ApsaraVideo Live:コールバック設定の構成

使用上の注意

ApsaraVideo Liveは、HTTPおよびHTTPSコールバックを使用したイベント通知をサポートしています。 HTTPサービスをデプロイしてコールバックメッセージを受信し、ApsaraVideo Liveコンソールを使用するかAPI操作を呼び出してコールバックURLを設定する必要があります。

• ストリーム取り込みが開始または中断されると、ApsaraVideo Liveは指定されたコールバックURLにHTTP GETリクエストを送信します。 特定のイベントコンテンツは、URLパラメータに含まれる。

• 他のイベントがトリガーされると、ApsaraVideo Liveは指定されたコールバックURLにHTTP POSTリクエストを送信します。 特定のイベントコンテンツは、JSON形式のリクエストボディに含まれます。

シナリオ

ライブストリーミング中にイベントがトリガーされると、Alibaba Cloudがサーバーにリクエストを送信し、サーバーがリクエストに応答します。 リクエストが検証に合格すると、JSON形式のデータを含むコールバックメッセージが返されます。

ApsaraVideo Liveは、ストリーム取り込みステータス、ライブストリーム録画 (オンデマンド録画) 、ライブストリームスナップショット、コンテンツモデレーション (ビデオモデレーションとオーディオモデレーション) などのイベントのコールバックをサポートしています。 コールバックパラメーターとさまざまなコールバックイベントの例については、「コールバックの管理」をご参照ください。

制限事項

• コールバックURLは識別子を必要としませんが、アクセス可能でなければなりません。 特定のタイムアウト期間内にURLから応答が返されない場合、ApsaraVideo LiveはURLへのアクセスを再試行します。 現在のタイムアウト時間は5秒です。 5秒以内に応答が返されない場合、ApsaraVideo Liveは1秒間隔で最大5回URLへのアクセスを再試行します。

• 取り込みドメインのみのストリーム取り込みコールバックを設定および変更できます。 ストリーミングドメインに対してのみ、記録コールバック、スナップショットコールバック、ビデオモデレーションコールバック、およびオーディオモデレーションコールバックを設定および変更できます。

機能の説明

コールバックは、ストリーム取り込みコールバックとストリーミングコールバックに分けられます。

• ストリーム取り込みコールバック: 取り込みドメインのストリーム取り込みコールバックとコールバック認証を設定できます。

• ストリーミングコールバック: ストリーミングドメインに対して、録音コールバック、スナップショットコールバック、ビデオモデレーションコールバック、オーディオモデレーションコールなどのストリーミングコールバックを設定できます。

• OSSでの記録コールバックレコードとコールバックコンテンツを表示できます。 詳細については、「コールバックレコードの表示」をご参照ください。

手順

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

2. 左側のナビゲーションウィンドウで、[機能管理] > [コールバック] を選択します。 [コールバック] ページが表示されます。

3. 設定する取り込みドメインまたはストリーミングドメインを選択します。 取り込みドメインはストリーム取り込みコールバックをサポートし、ストリーミングドメインは記録コールバック、スナップショットコールバック、ビデオモデレーションコール、およびオーディオモデレーションコールをサポートします。

4. [コールバック設定] タブで、コールバックを設定します。

