ApsaraVideo Live:アプリケーション管理

ARTCアプリケーションの作成

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

2. 左側のナビゲーションウィンドウで、[Live +] > [ApsaraVideo Real-time Communication] > [アプリケーション] を選択します。

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

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

5. アプリケーションの作成後、[アプリケーション] ページを更新してアプリケーションを表示します。

   説明

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

ストリームリレーの設定

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

2. 左側のナビゲーションウィンドウで、[Live +] > [ApsaraVideo Real-time Communication] > [アプリケーション] を選択します。 [アプリケーション] ページで、管理するアプリケーションを見つけ、[操作] 列の [管理] をクリックします。

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ミリ秒の指定された間隔で追加拡張情報 (SEI) を挿入できます。 SEIをIフレームに挿入する: このオプションを使用すると、ビデオストリームのIフレームにSEIを挿入できます。	SEI: SEIを使用して、UIDや混合ストリームレイアウトパラメーターなどの基本的なユーザー情報をストリームに挿入できます。 このようにして、コストリーミングシナリオでは、ストリームミキシングとリレーのレイアウトが変更された場合、視聴者がストリームを視聴するために使用するアプリは、SEIからのレイアウト情報をリアルタイムで解析できます。 これにより、インタラクションスタイルの調整が容易になります。 詳細は、「SEI format」をご参照ください。

         説明

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

         • ストリーミングドメインの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」をご参照ください。 混合ストリームリレーコールバックの詳細については、「CreateRtcMPUEventSub」をご参照ください。

コールバックタスクの作成

コールバックタスクの編集または削除

コールバックレコードの表示

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