全部产品
Search
文档中心

视频点播:音视频分析完成

更新时间:Jan 28, 2026

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

事件类型

VideoAnalysisComplete

事件说明

视频点播会对上传完成的音视频源文件进行分析,完成后会产生此事件。

说明
  • 所有上传的音视频文件,默认都会进行源文件分析,且整个过程完全免费。

  • 分析过程会提取源文件的时长、分辨率(宽高)、码率、帧率等基本的Meta信息。

  • 分析完成后的Meta信息会录入媒资库,可通过获取源文件信息接口,获取更多的源文件Meta信息。

事件内容

参数名称

类型

必备项

描述

EventTime

String

事件产生时间,为UTC时间:yyyy-MM-ddTHH:mm:ssZ。

EventType

String

事件类型,系统规定参数。固定为:VideoAnalysisComplete

VideoId

String

音视频ID。

Status

String

分析源文件结果状态。

  • success:成功。

  • fail:失败。

Width

Long

源文件宽 ,源片为纯音频不会有该字段。

Height

Long

源文件高 ,源片为纯音频不会有该字段。

Duration

Float

源文件时长 ,单位:秒。

Bitrate

String

源文件码率 ,单位:Kbps。

Fps

String

源文件帧率 ,每秒多少帧,源片为纯音频不会有该字段。

Size

Long

源文件大小,单位:Byte(字节)。

ErrorCode

String

作业错误码,分析源文件信息出错时,会有该字段。

ErrorMessage

String

作业错误信息,分析源文件信息出错时,会有该字段。

说明

Status=fail,表示分析不成功,则不会有源文件的基本信息,通常失败的原因是源文件封装信息有异常导致。

回调示例

回调示例说明:

  • 对于HTTP回调,以下内容为HTTP Post Body。

  • 对于MNS回调,以下内容为消息体。

分析成功回调消息,示例如下:

{
    "VideoId":"84bd5b0566ddj39549986befd0e80****",
    "Duration":"12",
    "Height":"360",
    "Width":"630",
    "Fps":"30",
    "Bitrate":"499",
    "Size":"1234568",
    "EventTime":"2018-11-28T10:12:48Z",
    "EventType":"VideoAnalysisComplete",
    "Status":"success"
  }

分析失败回调消息,示例如下:

 {
    "VideoId":"84bd5b0566ddj39549986befd0e80****",
    "EventTime":"2018-11-28T10:12:48Z",
    "EventType":"VideoAnalysisComplete",
    "Status":"fail",
    "ErrorCode":"InvalidParameter.ResourceContentBad",
    "ErrorMessage":"The resource operated InputFile is bad"
  }