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

ApsaraVideo Live:プロダクションスタジオのコールバック

最終更新日:Sep 04, 2024

このトピックでは、プロダクションスタジオのコールバックのリクエストパラメーターについて説明し、これらのコールバックの例を示します。

リクエストパラメーター

パラメーター

データ型

必須

説明

CasterId

String

課金されません

プロダクションスタジオのID。

  • このパラメーターは、EventTypeパラメーターをOperateCallbackまたはRuntimeErrorCallbackに設定する場合に必要です。

  • EventTypeパラメーターをEpisodeGroupCallbackに設定した場合、このパラメーターはオプションです。

EventType

String

課金されます

イベントのタイプ。

  • OperateCallback: 操作のコールバック。

  • RuntimeErrorCallback: ランタイムエラーのコールバック。

  • EpisodeGroupCallback: カルーセル再生用のコールバック。

  • ShowListDTSCallback: プロダクションスタジオがプレイリストモードの場合、現在のエピソードの再生進行状況をコールバックします。

EventMessage

EventMessage

課金されます

イベントの説明。 詳細については、このトピックのEventMessageセクションを参照してください。

EventMessage

  • 次の表では、EventTypeパラメーターをOperateCallbackまたはRuntimeErrorCallbackに設定した場合のEventMessageパラメーターのフィールドについて説明します。

    項目

    データ型

    必須

    説明

    RequestId

    String

    課金されません

    リクエストの ID。 このフィールドは、EventTypeパラメーターをOperateCallbackに設定する場合に必要です。

    SceneId

    String

    課金されません

    シーンのID。 このフィールドはシーンイベントに必要です。

    LayoutId

    String

    課金されません

    レイアウトのID。 このフィールドは、レイアウトイベントに必要です。

    ResourceId

    String

    課金されません

    リソースの ID です。 このフィールドは、ビデオソースイベントに必要です。

    ComponentId

    String

    課金されません

    コンポーネントのID。 このフィールドはコンポーネントイベントに必要です。

    Code

    String

    課金されません

    ステータスコード。

    Message

    String

    課金されません

    イベントのメッセージ。

  • 次の表に、EventTypeパラメーターをEpisodeGroupCallbackに設定した場合のEventMessageパラメーターのフィールドを示します。

    項目

    データ型

    必須

    説明

    ProgramId

    String

    課金されます

    カルーセル再生のエピソードリストのID。

    EpisodeId

    String

    課金されます

    エピソードのID。

    Code

    String

    課金されません

    ステータスコード。

    Message

    String

    課金されません

    イベントのメッセージ。

  • 次の表では、EventTypeパラメーターをShowListDTSCallbackに設定した場合のEventMessageパラメーターのフィールドについて説明します。

    項目

    データ型

    必須

    説明

    ProgressTime

    String

    課金されます

    エピソードの再生の進行状況。 単位:ミリ秒。

    ShowId

    String

    課金されます

    エピソードのID。

    有効期間

    String

    課金されます

    エピソードの全長。

    ShowName

    String

    課金されます

    エピソードの名前。

ステータスコード

ステータスコード

説明

Success

操作は正常終了しました。

StreamInterrupt (StreamInterrupt)

ライブストリームまたはファイルの再生が予期せず終了します。

CanvasStreamInterrupt

キャンバスストリームが予期せず終了しました。

AudioResampleFailed

オーディオのリサンプリングに失敗しました。

AudioAddFailed

オーディオソースの追加に失敗しました。

AudioDelFailed

オーディオソースの削除に失敗しました。

AudioStreamTypeInvalid

オーディオストリームのタイプの解析に失敗しました。

VideoTypeInvalid

レイヤーのタイプの解析に失敗しました。

VideoVisibleInvalid

レイヤー要素の可視性の解析に失敗しました。

VideoTransparencyInvalid

レイヤー要素の透明度値の解析に失敗しました。

VideoEffectInvalid

レイヤー要素のエフェクト値の解析に失敗しました。

VideoWidthInvalid

レイヤー要素の幅の正規化された値の解析に失敗しました。

VideoPositionReferInvalid

レイヤー要素の参照軸の解析に失敗しました。

VideoStreamTypeInvalid

メディアタイプの解析に失敗しました。 メディアタイプには、ライブストリームとファイルが含まれます。

VideoRepeatNumInvalid

ビデオオンデマンド (VOD) ファイルが繰り返された回数の解析に失敗しました。

VideoStreamAddFailed

ライブストリームの追加に失敗しました。

ImageOpenFailed

イメージを開けませんでした。

ImageGetDecodeInfoFailed

画像のデコード情報の照会に失敗しました。

ImageDecodeFailed

画像のデコードに失敗しました。

TextInvalid

テキストの解析に失敗しました。

TextFontInvalid

テキストのフォントの解析に失敗しました。

TextSizeInvalid

テキストのフォントサイズの正規化された値の解析に失敗しました。

TextBorderWidthInvalid

テキストの境界線幅の正規化された値の解析に失敗しました。

CanvasLoadFailed

キャンバスストリームの読み込みに失敗しました。

SideOutputUrlInvalid

ストリームリダイレクトURLが無効です。

操作のコールバック

 {
    "CasterId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
    "EventType": "OperateCallback",
    "EventMessage": {
        "RequestId": "26A96B9A-A201-4EC3-8E43-CB92E68FA132",
        "SceneId": "35716B9A-A201-4EC3-8E43-CB92E68F****",
        "ComponentId": "06196B9A-A201-4EC3-8E43-CB92E68F****",
        "Code": "ImageOpenFailed",
        "Message": "Fail to open image: http://XXXX/XXXX.jpg"
    }
}

ランタイムエラーのコールバック

{
    "CasterId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
    "EventType": "RuntimeErrorCallback",
    "EventMessage": {
      "Code": "StreamInterrupt",
      "Message": "Failed to open stream: rtmp://DOMAIN/APP/STREAM"
    }
}

再生の進行状況のコールバック

{
  "EventMessage": {
    "ProgressTime": "116796",
    "ShowId": "9ef1db9d-5e24-4e5f-b161-8a2429d9b882",
    "Duration": "396847",
    "ShowName": "test.mp4"
  },
  "EventType": "ShowListDTSCallback",
  "ResponseTime": 1663731128684,
  "CasterId": "3761c920-dfa6-40c7-a79c-2886b1493996"
}