ApsaraVideo Live:ARTC アプリケーション

ARTC アプリケーションを作成する

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

2. 左側のナビゲーションウィンドウで、[live +] > [リアルタイム音声・映像] > [アプリケーション] を選択します。

3. [アプリケーション] ページで、[アプリケーションの作成] をクリックします。

4. [インスタンス名] フィールドにカスタム名を入力し、[利用規約] を選択して、[今すぐ購入] をクリックします。

5. アプリケーションが作成されたら、[アプリケーション] ページをリフレッシュしてアプリケーションを表示します。

   説明

   デフォルトでは、アプリケーションを作成しても料金は発生しません。クラウドでの実際の使用状況に基づいて課金されます。詳細については、「ARTC の課金」をご参照ください。

ストリームリレーを設定する

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

2. 左側のナビゲーションウィンドウで、[live +] > [リアルタイム音声・映像] > [アプリケーション] を選択します。[アプリケーション] ページで、管理するアプリケーションを見つけ、[操作] 列の [管理] をクリックします。

3. [ストリームリレー] をクリックします。次のいずれかの方法を使用して、ストリームリレーを設定できます。

   1. 方法 1: リレーするストリームを指定する

      サーバー側で API 操作を呼び出して、特定のチャンネルのストリームリレーをリアルタイムで設定できます。このようにして、ストリームを ApsaraVideo Live またはサードパーティのプラットフォームにリレーできます。これには、サーバー側で少量の開発が必要です。

   2. 方法 2: ApsaraVideo Live へのグローバルストリームリレーを設定する

      ストリームリレー機能を有効にすると、音声ストリームとビデオストリームは ApsaraVideo Live のオリジンサーバーにリレーされます。ストリーミングドメインに基づいて、トランスコード、録画、スナップショットキャプチャなどの機能を設定できます。ライブストリームをプルして視聴することもできます。

      1. [ストリームリレー] をオンにします。

      2. ストリームリレーパラメーターを設定します。

         パラメーター	設定	説明
         ストリームリレー	オプションを選択します。	シングルストリームリレーを有効にすると、デフォルトですべての音声ストリームとビデオストリームが ApsaraVideo Live にリレーされます。SDK またはサーバー API を使用して、混合ストリームのレイアウトを更新することもできます。
         ストリーミングドメイン	例: play.example.com	標準ストリーミング用にリレーされるストリーミングドメイン。ライブストリームの再生、トランスコード設定と録画設定の構成、およびその他の操作をストリーミングドメインに基づいて実行できます。 説明 ストリーミングドメインがない場合は、ドメイン管理 ページで追加します。 ストリーミングドメインの RTS 2.0 を有効にしないでください。有効にすると、ストリームリレーは失敗します。
         AppName	名前の長さは最大 255 文字で、数字、文字、ハイフン (-)、アンダースコア (_)、および等号 (=) を含めることができます。 デフォルト値: live。カスタム値を指定できます。	ストリームリレー後のストリーミング URL のアプリケーション名。詳細については、「インジェスト URL とストリーミング URL を生成する」をご参照ください。 説明 リレーされたストリームのトランスコード、録画、スナップショットテンプレートなどのテンプレートを設定する必要がある場合は、テンプレートで指定されたアプリケーション名と同じアプリケーション名を指定する必要があります。そうしないと、テンプレートは有効になりません。
         SEI 挿入	SEI を一定の間隔で挿入する: このオプションを使用すると、1,000 ～ 5,000 ミリ秒の指定された間隔で Supplemental Enhancement Information (SEI) を挿入できます。 I フレームに SEI を挿入する: このオプションを使用すると、ビデオストリームの I フレームに SEI を挿入できます。	SEI: SEI を使用して、UID や混合ストリームレイアウトパラメーターなどの基本的なユーザー情報をストリームに挿入できます。このようにして、共同ストリーミングのシナリオでは、ストリームのミキシングとリレーのレイアウトが変更されると、視聴者がストリームを視聴するために使用するアプリがリアルタイムで SEI からレイアウト情報を解析できます。これは、インタラクションスタイルの調整に役立ちます。詳細については、「SEI 形式」をご参照ください。

         説明

         • [ドメイン管理] ページにストリーミングドメインが存在しない場合は、ドメイン名を追加する必要があります。詳細については、「ドメイン名を追加する」をご参照ください。

         • ストリーミングドメインの RTS 2.0 を有効にしないでください。有効にすると、リレーされたストリームフェッチングは失敗します。

SEI 形式

{"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}

コールバック

ARTC 機能は、チャンネルコールバック、ユーザーコールバック、および混合ストリームリレーコールバックを提供します。次のセクションでは、ApsaraVideo Live コンソールでこれらのコールバックを設定する方法について説明します。

概要

コールバックを設定すると、ビジネスサーバーは、ARTC アプリケーションで発生するチャンネルとユーザーのステータス変更、および混合ストリームリレーイベントをリアルタイムで受信できます。

• チャンネルコールバック: チャンネルの作成やチャンネルのクローズなどのイベントに関する通知が送信されます。

• ユーザーコールバック: ユーザーに関連するイベントに関する通知が送信されます。たとえば、ユーザーがチャンネルに参加または退出した場合、ユーザーがロールを切り替えた場合、またはユーザーがストリームをインジェストまたはプルした場合。

• 混合ストリームリレーコールバック: ストリームリレーイベントに関する通知が送信されます。

チャンネルコールバックとユーザーコールバックの詳細については、「CreateEventSub」をご参照ください。混合ストリームリレーコールバックの詳細については、「ListRtcMPUEventSubRecord」をご参照ください。

コールバックタスクを作成する

コールバックタスクを編集または削除する

コールバックレコードを表示する

コールバックタスクを作成し、タスクが有効になると、関連イベントが発生した場合にコールバックレコードが生成されます。[コールバックレコード] タブでコールバックの詳細を表示できます。