本文为您介绍视频转码完成事件、事件通知的内容和回调示例。

事件类型

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 是 视频转码状态，只要有一路流转码成功即为成功。
  • success：成功。
  • fail：失败。
Extend String 否 用户自定义回调透传数据。更多信息，请参见媒体上传自定义设置 UserData。
StreamInfos Array 否 请参见下文视频流信息表。

StreamInfos为数组，每个流信息的字段如下：

表 1. 视频流信息表
名称 类型 必选项 描述
Status String 否 视频流转码状态。
  • success：成功。
  • fail：失败。
Bitrate String 否 视频流码率，单位：Kbps。
Definition String 否 视频流清晰度定义。
  • FD：流畅。
  • LD：标清。
  • SD：高清。
  • HD：超清。
  • OD：原画。
  • 2K：2K。
  • 4K：4K。
  • AUTO：自适应码流。
Duration Float 否 视频流长度，单位：秒。
Encrypt Boolean 否 视频流是否为加密流。
ErrorCode String 否 作业错误码，视频流转码出错时，会有该字段。
ErrorMessage String 否 作业错误信息，视频流转码出错时，会有该字段。
FileUrl String 否 视频流的播放地址。不带鉴权的auth_key，如果开启了URL鉴权，则需要自己生成auth_key才能访问。
Format String 否 视频流格式。
  • mp4
  • m3u8
Fps String 否 视频流帧率，每秒多少帧。
Height Long 否 视频流高度，单位：px。
Size Long 否 视频流大小，单位：Byte。
Width Long 否 视频流宽度，单位：px。
JobId String 否 转码作业ID。

回调示例

回调示例说明：

  • 对于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://vod.aliyunsample.com/ABEBDE1JSU79FD4D1329/62cb3151eba52js82j2da3b55bc5****.mp4",
     "Format": "mp4",
     "Fps": "30",
     "Height": 960,
     "Size": 1815321,
     "Width": 540,
     "JobId":"ffffffffff"
   },
   {
     "Status": "success",
     "Bitrate": "1575",
     "Definition": "SD",
     "Duration": 15,
     "Encrypt": false,
     "FileUrl": "http://vod.aliyunsample.com/ABEBDE1JSU79FD4D1329/62cb3151eba52js82j2da3b55bc5****.mp4",
     "Format": "mp4",
     "Fps": "30",
     "Height": 960,
     "Size": 3090951,
     "Width": 540,
     "JobId":"ddddddddddd"
   }
  ]
}