このトピックでは、StreamTranscodeCompleteイベントについて説明し、コールバックのサンプルを示します。
イベントタイプ
StreamTranscodeComplete
イベントの説明
StreamTranscodeCompleteイベントは、ビデオストリームが、MP4形式のSDストリームなど、特定の定義および形式にトランスコードされるときに生成されます。 単一解像度のビデオストリームは、ビデオストリームが少なくとも1つのフォーマットでトランスコードされた直後に再生することができます。
URL署名を有効にしている場合は、URLに基づいてビデオを再生するauth_keyを生成する必要があります。 それ以外の場合、HTTP 403
のエラーコードが返されます。 URL署名の詳細については、「URL認証の設定」をご参照ください。
イベント通知
パラメーター | タイプ | 必須 | 説明 |
EventTime | String | 必須 | イベントが生成された時刻。 時間はyyyy-MM-ddThh:mm:ssZ形式のISO 8601標準に従います。 時刻は UTC で表示されます。 |
EventType | String | 必須 | イベントタイプ。 値はStreamTranscodeCompleteです。 |
VideoId | String | 必須 | ビデオのID。 |
Status | String | 必須 | ビデオストリームがトランスコードされているかどうかを示します。 有効な値:
|
ビットレート | String | 任意 | ビデオストリームのビットレート。 単位:Kbit/秒 |
定義 | String | 任意 | ビデオストリームの品質。 有効な値:
|
有効期間 | Double | 選択可能 | ビデオストリームの長さ。 単位は秒です。 |
Codec | String | 任意 | ビデオストリームのコーデック。 |
Encrypt | ブール値 | 選択可能 | ビデオストリームが暗号化されているかどうかを示します。 |
暗号化タイプ | String | 任意 | 暗号化タイプ。 |
ErrorCode | String | 任意 | エラーコードを示します。 このパラメーターは、ビデオストリームのトランスコード中にエラーが発生した場合に返されます。 |
エラーメッセージ | String | 任意 | エラーメッセージを示します。 このパラメーターは、ビデオストリームのトランスコード中にエラーが発生した場合に返されます。 |
FileUrl | String | 任意 | ビデオストリームの再生URL。 URLにはauth_keyが含まれていません。 URL署名を有効にしている場合は、URLに基づいてビデオを再生するauth_keyを生成する必要があります。 |
Format | String | 任意 | ビデオストリームの形式。
|
FPS | String | 任意 | ビデオストリームのフレームレート。 単位: FPS。 |
Height | Long | 選択可能 | ビデオストリームの高さ。 単位: ピクセル。 |
Size | Long | 選択可能 | ビデオストリームのサイズ。 単位はバイトです。 |
幅 | Long | 選択可能 | ビデオストリームの幅。 単位: ピクセル。 |
JobId | String | 任意 | コード変換ジョブのID。 |
WatermarkId | String | 任意 | 透かしのID。 複数のIDはコンマ (,) で区切ります。 |
IsAudio | Boolean | 必須 | ストリームがオーディオストリームかどうかを示します。 |
StartTime | String | 必須 | タスクの開始時間。 時刻は UTC で表示されます。 |
FinishTime | String | 必須 | タスクの終了時間。 時刻は UTC で表示されます。 |
拡張 | 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", "Codec":"h264", "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", "IsAudio": false, "StartTime": "2017-03-20T07:49:17Z", "FinishTime": "2017-03-20T09:49:17Z", "Extend":"test data" }