合并直播录制
接口描述
接口URL
请求方式
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
2、合并MP4文件不能超过15个,合并视频总时长不能超过24小时
请求参数描述
appId
true
String
timestamp
true
Long
当前13位毫秒级时间戳,3分钟内有效
sign
true
String
channelId
true
String
频道号
fileIds
true
String
fileName
false
String
合并后的视频的文件名
callbackUrl
false
String
autoConvert
false
String
是否自动转存到点播,默认为N Y:自动转存到对应点播分类下(点播保存路径:直播回放-频道号-场次) N:不自动转存
mergeMp4
false
String
合并后文件类型,默认为N Y:合并为MP4文件 N:合并为m3u8文件
示例
表单参数:
响应参数描述
code
Integer
status
String
响应状态文本信息
message
String
响应描述信息,当code为400或者500的时候,辅助描述错误原因
data
String
请求成功时返回提交成功信息 "processing.":合并任务正在处理中 "submit success.":合并任务提交成功
回调说明
合并结果实时信息回调,可以及时通知用户合并任务的结果。
原理
通过HTTP接口(设置的callbackUrl)向用户服务器发送GET请求,将合并结果推送给用户服务器。
举例说明
举例如下:http://abc.com/test.do?status=success×tamp=1603506240000&fileId=xxxx&fileIds=xxx,xxx&sign=xxdxxxxx&fileUrl=urlxxxx&fileName=xxxx
status
String
接口处理结果,成功为success,失败为error
timestamp
Long
当前13位毫秒级时间戳
fileId
String
合并后的文件ID,成功时返回
fileIds
String
合并前的文件ID
fileUrl
String
合并后的视频文件地址,成功时返回
fileName
String
合并后的文件名称,成功时返回
sign
String
校验的加密字符串,生成的规则md5(AppSecret+timestamp),AppSecret是直播系统用的密钥
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
响应示例
系统全局错误说明详见全局错误说明
成功示例
异常示例
Last updated
Was this helpful?