Citrix Virtual Apps and Desktops

Otimização para Microsoft Teams

Importante:

O mecanismo de mídia WebRTC no aplicativo Workspace para Windows 2009.6 e Linux 2009 foi renomeado de HdxTeams.exe para HdxRtcEngine.exe

A Citrix oferece otimização para Microsoft Teams baseados em desktop (1.2.00.31357 ou superior) usando o Citrix Virtual Apps and Desktops e o aplicativo Citrix Workspace. Por padrão, agrupamos todos os componentes necessários no aplicativo Citrix Workspace e no Virtual Delivery Agent (VDA).

Nossa otimização para o Microsoft Teams contém serviços HDX do lado do VDA e API para fazer interface com o aplicativo hospedado do Microsoft Teams para receber comandos. Esses componentes abrem um canal virtual de controle (CTXMTOP) para o mecanismo de mídia do lado do aplicativo Citrix Workspace. O ponto de extremidade decodifica e renderiza a multimídia localmente, movendo a janela do aplicativo Citrix Workspace de volta para o aplicativo Microsoft Teams hospedado.

A autenticação e a sinalização ocorrem de forma nativa no aplicativo hospedado pelo Microsoft Teams, assim como os outros serviços do Microsoft Teams (por exemplo, chat ou colaboração). O redirecionamento de áudio/vídeo não os afeta.

O CTXMTOP é um comando e controle de canal virtual. Isso significa que não há troca de mídia entre o aplicativo Citrix Workspace e o VDA.

Apenas a busca de cliente/renderização do cliente está disponível.

Esta demonstração de vídeo oferece uma ideia de como o Microsoft Teams funciona em um ambiente virtual Citrix.

Demonstração de otimização para Microsoft Teams

Instalação do Microsoft Teams

Nota:

Recomendamos instalar o VDA antes de instalar o Microsoft Teams na imagem de ouro. Esta ordem de instalação é necessária para que o sinalizador ALLUSER=1 tenha efeito. Se a máquina virtual tiver o Microsoft Teams instalado antes que o VDA seja instalado, desinstale e reinstale o Microsoft Teams. Se você estiver usando App Layering, consulte as instruções de App Layering no final desta seção para obter mais detalhes.

Recomendamos que você siga as Diretrizes de instalação em todo o computador do Microsoft Teams e evite usar o instalador .exe que instala o Microsoft Teams no AppData. Em vez disso, instale em C:\Program Files (x86)\Microsoft\Teams usando o sinalizador ALLUSER=1 da linha de comando.

msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSER=1 ALLUSERS=1

Este exemplo também usa o parâmetro ALLUSERS=1. Quando você define esse parâmetro, o Instalador do Teams Machine-Wide aparece em Programas e Recursos no Painel de Controle e em Aplicativos e recursos nas Configurações do Windows para todos os usuários do computador. Todos os usuários podem desinstalar o Teams se tiverem credenciais de administrador. É importante entender a diferença entre ALLUSERS=1 e ALLUSER=1. Você pode usar o parâmetro ALLUSERS=1 em ambientes não-VDI e VDI. Use o parâmetro ALLUSER=1 somente em ambientes VDI para especificar uma instalação por máquina.

No modo ALLUSER=1, o aplicativo Microsoft Teams não é atualizado automaticamente sempre que houver uma nova versão. Recomendamos este modo para ambientes não persistentes. Por exemplo, aplicativos ou desktops compartilhados hospedados fora de um Windows Server ou catálogos aleatórios/agrupados do Windows 10. Para obter mais informações, consulte Instalar o Microsoft Teams usando MSI (seção Instalação da VDI).

Você tem o Windows 10 ambientes VDI persistentes dedicados. Você deseja que o aplicativo Microsoft Teams seja atualizado automaticamente e prefere que o Microsoft Teams seja instalado para cada usuário em Appdata/Local, use o .exe instalador ou o MSI sem ALLUSER=1.

Para App Layering:

Aviso:

Editar o registro incorretamente pode causar sérios problemas que podem exigir a reinstalação do sistema operacional. A Citrix não pode garantir que os problemas resultantes do uso incorreto do Editor do Registro possam ser resolvidos. Use o Editor do Registro por sua conta e risco. Tenha o cuidado de fazer backup do registro antes de editá-lo.

Crie uma chave de registro vazia chamada PortICA (deixe os valores padrão de Nome, Tipo e Dados).

Se estiver usando o Citrix App Layering para gerenciar instalações VDA e Microsoft Teams em diferentes camadas, implante essa chave de registro no Windows antes de instalar o Microsoft Teams com ALLUSER =1:

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\PortICA

Ou

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\PortICA

Recomendações de gerenciamento de perfis

Recomendamos usar o instalador em toda o computador para ambientes Windows Server e VDI em pool no Windows 10.

Quando o sinalizador ALLUSER =1 é passado para o MSI a partir da linha de comando (o instalador em todo o computador), o aplicativo Microsoft Teams é instalado em C:\Program Files (x86) (~300 MB). O aplicativo usa AppData\Local\Microsoft\TeamsMeetingAddin para logs e AppData\Roaming\Microsoft\Teams (~600—700 MB) para configurações específicas do usuário, cache de elementos na interface do usuário e assim por diante.

Instalador em todo o computador

