Microsoft Teams 优化

注意: 此功能取决于未来的 Microsoft Teams 版本。我们将在版本和发布日期的相关信息发布时更新此说明。

Citrix 使用 Citrix Virtual Apps and Desktops 和 Citrix Workspace 应用程序为基于桌面的 Microsoft Teams 提供优化。默认情况下,我们将所有必要的组件绑定到 Citrix Workspace 应用程序和 Virtual Delivery Agent (VDA) 中。

我们针对 Microsoft Teams 的优化包含一个 VDA 端 HDX 服务和 API,用于与 Teams 托管的应用程序进行交互以接收命令。这些组件将向 Citrix Workspace 应用程序端媒体引擎打开控制虚拟通道。端点将在本地解码并呈现多媒体。将本地 Citrix Workspace 应用程序窗口中的无缝管理单元反转回托管的 Teams 应用程序。

身份验证和发出信号在本地发生在 Teams 托管的应用程序上,就像其他 Teams 服务(例如聊天或协作)一样。音频/视频重定向不会对其产生影响。

仅客户端提取/客户端呈现可用。

体系结构

Microsoft Teams 优化的工作原理

此视频演示让您了解 Microsoft Teams 如何在 Citrix 虚拟环境中工作。

Microsoft Teams 优化演示

系统要求

最低版本 - 适用于 Windows 桌面操作系统的 Virtual Delivery Agent (VDA) 1906:

支持的操作系统:

  • Windows 10 64 位,最低版本 1607,最高版本 1903。

要求:

  • 如果尚未安装 .NET Framework 4.7.1 或更高版本,该框架将自动安装。
  • Microsoft Visual C++ 2013 和 2015 Runtimes,32 位和 64 位。
  • BCR_x64.msi - 包含 Teams 优化代码并从 GUI 自动启动的 MSI。如果使用命令行界面进行 VDA 安装,请不要将其排除。

最低版本 - 适用于服务器操作系统的 Virtual Delivery Agent (VDA) 1906:

支持的操作系统:

  • Windows Server 2019、2016 和 2012 R2(Standard Edition 和 Datacenter Edition)。

安装程序将自动安装以下项目,这些组件可以在 Citrix 安装介质上的 Support 文件夹中找到:

  • 如果尚未安装 .NET Framework 4.7.1 或更高版本,该框架将自动安装。
  • Microsoft Visual C++ 2013 和 2015 Runtimes,32 位和 64 位。
  • BCR_x64.msi - 包含 Teams 优化代码并从 GUI 自动启动的 MSI。如果使用命令行界面进行 VDA 安装,请不要将其排除。

如果尚未安装并启用远程桌面服务角色,安装程序会自动安装并启用这些角色。

最低版本 - 适用于 Windows 的 Citrix Workspace 应用程序 1905:

  • Windows 7、8 和 10(32 位和 64 位版本,包括 Embedded Edition)
  • 端点要求:大约 1.4 GHz 双 CPU,可在点对点视频会议通话期间支持 360p VGA 分辨率。
  • Citrix Workspace 应用程序至少需要 600 MB 可用磁盘空间和 1 GB RAM。
  • Microsoft .NET Framework 最低要求为版本 4.6.2。如果系统中不存在,Citrix Workspace 应用程序会自动下载并安装 .NET Framework。
  • 此版本的 Citrix Workspace 应用程序支持音频和视频重定向(对等或会议)以及传入屏幕共享。不支持传出屏幕共享。

启用 Microsoft Teams 优化

要为 Microsoft Teams 启用优化,请使用 Microsoft Teams 重定向策略中介绍的 Studio 策略。除启用此策略外,HDX 还会进行检查,以验证 Citrix Workspace 应用程序的版本等于还是高于所需的最低版本。如果启用了此策略并且支持 Citrix Workspace 应用程序的版本,HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport 注册表项将自动设置为 1。Microsoft Teams 应用程序读取要在 VDI 模式下加载的密钥。

故障排除

本部分内容提供故障排除提示,解决您在使用 Microsoft Teams 优化时可能遇到的问题。 更多信息可以在 CTX253754 中找到。

在 Virtual Delivery Agent 上

BCR_x64.msi 安装四个服务。只有两个服务负责 VDA 中的 Microsoft Teams 重定向。

浏览器内容重定向安装四个服务

  • Citrix HDX Teams 重定向服务建立 Teams 中使用的虚拟通道。该服务依赖于 CtxSvcHost.exe。

  • Citrix HDX HTML5 视频重定向服务作为 WebSocketService.exe 在 127.0.0.1:9002 TCP 上侦听。WebSocketService.exe 执行两项主要功能:

    i.安全 WebSocket 的 TLS 终止接收来自 vdiCitrixPeerConnection.js 的安全 WebSocket 连接,这是 Teams 应用程序中的一个组件。例如,您可以使用进程监视器对其进行跟踪。有关证书的详细信息,请参阅 Controller 与 VDA 之间的通信下的“TLS 和 HTML5 视频重定向以及浏览器内容重定向”部分。

    进程监视器

    ii.用户会话映射。当 Teams 应用程序启动时,WebSocketService.exe 将在 VDA 中的用户会话中启动 WebSocketAgent.exe 进程。WebSocketService.exe 作为 LocalSystem 帐户在会话 0 中运行。

    WebSocketService.exe 服务

    可以使用两种方法中的任何一种来检查 VDA 中的 WebSocketService.exe 服务是否处于主动侦听状态。

    选项 1: 在浏览器选项卡中键入 https://127.0.0.1:9002。与服务成功通信表示服务处于主动侦听状态。

    选项 2: 可以使用 DevTools 控制台收集更多详细信息。

    1. 在一行中键入以下文本:

      var exampleSocket = new WebSocket('wss://127.0.0.1:9002'); exampleSocket.onmessage = function(messageEvent) { console.log(JSON.stringify(messageEvent)); };

    2. 等待几秒钟,然后键入:

      exampleSocket.readyState

