Optimización para Microsoft Teams

Importante:

La optimización para Microsoft Teams requiere Microsoft Teams versión 1.2.00.31357 o posterior.

Citrix ofrece la optimización para Microsoft Teams de escritorio mediante Citrix Virtual Apps and Desktops y la aplicación Citrix Workspace. De forma predeterminada, agrupamos todos los componentes necesarios en la aplicación Citrix Workspace y en Virtual Delivery Agent (VDA).

Nuestra optimización para Microsoft Teams contiene una API y servicios de HDX del lado de VDA para interactuar con la aplicación alojada Teams y recibir comandos. Estos componentes abren un canal virtual de control (CTXMTOP) en el motor de medios de la aplicación Citrix Workspace. El dispositivo de punto final decodifica y genera localmente el contenido multimedia. Revierta los complementos integrados de la ventana local de la aplicación Citrix Workspace a la aplicación Microsoft Teams alojada.

La autenticación y la señalización se producen de forma nativa en la aplicación alojada de Microsoft Teams, al igual que los demás servicios de Microsoft Teams (por ejemplo, el chat o la colaboración). La redirección de audio/vídeo no les afecta.

CTXMTOP es un canal virtual de comando y control. Esto significa que los medios no se intercambian entre la aplicación Citrix Workspace y el VDA.

Solo la obtención del cliente/generación del cliente está disponible.

Este vídeo de demostración le da una idea de cómo funciona Microsoft Teams en un entorno virtual Citrix.

Demostración de la optimización para Microsoft Teams

Instalación de Microsoft Teams

ADVERTENCIA:

Si se modifica el Registro de forma incorrecta, pueden producirse problemas graves que obliguen a reinstalar el sistema operativo. Citrix no puede garantizar que los problemas derivados de la utilización inadecuada del Editor del Registro puedan resolverse. Si utiliza el Editor del Registro, será bajo su propia responsabilidad. Haga una copia de seguridad del Registro antes de modificarlo.

Le recomendamos que siga las directrices de instalación para toda la máquina de Microsoft Teams y que no utilice el instalador .exe que instala Teams en Appdata. En su lugar, instálelo en C:\Program Files (x86)\Microsoft\Teams con el indicador ALLUSER=1 desde la línea de comandos. De este modo, la aplicación Teams no se actualiza automáticamente cuando hay una nueva versión. Recomendamos este modo para entornos no persistentes. Para obtener más información, consulte Instalar Microsoft Teams mediante MSI (sección Instalación de VDI).

Si tiene entornos VDI persistentes dedicados y desea que la aplicación Teams se actualice automáticamente, además de preferir instalar Teams por usuario en Appdata/Local, utilice el instalador .exe o MSI sin ALLUSER =1.

Si utiliza Citrix App Layering para administrar instalaciones de VDA y Microsoft Teams en diferentes capas, implemente esta clave de Registro en Windows antes de instalar Teams con ALLUSER =1:

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix

O bien:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix

Cree una clave de Registro vacía llamada PortICA (deje el nombre, tipo y datos predeterminados).

Recomendaciones para Profile Management

Cuando el indicador ALLUSER =1 se transfiere al MSI desde la línea de comandos, la aplicación Teams se instala en C:\Program Files (~ 300 MB). La aplicación utiliza AppData\Local para registros y AppData\Roaming\Microsoft\Teams configuraciones específicas de usuario, almacenamiento en caché de elementos en la interfaz de usuario, etc.

Requisitos del sistema

Versión mínima: Virtual Delivery Agent (VDA) 1906.2:

Sistemas operativos compatibles:

  • Windows 10 de 64 bits, versiones mínimas 1607 hasta 1903.
  • Windows Server 2019, 2016 y 2012 R2 (ediciones Standard y Datacenter).

Requisitos:

  • BCR_x64.msi: El MSI que contiene el código de optimización de Microsoft Teams y se inicia automáticamente desde la GUI. Si utiliza la interfaz de línea de comandos para la instalación de VDA, no la excluya.

