针对微软 Teams (经典版) 的优化

注意：

新版微软 Teams 2.1 现已普遍适用于 VDA。此微软 Teams 版本与使用 WebRTC (VDI 1.0) 的 Citrix 微软 Teams 优化兼容。

从 Citrix Virtual Apps and Desktops 2402 开始，您无需手动配置 msedgewebview2.exe 注册表项，因为它默认已列入允许列表。

已发布的应用程序现已支持新版 Microsoft Teams。

Citrix delivers optimization for desktop-based Microsoft Teams using Citrix Virtual Apps and Desktops™ and Citrix Workspace™ app. By default, we bundle all the necessary components into the Citrix Workspace app and the Virtual Delivery Agent (VDA).

我们针对 Microsoft Teams 的优化包括 VDA 端的 HDX™ 服务以及一个用于与 Microsoft Teams 托管应用程序接口以接收命令的 API。这些组件会打开一个控制虚拟通道 (CTXMTOP) 到 Citrix Workspace 应用程序端的媒体引擎。端点在本地解码并提供多媒体，将 Citrix Workspace 应用程序窗口移回托管的 Microsoft Teams 应用程序中。

身份验证和信令在 Microsoft Teams 托管应用程序上本地进行，就像其他 Microsoft Teams 服务（例如聊天或协作）一样。音频/视频重定向不会影响它们。

CTXMTOP 是一个命令和控制虚拟通道。这意味着媒体不会在 Citrix Workspace 应用程序和 VDA 之间交换。

仅支持客户端提取/客户端渲染。

此视频演示将向您展示 Microsoft Teams 在 Citrix 虚拟环境中的工作方式。

Microsoft Teams installation

Citrix 和 Microsoft 建议使用最新可用版本的 Microsoft Teams 并保持其更新。 发布日期比当前版本发布日期早 90 天以上的 Microsoft Teams 桌面应用程序版本不受支持。 不受支持的 Microsoft Teams 桌面应用程序版本会向用户显示阻止页面并要求更新应用程序。

有关最新可用版本的信息，请参阅 Microsoft Teams 应用程序（桌面版和 Mac 版）的更新历史记录。

我们建议您遵循 Microsoft Teams 全局安装指南。避免使用将 Microsoft Teams 安装到 AppData 的 .exe 安装程序。相反，请使用命令行中的 ALLUSER=1 标志将其安装到 C:\Program Files (x86)\Microsoft\Teams。

msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSER=1 ALLUSERS=1

此示例还使用 ALLUSERS=1 参数。设置此参数后，Microsoft Teams 计算机范围安装程序将显示在“控制面板”中的“程序和功能”下。此外，它还会显示在计算机所有用户的 Windows 设置中的“应用和功能”下。如果所有用户都具有管理员凭据，则可以卸载 Microsoft Teams。

了解 ALLUSERS=1 和 ALLUSER=1 之间的区别非常重要。您可以在非 VDI 和 VDI 环境中使用 ALLUSERS=1 参数。仅在 VDI 环境中使用 ALLUSER=1 参数来指定每台计算机安装。

在 ALLUSER=1 模式下，Microsoft Teams 应用程序在新版本发布时不会自动更新。我们建议将此模式用于非持久性环境，例如 Windows Server 或 Windows 10 随机/池化目录中的托管共享应用程序或桌面。有关详细信息，请参阅 使用 MSI 安装 Microsoft Teams（VDI 安装部分）。

假设您有一个 Windows 10 专用持久性 VDI 环境。您希望 Microsoft Teams 应用程序自动更新，并希望 Microsoft Teams 在 Appdata/Local 下按用户安装。在这种情况下，请使用 .exe 安装程序或不带 ALLUSER=1 的 MSI。

注意：

Citrix 建议在黄金映像中安装 Microsoft Teams 之前安装 VDA。此安装顺序是使 ALLUSER=1 标志生效所必需的。如果您在安装 VDA 之前已在虚拟机中安装 Microsoft Teams，请卸载并重新安装 Microsoft Teams。

对于远程电脑访问

Citrix 建议您在安装 VDA 后安装 Microsoft Teams 版本 1.4.00.22472 或更高版本。否则，您需要注销并重新登录，Microsoft Teams 才能按预期检测到 VDA。版本 1.4.00.22472 及更高版本包含在 Microsoft Teams 启动时和登录时运行的增强逻辑，用于 VDA 检测。这些版本还包括活动会话类型识别（HDX、RDP 或本地连接到客户端计算机）。如果您是本地连接，则早期版本的 Microsoft Teams 可能无法检测并禁用某些功能或 UI 元素。例如，分组讨论室、会议和聊天弹出窗口或会议反应。

重要提示：

当您从本地会话漫游到 HDX 会话，并且 Microsoft Teams 在后台保持打开和运行状态时，您必须退出并重新启动 Microsoft Teams，才能正确地与 HDX 进行优化。 相反，如果您通过优化的 HDX 会话远程使用 Microsoft Teams，请断开 HDX 会话，并在设备上本地重新连接到相同的 Windows 会话。在办公室工作时，您必须重新启动 Microsoft Teams，以便它能够正确检测远程电脑访问状态（HDX 或本地）。因为 Microsoft Teams 只能在应用程序启动时评估 VDI 模式，而不能在它已在后台运行时评估。如果不重新启动，Microsoft Teams 可能无法加载弹出窗口、分组讨论室或会议反应等功能。

对于应用程序分层

If using Citrix App Layering to manage VDA and Microsoft Teams installations in different layers, you must create a registry key on Windows VDAs before installing Microsoft Teams with the ALLUSER=1 flag from the command line. For more information, see the Optimization for Microsoft Teams with Citrix App Layering section under Multimedia.

配置文件管理建议事项

我们建议在 Windows Server 和池化 VDI Windows 10 环境中使用全计算机安装程序。

当从命令行将 ALLUSER=1 标志传递给 MSI（全计算机安装程序）时，Microsoft Teams 应用程序将安装在 C:\Program Files (x86) (~300 MB) 下。该应用程序使用 AppData\Local\Microsoft\TeamsMeetingAddin 存储日志，并使用 AppData\Roaming\Microsoft\Teams (~600–700 MB) 存储用户特定配置、用户界面元素缓存等。

重要提示：

如果您未传递 ALLUSER=1 标志，MSI 会将 Teams.exe 安装程序和 setup.json 放置在 C:\Program Files (x86)\Teams Installer 下。注册表项 (TeamsMachineInstaller) 将添加在：HKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run 下

后续用户登录会改为触发 AppData 中的最终安装。

全计算机安装程序

以下是在任何 Windows Server 64 位 VM 上安装 Microsoft Teams 全计算机安装程序时创建的文件夹、桌面快捷方式和注册表示例：

文件夹：

• C:\Program Files (x86)\Microsoft\Teams
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

桌面快捷方式：

C:\Program Files (x86)\Microsoft\Teams\current\Teams.exe

注册表：

• HKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run
• HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows\CurrentVersion\Run
• HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run
• 名称: Teams
• 类型: REG_SZ
• 值: C:\Program Files (x86)\Microsoft\Teams\current\Teams.exe

注意：

注册表位置会根据底层操作系统和位数而有所不同。

推荐事项

• 我们建议通过删除 Microsoft Teams 注册表项来禁用自动启动。这样做可以防止许多同时发生的登录（例如，在工作日开始时）导致 VM 的 CPU 飙升。
• 如果虚拟桌面没有 GPU/vGPU，我们建议在 Microsoft Teams 的设置中设置禁用 GPU 硬件加速以提高性能。此设置 ("disableGpu":true) 存储在 desktop-config.json 中的 %Appdata%\Microsoft\Teams。您可以使用登录脚本编辑该文件并将值设置为 true。
• If using Citrix Workspace Environment Management™ (WEM), enable CPU Spikes Protection to manage processor consumption for Microsoft Teams.

每用户安装程序

使用 .exe 安装程序时，安装过程有所不同。所有文件都放置在 AppData 中。

