新建或更新模板
服务地址
http://api-az-cn.danghongyun.com/rest
请求方法
POST
请求参数
| 参数 | 说明 | 类型 | 是否必须 |
|---|---|---|---|
| accessKey | 访问API用的accessKey | String | 必选 |
| action | API名称，此接口为 "templateGroup" | String | 必选 |
| version | API版本，目前必须为2.0 | String | 必选 |
| timestamp | API调用时间戳，1970年1月1日以来的毫秒数，如1466488681033 | String | 必选 |
| signature | 签名，请参考签名规则 | String | 必选 |
| id | 转码模板组id，不传该参数时为增加模板组，传该参数的时候为修改对应模板组 | String | 必选 |
| transcodeTemplates | 模板组内的目标参数，请参考模板说明 | String | 必选 |
| name | 转码模板组名 | String | 必选 |
| type | 该模板组为普通视频模板组或者VR视频模板组， 0：普通模板，1：VR模板 | Integer | 必选 |
| trailor | 是否额外再转码试看片段，false：否，true：是 | Boolean | 必选 |
| trailorDuration | 试看时长，单位秒 | Long | 必选 |
| logoGroupId | 台标组id | Integer | 必选 |
模板说明
| 参数 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| name | 模板名字 | String | 必选 |
| videoWidth | 视频宽度 | Integer | 必选 |
| videoHeight | 视频高度 | Integer | 必选 |
| videoBitrate | 视频比特率，1000为1000kbps | Integer | 必选 |
| audioBitrate | 音频比特率，64000为64kbps | Integer | 必选 |
| format | 转码格式，0: hls，1: mp4，2: flv，3: ts | Integer | 必选 |
| encryptType | 加密类型，0: 不加密，6: AES加密，7: 当虹加密，其中AES加密只对hls起作用 | Integer | 必选 |
| defaultVideo | 是否为默认播放模板，0: 否，1: 是，确保列表中默认播放模板有且只有一个 | Integer | 必选 |
| advancedArguments | 高级参数，参见高级参数说明 | String | 可选 |
模板示例
[{"name":"high-quality","videoWidth":1280,"videoHeight":720,"videoBitrate":1000,"audioBitrate":192000,"format":0,"encryptType":6,"defaultVideo":1},{"name":"high-definition","videoWidth":640,"videoHeight":480,"videoBitrate":500,"audioBitrate":192000,"format":1,"encryptType":7,"defaultVideo":0},{"name":"standard-definition","videoWidth":480,"videoHeight":360,"videoBitrate":250,"audioBitrate":192000,"format":2,"encryptType":0,"defaultVideo":0}]
高级参数说明
| 字段 | 说明 | 类型 |
|---|---|---|
| rc | 码率控制，VBR 或 CBR | String |
| refFrame | 参考帧数量 | Integer |
| gopSize | GOP大小 | Integer |
| gopType | GOP单位，0：帧，1：毫秒，默认为0 | Integer |
| bframe | B帧数量 | Integer |
| interlace | 帧场模式，-1: 跟随源, 0: 帧, 3: MBAFF | Integer |
| smartBorder | 宽高变换模式, 0: 线性拉伸, 1: 智能黑边, 2: 自动裁剪 | Integer |
高级参数示例
{"rc": "CBR","gopSize": 4000,"bFrame": 0, "refFrame": 1, "qualityLevel": null, "interlace": -1, "smartBorder": 1}
响应示例
{
"result": 1015,
"code": 0,
"success": true,
"message": "success"
}
响应错误码
| 错误码 | 说明 |
|---|---|
| 0 | success |
| 10000 | exception |
| 10003 | account_not_exists |
| 10050 | sub_can_not_modify_transcode_template |
| 10061 | transcode_template_is_not_correct |
| 10081 | transcode_template_group_not_exist |
| 10082 | can_not_modify_this_template_group |
| 10095 | can_not_modify_default_template_group_type |