Linux Virtual Delivery Agent

音频功能

自适应音频

借助自适应音频,您无需在 VDA 上手动配置音频质量策略。自适应音频可优化您的环境设置并替换过时的音频压缩格式,以提供卓越的用户体验。

自适应音频默认启用。它支持以下 Citrix Workspace™ 应用程序客户端:

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

当您使用的客户端不在列表中时,自适应音频将回退到旧版音频。

音频服务注意事项

The Linux VDA supports PipeWire in Debian 12.x RHEL 9.x/10, Rocky Linux 9.x/10, and Ubuntu 24.04, where it is the default audio service. For the other distributions, continue using PulseAudio.

PulseAudio

  • Use PulseAudio 13.99 or later on RHEL 8.x and Rocky Linux 8.x.

PipeWire

Linux VDA 对 PipeWire 的支持目前仅限于以下特定的操作系统版本:Debian 12.x、RHEL 9.x/10、Rocky Linux 9.x/10 和 Ubuntu 24.04。在使用此功能时,请务必考虑以下几点:

  • 如果您在 Debian 12.x、RHEL 9.x/10 或 Rocky Linux 9.x/10 这些特定的操作系统环境中安装了 Linux VDA 2407 或其后续版本,那么您将自动使用 PipeWire 功能。

  • 如果您在 Ubuntu 24.04 上安装了 Linux VDA 2411 或更高版本,则您正在使用 PipeWire。

  • 如果您在 RHEL 9.x/10 或 Rocky Linux 9.x/10 上安装了低于 2407 版本的 Linux VDA,则您正在使用 PulseAudio。要继续使用 PulseAudio,请勿执行任何操作。要切换到 PipeWire,请完成以下步骤:

    1. Replace the PulseAudio package with pipewire-pulseaudio:

      dnf swap --allowerasing pulseaudio pipewire-pulseaudio
      <!--NeedCopy-->
      
    2. 全局启用 PipeWire 相关服务:

      systemctl --global --now enable pipewire pipewire-pulse pipewire-pulse.socket wireplumber
      <!--NeedCopy-->
      
    3. Restart the Linux VDA.

  • 如果您的 Linux 计算机的系统语言不是英语且音频服务是 PipeWire,请按照以下步骤确保音频功能正常运行:

    1. Open the file located at: /etc/xdg/autostart/ctxaudio.desktop

    2. Locate the following line: Exec=/opt/Citrix/VDA/bin/ctxaudio

    3. Replace it with: Exec=env LC_ALL=C /opt/Citrix/VDA/bin/ctxaudio

    此更改强制 ctxaudio 使用 C 区域设置,从而确保在非英语环境中与 PipeWire 兼容。

音频的容错模式

容错模式支持音频。当用户通过具有高延迟和数据包丢失的网络连接时,此功能可提高实时流的用户体验,并改善通过 EDT 传输的音频质量。

有关容错模式和 EDT 的更多信息,请参阅 Citrix Virtual Apps and Desktops 文档中的其他信息

启用音频功能的丢失容忍模式

音频的容错模式默认处于启用状态。如果已禁用,请完成以下步骤以重新启用它:

  1. 通过设置 HDX adaptive transport 策略启用自适应传输。自适应传输默认启用。
  2. 通过设置 Adaptive audio 策略启用自适应音频。自适应音频默认启用。
  3. 通过设置 音频容错模式 策略,启用容错模式(EDT 不可靠传输)。
  4. 对于直接连接,需要 在 VDA 上启用 DTLS
  5. 对于远程连接,EDT 容错模式也必须在 思杰网关服务NetScaler 网关 上受支持。

客户端要求和设置

要使用音频容错模式,请确保您的 Citrix Workspace 应用程序支持并已配置为启用此功能;否则,音频将默认为 EDT 可靠传输。

以下是支持容错模式的最低 Citrix Workspace 应用程序版本:

  • 适用于 Windows 的思杰工作区应用程序最低版本 2309
  • 适用于 Linux 的思杰工作区应用程序最低版本 2311
  • 适用于 Mac 的 Citrix Workspace 应用程序最低版本 2311

音频诊断命令行工具

VDA 上的音频诊断命令行工具可用于查询与音频策略、配置和数据传输相关的会话数据。

用法

打开命令提示符并从 /opt/Citrix/VDA/bin 文件夹运行 ctxaudiosession

运行该工具将显示当前用户所有活动的 ICA® 会话的音频信息和设备重定向状态。

输出

该工具输出各种配置设置,有助于诊断会话中的音频相关问题。

部分 详细信息
警告 设备状态、传输类型、音频编解码器等的音频服务警告消息。
当前状态信息 应用于当前会话的音频状态、版本、编解码器、传输等。
策略设置 应用于当前会话的音频策略。
本地设置 存储在注册表或本地设置中的音频相关配置。
功能特性 CWA 和 VDA 之间的音频功能结果。
音频设备 设备名称、其角色以及它们在会话中的运行状态。