文件夹：

• C:\Users\<username>\AppData\Local\Microsoft\Teams
• C:\Users\<username>\AppData\Local\Microsoft\TeamsPresenceAddin
• C:\Users\<username>\AppData\Local\Microsoft\TeamsMeetingAddin
• C:\Users\<username>\AppData\Local\SquirrelTemp
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

桌面快捷方式：

C:\Users\<username>\AppData\Local\Microsoft\Teams\Update.exe --processStart "Teams.exe"

注册表：

HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run

最佳实践

最佳实践建议基于用例场景。 在非持久性设置中使用 Microsoft Teams 需要配置文件缓存管理器，以实现高效的 Microsoft Teams 运行时数据同步。借助配置文件缓存管理器，用户会话期间会缓存相应的用户特定信息。例如，用户特定信息包括用户数据、配置文件和设置。同步以下两个文件夹中的数据：

• C:\Users\<username>\AppData\Local\Microsoft\IdentityCache
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

非持久性设置的 Microsoft Teams 缓存内容排除列表

按照 Microsoft 文档中的说明，从 Microsoft Teams 缓存文件夹中排除文件和目录。此操作有助于减小用户缓存大小，从而进一步优化您的非持久性设置。

使用场景：单一会话场景

在此场景中，最终用户一次在一个位置使用 Microsoft Teams。他们不需要同时在两个 Windows 会话中运行 Microsoft Teams。在常见的虚拟桌面部署中，每个用户都被分配到一个桌面，并且 Microsoft Teams 作为单个应用程序部署在虚拟桌面中。 我们建议启用 Citrix Profile 容器，并将 Per-user installer 中列出的每个用户目录重定向到该容器中。

1. 在黄金映像中部署 Microsoft Teams 机器范围安装程序 (ALLUSER=1)。
2. 启用 Citrix Profile Management 并设置具有适当权限的用户配置文件存储。

3. 启用以下 Profile Management 策略设置：文件系统 > 同步 > 配置文件容器 – 配置文件磁盘中包含的文件夹列表。

   

   列出此配置中的所有每用户目录。您还可以使用 Citrix Workspace Environment Management (WEM) 服务配置这些设置。

4. 将设置应用于正确的交付组。
5. 请登录以验证部署。

系统配置要求

最低推荐版本 - 交付控制器 (DDCs) 1906.2

如果您使用的是早期版本，请参阅 启用 Microsoft Teams 优化：

支持的操作系统：

• Windows Server 2022、2019、2016、2012R2 标准版和数据中心版本，以及带有 Server Core 选项

最低版本 - 虚拟投递代理 (VDAs) 1906.2

支持的操作系统：

• 视窗 11
• Windows 10 64 位，版本 1607 及更高版本。VM 托管的应用程序在适用于 Windows 2109.1 及更高版本的 Citrix Workspace 应用程序中受支持
• Windows Server 2022、2019、2016 和 2012 R2（标准版和数据中心版）

要求如下：

• BCR_x64.msi - 包含 Microsoft Teams 优化代码并从 GUI 自动启动的 MSI。如果您使用命令行界面进行 VDA 安装，请勿将其排除。

推荐版本：适用于 Windows 操作系统 的 Citrix Workspace 应用程序最新 CR；最低版本：适用于 Windows 操作系统 的 Citrix Workspace 应用程序 1907

• 视窗 11。
• Windows 10（32 位和 64 位版本，包括嵌入式版本）（对 Windows 7 的支持已在版本 2006 停止）（对 Windows 8.1 的支持已在版本 2204.1 停止）。
• Windows 10 物联网企业版 2016 长期服务分支 (v1607) 和 2019 长期服务频道 (v1809)。
• 支持的处理器 (CPU) 架构：x86 和 x64（不支持 ARM）。
• 端点要求：大约 2.2–2.4 GHz 双核 CPU，能够在点对点视频会议通话期间支持 720p 高清分辨率。
• 配备 Intel Turbo Boost 或 AMD Turbo Core 的双核或四核 CPU，其基本速度较低（约 1.5 GHz），但可提升至至少 2.4 GHz。
• 已验证的 HP 瘦客户端：t630/t640、t730/t740、mt44/mt45。
• 戴尔已验证的瘦客户端：5070、5470 Mobile TC 和 AIO。
• 已验证的 10ZiG 瘦客户端：4510 和 5810q。
• 有关已验证端点的完整列表，请参阅 瘦客户端。
• Citrix Workspace 应用程序至少需要 600 MB 可用磁盘空间和 1 GB RAM。
• Microsoft .NET Framework 的最低要求是版本 4.8。如果系统中未安装此框架，Citrix Workspace 应用程序将自动下载并安装它。

管理员可以通过更改 Microsoft Teams 优化策略 来启用/禁用以优化模式启动 Microsoft Teams。在 Citrix Workspace 应用程序中以优化模式启动的用户无法禁用 Microsoft Teams。

最低版本 - 适用于 Linux 操作系统 的 Citrix Workspace 应用程序 2006 版本

有关详细信息，请参阅适用于 Linux 的 Citrix Workspace 应用程序文档中的 微软 Teams 优化。

软件：

• GStreamer 1.0 或更高版本或 Cairo 2
• libc++-9.0 或更高版本
• libgdk 3.22 或更高版本
• OpenSSL 1.1.1d
• libnsl
• Ubuntu 20.04 或更高版本

身份验证增强：

• Libsecret library
• libunwind-12 库。有关详细信息，请参阅 为 llvm-12 添加 libunwind-12 库依赖项。

硬件:

• 最低 1.8 GHz 双核 CPU，可在点对点视频会议通话期间支持 720p 高清分辨率
• 双核或四核 CPU，基本速度为 1.8 GHz，高 Intel Turbo Boost 速度至少为 2.9 GHz

有关已验证端点的完整列表，请参阅 瘦客户端。

有关详细信息，请参阅 安装 Citrix Workspace 应用程序的必备条件。

您可以通过将 /opt/Citrix/ICAClient/config/module.ini 文件中 VDWEBRTC 字段的值更新为 Off 来禁用 Microsoft Teams 优化。默认值为 VDWEBRTC=On。更新完成后，重新启动会话。（需要 Root 权限）。

最低版本 - 适用于 Mac 的 Citrix Workspace 应用程序 2012

支持的操作系统:

• macOS Catalina (10.15).
• macOS Big Sur 11.0.1 及更高版本操作系统。
• macOS Monterey.

支持的功能:

• 音频
• 视频
• 屏幕共享优化（传入和传出）

注意：

Citrix Viewer 应用程序需要访问 macOS 的“安全性与隐私”偏好设置才能进行屏幕共享。用户可在 Apple 菜单 > 系统偏好设置 > 安全性与隐私 > 隐私选项卡 > 屏幕录制中配置此偏好设置，然后选择 Citrix Viewer。

微软团队的优化功能默认情况下适用于 Citrix Workspace 应用程序 2012 及更高版本以及 macOS 10.15 操作系统。

如果要禁用 Microsoft Teams 优化，请在终端中运行此命令并重新启动 Citrix Workspace 应用程序：

defaults write com.citrix.receiver.nomas mtopEnabled -bool NO

最低版本 - 在最新版 ChromeOS 上运行的最新版适用于 ChromeOS 的 Citrix Workspace 应用程序

硬件：

• 性能与 Intel i3 四核 2.4 GHz 处理器相当或更优的处理器。

支持的功能：

• 音频
• 视频
• 屏幕共享优化（传入和传出）- 默认情况下禁用。有关如何启用此功能的说明，请参阅这些设置。

单服务器可扩展性

本节提供建议和指导，以估算单个物理主机可支持的用户或虚拟机 (VM) 数量。这通常称为 Citrix Virtual Apps and Desktops 单服务器可扩展性 (SSS)。在 Citrix Virtual Apps (CVA) 或会话虚拟化环境中，这通常也称为用户密度。其目的是找出在运行主要虚拟机管理程序的单个硬件上可以运行多少用户或虚拟机。

