會議室概觀
Azure 通訊服務 為建置結構化交談的開發人員提供空間的概念，例如虛擬約會或虛擬活動。 會議室目前允許語音和視訊通話。
以下是會議室很有用的主要案例：
- 會議室可啟用排程的通訊體驗。 會議室協助服務平臺提供會議樣式的體驗，同時仍適合各種產業應用程式。 服務可以安排和管理病人的會議室，尋求醫療諮詢、財務規劃師與客戶合作，以及提供法律服務的律師。
- 會議室可啟用僅限邀請的體驗。 會議室可讓您的服務控制哪些使用者可以加入會議室，以便與醫生或財務顧問進行虛擬預約。 這隻允許具有指派通訊服務身分識別的使用者子集加入會議室通話。
- 會議室可透過角色和許可權啟用結構化通訊。 會議室可讓開發人員將預先定義的角色指派給使用者，以在通訊中執行更高程度的控制和結構。 請確定只有演示者可以在大型會議或虛擬會議中發言和分享內容。
- 新增 PSTN 參與者。 邀請公用電話交換網 （PSTN） 參與者使用透過訂用帳戶購買的號碼或透過 Azure 直接路由傳送至會話邊界控制器 （SBC） 的電話。
使用會議室的時機
當您需要下列任何功能時，請使用會議室：
- 控制哪些使用者可以加入會議室通話。
- 需要啟用並在指定時間和日期到期的排程/座標。
- 需要透過使用者的角色和許可權進行結構化通訊。
| 功能 | 1：N 呼叫 | 1：N 呼叫 使用暫時標識碼 |
會議室通話 |
|---|---|---|---|
| 互動式參與者 | 350 | 350 | 350 |
| 要散發給參與者的暫時標識碼 | ❌ | ✔️ （組識別元） |
✔️ （房間識別碼） |
| 僅限受邀者參與 | ❌ | ❌ | ✔️ |
| 撥出給 PSTN 使用者的能力 | ✔️ | ✔️ | ✔️ |
| 呼叫 標題 | ✔️ 私人預覽 |
✔️ 私人預覽 |
✔️ 私人預覽 |
| 通話錄音 | ✔️ | ✔️ | ✔️ 公開預覽 |
| 通訊服務資源中的所有使用者加入通話 | ❌ | ✔️ | ✔️ |
| 設定呼叫的有效期間 | ❌ | ❌ | ✔️ 最多六個月 |
| 設定通話的使用者角色和許可權 | ❌ | ❌ | ✔️ |
| 建立、移除、更新、刪除呼叫的 API | ❌ | ❌ | ✔️ 會議室 API |
管理會議室和加入會議室通話
會議室 API/SDK 可用來完成動作，例如建立會議室、新增參與者和設定排程等。通話 SDK 可用來從用戶端起始會議室內的通話。 通話 SDK 中一對一或群組通話中可用的大部分動作也可以在會議室通話中使用。 通話 SDK 中提供的完整功能清單列在通話 SDK 概觀中。
| 功能 | 呼叫 SDK | 會議室 API/SDK |
|---|---|---|
| 使用語音和視訊加入會議室通話 | ✔️ | ❌ |
| 列出加入會議室通話的參與者 | ✔️ | ❌ |
| 允許/不允許在虛擬會議室層級撥出給 PSTN 使用者 | ❌ | ✔️ |
| 建立會議室 | ❌ | ✔️ |
| 列出所有受邀加入會議室的參與者 | ❌ | ✔️ |
| 開始、暫停、停止通話錄製 | ✔️ | ❌ |
| 新增或移除 VoIP 參與者 | ❌ | ✔️ |
| 將角色指派給會議室參與者 | ❌ | ✔️ |
下圖說明管理和加入會議室的概念。
虛擬會議室 API/SDK
會議室是透過會議室 API 或 SDK 來建立和管理。 在伺服器應用程式中使用會議室 API/SDK 來進行 room 作業：
- 建立
- 修改
- 刪除
- 設定和更新參與者清單
- 設定及修改會議室有效性
- 將角色和許可權指派給使用者。 詳細資料如下。
| 虛擬會議室 SDK | 版本 | 州/省 |
|---|---|---|
| 虛擬會議室 SDK | 2024-04-15 | 正式推出 - 完全支援 |
| 虛擬會議室 SDK | 2023-10-30 | 公開預覽 - 完全支援 |
| 虛擬會議室 SDK | 2023-06-14 | 正式推出 - 完全支援 |
| 虛擬會議室 SDK | 2023-03-31 | 將於 2024 年 4 月 30 日退休 |
| 虛擬會議室 SDK | 2022-02-01 | 將於 2024 年 4 月 30 日退休 |
| 虛擬會議室 SDK | 2021-04-07 | 將於 2024 年 4 月 30 日退休 |
呼叫 SDK
使用通話 SDK 來加入會議室通話。 會議室通話可以使用 Web、iOS 或 Android 通話 SDK 來加入。 您可以在這裡找到加入會議室通話的快速入門範例。
您也可以使用 Azure 通訊服務 UI 連結庫來存取會議室。 UI 連結庫可讓開發人員只使用幾行程式代碼，將已啟用會議室的呼叫用戶端新增至其應用程式中。
預先定義的參與者角色和許可權
會議室參與者可以獲指派下列其中一個角色：演示者、出席者和取用者。 根據預設，如果使用者未獲指派其他角色，則會獲 派出席者 角色。
下表提供對應至角色的詳細功能。 概括而言，演示者角色具有完全控制權，出席者功能僅限於音訊和視訊，而取用者只能接收音訊、視訊和屏幕共用。
| 功能 | 角色：演示者 | 角色：出席者 | 角色：取用者 |
|---|---|---|---|
| 中通話控件 | |||
| - 開啟/關閉視訊 | ✔️ | ✔️ | ❌ |
| - 靜音/取消靜音麥克風 | ✔️ | ✔️ | ❌ |
| - 將遠端使用者靜音 | ✔️ | ❌ | ❌ |
| - 在相機之間切換 | ✔️ | ✔️ | ❌ |
| - 使用中喇叭 | ✔️ | ✔️ | ✔️ |
| - 選擇通話的喇叭 | ✔️ | ✔️ | ✔️ |
| - 選擇通話的麥克風 | ✔️ | ✔️ | ❌ |
| - 顯示參與者狀態（閑置、連線、已連線、擱置、中斷連線、中斷連線、中斷連線等） | ✔️ | ✔️ | ✔️ |
| - 顯示通話狀態 （早期媒體、傳入、連線、響鈴、已 連線、保留、中斷連線、中斷連線 | ✔️ | ✔️ | ✔️ |
| - 顯示參與者是否靜音 | ✔️ | ✔️ | ✔️ |
| - 顯示參與者離開通話的原因 | ✔️ | ✔️ | ✔️ |
| 螢幕共用 | |||
| - 共享畫面 | ✔️ * | ❌ | ❌ |
| - 共用應用程式 | ✔️ * | ❌ | ❌ |
| - 共用瀏覽器索引標籤 | ✔️ * | ❌ | ❌ |
| - 參與者可以檢視共享畫面 | ✔️ | ✔️ | ✔️ |
| 名冊管理 | |||
| - 移除參與者 | ✔️ | ❌ | ❌ |
| 裝置管理 | |||
| - 要求使用音訊和/或視訊的許可權 | ✔️ | ✔️ | ❌ |
| - 取得相機清單 | ✔️ | ✔️ | ❌ |
| - 設定相機 | ✔️ | ✔️ | ❌ |
| - 取得選取的相機 | ✔️ | ✔️ | ❌ |
| - 取得麥克風清單 | ✔️ * | ✔️ * | ❌ |
| - 設定麥克風 | ✔️ * | ✔️ * | ❌ |
| - 取得選取的麥克風 | ✔️ * | ✔️ * | ❌ |
| - 取得演講者清單 | ✔️ * | ✔️ * | ✔️ * |
| - 設定喇叭 | ✔️ * | ✔️ * | ✔️ * |
| - 取得選取的說話者 | ✔️ | ✔️ | ✔️ |
| 視訊轉譯 | |||
| - 在多個位置轉譯視訊（本機相機或遠端串流） | ✔️ | ✔️ | ✔️ （僅限遠端） |
| - 設定/更新視訊調整模式 | ✔️ | ✔️ | ✔️ （僅限遠端） |
| - 轉譯遠端視訊串流 | ✔️ | ✔️ | ✔️ |
| 新增 PSTN 參與者 | |||
| - 使用電話撥打參與者 | ✔️ | ❌ | ❌ |
* 僅適用於 Web 呼叫 SDK。 無法在 iOS 和 Android 上呼叫 SDK
事件處理
透過事件方格發佈的語音和視訊通話事件會加上會議室通話資訊的批注。
- 當會議室通話啟動時，即會發佈 CallStarted 。
- 當會議室通話結束時，就會發佈 CallEnded 。
- 當新的參與者加入會議室通話時，即會發佈 CallParticipantAdded 。
- 當參與者從會議室通話中卸除時，會發佈 CallParticipantRemoved 。
已被取代的功能
舊版的會議室 API 支援兩個會議室名冊控制組態，如下所示：
- 「僅限邀請」會議室，只允許受邀的使用者加入會議室通話。
- 一個不安全的「開放房間」。 在開放式會議室設定中，允許所有 Azure 通訊服務 使用者加入通話，而不需透過會議室名冊明確邀請。
「開放空間」概念現在已被取代。 接下來，「僅限邀請」會議室將是唯一支援的會議室類型。
已知限制
- Azure 通訊服務 通話自動化功能目前不支援會議室通話。