Optimisation pour Microsoft Teams

Remarque : cette fonctionnalité dépend d’une future version de Microsoft Teams. Nous mettrons à jour cette description au fur et à mesure que les informations sur la version et la date de sortie seront disponibles.

Citrix offre une optimisation pour Microsoft Teams avec l’application Citrix Workspace et Citrix Virtual Apps and Desktops. Par défaut, nous regroupons tous les composants nécessaires dans l’application Citrix Workspace et le Virtual Delivery Agent (VDA).

Notre optimisation pour Microsoft Teams contient des services et une API HDX côté VDA afin de créer une interface avec l’application hébergée Teams pour recevoir des commandes. Ces composants ouvrent un canal virtuel de contrôle vers Media Engine côté application Citrix Workspace. Le point de terminaison décode et restitue le multimédia localement. Inversez les composants logiciels enfichables de la fenêtre locale de l’application Citrix Workspace dans l’application Teams hébergée.

L’authentification et la signalisation se produisent en mode natif sur l’application hébergée par Teams, tout comme les autres services Teams (par exemple le chat ou la collaboration). La redirection audio/vidéo ne les affecte pas.

Seule la récupération/restitution client est disponible.

Architecture

Fonctionnement de l'optimisation pour Microsoft Teams

Cette vidéo de démo vous donne une idée du fonctionnement de Microsoft Teams dans un environnement virtuel Citrix.

Démo Optimisation pour Microsoft Teams

Configuration système requise

Version minimale - Virtual Delivery Agent (VDA) 1906 pour Windows Desktop OS :

Systèmes d’exploitation pris en charge :

  • Windows 10 64 bits, versions minimum 1607 jusqu’à 1903.

Exigences :

  • Microsoft .NET Framework 4.7.1 ou version ultérieure est automatiquement installé si cette version n’est pas déjà installée.
  • Microsoft Visual C++ 2013 et 2015 Runtime, 32 et 64 bits.
  • BCR_x64.msi - MSI qui contient le code d’optimisation de Teams et démarre automatiquement à partir de l’interface graphique. Si vous utilisez l’interface de ligne de commande pour l’installation du VDA, ne l’excluez pas.

Version minimale - Virtual Delivery Agent (VDA) 1906 pour OS de serveur :

Systèmes d’exploitation pris en charge :

  • Windows Server 2019, 2016 et 2012 R2 (éditions Standard et Datacenter).

Le programme d’installation installe automatiquement les éléments suivants, qui sont disponibles sur le support d’installation Citrix dans les dossiers Support :

  • Microsoft .NET Framework 4.7.1 ou version ultérieure est automatiquement installé si cette version n’est pas déjà installée.
  • Microsoft Visual C++ 2013 et 2015 Runtime, 32 et 64 bits.
  • BCR_x64.msi - MSI qui contient le code d’optimisation de Teams et démarre automatiquement à partir de l’interface graphique. Si vous utilisez l’interface de ligne de commande pour l’installation du VDA, ne l’excluez pas.

Si vous n’avez pas installé et activé les rôles Services Bureau à distance, le programme d’installation installe et active automatiquement ces rôles.

Version minimale - Application Citrix Workspace 1905 pour Windows :

  • Windows 7, 8 et 10 (éditions 32 bits et 64 bits, y compris l’édition Embedded)
  • Exigences pour le point de terminaison : CPU double d’environ 1,4 GHz pouvant prendre en charge la résolution VGA 360p lors d’une visioconférence égal à égal.
  • L’application Citrix Workspace requiert une capacité minimale de 600 Mo d’espace disque disponible et 1 Go de RAM.
  • La configuration minimale requise pour Microsoft .NET Framework est la version 4.6.2. L’application Citrix Workspace télécharge et installe automatiquement .NET Framework si la version n’est pas présente dans le système.
  • Cette version de l’application Citrix Workspace prend en charge la redirection audio et vidéo (égal à égal ou conférence) et le partage d’écran entrant. Le partage d’écran sortant n’est pas pris en charge.

Activer l’optimisation de Microsoft Teams

