ルームの概要
Azure Communication Servicesは、仮想予定や仮想イベントなどの構造化された会話を構築する開発者向けのルームの概念を提供します。 ルームでは現在、音声通話とビデオ通話が許可されています。
ルームが役に立つ主なシナリオを次に示します：
- ルールでは、スケジュールされたコミュニケーション エクスペリエンスを利用できます。 ルームは、サービス プラットフォームが会議形式のエクスペリエンスを提供するのに役立ちますが、さまざまな業界アプリケーションに適した汎用性を備えています。 サービスは、医療アドバイスを求める患者、クライアントと働くファイナンシャル プランナー、法律サービスを提供する弁護士のためのルームをスケジュールおよび管理できます。
- ルームでは招待専用のエクスペリエンスを利用できます。 ルームを使用すると、医師や金融コンサルタントとの仮想予約のためにどのユーザーがルームに参加できるかをサービスでコントロールできます。 これにより、割り当てられた Communication Services ID を持つユーザーのサブセットのみがルームコールに参加できるようになります。
- ルームでは、ロールとアクセス許可を介した構造化された通信が可能になります。 ルームを使用すると、開発者は定義済みのロールをユーザーに割り当てて、より高度なコントロールと構造体をコミュニケーションで実行できます。 発表者のみが大規模な会議や仮想会議で話したり、コンテンツを共有したりできます。
- PSTN 参加者を追加します。 サブスクリプションから、あるいは Session Border Controller (SBC) への Azure ダイレクト ルーティングから購入した番号を利用し、公衆交換電話網 (PSTN) 参加者を通話に招待します。
ルームを使用する場合
次のいずれかの機能が必要な場合は、ルームを使用します：
- ルームコールに参加できるユーザーをコントロールします。
- 指定した日時に有効になり、期限切れになるスケジューリング/座標が必要です。
- ユーザーのロールとアクセス許可を介した構造化された通信が必要です。
| 機能 | 1:N 呼び出し | 1:N 呼び出し エフェメラル ID を使用する |
ルーム呼び出し |
|---|---|---|---|
| 対話型参加者 | 350 | 350 | 350 |
| 参加者に配布するエフェメラル ID | ❌ | ✔️ (グループ ID) |
✔️ (ルーム ID) |
| 招待された人のみ参加 | ❌ | ❌ | ✔️ |
| PSTN ユーザーにダイヤルアウトする機能 | ✔️ | ✔️ | ✔️ |
| 通話キャプション | ✔️ プライベート プレビュー |
✔️ プライベート プレビュー |
✔️ プライベート プレビュー |
| 通話レコーディング | ✔️ | ✔️ | ✔️ パブリック プレビュー |
| 通話に参加するための通信サービス リソース内のすべてのユーザー | ❌ | ✔️ | ✔️ |
| 呼び出しの有効期間を設定する | ❌ | ❌ | ✔️ 最大 6 か月 |
| 通話のユーザー ロールとアクセス許可を設定する | ❌ | ❌ | ✔️ |
| 呼び出しを作成、削除、更新、削除する API | ❌ | ❌ | ✔️ Rooms API |
ルームの管理とルームコールの参加
Rooms API/SDK は、ルームの作成、参加者の追加、スケジュールの設定などのアクションを実行するために使用されます。呼び出し SDK は、クライアント側から Room 内で呼び出しを開始するために使用されます。 Calling SDKs の 1 対 1 またはグループ呼び出しで使用できるほとんどのアクションは、ルーム呼び出しでも使用できます。 Calling SDK で提供される機能の完全なリストは、 Calling SDK の概要に記載されています。
| 機能 | SDK の呼び出し | Rooms API/SDK |
|---|---|---|
| 音声とビデオを使用してルーム呼び出しに参加する | ✔️ | ❌ |
| ルーム呼び出しに参加した参加者をリストする | ✔️ | ❌ |
| Virtual Rooms レベルで PSTN ユーザーへのダイヤルアウトを許可または禁止する | ❌ | ✔️ |
| ルームを作成する | ❌ | ✔️ |
| ルームに招待された参加者をリストする | ❌ | ✔️ |
| 通話レコーディングの開始、一時停止、停止 | ✔️ | ❌ |
| VoIP 参加者を追加または削除する | ❌ | ✔️ |
| ルームの参加者にロールを割り当てる | ❌ | ✔️ |
次の図は、ルームの管理と参加の概念を示しています。
Virtual Rooms API/SDK
ルームは、ルーム API または SDK を使用して作成および管理されます。 room 操作には、ルームのサーバー アプリケーションで次の Rooms API/SDK を使用します。
- 作成
- 変更
- 削除
- 参加者のリストを設定および更新する
- ルームの有効性を設定および変更する
- ユーザーにロールとアクセス許可を割り当てます。 詳細は以下を参照してください。
| Virtual Rooms SDK | バージョン | 都道府県 |
|---|---|---|
| Virtual Rooms SDK | 2024-04-15 | 一般提供 - 完全サポート |
| Virtual Rooms SDK | 2023-10-30 | パブリック プレビュー - 完全サポート |
| Virtual Rooms SDK | 2023-06-14 | 一般提供 - 完全サポート |
| Virtual Rooms SDK | 2023-03-31 | 2024 年 4 月 30 日に廃止される予定です |
| Virtual Rooms SDK | 2022-02-01 | 2024 年 4 月 30 日に廃止される予定です |
| Virtual Rooms SDK | 2021-04-07 | 2024 年 4 月 30 日に廃止される予定です |
SDK の呼び出し
[SDK の呼び出し] を使用してルーム コールに参加します。 ルームの呼び出しは、Web SDK の呼び出し、iOS SDK の呼び出し、または Android SDK の呼び出し を使用して参加できます。 ルームコールに参加するためのクイック スタート サンプルについては、 こちらを参照してください。
ルームには、Azure Communication Services UI ライブラリを使用してアクセスすることもできます。 この UI ライブラリによって、開発者はルームで有効な呼び出しクライアントをわずか数行のコードでアプリケーションに追加できます。
定義済みの参加者の役割とアクセス許可
ルームの参加者には、 以下の発表者、 出席者、 コンシューマーのいずれかの役割を割り当てることができます。 既定では、他のロールが割り当てられていない場合、ユーザーには 出席者 ロールが割り当てられます。
次の表は、ロールにマップされた詳細な機能を提供します。 大まかに言うと、 発表者 のロールは完全にコントロールでき、 出席者 の機能はオーディオとビデオに限定され、 コンシューマー はオーディオ、ビデオ、スクリーン共有のみを受け取ることができるということです。
| 機能 | 役割: 発表者 | ロール: 出席者 | ロール: コンシューマー |
|---|---|---|---|
| 通話中のコントロール | |||
| - ビデオをオン/オフにする | ✔️ | ✔️ | ❌ |
| - マイクをミュート/ミュート解除する | ✔️ | ✔️ | ❌ |
| - リモート ユーザーをミュートする | ✔️ | ❌ | ❌ |
| - カメラを切り替える | ✔️ | ✔️ | ❌ |
| - スピーカーをアクティブにする | ✔️ | ✔️ | ✔️ |
| - 通話用のスピーカーを選択する | ✔️ | ✔️ | ✔️ |
| - 通話用のマイクを選択する | ✔️ | ✔️ | ❌ |
| - 参加者の状態を表示する (アイドル、接続中、接続した、保留、切断中、切断した、など) | ✔️ | ✔️ | ✔️ |
| - 通話の状態を表示する (初期メディア、着信、接続中、呼び出し中、接続した、保留、切断中、切断した | ✔️ | ✔️ | ✔️ |
| - 参加者がミュートされているかどうかを表示する | ✔️ | ✔️ | ✔️ |
| - 参加者が通話を終了した理由を表示する | ✔️ | ✔️ | ✔️ |
| 画面共有 | |||
| - スクリーンを共有する | ✔️* | ❌ | ❌ |
| - アプリケーションを共有する | ✔️* | ❌ | ❌ |
| - ブラウザー タブを共有する | ✔️* | ❌ | ❌ |
| - 参加者は共有スクリーンを確認できる | ✔️ | ✔️ | ✔️ |
| 名簿管理 | |||
| - 参加者を削除する | ✔️ | ❌ | ❌ |
| デバイス管理 | |||
| - オーディオおよび/またはビデオを使用するアクセス許可を求める | ✔️ | ✔️ | ❌ |
| - カメラのリストリストを取得する | ✔️ | ✔️ | ❌ |
| - カメラを設定する | ✔️ | ✔️ | ❌ |
| - 選択したカメラを取得する | ✔️ | ✔️ | ❌ |
| - マイクのリストを取得する | ✔️* | ✔️* | ❌ |
| - マイクを設定する | ✔️* | ✔️* | ❌ |
| - 選択されたマイクを取得する | ✔️* | ✔️* | ❌ |
| - スピーカーのリストを取得する | ✔️* | ✔️* | ✔️* |
| - スピーカーを設定する | ✔️* | ✔️* | ✔️* |
| - 選択したスピーカーを取得する | ✔️ | ✔️ | ✔️ |
| ビデオのレンダリング | |||
| - 複数の場所で 1 つのビデオをレンダリングする (ローカル カメラまたはリモート ストリーム) | ✔️ | ✔️ | ✔️ (リモートのみ) |
| - ビデオスケーリングモードの設定/更新 | ✔️ | ✔️ | ✔️ (リモートのみ) |
| - リモート ビデオ ストリームをレンダリングする | ✔️ | ✔️ | ✔️ |
| PSTN 参加者を追加する | |||
| - 電話を使用して参加者を呼び出す | ✔️ | ❌ | ❌ |
* Web 呼び出し元 SDK でのみ使用できます。 iOS および Android 呼び出し SDK では使用できません
イベント処理
Event Grid を介して発行された音声通話イベントとビデオ通話イベントには、ルーム呼び出し情報に注釈が付けられます。
- CallStarted は、ルーム呼び出しの開始時に発行されます。
- CallEnded は、ルーム呼び出しの終了時に発行されます。
- CallParticipantAdded は、新しい参加者がルーム呼び出しに参加したときに発行されます。
- CallParticipantRemoved は、新しい参加者がルーム呼び出しを切断したときに発行されます。
非推奨の機能
以前のパブリック プレビュー バージョンの Rooms API では、次のように Rooms 名簿コントロールの 2 つの構成がサポートされました。
- 招待されたユーザーのみが Rooms 通話に参加できるようにする "招待のみ" のルーム。
- セキュリティが低い"オープンルーム"。 オープン ルーム構成では、すべての Azure Communication Services ユーザーが Room 名簿を通じて明示的に招待されることなく、通話に参加することが許可されていました。
"オープン ルーム" の概念は非推奨になりました。 今後、「招待のみ」の部屋がサポートされている唯一のルームタイプになります。
既知の制限事項
- Azure Communication Services の通話オートメーション機能では、現在、Rooms コールはサポートされていません。
次のステップ:
- クイック スタートを使用して、ルームを作成、管理、そしてそれに参加します。
- ルーム呼び出しに参加する方法について説明します。
- メディアとシグナリングのネットワーク要件をレビューします。
- Rooms のデータを分析するには、「 Rooms ログ」を参照してください。
- Log Analytics ワークスペースの使用方法を学習するには、「Log Analytics のチュートリアル」を参照してください
- Log Analytics で独自のクエリを作成します。クエリの使用を開始するに関する記事を参照してください