注意：

本节包含估算 SSS 的指南。该指南是高级别的，可能不一定适用于您的独特情况或环境。真正理解 Citrix Virtual Apps and Desktops SSS 的唯一方法是使用可扩展性或负载测试工具，例如 Login VSI。Citrix 建议仅使用此指南和这些简单规则来快速估算 SSS。但是，Citrix 建议使用 Login VSI 或您选择的负载测试工具来验证结果，尤其是在购买硬件或做出任何财务决策之前。

硬件（被测系统）

• 戴尔博睿 R740 服务器
• Intel Xeon (Gold) 6126 @ 2.60 GHz（最大睿频 3.70 GHz），每插槽 12 核，双插槽并启用超线程
• 382 GB 内存
• 本地 SSD RAID 0 存储（11 块磁盘）6 TB

软件

A single virtual machine (40 logical processors) with Windows 2019 (TSVDA) running Citrix Virtual Apps and Desktops 2106 VMware ESXi 6.7

术语定义

• Knowledge worker workload: Includes Acrobat Reader, Freemind/Java, Photo viewer, Edge, and MS Office apps such as Excel, Outlook, PowerPoint, and Word.
• 基准：使用知识工作者工作负载（不含 Microsoft Teams）运行的服务器可扩展性测试。
• 微软 Teams 工作负载：知识工作者典型工作负载 + 微软 Teams。

微软团队的压力测试方式

• Microsoft Teams 已通过 HDX 优化。因此，所有多媒体处理都卸载到端点或客户端，不属于测量范围。
• 在工作负载启动之前，所有 Microsoft Teams 进程都会停止或终止。
• 打开微软团队（冷启动）。
• 测量 Microsoft Teams 加载并获取其主窗口焦点所需的时间。
• 使用键盘快捷方式切换到聊天窗口。
• 使用键盘快捷方式切换到日历窗口。
• 使用键盘快捷方式向特定用户发送聊天消息。
• 使用键盘快捷方式切换到 Microsoft Teams 窗口。

结果

• 与基准（137 个用户）相比，Microsoft Teams 工作负载（81 个用户）的可伸缩性影响为 40%。
• 将服务器容量增加约 40%（在 CPU 中）可恢复与基准工作负载相同的用户数量。
• 与基准相比，Microsoft Teams 工作负载需要额外 20% 的内存。
• 将每个用户的存储大小增加 512-1024 MB。
• IOPS 写入增加约 50%，IOPS 读取增加约 100%。Microsoft Teams 在存储速度较慢的环境中可能会产生显著影响。

功能矩阵和版本支持

1. CD Viewer 仅支持全屏模式。不支持 SHIFT+F2。
2. Negotiate/Kerberos, NTLM, Basic, and Digest. Pac files are also supported.
3. 仅限匿名。
4. 如果 VDA 版本为 2112 或更高版本，则实时字幕仅在适用于 MAC 的 Citrix Workspace 应用程序版本为 2203.1、适用于 Linux 的版本为 2203 或适用于 Windows 的版本为 2112 时才有效。这是因为如果 Microsoft Teams 处于单窗口 UI 模式或多窗口模式，实时字幕的行为会有所不同。
5. 多窗口模式在 VDA 2112 中引入，但已向后移植到 VDA 1912 LTSR CU6 版本。

注意：

• All features listed in Citrix Workspace app for Windows 1912 CU6 (or later) are applicable to Citrix Workspace app for Windows 2203.1 LTSR CU1.
• Microsoft 已弃用对 Microsoft Teams 中单窗口模式的支持。为符合要求，您必须将 VDA 升级到 1912 CU6+ LTSR，并将 Citrix Workspace 应用程序升级到 2203 CU2+ 或更高版本，这些版本支持多窗口模式。

启用 微软团队 的优化功能

要启用 Microsoft Teams 优化，请使用 Microsoft Teams 重定向 策略中描述的“管理”策略。此策略默认处于启用状态。除了启用此策略外，HDX 还会检查以验证 Citrix Workspace 应用程序的版本是否至少达到最低要求版本。如果启用了该策略且 Citrix Workspace 应用程序版本受支持，则 VDA 上的 HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport 会自动设置为 1。Microsoft Teams 读取此项以在 VDI 模式下加载。

注意：

如果您使用的是 1906.2 或更高版本的 VDA，或者使用在“管理”控制台 (Studio) 中没有可用策略的旧控制器版本（例如，版本 7.15），您的 VDA 仍然可以优化。Microsoft Teams 的 HDX 优化在 VDA 中默认启用。

如果单击“关于 > 版本”，将显示“Citrix HDX Optimized”图例：

如果看到“Citrix HDX Not Connected”，则表示 Citrix API 已加载到 Microsoft Teams 中。加载 API 是重定向的第一步。但堆栈的后续部分存在错误。错误很可能出在 VDA 服务或 Citrix Workspace 应用程序中。

如果您没有看到任何图例，则表示 Microsoft Teams 未能加载 Citrix API。右键单击通知区域图标并重新启动，退出 Microsoft Teams。确保“管理”策略未设置为 Prohibited 且 Citrix Workspace 应用程序版本受支持。

重要：会话重新连接

• 当您的连接发生变化时，您可能需要重新启动 Microsoft Teams 才能获得 HDX 优化会话。例如，如果您从不受支持的端点（适用于 iOS、Android 或旧版 Windows/Linux/Mac 的 Workspace 应用程序）漫游到受支持的端点（适用于 Windows/Linux/Mac/ChromeOS/HTML5 的 Workspace 应用程序），反之亦然。
• 如果您在 VDA 中使用 Microsoft Teams .exe 安装程序安装了该应用程序，则还需要重新启动 Microsoft Teams。建议将 .exe 安装程序用于持久性 VDI 部署。在这种情况下，当 HDX 会话处于断开连接状态时，Microsoft Teams 可以自动更新。因此，重新连接到 HDX 会话的用户会发现 Microsoft Teams 未优化运行。
• 当您从本地会话漫游到 HDX 会话时，必须重新启动 Microsoft Teams 以使用 HDX 进行优化。在远程 PC 访问场景中需要此操作。

网络连接要求

Microsoft Teams 依靠 Microsoft 365 中的媒体处理器服务器进行会议或多方通话。此外，Microsoft Teams 依靠 Microsoft 365 传输中继来处理以下场景：

• 点对点通话中的两个对等方没有直接连接
• 某个参与者无法直接连接到媒体处理器。

因此，对等方与 Microsoft 365 云之间的网络状况决定了通话的性能。有关网络规划的详细指南，请参阅 Microsoft 365 网络连接原则。

我们建议评估您的环境，以识别可能影响您的整体云语音和视频部署的任何风险和要求。 使用 Skype for Business 网络评估工具 测试您的网络是否已为 Microsoft Teams 做好准备。有关支持信息，请参阅 支持。

实时协议 (RTP) 流量的关键网络建议摘要

• 从分支机构尽可能直接连接到 Microsoft 365 网络。
• 需要为分支机构规划并提供充足的带宽。
• 检查每个分支机构的网络连接和质量。
• 如果您必须在分支机构使用以下任何一项，请确保 RTP/UDP 流量（由 Citrix Workspace 应用程序中的 HdxRtcEngine.exe 处理）畅通无阻。
  • 绕过代理服务器
  • 网络 SSL 拦截
  • 用于深度包检测的设备
  • VPN 回环（如果可能，请使用分流隧道）

重要：VPN 分流隧道配置

HdxRtcEngine.exe 流量必须从 VPN 隧道中分流，并允许使用用户的本地 Internet 连接直接连接到服务。实现此目的的方式取决于所使用的 VPN 产品和机器平台，但大多数 VPN 解决方案允许通过一些简单的策略配置来应用此逻辑。有关 VPN 平台特定分流隧道指南的更多信息，请参阅这篇 Microsoft 文章。