步骤 2 的预期输出为数字 1,表示已成功形成 WebSocket 连接。

进程监视器

输出数字为:

-  0 (CONNECTING) 连接尚未打开。
-  1 (OPEN) 连接已打开,并准备进行通信。
-  2 (CLOSING) 连接正在关闭中。
-  3 (CLOSED) 连接已关闭或无法打开。

如果看到此错误或数字 3,请确保 Citrix HDX Teams 重定向服务正在运行,并在需要时重新启动:

进程监视器

vdiCitrixPeerConnection.js 在控制台中记录为 HdxWebRTC.js

注意:

WebSocketService.exe 在两个 TCP 套接字中侦听,即 127.0.0.1:9001 和 127.0.0.1:9002。端口 9001 用于浏览器内容重定向和 HTML5 视频重定向。端口 9002 用于 Teams 重定向。

服务位置和说明

服务 可执行文件夹路径 登录身份 说明
Citrix HTML5 视频重定向服务 “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service 本地系统帐户 通过在虚拟桌面与端点设备之间执行媒体重定向所需的初始框架提供了多个 HDX 多媒体服务。
Citrix HDX 浏览器重定向服务 “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs 此帐户(本地服务) 在端点设备与虚拟桌面之间提供浏览器内容重定向。
Citrix 端口转发服务 “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs 此帐户(本地服务) 在端点设备与虚拟桌面之间为浏览器内容重定向提供端口转发。
Citrix HDX Teams 重定向服务 “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs 此帐户(本地服务) 在端点设备与虚拟桌面之间提供 Microsoft Teams 重定向。

Citrix Workspace 应用程序

在用户的端点上,当 Teams 在 VDA 中启动,并且用户尝试在自主预览模式下拨打电话或访问此外围设备时,适用于 Windows 的 Citrix Workspace 应用程序将实例化名为 HdxTeams.exe 的新服务。如果您没有看到此服务,请检查以下内容:

  1. 确保您至少安装了适用于 Windows 的 Workspace 应用程序版本 1905。您是否在 Workspace 应用程序安装路径中看到 HdxTeams.exe 和 webrpc.dll 二进制文件?
  2. 如果验证了步骤 1,请执行以下操作以检查 HdxTeams.exe 是否正在启动。
    1. 在 VDA 上退出 Teams。
    2. 在 VDA 上启动 services.msc。
    3. 停止 Citrix HDX Teams 重定向服务。
    4. 断开 ICA 会话的连接。
    5. 连接 ICA 会话。
    6. 启动 Citrix HDX Teams 重定向服务。
    7. 重新启动 Citrix HDX HTML5 视频重定向服务。
    8. 在 VDA 启动 Teams。
  3. 如果您仍然没有看到正在客户端端点上启动的 HdxTeams.exe,请执行以下操作:
    1. 重新启动 VDA。
    2. 重新启动客户端端点。

支持

Citrix 和 Microsoft 联合支持使用 Microsoft Teams 优化从 Citrix Virtual Apps and Desktops 交付 Microsoft Teams。这种联合支持是两家公司密切合作的结果。如果您有有效的支持合同,并且遇到此解决方案的问题,请与您怀疑其代码导致该问题的供应商打开支持票证。也就是说,Teams 有关的问题请联系 Microsoft,优化组件有关的问题请联系 Citrix。

Citrix 或 Microsoft 会收到票证、对问题进行分级并根据需要上报。您无需联系每个公司的支持团队。

收集日志

可以在用户的计算机上的 %TEMP% (AppData/Local/Temp) 下找到 HDXTeams.exe 日志。查找名为 webrpc_Day_Month_timestamp_Year.txt 的 .txt

在 HdxTeams.exe 日志中,这些是为成功建立通话而设置的相关 ICE(互动式连接建立)条目(请参阅下面的示例片段):

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

RTCPeerConnection::createOffer. audio = 1 video = 1
RTCPeerConnection::OnSignalingChange. signaling state = HaveLocalOffer
video_element::connectTo
RTCPeerConnection::OnIceGatheringChange. state = Gathering

[…]
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
[…]
candidate:4271145120 1 udp 1685987071 66.165.176.60 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
[…]

RTCPeerConnection::OnIceGatheringChange. state = Complete
RTCPeerConnection::setRemoteDescription

RTCPeerConnection::OnSignalingChange. signaling state = HaveRemoteOffer

如果您遇到问题并且可以持续重现,我们建议您在联系技术支持之前捕获 CDF 跟踪信息。有关详细信息,请参阅知识中心文章 CDFcontrol

有关收集 CDF 跟踪信息的建议,请参阅知识中心文章 收集 CDF 跟踪信息的建议

VDA 端 CDF 跟踪 - 启用以下 CDF 跟踪提供程序:

VDA 端 CDF 跟踪信息

Workspace 应用程序端 CDF 跟踪 - 启用以下 CDF 跟踪提供程序:

Workspace 应用程序端 CDF 跟踪