Versión recomendada: aplicación Citrix Workspace 1911 para Windows; versión mínima: aplicación Citrix Workspace 1907 para Windows:

  • Windows 7, 8 y 10 (ediciones de 32 y 64 bits, incluida las ediciones Embedded)
  • Windows 10 IoT Enterprise 2016 LTSB (v1607) y 2019 LTSC (v1809)
  • Requisito del dispositivo de punto final: CPU dual de aproximadamente 2,2 - 2,4 GHz que puede admitir una resolución HD de 720p durante una llamada de conferencia en vídeo de punto a punto.
  • CPU de núcleo doble o cuádruple con velocidades base más bajas (~1,5 GHz) equipadas con Intel Turbo Boost o AMD Turbo Core que pueden aumentar hasta al menos 2,4 GHz.
  • Clientes ligeros HP verificados: t630/t640, t730/t740, mt45.
  • Clientes ligeros Dell verificados: 5070/5470 Mobile TC.
  • Para obtener una lista completa de dispositivos de punto final verificados, consulte Clientes ligeros.
  • La aplicación Citrix Workspace requiere un mínimo de 600 MB de espacio libre en el disco y 1 GB de RAM.
  • El requisito mínimo de Microsoft .NET Framework es la versión 4.6.2. La aplicación Citrix Workspace descarga e instala automáticamente .NET Framework si no está presente en el sistema.

Habilitar la optimización de Microsoft Teams

Para habilitar la optimización de Microsoft Teams, utilice la directiva de Studio descrita en Directiva de redirección de Microsoft Teams (está ACTIVADA de manera predeterminada). Además de habilitar esta directiva, HDX comprueba si la versión de la aplicación Citrix Workspace es igual o mayor que la versión mínima requerida. Si se ha habilitado la directiva y se admite la versión de la aplicación Citrix Workspace, la clave del Registro HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport se establece en 1 automáticamente en el VDA. La aplicación Microsoft Teams lee la clave para cargar en modo VDI.

Si hace clic en Acerca de > Versión, aparecerá la leyenda Optimizado para Citrix:

Leyenda Optimizado para Citrix

Si no aparece la leyenda Optimizado para Citrix, salga de Teams haciendo clic con el botón derecho en el icono del área de notificación y reinicie.

Requisitos de la red

Microsoft Teams se basa en servidores Media Processor (procesador de multimedia) en Office 365 para las reuniones o llamadas con múltiples participantes. Microsoft Teams se basa en Transport Relay (traspaso de transporte) de Office 365 para los siguientes supuestos:

  • Dos pares en una llamada punto a punto sin conectividad directa
  • Un participante no tiene conectividad directa con el procesador de multimedia.

Por lo tanto, el estado de la red entre el par y la nube de Office 365 determina el rendimiento de la llamada.

Se recomienda analizar el entorno para identificar los riesgos y los requisitos que puedan influir en la implementación general de voz y vídeo en la nube. Utilice Herramienta de evaluación de la red de Skype Empresarial para comprobar si la red está lista para Microsoft Teams. Para obtener más información, consulte la sección Asistencia.

Resumen de las recomendaciones de red clave para el tráfico con protocolo de transporte en tiempo real (RTP):

  • Conéctese a la red de Office 365 de la forma más directa posible desde la sucursal.
  • Si debe utilizar cualquiera de las siguientes opciones en la sucursal, asegúrese de que el tráfico RTP/UDP de Teams no tenga obstáculos. HDXTeams.exe no respeta los proxies explícitos configurados en el dispositivo de punto final.
    • Omitir servidores proxy
    • Interceptación SSL de red
    • Dispositivos de inspección profunda de paquetes (DPI)
    • Bifurcaciones VPN (utilice túnel dividido si es posible)
  • Planifique y proporcione suficiente ancho de banda.
  • Compruebe la conectividad y la calidad de la red en cada sucursal.

El motor multimedia WebRTC en la aplicación Workspace (HDXTeams.exe) utiliza el protocolo de transporte seguro en tiempo real (SRTP) para secuencias multimedia que se descargan en el cliente. SRTP proporciona confidencialidad y autenticación a RTP mediante el uso de claves simétricas (128 bits) para cifrar el contenido multimedia y los mensajes de control, y utiliza el cifrado AES con modo de contador.

Para garantizar una experiencia de usuario positiva, se recomiendan las siguientes métricas:

Métrica Dispositivo de punto final a Office 365
Latencia (ida) < 50 ms
Latencia (RTT) < 100 ms
Pérdida de paquetes < 1% durante cada intervalo de 15 segundos
Fluctuación entre la llegada de paquetes < 30 ms durante cada intervalo de 15 segundos

