本文为您介绍单个清晰度转码完成事件、事件通知的内容和回调示例。

事件类型

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 视频流转码状态。
  • 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。
Extend String 用户自定义回调透传数据,更多信息,请参见媒体上传自定义设置 UserData

回调示例

回调示例说明:

  • 对于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://vod.aliyunsample.com/DBEBDEAJS73J79BE4D1329/52a53151eba5js73ke2da3b55bc5****.mp4",
   "Format": "mp4",
   "Fps": "30",
   "Height": 960,
   "Size": 1815321,
   "Width": 540,
   "JobId":"ddddddddddd",
   "Extend":"test data"
}