このトピックでは、VideoAnalysisCompleteイベントとその通知内容とサンプルコールバックについて説明します。
イベントタイプ
VideoAnalysisComplete
イベントの説明
VideoAnalysisCompleteイベントは、ApsaraVideo VODがアップロードするオーディオおよびビデオメザニンファイルを分析した後に生成されます。
デフォルトでは、ApsaraVideo VODは、無料でアップロードされるすべてのオーディオおよびビデオメザニンファイルを分析します。
分析中、ApsaraVideo VODはメザニンファイルのメタデータを抽出します。 そのようなメタデータは、持続時間、解像度 (幅および高さ) 、ビットレート、およびフレームレートを含む。
分析から得られたメタデータは、メディアライブラリに格納される。 GetMezzanineInfo操作を呼び出して、メザニンファイルのメタデータを取得できます。
イベント通知コンテンツ
パラメーター | データ型 | 必須／任意 | 説明 |
EventTime | String | 必須 | イベントが生成された時刻。 時刻はyyyy-MM-ddTHH:mm:ssZ形式でUTCで表示されます。 |
EventType | String | 必須 | イベントタイプ。 値はVideoAnalysisCompleteです。 |
VideoId | String | 必須 | オーディオファイルまたはビデオファイルのID。 |
ステータス | String | 必須 | メザニンファイルを分析するかどうかを示します。 設定可能な値は以下のとおりです。
|
幅 | Long | 任意 | メザニンファイルの幅。 メザニンファイルがオーディオファイルの場合、このパラメーターは使用できません。 |
Height | Long | 任意 | メザニンファイルの高さ。 メザニンファイルがオーディオファイルの場合、このパラメーターは使用できません。 |
有効期間 | Float | 任意 | メザニンファイルの長さ。 (単位：秒) |
ビットレート | String | 任意 | メザニンファイルのビットレート。 単位: Kbps |
FPS | String | 任意 | メザニンファイルのフレームレート (フレーム /秒) 。 メザニンファイルがオーディオファイルの場合、このパラメーターは使用できません。 |
Size | Long | 任意 | メザニンファイルのサイズ。 単位：バイト |
ErrorCode | String | 任意 | エラーコードを示します。 このパラメーターは、メザニンファイルの解析中にエラーが発生した場合に使用できます。 |
ErrorMessage | String | 任意 | エラーメッセージを示します。 このパラメーターは、メザニンファイルの解析中にエラーが発生した場合に使用できます。 |
Status値がfailの場合、メザニンファイルの分析に失敗し、メタデータは返されません。 失敗の典型的な理由は、メザニンファイルのカプセル化が異常であるためです。
サンプルコールバック
説明
HTTPコールバックの場合、次の例はHTTP POSTリクエストのボディです。
MNSコールバックの場合、次の例はメッセージ本文です。
Sample success callback message:
{
"VideoId":"84bd5b0566ddj39549986befd0e80 ****" 、
"期間":"12" 、
"高さ":"360" 、
"幅":"630" 、
"Fps":"30" 、
"ビットレート":"499" 、
"サイズ":"1234568" 、
"EventTime":"2018-11-28T10:12:48Z" 、
"EventType":"VideoAnalysisComplete" 、
"ステータス":"成功"
}サンプルエラーコールバックメッセージ:
{
"VideoId":"84bd5b0566ddj39549986befd0e80 ****" 、
"EventTime":"2018-11-28T10:12:48Z" 、
"EventType":"VideoAnalysisComplete" 、
"ステータス":"失敗" 、
"ErrorCode":"InvalidParameter.ResourceContentBad" 、
"ErrorMessage":"InputFileを操作するリソースが悪い"
}