Single-definition transcoding completion event, notification content, and callback example - ApsaraVideo VOD

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

イベントタイプ

StreamTranscodeComplete

イベントの説明

StreamTranscodeComplete イベントは、ビデオストリームが特定の解像度と形式（MP4 形式の SD ストリームなど）にトランスコードされたときに生成されます。単一の解像度のビデオストリームは、少なくとも 1 つの形式でトランスコードされた後、すぐに再生できます。

説明

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

イベントの内容

パラメーター名	タイプ	必須	説明
EventTime	String	はい	イベントが生成された時刻。時刻は、ISO 8601 標準の yyyy-MM-ddThh:mm:ssZ 形式に従います。時刻は UTC で表示されます。
EventType	String	はい	イベントタイプ。これは必須パラメーターです。値は StreamTranscodeComplete に固定されます。
VideoId	String	はい	ビデオの ID。
Status	String	はい	ビデオストリームのトランスコーディングステータス。 success：ジョブは成功しました。 fail：操作は失敗しました。
Bitrate	String	いいえ	ビデオストリームのビットレート。単位：Kbit/s。
Definition	String	いいえ	ビデオストリームの品質。有効な値： FD：低画質 LD：標準画質 HD：高画質 UHD：超高画質 OD：オリジナル画質 2K：2K 4K：4K AUTO：アダプティブビットレートストリーム
Duration	Double	いいえ	ビデオストリームの長さ。単位：秒。
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 で表示されます。
Extend	String	いいえ	パススルーモードで返されるユーザー定義パラメーター。詳細については、「リクエストパラメーター」をご参照ください。

サンプルコールバック

以下にコールバックの例を示します。

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

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

{ 
   "EventTime": "2017-03-20T07:49:17Z",
   "EventType": "StreamTranscodeComplete", 
   "VideoId": "43q9fj74hdf****", 
   "Status": "success",
   "Bitrate": "925",
   "Definition": "LD",
   "Duration": 15.0,
   "Encrypt": false,
   "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4",
   "Format": "mp4",
   "Fps": "30",
   "Height": 960,
   "Size": 1815321,
   "Width": 540,
   "JobId":"ddddddddddd",
   "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
   "IsAudio": false, 
   "StartTime": "2017-03-20T07:49:17Z",
   "FinishTime": "2017-03-20T09:49:17Z",
   "Extend":"test data"
}