Veja a seguir um exemplo de pastas, atalhos de área de trabalho e registros criados com a instalação do instalador do Microsoft Teams em todo o computador em uma VM de 64 bits do Windows Server 2016:

Pasta:

  • C:\Program Files (x86)\Microsoft\Teams
  • C:\Users\<username>\AppData\Roaming\Microsoft\Teams

Atalho da área de trabalho:

C:\Program Files (x86)\Microsoft\Teams\current\Teams.exe

Registro:

  • HKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run
  • HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows\CurrentVersion\Run
  • HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run

Recomendações, em Recommendations

  • Recomendamos desativar o início automático excluindo as chaves de registro do Microsoft Teams. Isso impede que “tempestades de logon às 8 da manhã” sobrecarreguem a CPU da VM.
  • Se o Virtual Desktop não tiver uma GPU/vGPU, recomendamos a configuração Desabilitar a aceleração de hardware GPU nas Configurações do Microsoft Teams para melhorar o desempenho. Esta configuração ("disableGpu":true) é armazenada em %Appdata%\Microsoft\Teams dentro do arquivo desktop-config.json. Você pode usar um script de logon para editar esse arquivo e definir o valor como true.
  • Se estiver usando o Citrix Workspace Environment Management (WEM), ative o CPU Spikes Protection para gerenciar o consumo do processador para o Microsoft Teams.

Importante:

Se você não passar o sinalizador ALLUSER=1, o MSI coloca o instalador Teams.exe e setup.json em C:\Program Files (x86)\Teams Installer. Uma chave de registro (TeamsMachineInstaller) é adicionada em: HKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run

Um logon de usuário subsequente aciona a instalação final em AppData, em vez disso.

Instalador por usuário

Ao usar o instalador .exe, o processo de instalação muda significativamente, e todos os arquivos são colocados no AppData.

Pasta:

  • C:\Users\<username>\AppData\Local\Microsoft\Teams
  • C:\Users\<username>\AppData\Local\Microsoft\TeamsPresenceAddin
  • C:\Users\<username>\AppData\Local\Microsoft\TeamsMeetingAddin
  • C:\Users\<username>\AppData\Local\SquirrelTemp
  • C:\Users\<username>\AppData\Roaming\Microsoft\Teams

Atalho da área de trabalho:

C:\Users\<username>\AppData\Local\Microsoft\Teams\Update.exe --processStart "Teams.exe"

Registro:

HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run

Melhores práticas

As recomendações de práticas recomendadas baseiam-se nos cenários de caso de uso. O uso do Microsoft Teams com uma configuração não persistente requer um gerenciador de cache de perfil para uma sincronização eficiente de dados de tempo de execução do Microsoft Teams. A presença de um gerenciador de cache de perfis garante que as informações específicas do usuário apropriadas (por exemplo, dados do usuário, perfil e configurações) sejam armazenadas em cache durante a sessão do usuário. Tenha o cuidado de sincronizar os dados nestas duas pastas:

  • C:\Users\<username>\AppData\Local\Microsoft\IdentityCache
  • C:\Users\<username>\AppData\Roaming\Microsoft\Teams

Lista de exclusão de conteúdo armazenado em cache de equipes para configuração não persistente:

Exclua os seguintes itens da pasta de cache do Teams %AppData%/Microsoft/Teams. A exclusão desses itens ajuda a reduzir o tamanho do cache do usuário para otimizar ainda mais sua configuração não persistente.

Lista de exclusão - arquivos

  • Roaming\Microsoft\Teams\* .txt

Lista de exclusão - diretórios

  • Roaming\Microsoft\Teams\Logs
  • Roaming\Microsoft\Teams\media-stack
  • Roaming\Microsoft\Teams\Service Worker\CacheStorage
  • Roaming\Microsoft\Teams\Application Cache
  • Roaming\Microsoft\Teams\Cache
  • Roaming\Microsoft\Teams\GPUCache
  • Roaming\Microsoft\Teams\meeting-addin\Cache (crítico para problemas em que o suplemento está faltando no Outlook)

Caso de uso: cenário de sessão única:

Nesse cenário, o usuário final usa o Microsoft Teams em um local de cada vez. Não há necessidade de executar o Teams em duas sessões diferentes do Windows simultaneamente. Por exemplo, em uma implantação comum de desktop virtual, cada usuário é atribuído a um desktop e o Teams é implantado dentro da área de trabalho virtual como um aplicativo. Recomendamos ativar o contêiner Citrix Profile e redirecionar os diretórios por usuário mencionados anteriormente para o contêiner.

  1. Implante o instalador de toda a máquina do Microsoft Teams (ALLUSER=1) na imagem dourada.
  2. Ative o Citrix Profile Management e configure o armazenamento de perfis de usuário com as permissões apropriadas.
  3. Ative a seguinte configuração de política de Gerenciamento de perfis: File system > Synchronization > Profile container — Lista de pastas que devem estar no disco de perfil.

    Contêiner de perfil

    Liste todas as pastas mencionadas anteriormente nesta configuração. Como alternativa, você também pode configurar essas configurações usando o serviço Citrix Workspace Environment Management (WEM).

  4. Aplique as configurações ao grupo de entrega correto.
  5. Faça login para validar a implantação.

Requisitos do sistema

Versão mínima recomendada - Delivery Controller (DDCs) 1906.2 (Se você estiver usando uma versão anterior, consulte Ativar a otimização do Microsoft Teams):