Workspace 应用程序中的 WebRTC 媒体引擎 (HdxRtcEngine.exe) 使用安全实时传输协议 (SRTP) 处理卸载到客户端的多媒体流。SRTP 为 RTP 提供机密性和身份验证。对于此功能，对称密钥（通过 DTLS 协商）用于使用 AES 加密算法加密媒体和控制消息。

建议使用以下指标以获得良好的用户体验：

有关详细信息，请参阅 为 Microsoft Teams 准备组织网络。

对于带宽要求，Microsoft Teams 优化可以使用多种编解码器用于音频 (OPUS/G.722/PCM G711) 和视频 (H264)。

对等方在呼叫建立过程中使用会话描述协议 (SDP) Offer/Answer 协商这些编解码器。 Citrix 对每个用户的最低建议为：

* Opus 支持从 6 kbps 到 510 kbps 的恒定和可变比特率编码。

Opus 和 H264 是点对点和电话会议的首选编解码器。

重要提示：

关于性能，在客户端计算机上，编码比解码更占用 CPU 资源。您可以在适用于 Linux 和 Windows 的 Citrix Workspace 应用程序中硬编码最大编码分辨率。请参阅 编码器性能估算器 和 Microsoft Teams 优化。

代理服务器

根据代理的位置，请考虑以下事项：

• VDA 上的代理配置：

  如果您在 VDA 中配置了显式代理服务器，并通过代理将连接路由到 localhost，则重定向会失败。要正确配置代理，您必须在 Internet 选项 > 连接 > 局域网设置 > 代理服务器中选择不使用代理服务器访问本地地址设置，并绕过 127.0.0.1:9002。

  如果您使用 PAC 文件，则 PAC 文件中的 VDA 代理配置脚本必须为 wss://127.0.0.1:9002 返回 DIRECT。否则，优化将失败。要确保脚本返回 DIRECT，请使用 shExpMatch(url, "wss://127.0.0.1:9002/*")。

• Citrix Workspace 应用程序上的代理配置：

  如果分支机构配置为通过代理访问 Internet，则以下版本支持代理服务器：

  • 适用于 Windows 的 Citrix Workspace 应用程序版本 2012（协商/Kerberos、NTLM、基本和摘要。同时，Pac 文件也受支持。）
  • 适用于 Windows 的 Citrix Workspace 应用程序版本 1912 CU5（协商/Kerberos、NTLM、基本和摘要。同时，Pac 文件也受支持。）
  • 适用于 Linux 的 Citrix Workspace 应用程序版本 2101（匿名身份验证）
  • 适用于 Mac 的 Citrix Workspace 应用程序版本 2104（匿名身份验证）

安装了早期版本 Citrix Workspace 应用程序的客户端设备无法读取代理配置。这些设备会将流量直接发送到 Microsoft 365 TURN 服务器。

重要提示：

• 验证客户端设备是否可以连接到 DNS 服务器以执行 DNS 解析。客户端设备必须能够解析以下 Microsoft Teams 中继服务器的 FQDN：
  • worldaz.relay.teams.microsoft.com
  • inaz.relay.teams.microsoft.com
  • uaeaz.relay.teams.microsoft.com
  • euaz.relay.teams.microsoft.com
  • usaz.relay.teams.microsoft.com
  • turn.dod.teams.microsoft.us
  • turn.gov.teams.microsoft.us

如果 DNS 请求不成功，与外部用户的 P2P 呼叫和与媒体建立的电话会议将失败。

• 会议服务器的位置是根据第一个参与者的虚拟桌面位置（而非客户端）选择的。

呼叫建立和媒体流路径

在可能的情况下，Citrix Workspace 应用程序中的 HDX WebRTC 媒体引擎 (HdxRtcEngine.exe) 会尝试在点对点呼叫中通过用户数据报协议 (UDP) 建立直接网络安全实时传输协议 (SRTP) 连接。如果 UDP 高端口被阻止，媒体引擎将回退到 TCP/TLS 443。

HDX 媒体引擎支持 ICE、NAT 会话遍历实用程序 (STUN) 和使用 NAT 中继遍历 (TURN) 进行候选发现和建立连接。此支持意味着端点必须能够执行 DNS 解析。

考虑这样一种情况：两个对等方之间或对等方与会议服务器之间没有直接路径，并且您正在加入多方呼叫或会议。HdxRtcEngine.exe 使用 Microsoft 365 中的 Microsoft Teams 传输中继服务器来连接其他对等方或媒体处理器（会议在此处托管）。您的客户端计算机必须能够访问三个 Microsoft 365 子网 IP 地址范围和四个 UDP 端口（如果 UDP 被阻止，则回退到 TCP/TLS 443）。有关详细信息，请参阅 呼叫设置 中的体系结构图和 Office 365 URL 和 IP 地址范围 ID 11。

这些范围包括传输中继和媒体处理器，由 Azure 负载均衡器作为前端。 Microsoft Teams 传输中继提供 STUN 和 TURN 功能，但它们不是 ICE 端点。此外，Microsoft Teams 传输中继不终止媒体、TLS，也不进行任何转码。当它们将流量转发到其他对等方或媒体处理器时，它们可以将 TCP（如果 HdxRtcEngine.exe 使用 TCP）桥接到 UDP。

Workspace 应用程序 WebRTC 媒体引擎联系 Microsoft 365 云中最近的 Microsoft Teams 传输中继。媒体引擎使用任播 IP 和端口 3478–3481 UDP（每个工作负载使用不同的 UDP 端口，尽管可能发生多路复用）或 443 TCP/TLS 进行回退。呼叫质量取决于底层网络协议。由于始终建议使用 UDP 而非 TCP，因此我们建议您设计网络以适应分支机构中的 UDP 流量。

如果 Microsoft Teams 以优化模式加载且 HdxRtcEngine.exe 在端点上运行，ICE 故障可能会导致呼叫设置失败或仅单向音频/视频。如果呼叫无法完成或媒体流不是全双工，请首先检查端点上的 Wireshark 跟踪。有关 ICE 候选收集过程的更多信息，请参阅 支持 部分中的“收集日志”。

注意：

如果端点没有 Internet 访问权限，则如果用户都在同一局域网中，他们仍然可以进行点对点呼叫。会议将失败。在这种情况下，呼叫设置开始前会有 30 秒的超时。

呼叫设置

您可以将此架构图用作呼叫流序列的视觉参考。图中已清楚地标示了相应的步骤。

体系结构

1. 启动 微软 Teams。
2. Microsoft Teams 向 O365 进行身份验证。租户策略被下推到 Microsoft Teams 客户端，并且相关的 TURN 和信令通道信息被中继到应用程序。
3. 微软 Teams 检测到它正在虚拟桌面代理中运行，并向 Citrix JavaScript API 发出 API 调用。
4. 在 Microsoft Teams 应用程序内部运行的 Citrix JavaScript 脚本会主动建立一个安全的 WebSocket 连接通道，并将其连接到在 VDA 虚拟机上运行的 WebSocketService.exe 服务，此连接随后会在用户会话的内部空间中生成 WebSocketAgent.exe 代理进程。
5. WebSocketAgent.exe 通过调用 思杰 高清体验 微软 Teams 重定向服务 (CtxSvcHost.exe) 来实例化一个通用虚拟通道。
6. Citrix Workspace app’s wfica32.exe (HDX engine) spawns a new process called HdxRtcEngine.exe, which is the new WebRTC engine used for Microsoft Teams optimization.

7. Citrix 媒体引擎和 Teams.exe 具有双向虚拟通道路径，可以开始处理多媒体请求。

   —–用户呼叫——

8. 对等方 A 单击呼叫按钮。Teams.exe 与 Microsoft 365 中的 Microsoft Teams 服务通信，与对等方 B 建立端到端信令路径。Microsoft Teams 向 HdxRtcEngine 请求一系列支持的呼叫参数（编解码器、分辨率等，这被称为会话描述协议 (SDP) 提议）。然后，这些呼叫参数通过信令路径中继到 Microsoft 365 中的 Microsoft Teams 服务，并从那里中继到另一个对等方。
9. SDP 提议/应答（单次协商）通过信令通道进行，并且 ICE 连接检查（使用 STUN 绑定请求进行 NAT 和防火墙遍历）完成。然后，安全实时传输协议 (SRTP) 媒体直接在 HdxRtcEngine.exe 和另一个对等方之间流动（如果是会议，则在 Microsoft 365 会议服务器之间流动）。

