本文為您介紹音視頻分析完成事件、事件通知的內(nèi)容和回調(diào)示例。

事件類型

VideoAnalysisComplete

事件說明

視頻點(diǎn)播會對上傳完成的音視頻源文件進(jìn)行分析，完成后會產(chǎn)生此事件。

說明
  • 所有上傳的音視頻文件，默認(rèn)都會進(jìn)行源文件分析，且整個過程完全免費(fèi)。
  • 分析過程會提取源文件的時長、分辨率（寬高）、碼率、幀率等基本的Meta信息。
  • 分析完成后的Meta信息會錄入媒資庫，可通過獲取源文件信息接口，獲取更多的源文件Meta信息。

事件內(nèi)容

參數(shù)名稱類型必備項(xiàng)描述
EventTimeString是事件產(chǎn)生時間，為UTC時間：yyyy-MM-ddTHH:mm:ssZ。
EventTypeString是事件類型，系統(tǒng)規(guī)定參數(shù)。固定為：VideoAnalysisComplete。
VideoIdString是音視頻ID。
StatusString是分析源文件結(jié)果狀態(tài)。
  • success：成功。
  • fail：失敗。
WidthLong否源文件寬 ，源片為純音頻不會有該字段。
HeightLong否源文件高 ，源片為純音頻不會有該字段。
DurationFloat否源文件時長 ，單位：秒。
BitrateString否源文件碼率 ，單位：Kbps。
FpsString否源文件幀率 ，每秒多少幀，源片為純音頻不會有該字段。
SizeLong否源文件大小，單位：Byte（字節(jié)）。
ErrorCodeString否作業(yè)錯誤碼，分析源文件信息出錯時，會有該字段。
ErrorMessageString否作業(yè)錯誤信息，分析源文件信息出錯時，會有該字段。
說明 Status=fail，表示分析不成功，則不會有源文件的基本信息，通常失敗的原因是源文件封裝信息有異常導(dǎo)致。

回調(diào)示例

回調(diào)示例說明：

  • 對于HTTP回調(diào)，以下內(nèi)容為HTTP Post Body。
  • 對于MNS回調(diào)，以下內(nèi)容為消息體。

分析成功回調(diào)消息，示例如下：

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

分析失敗回調(diào)消息，示例如下：

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