发起外网拉流接口(StartStreamPull)

最近更新时间:2018-06-26 14:50:31

功能描述:

发起从外网拉流推流到源站,模拟用户向源站推流。支持rtmp/http-flv/hls协议的外网拉流。

请求方式:

POST

请求参数:

外网拉流后推至金山云源站:

参数名 类型 是否必需 备注
UniqName string 客户的域名标识
App string 客户的频道名
StreamID string 流名称
SrcUrl string 外网源流地址
Vdoid string 用于标识同一流名的每次推流,开启直播转点播时,该值将作为点播文件名的一部分(见直播转点播部分说明)
Params string 推流到源站使用的额外参数,形如url querystring,如:带转码模板时设置为preset=mypreset

外网拉流后直接推至第三方源站:

参数名 类型 是否必需 备注
UniqName string 客户的域名标识
App string 客户的频道名
StreamID string 流名称
SrcUrl string 外网源流地址
DstUrl string 完整的第三方源站推流地址
ExtParam string 创建任务时传递不适用于放入转码模板里,且经常变动的参数,示例:'{"preset":"presetdemo","interval":3,"retrytimes":15}'

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"

}

金山云,开启您的云计算之旅

免费注册