Pour activer l’optimisation de Microsoft Teams, utilisez la stratégie Studio décrite à la section Stratégie de redirection de Microsoft Teams. Outre l’activation de cette stratégie, HDX vérifie que la version de l’application Citrix Workspace est égale ou supérieure à la version minimale requise. Si la stratégie est activée et que la version de l’application Citrix Workspace est prise en charge, la clé de Registre HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport est définie sur 1 de manière automatique. L’application Microsoft Teams lit la clé à charger en mode VDI.

Dépannage

Cette section fournit des conseils de dépannage pour les problèmes que vous pourriez rencontrer lors de l’utilisation de l’optimisation de Microsoft Teams. Pour de plus amples informations, consultez l’article CTX253754.

Sur le VDA

Quatre services sont installés par BCR_x64.msi. Seuls deux de ces services sont responsables de la redirection Microsoft Teams dans le VDA.

Quatre services installés par redirection de contenu du navigateur

  • Citrix HDX Teams Redirection Service établit le canal virtuel utilisé dans Teams. Le service repose sur CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service s’exécute en tant que WebSocketService.exe en écoute sur 127.0.0.1:9002 TCP. WebSocketService.exe exécute deux fonctions principales :

    i.La terminaison TLS pour Secure WebSockets reçoit une connexion WebSocket sécurisée de vdiCitrixPeerConnection.js, qui est un composant de l’application Teams. Vous pouvez le suivre avec le moniteur de processus. Par exemple :

    Moniteur de processus

    ii. Mappage de session utilisateur. Lorsque l’application Teams démarre, WebSocketService.exe démarre le processus WebSocketAgent.exe dans la session de l’utilisateur dans le VDA. WebSocketService.exe s’exécute dans la session 0 en tant que compte LocalSystem.

    Vous pouvez utiliser l’une des deux méthodes pour vérifier si le service WebSocketService.exe est dans un état d’écoute actif dans le VDA.

    Option 1 : tapez https://127.0.0.1:9002 dans un onglet de navigateur. Une communication réussie avec le service indique qu’il est en état d’écoute actif.

    Option 2 : vous pouvez collecter des informations plus détaillées à l’aide de la console DevTools.

    1. Tapez ce texte sur une ligne :

      var exampleSocket = new WebSocket('wss://127.0.0.1:9002'); exampleSocket.onmessage = function(messageEvent) { console.log(JSON.stringify(messageEvent)); };

    2. Attendez quelques secondes, puis tapez :

      exampleSocket.readyState

    La sortie attendue de l’étape 2 est le numéro 1, ce qui indique que la connexion WebSocket a été formée avec succès.

    Moniteur de processus

    Les numéros de sortie sont :

    • 0 (CONNECTING) La connexion n’est pas encore ouverte.
    • 1 (OPEN) La connexion est ouverte et prête à communiquer.
    • 2 (CLOSING) La connexion est en cours de fermeture.
    • 3 (CLOSED) La connexion est fermée ou ne peut pas être ouverte.

Si vous voyez cette erreur ou le numéro 3, assurez-vous que le service de redirection Citrix HDX Teams est en cours d’exécution et redémarrez si nécessaire :

Moniteur de processus

vdiCitrixPeerConnection.js est enregistré en tant que HdxWebRTC.js dans la console.

Remarque :

WebSocketService.exe écoute deux sockets TCP, 127.0.0.1:9001 et 127.0.0.1:9002. Le port 9001 est utilisé pour la redirection du contenu du navigateur et la redirection vidéo HTML5. Le port 9002 est utilisé pour la redirection de Teams.

Emplacements et descriptions des services

Service Chemin vers l’exécutable Ouvrir une session en tant que Description
Service de redirection vidéo Citrix HTML5 “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service Compte Système local Fournit plusieurs services multimédia HDX avec l’infrastructure initiale requise pour effectuer la redirection de média entre le bureau virtuel et la machine de point de terminaison.
Service de redirection de navigateur Citrix HDX “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Ce compte (service local) Permet de rediriger le contenu du navigateur entre la machine de point de terminaison et le bureau virtuel.
Service de transfert de port Citrix “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Ce compte (service local) Permet de réacheminer le port entre la machine de point de terminaison et le bureau virtuel pour la redirection de contenu du navigateur.
Service de redirection de Teams Citrix HDX “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Ce compte (service local) Offre une redirection de Microsoft Teams entre la machine de point de terminaison et le bureau virtuel.