Para obtener más información, consulte Preparar la red de la organización para Microsoft Teams.

En cuanto a requisitos de ancho de banda, la optimización para Microsoft Teams puede utilizar una amplia variedad de códecs para audio (OPUS/G.722/PCM G711) y vídeo (H264/VP9).

Los pares negocian estos códecs durante el proceso de establecimiento de llamadas mediante la oferta/respuesta de Session Description Protocol (SDP). Las recomendaciones mínimas de Citrix son:

Tipo Ancho de banda Códec
Audio (en cada sentido) ~ 90 Kbps G.722
Audio (en cada sentido) ~ 60 Kbps Opus*
Vídeo (en cada sentido) ~ 700 Kbps H264 360p @ 30 fps 16:9
Vídeo (en cada sentido) ~ 2500 Kbps VP9 720p @ 30 fps 16:9
Pantalla compartida ~ 300 Kbps H.264 1080p @ 15 fps

* Opus admite codificación de velocidad de bits constante y variable desde 6 kbps hasta 510 kbps.

Opus y VP9 son los códecs preferidos para llamadas de punto a punto entre dos usuarios VDI optimizados.

G.722 y H264 son los códecs preferidos para un usuario VDI que se une a una reunión.

Establecimiento de llamadas y rutas de flujo de medios

Cuando sea posible, el motor de medios HDX de la aplicación Citrix Workspace (HDXTeams.exe) intenta establecer una conexión SRTP (protocolo de transporte seguro en tiempo real) de red directa mediante el protocolo de datagramas de usuario (UDP) en una llamada de un par homólogo a otro. Si los puertos UDP están bloqueados, el motor de medios recurre a TCP 443.

El motor de contenido multimedia HDX admite ICE, el protocolo STUN (Session Traversal Utilities for NAT) y el protocolo TURN (Traversal Using Relays around NAT) para la detección de candidatos y el establecimiento de conexiones.

Si no hay una ruta directa entre los dos pares o entre un par y un servidor de conferencias (si el usuario se une a una reunión o llamada con múltiples participantes), HDXTeams.exe utiliza un servidor de traspaso de transporte de Microsoft Teams en Office 365 para llegar al otro par o al procesador de multimedia (donde se alojan las reuniones). La máquina cliente del usuario debe tener acceso a dos rangos de direcciones IP de subred de Office 365 y a 4 puertos UDP. Para obtener más información, consulte el diagrama de arquitectura de la sección “Configuración de llamadas” que hay más abajo y Direcciones URL e intervalos de direcciones IP de ID 11 para Office 365.

ID Categoría Direcciones Puertos de destino
11 Precisa optimización 13.107.64.0/18, 52.112.0.0/14 UDP: 3478, 3479, 3480, 3481, TCP: 443 (respaldo)

Estos rangos contienen tanto servidores de traspaso de transporte como procesadores de multimedia. Los servidores de traspaso de transporte de Teams proporcionan funciones STUN y TURN, pero no son dispositivos de punto final ICE. Además, los servidores de traspaso de transporte de Teams no finalizan el contenido multimedia ni realizan ninguna transcodificación. Pueden puentear TCP (si HDXTeams.exe utiliza TCP) a UDP cuando reenvían tráfico a otros pares o procesadores de multimedia.

HDXTeams.exe conecta con el servidor de traspaso de trasnsporte de Microsoft Teams más cercano en la nube de Office 365. HDXTeams.exe utiliza la técnica IP Anycast y los puertos UDP 3478 a 3481 (puertos UDP diferentes por carga de trabajo, aunque puede haber multiplexación) o el puerto TCP 443 con TLSV1.2 de respaldo. La calidad de la llamada depende del protocolo de red subyacente. Debido a que siempre se recomienda UDP antes que TCP, se recomienda diseñar las redes para dar cabida al tráfico UDP en la sucursal.

Si Teams se carga en modo optimizado y HDXTeams.exe se está ejecutando en el terminal, los errores de establecimiento interactivo de conectividad (ICE) pueden provocar un error de configuración de llamada o transmisión de audio/vídeo en una sola dirección. Cuando no se pueda completar una llamada o las secuencias multimedia no sean dúplex completo, compruebe primero la traza Wireshark en el dispositivo de punto final. Para obtener más información sobre el proceso de recopilación de candidatos de ICE, consulte “Recopilar registros” en la sección Asistencia.

