你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
通话 SDK 中支持的面向 Teams 用户的通话功能
Azure 通信服务通话 SDK 使 Teams 用户设备能够驱动语音和视频通信体验。 本页提供呼叫功能的详细说明,包括平台和浏览器支持信息。 若要立即开始使用 JavaScript,请查看通话快速入门。
呼叫 SDK 的关键功能:
- 寻址 - Azure 通信服务使用 Microsoft Entra 用户标识符以寻址通信终结点。 客户端使用 Microsoft Entra 标识对服务进行身份验证并相互通信。 这些标识用于呼叫 API,使客户端了解到已连接到(花名册中的)何人。 并且还用于 Microsoft Graph API。
- 加密 - 呼叫 SDK 将加密流量并防止在线篡改。
- 设备管理和媒体 - 呼叫 SDK 提供所需的工具用于绑定到音频和视频设备、对内容进行编码以通过通信数据平面高效传输,并在指定的输出设备和视图中呈现内容。 此外,还提供 API 用于屏幕和应用程序共享。
- 通知 - 呼叫 SDK 提供可以在接到来电时通知客户端的 API。 如果应用未在前台运行,可以使用触发弹出式通知(“toast”)模式来通知用户接到了来电。
通话功能
以下列表显示了在参与 1:1 IP 语音 (VoIP) 通话或群组 VoIP 通话时,Azure 通信服务通话 SDK 中当前可用的一组功能。
功能组 | 功能 | JavaScript | Windows | Java (Android) | Objective-C (iOS) |
---|---|---|---|---|---|
核心功能 | 向 Teams 用户发起一对一通话 | ✔️ | ✔️ | ✔️ | ✔️ |
向 Azure 通信服务用户发起一对一通话 | ❌ | ❌ | ❌ | ❌ | |
为两位以上的 Teams 用户(最多 350 位用户)发起组通话 | ✔️ | ✔️ | ✔️ | ✔️ | |
将两位 Teams 用户的一对一通话升级为两位以上 Teams 用户的组通话 | ✔️ | ✔️ | ✔️ | ✔️ | |
在一个组呼叫开始后加入它 | ❌ | ❌ | ❌ | ❌ | |
邀请其他 VoIP 参与者加入正在进行的组呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
使用音频测试服务测试麦克风、扬声器和照相机(可通过呼叫 8:echo123 使用) | ✔️ | ✔️ | ✔️ | ✔️ | |
发出呼叫来接受 Teams 外部访问配置 | ✔️ | ✔️ | ✔️ | ✔️ | |
发出呼叫来接受 Teams 来宾访问配置 | ✔️ | ✔️ | ✔️ | ✔️ | |
Mid 呼叫控制 | 打开/关闭视频 | ✔️ | ✔️ | ✔️ | ✔️ |
将麦克风静音/取消静音 | ✔️ | ✔️ | ✔️ | ✔️ | |
切换照相机 | ✔️ | ✔️ | ✔️ | ✔️ | |
本地保持/取消保持 | ✔️ | ✔️ | ✔️ | ✔️ | |
通话中主导说话人的指示器 | ✔️ | ✔️ | ✔️ | ✔️ | |
选择通话的扬声器设备 | ✔️ | ✔️ | ❌2 | ❌2 | |
选择呼叫麦克风 | ✔️ | ✔️ | ❌2 | ❌2 | |
参与者状态的指示器 空闲、早期媒体、正在连接、已连接、等候接听、接听中、已断开连接 |
✔️ | ✔️ | ✔️ | ✔️ | |
通话状态的指示器 早期媒体、正在传入、正在连接、正在响铃、已连接、通话保持、正在断开连接、已断开连接 |
✔️ | ✔️ | ✔️ | ✔️ | |
指示参与者已静音 | ✔️ | ✔️ | ✔️ | ✔️ | |
指示参与者终止通话的原因 | ✔️ | ✔️ | ✔️ | ✔️ | |
屏幕共享 | 在应用程序中共享整个屏幕 | ✔️ | ✔️1 | ✔️1 | ✔️1 |
共享特定的应用程序(从正在运行的应用程序列表中) | ✔️ | ✔️1 | ❌ | ❌ | |
从打开的选项卡列表中共享 web 浏览器选项卡 | ✔️ | ✔️ | ✔️ | ✔️ | |
接收屏幕共享流 | ❌ | ❌ | ❌ | ❌ | |
在“仅内容”模式下共享内容 | ✔️ | ✔️ | ✔️ | ✔️ | |
接收包含相关内容的视频流,以实现“仅内容”屏幕共享体验 | ✔️ | ✔️ | ✔️ | ✔️ | |
在“突出”模式下共享内容 | ❌ | ❌ | ❌ | ❌ | |
接收包含相关内容的视频流,以实现“突出”屏幕共享体验 | ❌ | ❌ | ❌ | ❌ | |
在“并排”模式下共享内容 | ❌ | ❌ | ❌ | ❌ | |
接收包含相关内容的视频流,以实现“并排”屏幕共享体验 | ❌ | ❌ | ❌ | ❌ | |
在“报告者”模式下共享内容 | ❌ | ❌ | ❌ | ❌ | |
接收包含相关内容的视频流,以实现“报告者”屏幕共享体验 | ❌ | ❌ | ❌ | ❌ | |
在屏幕共享过程中共享系统音频 | ✔️ | ❌ | ❌ | ❌ | |
名单 | 列出参与者 | ✔️ | ✔️ | ✔️ | ✔️ |
添加 Azure 通信服务用户 | ❌ | ❌ | ❌ | ❌ | |
添加 Teams 用户 | ✔️ | ✔️ | ✔️ | ✔️ | |
添加 Teams 用户以接受 Teams 外部访问配置 | ✔️ | ✔️ | ✔️ | ✔️ | |
添加 Teams 用户以接受 Teams 来宾访问配置 | ✔️ | ✔️ | ✔️ | ✔️ | |
添加电话号码 | ✔️ | ✔️ | ✔️ | ✔️ | |
删除参与者 | ✔️ | ✔️ | ✔️ | ✔️ | |
准许大厅中的参与者进入 Teams 会议 | ✔️ | ✔️ | ✔️ | ✔️ | |
从大厅进入 Teams 会议 | ✔️ | ✔️ | ✔️ | ✔️ | |
添加 Teams 用户以接受信息屏障 | ✔️ | ✔️ | ✔️ | ✔️ | |
设备管理 | 请求使用音频和/或视频的权限 | ✔️ | ✔️ | ✔️ | ✔️ |
获取相机列表 | ✔️ | ✔️ | ✔️ | ✔️ | |
设置相机 | ✔️ | ✔️ | ✔️ | ✔️ | |
获取所选相机 | ✔️ | ✔️ | ✔️ | ✔️ | |
获取麦克风列表 | ✔️ | ✔️ | ✔️ | ✔️ | |
设置麦克风 | ✔️ | ✔️ | ✔️ | ✔️ | |
获取所选麦克风 | ✔️ | ✔️ | ✔️ | ✔️ | |
获取扬声器列表 | ✔️ | ✔️ | ✔️ | ✔️ | |
设置扬声器 | ✔️ | ✔️ | ✔️ | ✔️ | |
获取所选扬声器 | ✔️ | ✔️ | ✔️ | ✔️ | |
视频渲染 | 在多个位置(本地相机或远程流)渲染单个视频 | ✔️ | ✔️ | ✔️ | ✔️ |
设置/更新缩放模式 | ✔️ | ✔️ | ✔️ | ✔️ | |
渲染远程视频流 | ✔️ | ✔️ | ✔️ | ✔️ | |
查看一起模式视频流 | ✔️ | ❌ | ❌ | ❌ | |
查看“大型库”视图 | ❌ | ❌ | ❌ | ❌ | |
接收来自 Teams 媒体机器人的视频流 | ❌ | ❌ | ❌ | ❌ | |
接收调整后的“来自相机的内容”流 | ❌ | ❌ | ❌ | ❌ | |
添加和移除聚焦的视频流 | ✔️ | ✔️ | ✔️ | ✔️ | |
允许选择聚焦的视频流 | ✔️ | ✔️ | ✔️ | ✔️ | |
视频效果 | 背景模糊 | ✔️ | ✔️ | ✔️ | ✔️ |
自定义背景图像 | ✔️ | ❌ | ❌ | ❌ | |
录制和听录 | 管理 Teams 云录制 | ❌ | ❌ | ❌ | ❌ |
接收正在进行云录制的调用信息 | ✔️ | ✔️ | ✔️ | ✔️ | |
明确同意进行 Teams 云录制 | ✔️ | ❌ | ❌ | ❌ | |
管理 Teams 听录 | ❌ | ❌ | ❌ | ❌ | |
接收正在听录的调用信息 | ✔️ | ✔️ | ✔️ | ✔️ | |
明确同意进行 Teams 听录 | ✔️ | ❌ | ❌ | ❌ | |
管理 Teams 隐藏式字幕 | ✔️ | ✔️ | ✔️ | ✔️ | |
支持符合性记录 | ✔️ | ✔️ | ✔️ | ✔️ | |
参与 | 举手和取消举手 | ✔️ | ✔️ | ✔️ | ✔️ |
指示其他参与者举手和取消举手 | ✔️ | ✔️ | ✔️ | ✔️ | |
触发表情符号 | ❌ | ❌ | ❌ | ❌ | |
指示其他参与者的表情符号 | ❌ | ❌ | ❌ | ❌ | |
集成 | 控制 Teams 第三方应用程序 | ❌ | ❌ | ❌ | ❌ |
接收 PowerPoint Live 流 | ❌ | ❌ | ❌ | ❌ | |
接收 Whiteboard 流 | ❌ | ❌ | ❌ | ❌ | |
与轮询交互 | ❌ | ❌ | ❌ | ❌ | |
与 Q&A 交互 | ❌ | ❌ | ❌ | ❌ | |
高级呼叫路由 | “发起呼叫”和“添加用户操作”遵循转发规则 | ✔️ | ✔️ | ✔️ | ✔️ |
读取和配置呼叫转接规则 | ❌ | ❌ | ❌ | ❌ | |
“发起呼叫”和“添加用户操作”支持同时响铃 | ✔️ | ✔️ | ✔️ | ✔️ | |
读取和配置同时响铃 | ❌ | ❌ | ❌ | ❌ | |
“发起呼叫”和“添加用户操作”支持“请勿打扰”状态 | ✔️ | ✔️ | ✔️ | ✔️ | |
使参与者暂停会播放暂停音乐 | ✔️ | ❌ | ❌ | ❌ | |
在 Teams 客户端上由 Teams 用户置于暂停状态会播放暂停音乐 | ✔️ | ✔️ | ✔️ | ✔️ | |
寄存呼叫 | ❌ | ❌ | ❌ | ❌ | |
已寄存 | ✔️ | ✔️ | ✔️ | ✔️ | |
将呼叫转移到另一位用户 | ✔️ | ✔️ | ✔️ | ✔️ | |
转移到用户或呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
将呼叫转移到另一个呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
将呼叫转移到语音邮件 | ✔️ | ✔️ | ✔️ | ✔️ | |
转移到语音邮件 | ✔️ | ✔️ | ✔️ | ✔️ | |
合并正在进行的呼叫 | ❌ | ❌ | ❌ | ❌ | |
发起通话并添加用户操作接受线路配置 | ✔️ | ✔️ | ✔️ | ✔️ | |
代表 Teams 用户发起通话 | ❌ | ❌ | ❌ | ❌ | |
读取和配置共享线路配置 | ❌ | ❌ | ❌ | ❌ | |
接收团队自动助理呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
将呼叫转移到团队自动助理 | ✔️ | ✔️ | ✔️ | ✔️ | |
接收 Teams 呼叫队列中的呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
转移 Teams 呼叫队列中的呼叫 | ✔️ | ✔️ | ✔️ | ✔️ | |
Teams 通话策略 | 接受“进行私人呼叫” | ✔️ | ✔️ | ✔️ | ✔️ |
接受设置“通话云录制” | 没有可用的 API | 没有可用的 API | 没有可用的 API | 没有可用的 API | |
接受设置“听录” | 没有可用的 API | 没有可用的 API | 没有可用的 API | 没有可用的 API | |
接受设置“呼叫转接和同时响铃到组织中的人员” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“呼叫转接和同时响铃到外部电话号码” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“语音邮件可用于路由入站呼叫” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“可将入站呼叫路由到呼叫组” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“入站和出站呼叫委派” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“阻止公用电话旁路并通过 PSTN 发送呼叫” | ❌ | ❌ | ❌ | ❌ | |
接受设置“音乐暂停” | ❌ | ❌ | ❌ | ❌ | |
接受设置“呼叫中的忙线设定” | ❌ | ❌ | ❌ | ❌ | |
接受设置“Teams 呼叫中的实时字幕” | 没有可用的 API | 没有可用的 API | 没有可用的 API | 没有可用的 API | |
接受设置“垃圾邮件筛选” | ✔️ | ✔️ | ✔️ | ✔️ | |
接受设置“SIP 设备可用于呼叫” | ✔️ | ✔️ | ✔️ | ✔️ | |
DevOps | Azure 指标 | ✔️ | ✔️ | ✔️ | ✔️ |
Azure Monitor | ✔️ | ✔️ | ✔️ | ✔️ | |
Azure 通信服务见解 | ✔️ | ✔️ | ✔️ | ✔️ | |
Azure 通信服务语音和视频通话事件 | ❌ | ❌ | ❌ | ❌ | |
Teams 通话分析 | ✔️ | ✔️ | ✔️ | ✔️ | |
Teams 实时分析 | ❌ | ❌ | ❌ | ❌ |
- 可使用原始媒体实现共享屏幕功能,若要了解如何添加原始媒体,请访问快速入门指南。
- 通话 SDK 没有显式 API,你需要使用 OS (android 和 iOS)API 来实现它。
与呼叫 SDK 概述的通信服务共享对流式处理、超时、平台和浏览器的支持。
后续步骤
有关详细信息,请参阅以下文章: