Content and callback examples for the TranscodeComplete event - ApsaraVideo VOD

本トピックでは、TranscodeComplete イベント、その通知内容、およびコールバックの例について説明します。

イベントタイプ

TranscodeComplete

イベントの説明

TranscodeComplete イベントは、すべてのビデオストリームがトランスコードされた後に生成されます。

説明

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

イベント内容

パラメーター名	タイプ	必須	説明
EventTime	String	はい	イベントが生成された時刻。時刻は UTC 形式 (yyyy-MM-ddTHH:mm:ssZ) です。
EventType	String	はい	イベントタイプ。必須パラメーターです。値は TranscodeComplete に固定されています。
VideoId	String	はい	ビデオ ID。
Status	String	はい	ビデオのトランスコードステータス。少なくとも 1 つのストリームが正常にトランスコードされた場合、ステータスは success になります。 success：操作は成功しました。 fail：操作は失敗しました。
Extend	String	いいえ	コールバック用のカスタムのパススルーデータ。詳細については、「リクエストパラメーター」をご参照ください。
StreamInfos	Array	いいえ	下記のビデオストリーム情報テーブルをご参照ください。

StreamInfos は配列です。次の表に、各ストリームのフィールドを示します。

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

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

コールバックの例

コールバックの例に関する注意事項：

HTTP コールバックの場合、次の内容は HTTP POST の本文です。

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

{ 
  "EventTime": "2017-03-20T07:49:17Z",
  "EventType": "TranscodeComplete", 
  "VideoId": "43q9fjsh73f****", 
  "Status": "success",
  "Extend":"test data",
  "StreamInfos": 
  [
   {
     "Status": "success",
     "Bitrate": "925",
     "Definition": "LD",
     "Duration": 15,
     "Encrypt": false,
     "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4",
     "Format": "mp4",
     "Fps": "30",
     "Height": 960,
     "Size": 1815321,
     "Width": 540,
     "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
     "IsAudio": false, 
     "StartTime": "2017-03-20T07:49:17Z",
     "FinishTime": "2017-03-20T09:49:17Z",
     "JobId":"ffffffffff"
   },
   {
     "Status": "success",
     "Bitrate": "1575",
     "Definition": "SD",
     "Duration": 15,
     "Encrypt": false,
     "FileUrl": "http://example.aliyundoc.com/ABEBDE1JSU79FD4D****/62cb3151eba52js82j2da3b55bc5****.mp4",
     "Format": "mp4",
     "Fps": "30",
     "Height": 960,
     "Size": 3090951,
     "Width": 540,
     "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
     "IsAudio": false, 
     "StartTime": "2017-03-20T07:49:17Z",
     "FinishTime": "2017-03-20T09:49:17Z",
     "JobId":"ddddddddddd"
   }
  ]
}