Nota:

Si los dispositivos de punto final no tienen acceso a Internet, es posible que el usuario solo pueda realizar una llamada de un par homólogo a otro si están en la misma red de área local (LAN). Las reuniones no funcionan. En este caso, hay un tiempo de espera de 30 segundos antes de que comience la configuración de la llamada.

Configuración de llamadas

Utilice este diagrama de arquitectura como referencia visual para la secuencia del flujo de llamadas. Los pasos correspondientes se indican en el diagrama.

Arquitectura:

Cómo funciona la optimización para Microsoft Teams

  1. Inicie Microsoft Teams.
  2. Teams se autentica en O365. Las directivas de arrendatario se envían al cliente de Teams, y la información pertinente del canal de señalización y del protocolo TURN se transmite a la aplicación.
  3. Teams detecta que se ejecuta en un VDA y realiza llamadas API a la API de JavaScript de Citrix.
  4. JavaScript de Citrix en Teams abre una conexión WebSocket segura con WebSocketService.exe en el VDA (127.0.0.1:9002), que genera WebSocketAgent.exe dentro de la sesión de usuario.
  5. WebSocketAgent.exe crea una instancia de un canal virtual genérico mediante una llamada al servicio de redirección de Teams para Citrix HDX (CtxSvcHost.exe).
  6. El archivo wfica32.exe (motor de HDX) de la aplicación Citrix Workspace genera un nuevo proceso denominado HdxTeams.exe, que es el nuevo motor de WebRTC utilizado para la optimización de Teams.
  7. HdxTeams.exe y Teams.exe tienen una ruta bidireccional de canales virtuales y pueden comenzar a procesar solicitudes multimedia.

    —–Llamadas de usuario——

  8. El interlocutor A hace clic en el botón de llamada. Teams.exe se comunica con los servicios de Teams de Office 365 y establece una ruta de señalización de extremo a extremo con el interlocutor B. Teams solicita a HdxTeams una serie de parámetros de llamada admitidos (códecs, resoluciones, etc., lo que se conoce como una oferta de protocolo de descripción de sesiones o SDP). A continuación, estos parámetros de llamada se retransmiten mediante la ruta de señalización a los servicios de Teams en Office 365 y, desde allí, al otro interlocutor.
  9. La oferta/respuesta SDP (negociación de paso único) tiene lugar a través del canal de señalización, y las comprobaciones de conectividad de ICE (recorrido de NAT y firewalls mediante el protocolo STUN) se completan. A continuación, el contenido multimedia con Secure Real-Time Transport Protocol (SRTP) circula directamente entre HdxTeams.exe y el otro interlocutor (o servidores de conferencia de Office 365 si se trata de una reunión).

Consideraciones sobre el firewall

Cuando los usuarios inician una llamada optimizada utilizando el cliente de Microsoft Teams por primera vez, es posible que aparezca una advertencia relacionada con la configuración del firewall de Windows . En la advertencia, se pide a los usuarios que permitan la comunicación para HDXTeams.exe (HDX Overlay Teams).

Advertencia del cortafuegos

Las cuatro entradas siguientes se agregan en Reglas de entrada, en la consola Firewall de Windows Defender > Seguridad avanzada. Puede aplicar reglas más restrictivas si lo desea.

Reglas de entrada del firewall

Citrix SD-WAN: conectividad de red optimizada para Microsoft Teams

Para lograr una calidad de audio y vídeo óptima, se requiere una conexión de red a la nube de Office 365 que tenga baja latencia, baja vibración y baja pérdida de paquetes. El uso de una red de retorno (backhaul) para canalizar el tráfico RTP de audio y vídeo de Microsoft Teams desde los usuarios de la aplicación Citrix Workspace que se encuentran en sucursales a un centro de datos antes de dirigirlo a Internet puede agregar una latencia excesiva y también puede causar congestión en los vínculos WAN. Citrix SD-WAN optimiza la conectividad para Microsoft Teams siguiendo los principios de conectividad de red de Microsoft Office 365. Citrix SD-WAN utiliza la dirección IP y el servicio web de Office 365 basados en REST de Microsoft y DNS próximo para identificar, clasificar y dirigir el tráfico de Microsoft Teams.

Las conexiones de banda ancha empresarial de Internet en muchas áreas sufren pérdida intermitente de paquetes, períodos de vibración excesiva e interrupciones.

