すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:StreamTranscodeComplete

最終更新日:Oct 25, 2024

このトピックでは、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

任意

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

  • FD: 低い定義

  • LD: 標準定義

  • SD: 高い定義

  • HD: 超高い定义

  • OD: オリジナル定義

  • 2K

  • 4K

  • AUTO: アダプティブ

有効期間

Double

選択可能

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

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 で表示されます。

拡張

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"
    }