Sistemas operacionais compatíveis:

  • Windows Server 2019, 2016, 2012R2, edições padrão e datacenter e com a opção Server Core

Versão mínima - Virtual Delivery Agents (VDAs) 1906.2:

Sistemas operacionais compatíveis:

  • Windows 10 64-bit, versões 1607 e superiores. (Aplicativos hospedados em VM não são compatíveis).
  • Windows Server 2019, 2016 e 2012 R2 (edições padrão e datacenter).

Requisitos:

  • BCR_x64.msi - o MSI que contém o código de otimização do Microsoft Teams e inicia automaticamente a partir da GUI. Se você estiver usando a interface de linha de comando para a instalação do VDA, não a exclua.

Versão recomendada — aplicativo Citrix Workspace para Windows mais recente CR e versão mínima - Citrix Workspace app 1907 para Windows:

  • Windows 8 e 10 (edições de 32 bits e 64 bits, incluindo edições incorporadas) (o suporte para Windows 7 foi interrompido a partir da versão 2006)
  • Windows 10 IoT Enterprise 2016 LTSB (v1607) e 2019 LTSC (v1809)
  • Arquiteturas do processador (CPU) suportadas: x86 e x64 (o ARM não é suportado)
  • Requisito de ponto de extremidade: CPU dual core de aproximadamente 2,2 a 2,4 GHz que pode dar suporte à resolução HD 720p durante uma chamada de videoconferência ponto a ponto.
  • CPUs de núcleo duplo ou quádruplo com velocidades de base mais baixas (~ 1,5 GHz) equipadas com Intel Turbo Boost ou AMD Turbo Core que podem aumentar até pelo menos 2,4 GHz.
  • Clientes finos HP verificados: t630/t640, t730/t740, mt44/mt45.
  • Clientes finos Dell verificados: 5070, 5470 Mobile TC.
  • Clientes finos 10ZiG verificados: 4510 e 5810q.
  • Para obter uma lista completa de pontos de extremidade verificados, consulte Clientes finos.
  • O aplicativo Citrix Workspace requer um mínimo de 600 MB de espaço livre em disco e 1 GB de RAM.
  • O requisito mínimo do Microsoft .NET Framework é a versão 4.6.2. O aplicativo Citrix Workspace baixa e instala automaticamente o .NET Framework se não estiver presente no sistema.

Versão mínima - aplicativo Citrix Workspace 2006 para Linux:

Para obter mais informações, consulte Otimização para Microsoft Teams em O que há de novo em 2006.

Software:

  • GStreamer 1.0 ou posterior ou Cairo 2
  • libc++-9.0 ou posterior
  • libgdk 3.22 ou posterior
  • OpenSSL 1.1.1d
  • Distribuição Linux x64

Hardware:

  • CPU dual-core mínima de 1,8 GHz que possa dar suporte a resolução HD 720p durante uma chamada de videoconferência ponto a ponto.
  • CPU dual ou quad-core com uma velocidade base de 1,8 GHz e uma alta velocidade Intel Turbo Boost de pelo menos 2,9 GHz.
  • Para obter uma lista completa de pontos de extremidade verificados, consulte Clientes finos.

Para obter mais informações, consulte Pré-requisitos para instalar o aplicativo Citrix Workspace.

Você pode desativar a otimização de equipes alterando o valor do campo VDWEBRTC para Off no arquivo /opt/Citrix/ICAClient/config/module.ini. O padrão é VDWEBRTC=On. Depois de executar a atualização, reinicie a Sessão. (É necessária permissão raiz).

Versão mínima - Aplicativo Citrix Workspace 2012 para Mac:

Sistemas operacionais compatíveis

  • macOS Catalina (10.15)
  • macOS Big Sur Beta 8 apenas em ambientes de teste. Não use em ambientes de produção.

Recursos suportados:

  • Áudio
  • Vídeo
  • Otimização de compartilhamento de tela (entrada e saída)

A otimização do Microsoft Teams funciona por padrão se o usuário tiver o aplicativo Citrix Workspace 2012 ou posterior e o macOS 10.15.

Se você deseja desativar a otimização do Microsoft Teams, execute este comando no terminal e reinicie o aplicativo Workspace:

defaults write com.citrix.receiver.nomas mtopEnabled -bool NO

Ativar a otimização do Microsoft Teams

Para habilitar a otimização para o Microsoft Teams, use a política do Studio descrita em Política de redirecionamento do Microsoft Teams (ela está ATIVADA por padrão). Além da ativação dessa política, o HDX verifica se a versão do aplicativo Citrix Workspace é igual ou maior que a versão mínima necessária. Se você habilitou a política e a versão do aplicativo Citrix Workspace for suportada, HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport é definida como 1 automaticamente no VDA. O aplicativo Microsoft Teams lê a chave a ser carregada no modo de VDI.

Nota:

Se você estiver usando a versão 1906.2 VDAs ou superior com versões mais antigas do Controller (por exemplo, versão 7.15), que não têm a política disponível no Studio, você ainda pode realizar a otimização porque a otimização HDX para o Microsoft Teams está habilitada por padrão no VDA.

Se você clicar em About > Version, a legenda Citrix HDX Optimized exibirá:

Legenda Otimizado para Citrix

