你当前正在访问 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 第三方应用程序
接收 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 实时分析
  1. 可使用原始媒体实现共享屏幕功能,若要了解如何添加原始媒体,请访问快速入门指南
  2. 通话 SDK 没有显式 API,你需要使用 OS (android 和 iOS)API 来实现它。

呼叫 SDK 概述的通信服务共享对流式处理、超时、平台和浏览器的支持。

后续步骤

有关详细信息,请参阅以下文章: