ApsaraVideo Live は、アップストリーミングステータス、ライブ録画、ライブスナップショット、および自動レビューのイベントコールバックを提供します。このトピックでは、ApsaraVideo Live コンソールでこれらのコールバックイベントを設定する方法について説明します。
前提条件
ApsaraVideo Live は、HTTP コールバックによるイベント通知をサポートしており、HTTPS とも互換性があります。コールバックメッセージを受信するための HTTP サービスをデプロイし、コンソールまたは API を使用して Webhook アドレスを設定する必要があります。
アップストリーミングまたは中断イベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP GET リクエストを送信します。イベントの詳細は URL パラメーターを介して配信されます。
その他のイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。イベントの詳細は JSON 本文で配信されます。
利用シーン
ライブストリーム中に特定のイベントがトリガーされると、Alibaba Cloud はご利用のサーバーにリクエストを送信します。ご利用のサーバーは、そのリクエストを確認する責任を負います。認証が成功した後、JSON データパケットでイベントコールバック情報を取得できます。
ApsaraVideo Live は、アップストリーミングステータス、ライブ録画 (オンデマンド録画)、ライブスナップショット、自動レビュー (動画と音声のレビュー) などのイベントのコールバックをサポートしています。さまざまなイベントのコールバックパラメーターと例の詳細については、「コールバック管理」をご参照ください。
制限事項
Webhook アドレスの URL は認証を必要としません。公開アクセス可能であることだけが要件です。URL の確認に関する要件は次のとおりです：
URL へのリクエストがタイムアウトした場合、リクエストは再試行されます。タイムアウト期間は 5 秒、再試行回数は 5 回、再試行間隔は 1 秒です。
コールバックタイプごとの設定要件：
アップストリーミングコールバックは、アップストリーミングドメインに対してのみ設定および編集できます。
録画、スナップショット、動画レビュー、音声レビューのコールバックは、ストリーミングドメインに対してのみ設定および編集できます。
機能紹介
イベントコールバックは、アップストリーミングコールバックとストリーミングコールバックに分類されます。
アップストリーミングコールバック：アップストリーミングドメインに対して、アップストリーミングコールバックとコールバック認証を設定できます。
ストリーミングコールバック：ストリーミングドメインに対して、録画コールバック、スナップショットコールバック、動画モデレーションコールバック、および音声モデレーションコールバックを設定できます。
コールバックレコード：コールバックレコードを使用して、OSS に保存されているライブ録画のコールバックイベントのレコードと内容をすばやく表示できます。詳細については、「コールバックレコード」をご参照ください。
操作手順
ApsaraVideo Live コンソールにログインします。
左側のナビゲーションウィンドウで、機能管理 > イベントコールバック をクリックして、 イベントコールバック ページを開きます。
設定するアップストリーミングドメインまたはストリーミングドメインを選択します。アップストリーミングドメインにはアップストリーミングコールバックを設定できます。ストリーミングドメインには録画、スナップショット、動画レビュー、音声レビューのコールバックを設定できます。
コールバックの設定 タブで、各機能を設定できます。
アップストリーミングコールバック
プッシュストリーミングコールバック を有効にできます。
コールバックパラメーターを設定します。
パラメーター
説明
コールバックタイプ
アップストリーミング/中断コールバック：現在のドメイン名でのアップストリーミング成功とストリーム中断を通知します。
異常なアップストリーミングイベントコールバック：現在のドメイン名での異常なアップストリーミングイベントを通知します。
コールバック URL
アップストリーミング/中断 Webhook アドレス：これはお客様が所有する URL です。アップストリーミングまたは中断イベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP GET リクエストを送信します。詳細は URL パラメーターを介して配信されます。
異常イベント Webhook アドレス：これはお客様が所有する URL です。異常なアップストリーミングイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。詳細は JSON 本文で配信されます。
コールバック認証
アップストリーミングコールバックアドレスの認証を有効にするかどうかを選択します。認証を有効にするには、スイッチをオンにして [暗号鍵] を入力します。
[OK] をクリックします。
コールバックのメソッドと内容の詳細については、「ライブストリームのアップストリーミングコールバック」をご参照ください。また、SetLiveStreamsNotifyUrlConfig API 操作を呼び出すこともできます。
録画コールバック
録画コールバック を有効にします。
コールバックパラメーターを設定します。
パラメーター
説明
コールバックタイプ
これはお客様が所有する URL です。録画コールバックイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。詳細は JSON 本文で配信されます。
トリガーイベント
ファイル生成コールバック：録画ファイルが生成されたときにコールバックがトリガーされます。
録画ステータスコールバック：録画ファイルの生成、録画の開始、一時停止、再開などのイベントでコールバックがトリガーされます。
オンデマンドコールバック URL
オンデマンド録画を設定した後、ライブストリームのアップストリーミングが開始されると、ライブ録画サービスは事前に設定されたオンデマンド Webhook アドレスに HTTP コールバックを送信します。このコールバックからの応答によって、ライブストリームを録画するかどうかが決まります。オンデマンド Webhook アドレスのデフォルト値は
*で、これはオンデマンド録画が無効であることを意味します。説明オンデマンド Webhook アドレスを設定する前に、AddLiveAppRecordConfig API 操作を呼び出して録画ルールを設定する必要があります。
OnDemandパラメーターを1に設定して、HTTP コールバックによるオンデマンド録画を有効にします。コールバック認証
この機能はデフォルトで無効になっています。有効にする場合は、認証キー を設定する必要があります。システムが各コールバックリクエストに署名するため、受信者側で署名検証を行うことで、リクエストの安全性を確保できます。プロシージャの詳細については、「コールバック認証」をご参照ください。
[OK] をクリックします。
コールバックのメソッドと内容の詳細については、「ライブ録画コールバック」をご参照ください。また、AddLiveRecordNotifyConfig API 操作を呼び出すこともできます。
スナップショットコールバック
スナップショットコールバック を有効にします。
コールバックパラメーターを設定します。
パラメーター
説明
コールバック URL
これはお客様が所有する URL です。スナップショットコールバックイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。詳細は JSON 本文で配信されます。
コールバック認証
スナップショットコールバックアドレスの認証を有効にするかどうかを選択します。認証を有効にするには、スイッチをオンにして [暗号鍵] を入力します。
コールバックのメソッドと内容の詳細については、「ライブスナップショットコールバック」をご参照ください。また、AddLiveSnapshotNotifyConfig API 操作を呼び出すこともできます。
動画レビューコールバック
動画レビューのコールバック を有効にできます。
Webhook アドレスを設定します。
これはお客様が所有する URL です。動画レビューコールバックイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。イベントの詳細は JSON 本文で配信されます。
[OK] をクリックします。
コールバックのメソッドと内容の詳細については、「自動レビューコールバック」をご参照ください。また、AddLiveDetectNotifyConfig API 操作を呼び出してコールバック通知 URL を追加することもできます。
ライブストリームの自動レビューは、特定のライブセンターでのみサポートされています。この機能をサポートするライブセンターの詳細については、「サービスリージョン」をご参照ください。
動画レビューコールバックは、問題のある動画コンテンツに対してのみトリガーされます。通知には、問題のある動画のスナップショットのレビューとストレージ情報が含まれます。コールバック情報は、ご利用のコールバックサーバーで表示できます。コールバック情報のフォーマットと例の詳細については、「自動レビューコールバック」をご参照ください。
OSS で検出されたコンテンツを検索します。レビューコールバックからの情報に基づいて、OSS コンソールで指定されたレビュー済みコンテンツを見つけることができます。
AppName と StreamName で指定されたレビュー済みコンテンツを検索します。
アップストリーミング日で指定されたレビュー済みコンテンツを検索します。
音声レビューコールバック
音声レビューのコールバック を有効にできます。
Webhook アドレスを設定します。
これはお客様が所有する URL です。音声レビューコールバックイベントが発生すると、ApsaraVideo Live サーバーはこのアドレスに HTTP POST リクエストを送信します。イベントの詳細は JSON 本文で配信されます。
[OK] をクリックします。
コールバックのメソッドと内容の詳細については、「自動レビューコールバック」をご参照ください。また、AddLiveAudioAuditNotifyConfig API 操作を呼び出して音声レビューコールバック情報を追加することもできます。
音声レビューコールバックは、問題のある音声コンテンツに対してのみトリガーされます。通知には、問題のある音声のテキストと、その前の 1 分間のコンテキスト情報が含まれます。コールバック情報は、ご利用のコールバックサーバーで表示できます。コールバック情報のフォーマットと例の詳細については、「自動レビューコールバック」をご参照ください。
OSS で検出されたコンテンツを検索します。レビューコールバックからの情報に基づいて、OSS コンソールで指定されたレビュー済みコンテンツを見つけることができます。
AppName と StreamName で指定されたレビュー済みコンテンツを検索します。
アップストリーミング日で指定されたレビュー済みコンテンツを検索します。
アップストリーミングコールバックのロジック
アップストリーミングステータスコールバックにおける公開ステータスコールバックのロジックは次のとおりです：
RTMP アップストリーミングの場合、ApsaraVideo Live サービスが On Publish メッセージを受信してから 2 秒以内にアップストリーミングクライアントが能動的に切断しない場合、サービスはアップストリーミング成功のコールバックを送信します。
アップストリーミングドメイン A とストリーミングドメイン B があるとします。ドメイン B でのストリームフェッチング (固定またはトリガーによる back-to-origin ストリームフェッチング) のコールバックが必要な場合は、ドメイン A にアップストリーミングコールバックを設定する必要があります。設定が完了すると、ドメイン B のストリームフェッチングコールバックのロジックは、前のステップで説明した内容と同じになります。接続が確立されてから 2 秒以内に能動的に切断されなければ、ストリームフェッチングは成功したと見なされます。
コールバック通知を使用して、アップストリーミングとストリームフェッチングが正常かどうかを判断できます。また、アクティブなストリームのリストをクエリして、ライブストリームの再生 URL を配信する前にアップストリーミングが正常であることを確認することもできます。
コールバック認証
アップストリーミングのコールバック認証機能は、デフォルトで無効になっています。アップストリーミングコールバックアドレスを設定する際に認証を有効にできます。この機能を有効にすると、認証ロジックは次のようになります：
ApsaraVideo Live がコールバックリクエストを開始する際、HTTP または HTTPS リクエストヘッダーに
ALI-LIVE-TIMESTAMPとALI-LIVE-SIGNATUREフィールドを含めます。これにより、コールバックメッセージを受信するサーバーが署名認証を実行できます。ALI-LIVE-SIGNATUREの値は次のように計算されます：ALI-LIVE-SIGNATURE=MD5SUM(MD5CONTENT) ここで MD5CONTENT= CallbackDomain | ALI-LIVE-TIMESTAMP の値 | EncryptionKEY。
説明コールバックドメインは、コールバック URL が設定されているアップストリーミングドメインです。暗号鍵は、アップストリーミングコールバック URL に設定したキーです。
ご利用のサーバーがコールバックメッセージを受信すると、コールバックドメイン、
ALI-LIVE-TIMESTAMPの値、および暗号鍵を連結します。次に、サーバーは連結された文字列の MD5 ハッシュを計算して暗号化された文字列を取得します。その後、サーバーは計算された暗号化文字列を、ApsaraVideo Live から送信された HTTP または HTTPS リクエストヘッダーのALI-LIVE-SIGNATUREフィールドの値と比較します。文字列が一致しない場合、リクエストは無効と見なされます。