このトピックでは、`VideoAnalysisComplete` イベント、その通知内容、およびコールバックの例について説明します。
イベントタイプ
VideoAnalysisComplete
イベントの説明
ApsaraVideo VOD は、アップロードされた音声および動画のソースファイルを分析します。このイベントは、分析が完了した後に生成されます。
デフォルトでは、ApsaraVideo VOD はアップロードされたすべての音声ファイルと動画ファイルを分析します。この分析は無料です。
この分析では、ソースファイルから長さ、解像度 (幅と高さ)、ビットレート、フレームレートなどの基本的なメタデータを抽出します。
分析後、メタデータはメディアアセットライブラリに追加されます。GetMezzanineInfo 操作を呼び出して、ソースファイルに関するより多くのメタデータを取得できます。
イベント通知の内容
パラメーター名 | 型 | 必須 | 説明 |
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 | いいえ | ソースファイルのフレームレート (1 秒あたりのフレーム数)。このフィールドは音声のみのファイルの場合は返されません。 |
Size | Long | いいえ | ソースファイルのサイズ (バイト単位)。 |
ErrorCode | String | いいえ | ジョブのエラーコード。このフィールドは、ソースファイルの分析中にエラーが発生した場合に返されます。 |
ErrorMessage | String | いいえ | ジョブのエラーメッセージ。このフィールドは、ソースファイルの分析中にエラーが発生した場合に返されます。 |
`Status` が `fail` に設定されている場合、分析は失敗し、ソースファイルの基本情報は返されません。失敗は通常、ソースファイルの異常なカプセル化が原因で発生します。
コールバックの例
コールバックの例に関する注意点：
HTTP コールバックの場合、次の内容は HTTP POST の本文です。
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"
}