Se você vir o Citrix HDX Not Connected, a API Citrix será carregada no Microsoft Teams (que é o primeiro passo para o redirecionamento), mas terá ocorrido um erro nas partes subsequentes da pilha. O erro é mais provável nos serviços VDA ou no aplicativo Citrix Workspace).

Legenda Não otimizado para Citrix

Se você não vir nenhuma legenda, isso indica que o Teams não conseguiu carregar a API Citrix. Saia do Teams clicando com o botão direito no ícone da área de notificação e reinicie. Verifique se a política do Studio não está definida como Prohibited e se a versão do aplicativo Citrix Workspace é suportada.

Sem legenda da Citrix

Requisitos de rede

O Microsoft Teams conta com servidores de Processador de Mídia no Office 365 para reuniões ou chamadas multipartes. O Microsoft Teams usa retransmissões de transporte do Office 365 para estes cenários:

  • Dois pares em uma chamada ponto a ponto não têm conectividade direta
  • Um participante não tem conectividade direta com o processador de mídia.

Portanto, a integridade da rede entre o par e a nuvem do Office 365 determina o desempenho da chamada.

Recomendamos avaliar seu ambiente para identificar os riscos e requisitos que possam influenciar sua implantação geral de voz e vídeo na nuvem. Use a Ferramenta de avaliação de rede do Skype for Business para testar se sua rede está pronta para o Microsoft Teams. Para obter informações sobre suporte, consulte Suporte.

Resumo das principais recomendações de rede para o tráfego RTP (Real Time Protocol):

  • Conecte-se à rede do Office 365 o mais diretamente possível a partir da filial.
  • Se você precisar usar qualquer um dos itens a seguir na filial, verifique se o tráfego das equipes RTP/UDP está desimpedido. O mecanismo de mídia WebRTC do aplicativo Workspace não honra proxies explícitos (ou arquivos PAC) configurados no ponto de extremidade.
    • Ignorar servidores proxy
    • Interceptação SSL de rede
    • Dispositivos de inspeção profunda de pacotes
    • VPN hairpin (use tunelamento dividido, se possível)
  • Planeje e forneça largura de banda suficiente.
  • Verifique se há conectividade e qualidade de rede em cada filial.

O mecanismo de mídia WebRTC no aplicativo Workspace (HdxTeams.exe ou HdxRtcEngine.exe) usa o SRTP (Secure Real-Time Transport Protocol) para fluxos multimídia que são descarregados para o cliente. O SRTP fornece confidencialidade e autenticação ao RTP usando chaves simétricas (128 bits) para criptografar mídia e mensagens de controle e usa a cifra de criptografia AES no modo de contador.

As seguintes métricas são recomendadas para garantir uma experiência positiva do usuário:

Métrica Ponto de extremidade para o Office 365
Latência (um sentido) < 50 ms
Latência (RTT) < 100 ms
Perda de pacote < 1% durante um intervalo de 15s
Jitter entre chegada de pacotes <30ms durante um intervalo de 15s

Para obter mais informações, consulte Preparar a rede da sua organização para o Microsoft Teams.

Em termos de requisitos de largura de banda, a otimização para o Microsoft Teams pode usar uma grande variedade de codecs para áudio (OPUS/G.722/PCM G711) e vídeo (H264).

Os pares negociam estes codecs durante o processo do estabelecimento de chamada usando a oferta/resposta do Session Description Protocol (SDP). As recomendações mínimas da Citrix são:

Tipo Largura de banda Codec
Áudio (em cada sentido) ~ 90 kbps G.722
Áudio (em cada sentido) ~ 60 kbps Opus*
Vídeo (em cada sentido) ~ 700 kbps H264 360p a 30 fps 16:9
Compartilhamento de tela ~ 300 kbps H264 1080p a 15 fps

* O Opus suporta codificação de taxa de bits constante e variável de 6 kbps até 510 kbps.

O Opus é os codecs preferidos para chamadas ponto a ponto entre dois usuários de VDI otimizados.

G.722 e H264 são os codecs preferidos para um usuário de VDI que participe de uma reunião.

Servidores proxy

Dependendo da localização do proxy, considere o seguinte:

  • Configuração de proxy no VDA:

    Se você configurar servidor proxy explícito no VDA e encaminhar conexões para localhost por meio de um proxy, o redirecionamento falhará. Para configurar o proxy corretamente, você deve selecionar a configuração Bypass proxy servers for local address em Internet Options > Connections > LAN Settings > Proxy Servers e verifique se 127.0.0.1:9002 é ignorado.

    Se você usar um arquivo PAC, o script de configuração do proxy VDA do arquivo PAC deverá retornar DIRECT para wss://127.0.0.1:9002. Caso contrário, a otimização falhará. Para garantir que o script retorne DIRECT, use shExpMatch(url, "wss://127.0.0.1:9002/*").

  • Configuração de proxy no aplicativo Citrix Workspace:

    Se a filial estiver configurada para acessar a Internet por meio de um proxy, o aplicativo Citrix Workspace para Windows versão 2012 (Negotiate/Kerberos, NTLM, Basic e Digest), o aplicativo Citrix Workspace para Linux versão 2101 (autenticação anônima) e o aplicativo Citrix Workspace para Mac versão 2104 (autenticação anônima) suporte a servidores proxy. Dispositivos cliente com versões anteriores do aplicativo Citrix Workspace não conseguem ler configurações de proxy. Esses dispositivos enviam tráfego diretamente para servidores do Office 365 TURN.

    Importante:

    Verifique se o dispositivo cliente pode se conectar ao servidor DNS para executar resoluções de DNS. Um dispositivo cliente deve ser capaz de resolver três FQDNs do servidor Microsoft Teams TURN: worldaz.turn.teams.microsoft.com, usaz.turn.teams.microsoft.com e euaz.turn.teams.microsoft.com.

