微软 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。

对于远程 PC 访问

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，以便它能够正确检测远程 PC 访问状态（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 位虚拟机上安装 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。
• 如果您正在使用 Citrix Workspace Environment Management™ (WEM) 这一产品，建议您启用CPU 峰值保护功能，以便有效管理 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 标准版和数据中心版，并支持服务器核心选项

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

支持的操作系统：

• 视窗 11
• Windows 10 64 位，版本 1607 及更高版本。Citrix Workspace app for Windows 2109.1 及更高版本支持虚拟机托管应用程序
• Windows Server 2022、2019、2016 和 2012 R2（标准版和数据中心版）

所需条件：

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

推荐版本为适用于 Windows 的 Citrix Workspace 应用程序最新当前发布版本，最低版本为适用于 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 或更高版本
• 开放安全套接字层 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

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

有关详细信息，请参阅 (/zh-cn/citrix-workspace-app-for-linux/system-requirements.html) [安装 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 及更高版本。
• 苹果操作系统 Monterey。

支持的功能：

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

注意：

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

微软 Teams 优化功能默认适用于 Citrix Workspace 应用程序 2012 及更高版本以及 苹果操作系统 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

软件

一台虚拟机（40 个逻辑处理器），运行 Windows 2019 (TSVDA) 版思杰虚拟应用和桌面 2106 威睿 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）运行的服务器可伸缩性测试。
• Microsoft Teams 工作负载：知识工作者的典型工作负载，并包含 Microsoft Teams 的使用。

Microsoft Teams 是如何进行压力测试的

• Microsoft Teams 已通过 HDX 优化。因此，所有多媒体处理都卸载到端点或客户端，不属于测量范围。
• 在工作负载启动之前，所有 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 或更高版本，则实时字幕仅在 Citrix Workspace 应用程序版本为适用于 MAC 的 2203.1、适用于 Linux 的 2203 或适用于 Windows 的 2112 时才起作用。这是因为如果 Microsoft Teams 处于单窗口 UI 模式或多窗口模式，实时字幕的行为会有所不同。
5. 多窗口模式在 2112 VDA 中引入，但已向后移植到 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。请确保管理策略未设置为禁止，并且 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 选项 > 连接 > LAN 设置 > 代理服务器中选择不使用代理服务器访问本地地址设置，并绕过 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 累积更新 5（协商/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 候选收集过程的更多信息，请参阅 Support 部分中的“收集日志”。

注意：

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

呼叫设置

此架构图可作为呼叫流程序列的可视化参考。图中已明确标示出相应的步骤。

体系结构

1. 启动 微软团队。
2. Microsoft Teams 向 O365 进行身份验证。租户策略被下推到 Microsoft Teams 客户端，并且相关的 TURN 和信令通道信息被中继到应用程序。
3. 微软团队 检测到它正在 虚拟桌面代理 中运行，并向 Citrix JavaScript 应用程序接口 发出 应用程序接口 调用。
4. Citrix JavaScript in Microsoft Teams opens a secure WebSocket connection to WebSocketService.exe running on the VDA, which spawns WebSocketAgent.exe inside the user session.
5. WebSocketAgent.exe 通过调用名为 思杰 HDX 微软 Teams 重定向服务 的组件（其可执行文件为 CtxSvcHost.exe），从而实例化一个通用的虚拟通道。
6. 思杰 Workspace 应用程序的 wfica32.exe (HDX 引擎) 生成一个名为 HdxRtcEngine.exe 的新进程，该进程是用于 微软 Teams 优化的新 WebRTC 引擎。

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 应用程序（及更高版本）：

• 思杰工作区应用程序 Windows 版 2102
• 思杰工作区应用程序 Windows 版 LTSR 1912 CU5（仅限 Windows 10 操作系统）
• 思杰工作区应用程序 适用于 Linux 版本 2101
• 适用于 Mac 平台的 Citrix 工作区应用程序 2101 版本
• 适用于 ChromeOS 平台的 Citrix 工作区应用程序 2111.1 版本

支持动态 e911

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

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

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

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

• 适用于 Windows 的 Citrix Workspace 应用程序版本 2112.1 及更高版本
• 适用于 Linux 的 Citrix Workspace 应用程序版本 2112 及更高版本
• 适用于 Mac 的 Citrix Workspace 应用程序版本 2112 及更高版本
• 适用于 ChromeOS 的思杰工作区应用程序版本 2112 及更高版本

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

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

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

思杰工作区应用程序中继到微软团队的可调度位置信息包括：

• 机箱 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 防火墙 > 高级安全控制台的入站规则下。如果需要，您可以应用更严格的规则。

微软团队和 Skype 企业版共存

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

Citrix RealTime 优化包和 HDX 对微软 Teams 多媒体引擎的优化将遵循您环境中设置的配置。示例包括孤岛模式以及 Skype for Business 与微软 Teams 的协作。此外，还包括 Skype for Business 与微软 Teams 的协作和会议。

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

Citrix SD-WAN™: 适用于 微软 Teams 的优化网络连接

最佳的音频和视频质量需要连接到 Microsoft 365 云的网络，该网络应具有低延迟、低抖动和低数据包丢失。将 Microsoft Teams 音视频 RTP 流量从分支机构的 Citrix Workspace 应用程序用户回传到数据中心，然后再连接到互联网，可能会增加过多的延迟。这还可能导致 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 优化。

多窗口会议和聊天

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

注意：

此功能支持以下版本的 Citrix Workspace 应用程序：Windows 2112.1、Mac 2203、Linux 2203 和 ChromeOS 2303。它需要 VDA 2112 或更高版本，并且已向后移植到 1912 CU6+ LTSR 版本。

背景模糊和背景效果功能

适用于 Windows、Mac、Linux 以及 ChromeOS/HTML5 操作系统平台的 Citrix Workspace 应用程序，在通过 HDX 技术对 Microsoft Teams 进行优化时，能够支持背景模糊和背景效果功能。

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

注意：

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

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

• Citrix Workspace app for Windows 2207
• 思杰工作区应用程序适用于 Mac 2301
• 思杰工作区应用程序适用于 Linux 2307
• 适用于 ChromeOS 的 思杰工作区应用程序 2303

限制：

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

设置自定义背景图像

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

在 视窗 上

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

位置：HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream

• Name: VideoBackgroundEffect
• 此值的类型为: DWORD
• 值：0（禁用）、1（启用）、2（背景图像替换）

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

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

• 此自定义视频背景图像设置的名称为: 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

User downloaded picture location: /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. Navigate to the configuration.js file in the HTML5Client folder.

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 分割技术将参与者数字地放置在共享背景中，从而将所有参与者置于同一个礼堂中。

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

Support for video aspect ratio constraints (Citrix Workspace app for Windows 2102, Citrix Workspace app for Linux 2106, Citrix Workspace app for MAC 2106 and later):

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

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

微软 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 中的特定位置。
• 共享最小化应用程序时，应用程序的标题栏也可能被共享。

屏幕共享(/zh-cn/citrix-virtual-apps-desktops/2407/media/desktop-viewer-teams.png)

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

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

应用程序共享

自适用于 Windows 的 Citrix Workspace 应用程序 2112.1 版本以及 VDA 2112 版本起，微软团队开始支持应用程序共享功能。

从适用于 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 中单击共享内容时，屏幕选择器会删除桌面选项。您只能选择窗口选项来共享任何打开的应用程序。

注意：

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

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

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

• 适用于 Windows 操作系统的 Citrix Workspace 客户端应用程序 2112.1 版或更高版本
• 适用于 Mac 的 Citrix Workspace 应用程序 2203.1 版或更高版本
• 适用于 Linux 的 Citrix Workspace 应用程序 2203 版或更高版本
• 适用于 ChromeOS 操作系统的 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 认证耳机。
• 微软 Teams 认证的摄像头，尽管 Skype 商务版 认证的外设与 微软 Teams 兼容。如需了解更多信息，请访问 并搜索 微软 Teams 认证的摄像头和 Skype 商务版 认证的外设。
• Citrix Workspace 应用程序媒体引擎无法利用执行板载 H.264 编码的 UVC 1.1 和 1.5 网络摄像头的 CPU 卸载功能。

注意：

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

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

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

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

Webrpc logs in HdxTeams.exe show this type of information:

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 消耗会很高。实时音频性能可能不理想。

已知局限性

思杰局限性

思杰 Workspace 应用程序的局限性：

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

VDA 上的限制：

• 当您将 Citrix Workspace 应用程序高 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 中的放大和缩小功能不受支持。
• 不支持基于位置的路由和媒体旁路。
• 不支持呼叫合并（用户界面中不显示此选项）。

思杰和微软的局限性

• 进行屏幕共享时，包括系统音频选项不可用。
• 在 ChromeOS 上不支持联播。

即将到来的 Microsoft Teams 单窗口终止支持

2024 年 1 月 31 日，Microsoft 将停止对使用 VDI Microsoft Teams 优化时的 Microsoft Teams 单窗口 UI 的支持，并仅支持多窗口体验。Microsoft 已于 2023 年 9 月 8 日在 M365 管理中心发布了此弃用通知（帖子 ID：MC674419）。 有关多窗口功能的公开详细信息，请参阅技术社区文章：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/article/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 的 Citrix 工作区应用程序
• 适用于 Mac 的 Citrix 工作区应用程序
• 思杰工作区应用程序适用于 Chrome

方案 B 的替代方案

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

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

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

其他相关信息

• 监视、排查和支持 微软团队
• 将 微软团队 桌面应用部署到 VM
• 使用 MSI 安装 微软 Teams（VDI 安装部分）
• 瘦客户端
• 商务版 Skype 网络评估工具
• 了解 微软团队 和 Skype 商务版 的共存和互操作性