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

イベントタイプ

StreamTranscodeComplete

Event description

The StreamTranscodeComplete event is generated after a video stream in a single definition and format (such as an SD stream in the MP4 format) is transcoded. A video stream in a single resolution can be played immediately after the video stream is transcoded in at least one format.

注 URL署名を有効にしている場合は、ビデオの再生URLにアクセスするために独自のauth_keyを生成する必要があります。 それ以外の場合、リクエストに対してHTTP 403のエラーコードが返されます。 URL署名の詳細については、「URL認証の設定」をご参照ください。

イベント通知コンテンツ

フィールド データ型 必須／任意 説明
EventTime String 必須 イベントが生成された時刻。 時刻はyyyy-MM-ddTHH:mm:ssZ形式でUTCで表示されます。
EventType String 必須 イベントタイプ。 値はStreamTranscodeCompleteです。
VideoId String 必須 ビデオのID。
ステータス String 必須 ビデオストリームがトランスコードされているかどうかを示します。 設定可能な値は以下のとおりです。
  • success: ビデオストリームがトランスコードされています。
  • fail: ビデオストリームのトランスコードに失敗しました。
ビットレート String 任意 ビデオストリームのビットレート。 単位：Kbit/s
定義 String 任意 ビデオストリームの定義。 設定可能な値は以下のとおりです。
  • FD: 低い定義
  • LD: 標準定義
  • SD: 高い定義
  • HD: 超高い定义
  • OD: オリジナル定義
  • 2K
  • 4K
  • AUTO: アダプティブ
有効期間 Float 任意 ビデオストリームの長さ。 (単位：秒)
Encrypt Boolean 任意 ビデオストリームが暗号化されているかどうかを示します。
ErrorCode String 任意 エラーコードを示します。 This parameter is available when an error occurs while the video stream is being transcoded.
ErrorMessage String 任意 エラーメッセージを示します。 このパラメーターは、ビデオストリームのトランスコード中にエラーが発生した場合に使用できます。
FileUrl String 任意 The playback URL of the video stream. The URL does not carry the signing auth_key. If you have enabled URL signing, you must generate your own auth_key to access the playback URL of the video stream.
形式 String 任意 ビデオストリームの形式。 設定可能な値は以下のとおりです。
  • mp4
  • m3u8
FPS String 任意 ビデオストリームのフレームレート (フレーム /秒) 。
Height Long 任意 ビデオストリームの高さ。 単位: ピクセル
Size Long 任意 ビデオストリームのサイズ。 単位：バイト
幅 Long 任意 ビデオストリームの幅。 単位: ピクセル
JobId String 任意 コード変換ジョブのID。
拡張 String 任意 コールバックのパススルーモードで返されるユーザー定義パラメーター。 詳細については、「UserData」をご参照ください。

サンプルコールバック

説明

  • HTTPコールバックの場合、次の例はHTTP POSTリクエストのボディです。
  • MNSコールバックの場合、次の例はメッセージ本文です。
{ 
   "EventTime": "2017-03-20T07:49:17Z" 、
   "EventType": "StreamTranscodeComplete" 、 
   "VideoId": "43q9fj74hdf ****" 、 
   "ステータス": "成功" 、
   "ビットレート": "925" 、
   "定義": "LD" 、
   "期間": 15.0、
   "暗号化": false、
   // FileUrlの例: http://example.aliyundoc.com/DBEBDEAJS73J79BE4D ****/52a53151eba5js73ke2da3b55bc5 ****.mp4
   "FileUrl": "<your FileURL>" 、
   "フォーマット": "mp4" 、
   "Fps": "30" 、
   "高さ": 960、
   「サイズ」: 1815321、
   "幅": 540、
   "JobId":"ddddddddddd" 、
   "Extend":"テストデータ"
}