Estabelecimento de chamadas e caminhos de fluxo de mídia

Quando possível, o mecanismo de mídia HDX WebRTC no aplicativo Citrix Workspace (HdxTeams.exe ou HdxRtcEngine.exe) tenta estabelecer uma conexão SRTP (Secure Real-Time Transport Protocol) de rede direta via User Datagram Protocol (UDP) em uma chamada ponto a ponto. Se as portas UDP estiverem bloqueadas, o mecanismo de mídia recorre ao TCP 443.

O mecanismo de mídia HDX dá suporte a ICE, Session Traversal Utilities for NAT (STUN) e Traversal usando relés em torno de NAT (TURN) para descoberta de candidatos e estabelecimento de conexão.

Note que isto significa que o ponto de extremidade deve poder executar resoluções DNS.

Se não houver caminho direto entre os dois pares ou entre um par e um servidor de conferência (se o usuário estiver participando de uma chamada ou reunião com vários participantes), o mecanismo de mídia usará um servidor de retransmissão de transporte do Microsoft Teams no Office 365 para alcançar o outro par ou o processador de mídia (onde as reuniões são hospedadas). O computador cliente do usuário deve ter acesso a dois intervalos de endereços IP de sub-rede do Office 365 e a 4 portas UDP. Para obter mais informações, consulte o diagrama de arquitetura na “Configuração de chamada” e URLs e intervalos de endereços IP do Office 365 ID 11.

ID Categoria Endereços Portas de destino
11 Otimização necessária 13.107.64.0/18, 52.112.0.0/14, 52.120.0.0/14 UDP: 3478, 3479, 3480, 3481, TCP: 443 (fallback)

Esses intervalos contêm relés de transporte e processadores de mídia. Os relés de transporte de equipes fornecem funcionalidade STUN e TURN, mas não são pontos de extremidade ICE. Além disso, as retransmissões de transporte do Teams não terminam a mídia nem realizam nenhuma transcodificação. Eles podem fazer a ponte TCP (se o mecanismo de mídia usar TCP) para o UDP quando encaminham o tráfego para outros pares ou processadores de mídia.

O mecanismo de mídia WebRTC do aplicativo Workspace entra em contato com a retransmissão de transporte do Microsoft Teams mais próxima na nuvem do Office 365. O mecanismo de mídia usa IP anycast e porta 3478—3481 UDP (portas UDP diferentes por carga de trabalho, embora possa haver multiplexação) ou 443 TCP TLSv1.2 para fallbacks. A qualidade da chamada depende do protocolo de rede subjacente. Como o UDP é sempre recomendado por TCP, aconselhamos você a projetar suas redes para acomodar o tráfego UDP na filial.

Se o Teams carregado no modo otimizado e o mecanismo de mídia WebRTC do aplicativo Workspace estiver sendo executado no ponto de extremidade, as falhas de ICE (Interactive Connectivity Establishment) poderão causar uma falha na configuração de chamadas ou áudio/vídeo somente de um sentido. Quando um atendimento não pode ser concluído ou os fluxos de mídia não forem full duplex, verifique primeiramente o rastreamento Wireshark no ponto de extremidade. Para obter mais informações sobre o processo de coleta do candidato ICE, consulte “Coletando logs” na seção Suporte.

Nota:

Se os pontos de extremidade não tiverem acesso à Internet, pode ainda ser possível que o usuário faça uma chamada ponto a ponto somente se estiverem na mesma LAN. As reuniões não ocorrem. Neste caso, há um intervalo de 30 segundos antes que a configuração de chamada comece.

Configuração de chamada

Use este diagrama de arquitetura como uma referência visual para a sequência de fluxo de chamadas. As etapas correspondentes são indicadas no diagrama.

Arquitetura:

Como funciona a otimização para o Microsoft Teams

  1. Inicie o Microsoft Teams.
  2. O Teams se autentica no O365. As políticas de locatário são enviadas para o cliente Teams e as informações relevantes do canal de sinalização e TURN são retransmitidas para o aplicativo.
  3. O Teams detecta que ele está sendo executado em um VDA e faz chamadas de API para a API JavaScript Citrix.
  4. O Citrix JavaScript no Teams abre uma conexão segura do WebSocket ao WebSocketService.exe em execução no VDA, que gera WebSocketAgent.exe dentro da sessão do usuário.
  5. O WebSocketAgent.exe instancia um canal virtual genérico ligando para o Citrix HDX Teams Redirection Service (CtxSvcHost.exe).
  6. O wfica32.exe (mecanismo HDX) do aplicativo Citrix Workspace gera um novo processo chamado HdxTeams.exe ou HdxRtcEngine.exe, que é o novo mecanismo WebRTC usado para a otimização do Teams.
  7. O mecanismo de mídia Citrix e o Teams.exe têm um caminho de canal virtual bidirecional e podem iniciar o processamento de solicitações de multimídia.

    —–Chamadas do usuário——

  8. O par A clica no botão de chamada. Teams.exe se comunica com os serviços Teams no Office 365 estabelecendo um caminho de sinalização de ponta a ponta com o Peer B. O Teams pede ao mecanismo de mídia do aplicativo Citrix Workspace uma série de parâmetros de chamada compatíveis (codecs, resoluções e assim por diante, que é conhecida como oferta SDP (Session Description Protocol)). Esses parâmetros de chamada são retransmitidos usando o caminho de sinalização para os serviços de equipes no Office 365 e daí para o outro par.
  9. A oferta/resposta SDP (negociação de passagem única) ocorre através do canal de sinalização e quando são concluídas as verificações de conectividade ICE (travessia de NAT e firewall por meio de utilitários de travessia de sessão para solicitações de ligação NAT (STUN)). Então, a mídia Secure Real-Time Transport Protocol (SRTP) flui diretamente entre HdxTeams.exe e o outro par (ou Office 365, se for uma reunião).

