音視頻分析完成 - ApsaraVideo VOD

本文為您介紹音視頻分析完成事件、事件通知的內容和回調樣本。

事件類型

VideoAnalysisComplete

事件說明

ApsaraVideo for VOD會對上傳完成的音視頻源檔案進行分析，完成後會產生此事件。

說明

所有上傳的音視頻檔案，預設都會進行源檔案分析，且整個過程完全免費。
分析過程會提取源檔案的時間長度、解析度（寬高）、碼率、幀率等基本的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"
  }