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

事件类型

VideoAnalysisComplete

事件说明

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

说明
  • 所有上传的音视频文件,默认都会进行源文件分析,且整个过程完全免费。
  • 分析过程会提取源文件的时长、分辨率(宽高)、码率、帧率等基本的Meta信息。
  • 分析完成后的Meta信息会录入媒资库,可通过获取源文件信息接口,获取更多的源文件Meta信息。

事件内容

参数名称类型必备项描述
EventTimeString事件产生时间,为UTC时间:yyyy-MM-ddTHH:mm:ssZ。
EventTypeString事件类型,系统规定参数。固定为:VideoAnalysisComplete
VideoIdString音视频ID。
StatusString分析源文件结果状态。
  • success:成功。
  • fail:失败。
WidthLong源文件宽 ,源片为纯音频不会有该字段。
HeightLong源文件高 ,源片为纯音频不会有该字段。
DurationFloat源文件时长 ,单位:秒。
BitrateString源文件码率 ,单位:Kbps。
FpsString源文件帧率 ,每秒多少帧,源片为纯音频不会有该字段。
SizeLong源文件大小,单位:Byte(字节)。
ErrorCodeString作业错误码,分析源文件信息出错时,会有该字段。
ErrorMessageString作业错误信息,分析源文件信息出错时,会有该字段。
说明 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"
  }