Citrix SD-WAN ofrece dos soluciones para preservar la calidad de audio y vídeo de Microsoft Teams cuando la red tiene un estado variable o degradado.

  • Si utiliza Microsoft Azure, un dispositivo virtual Citrix SD-WAN (VPX) implementado en Azure VNET ofrece optimizaciones de conectividad avanzadas. Estas optimizaciones incluyen conmutación por error de enlaces y duplicación de paquetes de audio.
  • Como alternativa, los clientes de Citrix SD-WAN pueden conectarse a Office 365 a través del servicio Citrix Cloud Direct. Este servicio garantiza una entrega fiable y segura de todo el tráfico de Internet.

Si la calidad de la conexión a Internet de la sucursal no es un problema, puede ser suficiente para minimizar la latencia, al dirigir el tráfico de Microsoft Teams directamente desde el dispositivo de sucursal Citrix SD-WAN a la puerta delantera de Office 365 más próxima. Para obtener más información, consulte Optimización de Citrix SD-WAN para Office 365.

Citrix SD-WAN

Vista de galería y participantes activos en Microsoft Teams

Solo se admite una transmisión de vídeo entrante en reuniones o llamadas de grupo. Cuando hay varios participantes enviando vídeo, solo se muestra el vídeo del participante dominante en cada momento. Puede haber un retraso de uno o dos segundos entre el momento en que un participante se detecta como activo y el momento en que se muestra la fuente de vídeo.

Uso compartido de pantalla en Microsoft Teams

Microsoft Teams utiliza uso compartido de pantalla basado en vídeo (VBSS), que codifica el escritorio que se comparte con códecs de vídeo, como H264, y crea un flujo de alta definición. Con la optimización HDX, la pantalla compartida entrante se trata como una transmisión de vídeo. Por lo tanto, si está en medio de una videollamada y el otro participante comienza a compartir el escritorio, la fuente de vídeo de la cámara original se pone en pausa y, en su lugar, se muestra la fuente de vídeo de la pantalla compartida. A continuación, el participante debe reanudar manualmente el uso compartido de la cámara.

El uso compartido de pantalla saliente también se optimiza y se descarga en la aplicación Citrix Workspace (versión 1907 o posterior). En este caso, HDXTeams.exe captura y transmite solo la ventana de Citrix Desktop Viewer (CDViewer.exe). Si desea compartir una aplicación local que se ejecute en su equipo cliente, puede superponerla sobre CDViewer y también se captura.

Multimonitor: en los casos en que CDViewer está en modo de pantalla completa y se extiende por varios monitores, solo se comparte el monitor principal. Los usuarios deben arrastrar la aplicación en cuestión al escritorio virtual del monitor principal para que el otro participante de la llamada la pueda ver.

Pantalla compartida

Nota:

Si publica Teams como aplicación independiente integrada, el uso compartido de pantalla captura el escritorio local del terminal físico en la versión mínima de la aplicación Citrix Workspace 1909.

Periféricos en Microsoft Teams

Cuando la optimización para Microsoft Teams está activa, la aplicación Citrix Workspace accede a los periféricos (auriculares, micrófono, cámaras, altavoces…). A continuación, los periféricos se indican correctamente en la IU de Microsoft Teams (Configuración > Dispositivos).

Modo de optimización para Microsoft Teams

Microsoft Teams no accede directamente a los dispositivos. En su lugar, se basa en HDXTeams.exe para adquirir, capturar y procesar los archivos multimedia. Microsoft Teams indica los dispositivos que debe seleccionar el usuario.

Recomendaciones:

  • Auriculares certificados por Microsoft Teams con eliminación de eco integrada. En configuraciones con varios periféricos, donde el micrófono y los altavoces se encuentran en dispositivos separados, puede producirse eco. Por ejemplo, una cámara web con un micrófono incorporado y un monitor con altavoces. Cuando utilice altavoces externos, colóquelos lo más lejos posible del micrófono y de cualquier superficie que pueda refractar el sonido hacia el micrófono.
  • Cámaras certificadas por Microsoft Teams, aunque los periféricos certificados por Skype Empresarial son compatibles con Microsoft Teams.
  • HdxTeams.exe no puede aprovechar la descarga de CPU con cámaras web que emplean codificación H.264 integrada -UVC 1.1 y 1.5.