微软电话系统

电话系统是 Microsoft 的技术，可在 Microsoft 365 云中通过 Microsoft Teams 实现呼叫控制和 PBX。Microsoft Teams 优化支持电话系统，使用 Microsoft 365 呼叫计划或直接路由。通过直接路由，您可以将自己支持的会话边界控制器直接连接到 Microsoft 电话系统，而无需任何额外的本地软件。 支持呼叫队列、转接、呼叫转移、保持、静音和恢复呼叫。

DTMF (双音多频)

以下版本的 Citrix Workspace 应用程序（及更高版本）支持双音多频 (DTMF) 功能：

• 适用于 Windows 的 Citrix 工作区应用程序 2102 版
• 适用于 Windows 的 Citrix Workspace 应用程序 长期服务版本 1912 累积更新 5（仅限 Windows 10 操作系统）
• 适用于 Linux 的 思杰工作区 应用程序 2101 版本
• 适用于 Mac 的 Citrix Workspace 应用程序 版本号为 2101
• 适用于 ChromeOS 的 思杰工作区 应用程序 2111.1 版本

支持动态 e911

从版本 2112 开始，Citrix Workspace 应用程序支持动态紧急呼叫。在 Microsoft 呼叫计划、运营商连接和直接路由中使用时，它允许您执行以下操作：

• 配置和路由紧急呼叫。
• 通知安全人员。

通知是根据在端点上运行的 Citrix Workspace 应用程序的当前位置提供的，而不是根据在 VDA 上运行的 Microsoft Teams 客户端提供的。

Ray Baum 法案要求将 911 呼叫者的可调度位置传输到相应的公共安全应答点 (PSAP)。使用 HDX 的 Microsoft Teams 优化在与以下版本的 Citrix Workspace 应用程序一起使用时符合 Ray Baum 法案：

• 适用于 Windows 的 Citrix Workspace 应用程序版本 2112.1 及更高版本
• 适用于 Linux 的 Citrix Workspace 应用程序版本 2112 及更高版本
• 适用于 Mac 的 Citrix Workspace 应用程序版本 2112 及更高版本
• 适用于 Chrome 操作系统 的 Citrix Workspace 应用程序 2112 版本及更高版本

要启用动态紧急呼叫，管理员必须使用 Microsoft Teams 管理中心并配置以下内容以创建网络或紧急位置映射：

• 网络设置
• 位置信息服务 (LIS)

有关动态紧急呼叫的更多信息，请参阅Microsoft 文档。

Citrix Workspace 应用程序会将可调度位置信息中继到 Microsoft Teams。这些信息具体如下所示：

• 机箱 ID / 端口 ID，使用链路层发现协议 (LLDP) 进行以太网/交换机连接。以太网/交换机 (LLDP) 支持以下平台：

  • Windows 操作系统，版本 8.1 和 10
  • macOS，需要 LLDP 启用软件。要下载 LLDP 启用软件，请转到 www.microsoft.com 并搜索 LLDP 启用软件。
  • Linux，需要将 LLDP 库包含在瘦客户端的操作系统 (OS) 分发中。
• 安装了 Citrix Workspace 应用程序的端点的无线局域网 BBSID 以及 {IPv4-IPv6; 子网; MAC 地址} 等信息。
  • 子网和基于 WiFi 的位置在适用于 Windows、Linux 和 Mac 的 Workspace 应用程序上受支持。
• 纬度和经度，如果用户在安装 Citrix Workspace 应用程序的操作系统级别授予了权限（权限设置为 HDX RTC Engine）
  • 所有 Workspace 应用程序平台都支持此功能。但是，对于适用于 Linux 的 Citrix Workspace，您必须在瘦客户端的操作系统分发中包含 libgps 库文件 (>sudo apt-get install libgps23 gpsd lldpd)。

防火墙注意事项

当用户首次使用 Microsoft Teams 客户端启动优化呼叫时，他们可能会看到有关 Windows 防火墙设置的警告。该警告要求用户允许 HdxTeams.exe 或 HdxRtcEngine.exe（HDX Overlay Microsoft Teams）进行通信。

以下四个条目已添加到 Windows Defender 防火墙 > 高级安全控制台的入站规则下。如果需要，您可以应用更严格的规则。

微软 Teams 和 商务版 Skype 共存

您可以将 Microsoft Teams 和 Skype for Business 作为两个具有重叠功能的独立解决方案并排部署。 有关详细信息，请参阅 了解 Microsoft Teams 和 Skype for Business 共存和互操作性。

Citrix 实时优化包和 HDX 对 Microsoft Teams 多媒体引擎的优化随后遵循您环境中设置的配置。示例包括孤岛模式以及商务版 Skype 与 Microsoft Teams 协作。此外，还包括商务版 Skype 与 Microsoft Teams 协作和会议。

外设访问一次只能授予单个应用程序。例如，在通话期间，RealTime Media Engine 对网络摄像头的访问会锁定成像设备。设备释放后，即可供 Microsoft Teams 使用。

微软团队和斯凯普共存 ](/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/teams-coexist.png)

Citrix 软件定义广域网™：针对 Microsoft Teams 优化的网络连接

最佳的音频和视频质量需要连接到 Microsoft 365 云的网络，该网络应具有低延迟、低抖动和低数据包丢失。将分支机构位置的 Citrix Workspace 应用程序用户发出的 Microsoft Teams 音频-视频 RTP 流量回传到数据中心，然后再传输到 Internet，可能会增加过多的延迟。这还可能导致 WAN 链路拥塞。Citrix SD-WAN 遵循 Microsoft 365 网络连接原则优化 Microsoft Teams 的连接。Citrix SD-WAN 使用基于 Microsoft REST 的 Microsoft 365 IP 地址和 Web 服务以及邻近 DNS。此用途旨在识别、分类和引导 Microsoft Teams 流量。

许多地区的商业宽带互联网连接都存在间歇性数据包丢失、过度抖动和中断的问题。

当网络状况不稳定或降级时，Citrix SD-WAN 提供两种解决方案来保持 Microsoft Teams 音频-视频质量。

• 如果您使用 Microsoft Azure，部署在 Azure VNET 中的 Citrix SD-WAN 虚拟设备 (VPX) 可提供高级连接优化。这些优化包括无缝链路故障转移和音频数据包竞速。
• Citrix SD-WAN 客户可以通过 Citrix Cloud™ Direct 服务连接到 Microsoft 365。此服务为所有互联网流量提供可靠且安全的交付。

如果分支机构互联网连接的质量不是问题，那么最小化延迟可能就足够了。将 Microsoft Teams 流量直接从 Citrix SD-WAN 分支设备引导到最近的 Microsoft 365 前端，以最大程度地减少延迟。有关更多信息，请参阅 Citrix SD-WAN Office 365 优化。

Citrix 软件定义广域网 ](/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/media/sd-wan.png)

多窗口会议和聊天

您可以在 Windows 中为 Microsoft Teams 使用多个会议或聊天窗口。有关弹出功能的详细信息，请参阅 Microsoft 365 网站上的 Microsoft Teams 聊天和会议弹出窗口。

注意：

This feature is supported with the Citrix Workspace app for Windows 2112.1, Mac 2203, Linux 2203, ChromeOS 2303. It requires VDA 2112 or greater and was back-ported to 1912 CU6+ LTSR.

背景模糊处理和背景效果

适用于 Windows 操作系统、Mac 操作系统、Linux 操作系统和 ChromeOS/HTML5 操作系统 的 Citrix Workspace 应用程序支持通过 HDX 在 Microsoft Teams 优化中实现背景模糊和背景效果。

