Microsoft Teams 的优化

使用 Citrix Virtual Apps and Desktops 或 Citrix DaaS 以及 Citrix Workspace 应用程序为基于桌面的 Microsoft Teams 进行优化。Microsoft Teams 优化类似于 Microsoft Skype for Business 的 HDX RealTime 优化。不同的是，我们将 Microsoft Teams 优化所需的所有组件捆绑到 VDA 和适用于 Linux 的 Citrix Workspace 应用程序中。

通过 Microsoft Teams 优化，适用于 Linux 的 Citrix Workspace 应用程序支持音频、视频和屏幕共享功能 。

注意：

• 只有 Ubuntu 20.04 或更高版本支持 Microsoft Teams 优化。
• Citrix Virtual Apps and Desktops 和 Citrix DaaS 都支持 Microsoft 优化。
• 对于使用 Dell Wyse 的瘦客户端，请使用 Citrix Configuration Editor 编辑 /var/.config/citrix/hdx_rtc_engine/config.json 文件中的任意参数。有关详细信息，请参阅 Dell 文档。

有关如何启用日志收集的信息，请按照 Microsoft Teams 的日志收集下提到的步骤进行操作。

有关系统要求的信息，请参阅 Microsoft Teams 优化要求。

有关详细信息，请参阅 Microsoft Teams 优化和 Microsoft Teams 重定向。

音频配置增强功能

如果 Microsoft Teams 配置了自动增益控制和噪音抑制选项，Citrix 重定向的 Microsoft Teams 将遵循配置的值。否则，默认情况下将启用这些选项。但是，自 Citrix Workspace 应用程序 2104 起，回声消除选项默认处于禁用状态。音频问题的示例包括机器人语音、CPU 过高导致音频不稳定等。自 Citrix Workspace 应用程序 2112 起，管理员可以通过执行以下操作更改默认设置来解决音频问题：

1. 导航到 /var/.config/citrix/hdx_rtc_engine/config.json 文件。
2. 设置以下选项：
   • EnableAEC 值 1 表示启用，0 表示禁用回声消除
   • EnableAGC 值 1 表示启用，0 表示禁用自动增益控制
   • EnableNS 值 1 表示启用，0 表示禁用噪声抑制

mkdir -p /var/.config/citrix/hdx_rtc_engine

vim /var/.config/citrix/hdx_rtc_engine/config.json

{

      "EnableAEC":1,"EnableAGC":1,"EnableNS":1

}
<!--NeedCopy-->

建立调用后，监视 webrpc 日志 (/tmp/webrpc/<current date>/) 中是否存在以下条目以验证更改是否已生效：

/tmp/webrpc/Wed_Feb__2_14_56_33_2022/webrpc.log:[040.025] Feb 02 14:57:13.220 webrtcapi.NavigatorUserMedia Info: getUserMedia. audio constraints, aec=1, agc=1, ns=1
<!--NeedCopy-->

面向 Microsoft Teams 的编码器性能估算器

HdxRtcEngine 是嵌入在 Citrix Workspace 应用程序中的 WebRTC 媒体引擎，用于处理 Microsoft Teams 重定向。HdxRtcEngine.exe 可以预估端点的 CPU 在不超载的情况下可以承受的最佳传出视频（编码）分辨率。可能的值为 240p、360p、720p 和 1080p。

性能估算过程将使用宏块代码来确定可通过特定端点实现的最佳分辨率。调用设置期间的编解码器协商包括尽可能高的分辨率。编解码器协商可以是对等方之间的协商，也可以是对等方与会议服务器之间的协商。

对于具有自己的最大可用分辨率的端点，下表列出了四种性能类别：

要设置传输视频（编码）分辨率值（例如 360p），请从终端运行以下命令：

mkdir -p /var/.config/citrix/hdx_rtc_engine

vim /var/.config/citrix/hdx_rtc_engine/config.json

{

    "OverridePerformance":1

}
<!--NeedCopy-->

Microsoft Teams 的日志收集

要为 Microsoft Teams 启用日志收集，请执行以下操作：

