Audio Quality Enhancer (AQE)
Enable Audio Quality Enhancer to improve audio performance [Technical Preview]
Starting with the 2503 version, Audio Quality Enhancer (v1) is added for Adaptive Audio.
Audio quality enhancer effectively manages short periods of packet loss and disruptions by intelligently reconstructing audio from previous samples in real-time, thus preventing noticeable degradation in quality. Furthermore, it intelligently and adaptively recovers lost audio packets, if and only when needed. It enables and disables itself adaptively when packet loss increases and decreases for a sustained period. Audio quality enhancer optimizes audio playback and recording quality in both good and poor network conditions.
To enable Audio Quality Enhancer, complete the following steps on the VDA
- Enable Adaptive Audio.
- Enable Loss Tolerant Mode for Audio.
- Enable the feature:
sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\\System\\CurrentControlSet\\Control\\Citrix\\VirtualChannels\\Audio" -v "fEnablePacketLossConcealment" -t BIN -d "1" --force - Enable Audio Quality Enhancer on the client as well, which is required to fully enable the feature. That is, Audio Quality Enhancer needs to be enabled on both the VDA and CWA sides to function end-to-end for audio playback and recording.
To disable Audio Quality Enhancer, complete the following steps on the VDA
- Disable the feature:
sudo /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\\System\\CurrentControlSet\\Control\\Citrix\\VirtualChannels\\Audio" -v "fEnablePacketLossConcealment" -d "0" -
Disable Audio Quality Enhancer on the client as well, which is required to fully disable the feature.
- Restart the session for the changes to take effect.
Audio diagnostic command line tool
The audio diagnostic command line tool on the VDA can be used to query session data related to audio policies, configuration, and data transport.
Usage
-
Open a command prompt and run
ctxaudiosessionfrom the/opt/Citrix/VDA/binfolder.- Running the tool will display all active ICA session(s) audio information and devices redirection status for the current user.
Output
The tool outputs various configuration settings that can help diagnose audio-related issues within a session.
| Section | Description |
|---|---|
| DDC Policy information | Audio policies applied to the current session(s). |
| Local Registry information | Audio related configuration settings stored in the registry. |
| State information | Audio state, version, codecs, transport applied to the current session(s) and device numbers. |
| Devices information | Device names, their roles, and their statuses used in the session. |