このトピックでは、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 必須 メザニンファイルを分析するかどうかを示します。 設定可能な値は以下のとおりです。
  • success: メザニンファイルが分析されます。
  • fail: メザニンファイルの分析に失敗しました。
幅 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を操作するリソースが悪い"
  }