Sistema de Telefonia da Microsoft

O Sistema de Telefonia é a tecnologia da Microsoft que permite o controle de chamadas e os recursos de PBX na nuvem do Office 365 com o Microsoft Teams. A Otimização para Microsoft Teams oferece suporte ao sistema de telefonia com planos de chamadas do Office 365 ou roteamento direto Com o roteamento direto, você conecta seu próprio controlador de borda de sessão suportado ao sistema de telefonia Microsoft diretamente sem nenhum software local adicional.

Considerações sobre o firewall

Quando os usuários iniciam uma chamada otimizada usando o cliente Microsoft Teams pela primeira vez, eles podem notar um aviso com as configurações de firewall do Windows. O aviso pede aos usuários para permitir a comunicação para HdxTeams.exe ou HdxRtcEngine.exe (HDX Overlay Teams).

Aviso de firewall

As quatro entradas a seguir são adicionadas em Regras de Entrada no console Firewall do Windows Defender > Segurança Avançada. Você pode aplicar regras mais restritivas, se desejar.

Regras de entrada de firewall

Coexistência do Microsoft Teams e Skype for Business

Você pode implantar o Microsoft Teams e o Skype for Business lado a lado, como duas soluções separadas com recursos sobrepostos. Para obter mais informações, consulte Compreender a coexistência e a interoperabilidade do Microsoft Teams e do Skype for Business.

O Citrix RealTime Optimization Pack e a otimização HDX para os mecanismos multimídia dos Teams honram qualquer configuração definida em seu ambiente (por exemplo, modos ilha, colaboração do Skype for Business com o Teams, colaboração e reuniões do Skype for Business com o Teams).

O acesso periférico só pode ser concedido a um único aplicativo no momento. Por exemplo, o acesso à webcam pelo RealTime Media Engine durante uma chamada bloqueia o dispositivo de imagem durante uma chamada. Quando o dispositivo é liberado, ele fica disponível para o Teams.

Coexistência do Teams e Skype

Citrix SD-WAN: conectividade de rede otimizada para Microsoft Teams

A qualidade ideal de áudio e vídeo requer uma conexão de rede com a nuvem do Office 365 que tenha baixa latência, baixo jitter e baixa perda de pacotes. O backhauling do tráfego RTP de áudio-vídeo do Microsoft Teams dos usuários do aplicativo Citrix Workspace em locais de filiais para um data center antes de ir à Internet pode adicionar latência excessiva e também causar congestionamento em links WAN. O Citrix SD-WAN otimiza a conectividade para o Microsoft Teams seguindo os princípios de conectividade de rede do Microsoft Office 365. O Citrix SD-WAN usa o endereço IP e o serviço Web do Office 365 baseado em Microsoft REST e o DNS próximo para identificar, categorizar e orientar o tráfego do Microsoft Teams.

As conexões de internet de banda larga de negócios em muitas áreas sofrem de perda intermitente de pacotes, períodos de jitter excessivo e interrupções.

O Citrix SD-WAN oferece duas soluções para preservar a qualidade de áudio-vídeo do Microsoft Teams quando a integridade da rede é variável ou está degradada.

  • Se você usar o Microsoft Azure, um Appliance Virtual (VPX) Citrix SD-WAN implantado no Azure VNET fornece otimizações avançadas de conectividade. Essas otimizações incluem failover de link integrado e corridas de pacotes de áudio.
  • Como alternativa, os clientes do Citrix SD-WAN podem se conectar ao Office 365 por meio do serviço Citrix Cloud Direct. Este serviço fornece entrega confiável e segura para todo o tráfego direcionado à Internet.

Se a qualidade da conexão com a Internet da filial não for um problema, talvez seja suficiente minimizar a latência direcionando o tráfego do Microsoft Teams diretamente do dispositivo da filial Citrix SD-WAN para a porta da frente do Office 365 mais próxima. Para obter mais informações, consulte Otimização do Citrix SD-WAN Office 365.

Citrix SD-WAN

Exibição de galeria e alto-falantes ativos no Microsoft Teams

O Microsoft Teams oferece suporte a layouts de Gallery, Large gallery e Together mode.

O Microsoft Teams exibe uma grade 2x2 com fluxos de vídeo de quatro participantes (conhecidos como Gallery). Nesse caso, o Teams envia quatro fluxos de vídeo para o dispositivo cliente para decodificação. Quando há mais de quatro participantes que compartilham vídeo, apenas os últimos palestrantes mais ativos aparecem na tela.