您可以模糊背景或将其替换为默认图像，并通过帮助对话保持专注于轮廓（身体和面部）来避免意外干扰。您可以在 P2P 或电话会议中使用此功能。

注意：

此功能与 Microsoft Teams UI/按钮集成。多窗口支持是先决条件，需要将 VDA 更新到 2112 或更高版本。有关详细信息，请参阅多窗口会议和聊天。

Microsoft Teams UI 对背景模糊和效果的控制需要以下最低版本：

• 适用于 视窗 操作系统 的 Citrix Workspace 应用程序 版本 2207
• 适用于 Mac 的 思杰工作区应用程序 2301
• 适用于 Linux 的 思杰工作区应用程序 2307
• Citrix Workspace app for ChromeOS 2303

限制：

• 将背景图像替换为 Microsoft Teams 默认图像时，客户端必须连接到 Internet。
• Microsoft Teams UI 不支持管理员和用户定义的背景图像替换。如果图像也存储在客户端上，则可以使用客户端上的配置设置来配置自定义背景图像。

设置自定义背景图像

仅当您不打算使用 Microsoft Teams UI 来控制该功能，或者管理员想要覆盖默认行为时，才需要以下注册表项。例如，禁用背景模糊，因为端点性能不足。

在 Windows 操作系统上

要设置自定义背景图像，管理员或最终用户必须在客户端或端点上配置以下注册表项：

位置：HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream

• Name: VideoBackgroundEffect
• Type: DWORD
• 值：0（禁用），1（启用），2（背景图像替换）

将值设置为 1 会模糊背景。最终用户或管理员可以设置此值。

将值设置为 2 还需要存在 VideoBackgroundImage 键。只有管理员可以设置此值。仅当您要替换背景图像而不是模糊背景时，才需要以下键：

• Name: VideoBackgroundImage
• Type: REG_SZ
• Value: my_image_name.jpeg

视频背景图像必须存在于 C:\Program Files (x86)\Citrix\ICA Client 目录中。

此注册表配置还可用于在 Citrix Workspace app 2206 中启用背景模糊或图像替换，而无需 Microsoft Teams UI 选择器。换句话说，如果您的环境或 VDA 不支持多窗口，您仍然可以使用 Citrix Workspace app 2206 或更高版本应用 HKCU 注册表变通方法以实现类似结果，尽管用户无法在 HDX 会话或 Microsoft Teams 通话期间控制此功能。

注册表项更改仅在 HDX 会话连接时生效。

在 Mac 上

User downloaded picture location: /Users/username/Downloads/any_image.png

运行以下命令将自定义图像设置为默认图像：

defaults write com.citrix.HdxRtcEngine VideoBackgroundEffect -int 2

defaults write com.citrix.HdxRtcEngine VideoBackgroundImage -string "/Users/username/Downloads/any_image.png"

On Linux

用户下载的自定义背景图片文件，其典型的存储位置路径如下所示：/home/username/Downloads/any_image.jpg

Create the file /var/.config/citrix/hdx_rtc_engine/config.json and add the following configuration keys in JSON format. For example,

{

"VideoBackgroundEffect":2,

"VideoBackgroundImage":"/home/username/Downloads/any_image.jpg"

}

在 HTML5 平台上

1. 请导航至 HTML5Client 文件夹，并找到其中的 configuration.js 文件进行编辑。

2. 添加 backgroundEffects 属性并将该属性设置为 true。例如，

   'features' : {
       'msTeamsOptimization' :
       {
           'backgroundEffects' : true
       }
   }
   <!--NeedCopy-->
   

3. 保存更改。

客户端 CPU 消耗注意事项

尽管模糊功能对 CPU 的消耗不大，但您仍可预期消耗会增加。例如，在配备 4 核 1.5 GHz Intel® Pentium® Silver 芯片（TurboBoost 高达 2.8 GHz）的瘦客户端上，背景模糊会使 CPU 使用率增加约 2%。平均 CPU 使用率低于 20%。

Microsoft Teams 中的图库视图和活动发言人

Microsoft Teams 支持图库、大型图库和同框模式布局。

Microsoft Teams 显示一个 2x2 的网格，其中包含四名参与者的视频流（称为画廊）。在这种情况下，Microsoft Teams 会将四个视频流发送到客户端设备进行解码。当超过四名参与者共享视频时，屏幕上只会显示最后四位最活跃的发言者。

Microsoft Teams 还提供大型画廊视图，网格最大可达 7x7。因此，Microsoft Teams 会议服务器会合成单个视频源并将其发送到客户端设备进行解码，从而降低 CPU 消耗。这种单一的矩阵式视频源也可能包含用户的自我预览视频。

最后，Microsoft Teams 支持同框模式，这是新会议体验的一部分。Microsoft Teams 利用 AI 分割技术将参与者数字化地放置在共享背景中，从而将所有参与者置于同一礼堂中。

用户可以在电话会议期间通过在省略号菜单中选择画廊、大型画廊或同框模式布局来控制这些模式。

支持视频宽高比限制功能（适用于 Windows 2102 的 Citrix Workspace 应用程序、适用于 Linux 2106 的 Citrix Workspace 应用程序、适用于 MAC 2106 及更高版本的 Citrix Workspace 应用程序）：

• 在画廊/大型画廊视图中，可以使用填充到帧选项。此选项会裁剪视频大小以适应子窗口。另一方面，适应到帧会在视频两侧显示黑边（信箱模式），因此不会进行裁剪。

以下表格详细比较了画廊视图和大型画廊视图的布局差异：

微软 Teams 中的屏幕共享

Microsoft Teams 依赖于基于视频的屏幕共享 (VBSS)，有效地使用诸如 H264 等视频编解码器对正在共享的桌面进行编码，并创建高清流。借助 HDX 优化，传入的屏幕共享被视为视频流。

从适用于 Windows、Linux、Mac 的 Citrix Workspace 应用程序 2109 或更高版本以及适用于 ChromeOS 的 Citrix Workspace 应用程序 2303 开始，用户可以同时共享其屏幕和视频摄像头。

在早期版本中，如果您正在进行视频通话，而另一方开始共享桌面，则原始摄像头视频源会暂停。相反，会显示屏幕共享视频源。然后对方必须手动恢复摄像头共享。

PowerPoint 直播功能的重要注意事项

如果您正在从 PowerPoint Live 共享内容，则此限制不存在。在这种情况下，其他参与者仍然可以看到您的网络摄像头和内容，并来回导航以查看其他幻灯片。在此场景中，幻灯片在 VDA 上呈现。要访问 PowerPoint Live 幻灯片组，请单击“共享托盘”按钮并选择建议的 PowerPoint 幻灯片之一，或单击“浏览”并在您的计算机或 OneDrive 中查找 PowerPoint 文件。

出站屏幕共享也已优化并卸载到 Citrix Workspace 应用程序。在这种情况下，媒体引擎仅捕获和传输 Citrix Desktop Viewer (CDViewer.exe) 窗口，并在其周围绘制红色边框。任何与 Desktop Viewer 重叠的本地应用程序都不会被捕获。

注意

在适用于 Mac 的 Citrix Workspace 应用程序中设置特定权限以启用屏幕共享。有关详细信息，请参阅 系统要求。

已知限制：

• 如果 Desktop Viewer 被禁用或者正在使用 Desktop Lock，则 Microsoft Teams 屏幕选择器中不可用多显示器选择。Desktop Viewer 可能会通过编辑 .ICA 文件模板或 StoreFront web.config 被禁用。SHIFT+F2 热键与多显示器屏幕共享不兼容。
• 在早于 2106 版本的 Workspace 应用程序中，仅共享主显示器。将虚拟桌面中的应用程序拖动到主显示器，以便通话中的其他参与者可以看到它。
• 如果您使用虚拟显示器布局功能（单个物理显示器的逻辑分区）配置 Citrix Workspace 应用程序，则多显示器屏幕共享可能无法工作。在这种情况下，所有虚拟显示器都将作为复合图像共享。
• 适用于 Windows 的旧版本 Citrix Workspace 应用程序（1907 至 2008）还会共享在客户端计算机中运行的本地应用程序。仅当本地应用程序叠加在 Desktop Viewer 之上时，才能进行此共享。此行为在 2009.6 或更高版本以及 1912 CU5 或更高版本中已移除。
• 在屏幕共享期间，如果您从窗口模式切换到全屏模式，屏幕共享将停止。您必须停止并再次共享才能使屏幕共享正常工作。
• 无法将共享控件固定到优化版 Microsoft Teams 中的特定位置。
• 共享最小化的应用程序时，该应用程序的标题栏也可能被共享。

