思杰 HDX™ 优化

注意：

微软已宣布弃用适用于 Windows 端点的基于 WebRTC 的 Microsoft Teams HDX 优化。以下是两个里程碑：

• 2026 年 10 月 1 日 - 支持终止：Microsoft 或 Citrix 不再正式支持

• 2027 年 4 月 1 日 - 可用性终止：Microsoft 已宣布弃用适用于 Windows 端点的 HDX WebRTC 优化。基于 WebRTC 的优化将停止运行。Citrix Studio 中针对旧版优化的策略将不再生效。

建议客户迁移到适用于 Microsoft Teams 的新 VDI 解决方案 (SlimCore)。此更改仅影响 Windows 端点 — macOS、Linux、ChromeOS 和 HTML5 端点不受影响。有关更多详细信息，请参阅 Microsoft 博客。

在 Citrix HDX (WebRTC 优化) 中，负责处理卸载媒体的端点上的媒体引擎 (HdxRtcEngine) 嵌入在 Citrix Workspace™ 应用程序中，安装 Citrix Workspace 应用程序也会自动安装该引擎。

系统配置要求

本节描述了支持新 Teams 客户端所需的最低版本和推荐版本。请注意，在最低版本中，某些关键错误修复或最新功能可能不可用。部署推荐版本以获得最佳体验，包括最新的修复和功能。

VDI 操作系统

有关详细信息，请参阅 Microsoft 文档中提供的建议。

注意：

• 不支持 Windows Server 2016。Citrix 建议您相应地规划升级。
• 由于版本更新频繁，此处提及的版本可能已终止生命周期。因此，请参阅 Citrix Workspace app 和 Citrix Virtual Apps and Desktops 的产品生命周期页面，以确保您使用的是受支持的组件版本。
• 如果您正在使用 Citrix Virtual Apps and Desktops™ 1912 LTSR，Citrix 建议您计划升级，因为该版本将于 2024 年 12 月终止支持。

虚拟投递代理 (VDA)

思杰 工作区 应用程序

部署方式

1. 在 VDI 上安装新的 Teams 客户端。有关详细信息，请参阅 为 VDI 部署新 Teams。
2. 在 VDA 上配置以下注册表项以优化新 Teams。
   • 位置：  HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
   • Key (REG_Multi_SZ): ProcessWhitelist

   • 值： msedgewebview2.exe

     注意：

     Starting with Citrix Virtual Apps and Desktops 2402 LTSR (or) Citrix Virtual Apps and Desktops 2203 LTSR CU5+, you don’t need to manually configure the msedgewebview2.exe registry entry as it’s allow-listed by default.

3. 确保已启用 Microsoft Teams 重定向 策略。此策略默认处于启用状态。
4. 客户端无需额外配置。按照向导说明安装 Citrix Workspace 应用程序。

应用程序分层

新版 Microsoft Teams 已更改其安装方法，现在安装在 C:\Program Files\WindowsApps 下。为支持此更改，您必须运行 App Layering 2403.2 或更高版本。您可以在包含此修复程序的 App Layering 下载 页面中下载升级磁盘。

有关详细信息，请参阅 App Layering 文档。

Citrix 配置文件管理

有关如何为新版 Microsoft Teams 启用漫游的信息，请参阅 Citrix 配置文件管理 文档。Citrix 配置文件管理的当前最低版本指南为 2402 LTSR 或 2203 LTSR CU5+。

网络方面的考量

新版 Teams 的网络要求与经典版 Teams 没有区别。因此，请参阅经典版 Teams 文档中的 网络要求 部分。

功能特性参考

经过优化的叠加剪裁，以提升性能和用户体验

从 CVAD 2511 开始，用于处理 HDX Microsoft Teams 优化和 UCSDK 优化等功能中的重定向视频叠加的机制已重新设计，以改善用户体验和服务器性能。

主要优势

• 改进的视觉准确性： 此增强功能解决了应用程序元素（例如弹出菜单或通知）错误地出现在视频内容后面的视觉故障。新逻辑确保所有组件都以正确的顺序呈现，从而提供更无缝和可预测的体验。

• 增强的性能： 此优化显著降低了虚拟投递代理上的 CPU 利用率。通过用更高效的基于图形的方法取代旧的、资源密集型轮询方法，此更改提高了服务器可伸缩性并允许更高的用户密度。

注意：

The functionality depends on a future version of Microsoft Teams (or other UCSDK partner application) and requires Citrix Workspace App for Windows 2511.

功能矩阵和版本支持

由于版本更新频繁，此处提到的一些旧版本可能已达到生命周期结束。因此，请参阅 Citrix Workspace App 和 Citrix Virtual Apps and Desktops 的产品生命周期页面，以确保您使用的是不同组件的受支持版本。

注意：

• 此处提到的版本是支持特定功能的最低版本，或支持新版 Teams 的最低版本，以较高者为准。
• 最低版本部分中提到的 Citrix Virtual Apps™ and Desktops 1912 LTSR CU8+ 未在下表中提及，因为它将在 2024 年 12 月达到生命周期结束。但是，在此之前它仍然是受支持的版本。
• 最小 Citrix Virtual Apps and Desktops 版本为 N/A 的功能仅表示该功能不涉及 VDA 端的任何更改。

故障排除及其他注意事项

对于新版 Teams，请参阅 CTX253754，排查 Microsoft Teams 故障。有关新版 Teams 的任何最新更新，请参阅 CTX585013。

已知局限性

Citrix Workspace 应用程序所存在的限制

• HID 支持 - 不支持接听和结束通话。支持音量调高和调低。
• 用户在使用 VDA 上的截图工具时无法截取 Microsoft Teams 内容的屏幕截图。但是，如果在客户端使用截图工具，则可以捕获内容。
• 共享系统音频限制
  • 在与 RAVE 和 BCR 重定向的应用程序或选项卡共享屏幕时，无法使用此功能共享音频。
  • 此功能仅在已发布的桌面上受支持

VDA 上的限制

• 不支持将新版 Teams 作为已发布的（无缝）应用程序

  • 在 CVAD 2402 LTSR、2203 LTSR CU5 及更高版本中已修复

• 当您将 Citrix Workspace 应用程序高 DPI 设置配置为“是”时，重定向的视频窗口显示位置不正确。当显示器的 DPI 缩放因子设置为 100% 以上的任何值时，会出现此限制。

• Microsoft Teams 2.1 一次只支持重定向一个网络摄像头。但是，它不支持在单会话 VDA 上进行多个网络摄像头重定向或即插即用 (PnP) 网络摄像头重定向。

Citrix Workspace 应用程序和 VDA 方面存在的限制

• 您只能使用客户端计算机上的音量条控制优化通话的音量，而不能在 VDA 上控制。

有关 Microsoft 限制的更多详细信息，请参阅 VDI 中不支持的功能。