EDT 容错模式的音频质量增强器

从 2507 版本开始,音频质量增强器默认启用,用于通过 EDT 音频容错模式 的自适应音频。

音频质量增强器可在短暂的网络中断期间保持清晰的音频。此功能可适应网络条件,以确保在播放和录制期间提供一致的音频性能。

注意:

自适应音频 必须启用才能使此功能正常工作。

可靠传输的音频质量增强器(预览版)

从技术预览版 2511 开始,音频质量增强器也适用于通过可靠传输(即 TCP 和 EDT-Reliable)的连接。在网络状况不佳的情况下,音频播放和录制都将获得更流畅的体验,并减少延迟。

启用此功能,请完成以下步骤:

  1. 在 Linux VDA 上启用此功能。

    在终端中运行以下命令:

    sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Audio" -v "fAlwaysUseSpeexJitterBuffer" -t REG_DWORD -d 0 –force
    <!--NeedCopy-->
    
  2. 在适用于 Linux 的 Citrix Workspace 应用程序上启用此功能。

    1. 导航到 <ICAROOT>/config 文件夹并打开 module.ini 文件。

    2. 转到 [ClientAudio] 部分并添加以下条目:

    AlwaysUseSpeexJitterBuffer=FALSE

禁用此功能,请完成以下步骤:

  1. 在 Linux VDA 上禁用此功能。

    在终端中运行以下命令:

    sudo /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\System\CurrentControlSet\Control\Citrix\VirtualChannels\Audio" -v "fAlwaysUseSpeexJitterBuffer" -t REG_DWORD -d 1

  2. 在适用于 Linux 的 Citrix Workspace 应用程序上禁用此功能。

    1. 导航到 <ICAROOT>/config 文件夹并打开 module.ini 文件。

    2. 转到 [ClientAudio] 部分并添加以下条目:

    AlwaysUseSpeexJitterBuffer=TRUE

注意:

必须启用自适应音频,此功能才能正常工作。

此功能在技术预览版中默认禁用(通过可靠传输)。

必须在 VDA 和 CWA 上启用此功能。

此功能支持适用于 Linux 的 Citrix Workspace 应用程序 2511 及更高版本,以及适用于 Mac 的 Citrix Workspace 应用程序 2508 及更高版本。

提供对多个音频设备的支持

概述

从版本 2311 开始,Linux VDA 引入了音频重定向功能。此功能允许将安装了 Citrix Workspace 应用程序的客户端计算机上的多个音频设备重定向到远程 Linux VDA 会话。

启用此功能后:

  • 客户端计算机上的所有本地音频设备都显示在会话中。音频设备会显示其各自的设备名称,而不是 CitrixAudioSink(音频输出)或 CitrixAudioSource(音频输入)。

  • 当您插入或移除设备时,会话中的音频设备会动态更新。

配置说明

要使用此功能,请在 Linux VDA 上启用它并选择受支持的 Citrix Workspace 应用程序。

在 Linux VDA 上启用此功能

默认情况下,多音频设备支持处于启用状态。要禁用或重新启用此功能,请分别运行以下命令:

sudo /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\\System\\CurrentControlSet\\Control\\Citrix\\VirtualChannels\\Audio" -v "fEnableAudioRedirectionV4" -d "0"
<!--NeedCopy-->
sudo /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\\System\\CurrentControlSet\\Control\\Citrix\\VirtualChannels\\Audio" -v "fEnableAudioRedirectionV4" -d "1"
<!--NeedCopy-->

客户端要求和设置

此功能仅在以下客户端上受支持:

  • 适用于 Windows 的思杰工作区应用程序
  • 适用于 Linux 的思杰工作区应用程序,最低版本 2212
  • 适用于 HTML5 的 思杰工作区应用程序 最低版本 2306
  • 适用于 谷歌浏览器 的 Citrix Workspace 应用程序,最低版本 2306
  • 适用于 Mac 的 Citrix Workspace 应用程序最低版本 2311
  • 安卓版 思杰工作区应用最低版本 2405

Citrix Workspace 应用程序需要正确的设置才能使该功能按预期运行。有关详细信息,请参阅 Citrix Workspace 应用程序 文档。

已知问题

由于 PulseAudio 的 问题,在 Ubuntu 22.04 会话中尝试在音频设备之间切换可能会失败。要解决此问题,请从 VDA 中删除当前会话用户的 PulseAudio 配置,然后重新打开会话。要删除 PulseAudio 配置,请运行 $ rm -r ~/.config/pulse 命令。

对音频音量同步的支持

从版本 2603 开始,Linux VDA 现在支持 VDA 与您的音频设备之间的音频音量同步。您现在可以使用 VDA 音频音量滑块调节音量,并在您的设备上获得相同的音量,反之亦然。此功能默认启用。