ApsaraVideo Real-time Communication（ARTC）SDK for Web では、チャンネルモードとユーザーロールを変更することで、さまざまなインタラクティブエクスペリエンスを提供できます。このトピックでは、チャンネルモードとユーザーロールを設定するために使用されるサンプルコードを紹介します。
チャンネルモードを設定する
ARTC SDK for Web は、さまざまなシナリオでストリーミングパフォーマンスを最適化するために使用できる 2 つのチャンネルモードを提供します。
チャンネルモードを設定するには、チャンネルに参加する前に setChannelProfile メソッドを呼び出す必要があります。チャンネル参加後のチャンネルモード設定は有効になりません。
// AliRtcEngine インスタンスが作成されていることを確認します。
// メソッドを呼び出してチャンネルモードを設定します。
aliRtcEngine.setChannelProfile('communication');引数 | 意味 | 説明 | デフォルト値か |
communication | コミュニケーションモード。 | このモードでは、すべてのユーザーがインタラクションを行うことができます。このモードは、オンライン会議や通話などのシナリオに適しています。 | はい |
interactive_live | インタラクティブモード。 | このモードでは、ユーザーはストリーマーと視聴者の 2 つのタイプに分けられます。ストリーマーは音声ストリームとビデオストリームを配信およびサブスクライブできますが、視聴者は音声ストリームとビデオストリームをサブスクライブすることしかできません。このモードは、会議やリアルタイムコミュニケーションに適しています。 | いいえ |
ユーザーロールを設定する
interactive_live モードを選択した場合は、setClientRole メソッドを呼び出して、ユーザーにロールを割り当てる必要があります。SDK は、インタラクティブとライブの 2 つのユーザーロールを提供します。
コミュニケーションモードでのユーザーロール設定は有効になりません。
// チャンネルモードを interactive_live に設定していることを確認します。コミュニケーションモードでのユーザーロール設定は有効になりません。
// ユーザーロールはいつでも設定できます。たとえば、視聴者がストリーマーと話をしたい場合は、ユーザーロールをインタラクティブに設定できます。
aliRtcEngine.setClientRole('interactive');
// 会話が終了したら、ユーザーロールをライブに設定します。
aliRtcEngine.setClientRole('live');引数 | 意味 | 説明 | デフォルト値か |
interactive | ストリーマーロール。 | ストリーマーは音声ストリームとビデオストリームを配信およびサブスクライブできます。 | いいえ |
live | 視聴者ロール。 | 視聴者は音声ストリームとビデオストリームをサブスクライブすることしかできません。 | はい |