最近更新时间:2022-01-18 17:01:30
发起从外网拉流推流到源站,模拟用户向源站推流。支持rtmp/http-flv/hls协议的外网拉流。需要提前开通金山云直播源站服务。
POST
参数名 | 类型 | 是否必需 | 备注 |
---|---|---|---|
UniqName | string | 是 | 客户的域名标识 |
App | string | 是 | 客户的频道名 |
StreamID | string | 是 | 流名称 |
SrcUrl | string | 是 | 外网源流地址 |
Vdoid | string | 否 | 用于标识同一流名的每次推流,开启直播转点播时,该值将作为点播文件名的一部分(见直播转点播部分说明) |
Params | string | 否 | 推流到源站使用的额外参数,形如url querystring,如:带转码模板时设置为preset=mypreset |
ExtParam 参数说明:
参数名 | 类型 | 是否必需 | 备注 |
---|---|---|---|
preset | string | 否 | 转码模版,需要对源流进行转码时设置,默认为空 |
interval | int | 否 | 拉源流失败时,重试间隔时间,单位:秒,范围:[1,20],默认6秒。如果此次拉流时间已经花费n秒,则只sleep(interval - n)。最长重试时间不超过5分钟。 |
retrytimes | int | 否 | 拉源流失败时,重试最大次数,范围:[1,100]。最长重试时间不超过5分钟。 |
参数名 | 类型 | 是否必须 | 备注 |
---|---|---|---|
ErrNum | int | 是 | |
ErrMsg | string | 是 | |
TaskID | string | 否 | 任务ID |
示例一:
POST /?Action=StartStreamPull
&Version=2017-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Date=20170518T092721Z
&X-Amz-Credential=AKLT6UU6Vp_9SxWW5RAW6UHtdQ%2F20170518%2Fcn-beijing-6%2Fket%2Faws4_request
&X-Amz-SignedHeaders=accept%3Bhost
&X-Amz-Signature=a439d0f4a6275da64cb04ead02946a1ce6eede11c552e24504e116a4c5558aee HTTP/1.1
Host: ket.cn-beijing-6.api.ksyun.com
Accept: application/json
{
"UniqName": "mytest",
"StreamID": "teststreamid",
"SrcUrl": "rtmp://qa-ws.test-rtmplive.ks-cdn.com/live/20160819",
"App": "live",
"Vdoid": "123456",
"Params": "preset=testpreset",
}
示例二:
POST /?Action=StartStreamPull
&Version=2017-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Date=20170518T092721Z
&X-Amz-Credential=AKLT6UU6Vp_9SxWW5RAW6UHtdQ%2F20170518%2Fcn-beijing-6%2Fket%2Faws4_request
&X-Amz-SignedHeaders=accept%3Bhost
&X-Amz-Signature=a439d0f4a6275da64cb04ead02946a1ce6eede11c552e24504e116a4c5558aee HTTP/1.1
Host: ket.cn-beijing-6.api.ksyun.com
Accept: application/json
{
"UniqName": "mytest",
"StreamID": "teststreamid",
"SrcUrl": "rtmp://qa-ws.test-rtmplive.ks-cdn.com/live/20160819",
"App": "live",
"DstUrl": "rtmp://qa-ks.uplive.ks-cdn.com/live/20160819",
"ExtParam":'{"timeout":5,"retrytimes":3}'
}
HTTP/1.1 200 OK
Server: ksyun-open-platform
Date: Fri, 12 May 2017 08:01:06 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
{
"ErrNum":0,
"ErrMsg":"success",
"TaskID":"8291322e08e34d8bfd796e1ae9807dee"
}
纯净模式