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

事件类型

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 Float 视频流码率,单位: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 Float 视频流帧率,每秒多少帧。
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"
   }
  ]
}