你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Rooms 概述
Azure 通信服务为正在构建结构化对话(如虚拟约会或虚拟事件)的开发人员提供会议室的概念。 会议室当前允许进行语音和视频通话。
下面是会议室能够发挥作用的主要场景:
- 会议室支持计划的通信体验。 会议室帮助服务平台提供了会议风格的体验,同时仍对各种行业应用程序进行了适当的通用处理。 服务可以为寻求医疗建议的患者、与客户合作的财务规划师以及提供法律服务的律师预约和管理会议室。
- 会议室提供仅限邀请的使用体验。 会议室允许服务控制哪些用户可以与医生或财务顾问加入会议室进行虚拟预约。 这将只允许具有分配的通信服务标识的一部分用户加入会议室通话。
- 会议室可以通过角色和权限实现结构化通信。 会议室使开发人员能够向用户分配预定义的角色,从而在通信中实现更高程度的控制和结构。 确保只有演示者才能在大型会议或虚拟会议中发言和共享内容。
- 添加 PSTN 参与者。 使用通过订阅购买的号码或通过 Azure 直接路由到会话边界控制器(SBC) 邀请公用电话交换网 (PSTN) 参与者进行通话。
何时使用会议室
在需要以下任何功能的情况下使用会议室:
- 控制哪些用户可以加入会议室通话。
- 需要预约/协调并在指定时间和日期过期。
- 用户需要通过角色和权限进行结构化通信。
功能 | 1:N 呼叫 | 1:N 呼叫 具有临时 ID |
会议室呼叫 |
---|---|---|---|
交互式参与者 | 350 | 350 | 350 |
分发给参与者的临时 ID | ❌ | ✔️ (组 ID) |
✔️ (会议室 ID) |
仅限被邀请者参与 | ❌ | ❌ | ✔ |
能够拨出到 PSTN 用户 | ✔ | ✔ | ✔ |
通话字幕 | ✔️ 个人预览版 |
✔️ 个人预览版 |
✔️ 个人预览版 |
通话记录 | ✔ | ✔ | ✔️ 公共预览版 |
通信服务资源中的所有用户加入通话 | ❌ | ✔ | ✔ |
设置呼叫的有效期 | ❌ | ❌ | ✔️ 最多六个月 |
设置通话的用户角色和权限 | ❌ | ❌ | ✔ |
用于创建、移除、更新、删除通话的 API | ❌ | ❌ | ✔️ Rooms API |
管理会议室和加入会议室通话
会议室 API/SDK 用于完成创建聊天室、添加参与者和设置日程安排等操作。通话 SDK 用于从客户端在会议室中发起呼叫。 通话 SDK 中一对一或群组通话中可用的大多数操作在会议室通话中也可用。 通话 SDK 概述中列出了通话 SDK 中提供的完整功能列表。
功能 | 通话 SDK | Rooms API/SDK |
---|---|---|
使用语音和视频加入会议室通话 | ✔ | ❌ |
列出加入会议室通话的参与者 | ✔ | ❌ |
允许/禁止在虚拟会议室级别拨出到 PSTN 用户 | ❌ | ✔ |
创建会议室 | ❌ | ✔ |
列出所有受邀加入会议室的参与者 | ❌ | ✔ |
添加或删除 VoIP 参与者 | ❌ | ✔ |
向会议室参与者分配角色 | ❌ | ✔ |
下图说明了管理和加入会议室的概念。
虚拟会议室 API/SDK
会议室是通过会议室 API 或 SDK 创建和管理的。 在服务器应用程序中使用会议室 API/SDK 进行 room
操作:
- 创建
- 修改
- 删除
- 设置和更新参与者列表
- 设置和修改会议室有效性
- 向用户分配角色和权限。 详细信息如下所示。
虚拟会议室 SDK | 版本 | State |
---|---|---|
虚拟会议室 SDK | 2024 年 4 月 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 库,开发人员只需几行代码即可将启用了会议室的呼叫客户端添加到其应用程序中。
预定义参与者角色和权限
可以向会议室参与者分配以下角色之一:“演示者”、“与会者”和“使用者”。 默认情况下,如果未向用户分配其他角色,则会向用户分配“与会者”角色。
下表提供了映射到角色的详细功能。 在基础层面上,“演示者”角色具有完全控制权限,“与会者”功能仅限于音频和视频,而“使用者”只能接收音频、视频和屏幕共享。
功能 | 角色:演示者 | 角色:与会者 | 角色:使用者 |
---|---|---|---|
Mid 通话控制 | |||
- 打开/关闭视频 | ✔ | ✔ | ❌ |
- 将麦克风静音/取消静音 | ✔ | ✔ | ❌ |
- 将远程用户设为静音 ** | ✔ | ❌ | ❌ |
- 切换摄像头 | ✔ | ✔ | ❌ |
- 激活扬声器 | ✔ | ✔ | ✔ |
- 选择通话的扬声器 | ✔ | ✔ | ✔ |
- 选择通话的麦克风 | ✔ | ✔ | ❌ |
- 显示参与者状态(空闲、正在连接、已连接、通话保持、正在断开连接、已断开连接等) | ✔ | ✔ | ✔ |
- 显示通话状态(早期媒体、正在接入、正在连接、正在响铃、已连接、通话保持、正在断开连接、已断开连接) | ✔ | ✔ | ✔ |
- 显示参与者是否静音 | ✔ | ✔ | ✔ |
- 显示参与者退出通话的原因 | ✔ | ✔ | ✔ |
屏幕共享 | |||
- 共享屏幕 | ✔️* | ❌ | ❌ |
- 共享应用程序 | ✔️* | ❌ | ❌ |
- 共享浏览器选项卡 | ✔️* | ❌ | ❌ |
- 参与者可以查看共享屏幕 | ✔ | ✔ | ✔ |
名单管理 | |||
- 移除参与者 | ✔ | ❌ | ❌ |
设备管理 | |||
- 请求使用音频和/或视频的权限 | ✔ | ✔ | ❌ |
- 获取摄像头列表 | ✔ | ✔ | ❌ |
- 设置摄像头 | ✔ | ✔ | ❌ |
- 获取选定摄像头 | ✔ | ✔ | ❌ |
- 获取麦克风列表 | ✔️* | ✔️* | ❌ |
- 设置麦克风 | ✔️* | ✔️* | ❌ |
- 获取选定麦克风 | ✔️* | ✔️* | ❌ |
- 获取扬声器列表 | ✔️* | ✔️* | ✔️* |
- 设置扬声器 | ✔️* | ✔️* | ✔️* |
- 获取选定扬声器 | ✔ | ✔ | ✔ |
视频渲染 | |||
- 在多个位置(本地摄像头或远程流)渲染单个视频 | ✔ | ✔ | ✔️ (仅远程) |
- 设置/更新视频缩放模式 | ✔ | ✔ | ✔️ (仅远程) |
- 渲染远程视频流 | ✔ | ✔ | ✔ |
添加 PSTN 参与者 | |||
- 使用电话呼叫呼叫参与者 | ✔ | ❌ | ❌ |
* 仅在 Web 通话 SDK 上可用。 在 iOS 和 Android 通话 SDK 上不可用
** 目前为公共预览版。
事件处理
通过事件网格发布的语音和视频通话事件使用会议室通话信息进行批注。
- 会议室通话启动时,会发布 CallStarted。
- 会议室通话结束时,会发布 CallEnded。
- 新参与者加入会议室通话时,会发布 CallParticipantAdded。
- 参与者离开会议室通话时,会发布 CallParticipantRemoved。
已弃用的功能
早期公共预览版会议室 API 支持两种会议室名单控制配置,如下所示:
- “仅邀请”会议室,仅允许受邀用户加入会议室通话。
- “开放会议室”,不太安全。 在开放会议室配置中,允许所有 Azure 通信服务用户加入通话,无需通过会议室名单明确邀请。
“开放会议室”概念现已弃用。 今后,“仅邀请”会议室将是唯一受支持的会议室类型。
已知限制
- Azure 通信服务通话自动化功能目前不支持会议室通话。
后续步骤:
- 使用快速入门:创建、管理和加入会议室。
- 了解如何加入会议室通话。
- 查看媒体和信号的网络要求。
- 分析会议室数据,请参阅:会议室日志。
- 了解如何使用 Log Analytics 工作区,请参阅:Log Analytics 教程。
- 在 Log Analytics 中创建自己的查询,请参阅:查询入门。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