Aperçu de l'optimisation des médias CITRIX
L'optimisation audio est réalisée par l'intégration du Citrix Unified Communication SDK (UC SDK).
Applicable aux utilisations suivantes du Rainbow :
- Application de bureau Rainbow utilisée en mode téléphonie.
- Ou tout profil où :
- Utiliser la vidéo IP dans les conversations individuelles ou multipartites est défini sur . Non autorisé
- Utiliser le partage d'écran et d'application dans les conversations individuelles ou multipartites est défini sur Non autorisé
- La téléphonie Business pour Microsoft Teams.
Compatibilité CITRIX
Les versions minimales des composants Citrix pour utiliser l'optimisation Citrix avec Rainbow sont :
- 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.149.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 possibilité d'activer l'optimisation. Aucune configuration n'est nécessaire du côté de Rainbow, sauf pour l'administrateur de l'entreprise qui doit gérer le profil des utilisateurs afin d'interdire les appels vidéo et le partage d'écran.
- La capacité est pilotée par la configuration appropriée par l'IS/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
Key Path : HKLM\Software\WOW6432Node\Citrix\WebSocketService
Key Name : ProcessWhitelist
Type de clé : MULTISZ
Redémarrez ensuite le processus CtxHdxWebSocketService.
Étape 2 : Activez la redirection sur la VDA dans le registre de l'utilisateur actuel :
Key Path : HKCU\Software\Citrix\HDXMediaStream
Key Name : MSTeamsRedirectionSupport
Type de clé : 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.
Configuration du profil de l'utilisateur
L'optimisation Citrix est parfaitement adaptée à une utilisation de Rainbow avec un profil Téléphonie uniquement mais n'importe quel profil peut être utilisé dès lors que les appels vidéo et le partage d'écran ne sont ne sont pas autorisés.
Vérification de la configuration
Vérification de l'état
- Dans l'application 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. - Le message vocal dans les messageries instantanées ne fonctionne pas encore (fonction de collaboration)
Résolution des problèmes
Quelques rappels sur la récupération des logs :
- La façon la 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 s authentifiants du client Rainbow, consultez l'article dédié.
- En plus des logs du client Rainbow, pour le client web, le log du navigateur 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 journaux des clients Rainbow concernés et les journaux de la passerelle WebRTC en cas d'appels VoIP (mode ordinateur).