文档中心 云点播 直播录制文件合并

直播录制文件合并

更新时间: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 频道未开播不存在录像文件
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!