1. 导航到 /opt/Citrix/ICAClient/debug.ini 文件。

2. 修改 [HDXTeams] 部分，如下所示：

   [HDXTeams]
   ; Retail logging for HDXTeams 0/1 = disabled/enabled
   HDXTeamsLogSwitch = 1
   ; Debug logging; , It is in decreasing order
   ; LS_NONE = 4, LS_ERROR = 3, LS_WARNING = 2, LS_INFO = 1, LS_VERBOSE = 0
   WebrtcLogLevel = 0
   ; None = 5, Info = 4, Warning = 3, Error = 2, Debug = 1, Trace = 0
   WebrpcLogLevel = 0
   
   <!--NeedCopy-->
   

也可以通过在 config.json 文件中添加以下行来启用日志收集：

{
"WebrpcLogLevel": 0,"WebrtcLogLevel": 0
}
<!--NeedCopy-->

为 llvm-12 添加 libunwind-12 库依赖项

自版本 2111 起，为 llvm-12 添加了名为 libunwind-12 库的新依赖项。但是，默认情况下，该依赖项在原始存储库中不存在。请按照以下步骤在存储库中手动安装 libunwind-12 库：

1. 打开终端。

2. 输入以下行以安装 llvm 存储库密钥文件：

   
    wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key|sudo apt-key add
   <!--NeedCopy-->
   

3. 输入以下行以配置 llvm 存储库源列表：

    sudo vim /etc/apt/sources.list
   <!--NeedCopy-->
   

4. 添加以下行：

   deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-12 main
   deb-src http://apt.llvm.org/bionic/ llvm-toolchain-bionic-12 main
   <!--NeedCopy-->
   

5. 运行以下命令以安装 libunwind-12 库：

   sudo apt-get update -y
   sudo apt-get install libunwind-12
   <!--NeedCopy-->
   

配置首选网络接口

自 Citrix Workspace 应用程序 2303 版本起，您现在可以为媒体流量配置首选网络接口。使用此增强功能，如果您有多个网络连接并且默认网络的性能不佳，则可以更改到另一个网络。要启用此增强功能，请执行以下操作：

1. 导航到 /var/.config/citrix/hdx_rtc_engine/config.json 文件。

2. 转到以下部分：

          mkdir -p /var/.config/citrix/hdx_rtc_engine
   
           vim /var/.config/citrix/hdx_rtc_engine/config.json
   
          {
   
               ”NetworkPreference”:1
   
           }
   <!--NeedCopy-->
   

3. 根据需要使用以下值之一更新“NetworkPreference:”值：

   • 1：以太网
   • 2：Wi-Fi
   • 3：手机网络
   • 4：VPN
   • 5：环回
   • 6：任何

默认情况下，如果未设置任何值，WebRTC 媒体引擎将选择最佳可用路线。

为 Microsoft Teams 优化配置 UDP 端口范围

在 2402 版本中，您可以为 Microsoft Teams 优化指定 UDP 端口的最小和最大范围。如果由于任何原因无法分配 UDP 端口，WebRTC 将回退到 TCP。要启用此功能，请在客户端设备上的 /var/.config/citrix/hdx_rtc_engine/config.json 配置文件中添加以下两个新配置项目：

• PortRangeMin 代表最小 UDP 端口
• PortRangeMax 代表最大 UDP 端口

请确保满足以下两个条件才能使此功能生效：

• 必须设置最小和最大 UDP 端口。
• 最小端口必须比最大端口小 10 个数字。

要启用此功能，请在客户端设备上执行以下操作：

1. 导航到 /var/.config/citrix/hdx_rtc_engine/config.json 配置文件。

2. 将 PortRangeMin 和 PortRangeMax 数字相加。

   // config file /var/.config/citrix/hdx_rtc_engine/config.json
   
   {
       "PortRangeMin" : 30000,
       "PortRangeMax" : 31000
   }
   <!--NeedCopy-->
   

Microsoft Teams 优化的增强功能

