修改流转码配置
修改转码配置
- 推流开始时如果有转码配置会触发转码,推流过程中修改转码配置不会立即生效,需要重新推流。
- 推流过程中,在直播地址后面添加
@<ProfileName>
即可播放转码流。- 例: 一路流的直播地址是
rtmp://live-rtmp.test.com/PiliSDKTest/streamtitle
,<ProfileName>
是720p
,则对应转码流的直播地址是rtmp://live-rtmp.test.com/PiliSDKTest/streamtitle@720p
- 目前能转码的规格有
480p
和720p
- 例: 一路流的直播地址是
规格
请求包:
POST /v2/hubs/<Hub>/streams/<EncodedStreamTitle>/converts
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json
{
"converts": ["<ProfileName>", ...]
}
参数名称 | 必填 | 说明 |
---|---|---|
Hub | 是 | 直播空间名 |
EncodedStreamTitle | 是 | 对流名做URL 安全的 Base64 编码后得到的字符串 |
converts | 否 | 数组,转码配置,如果提交的 ProfileName 为空数组,那么之前的转码配置将被取消 |
返回包:
200 {}
400 {
"error": "invalid stream key" // 只能修改原始流,包含@的流不允许
}
400 {
"error": "invalid args" // 转码配置不存在
}
612 {
"error": "stream not found"
}
示例
请求包:
POST /v2/hubs/9527/streams/dGVzdGNvbnZlcnRz/converts HTTP/1.1
Host: pili.qiniuapi.com
User-Agent: pili-sdk-go/v2 go1.6 darwin/amd64
Content-Length: 28
Authorization: Qiniu 9roGzeeJkZh4y5gHpzT7Uv1CIw0KiVV8K4dfXRY0:prhwnWzN8A3lHHcdKXOukHRSVuQ=
Content-Type: application/json
X-Reqid: 5ugAAHlh58T9i1wU
Accept-Encoding: gzip
{"converts":["720p","480p"]}
返回包:
HTTP/1.1 200 OK
Content-Length: 2
Content-Type: application/json
Date: Wed, 29 Jun 2016 11:58:20 GMT
X-Log: PILI:2;vs.i/vstream: stream already exists;ZEUSD:2/614;vs.u;ZEUSD:2;PILI-LINA:11
X-Reqid: 5ugAAHlh58T9i1wU
{}
文档反馈
(如有产品使用问题,请提交工单)