Application Citrix Workspace

Sur le point de terminaison de l’utilisateur, l’application Citrix Workspace pour Windows instancie un nouveau service appelé HdxTeams.exe lorsque Teams démarre dans le VDA et que l’utilisateur essaie d’effectuer un appel ou d’accéder à ses périphériques en mode auto-aperçu. Si ce service ne s’affiche pas, vérifiez les points suivants :

  1. Assurez-vous que vous avez installé au minimum la version 1905 de l’application Workspace pour Windows. Voyez-vous HdxTeams.exe et les binaires webrpc.dll dans le chemin d’installation de l’application Workspace ?
  2. Si vous avez validé l’étape 1, procédez comme suit pour vérifier si HdxTeams.exe est lancé.
    1. Quittez Teams sur le VDA.
    2. Démarrez services.msc sur le VDA.
    3. Arrêtez le service de Teams Citrix HDX.
    4. Déconnectez la session ICA.
    5. Connectez la session ICA.
    6. Démarrez le service de redirection de Teams Citrix HDX.
    7. Redémarrez le service de redirection vidéo Citrix HDX HTML5.
    8. Lancez Teams sur le VDA.
  3. Si HdxTeams.exe n’est toujours pas lancé sur le point de terminaison client, procédez comme suit :
    1. Redémarrez le VDA.
    2. Redémarrez le point de terminaison client.

Support

Citrix et Microsoft prennent conjointement en charge la mise à disposition de Microsoft Teams à partir de Citrix Virtual Apps and Desktops à l’aide de l’optimisation pour Microsoft Teams. Cette prise en charge conjointe est le résultat d’une étroite collaboration entre les deux entreprises. Si vous avez des contrats de support valides et que vous rencontrez un problème avec cette solution, ouvrez un ticket de support avec le fournisseur dont le code semble être à l’origine du problème. Autrement dit, Microsoft pour Teams ou Citrix pour les composants d’optimisation.

Citrix ou Microsoft reçoit le ticket, trie le problème et escalade le cas échéant. Vous n’avez pas besoin de contacter l’équipe de support de chaque entreprise.

Collecte des journaux

Les journaux HDXTeams.exe se trouvent sur la machine de l’utilisateur dans %TEMP% (AppData/Local/Temp). Recherchez un fichier .txt appelé webrpc_Day_Month_timestamp_Year.txt.

Dans les journaux HDXTeams.exe, ce sont les entrées ICE (Interactive Connectivity Establishment) pertinentes qui doivent être présentes pour que la configuration d’un appel réussisse (voir exemple ci-dessous) :

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

RTCPeerConnection::createOffer. audio = 1 video = 1
RTCPeerConnection::OnSignalingChange. signaling state = HaveLocalOffer
video_element::connectTo
RTCPeerConnection::OnIceGatheringChange. state = Gathering

[…]
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
[…]
candidate:4271145120 1 udp 1685987071 66.165.176.60 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
[…]

RTCPeerConnection::OnIceGatheringChange. state = Complete
RTCPeerConnection::setRemoteDescription

RTCPeerConnection::OnSignalingChange. signaling state = HaveRemoteOffer

Si vous rencontrez un problème et que vous pouvez le reproduire de manière cohérente, nous vous recommandons de capturer des traces de CDF avant de contacter le support. Pour plus d’informations, consultez l’article CDFcontrol du centre de connaissances.

Pour obtenir des recommandations sur la collecte des traces CDF, consultez l’article du Centre de connaissances Recommandations pour la collecte des traces CDF.

Traces CDF côté VDA - Activez les fournisseurs de traces CDF suivants :

Traces CDF côté VDA

Traces CDF côté application Workspace - Activez les fournisseurs de traces CDF suivants :

Traces CDF côté application Workspace