你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
扩展通话前活动
虚拟约会体验的成败取决于音频和视频两个方面,这要求设备做好准备。 Azure 通信服务提供一系列工具,能够帮助你在虚拟约会引导式支持之前验证设备先决条件。
先决条件
本文的读者应切实了解以下主题:
- Microsoft Teams 虚拟约会产品及其提供的用户体验
- Microsoft Graph Booking API,可通过 Microsoft Graph API 管理 Microsoft Booking
- 通过 Microsoft Graph API 管理 Microsoft Teams 会议的 Microsoft Graph Online 会议 API
- Azure 通信服务聊天、通话和用户界面库
后台验证
Azure 通信服务提供通话前诊断 API 用于验证设备就绪情况,例如,浏览器兼容性、网络以及通话质量。 以下代码片段在设备上运行 30 秒的测试。
创建 CallClient 并获取 PreCallDiagnostics 功能:
const callClient = new CallClient();
const preCallDiagnostics = callClient.feature(Features.PreCallDiagnostics);
使用访问令牌启动通话前测试:
const tokenCredential = new AzureCommunicationTokenCredential("<ACCESS_TOKEN>");
const preCallDiagnosticsResult = await preCallDiagnostics.startTest(tokenCredential);
查看诊断结果以确定设备是否已准备好进行虚拟约会。 下面的示例演示了如何验证浏览器和操作系统支持的就绪情况:
const browserSupport = await preCallDiagnosticsResult.browserSupport;
if(browserSupport) {
console.log(browserSupport.browser) // "Supported" | "NotSupported" | "Unknown"
console.log(browserSupport.os) // "Supported" | "NotSupported" | "Unknown"
}
此外,还可以验证 MediaStatsCallFeature、DeviceCompatibility、DeviceAccess、DeviceEnumeration、InCallDiagnostics。 还可以查看使用用户界面库实现通话前诊断的教程。
Azure 通信服务为开发者提供一款名为“网络诊断”的实用工具,以确保他们的设备和网络处于最佳状态,能够稳定连接服务。
引导式验证
Azure 通信服务提供专用机器人来帮助用户验证客户端的音频设置。 机器人会先播放一段预先录好的消息,并提示客户录制其自己的消息。 如果麦克风和扬声器设置正确,则客户会听到播放的预先录好的消息和他们自己录制的消息。
使用以下代码片段启动通话以测试机器人
const callClient = new CallClient();
const tokenCredential = new AzureCommunicationTokenCredential("<ACCESS_TOKEN>");
callAgent = await callClient.createCallAgent(tokenCredential, {displayName: 'Adele Vance'})
call = callAgent.startCall([{id: '8:echo123'}],{});