• 自 Citrix Workspace 应用程序的 2101 版起：
  • Citrix Workspace 应用程序安装程序已与 Microsoft Teams 铃声一起打包。
  • 音频输出会自动切换到新插入的音频设备，并处于合适的音频音量。
  • HTTP 代理支持匿名身份验证。

• 自 Citrix Workspace 应用程序的 2103 版起，默认情况下会禁用 VP9 视频编解码器。

• 自 Citrix Workspace 应用程序的 2104 版起，默认情况下会禁用回声消除功能。我们建议您不要使用内置扬声器和麦克风进行通话。请改为使用耳机。此修复旨在解决瘦客户端上发现的不连贯的音频问题

• 自 Citrix Workspace 应用程序的 2106 版起：

  • 以前，单击屏幕共享时， 默认显示器或主显示器的预览功能仅适用于屏幕共享。

    在本版本中，所有屏幕的预览将在屏幕选取器菜单中显示。可以选择 VDA 环境中用于屏幕共享的任何屏幕。选定的显示器上将显示一个红色正方形，选定屏幕内容的小图片将显示在屏幕选取器中。

    在无缝模式下，您可以从所有屏幕中选择一个屏幕进行共享。Desktop Viewer 更改窗口模式（最大化、还原或最小化）时，屏幕共享将停止。

• 自 Citrix Workspace 应用程序的 2112 版起：

  注意：

  以下功能仅在 Microsoft Teams 推出功能更新后可用。Microsoft 推出此更新时，您可以查看 CTX253754 以获取文档更新和公告。

  • 在 Microsoft Teams 中请求控制权

    在本版本中，参与者正在共享屏幕时，您可以在 Microsoft Teams 通话期间请求控制权。获得控制权后，您可以对共享屏幕进行选择、编辑或其他修改。

    要控制共享屏幕的时间，请单击 Microsoft Teams 屏幕顶部的请求控制权。共享屏幕的会议参与者可以允许或拒绝您的请求。

    获得控制权后，您可以对共享屏幕进行选择、编辑和其他修改。完成后，单击释放控制权。

    限制：

    • Linux 客户端上的用户无法将控制权授予其他用户。换言之，在 Linux 客户端上的用户开始共享内容后，共享工具栏中不存在授予控制权选项。这属于 Microsoft 的限制。
    • 在优化的用户与端点上运行的本机 Microsoft Teams 桌面客户端上的用户之间的点对点通话期间，请求控制权选项不可用。解决方法：用户可以加入会议以获取请求控制权选项。

  • 支持动态 e911

    在本版本中，Citrix Workspace 应用程序支持动态紧急呼叫。在 Microsoft 通话套餐、接线员连接和直接路由中使用时，它提供了以下功能：

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

    提供通知的依据是端点上运行的 Citrix Workspace 应用程序的当前位置，而非 VDA 上运行的 Microsoft Teams 客户端。 Ray Baum 法律要求将 911 呼叫者的可调度位置传送到相应的公共安全应答点 (PSAP)。自适用于 Linux 的 Citrix Workspace 应用程序 2112 起，使用 HDX 的 Microsoft Teams 优化遵从 Ray Baum 的法律。要支持此功能，瘦客户端的操作系统发行版中必须包含 LLDP 库。

• 自 Citrix Workspace 应用程序的 2203 版起：

  Microsoft Teams 的多窗口聊天和会议

  在本版本中，在 Citrix Virtual Apps and Desktops 2112 或更高版本中通过 HDX 进行优化时，您可以在 Microsoft Teams 中使用多个窗口进行聊天和会议。可以通过各种方式弹出对话或会议。有关弹出窗口功能的详细信息，请参阅 Microsoft Teams Pop-Out Windows for Chats and Meetings（Microsoft Teams 用于聊天和会议的弹出窗口）。

  如果您正在运行较旧版本的 Citrix Workspace 应用程序或 Virtual Delivery Agent (VDA)，请谨记，Microsoft 将来会弃用单窗口代码。但是，在此功能正式发布后，您至少有九个月的时间升级到支持多个窗口（2203 及更高版本）的 VDA 或 Citrix Workspace 应用程序版本。

  注意：

  此功能仅在 Microsoft Teams 推出将来的更新后可用。Microsoft 推出此更新时，您可以查看 CTX253754 以获取文档更新和公告。

