全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

发起轮播转码接口(StartLoop)

最近更新时间: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"

}

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