O Microsoft Teams também fornece a grande visualização da galeria com uma grade de até 7x7. Como resultado, o servidor de conferência do Teams compõe um único feed de vídeo e o envia para o dispositivo cliente para decodificação, resultando em menor consumo de CPU. Esse único feed “Hollywood Square” também pode incluir o vídeo de visualização automática do usuário.

Por fim, o Microsoft Teams suporta o Together mode, que faz parte da nova experiência de reunião. Usando a tecnologia de segmentação de IA para colocar digitalmente os participantes em um histórico compartilhado, o Teams coloca todos os participantes no mesmo auditório.

O usuário pode controlar esses modos durante uma chamada em conferência selecionando layouts de Gallery, Large gallery ou Together mode no menu de reticências.

Layout de vídeo

Compartilhamento de tela no Microsoft Teams

O Microsoft Teams conta com o compartilhamento de tela baseado em vídeo (VBSS), codificando efetivamente a área de trabalho que está sendo compartilhada com codecs de vídeo como o H264 e criando um fluxo de alta definição. Com a otimização HDX, o compartilhamento de tela de entrada é tratado como um fluxo de vídeo. Portanto, se você estiver no meio de uma chamada de vídeo e o outro par começar a compartilhar a área de trabalho, esse feed de vídeo original da câmera será pausado. Em vez disso, o feed de vídeo de compartilhamento de tela é exibido. O par deve então retomar manualmente o compartilhamento da câmera.

O compartilhamento de tela de saída também é otimizado e descarregado para o aplicativo Citrix Workspace (versão 1907 ou superior). Nesse caso, o mecanismo de mídia captura e transmite apenas a janela Citrix Desktop Viewer (CDViewer.exe). Se você quiser compartilhar um aplicativo local em execução em sua máquina cliente, você pode sobrepô-lo em cima do CDViewer e também é capturado.

O aplicativo Citrix Workspace 2009.6 para Windows faz captura nativa de bitmap da janela, portanto, nenhuma janela sobreposta é capturada.

Multi-monitor: Nos casos em que o CDViewer está no modo de tela cheia e se estende por configurações de vários monitores, somente o monitor principal é compartilhado. Os usuários devem arrastar o aplicativo de interesse dentro da área de trabalho virtual para o monitor primário para o outro par na chamada vê-lo.

Compartilhamento de tela

Nota:

Se você estiver publicando o Teams como um aplicativo integrado independente, o compartilhamento de tela capturará a área de trabalho local do seu endpoint físico no aplicativo Citrix Workspace versão mínima 1909.

Periféricos no Microsoft Teams

Quando a otimização do Microsoft Teams está ativa, o aplicativo Citrix Workspace acessa os periféricos (fone de ouvido, microfone, câmeras, alto-falantes e assim por diante). Em seguida, os periféricos são enumerados devidamente na interface do usuário do Microsoft Teams (Configurações > Dispositivos).

Modo de otimização para Microsoft Teams

O Microsoft Teams não acessa os dispositivos diretamente. Em vez disso, ele usa o mecanismo de mídia WebRTC do aplicativo Workspace para adquirir, capturar e processar a mídia. O Microsoft Teams lista os dispositivos para o usuário selecionar.

Recomendações:

  • Headsets certificados pelo Microsoft Teams com cancelamento de eco integrado. Em configurações com vários periféricos, onde microfone e alto-falantes estão em dispositivos separados, pode ocorrer eco. Por exemplo, uma webcam com um microfone embutido e um monitor com alto-falantes. Ao usar alto-falantes externos, coloque-os o mais longe possível do microfone e de qualquer superfície que possa refratar o som no microfone.
  • Câmeras certificadas pelo Microsoft Teams, embora os periféricos certificados pelo Skype for Business sejam compatíveis com o Microsoft Teams.
  • O mecanismo de mídia do aplicativo Citrix Workspace não pode aproveitar o descarregamento de CPU com webcams que executam codificação H.264 integrada - UVC 1.1 e 1.5.

Nota:

O aplicativo Workspace 2009.6 para Windows agora pode adquirir periféricos com formatos de áudio com 24 bits ou com frequências acima de 96 kHz.

O HdxTeams.exe (no aplicativo Workspace para Windows 2009 ou mais antigo) suporta apenas esses formatos de dispositivo de áudio específicos (canais, profundidade de bits e taxa de amostragem):

  • Dispositivos de reprodução: até 2 canais, 16 bits, frequências de até 96.000 Hz
  • Dispositivos de gravação: até 4 canais, 16 bits, frequências de até 96.000 Hz

Mesmo que um alto-falante ou microfone não corresponda às configurações esperadas, a enumeração de dispositivos no Teams falha e Nenhum é exibido em Configurações > Dispositivos.

Webrpc apresenta logs em HdxTeams.exe que mostram este tipo de informação:

Mar 27 20:58:22.885 webrtcapi.WebRTCEngine Info: init. initializing...

Mar 27 20:58:23.190 webrtcapi.WebRTCEngine Error: init. couldn't create audio module!

Como solução alternativa, abra o Painel de Controle do Som (mmsys.cpl), selecione o dispositivo de reprodução ou gravação, vá para Propriedades > Avançado e altere as configurações para um modo com suporte. Alternativamente, desative o dispositivo específico.

