最近更新时间:2023-01-10 18:34:07
此接口用来发起轮播任务,用于将指定的视频文件转换为直播流供观众观看;
需开通直播转码服务才能使用,请联系技术支持。
mp4/flv/m3u8/mpegts
注:如果使用多文件轮播,建议先使用点播转码服务将所有视频参数统一,并转成mp4视频再发起轮播任务
支持的文件名字符:中文、英文大小写、-$^&=’~,[]{};!¥……(——);‘’“”,。《》?.
支持音视频类文件轮播,不支持纯视频、纯音频类混合轮播。
POST
参数名 | 类型 | 是否必需 | 描述 |
---|---|---|---|
UniqName | string | 是 | 域名空间。 |
App | string | 是 | 应用名。 |
Preset | string | 是 | 模板名称,支持配置:视频帧率、视频码率、音频码率、视频分辨率。 |
StreamID | string | 是 | 轮播流名。 |
SrcInfo | json array | 是 | 轮播源文件信息,数组,每项包括文件路径(金山云KS3内网URL)和顺序参数。发起轮播前请先确认轮播源文件是否存在。最多可以支持100个轮播任务。 |
PubDomain | string | 是 | 用来轮播的推流域名。 |
TaskStartTime | int | 否 | 任务开始时间戳,指定轮播流启动播放时间,精确到秒,不填默认下发后立即开始轮播。只能填当前时间1分钟之后的时间。 |
TaskStopTime | int | 否 | 任务结束时间戳,指定轮播流结束播放时间,精确到秒,不填默认结束时间为开始时间之后20天。TaskStopTime-TaskStartTime必须>30s。 |
LoopTimes | int | 否 | 文件轮播次数,与TaskStopTime冲突时,以TaskStopTime为准,如果需要以轮播次数为准,TaskStopTime不填。 |
SrcInfo | 类型 | 是否必需 | 描述 |
---|---|---|---|
Path | string | 是 | 源文件在ks3的完整路径。 |
Index | int | 是 | 文件播放顺序。 |
备注:
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",
}
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"
}
纯净模式