本文为您介绍单个清晰度转码完成事件、事件通知的内容和回调示例。
事件类型
StreamTranscodeComplete
事件说明
视频的某个清晰度、某种格式的流(如:标清的MP4格式)转码完成时会产生此事件。目前单个清晰度至少1种格式的转码完成即可播放。
如果开启了URL鉴权,则需要自己生成auth_key才能访问播放地址,否则会返回HTTP 403
。关于URL鉴权的信息,请参见配置URL鉴权。
事件内容
参数名称 | 类型 | 必备项 | 描述 |
EventTime | String | 是 | 事件产生时间,为UTC时间:yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 是 | 事件类型,系统规定参数。固定为:StreamTranscodeComplete。 |
VideoId | String | 是 | 视频ID。 |
Status | String | 是 | 视频流转码状态。
|
Bitrate | String | 否 | 视频流码率,单位:Kbps。 |
Definition | String | 否 | 视频流清晰度定义。
|
Duration | Double | 否 | 视频流长度,单位:秒。 |
Codec | String | 否 | 视频流Codec名称。 |
Encrypt | Boolean | 否 | 视频流是否为加密流。 |
EncryptType | String | 否 | 加密类型。 |
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时间。 |
Extend | String | 否 | 用户自定义回调透传数据,更多信息,请参见请求参数示例。 |
回调示例
回调示例说明:
对于HTTP回调,以下内容为HTTP Post Body。
对于MNS回调,以下内容为消息体。
{ "EventTime": "2017-03-20T07:49:17Z", "EventType": "StreamTranscodeComplete", "VideoId": "43q9fj74hdf****", "Status": "success", "Bitrate": "925", "Definition": "LD", "Duration": 15.0, "Encrypt": false, "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4", "Format": "mp4", "Fps": "30", "Height": 960, "Size": 1815321, "Width": 540, "JobId":"ddddddddddd", "Codec":"h264", "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", "IsAudio": false, "StartTime": "2017-03-20T07:49:17Z", "FinishTime": "2017-03-20T09:49:17Z", "Extend":"test data" }