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

コンソールでの設定

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

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

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

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

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

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

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

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

取り込み成功の追加の確認方法

アップストリーミングコールバックに加えて、以下の方法でストリームが正常にアップストリーミングされたかを確認できます。

• Web プレーヤーで canplay イベントをリッスンする：Web プレーヤーを初期化した後、ストリームをアップストリーミングしてから再生します。ストリームが存在し、再生可能な場合、canplay イベントがトリガーされます。ストリームが存在しない場合は、エラーが返されます。

• RTS デモページでストリームを検証する：[アップストリーミング] タブで、アップストリーミング URL を入力し、ローカルストリームを作成してからアップストリーミングを開始します。[ストリーミング] タブに切り替え、artc:// プロトコルを使用する必要があるストリーミング URL を入力し、再生を開始してストリームが正常に再生されるかを確認します。

これらの方法は補助的な確認手段です。アップストリーミングコールバックを使用してアップストリーミングステータスを判断することを推奨します。

API による設定

アップストリーミングおよび中断イベント

コールバックロジック

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

ストリーミングドメイン (ドメイン 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 リクエストを使用します。

   • トリガーイベント：[ファイル生成] または [ファイル生成と録画ステータス] を選択します。

   • オンデマンドコールバック 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
}