更新时间:2022-12-01 17:53:42
通过接口可以根据指定时间合并某个直播频道内的录像文件。
请求方式 | Post |
---|---|
接口地址 | https://open.chinanetcenter.com/live/channelManage/liveVideoConcat |
是否需要凭证 | 需要校验凭证 |
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
pullId | string | 是 | 频道拉流id |
transNo | string | 否 | 业务ID,需用户自己控制唯一性\n建议使用32位UUID,并且最长为32位字符串 |
start | int64 | 否 | 开始时间,unix时间戳,默认为第一次直播开始时间 |
end | int64 | 否 | 结束时间,unix时间戳,默认当前时间。结束时间禁止填未来时间 |
fname | string | 否 | 文件名。若为空则系统自动生成一个文件名(流名_开始时间_结束时间) |
suffix | string | 否 | 文件格式,可选文件格式为: flv:FLV格式,将多个录制视频合并成单个flv文件。默认格式 mp4:MP4格式,将多个录制视频合并成单个mp4文件。 不支持格式: m3u8:HLS格式。 |
notify | string | 否 | 回调地址。完成任务后回调通知地址,不指定表示不做回调 |
transMode | int | 否 | 转码模式,用来决定视频合并前是否要进行转码,默认为0 设置为智能转码时,分辨率不一样则触发转码动作,分辨率一样则不进行转码 0:不转码, 1:强制转码 2:智能转码 |
成功响应
参数名 | 类型 | 描述 |
---|---|---|
code | int | 创建结果状态码,200为成功 |
message | string | 操作成功 |
data | json | 返回数据 |
data返回数据结构
参数名 | 类型 | 描述 |
---|---|---|
tranNo | string | 业务ID,如果请求是没有传,系统自动生成一个 |
错误响应
参数名 | 类型 | 描述 |
---|---|---|
code | int | 响应错误码 |
message | string | 响应错误提示信息 |
curl -X POST
http://https://open.chinanetcenter.com/live/channelManage/liveVideoConcat
-H "Content-Type: application/json; charset=utf-8"
-H "Host: open.chinanetcenter.com"
<公共的头部参数>
<自定义的头部参数>
-d '{"pullId": "idxxxxxx","transNo":"tranNoxxxxxxx","start":"1657173273","end":"1657512609","fname":"文件名","suffix":"mp4","notify":"http://xxxxx"}'
{
"code": 200,
"data": {
"tranNo":"1234567890"
},
"message": "操作成功"
}
注意:示例中的“公共参数”参见公共参数说明文档。
以下仅列出了接口业务逻辑相关的错误码,通用错误码详见 返回结果
错误码 | 描述 |
---|---|
1341 | 频道未开播不存在录像文件 |