Modo de fallback

Se o Microsoft Teams não carregar no modo VDI otimizado (“Citrix HDX Not Connected” em Teams/Sobre/Versãp), o VDA volta às tecnologias HDX herdadas, como o redirecionamento da webcam e o redirecionamento de áudio e microfone do cliente. Se você estiver usando um sistema operacional de versão/plataforma do aplicativo Workspace que não oferece suporte à otimização do Teams, as chaves de registro de fallback não serão aplicadas. No modo de reserva, os periféricos são traçados ao VDA. Os periféricos aparecem no aplicativo Microsoft Teams como se estivessem conectados localmente à área de trabalho virtual.

Agora você pode controlar granularmente o mecanismo de fallback definindo um dos seguintes valores DWORD do Registro noa VDA:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams\DisableFallback

HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams\DisableFallback

Para desativar o modo de fallback, defina o valor como 1. Para ativar somente o áudio, defina o valor como 2. Se o valor não estiver presente ou estiver definido como 0, o modo de fallback será ativado. Esse recurso requer o Teams versão 1.3.0.13565 ou posterior.

Para determinar se você está no modo otimizado ou não otimizado ao observar a guia Configurações > Dispositivos em Teams, a diferença mais significativa é o nome da câmera. Se o Microsoft Teams for carregado no modo não otimizado, as tecnologias HDX herdadas serão iniciadas. O nome da webcam tem o sufixo Citrix HDX como mostrado no gráfico a seguir. Os nomes dos dispositivos de alto-falante e microfone podem ser ligeiramente diferentes (ou truncados) quando comparados com o modo otimizado.

Modo de desotimização para o Microsoft Teams

Quando são usadas as tecnologias HDX herdadas, o Microsoft Teams não descarrega o processamento de compartilhamento de áudio, vídeo e tela para o mecanismo de mídia WebRTC do aplicativo Citrix Workspace do ponto de extremidade. Em vez disso, as tecnologias HDX usam renderização no lado do servidor. Espere alto consumo de CPU no VDA quando você liga o vídeo. O desempenho de áudio em tempo real pode não ser otimizado.

Limitações conhecidas

Limitações do Citrix

Limitações no aplicativo Citrix Workspace:

  • Os tons DTMF não têm suporte.
  • Botões HID - Atender e terminar chamada não têm suporte. Aumentar e diminuir volume têm suporte.
  • Ao fazer o compartilhamento de tela em configurações de vários monitores, apenas o monitor principal é compartilhado.
  • Nós oferecemos suporte apenas um fluxo de vídeo de uma câmera de entrada ou fluxo de compartilhamento de tela. Quando há um compartilhamento de tela de entrada, esse compartilhamento de tela é mostrado em vez do vídeo do palestrante dominante.
  • A campainha secundária (Teams > Settings > Devices) não tem suporte.
  • As configurações de QoS no Admin Center for Microsoft Teams não se aplicam a usuários de VDI.
  • O recurso de complemento de proteção de aplicativos para o aplicativo Citrix Workspace impede o compartilhamento de tela de saída.
  • A função de aumentar zoom e diminuir zoom no Microsoft Teams não é suportada.

Limitação no VDA:

  • Quando você configura a configuração de DPI alto do aplicativo Citrix Workspace como Yes ou No, use the native resolution, a janela de vídeo redirecionada aparece fora do lugar quando o fator de dimensionamento de DPI do monitor estiver definido com algum valor acima de 100%.

Limitações no aplicativo Citrix Workspace e no VDA:

  • Compartilhamento de tela de saída: o compartilhamento de aplicativos não tem suporte.
  • Você só pode controlar o volume de uma chamada otimizada usando a barra de volume no computador cliente, não no VDA.

Limitação da Microsoft

  • As opções para desfocar ou personalizar o plano de fundo não são suportadas.
  • Uma visualização de galeria 3x3 não é suportada. Dependência do Microsoft Teams — entre em contato com a Microsoft para saber para quando esperar a grade 3x3.
  • A interoperabilidade com o Skype for Business é limitada a chamadas de áudio, sem modalidade de vídeo.
  • A resolução máxima de fluxo de vídeo de entrada e saída é de 720p. Dependência do Microsoft Teams — entre em contato com a Microsoft para saber para quando esperar 1080p.
  • O toque de retorno de chamada PSTN não é suportado
  • O Call Quality Dashboard e Call Analytics for Microsoft Teams Admin Center não exibem dados de QoE para usuários de VDI.
  • O desvio de mídia para roteamento direto não tem suporte.

Limitação da Citrix e Microsoft

  • Ao fazer o compartilhamento de tela, a opção include system audio não está disponível.
  • A janela de pop-out do chat (também conhecido como chat com várias janelas ou a nova experiência de reunião) não tem suporte.
  • As salas simultâneas são suportadas para participantes por VDI. O Microsoft Teams não dá suporte a salas simultâneas se o organizador for um usuário de VDI.
  • Dar controle e assumir o controle: não é suportado durante uma sessão de compartilhamento de tela de desktop ou compartilhamento de aplicativos. Suportado somente durante uma sessão de compartilhamento do PowerPoint.
  • O E911 e o Roteamento Baseado em Localização não são suportados.

Informações adicionais