Audio
Le mappage audio du client permet aux applications exécutées sur le serveur Citrix Virtual Apps and Desktops ou Citrix DaaS de restituer les sons et d’enregistrer l’audio sur des périphériques audio installés sur la machine utilisateur. Vous pouvez configurer le mappage audio du client à l’aide de règles. Pour de plus amples informations, consultez la documentation de Citrix Virtual Apps and Desktops.
Prise en charge de l’enregistrement audio
À partir de la version 2212, la fonction d’enregistrement audio est activée par défaut. Les appareils compatibles avec l’enregistrement audio apparaissent au démarrage d’une session.
Pour désactiver cette fonctionnalité, définissez la valeur de AllowAudioInput sur False dans le fichier wfclient.ini.
Remarque:
- L’option Mic et webcam de la boîte de dialogue Préférences est désactivée par défaut. Pour plus d’informations sur l’activation du micro et de la webcam, reportez-vous à la section Préférences.
Prise en charge de plusieurs périphériques audio
À partir de la version 2112, l’attribut VdcamVersion4Support dans le fichier module.ini est renommé AudioRedirectionV4. À partir de la version 2212, la valeur par défaut pour AudioRedirectionV4 est définie sur True. Résultat :
- La bibliothèque PulseAudio est utilisée pour accéder aux périphériques audio et des appareils supplémentaires sont pris en charge.
- Plusieurs applications peuvent utiliser les périphériques audio à la fois.
- L’application Citrix Workspace affiche tous les périphériques audio locaux disponibles dans une session. Au lieu de Citrix HDX Audio, les périphériques audio apparaissent désormais avec leurs noms de périphérique respectifs. Vous pouvez sélectionner un périphérique audio dans une application au cours d’une session. Vous pouvez également utiliser le périphérique audio par défaut pendant une session, qui est également le périphérique audio par défaut de la machine cliente. Si nécessaire, vous pouvez modifier le périphérique audio par défaut à partir des paramètres système de l’ordinateur client. Une fois le périphérique audio par défaut de la machine cliente mis à jour, le nouveau périphérique apparaît comme périphérique audio par défaut dans la session.
- Les sessions sont mises à jour de manière dynamique lorsque vous branchez ou supprimez des périphériques audio.
Si vous définissez la valeur de AudioRedirectionV4 sur False :
- La bibliothèque ALSA est utilisée pour accéder aux périphériques audio et un seul appareil est pris en charge.
- Dans une session, il n’y a qu’un seul haut-parleur et un seul microphone portant le nom « Citrix HDX™ Audio », qui correspond au périphérique par défaut côté client.
- Une seule application peut utiliser le périphérique audio Citrix HDX à la fois.
Pour définir AudioRedirectionV4 sur False, procédez comme suit :
- Accédez au dossier
<ICAROOT>/configet ouvrez le fichiermodule.ini. -
Accédez à la section [ClientAudio] et ajoutez l’entrée suivante :
AudioRedirectionV4=False
- Redémarrez la session pour que les modifications prennent effet.
Limitations connues :
-
Par défaut, la valeur de
AudioRedirectionV4est définie sur True. La limitation connue suivante est présente lorsque la valeur deAudioRedirectionV4est définie sur True :- Si vous lancez une session à partir de l’interface de ligne de commande avec des privilèges root, le serveur PulseAudio peut refuser la connexion lorsque vous essayez de vous y connecter. Dans ce cas, les périphériques audio peuvent commencer à utiliser la bibliothèque ALSA qui ne prend en charge que des appareils individuels.
Si vous définissez la valeur
AudioRedirectionV4sur False, les limitations connues suivantes sont présentes :-
Vous ne pouvez pas modifier la sélection de périphériques audio au cours d’une session. La sélection est définie sur l’entrée et la sortie audio par défaut uniquement. Cette limitation est résolue lorsque vous définissez la valeur de
AudioRedirectionV4sur True. -
La redirection de périphérique audio n’est pas prise en charge avec les périphériques audio Bluetooth et HDMI. Cette limitation est résolue lorsque vous définissez la valeur de
AudioRedirectionV4sur True.
Lorsque la valeur de
AudioRedirectionV4est False, le périphérique audio par défaut est généralement le périphérique ALSA par défaut configuré pour votre système. Pour spécifier un périphérique différent, procédez comme suit :-
Sélectionnez et ouvrez un fichier de configuration en fonction des utilisateurs que vous souhaitez voir affectés par vos modifications. Pour plus d’informations sur l’impact des mises à jour de fichiers de configuration particuliers sur différents utilisateurs, veuillez consulter la section paramètres par défaut.
-
Ajoutez l’option suivante, en créant la section si besoin est :
[ClientAudio] AudioDevice=\<device\> <!--NeedCopy-->Dans cette section, l’information sur la machine se trouve dans le fichier de configuration ALSA de votre système d’exploitation.
Remarque:
L’emplacement de cette information peut varier en fonction des systèmes d’exploitation Linux. Pour plus de détails sur l’emplacement de cette information, Citrix vous recommande de consulter la documentation de votre système d’exploitation.
-
Sous Ubuntu 24.04, les périphériques audio HDMI peuvent ne pas être correctement détectés ou supprimés dans le VDA lors du branchement ou du débranchement du périphérique HDMI pendant que la session est active. Ce problème se produit en raison de différences entre PipeWire (le moteur audio par défaut dans Ubuntu 24.04) et son prédécesseur, PulseAudio.
Ce problème affecte les machines qui prennent en charge simultanément la sortie audio HDMI et les haut-parleurs intégrés.
- Lorsqu’un périphérique HDMI est branché avant le lancement de la session : le périphérique est redirigé vers le VDA comme prévu.
- Lorsqu’un périphérique HDMI est branché après le lancement de la session : le périphérique n’est pas correctement redirigé vers le VDA.
- Lorsqu’un périphérique HDMI est débranché après le lancement de la session : le périphérique reste dans le VDA et ne peut pas être utilisé.
- Lorsqu’un périphérique HDMI est débranché, puis reconnecté après le lancement de la session : le périphérique fonctionne comme prévu dans le VDA.
Amélioration de la qualité audio
Auparavant, la valeur maximale de mise en mémoire tampon de sortie pour une lecture audio fluide était de 200 ms dans l’application Citrix Workspace. En raison de cette valeur définie, une latence de 200 ms a été ajoutée dans le scénario de lecture. Cette valeur maximale de mise en mémoire tampon de sortie avait également un impact sur les applications audio interactives.
Avec cette amélioration, la valeur maximale de mise en mémoire tampon de sortie est réduite à 50 ms dans l’application Citrix Workspace. En conséquence, l’expérience utilisateur sur l’application audio interactive est améliorée. De plus, la durée des boucles (RTT) est réduite de 150 ms.
À partir de la version 2207, vous pouvez sélectionner le seuil de lecture et le pré-tampon audio pulsé appropriés pour améliorer la qualité audio. Pour cette amélioration, les paramètres suivants sont ajoutés dans la section [ClientAudio] du fichier module.ini :
-
PlaybackDelayThreshV4– Pour spécifier le niveau initial de mise en mémoire tampon de sortie en millisecondes. L’application Citrix Workspace essaie de maintenir ce niveau de mise en mémoire tampon pendant toute la durée d’une session. La valeur par défaut dePlaybackDelayThreshV4est de 50 ms. Ce paramètre n’est valide que lorsqueAudioRedirectionV4est défini sur True. -
AudioTempLatencyBoostV4– Lorsque le débit audio subit un pic soudain ou n’est pas suffisant pour un réseau instable, cette valeur augmente la valeur de mise en mémoire tampon de sortie. Cette augmentation de la valeur de mise en mémoire tampon de sortie fournit un son fluide. Cependant, l’audio peut être légèrement retardé. La valeur par défaut deAudioTempLatencyBoostV4est définie sur 100 ms. Ce paramètre n’est valide que lorsqueAudioRedirectionV4** etAudioLatencyControlEnabledsont définis sur **True. Par défaut, la valeur deAudioLatencyControlEnabledest définie sur False.
Annulation de l’écho
L’application Citrix Workspace™ prend désormais en charge la fonction d’annulation de l’écho conçue pour améliorer l’expérience utilisateur en temps réel. La fonction d’annulation de l’écho prend en charge l’audio de qualité moyenne, l’audio de faible qualité et l’audio adaptatif. Citrix recommande d’utiliser l’audio adaptatif pour de meilleures performances.
Remarque:
À partir de la version 2411, la fonctionnalité d’annulation de l’écho est activée par défaut.
Dans les cas d’utilisation en temps réel, il est recommandé d’activer l’annulation de l’écho si le haut-parleur est utilisé à la place du casque.
Pour désactiver cette fonctionnalité, procédez comme suit :
- Accédez au dossier
<ICAROOT>/configet ouvrez le fichiermodule.ini. -
Accédez à la section [ClientAudio] et mettez à jour la valeur du paramètre
EnableEchoCancellationcomme suit :EnableEchoCancellation=False
Limitation:
La fonction d’annulation de l’écho est désactivée pour un son de haute qualité. Pour de plus amples informations sur le son de haute qualité, consultez la documentation de Citrix Virtual Apps and Desktops.
Ajout d’un mécanisme de tampon de gigue côté client
À partir de la version 2305, l’application Citrix Workspace garantit un son net même lorsque la latence du réseau fluctue. Cette fonctionnalité est activée par défaut.
Pour désactiver cette fonctionnalité, accédez au fichier de configuration /opt/Citrix/ICAClient/config/module.ini et définissez JitterBufferEnabled=FALSE.
Audio adaptatif
Depuis la version 2109, l’application Citrix Workspace prend en charge l’audio adaptatif. Avec l’audio adaptatif, vous n’avez pas besoin de configurer manuellement les stratégies de qualité audio sur le VDA. L’audio adaptatif optimise les paramètres de votre environnement et remplace les formats de compression audio obsolètes pour offrir une excellente expérience utilisateur. L’audio adaptatif est activé par défaut. Pour plus d’informations, consultez la section Audio adaptatif.
À partir de la version 2112, l’audio adaptatif fonctionne lors de l’utilisation de la diffusion audio UDP (User Datagram Protocol).
Limitation connue :
- L’audio adaptatif nécessite des processeurs prenant en charge Streaming SIMD Extensions (SSE) 4.x. L’application Citrix Workspace peut se fermer lorsque l’audio adaptatif est utilisé avec le processeur CPU qui ne prend pas en charge SSE 4.x.
Activation de l’audio UDP
L’audio UDP peut améliorer la qualité des appels téléphoniques effectués sur Internet. Il utilise UDP au lieu de TCP.
À partir de la version 2112, l’audio adaptatif fonctionne lors de l’utilisation de la diffusion audio UDP. À partir de cette version, l’application Citrix Workspace prend aussi en charge le protocole DTLS (Datagram Transport Layer Security) pour l’audio UDP. Par conséquent, vous pouvez accéder à l’audio UDP via Citrix Gateway. Cette fonctionnalité est désactivée par défaut.
À partir de la version 2202, l’application Citrix Workspace prend en charge l’audio UDP via Citrix Gateway.
Pour activer l’audio UDP :
- Accédez au dossier
<ICAROOT>/configet ouvrez le fichier module.ini. - Définissez les options suivantes dans la section [ClientAudio] du fichier module.ini :
- Définissez
EnableUDPAudiosur True. Par défaut, cette option est définie sur False, ce qui désactive l’audio UDP. - Spécifiez les numéros de port minimum et maximum pour le trafic audio UDP à l’aide de
UDPAudioPortLowetUDPAudioPortHigh. Par défaut, les ports 16500 à 16509 sont utilisés.
- Définissez
- Définissez les stratégies suivantes sur le Domain Delivery Controller™ (DDC) :
- Définissez Audio sur UDP sur Autorisé.
- Définissez Transport en temps réel audio via UDP sur Activé.
-
Par défaut, l’audio adaptatif est activé sur le VDA et prend en charge l’audio UDP. Si vous avez désactivé l’audio adaptatif, définissez la stratégie suivante sur le Domain Delivery Controller (DDC) :
- Définissez Qualité audio sur Moyenne.
Par conséquent, le son obtenu est de qualité moyenne et peut prendre en charge l’audio UDP.
Pour activer l’audio UDP via Citrix Gateway :
- Accédez au dossier
<ICAROOT>/configet ouvrez le fichiermodule.ini. -
Accédez à la section [WFClient] et définissez l’entrée suivante :
EnableUDPThroughGateway=True
-
Accédez à la section [ClientAudio] et définissez l’entrée suivante :
EnableUDPAudio=True
- Définissez les stratégies suivantes sur le Domain Delivery Controller (DDC) :
- Définissez Audio sur UDP sur Autorisé.
- Définissez Transport en temps réel audio via UDP sur Activé.
-
Par défaut, l’audio adaptatif est activé sur le VDA et prend en charge l’audio UDP. Si vous avez désactivé l’audio adaptatif, définissez la stratégie suivante sur le Domain Delivery Controller (DDC) :
- Définissez Qualité audio sur Moyenne.
Mode de tolérance de pertes pour l’audio
À partir de la version 2402, l’application Citrix Workspace prend en charge le mode de tolérance de pertes (compression avec perte EDT) pour la redirection audio. Cette fonctionnalité améliore l’expérience utilisateur pour le streaming en temps réel lorsque les utilisateurs se connectent via des réseaux à latence élevée et à perte de paquets. Cette fonctionnalité est activée par défaut.
Vous devez utiliser la version 2311 ou ultérieure du VDA. Pour en savoir plus, consultez la section Prise en charge de l’audio via le mode de tolérance de pertes (Technical Preview) dans la documentation Citrix Virtual Apps and Desktops.
Pour désactiver cette fonctionnalité sur l’application Citrix Workspace pour Linux, définissez la valeur de EdtUnreliableAllowed sur FALSE dans le fichier de configuration $ICAROOT/config/module.ini, puis redémarrez la session pour appliquer les modifications.
Prise en charge de la synchronisation du volume audio
À partir de la version 2402, l’application Citrix Workspace pour Linux prend en charge la synchronisation du volume audio entre le VDA et vos périphériques audio. Vous pouvez désormais régler le volume à l’aide du curseur de volume audio du VDA pour avoir le même volume que sur votre appareil et vice versa. Cette fonctionnalité est activée par défaut.
Vous devez utiliser la version 2308 du VDA ou une version ultérieure. Pour en savoir plus, consultez la section Synchronisation des volumes audio dans la documentation Citrix Virtual Apps and Desktops.
Pour désactiver cette fonctionnalité sur l’application Citrix Workspace pour Linux, définissez la valeur de EnableVolumeSync sur FALSE dans le fichier de configuration $ICAROOT/config/module.ini, puis redémarrez la session pour appliquer les modifications.
Activer la suppression du bruit
À partir de la version 2411, l’application Citrix Workspace offre désormais une redirection audio améliorée avec une suppression du bruit améliorée. Cette fonctionnalité réduit le bruit de fond, garantissant une parole plus claire et plus précise, améliorant ainsi l’expérience de communication globale.
Remarque:
Cette fonction est désactivée par défaut.
Pour activer cette fonctionnalité, procédez comme suit :
-
Accédez à Préférences > Audio > Suppression du bruit.

