文档

单个清晰度转码完成

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

事件类型

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

Double

视频流长度,单位:秒。

Codec

String

视频流Codec名称。

Encrypt

Boolean

视频流是否为加密流。

EncryptType

String

加密类型。

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。

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"
    }