Stream Status Callbacks

Stream Status Callbacksを利用すると、Media Acceleration Live Broadcastでストリームが開始または終了した際にリアルタイムでコールバック通知を受信できます。本ガイドでは、ライブプッシュDomainでのコールバック有効化手順、開始および終了コールバックURLの設定方法、各イベントで送信されるコールバックパラメーターの選択方法について説明します。

この機能は、モニタリングシステムやワークフローシステム、ビジネスバックエンドなどの外部サービスとストリームのライフサイクルイベントを同期する必要がある場合にご利用ください。

始める前に

• Media Acceleration Live BroadcastのDomainを所有しているCDNetworksコンソールアカウントへのアクセス権があること。
• 設定するDomainはプッシュDomainである必要があります。なぜなら、ストリーム開始および終了コールバックはインジェストイベントに紐づいているためです。
• ストリーム開始およびストリーム終了イベント用に到達可能なコールバックエンドポイントを準備していること。
• ストリーム開始URLおよびストリーム終了URLは、同じプロトコルおよびDomainを使用していること。
• 外部サービスで期待されるコールバックパラメーターを把握していること。

ストリームステータスコールバックの設定

ドメイン設定エディターでストリームステータスコールバックを設定します。

スクリーンショット：ストリームステータスコールバック追加ダイアログでオンが選択されており、メソッド、ストリーム開始URL、ストリーム終了URL、およびコールバックパラメーターが表示されています。

1. メディアデリバリー > Media Acceleration Live Broadcast > 設定 に移動します。
2. ドメイン一覧から設定したいプッシュDomainを見つけ、設定の編集を選択します。
3. 設定エディターでストリームステータスコールバックを選択し、追加をクリックします。
4. ストリームステータスコールバックに対して、オンを選択します。
5. コールバック設定を構成します。

重要: ストリーム開始URLとストリーム終了URLは、同じプロトコルおよびドメインを使用する必要があります。たとえば、両方のURLを同じhttps://example.comホストで設定してください。

6. コールバックパラメータで、構成をクリックを展開します。開始レポートと終了レポートで、ストリーム開始および終了コールバックと共に送信するパラメータを選択します。
7. 確認を選択し、エディタのストリームステータスコールバック行を確認してください。ドメイン設定全体を確認する準備ができたら、次へのみ選択してください。

参考

コールバックURL形式

コールバックURLには以下の形式を使用してください：

{protocol}://{host}:{port}/{URI}

例：

https://test.example.com/api/live/check
http://1.1.1.1:8888/api/live/check

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

Report Starts および Report Ends で、コールバックパラメーターを個別に設定することができます。

コールバックパラメータは、ストリームの開始または終了時にコールバックエンドポイントへ送信されるイベント情報を定義します。各イベントタイプについて、デフォルトのパラメータ名を使用するか、サービスで期待される名前に変更できます。コールバックリクエストにパラメータを含めたくない場合は、そのパラメータをクリアしてください。