Nota:

HDXTeams.exe solo admite estos formatos específicos de dispositivo de sonido (canales, profundidad de bits y tasa de muestreo):

  • Dispositivos de reproducción: hasta 2 canales, 16 bits, frecuencias de hasta 48000 Hz
  • Dispositivos de grabación: hasta 3 canales, 16 bits, frecuencias de hasta 48000 Hz

Incluso si un solo altavoz o micrófono no tiene la configuración prevista, la enumeración de dispositivos en Teams falla y aparece Ninguno en Configuración > Dispositivos. Como solución temporal, abra el Panel de control de Sonido (mmsys.cpl), seleccione el dispositivo de reproducción o grabación, abra Propiedades > Avanzadas y cambie la configuración a un modo compatible. Alternativamente, inhabilite el dispositivo específico.

Las tecnologías HDX pueden utilizar cualquiera de estos métodos para asignar periféricos:

  • Optimización para Microsoft Teams (modo recomendado).
  • Si Microsoft Teams no puede cargarse en modo VDI optimizado, el VDA utiliza tecnologías HDX heredadas como la redirección de cámaras web y la redirección de audio y micrófono del cliente. En el modo no optimizado, los periféricos se asignan al VDA. Los periféricos aparecen en la aplicación Microsoft Teams como si estuvieran conectados localmente al escritorio virtual.

    Para determinar si está en modo optimizado o no optimizado al observar la ficha Configuración > Dispositivos en Teams, la diferencia más relevante es el nombre de la cámara. Si Microsoft Teams se carga en modo no optimizado, se inician las tecnologías HDX antiguas. El nombre de la cámara web tiene el sufijo Citrix HDX, como se muestra en el gráfico siguiente. Los nombres de los altavoces y del micrófono pueden ser ligeramente distintos (o estar truncados) si se comparan con sus nombres en el modo optimizado.

Modo de no optimización para Microsoft Teams

Cuando se utilizan tecnologías HDX heredadas, Microsoft Teams no descarga el procesamiento de audio, vídeo y uso compartido de la pantalla al motor multimedia WebRTC de la aplicación Citrix Workspace del dispositivo de punto final. En su lugar, las tecnologías HDX emplean la generación de contenido del lado del servidor. Espere un alto consumo de CPU en el VDA cuando active vídeo. Es posible que el rendimiento del audio en tiempo real no sea óptimo.

Limitaciones conocidas

  • Vista de galería: Solo altavoz activo.
  • Botones HID: Respuesta y finalización de llamada no compatibles. Compatible con subir y bajar el volumen.
  • Al cambiar la entrada o salida de los periféricos en Configuración > Dispositivos en mitad de una llamada, es posible que ocurra un fallo de audio durante un segundo.
  • Al hacer uso compartido de pantalla en configuraciones de varios monitores, solo se comparte el monitor principal.

Supervisar Teams

En esta sección, se ofrecen líneas generales para supervisar la optimización de Microsoft Teams con HDX. Si el usuario se está ejecutando en modo optimizado y HdxTeams.exe se está ejecutando en la máquina cliente, hay un proceso en el VDA llamado WebSocketAgent.exe que se ejecuta en la sesión. Utilice Administrador de actividades en Director para ver la aplicación.

Supervisar Teams en Administrador de actividades

Con la versión mínima de VDA 1912, puede supervisar las llamadas activas de Teams a través de Citrix HDX Monitor (versión mínima 3.11). La imagen ISO del producto Citrix Virtual Apps and Desktops contiene la último versión de hdxmonitor.msi en la carpeta layout\image-full\Support\HDX Monitor.

Para obtener más información, consulte Supervisión en el artículo CTX253754 de Knowledge Center.

Solución de problemas

En esta sección se proporcionan sugerencias para solucionar problemas que pueden surgir al usar la optimización para Microsoft Teams. Encontrará más información en CTX253754.

En el Virtual Delivery Agent

Hay cuatro servicios instalados por BCR_x64.msi. Solo dos son responsables de la redirección de Microsoft Teams en el VDA.

