Optimización para Microsoft Teams

Nota:

Esta función depende de una futura versión de Microsoft Teams. Vamos a actualizar esta descripción a medida que la información sobre la versión y la fecha de publicación estén disponibles.

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 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.

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

Arquitectura

Cómo funciona la optimización para Microsoft Teams

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

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 de red directa por 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 medios HDX admite ICE, Session Traversal Utilities for NAT (STUN) y Traversal Using Relays around NAT (TURN) para la detección de candidatos y el establecimiento de conexiones. Si no hay ruta directa entre los pares, o si el usuario se une a una llamada de varias partes o a una reunión, HDXTeams.exe utiliza un servidor de traspaso de transporte de Microsoft Teams en Azure. La máquina cliente del usuario debe tener acceso a varios rangos de direcciones IP de Azure. Para obtener más información, consulte el diagrama en Sección Arquitectura y Direcciones URL e intervalos de direcciones IP de ID 11 para Office 365.

HDXTeams.exe establece contacto con la nube de traspaso de transporte de Microsoft Teams por la técnica IP Anycast y los puertos UDP entre 3478 y 3481 (diferentes puertos UDP por carga de trabajo, aunque puede ocurrir una multiplexación) y el puerto TCP 443. 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. La mayoría de los fallos de configuración de llamadas son fallos de ICE. Compruebe eso en primer lugar cuando no se pueda completar una llamada. Para obtener más información sobre el proceso de recopilación de candidatos de ICE, consulte “Recopilar registros” en la sección Compatibilidad.

Nota:

Si los dispositivos de punto final no tienen acceso a Internet, es posible que el usuario pueda realizar una llamada de par a par solamente (Meetings fail). En este caso, hay un tiempo de espera de 30 segundos antes de que comience la configuración de la llamada.

Requisitos de la red

Microsoft Teams se basa en servidores de Transport Relay en Azure para reuniones, llamadas entre varias partes y casos en los que dos pares de una llamada de punto a punto no tienen conectividad directa. 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 Compatibilidad.

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 (G.722/OPUS/PCM) 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
Vídeo (en cada sentido) ~ 700 Kbps H264 360p @ 30 fps 16:9
Uso compartido de pantalla ~ 150 Kbps H264 @ 15 fps

Requisitos del sistema

Versión mínima: Virtual Delivery Agents (VDA) 1906 para SO de escritorio Windows:

Sistemas operativos compatibles:

  • Windows 10 de 64 bits, versiones mínimas 1607 hasta 1903.

Requisitos:

  • Microsoft .NET Framework 4.7.1 o una versión posterior se instala automáticamente si no está instalado.
  • Bibliotecas de tiempo de ejecución de Microsoft Visual C++ 2013 y 2015 (de 32 y 64 bits).
  • 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 mínima: Virtual Delivery Agent (VDA) 1906 para SO de servidor:

Sistemas operativos compatibles:

  • Windows Server 2019, 2016 y 2012 R2 (ediciones Standard y Datacenter).

El instalador instala automáticamente los siguientes elementos, que también están disponibles en las carpetas Support de los medios de instalación de Citrix:

  • Microsoft .NET Framework 4.7.1 o una versión posterior se instala automáticamente si no está instalado.
  • Bibliotecas de tiempo de ejecución de Microsoft Visual C++ 2013 y 2015 (de 32 y 64 bits).
  • 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.

Si no ha instalado ni habilitado los roles de Servicios de Escritorio remoto, el instalador los instala y los habilita automáticamente.

Versión mínima: Aplicación Citrix Workspace 1905 para Windows:

  • Windows 7, 8 y 10 (ediciones de 32 y 64 bits, incluida las ediciones Embedded)
  • Requisito del dispositivo de punto final: CPU de cuatro núcleos de aproximadamente 1,8-2,0 GHz que puede admitir una resolución VGA de 360p durante una llamada de conferencia en vídeo de punto a punto.
  • 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.
  • Esta versión de la aplicación Citrix Workspace admite la redirección de audio y vídeo (punto a punto o conferencia) y el uso compartido entrante de pantalla. La aplicación Citrix Workspace 1905 para Windows no admite el uso compartido saliente de pantalla. La versión 1907 y las versiones posteriores admiten el uso compartido saliente de pantalla.

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. 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 la directiva está habilitada 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.

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.

Nota:

Se recomiendan auriculares certificados por Microsoft Teams eliminación de eco integrada. En configuraciones con varios periféricos, donde el micrófono y los altavoces se encuentran en dispositivos separados (por ejemplo, una cámara web con un micrófono incorporado y un monitor con altavoces), puede producirse eco. 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.

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.

    La diferencia más significativa es el nombre de la cámara. Si Microsoft Teams se carga en modo no optimizado, se inician las tecnologías HDX heredadas y 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 diferentes en comparación 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.

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.

    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, es posible que las conexiones circulen por un servidor proxy asignado. Esta situación puede producirse aunque haya activado la opción Omitir servidor proxy para las direcciones locales. Para omitir localhost, especifique la dirección 127.0.0.1 en la lista de excepciones del proxy. La lista de excepciones se encuentra en Internet Explorer 11 > Herramientas > Opciones de Internet > Conexiones > Configuración de LAN > Opciones avanzadas > Excepciones.

Ubicaciones y descripciones de servicios

Servicio Ruta al archivo ejecutable Iniciar sesión como Descripción
Citrix HTML5 Video Redirection Service “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.
Citrix HDX Browser Redirection Service “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.
Citrix Port Forwarding Service “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.
Citrix HDX Teams Redirection Service “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 cuando Microsoft Teams se inicia en el VDA y el usuario intenta realizar una llamada o acceder a los periféricos en la vista previa propia. 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.

Compatibilidad

Citrix y Microsoft ofrece 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.

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.

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

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 tiene un problema y puede reproducirlo de forma coherente, le recomendamos capturar el rastreo de CDF antes de ponerse en contacto con Asistencia técnica. 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