このトピックでは、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 | はい | ビデオストリームがトランスコードされたかどうかを示します。有効な値：
|
Bitrate | String | いいえ | ビデオストリームのビットレート。単位：Kbit/s。 |
Definition | String | いいえ | ビデオストリームの品質。有効な値：
|
Duration | Double | いいえ | ビデオストリームの長さ。単位：秒。 |
Codec | String | いいえ | ビデオストリームのコーデック。 |
Encrypt | Boolean | いいえ | ビデオストリームが暗号化されているかどうかを示します。 |
ErrorCode | String | いいえ | エラーコード。ビデオストリームのトランスコード中にエラーが発生した場合に、このパラメーターが返されます。 |
ErrorMessage | String | いいえ | エラーメッセージ。ビデオストリームのトランスコード中にエラーが発生した場合に、このパラメーターが返されます。 |
FileUrl | String | いいえ | ビデオストリームの再生 URL。URL には auth_key は含まれていません。URL 署名を有効にしている場合は、URL に基づいてビデオを再生するための auth_key を生成する必要があります。 |
Format | String | いいえ | ビデオストリームの形式。
|
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****", // ビデオ ID "Status": "success", // ステータス "Bitrate": "925", // ビットレート "Definition": "LD", // 解像度 "Duration": 15.0, // 再生時間 "Encrypt": false, // 暗号化されているか "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4", // ファイル URL "Format": "mp4", // 形式 "Fps": "30", // フレームレート "Height": 960, // 高さ "Size": 1815321, // サイズ "Width": 540, // 幅 "JobId":"ddddddddddd", // ジョブ ID "Codec":"h264", // コーデック "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", // ウォーターマーク ID "IsAudio": false, // オーディオストリームか "StartTime": "2017-03-20T07:49:17Z", // 開始時刻 "FinishTime": "2017-03-20T09:49:17Z", // 終了時刻 "Extend":"test data" // 拡張データ }