从无缝应用程序进行屏幕共享：

如果您将 Microsoft Teams 发布为独立的无缝应用程序，屏幕共享将捕获物理端点的本地桌面。需要 Citrix Workspace 应用程序最低版本 1909。

应用程序共享

从适用于 Windows 的 Citrix Workspace 应用程序 2112.1 版本和 VDA 2112 版本开始，微软 Teams 支持应用程序共享功能。

从适用于 Windows 的 Citrix Workspace 应用程序 2109、Mac 2203、Linux 2209 和 VDA 2109 开始，Microsoft Teams 支持共享在虚拟会话中运行的特定应用程序的屏幕。您还可以使用优化版 Microsoft Teams 共享自定义内部应用程序，例如 Java。要共享特定应用程序，请执行以下操作：

1. 在远程会话中导航到 Microsoft Teams 应用程序。
2. 在您的 Microsoft Teams 用户界面 中单击共享内容。
3. 选择要在会议中共享的应用程序。您选择的应用程序周围会出现红色边框，通话中的参与者可以看到共享的应用程序。

要共享不同的应用程序，请再次单击共享内容并选择一个新应用程序。

如果要禁用应用程序共享，请在 VDA 上的 HKLM\SOFTWARE\Citrix\Graphics 处创建以下注册表项： 名称：UseWsProvider 类型：DWORD 值：0

注意：

• 如果最小化应用程序，Microsoft Teams 将显示共享应用程序的最后一张图像。您可以最大化窗口以恢复屏幕共享。
• 屏幕共享取决于 VDA 侧的窗口捕获。然后，内容以最大速率中继到 Citrix Workspace 应用程序。最大速率为每秒 30 帧。Citrix Workspace 应用程序将内容转发到对等方或会议服务器。

特定应用程序屏幕共享的已知限制：

• 屏幕共享应用程序时，鼠标指针不可见。
• 如果您在共享应用程序时将其最小化，则屏幕选择器中仅显示应用程序图标。应用程序的缩略图不会在屏幕选择器中预览。您无法共享内容，并且红色边框在您最大化应用程序之前不会出现。
• LAA 应用程序在 VDA 中优化的 Microsoft Teams 中显示可与桌面应用程序共享的应用程序列表。但是，当您从列表中选择应用程序时，结果可能不符合预期。

与应用程序保护的兼容性 特定应用程序的屏幕共享与 HDX 优化 Microsoft Teams 中的应用程序保护功能兼容。如果您从启用了应用程序保护的交付组启动了应用程序或桌面，则可以屏幕共享特定应用程序。

当您在 Microsoft Teams UI 中单击共享内容时，屏幕选择器会删除桌面选项。您只能选择窗口选项来共享任何打开的应用程序。

注意：

如果您使用的是适用于 Windows 2202 或更早版本的 Citrix Workspace 应用程序，则从启用了应用程序保护的交付组启动应用程序或桌面时，将无法看到传入的视频或屏幕共享。

在 Microsoft Teams 中授予和请求控制权

此功能在以下版本的 Citrix Workspace 应用程序中受支持（不依赖于 VDA 版本或操作系统、单会话或多会话）：

• 适用于 Windows 的 思杰工作区 应用程序 2112.1 版或更高版本
• 适用于 Mac 的 Citrix Workspace 应用程序 2203.1 版或更高版本
• 适用于 Linux 的 Citrix Workspace 应用程序 2203 版或更高版本
• 适用于 Chrome 操作系统 的 Citrix Workspace 应用 2303 版或更高版本

在 Microsoft Teams 通话期间，当参与者共享屏幕时，您可以请求控制权。获得控制权后，您可以对共享屏幕进行选择、编辑或其他键盘和鼠标操作。

要在屏幕共享时取得控制权，请单击 Microsoft Teams UI 中的“请求控制”按钮。共享屏幕的会议参与者可以允许或拒绝您的请求。

在您拥有控制权时，可以对共享屏幕进行选择、编辑和其他修改。对于这些操作，您可以使用键盘和鼠标。完成后，单击“请求控制”。

限制：

• 如果用户共享单个应用程序（也称为应用程序共享），则“授予”和“请求”控制不可用。必须共享整个桌面或显示器。
• 将控制栏固定到特定位置的功能目前尚不支持。

微软团队中的外设

当 Microsoft Teams 优化处于活动状态时，Citrix Workspace 应用程序会访问外设（耳机、麦克风、摄像头、扬声器等）。然后，外设会在 Microsoft Teams UI（设置 > 设备）中正确列出。

Microsoft Teams 不直接访问设备。相反，它依赖于 Workspace 应用程序 WebRTC 媒体引擎来获取、捕获和处理媒体。Microsoft Teams 会列出设备供用户选择。

在 Microsoft Teams 处于活动状态时插入的外设不会默认选中。您必须从 Microsoft Teams UI 的“设置”>“设备”屏幕手动选择外设。选择外设后，Microsoft Teams 会缓存外设信息。因此，当您从同一端点重新连接到会话时，外设会自动选中。

建议：

• Microsoft Teams 认证的内置回声消除耳机。在具有额外外设的设置中，如果麦克风和扬声器位于单独的设备上，可能会出现回声。例如，带内置麦克风的网络摄像头和带扬声器的显示器。使用外部扬声器时，请将其尽可能远离麦克风。此外，请将其放置在远离任何可能将声音折射到麦克风中的表面。有关详细信息，请访问 www.microsoft.com 并搜索 Microsoft Teams 认证耳机。
• Microsoft Teams certified cameras, although Skype for Business certified peripherals are compatible with Microsoft Teams. For more information, go to and search for Microsoft Teams certified cameras and Skype for Business certified peripherals.
• Citrix Workspace 应用程序媒体引擎无法利用执行板载 H.264 编码 (UVC 1.1 和 1.5) 的网络摄像头的 CPU 卸载功能。

注意：

适用于 Windows 的 Workspace 应用程序 2009.6 现在可以获取具有 24 位音频格式或频率高于 96 kHz 的外设。

HdxTeams.exe（在适用于 Windows 的 Citrix Workspace 应用程序 2009 或更早版本中）仅支持以下特定音频设备格式（通道、位深度和采样率）：

• 播放设备：最多 2 个通道，16 位，频率高达 96,000 Hz
• 录制设备：最多 4 个通道，16 位，频率高达 96,000 Hz

即使一个扬声器或麦克风不符合预期设置，Microsoft Teams 中的设备枚举也会失败，并且“设置”>“设备”下会显示“无”。

HdxTeams.exe 中的 Webrpc 日志会显示以下类型的信息：

Mar 27 20:58:22.885 webrtcapi.WebRTCEngine Info: init. initializing...

Mar 27 20:58:23.190 webrtcapi.WebRTCEngine Error: init. couldn't create audio module!

作为一种解决方法，请禁用特定设备或：

1. 打开声音控制面板 (mmsys.cpl)。
2. 选择播放或录音设备。
3. 转到属性 > 高级，并将设置更改为受支持的模式。

回退模式

如果 Microsoft Teams 未能在优化的 VDI 模式下加载（在 Microsoft Teams/关于/版本中显示“Citrix HDX 未连接”），VDA 将回退到旧版 HDX 技术。旧版 HDX 技术可能是网络摄像头重定向以及客户端音频和麦克风重定向。如果您使用的 Workspace 应用程序版本/平台操作系统不支持 Microsoft Teams 优化，则回退注册表项不适用。 在回退模式下，外设将映射到 VDA。外设在 Microsoft Teams 应用程序中显示，就像它们本地连接到虚拟桌面一样。

