Linux Virtual Delivery Agent

Audio features

Adaptive audio

Adaptive audio is enabled by default. It supports the following Citrix Workspace app clients:

  • Citrix Workspace app for Windows – 2109 and later versions
  • Citrix Workspace app for Linux – 2109 and later versions
  • Citrix Workspace app for Mac – 2109 and later versions

Adaptive audio falls back to legacy audio when you use a client not on the list.

With adaptive audio, you don’t need to manually configure the audio quality policies on the VDA. Adaptive audio dynamically adjusts audio sampling bitrates based on network conditions to provide a premium audio experience.

The following table shows a comparison between adaptive audio and legacy audio:

Adaptive audio Legacy audio
Max. audio sample rate: 48 kHz Max. audio sample rate: 8 kHz
Stereo channel Mono channel

Tip:

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

Support for multiple audio devices (preview)

Overview

Starting with Version 2311, the Linux VDA introduces an audio redirection feature. The feature allows multiple audio devices on the client machine where Citrix Workspace app is installed to be redirected to the remote Linux VDA session.

With the feature enabled:

  • All local audio devices on the client machine are displayed in a session. Instead of CitrixAudioSink (audio output) or CitrixAudioSource (audio input), the audio devices appear with their respective device names. You can select an audio device in an app in a session or use the default audio device during a session which is also the default audio device of the client machine. If necessary, you can change the default audio device from the system settings of the client machine. After the default audio device of the client machine is updated, the new device appears as the default audio device in the session.

  • Audio devices within sessions update dynamically when you plug in or remove one.

Configuration

To use the feature, enable it on the Linux VDA and choose a supported Citrix Workspace app.

Enable the feature on the Linux VDA

The audio redirection feature that allows multiple audio device support is disabled by default. To enable it, run the following command on the Linux VDA:

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

To disable or re-enable the feature, run the following commands, respectively:

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-->

Client requirements and settings

The feature is supported only for the following clients:

  • Citrix Workspace app for Windows
  • Citrix Workspace app for Linux minimum version 2212
  • Citrix Workspace app for HTML5 minimum version 2306
  • Citrix Workspace app for Chrome minimum version 2306
  • Citrix Workspace app for Mac minimum version 2311

Proper settings are required on Citrix Workspace app to make the feature function as expected. For more information, see the Citrix Workspace app documentation.

Known issues

Due to the issue with PulseAudio, attempts to switch between audio devices might fail in a Ubuntu 22.04 session. To address the issue, remove the PulseAudio configuration for the current session user from the VDA and then reopen the session. To remove the PulseAudio configuration, run the $ rm -r ~/.config/pulse command.

Audio features