ApsaraVideo Live:イベントコールバック

コンソールでの設定

1. ApsaraVideo Live コンソールにログインします。

2. 左側のナビゲーションウィンドウで、機能管理 > イベントコールバック を選択します。

3. 設定する アップストリーミングドメイン を選択します。

4. コールバックの設定 タブで、プッシュストリーミングコールバック スイッチを有効にし、以下のパラメーターを設定します。

   • コールバックタイプ： アップストリーミングおよび中断イベント、または例外イベントのコールバックを設定します。

   • コールバック URL： 通知を受信するためのパブリックエンドポイントです。アップストリーミングおよび中断イベントには HTTP GET を、例外イベントには HTTP POST を使用します。

   • コールバック認証： 認証を有効にするかどうかを選択します。有効にした場合は、認証キーを入力します。認証プロセスについては、「コールバック認証」をご参照ください。

5. [OK] をクリックします。

API による設定

インジェストおよび中断イベント

コールバックロジック

ストリームプッシュの場合、ApsaraVideo Live が OnPublish メッセージを受信した後、ライブソースが少なくとも 2 秒間接続されたままの場合、アップストリーミング成功のコールバックが送信されます。

ストリーミングドメイン（ドメイン B）に対してストリームフェッチング（固定時間またはオンデマンド）を使用し、コールバック通知が必要な場合は、関連付けられたアップストリーミングドメイン（ドメイン A）に対してストリームアップストリーミングコールバックを設定してください。ロジックは一貫しており、接続が確立され、ライブソースが少なくとも 2 秒間接続されたままの場合、ストリームフェッチングは成功と見なされます。

ApsaraVideo Live ライブセンターが 10 秒間データを受信しない場合、サービスは自動的にアップストリーミング接続を終了します。

パラメーター

インジェストイベントの例

http://1.1.X.X?action=publish&ip=192.168.0.1&id=world&app=example.aliyundoc.com&appname=liveApp****&time=1609220385&usrargs={user-defined-parameters}&node=cdnvideocenter01020711****.cm3&height=720&width=1280

中断イベントの例

http://1.1.X.X?action=publish_done&ip=192.168.0.0&id=world&app=example.aliyundoc.com&appname=liveApp****&time=1609220385&usrargs={user-defined-parameters}&node=cdnvideocenter01020711****.cm3&height=720&width=1280

例外イベントを取り込む

パラメーター

例外タイプ

例外イベントの例

{
  "action": "publish_exception_notify",
  "domain": "demo.aliyundoc.com",
  "appname": "liveApp****",
  "stream": "liveStream****",
  "ip": "141.01.****",
  "time": "1739760710",
  "type": "5002",
  "event_time": "1739760710"
}

コンソールでの設定

1. ApsaraVideo Live コンソールにログインします。

2. 左側のナビゲーションウィンドウで、機能管理 > イベントコールバック を選択します。

3. 設定する ストリーミングドメイン名 を選択します。

4. コールバックの設定 タブで、録画コールバック スイッチを有効にし、以下のパラメーターを設定します。

   • コールバック URL： 通知を受信するためのパブリックエンドポイントです。録画コールバックには HTTP POST リクエストを使用します。

   • トリガーイベント： File Generation または File Generation and Recording Status を選択します。

   • オンデマンドコールバック URL： オンデマンド録画を設定している場合、ライブストリームが開始されるとサービスはこの URL に対して HTTP コールバックを送信します。ストリームを録画するかどうかを決定するために、サーバーはこのリクエストに応答する必要があります。デフォルトでは、このパラメーターは * に設定されており、オンデマンド録画機能が無効になります。

   • コールバック認証： 認証を有効にするかどうかを選択します。有効にした場合は、認証キーを入力します。認証プロセスについては、「コールバック認証」をご参照ください。

5. [OK] をクリックします。

API による設定

録画ステータスコールバック

録画セッションの開始または一時停止時に送信されます。

パラメーター

例

{
  "domain": "demo.aliyundoc.com",
  "app": "liveApp****",
  "stream": "liveStream****",
  "event": "record_started"
}

ファイル生成コールバック

ファイル作成時に送信され、ファイルパス、持続時間、タイムスタンプなどの詳細を提供します。

パラメーター

例

アップストリーミング URL が rtmp://demo.aliyundoc.com/liveApp****/liveStream****?callback_args1=value1&callback_myid=1231389741 の場合、コールバックペイロードは次のようになります。

{
  "domain": "demo.aliyundoc.com",
  "app": "liveApp****",
  "stream": "liveStream****",
  "uri": "liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
  "file_url": "http://****.oss-****.aliyuncs.com/liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv",
  "duration": 69.403,
  "start_time": 1488985786,
  "stop_time": 1488985840,
  "push_args": {
    "callback_args1": "value1",
    "callback_myid": "1231389741"
  }
}

録画エラーコールバック

ソースストリームの例外またはストレージへの書き込み失敗（OSS）によってトリガーされます。

パラメーター

録画エラーの例

{
  "domain": "example.com",
  "app": "live",
  "stream": "stream123",
  "event": "record_error",
  "error_info": {
    "code": "TsSegmenterFail",
    "message": "ts segmenter error"
  }
}

エラーコード

リマックスエラーの例

{
  "domain": "example.com",
  "app": "live",
  "stream": "stream123",
  "event": "transformat_error",
  "error_info": {
    "code": "PermissionDenied.ResourceAccess",
    "message": "MTS not authorized to operate on the OutputBucket"
  },
  "file_info": {
    "uri": "record/live/stream123/2025-11-19-03-17-03_2025-11-19-03-28-39.flv",
    "start_time": 1763493420,
    "stop_time": 1763494119
  }
}

エラーコード

