すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:TranscodeComplete

    ドキュメントセンター

    ApsaraVideo VOD:TranscodeComplete

    最終更新日:Oct 25, 2024

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

    イベントタイプ

    TranscodeComplete

    イベントの説明

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

    説明

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

    イベント通知

    パラメーター

    タイプ

    必須

    説明

    EventTime

    String

    必須

    イベントが生成された時刻。 時間はyyyy-MM-ddThh:mm:ssZ形式のISO 8601標準に従います。 時刻は UTC で表示されます。

    EventType

    String

    必須

    イベントタイプ。 値はTranscodeCompleteです。

    VideoId

    String

    必須

    ビデオのID。

    Status

    String

    必須

    ビデオストリームがトランスコードされているかどうかを示します。 値は、1つのビデオストリームがトランスコードされている限り成功です。 有効な値：

    • 成功

    • 失敗

    拡張

    String

    任意

    コールバックのパススルーモードで返されるユーザー定義パラメーター。 詳細は、「リクエストパラメーター」をご参照ください。

    StreamInfos

    配列

    選択可能

    ビデオストリームの詳細。 詳細については、次の表を参照してください。

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

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

    項目

    タイプ

    必須

    説明

    Status

    String

    任意

    ビデオストリームがトランスコードされているかどうかを示します。 有効な値：

    • 成功

    • 失敗

    ビットレート

    String

    任意

    ビデオストリームのビットレート。 単位：Kbit/秒

    定義

    String

    任意

    ビデオストリームの品質。 有効な値：

    • FD: 低い定義

    • LD: 標準定義

    • SD: 高い定義

    • HD: 超高い定义

    • OD: オリジナル定義

    • 2K

    • 4K

    • AUTO: アダプティブ

    有効期間

    浮く

    選択可能

    ビデオストリームの長さ。 単位は秒です。

    Codec

    String

    任意

    ビデオストリームのコーデック。

    Encrypt

    ブール値

    選択可能

    ビデオストリームが暗号化されているかどうかを示します。

    暗号化タイプ

    String

    任意

    暗号化タイプ。

    ErrorCode

    String

    任意

    エラーコードを示します。 このパラメーターは、ビデオストリームのトランスコード中にエラーが発生した場合に返されます。

    エラーメッセージ

    String

    任意

    エラーメッセージを示します。 このパラメーターは、ビデオストリームのトランスコード中にエラーが発生した場合に返されます。

    FileUrl

    String

    任意

    ビデオストリームの再生URL。 URLにはauth_keyが含まれていません。 URL署名を有効にしている場合は、URLに基づいてビデオを再生するauth_keyを生成する必要があります。

    Format

    String

    任意

    ビデオストリームの形式。

    • mp4

    • m3u8

    FPS

    String

    任意

    ビデオストリームのフレームレート。 単位: FPS。

    Height

    Long

    選択可能

    ビデオストリームの高さ。 単位: ピクセル。

    Size

    Long

    選択可能

    ビデオストリームのサイズ。 単位はバイトです。

    幅

    Long

    選択可能

    ビデオストリームの幅。 単位: ピクセル。

    JobId

    String

    任意

    コード変換ジョブのID。

    WatermarkId

    String

    任意

    透かしのID。 複数の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,
     "Codec":"h264",
     "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,
     "Codec":"h264",
     "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
     "IsAudio": false, 
     "StartTime": "2017-03-20T07:49:17Z",
     "FinishTime": "2017-03-20T09:49:17Z",
     "JobId":"ddddddddddd"
   }
  ]
}