全部产品
Search
文档中心

视频点播:全部清晰度转码完成

更新时间:Sep 26, 2023

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

事件类型

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

用户自定义回调透传数据。更多信息,请参见请求参数说明

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

视频流长度,单位:秒。

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时间。

回调示例

回调示例说明:

  • 对于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://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4",
         "Format": "mp4",
         "Fps": "30",
         "Height": 960,
         "Size": 1815321,
         "Width": 540,
         "Codec":"h264",
         "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
         "IsAudio": false, 
         "StartTime": "2017-03-20T07:49:17Z",
         "FinishTime": "2017-03-20T09:49:17Z",
         "JobId":"ffffffffff"
       },
       {
         "Status": "success",
         "Bitrate": "1575",
         "Definition": "SD",
         "Duration": 15,
         "Encrypt": false,
         "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4",
         "Format": "mp4",
         "Fps": "30",
         "Height": 960,
         "Size": 3090951,
         "Width": 540,
         "Codec":"h264",
         "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
         "IsAudio": false, 
         "StartTime": "2017-03-20T07:49:17Z",
         "FinishTime": "2017-03-20T09:49:17Z",
         "JobId":"ddddddddddd"
       }
      ]
    }