- Sélectionnez l’une des options :
- Aucun : il s’agit du paramètre par défaut. Il n’utilise aucune ressource ni n’affecte leur consommation.
- Faible : la réduction du bruit est minimale et la consommation des ressources est la plus petite possible.
- Élevé : la réduction du bruit est appliquée à l’intensité maximale avec les meilleures performances et la consommation des ressources est plus élevée que le paramètre Faible.
- Cliquez sur OK. La configuration sélectionnée est appliquée.
Remarque:
- Les modifications s’appliquent uniquement à la session en cours et sont réinitialisées une fois la session terminée.
- Cette fonctionnalité est prise en charge uniquement sur les distributions Linux x64 et ARM64. Sous Linux x64, les options Faible et Élevé sont disponibles, tandis que sous Linux ARM64, seule l’option Faible est disponible en raison des limitations du processeur sur les appareils ARM.
Activation de l’optimiseur de qualité audio pour améliorer les performances audio
À partir de la version 2503, l’optimiseur de la qualité audio (v2) est ajouté pour l’audio adaptatif.
L’optimiseur de la qualité audio gère efficacement les courtes périodes de perte de paquets et de perturbations en reconstruisant intelligemment l’audio à partir d’échantillons précédents en temps réel, évitant ainsi une dégradation notable de la qualité. De plus, il récupère de manière intelligente et adaptative les paquets audio perdus, seulement lorsque cela est nécessaire. Il s’active et se désactive de manière adaptative lorsque la perte de paquets augmente et diminue pendant une période prolongée. L’optimiseur de la qualité audio optimise la qualité de lecture et d’enregistrement audio dans des conditions de réseau correctes et médiocres.
Activation de l’optimiseur de la qualité audio
Pour activer l’optimiseur de la qualité audio, procédez comme suit sur le client :
- Activez l’option Audio adaptatif. Pour plus d’informations, consultez Audio adaptatif.
- Activez l’option Mode tolérance de pertes pour l’audio. Pour plus d’informations, consultez Mode tolérance de pertes pour l’audio.
-
Modifiez le fichier
module.ini:- Ouvrez le fichier
/opt/Citrix/ICAClient/config/module.ini. - Définissez les options de configuration suivantes :
PacketLossConcealmentEnabled=TRUE EnableNetStat=TRUE <!--NeedCopy--> - Ouvrez le fichier
- Activez l’optimiseur de la qualité audio sur le VDA. Activez cette fonctionnalité sur VDA (Virtual Delivery Agent) et sur l’application Citrix Workspace pour une fonctionnalité de bout en bout, couvrant à la fois la lecture et l’enregistrement audio.
Désactivation de l’optimiseur de la qualité audio
Pour désactiver l’optimiseur de la qualité audio, procédez comme suit sur le client :
-
Désactivez la fonctionnalité :
- Modifiez le fichier
module.inisitué sous/opt/Citrix/ICAClient/config/module.ini. - Définissez les options de configuration suivantes :
PacketLossConcealmentEnabled=FALSE EnableNetStat=FALSE <!--NeedCopy--> - Modifiez le fichier
-
Désactivez l’optimiseur de la qualité audio sur le VDA. Assurez-vous que cette fonctionnalité est également désactivée sur le VDA pour la désactiver complètement des deux côtés.
Sélection du périphérique audio par défaut
À partir de la version 2503, vous pouvez désormais sélectionner vos périphériques audio préférés directement dans la barre d’outils de Desktop Viewer. Cette fonctionnalité offre une expérience audio plus personnalisée avec les fonctionnalités principales suivantes lorsqu’elle est connectée à un bureau virtuel.
- Fractionnement des périphériques : vous pouvez attribuer différents périphériques audio à différents VDA. Par exemple, vous pouvez avoir deux moniteurs avec deux VDA différents, chacun utilisant un périphérique audio distinct (un haut-parleur et un casque).
- Sélection de périphérique spécifique : le périphérique audio exact peut être sélectionné pour chaque VDA actif à partir de la section Préférences.
- Persistance de la configuration : la configuration sélectionnée est conservée pour la session suivante, garantissant une expérience transparente.
Remarque:
Si vous ne souhaitez pas que la configuration sélectionnée soit conservée pour la prochaine session, vous pouvez ajuster les paramètres en conséquence dans la section Préférences.
Cette fonctionnalité n’est pas applicable à un environnement de bureaux regroupés, car chaque fois qu’un utilisateur se connecte, il peut être connecté à un VDA différent.
Pour sélectionner le périphérique audio spécifique, procédez comme suit :
-
Accédez à la section Préférences dans la barre d’outils de Desktop Viewer.

- Sélectionnez le périphérique souhaité dans la liste déroulante Haut-parleur par défaut.
- Sélectionnez le périphérique souhaité dans la liste déroulante Microphone par défaut.
- Cliquez sur OK pour enregistrer les modifications.
Dans cet article
- Prise en charge de l’enregistrement audio
- Prise en charge de plusieurs périphériques audio
- Amélioration de la qualité audio
- Annulation de l’écho
- Ajout d’un mécanisme de tampon de gigue côté client
- Audio adaptatif
- Activation de l’audio UDP
- Activer la suppression du bruit
- Activation de l’optimiseur de qualité audio pour améliorer les performances audio
- Sélection du périphérique audio par défaut