5. 取り込みドメインの場合

   ストリーム取り込みコールバック

   説明

   SetLiveStreamsNotifyUrlConfig操作を呼び出して、ストリーム取り込みコールバックを設定することもできます。 詳細については、「SetLiveStreamsNotifyUrlConfig」をご参照ください。コールバックメソッドとパラメーターの詳細については、「Callbacks For stream ingest status」をご参照ください。

   1. ストリーム取り込みコールバックをオンにします。

   2. コールバックパラメーターを設定します。

      パラメーター	説明
      コールバックURL	コールバックURLは独自のURLです。 ストリームが取り込まれるか中断されると、ApsaraVideo LiveはHTTP GETリクエストをこのURLに送信します。 特定のコンテンツは、URLパラメータを使用して配信されます。
      コールバック認証	コールバックURLの認証を有効にするかどうかを指定します。 認証を有効にするには、スイッチをオンにして認証キーを指定します。

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

   ストリーミングドメインの場合

   • コールバックの記録

     説明

     AddLiveRecordNotifyConfig操作を呼び出して、ドメイン名の記録コールバックを設定することもできます。 詳細については、「AddLiveRecordNotifyConfig」をご参照ください。コールバックの方法とパラメーターの詳細については、「ライブストリーム録画のコールバック」をご参照ください。

     1. Recording Callbacksをオンにします。

     2. コールバックパラメーターを設定します。

        パラメーター	説明
        コールバックURL	コールバックURLは独自のURLです。 録画イベントが発生すると、ApsaraVideo LiveはこのURLにHTTP POSTリクエストを送信します。 特定のコンテンツは、JSONボディを使用して配信されます。
        Triggeringイベント	ファイル生成: 録音ファイルが生成されると、コールバックが発生します。 ファイルの生成と記録ステータス: 記録ファイルが生成されたとき、または記録が開始、一時停止、または再開されたときに、コールバックが発生します。
        オンデマンドのコールバックURL	オンデマンド録画が設定されている場合、ApsaraVideo Liveは、ライブストリームの取り込みを開始すると、指定されたオンデマンドコールバックURLにHTTPコールバックを送信します。 コールバックへの応答は、ライブストリームを記録するかどうかを決定します。 デフォルトでは、このパラメーターの値は * で、オンデマンド録画を無効にすることを指定します。 説明 オンデマンドコールバックURLを指定する前に、AddLiveAppRecordConfig操作を呼び出して記録ルールを設定する必要があります。 このルールでは、OnDemandパラメーターが1に設定されています。これは、HTTPコールバックメソッドを使用してオンデマンド記録が有効になっていることを示します。

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

   • スナップショットのコールバック

     説明

     AddLiveSnapshotNotifyConfig操作を呼び出して、ドメイン名のスナップショットコールバックを設定することもできます。 詳細については、「AddLiveSnapshotNotifyConfig」をご参照ください。コールバックの方法とパラメーターの詳細については、「ライブストリームのスナップショットのコールバック」をご参照ください。

     1. スナップショットコールバックをオンにします。

     2. コールバックパラメーターを設定します。

        パラメーター	説明
        コールバックURL	コールバックURLは独自のURLです。 スナップショットイベントが発生すると、ApsaraVideo LiveはこのURLにHTTP POSTリクエストを送信します。 特定のコンテンツは、JSONボディを使用して配信されます。
        コールバック認証	コールバックURLの認証を有効にするかどうかを指定します。 認証を有効にするには、スイッチをオンにして認証キーを指定します。

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

     説明

     • AddLiveDetectNotifyConfig操作を呼び出して、ビデオモデレーションコールバックを設定することもできます。 詳細については、「AddLiveDetectNotifyConfig」をご参照ください。コールバックメソッドとパラメーターの詳細については、「コンテンツモデレーションのコールバック」をご参照ください。

     • 一部のライブセンターのみがコンテンツモデレーション機能をサポートしています。 詳細については、「サポートされているリージョン」をご参照ください。

     • ビデオモデレーションコールバック通知は、問題のビデオに対してのみ返されます。 通知内容には、関連する動画スナップショットのモデレーション情報とストレージ情報が含まれています。 コールバックサーバーでコールバック情報を表示できます。 コールバック情報の形式と例の詳細については、「コンテンツモデレーションのコールバック」をご参照ください。

     • OSSで特定された違反を検索します。 モデレーションコールバック情報に基づいて、OSSコンソールで特定の違反を検索できます。

       • アプリケーション名とストリーム名に基づいて特定の違反を検索します。

       • ストリームの取り込み日に基づいて特定の違反を検索します。

     1. Video Moderationコールバックをオンにします。

     2. コールバックURLを指定します。

        コールバックURLは独自のURLです。 ビデオモデレーションイベントが発生すると、ApsaraVideo LiveはこのURLにHTTP POSTリクエストを送信します。 特定のコンテンツは、JSONボディを使用して配信されます。

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

   • 音声モデレーションコールバック

     説明

     • AddLiveAudioAuditNotifyConfig操作を呼び出して、オーディオモデレーションコールバックを設定することもできます。 詳細については、「AddLiveAudioAuditNotifyConfig」をご参照ください。コールバックメソッドとパラメーターの詳細については、「コンテンツモデレーションのコールバック」をご参照ください。

     • オーディオモデレーションコールバック通知は、問題のオーディオに対してのみ返されます。 通知内容には、直近1分間の音声のテキスト情報とコンテキストが含まれる。 コールバックサーバーでコールバック情報を表示できます。 コールバック情報の形式と例の詳細については、「コンテンツモデレーションのコールバック」をご参照ください。

     • OSSで特定された違反を検索します。 モデレーションコールバック情報に基づいて、OSSコンソールで特定の違反を検索できます。

       • アプリケーション名とストリーム名に基づいて特定の違反を検索します。

       • ストリームの取り込み日に基づいて特定の違反を検索します。

     1. Audio Moderationコールバックをオンにします。

     2. コールバックURLを指定します。

        コールバックURLは独自のURLです。 オーディオモデレーションイベントが発生すると、ApsaraVideo LiveはこのURLにHTTP POSTリクエストを送信します。 特定のコンテンツは、JSONボディを使用して配信されます。

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

ストリーム取り込みコールバックロジック

コールバック認証