Cuatro servicios instalados por redirección de contenido del explorador

  • Citrix HDX Teams Redirection Service establece el canal virtual utilizado en Microsoft Teams. El servicio se basa en CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service se ejecuta como WebSocketService.exe y escucha el puerto TCP 127.0.0.1:9002. WebSocketService.exe realiza dos funciones principales:

    i. La finalización de TLS para WebSockets seguros recibe una conexión WebSocket segura desde vdiCitrixPeerConnection.js, que es un componente de la aplicación Microsoft Teams. Puede hacer un seguimiento de esto con Process Monitor. Para obtener más información sobre los certificados, consulte la sección “TLS, la redirección de vídeo HTML5 y la redirección de contenido del explorador web” en Comunicación entre Controller y VDA.

    Algunos antivirus y software de seguridad de escritorio interfieren con el correcto funcionamiento de WebSocketService.exe y sus certificados. Aunque es posible que el servicio de hecho (Redirección de vídeo HTML5 de Citrix HDX) se esté ejecutando en la consola de services.msc, el socket TCP de localhost 127.0.0.1:9002 nunca está en modo de escucha como se ve en netstat. Intentar reiniciar el servicio hace que se bloquee (“Deteniendo…”). Asegúrese de que aplica las exclusiones adecuadas para el proceso WebScoketService.exe.

    Process Monitor

    ii. Asignación de sesiones de usuario. Cuando se inicia la aplicación Microsoft Teams, WebSocketService.exe inicia el proceso WebSocketAgent.exe en la sesión del usuario en el VDA. WebSocketService.exe se ejecuta en la sesión 0 como una cuenta LocalSystem.

    Servicio WebSocketAgent.exe

    Puede utilizar netstat para comprobar si el servicio WebSocketService.exe se encuentra en un estado de escucha activa en el VDA.

    Ejecute netstat -anob -p tcp desde una ventana elevada de símbolo del sistema:

    Ejemplo de ejecución de netstat

    En una conexión correcta, el estado cambia a ESTABLECIDO:

    Ejemplo de netstat correcto

Importante:

WebSocketService.exe escucha dos sockets TCP: 127.0.0.1:9001 y 127.0.0.1:9002. El puerto 9001 se utiliza para la redirección de contenido del explorador y la redirección de vídeo HTML5. El puerto 9002 se utiliza para la redirección de Microsoft Teams. No debe tener ninguna configuración de proxy en el sistema operativo Windows del VDA que pueda impedir una comunicación directa entre Teams.exe y WebSocketService.exe. A veces, al configurar un proxy explícito en Internet Explorer 11 (Opciones de Internet > Conexiones > Configuración de LAN > Servidor proxy), es posible que las conexiones circulen por un servidor proxy asignado. Compruebe que la opción Omitir servidor proxy para las direcciones locales esté activada cuando utilice una configuración de proxy manual y explícita.

Ubicaciones y descripciones de servicios

