裁剪录制文件
接口描述
接口URL
请求方式
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
appId
true
String
timestamp
true
Long
当前13位毫秒级时间戳,3分钟内有效
sign
true
String
channelId
true
String
频道号
fileId
true
String
deleteTimeFrame
true
String
要裁剪移除的时间区间
传入格式要求:
(1)start、end值是单位为秒的数值,格式为:[{"start":xx, "end":xx},{"start":xx, "end":xx}]
(2)多个区间请按照时间顺序从小到大排列
(3)时间区间不允许重叠
(4)时间区间不得超过100个限制
【示例:要裁剪移除的是第1s到第14s,以及第25s到第30s的区间,则传入的字符串为 [{"start":1, "end":14},{"start":25, "end":30}]
】
误差说明:
(1)裁剪区间存在一定的时间误差
(2)误差原因:回放默认为m3u8格式裁剪,由于m3u8的视频裁剪是精确到每片ts,所以裁剪时会判断裁剪要移除的时间区间所包含的ts片,进行裁剪移除,如需更精准的裁剪,可联系保利威客服人员开通mp4裁剪
callbackUrl
false
String
autoConvert
false
String
是否自动转存回放到点播,默认为N Y:是 N:否
fileName
false
String
裁剪后文件名
示例
表单参数:
响应参数描述
code
Integer
status
String
响应状态文本信息
message
String
响应描述信息,当code为400或者500的时候,辅助描述错误原因
data
String
请求成功时返回提交成功信息 "submit success.":提交的视频正在裁剪处理中
回调说明
裁剪结果实时信息回调,可以及时通知用户裁剪任务的结果。
原理
通过HTTP接口(设置的callbackUrl)向用户服务器发送GET请求,将合并结果推送给用户服务器。
举例说明
举例如下:http://abc.com/test.do?status=success&fileId=xxxx&channelId=xxx&sign=xxdxxxxx&clippedFileId=xxx&fileName=xxxx×tamp=xxx&actualTimeFrame=xxx
status
String
接口处理结果,成功为success,失败为error
channelId
String
频道号,成功时返回
fileId
String
裁剪后的文件ID,成功时返回
clippedFileId
String
裁剪前的文件ID,成功时返回
fileUrl
String
裁剪后的视频地址,成功时返回
timestamp
String
回调的当前时间戳
sign
String
校验的加密字符串,生成的规则md5(AppSecret+timestamp),AppSecret是直播系统的用密钥
actualTimeFrame
String
真实裁剪后保留的时间区间,经过urlEncode的字符串,格式为:[{"start":xx, "end":xx},{"start":xx, "end":xx}]
fileName
String
文件名,经过urlEncode的字符串
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
响应示例
系统全局错误说明详见全局错误说明
成功示例
异常示例
Last updated
Was this helpful?