音视频拼接

描述

该接口提供在云存储平台对音视频进行拼接的功能。

注意:

  • 音频拼接时,不同编码方案的音频,可以拼接,音频编码将转为目标封装格式支持的音频编码方案;
  • 视频拼接时,未指定编码方案、分辨率、帧率,以主文件的编码方案、分辨率、帧率为默认。

请求说明

POST /fops
Host: <MgrDomain>
Authorization: <AccessToken>

头部说明

参数 必填 描述
Host 管理域名,可在用户管理界面获取
Authorization 管理凭证

参数说明

请求参数以如下格式组织,作为请求内容提交:

bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>&notifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>
参数 必填 描述
bucket 空间名
key 文件名,指定拼接的主文件
fops 处理参数列表,参数含义请参见音视频拼接Ops参数格式
支持同时请求多个处理,参数列表之间用 ; 分隔。
notifyURL 处理结果通知接收URL,需要使用URL安全的Base64编码,请参考通知数据内容说明
force 是否强制执行数据处理。支持设置以下数值:
0:指定的数据处理结果如果存在,返回文件已存在,不进行处理,避免重复处理浪费资源
1:强制执行数据处理并覆盖已有文件
默认缺省为0
separate 处理是否分开通知。。支持设置以下数值:
0:表示所有转码指令执行完后再一次性通知notifyURL
1:表示每个转码指令执行完后都通知notifyURL
默认缺省为0

响应说明

如果请求成功,则返回如下内容的Json串:

{ "persistentId": <persistentId> }
字段名 必填 描述
persistentId 上传预处理或者触发持久化处理的进程ID

如果请求失败,则返回如下内容的Json字符串:

{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}
字段名 必填 描述
code HTTP请求响应码,参见HTTP响应状态码<返回码>
message 音视频处理失败的提示信息

范例

curl -v -X POST -d "bucket=aW1hZ2Vz&key=bGVodS5tcDQ=&fops=YXZjb25jYXQvZmx2L21vZGUvMS9iR1ZvZFMweExtMXdOQT09fHNhdmVhcy9hVzFoWjJWek9uQnBibWRxYVdVdVpteDI=&force=1&separate=0" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NmNlYmI5YzczMjlkN2MxYTYxNWYyMjE4MDMxZTVjMWQ3ZjlkZTVmOA==" --url "http://mgrDomain/fops"