リクエストパラメーター

リクエスト例

GET /?app=seq_all&domain=demo.aliyundoc.com&stream=ondemand8&vbitrate=2000&codec=h264 HTTP/1.1
Host: pull.aliyundoc.com
User-Agent: Go-http-client/1.1
Accept-Encoding: gzip

レスポンスパラメーター

レスポンス例

{
  "ApiVersion": "1.0",
  "NeedRecord": true,
  "Interval": {
    "Mp4": 300,
    "Flv": 120,
    "M3U8": 180
  },
  "Format": ["mp4","flv"]
}

レスポンス処理

録画サービスは、既存の構成を上書きするためにレスポンスを処理します。

• Interval： 提供された Interval 値は、録画テンプレートで設定された録画サイクルを上書きします。

• Format： サービスは、要求された Format と録画テンプレートで事前設定されたフォーマットとの共通部分を計算します。共通のフォーマットがない場合、ストリームは録画されません。

200 以外の HTTP ステータスコードは、API エンドポイントへの呼び出しが失敗したことを示します。

レスポンスボディは 2,048 バイトを超えることはできません。セキュリティ上の理由から、この制限を超えるコンテンツはシステムによって切り捨てられます。

コンソールでの設定

1. ApsaraVideo Live コンソールにログインします。

2. 左側のナビゲーションウィンドウで、機能管理 > イベントコールバック を選択します。

3. 設定する ストリーミングドメイン名 を選択します。

4. コールバックの設定 タブで、スナップショットコールバック スイッチを有効にし、以下のパラメーターを設定します。

   • コールバック URL： 通知を受信するためのパブリックエンドポイントです。スナップショットコールバックには HTTP POST リクエストを使用します。

   • コールバック認証： 認証を有効にするかどうかを選択します。有効にした場合は、認証キーを入力します。認証プロセスについては、「コールバック認証」をご参照ください。

5. [OK] をクリックします。

API 構成

スナップショットコールバックパラメーター

例

{
  "Event": "Snapshot",
  "DomainName": "demo.aliyundoc.com",
  "AppName": "liveApp****",
  "StreamName": "liveStream****",
  "OssBucket": "liveBucket****",
  "OssEndpoint": "oss-cn-shan****.aliyuncs.com",
  "OssObject": "1****.jpg",
  "CreateTime": "2015-12-01T17:36:00Z",
  "SnapshotUrl": "http://liveBucket****.oss-cn-shan****.aliyuncs.com/1****.jpg",
  "Size": "36291",
  "Width": "1280",
  "Height": "720"
}

ビデオモデレーションコールバック

問題があると判断されたビデオコンテンツに対してのみトリガーされます。

{
  "DomainName": "demo.aliyundoc.com",
  "AppName": "liveApp****",
  "StreamName": "liveStream****",
  "OssEndpoint": "oss-cn-hang****.aliyuncs.com",
  "OssBucket": "liveBucket****",
  "OssObject": "example.jpg",
  "Result": [
    {
      "BizType": "demo.aliyundoc.com",
      "Result": [
        {"Label": "Porn", "Rate": 11, "Suggestion": "review", "Scene": "porn", "Extent": {}},
        {"Label": "Ad", "Rate": 11, "Suggestion": "review", "Scene": "ad", "Extent": {}}
      ]
    }
  ]
}

オーディオモデレーションコールバック

問題があると判断されたオーディオコンテンツに対してのみトリガーされます。

{
  "DomainName": "example.aliyundoc.com",
  "AppName": "liveApp****",
  "StreamName": "5d9747eba39b44769852d276f9ff****",
  "Timestamp": 1572248095,
  "Result": [
    {
      "Scene": "antispam",
      "Label": "ad",
      "Suggestion": "block",
      "Rate": 99.91,
      "Details": [
        {
          "StartTime": 1572248023,
          "EndTime": 1572248040,
          "Text": "ホテルでは 120 日間の無料宿泊が提供されます。友人や家族と共有できます。団結街 96 番地のレセプションセンターまでお越しください。ホットライン：2285699。",
          "Label": "ad"
        },
        {
          "StartTime": 1572248040,
          "EndTime": 1572248070,
          "Text": "温泉リゾートタウンの中心部に位置する、希少なクラシックヴィラのコレクションをご発見ください。有名な龍多温泉や歴史的な梁河金塔の隣にあり、贅沢と自然が融合する場所です。",
          "Label": "normal"
        },
        {
          "StartTime": 1572248072,
          "EndTime": 1572248077,
          "Text": "楽しいひとときと居心地のよい日々を、美しい皆さまと共に、より気楽にお過ごしください。",
          "Label": "normal"
        },
        {
          "StartTime": 1572248078,
          "EndTime": 1572248086,
          "Text": "fme043 忙しさから少し離れて、居心地のよい音楽と映画でお過ごしください。",
          "Label": "normal"
        }
      ]
    }
  ]
}

コンソールでの設定

1. ApsaraVideo Live コンソールにログインします。

2. 左側のナビゲーションウィンドウで、機能管理 > イベントコールバック を選択します。

3. 設定する アップストリーミングドメイン を選択します。

4. コールバックの設定 タブで、デュアルストリームディザスタリカバリコールバック スイッチを有効にし、コールバック URL を設定します。

5. [OK] をクリックします。

コールバックパラメーター

例

{
  "action": "multistream_set_master_result",
  "domain": "demo.aliyundoc.com",
  "appname": "liveApp****",
  "streamname": "liveStream****",
  "upstreamsequence": "main",
  "upstreamip": "203.**.***.10",
  "upstreamtime": 17*****710,
  "changereason": "merge_cut_manually",
  "changetime": 17*****705,
  "time": 17*****706
}