TranscodeComplete イベントのコンテンツとコールバックの例 - ApsaraVideo VOD

このトピックでは、TranscodeComplete イベントについて説明し、サンプルコールバックを提供します。

イベントタイプ

TranscodeComplete

イベントの説明

TranscodeComplete イベントは、動画のすべてのトランスコードストリームが生成されたときに生成されます。

説明

URL 署名が有効になっている場合、再生 URL にアクセスするには auth_key を生成する必要があります。そうしないと、HTTP 403 エラーが返されます。URL 署名の詳細については、「URL 署名を構成する」をご参照ください。

イベント通知

パラメーター	タイプ	必須	説明
EventTime	String	はい	イベントが生成された時刻。時刻は、ISO 8601 標準の yyyy-MM-ddThh:mm:ssZ 形式に従います。時刻は UTC で表示されます。
EventType	String	はい	イベントタイプ。値は [transcodecomplete] です。
VideoId	String	はい	動画の ID。
Status	String	はい	ビデオストリームがトランスコードされているかどうかを示します。 1 つのビデオストリームがトランスコードされている限り、値は success です。有効な値： [success] [fail]
Extend	String	いいえ	コールバックでパススルーモードで返されるユーザー定義パラメーター。詳細については、「リクエストパラメーター」をご参照ください。
StreamInfos	Array	いいえ	ビデオストリームの詳細。詳細については、次の表を参照してください。

StreamInfos の値は配列です。次の表は、各ストリームのこのパラメーターのフィールドについて説明しています。

表 1. ビデオストリーム情報

名前	タイプ	必須	説明
Status	String	いいえ	ビデオストリームがトランスコードされているかどうかを示します。有効な値： [success] [fail]
Bitrate	String	いいえ	ビデオストリームのビットレート。単位：Kbit/s。
Definition	String	いいえ	ビデオストリームの解像度。プリセットテンプレートとナローバンド HD テンプレートの場合、サフィックスが解像度に追加されます。例: HD-MP4。 [FD]：低解像度 [LD]：標準解像度 [SD]：高解像度 [HD]：超高解像度 OD: 元の定義 [2K] [4K] [AUTO]：アダプティブ
Duration	Float	いいえ	ビデオストリームの長さ。単位：秒。
Codec	String	いいえ	ビデオストリームのコーデック。
Encrypt	Boolean	いいえ	ビデオストリームが暗号化されているかどうかを示します。
ErrorCode	String	いいえ	エラーコード。ビデオストリームのトランスコード中にエラーが発生した場合に、このパラメーターが返されます。
ErrorMessage	String	いいえ	エラーメッセージ。ビデオストリームのトランスコード中にエラーが発生した場合に、このパラメーターが返されます。
FileUrl	String	いいえ	ビデオストリームの再生 URL。 URL には auth_key は含まれていません。 URL 署名を有効にしている場合は、URL に基づいて動画を再生するための auth_key を生成する必要があります。
Format	String	いいえ	ビデオストリームのフォーマット。 [mp4] [m3u8]
Fps	String	いいえ	ビデオストリームのフレームレート。単位：FPS。
Height	Long	いいえ	ビデオストリームの高さ。単位：ピクセル。
Size	Long	いいえ	ビデオストリームのサイズ。単位：バイト。
Width	Long	いいえ	ビデオストリームの幅。単位：ピクセル。
JobId	String	いいえ	トランスコーディングジョブの ID。
WatermarkId	String	いいえ	ウォーターマークの ID。複数の ID はカンマ (,) で区切ります。
IsAudio	Boolean	はい	ストリームがオーディオストリームかどうかを示します。
StartTime	String	はい	タスクの開始時刻。時刻は UTC で表示されます。
FinishTime	String	はい	タスクの終了時刻。時刻は UTC で表示されます。

サンプルコールバック

説明：

HTTP コールバックの場合、次の例は HTTP POST リクエストのメッセージ本文です。

MNS コールバックの場合、次の例はメッセージ本文です。

{
  "EventTime": "2017-03-20T07:49:17Z", // イベント発生時刻
  "EventType": "TranscodeComplete", // イベントタイプ
  "VideoId": "43q9fjsh73f****", // ビデオID
  "Status": "success", // ステータス
  "Extend":"test data", // 拡張データ
  "StreamInfos":
  [
   {
     "Status": "success", // ストリームステータス
     "Bitrate": "925", // ビットレート
     "Definition": "LD", // 解像度
     "Duration": 15, // 再生時間
     "Encrypt": false, // 暗号化の有無
     "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4", // ファイルURL
     "Format": "mp4", // フォーマット
     "Fps": "30", // フレームレート
     "Height": 960, // 高さ
     "Size": 1815321, // サイズ
     "Width": 540, // 幅
     "Codec":"h264", // コーデック
     "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", // ウォーターマークID
     "IsAudio": false, // オーディオストリームかどうか
     "StartTime": "2017-03-20T07:49:17Z", // 開始時刻
     "FinishTime": "2017-03-20T09:49:17Z", // 終了時刻
     "JobId":"ffffffffff" // ジョブID
   },
   {
     "Status": "success", // ストリームステータス
     "Bitrate": "1575", // ビットレート
     "Definition": "SD", // 解像度
     "Duration": 15, // 再生時間
     "Encrypt": false, // 暗号化の有無
     "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4", // ファイルURL
     "Format": "mp4", // フォーマット
     "Fps": "30", // フレームレート
     "Height": 960, // 高さ
     "Size": 3090951, // サイズ
     "Width": 540, // 幅
     "Codec":"h264", // コーデック
     "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", // ウォーターマークID
     "IsAudio": false, // オーディオストリームかどうか
     "StartTime": "2017-03-20T07:49:17Z", // 開始時刻
     "FinishTime": "2017-03-20T09:49:17Z", // 終了時刻
     "JobId":"ddddddddddd" // ジョブID
   }
  ]
}