您现在可以通过在 VDA 中设置注册表项来精细控制回退机制。有关详细信息，请参阅通过注册表管理的特性列表中的Microsoft Teams 回退模式。

此功能需要 Microsoft Teams 版本 1.3.0.13565 或更高版本。

在 Microsoft Teams 应用程序中查看设置 > 设备选项卡时，要确定您是处于优化模式还是未优化模式，主要区别在于摄像头名称。如果 Microsoft Teams 在未优化模式下加载，则会启动旧版 HDX 技术。网络摄像头名称带有 Citrix HDX 后缀，如下图所示。与优化模式相比，扬声器和麦克风设备名称可能略有不同（或被截断）。

使用旧版 HDX 技术时，Microsoft Teams 不会将音频、视频和屏幕共享处理卸载到端点的 Citrix Workspace 应用程序 WebRTC 媒体引擎。相反，HDX 技术使用服务器端渲染。开启视频时，预计 VDA 上的 CPU 消耗会很高。实时音频性能可能不理想。

已知局限性

思杰局限性

Citrix Workspace 应用程序存在以下限制：

• HID 按钮 - 不支持接听和结束通话。支持音量增大和减小。
• Microsoft Teams 管理中心中的 QoS 设置不适用于 VDI 用户。
• 用户无法在使用 VDA 上的截图工具时截取 Microsoft Teams 内容的屏幕截图。但是，如果在客户端使用截图工具，则可以捕获内容。

VDA 上的限制：

• 当您将 Citrix Workspace app 高 DPI 设置配置为 Yes 时，重定向的视频窗口会显示在不正确的位置。当显示器的 DPI 缩放因子设置为 100% 以上时，会出现此限制。

关于 Citrix Workspace 应用程序和 VDA 的一些限制：

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

同步传输

Windows 和 Mac 上已为优化的 Microsoft Teams 视频会议通话启用同步传输支持。对于 Linux，请咨询您的瘦客户端供应商。 通过同步传输，视频会议通话在不同端点上的质量和体验得到改善，因为它会调整到适当的分辨率，为所有通话者提供最佳通话体验。

借助这种改进的体验，每个用户可以根据端点功能、网络条件等多种因素，以不同的分辨率（例如 720p、360p 等）传输多个视频流。接收端点随后会请求其可以处理的最高质量分辨率，从而为所有用户提供最佳视频体验。

注意：

此功能仅在 Microsoft Teams 推出更新后可用。有关预计到达时间 (ETA) 的信息，请访问 https://www.microsoft.com/ 并搜索 Microsoft 365 路线图。当 Microsoft 推出更新后，您可以查看 CTX253754 以获取文档更新和公告。

微软的局限性

• 不支持 3x3 画廊视图。Microsoft Teams 依赖项 – 请联系 Microsoft 以了解何时可以期待 3x3 网格。
• 与 Skype for Business 的互操作性仅限于音频呼叫，不支持视频模式。
• 输入和输出视频流的最大分辨率为 720p。
• 不支持 PSTN 呼叫回铃音。
• Direct Routing 的媒体旁路不受支持。
• 不支持广播和实时事件的制作人及演示者角色。支持参与者角色，但未优化（而是在 VDA 上呈现）。
• 不支持 Microsoft Teams 中的放大和缩小功能。
• 不支持基于位置的路由和媒体旁路。
• 不支持呼叫合并（用户界面中不显示此选项）。

Citrix 和 微软的限制

• 屏幕共享时，包括系统音频选项不可用。
• ChromeOS 不支持同播功能。

即将推出的 Microsoft Teams 单窗口终止支持

2024 年 1 月 31 日，Microsoft 将停止对使用 VDI Microsoft Teams 优化时的单窗口 UI 的 Microsoft Teams 支持，并仅支持多窗口体验。Microsoft 已于 2023 年 9 月 8 日在 M365 管理中心（帖子 ID：MC674419）发布了此弃用通知。 有关多窗口功能的公开详细信息，请参阅技术社区文章：New Meeting and Calling Experience in Microsoft Teams。

注意：

Citrix 建议您将 VDA 和 Citrix Workspace 应用程序升级到受支持的版本，以便继续在优化模式下使用 Microsoft Teams 进行视频和屏幕共享。如果您不升级您的基础架构和端点以支持多窗口，您的呼叫、视频呼叫和屏幕共享将变为未优化。这可能会导致呼叫质量问题、延迟增加以及服务器负载增加。

下表说明了在 Citrix VDI 上继续使用 Microsoft Teams 中的优化呼叫所需的 VDA 和 Citrix Workspace 应用程序的最低版本、LTSR 版本和推荐版本：

注意：

1. 最低版本：这是首次引入多窗口功能的版本。此处列出的一些最低版本可能已终止支持。
2. LTSR 支持的版本：这是 Citrix 为多窗口功能支持的 LTSR 版本。这些 LTSR 版本的旧版本可能仍可运行，但一旦发布新的 LTSR CU 版本，这些版本将不再提供支持。有关 LTSR 支持策略的更多信息，请参阅 https://support.citrix.com/support-home/kbsearch/article?articleNumber=CTX205549/faq-citrix-virtual-apps-and-desktops-and-citrix-hypervisor-long-term-service-release-ltsr。
3. 推荐版本：这是 Citrix 建议用户/客户升级其软件时使用的版本。这些都是 CR 版本。
4. 适用于 VDA 和 CWA 基础版本的 2203 LTSR 版本包含多窗口功能。这些版本已被最新 CU 取代，最新 CU 是官方支持的版本。客户可以自行决定继续使用这些不受支持的版本。Citrix 鼓励使用 LTSR 版本的客户升级到最新的 CU。

WebRTC 中 SDP 格式（方案 B）的弃用公告

Citrix 计划在未来的版本中弃用 WebRTC 中当前 SDP 格式（方案 B）的支持。您必须在 WebRTC 中使用统一计划 (Unified Plan) 来支持优化的 Microsoft Teams 功能。

受影响的产品清单

在 Citrix Workspace 应用程序的未来版本中，Citrix Workspace 应用程序即将发布的版本与 Citrix Workspace 应用程序 2108 或更早版本之间的端点通话将不受支持。这种通话不兼容性包括 1912 LTSR Citrix Workspace 应用程序客户端 (CWA)。以下 CWA 客户端受到影响：

• 适用于 Windows 的 思杰工作区应用程序
• 适用于 Linux 的 思杰工作区应用程序
• 适用于 Mac 的思杰工作区应用
• 适用于 Chrome 的思杰工作区应用

方案 B 的替代方案

如果您运行的 Citrix Workspace 应用程序版本低于 2109，则必须升级到受支持的版本（最好是最新的 CR 版本）。否则，与未来版本或更新端点的任何通话都将无法连接。如果联合通信伙伴尚未升级其 Citrix Workspace，则未来版本与您的联合通信伙伴之间的通话也可能无法完成。

Citrix Workspace 应用程序 2108 版本已于 2023 年 3 月结束支持，必须升级到更新版本。有关 Citrix Workspace 应用程序版本支持的详细信息，请参阅 Workspace App。

有关 Plan B 弃用的更多信息，请参阅 WebRTC 文档。

其他相关信息

• 监视、排查和支持 微软团队
• 将 Microsoft Teams 桌面应用部署到虚拟机
• 使用 MSI 安装 微软团队（VDI 安装部分）
• 瘦客户端
• 商务版 Skype 网络评估工具(https://www.microsoft.com/zh-cn/download/details.aspx?id=53885)
• 了解 Microsoft Teams 和 商务版 Skype 的共存和互操作性(https://docs.microsoft.com/zh-cn/microsoftteams/teams-and-skypeforbusiness-coexistence-and-interoperability)