• 自 Citrix Workspace 应用程序的 2207 版起：

  • 应用程序共享已启用：自适用于 Linux 的 Citrix Workspace 应用程序 2209 和 Citrix Virtual Apps and Desktops 2109 起，您可以使用 Microsoft Teams 中的屏幕共享功能共享应用程序。
  • 高 DPI 支持的增强功能： 启用了高 DPI 功能，并且您使用的是 4K 显示器时，Microsoft Teams 视频叠加层位于所需的位置，并且大小合适。无论您的显示设置如何（例如，单显示器排列或多显示器排列），叠加层始终正确显示，不会放大或出现在不想要的位置。要启用此增强功能，请确保将 wfclient.ini 配置文件中的 DPIMatchingEnabled 参数设置为 True。有关详细信息，请参阅支持 DPI 匹配。
  • WebRTC SDK 升级： 用于优化的 Microsoft Teams 的 WebRTC SDK 版本已升级到版本 M98。

• 自 Citrix Workspace 应用程序的 2305 版起：

  • 增强了睡眠模式以优化 Microsoft Teams 通话

    以前，当您参与优化的 Microsoft Teams 会议时，如果没有鼠标或键盘交互，Citrix Workspace 应用程序或经过优化的 Microsoft Teams 屏幕可能会进入睡眠模式。

    自 2305 版本起，即使在优化的 Microsoft Teams 会议期间没有鼠标或键盘交互，Citrix Workspace 应用程序或经过优化的 Microsoft Teams 屏幕也不会进入睡眠模式。

  • 改善了优化的 Microsoft Teams 视频会议通话体验

    自 2305 版本起，默认情况下，对优化的 Microsoft Teams 视频会议呼叫启用联播支持。有了这种支持，通过调整到适当的分辨率以便为所有呼叫者提供最佳通话体验，可以改善跨不同端点的视频会议通话的质量和体验。

    通过这种改进的体验，每个用户都可以提供分辨率不同（例如 720p、360p 等）的多个视频流，具体取决于多种因素，包括端点功能、网络条件等。然后，接收端点会请求其能够处理的最大质量分辨率，从而为所有用户提供最佳视频体验。

• 自 Citrix Workspace 应用程序的 2307 版起：

   **Background blurring and replacement for Citrix Optimized Microsoft Teams**
  
   **Prerequisite:**
  
   Ensure that you have installed the `wget`.
  
   Starting with version 2307 for Citrix Workspace app, Citrix Optimized Microsoft Teams in Citrix Workspace app for Linux now supports background blurring and background replacement. You can use this feature by selecting **More** > **Apply Background Effects** when you are in a meeting or in a P2P call.
  
   For more information, see [Background blurring and background effects](/zh-cn/citrix-virtual-apps-desktops/multimedia/opt-ms-teams#background-blurring-and-background-effects).
  

• 自 Citrix Workspace 应用程序的 2308 版起：

  • 支持备用铃声

    可以使用“辅助铃声”功能选择要在优化的 Microsoft Teams 中接收来电通知的辅助设备。例如，假设您已将扬声器设置为“辅助铃声”，并且您的端点已连接到耳机。在这种情况下，即使您的耳机是音频通话本身的主要外围设备，Microsoft Teams 也会将来电信号发送到扬声器。在以下情况下，您无法设置备用铃声：

    • 当您未连接到多个音频设备时
    • 外围设备不可用时（例如，蓝牙耳机）

  • 添加了对在经过优化的 Microsoft Teams 中播放短音的支持

    之前，会反复播放哔哔声或通知等短音。例如，重复播放访客加入 Microsoft Teams 会议时播放的声音。唯一的解决方法是退出并重新启动 Microsoft Teams。此问题导致最终用户体验不佳。

    自 2308 版本起，Citrix Workspace 应用程序支持根据需要播放短音。此支持还启用了辅助铃声功能。

    必备条件：

    更新到最新版本的 Microsoft Teams。