本文為您介紹音視頻分析完成事件、事件通知的內容和回調示例。
事件類型
VideoAnalysisComplete
事件說明
視頻點播會對上傳完成的音視頻源文件進行分析,完成后會產生此事件。
說明
- 所有上傳的音視頻文件,默認都會進行源文件分析,且整個過程完全免費。
- 分析過程會提取源文件的時長、分辨率(寬高)、碼率、幀率等基本的Meta信息。
- 分析完成后的Meta信息會錄入媒資庫,可通過獲取源文件信息接口,獲取更多的源文件Meta信息。
事件內容
參數名稱 | 類型 | 必備項 | 描述 |
---|---|---|---|
EventTime | String | 是 | 事件產生時間,為UTC時間:yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 是 | 事件類型,系統規定參數。固定為:VideoAnalysisComplete。 |
VideoId | String | 是 | 音視頻ID。 |
Status | String | 是 | 分析源文件結果狀態。
|
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"
}