Servicio Ruta al archivo ejecutable Iniciar sesión como Descripción
Servicio de redirección de vídeo para Citrix HTML5 “C:\Archivos de programa (x86)\Citrix\System32\WebSocketService.exe” /service Cuenta del sistema local Proporciona varios servicios HDX Multimedia con el marco inicial necesario para realizar la redirección multimedia entre el escritorio virtual y el dispositivo de punto final.
Servicio de redirección de explorador para Citrix HDX “C:\Archivos de programa (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Esta cuenta (servicio local) Permite redirigir el contenido del explorador entre el dispositivo de punto final y el escritorio virtual.
Servicio de reenvío de puertos para Citrix “C:\Archivos de programa (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Esta cuenta (servicio local) Permite reenviar puertos entre el dispositivo de punto final y el escritorio virtual para la redirección de contenido del explorador web.
Servicio de redirección de Teams para Citrix HDX “C:\Archivos de programa (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Cuenta del sistema local Permite redirigir Microsoft Teams entre el dispositivo de punto final y el escritorio virtual.

Aplicación Citrix Workspace

En el dispositivo de punto final del usuario, la aplicación Citrix Workspace para Windows crea una instancia de un nuevo servicio denominado HdxTeams.exe. Lo hace cuando Microsoft Teams se inicia en el VDA y el usuario intenta llamar o acceder a periféricos en la vista previa automática. Si no ve este servicio, compruebe lo siguiente:

  1. Debe haber instalado como mínimo la versión 1905 de la aplicación Workspace para Windows. ¿Ve HdxTeams.exe y los binarios de webrpc.dll en la ruta de instalación de la aplicación Workspace?
  2. Si validó el paso 1, haga lo siguiente para comprobar si se va a iniciar HdxTeams.exe.
    1. Salga de Microsoft Teams en el VDA.
    2. Inicie services.msc en el VDA.
    3. Detenga Citrix HDX Teams Redirection Service.
    4. Desconecte la sesión ICA.
    5. Conecte la sesión ICA.
    6. Inicie Citrix HDX Teams Redirection Service.
    7. Reinicie Citrix HDX HTML5 Video Redirection Service.
    8. Inicie Microsoft Teams en el VDA.
  3. Si aún no ve que HdxTeams.exe se inicia en el dispositivo de punto final del cliente, haga lo siguiente:
    1. Reinicie el VDA.
    2. Reinicie el dispositivo de punto final del cliente.

Asistencia

Citrix y Microsoft ofrecen soporte conjunto a la entrega de Microsoft Teams desde Citrix Virtual Apps and Desktops mediante la optimización para Microsoft Teams. Este soporte conjunto es el resultado de una estrecha colaboración entre ambas empresas. Si tiene contratos de soporte válidos y sufre problemas con esta solución, abra un tíquet de asistencia con el proveedor cuyo código sospeche que está causando el problema. Es decir, Microsoft si se trata de Teams o Citrix si se trata de los componentes de optimización.

Citrix o Microsoft reciben el tíquet, clasifican el problema y lo escalan según corresponda. No es necesario que se ponga en contacto con el equipo de asistencia de cada empresa.

Cuando tenga un problema, le recomendamos que haga clic en Ayuda > Informar de un problema en la interfaz de usuario de Teams. Los registros del lado del VDA se comparten automáticamente entre Citrix y Microsoft para resolver los problemas técnicos con mayor rapidez.

Recopilar registros

Los registros de HDXTeams.exe se pueden encontrar en la máquina del usuario, en %TEMP%, dentro de la carpeta HDXTeams (AppData/Local/Temp/HDXTeams). Busque un archivo TXT llamado webrpc_día_mes_hora_año.txt.

Al establecer una llamada, se requieren estas cuatro fases ICE:

  • Recopilación de candidatos
  • Intercambio de candidatos
  • Comprobaciones de conectividad (solicitudes de enlace STUN)
  • Promoción de candidatos

En los registros de HDXTeams.exe, las siguientes entradas son las entradas pertinentes del establecimiento interactivo de conectividad (ICE). Estas entradas deben estar allí para que una configuración de llamada se lleve a cabo correctamente (consulte este fragmento de ejemplo para la fase de recopilación):

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 =

webrtcapi.RTCPeerConnection Info: createOffer. audio = 1 video = 1
webrtcapi.RTCPeerConnection Info: setLocalDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveLocalOffer

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Gathering

[…]
>>> begin:sdp
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
<<< end:sdp
[…]
>>> begin:sdp
candidate:1938109490 1 udp 24911871 52.114.xxx.xxx 52786 typ relay raddr 73.205.xxx.x rport 25651 generation 0 ufrag dDML network-id 1 network-cost 10
<<< end:sdp
[…]
>>> begin:sdp
candidate:4271145120 1 udp 1685987071 66.xxx.xxx.xxx 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
<<< end:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Complete webrtcapi.RTCPeerConnection Info: setRemoteDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveRemotelOffer

Si hay varios candidatos de ICE, el orden de preferencia es el siguiente:

  1. Host
  2. par reflexivo
  3. servidor reflexivo
  4. traspaso de transporte

Si encuentra un problema y puede reproducirlo, le recomendamos que haga clic en Ayuda > Informar de un problema en Teams. Citrix y Microsoft comparten los registros para resolver los problemas técnicos si abre un caso con Microsoft. La captura de trazas (seguimiento) de CDF antes de ponerse en contacto con Citrix Support también puede resultar beneficiosa. Para obtener más información, consulte el artículo CDFControl de Knowledge Center.

Para obtener recomendaciones sobre la recopilación de rastreos de CDF, consulte el artículo de Knowledge Center Recomendaciones para recopilar los rastreos de CDF.

Rastreos de CDF del lado de VDA: Habilite los siguientes proveedores de rastreos de CDF:

Rastreos de CDF del lado de VDA

Rastreos de CDF del lado de la aplicación Workspace: Habilite los siguientes proveedores de rastreos de CDF:

Rastreos de CDF del lado de la aplicación Workspace