Aperçu de l'optimisation des médias CITRIX
L'optimisation audio et vidéo est réalisée par l'intégration du Citrix Unified Communication SDK (UC SDK).
Compatibilité CITRIX
Les versions minimales des composants Citrix pour utiliser l'optimisation Citrix avec Rainbow sont les suivantes :
- VDA : 1912 LTSR ou 2206
- Citrix Workspace app (Windows) : 2205
- Citrix Workspace app (Mac) : 2206.1
- Citrix Workspace app (Linux) : 2205
Configuration
- Exécutez l'application Rainbow Desktop v2.156.x ou supérieure, avec le Citrix UC SDK intégré par défaut.
- L'application Rainbow Desktop détecte automatiquement l'environnement Citrix et la capacité d'activer l'optimisation, aucune configuration n'est nécessaire du côté de Rainbow.
- La capacité est pilotée par la configuration appropriée par le SI/IT sur le VDA, en positionnant deux clés de registre.
Configuration des clés de registre sur le VDA Citrix
Étape 1 : Mettez en liste blanche l'application Rainbow Desktop dans le registre Local Machine :
Mettez Rainbow.exe en liste blanche dans
Chemin d'accès : HKLM\Software\WOW6432Node\Citrix\WebSocketService
Nom de la clé : ProcessWhitelist
Key Type : MULTISZ
Redémarrez ensuite le processus CtxHdxWebSocketService.
Étape 2 : Activez la redirection sur la VDA dans le registre de l'utilisateur actuel :
Chemin de clé : HKCU\Software\Citrix\HDXMediaStream
Nom de la clé : MSTeamsRedirSupport
Key Type : DWORD
Valeur de la clé :
- 0 indique que l'environnement virtuel Citrix est actif, mais que la redirection WebRTC n'est pas prise en charge.
- 1 indique que l'environnement virtuel Citrix est actif et que la redirection WebRTC est prise en charge.
Cette clé est surveillée par l'app de bureau Rainbow pour activer l'optimisation.
Vérification de la configuration
Vérification de l'état
- Dans l'app Rainbow desktop, vous pouvez voir si la redirection Citrix est utilisée.
- Un autre point qui peut être vérifié est que le processus HdxRtcEngine.exe est en cours d'exécution pendant les appels audio sur les Endpoints
Restrictions connues
- Dans les paramètres audio, il n'y a pas d'indicateur visuel du niveau audio du microphone.
Il s'agit d'une limitation du Citrix UC SDK. - Lesmessages vocaux dans les messageries instantanées ne fonctionnent pas encore.
- Push-to-talk dans le chat : Désactivé - le bouton n'apparaît pas.
- Arrière-plans virtuels : Non pris en charge - aucune option d'activation ou de modification.
- Partage d'écran : Optimisé pour un seul écran - les configurations multi-écrans peuvent ne pas fonctionner de manière fiable (nous vous invitons à les tester).
- Partage au niveau de l'application : Non pris en charge.
- Webinaires : Non disponible.
- Décrochage : Le bouton de décrochage n'est pas disponible - le paramètre de décrochage automatique est ignoré.
- Info-bulles : Elles peuvent apparaître derrière les éléments vidéo.
Résolution des problèmes
Quelques rappels concernant l'authentification des logs :
- Le moyen le plus simple pour l'utilisateur final de récupérer les Logs du client Rainbow est d'utiliser la fonction Signaler un problème.
- Pour les logs des clients Rainbow, consultez l'article dédié.
- En plus des Logs du client Rainbow, pour le client web le Browser log peut être très utile.
- Pour les Logs de la passerelle WebRTC (mpcollect --all) et les traces SIP (mpndump on), consultez l'article dédié.
Rapports sur un dysfonctionnement/bogue :
Si le problème est reproduit, fournissez une description étape par étape pour reproduire le problème. N'hésitez pas à ajouter des captures d'écran ou des vidéos pour nous aider à comprendre le problème.
Dans le cas de problèmes concernant les appels, n'oubliez pas de nous donner tous les détails de la configuration de l'utilisateur :
- Type/version du PBX
- Appareil (Deskphone, REX, Anydevice)
- Version de la passerelle WebRTC
- Paramètres de routage (mode ordinateur/téléphone de bureau)
- Date et heure exactes de l'appel.
Toutes les informations sur l'appelant et l'appelé.
- email du compte Rainbow
- numéro de l'appelant / numéro de l'appelé
- le type de destination, interne/externe, ligne mobile/terrestre.
En plus de ces informations, veuillez fournir tous les logs clients Rainbow concernés et les logs de la passerelle WebRTC en cas d'appels VoIP (mode ordinateur).