二次转码V2
服务地址
http://api-az-cn.danghongyun.com/rest
请求方法
POST
请求参数
| 参数 | 说明 | 类型 | 是否必须 |
|---|---|---|---|
| accessKey | 访问API用的accessKey | String | 必选 |
| action | API名称，此接口为 "secondTranscodeV2" | String | 必选 |
| version | API版本，目前必须为2.0 | String | 必选 |
| timestamp | API调用时间戳，1970年1月1日以来的毫秒数，如1466488681033 | String | 必选 |
| signature | 签名，请参考签名规则 | String | 必选 |
| videoIds | 视频id，多个id以逗号隔开，如"b007808b127b417cb7dfa28da0696fb0,46af996052f94dd69f7dad8f64c8e6e9" | String | 必选 |
| transcodeTemplates | 转码模板，使用内置模板则不传该参数。该参数仅在当次转码中使用，不会记录，也不会影响内置模板 | String | 可选 |
| videoType | 视频转码类型，0 普通视频转码，1 VR转码; 该参数在使用了参数transcodeTemplates的时候生效 | Integer | 可选 |
| trailor | 是否额外再转码试看片段，false 否，true 是，默认值false; 该参数在使用了参数transcodeTemplates的时候生效 | Boolean | 可选 |
| trailorDuration | 试看时长，单位秒，默认值0; 该参数在使用了参数transcodeTemplates的时候生效 | Long | 可选 |
| transcodeTemplateGroupId | 内置转码模板组id，可由获取模板组列表接口获取。transcodeTemplates和transcodeTemplateGroupId两个参数必须传一个，transcodeTemplates优先; 如若两个都不传，则使用内置默认的普通转码模板组id | Integer | 可选 |
| replace | 替换还是另存为，0 另存为，1 替换。另存为会在视频列表里面新增一项，替换会在转码完成后删除之前所有的转码文件。 | Boolean | 必选 |
转码模板(transcodeTemplates)参数说明:
| 参数 | 描述 | 数据类型 | 必选/可选 |
|---|---|---|---|
| name | 模板名字 | String | 必选 |
| videoWidth | 视频宽度 | Integer | 必选 |
| videoHeight | 视频高度 | Integer | 必选 |
| videoBitrate | 视频比特率，例如 1000 为 1000kbps | Integer | 必选 |
| audioBitrate | 音频比特率，例如 64000 为 64kbps | Integer | 必选 |
| hls | 是否转码 hls 格式，false or true | Boolean | 必选 |
| mp4 | 是否转码 mp4 格式，false or true | Boolean | 必选 |
| flv | 是否转码 flv 格式，false or true | Boolean | 必选 |
| ts | 是否转码 ts 格式，false or true | Boolean | 可选 |
| hlsEncryptType | hls 加密类型，0 不加密，6 AES 加密，7 当虹加密 | Integer | 可选 |
| mp4EncryptType | mp4 加密类型，0 不加密，7 当虹加密 | Integer | 可选 |
| flvEncryptType | flv 加密类型，0 不加密，7 当虹加密 | Integer | 可选 |
| tsEncryptType | ts 加密类型，0 不加密，7 当虹加密 | Integer | 可选 |
| defaultVideo | 是否为默认播放，1 默认播放模板，0 非默认 | Integer | 可选 |
| logoGroupId | 台标组 id，可由获取台标组列表接口获取 | Integer | 可选 |
转码模板示例:
String transcodeTemplates = "[{"name":"high-definition","videoWidth":1280,"videoHeight":720,"videoBitrate":1000,"audioBitrate":64000,"hls":true,"mp4":true,"flv":false,"ts":false,"hlsEncryptType":6,"mp4EncryptType":7,"flvEncryptType":0,"tsEncryptType":0,"defaultVideo":1}, {"name":"standard -definition","videoWidth":640,"videoHeight":480,"videoBitrate":500,"audioBitrate":64000,"hls":true,"mp4":true,"flv":false,"ts":false,"hlsEncryptType":6,"mp4EncryptType":7,"flvEncryptType":0,"tsEncryptType":0,"defaultVideo":0}]";
或包含台标组 id
String transcodeTemplates = "{"logoGroupId":2,"templates":[{"name":"high-definition","videoWidth":1280,"videoHeight":720,"videoBitrate":1000,"audioBitrate":64000,"hls":true,"mp4":true,"flv":false,"ts":false,"hlsEncryptType":6,"mp4EncryptType":7,"flvEncryptType":0,"tsEncryptType":0,"defaultVideo":1}, {"name":"standard -definition","videoWidth":640,"videoHeight":480, "videoBitrate":500,"audioBitrate":64000,"hls":true,"mp4":true,"flv":false,"ts":false,"hlsEncryptType":6,"mp4EncryptType":7,"flvEncryptType":0,"tsEncryptType":0,"defaultVideo":0}]}";
响应示例
{
"code":0, //the value is only 0 or 10000
"message":"success",
"result":
[
{
"id":"b007808b127b417cb7dfa28da0696fb0",
"code":0,
"message":""
},
{
"id":"46af996052f94dd69f7dad8f64c8e6e9",
"code":10012,
"message":"video_not_exists"
}
],
"success":true
}
响应字段说明
| 字段 | 说明 |
|---|---|
| id | 视频ID |
| code | 对应视频删除操作的错误码 |
| message | 对应视频删除操作的错误信息 |
响应错误码
| 错误码 | 说明 |
|---|---|
| 0 | success |
| 10000 | Exception |
| 10012 | video_not_exists |
| 10017 | video_not_exists |
| 10024 | no_user_transcode_template |
| 10025 | create_transcode_task_failed |
| 10033 | transcode_running |
| 10043 | add_video_failed |
| 10061 | transcode_template_is_not_correct |
| 10067 | video_is_in_transcode_waitting_list |
| 10081 | transcode_template_group_not_exist |
| 10201 | api_not_exists |