发起轮播转码接口(StartLoop)

最近更新时间:2019-06-20 11:40:43

接口描述

发起轮播任务,用于将指定的点播视频文件转换为源站的直播视频流;

适用于将客户在直播间内循环播放热门视频。

此接口需开通直播转码才能应用,请联系技术支持。

输入文件格式

mp4/flv/m3u8/mpegts

注:如果使用多文件轮播最好先用离线转码将所有视频参数统一,并转成mp4视频再发起轮播

请求方式:

POST

请求参数:

参数名 类型 是否必需 描述
UniqName string 客户的域名标识
App string 客户的频道名
Preset string 模板名称
StreamID string 轮播流名
SrcInfo json array 轮播源文件信息,数组,每项包括文件路径(金山云KS3内网URL)和顺序参数。发起轮播前请先确认轮播源文件是否存在
PubDomain string 推流域名
DurationHour int 持续时长,单位:时。默认8760(1年),最大值99999
StartTime int 起始时间,Unix时间戳,单位:秒。启动轮播时会根据此时间戳计算当前的轮播文件和偏移位置。
Path string 源文件在ks3的完整路径
Index int 播放顺序
DelayTime int 轮播延时时间,单位:秒。如配置此参数,轮播会延时发起,只要轮播源文件有一个存在即发起轮播;如未设置此参数,则必须轮播源文件全部存在才可发起轮播任务
CbMethod string 回调用户请求方法,目前只支持POST,和Delaytime配合使用,延时轮播时延时发送回调
CbUrl string 回调用户地址,可带token。和Delaytime配合使用,延时轮播时延时发送回调

备注:

  • SrcInfo必须是金山云KS3内网URL,组合内网域名与视频文件的objectkey。使用外网URL会造成轮播失败。推荐使用region在北京的bucket做为SrcInfo的来源。在KS3空间概况可以显示该bucket的内网域名。

  • 推荐bucket的权限设置为公开读,设置方式参见KS3存储空间维护-权限设置。如果bucket只能设置私密,则SrcInfo需要客户按KS3接口文档-请求签名的要求预先完成签名,再赋予SrcInfo。请注意,采用预先签名时,需要保证签名过期时间足够长,因为签名过期,会造成轮播失败。

  • 新建轮播任务时,只能指定最大20天的轮播时长,可以调用更新轮播时长接口,每次更新时长也是最长20天。更新轮播时长接口可以多次调用。

返回参数:

参数名 类型 是否必需 描述
ErrNum int 错误码
ErrMsg string 错误信息
List json array 轮播转码任务信息
TaskID string 轮播转码单个任务ID
Format int 转码任务使用的output_format

请求示例:


POST /?Action=StartLoop

&Version=2017-01-01

&X-Amz-Algorithm=AWS4-HMAC-SHA256

&X-Amz-Date=20170518T090434Z

&X-Amz-Credential=xxxxx

&X-Amz-SignedHeaders=xxxxx

&X-Amz-Signature=xxxxxx HTTP/1.1

Host: ket.cn-beijing-6.api.ksyun.com

Accept: application/json

{

    "PubDomain": "xxx.xxx.com",

    "UniqName": "xxxxx",

    "Preset": "testpreset",

    "SrcInfo": [

        {

            "Path": "http://xxx.xxx.com/ksyun.flv",

            "Index": 0

        }

    ],

    "StreamID": "myteststreamid",

    "App": "xxx",

    "DurationHour": 168

}

返回示例:


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

{

    "List": [

        {

            "TaskID": "5cf5b255d7cf7d8a16cdafe46ee38cca",

            "Format": 256

        },

        {

            "TaskID": "87a24f7fb1758f77b93756dce42082f0",

            "Format": 257

        }

    ],

    "ErrNum": 0,

    "ErrMsg": "success"

}

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

免费注册