本文为您介绍全部清晰度转码完成事件、事件通知的内容和回调示例。
事件类型
TranscodeComplete
事件说明
视频所有流转码完成会产生TranscodeComplete事件。
如果开启了URL鉴权,则需要自己生成auth_key才能访问播放地址,否则会返回HTTP 403。URL鉴权的信息,请参见配置URL鉴权。
事件内容
| 参数名称 | 类型 | 必备项 | 描述 | 
| EventTime | String | 是 | 事件产生时间,为UTC时间:yyyy-MM-ddTHH:mm:ssZ。 | 
| EventType | String | 是 | 事件类型,系统规定参数。固定为:TranscodeComplete。 | 
| VideoId | String | 是 | 视频ID。 | 
| Status | String | 是 | 视频转码状态,只要有一路流转码成功即为成功。 
 | 
| Extend | String | 否 | 用户自定义回调透传数据。更多信息,请参见请求参数说明。 | 
| StreamInfos | Array | 否 | 请参见下文视频流信息表。 | 
StreamInfos为数组,每个流信息的字段如下:
表 1. 视频流信息表
| 名称 | 类型 | 必选项 | 描述 | 
| Status | String | 否 | 视频流转码状态。 
 | 
| Bitrate | String | 否 | 视频流码率,单位:Kbps。 | 
| Definition | String | 否 | 回调视频流清晰度定义示例,预置模板和窄带高清模板会在此基础上拼接后缀,例如:HD-MP4。 
 | 
| Duration | Float | 否 | 视频流长度,单位:秒。 | 
| Codec | String | 否 | 视频流Codec名称。 | 
| Encrypt | Boolean | 否 | 视频流是否为加密流。 | 
| ErrorCode | String | 否 | 作业错误码,视频流转码出错时,会有该字段。 | 
| ErrorMessage | String | 否 | 作业错误信息,视频流转码出错时,会有该字段。 | 
| FileUrl | String | 否 | 视频流的播放地址。不带鉴权的auth_key,如果开启了URL鉴权,则需要自己生成auth_key才能访问。 | 
| Format | String | 否 | 视频流格式。 
 | 
| Fps | String | 否 | 视频流帧率,每秒多少帧。 | 
| Height | Long | 否 | 视频流高度,单位:px。 | 
| Size | Long | 否 | 视频流大小,单位:Byte。 | 
| Width | Long | 否 | 视频流宽度,单位:px。 | 
| JobId | String | 否 | 转码作业ID。 | 
| WatermarkId | String | 否 | 水印ID列表,逗号分隔。 | 
| IsAudio | Boolean | 是 | 是否为音频。 | 
| StartTime | String | 是 | 任务开始时间。UTC时间。 | 
| FinishTime | String | 是 | 任务结束时间。UTC时间。 | 
回调示例
回调示例说明:
- 对于HTTP回调,以下内容为HTTP Post Body。 
- 对于MNS回调,以下内容为消息体。 - { "EventTime": "2017-03-20T07:49:17Z", "EventType": "TranscodeComplete", "VideoId": "43q9fjsh73f****", "Status": "success", "Extend":"test data", "StreamInfos": [ { "Status": "success", "Bitrate": "925", "Definition": "LD", "Duration": 15, "Encrypt": false, "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4", "Format": "mp4", "Fps": "30", "Height": 960, "Size": 1815321, "Width": 540, "Codec":"h264", "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", "IsAudio": false, "StartTime": "2017-03-20T07:49:17Z", "FinishTime": "2017-03-20T09:49:17Z", "JobId":"ffffffffff" }, { "Status": "success", "Bitrate": "1575", "Definition": "SD", "Duration": 15, "Encrypt": false, "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4", "Format": "mp4", "Fps": "30", "Height": 960, "Size": 3090951, "Width": 540, "Codec":"h264", "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", "IsAudio": false, "StartTime": "2017-03-20T07:49:17Z", "FinishTime": "2017-03-20T09:49:17Z", "JobId":"ddddddddddd" } ] }