Compartilhamento de tela HDX

Last published : Nov 13, 2026
O Compartilhamento de Tela HDX é um recurso integrado, nativo e de alto desempenho dentro do Citrix Virtual Apps and Desktops que permite aos usuários compartilhar as telas de suas sessões virtuais com outras pessoas em tempo real. Ele foi projetado para oferecer baixa latência e alta qualidade, proporcionando uma experiência perfeita para cenários de colaboração, suporte e treinamento, sem a necessidade de implementar soluções de software de terceiros.
tela1
A funcionalidade de Compartilhamento de Tela HDX é integrada diretamente ao protocolo HDX, o que garante que a sessão de compartilhamento seja segura e eficiente, com impacto mínimo no desempenho da sessão.
Com o Compartilhamento de Tela HDX, os usuários podem compartilhar todo o conteúdo de suas sessões Citrix, incluindo o controle de teclado e mouse, com um ou mais participantes.
O recurso suporta monitores de alta resolução e pode acomodar até oito monitores.
O Compartilhamento de Tela HDX está disponível em todas as plataformas VDA, incluindo Windows, Linux e macOS, e oferece compatibilidade cruzada. Isso significa que os usuários em VDAs Windows podem compartilhar suas telas com usuários em VDAs Linux e macOS, e vice-versa.
Além disso, o Compartilhamento de Tela HDX não depende de nenhum componente cliente, tornando-o acessível em todas as plataformas cliente, incluindo dispositivos móveis.

Principais Conceitos

  • Compartilhador: O usuário que inicia o compartilhamento de tela a partir de sua sessão de desktop virtual e que mostrará o desktop de suas sessões virtuais para outras pessoas
  • Visualizador: O usuário (ou usuários) que se conecta à sessão do compartilhador para visualizar sua tela, também referido como os participantes do compartilhamento de tela
  • Código de Conexão: Um código de segurança exclusivo, gerado pelo sistema, que o compartilhador fornece aos visualizadores para acesso à sessão compartilhada.
  • Indicador de Status Gráfico: Um elemento da interface do usuário localizado na área de notificação que fornece controles para iniciar, parar e gerenciar sessões de compartilhamento de tela.
  • Reprodutor de Compartilhamento de Tela: A ferramenta na sessão que os visualizadores usam para ver a sessão do compartilhador.

Casos de Uso e cenários de uso de exemplo

A configuração e utilização adequadas do Compartilhamento de Tela HDX podem atender a diversas necessidades organizacionais, desde suporte de TI até desenvolvimento colaborativo e treinamento.

Cenário 1: Suporte de TI e Suporte Remoto

Um administrador de TI precisa solucionar um problema que um usuário está enfrentando em sua área de trabalho virtual. Em vez de tentar replicar o problema, o administrador de TI pode iniciar o Assistência Remota por meio do compartilhamento de tela HDX no Citrix Director. O administrador vê a tela exata do usuário em tempo real, o que leva a uma identificação e resolução mais rápidas do problema. A capacidade de solicitar controle de teclado e mouse permite que o administrador tome ações diretas. O compartilhamento de tela HDX também está integrado ao Citrix Director a partir do CVAD 2511 e versões posteriores. Para obter mais informações sobre como usar o compartilhamento de tela HDX via Citrix Director, consulte a documentação do Citrix Director

Cenário 2: Colaboração do usuário final

Uma equipe de engenheiros está trabalhando em um modelo 3D complexo dentro de um aplicativo com uso intensivo de gráficos em suas áreas de trabalho virtuais. Eles precisam revisar o design juntos e fazer ajustes em tempo real.
Um engenheiro pode compartilhar sua sessão, e toda a equipe pode visualizar o modelo, sugerir alterações e até mesmo se revezar no controle do aplicativo para fazer edições. Isso evita a necessidade de exportar arquivos ou usar ferramentas de compartilhamento de tela de terceiros.

Cenário 3: Integração e Treinamento de Funcionários

Um novo funcionário está aprendendo a usar um aplicativo proprietário de linha de negócios. Um instrutor pode demonstrar os recursos do aplicativo diretamente na sessão virtual do novo contratado.
O instrutor pode guiar o novo funcionário passo a passo. O indicador de borda colorida (vermelho ou amarelo) mostra claramente quando a sessão está sendo compartilhada, fornecendo uma dica visual para o ambiente de aprendizado.

Requisitos do sistema

O compartilhamento de tela HDX é suportado em todas as plataformas VDA, no entanto, pode haver requisitos adicionais em certas plataformas. Veja abaixo para mais informações.
O compartilhamento de tela HDX usa portas TCP no intervalo de 52525 a 52625 por padrão.
Ao instalar a versão 2112 do VDA e posteriores, o instalador do VDA pode ser configurado para abrir automaticamente as portas de firewall padrão para o compartilhamento de tela HDX.
screen2
Se isso não foi feito durante a instalação do VDA ou se um intervalo de portas personalizado foi configurado, abra essas portas manualmente nos VDAs.
Observação:
Deve haver conectividade de rede entre o VDA que hospeda a sessão e as máquinas que se conectam às sessões compartilhadas.
Um máximo de 64 espectadores pode se conectar a uma única sessão de compartilhamento de tela. O intervalo de portas controla o número máximo de usuários em um ambiente multi-sessão que podem iniciar o compartilhamento de tela. Uma porta é necessária por usuário.
Observação:
Todos os monitores conectados à sessão são compartilhados. Não é possível selecionar monitores individuais.
Os codecs de vídeo AV1 e H.265 e o modo de cor de 10 bits não são suportados. A sessão retornará automaticamente para a codificação de vídeo H.264 durante o compartilhamento de tela ativo. Assim que a sessão de compartilhamento de tela terminar, AV1 e H.265 estarão disponíveis novamente.

VDA do Windows

  • Windows: VDA de SO de sessão única ou multi-sessão
  • O indicador de status gráfico deve estar habilitado.
Observação:
Somente sessões de desktop podem ser compartilhadas.

VDA do Linux

  • Se o compartilhamento de sessão ocorrer entre vários VDAs do Linux, é recomendável atualizar para a mesma versão do VDA para evitar problemas de entrada de teclado.
  • Recomenda-se que o aplicativo Citrix Workspace™ seja configurado para usar o modo Scancode
  • O ícone da bandeja do sistema deve estar habilitado
Mais informações sobre o compartilhamento de tela HDX para VDAs do Linux podem ser encontradas na documentação do VDA do Linux para compartilhamento de tela HDX

VDA do macOS

  • Qt 5, revisão 5.15.13 ou posterior.
Para alinhar a experiência unificada do usuário em todos os VDAs em relação ao compartilhamento de tela HDX, você precisa instalar o framework Qt, a versão mínima compatível é Qt 5 (rev. 5.15.13 ou posterior).
A instalação do Qt 5 no VDA pode ser realizada usando, por exemplo, homebrew, executando o seguinte comando:
brew install qt@5
Mais informações sobre o compartilhamento de tela HDX para VDAs do macOS podem ser encontradas na documentação do VDA do macOS para compartilhamento de tela HDX

Configuração

O compartilhamento de tela HDX é desabilitado por padrão, e a funcionalidade pode ser habilitada e configurada por meio de políticas Citrix®.
As políticas darão controle granular à configuração de compartilhamento de tela HDX.

Habilitando o compartilhamento de tela HDX para usuários finais

O compartilhamento de tela HDX é desabilitado por padrão. Para permitir que os usuários finais compartilhem sua tela via compartilhamento de tela HDX, os recursos precisam ser habilitados e configurados da seguinte forma:
  • Habilitar política de compartilhamento de tela HDX
  • Habilitar indicador de status gráfico
  • Opcional: configure e abra portas personalizadas no firewall do VDA

Etapa 1: Habilitar compartilhamento de tela HDX

Para habilitar o compartilhamento de tela HDX, navegue até a política de Compartilhamento de tela e defina a política como habilitada
tela3a

Etapa 2: Habilitar o indicador de status gráfico

Navegue até Indicador de status gráfico e defina a política como Habilitado
tela3

Configuração adicional de compartilhamento de tela HDX

Por padrão, o compartilhamento de tela HDX usa as seguintes portas TCP para comunicação:
  • Porta inicial TCP: 52525
  • Porta final TCP: 52625
O intervalo de porta TCP padrão pode ser ajustado pela política ‘HDX Screen sharing port’:
Para ajustar o intervalo de porta TCP, navegue até a política ‘HDX Screen sharing port’ e defina o intervalo de porta para o intervalo de porta desejado.
A configuração da porta pode ser usada para restringir o número de usuários simultâneos compartilhando suas telas em um VDA de múltiplas sessões.
Nota:
A configuração da porta não deve se sobrepor a HDX Screen sharing para Director.
O código de conexão do HDX Screen sharing nunca expirará por padrão e pode ser usado indefinidamente durante uma sessão de compartilhamento de tela para ingressar nessa sessão.
Para segurança aprimorada, uma configuração de tempo limite pode ser configurada, após a qual o código de conexão expirará. Assim que o período de tempo limite especificado tiver decorrido, o código de conexão gerado anteriormente torna-se inválido, e novos usuários não conseguirão ingressar na sessão de compartilhamento de tela usando este código. O compartilhador precisará gerar um novo código de conexão de sessão.
Além disso, quando uma sessão de compartilhamento de tela for iniciada e nenhum visualizador tiver se conectado dentro do período de tempo limite configurado, o compartilhamento de tela será interrompido automaticamente. Para retomar o compartilhamento de tela, o compartilhador precisará reiniciar o HDX Screen sharing e compartilhar o código de conexão.
Para configurar um tempo limite para sessões de HDX Screen sharing, navegue até a política ‘HDX Screen sharing timeout’ e defina o valor de tempo limite desejado em minutos.

Configuração do código de conexão (Pré-visualização)

Por padrão, o HDX Screen sharing usa um código de conexão de 40 caracteres. A partir do CVAD 2411, os administradores podem configurar o uso do novo e mais curto código de conexão para HDX Screen sharing. O novo código de conexão é mais curto, com 13 caracteres, e não inclui caracteres ambíguos para facilitar a comunicação verbal do código de conexão aos potenciais visualizadores pelo compartilhador.
screen4
Atualmente, a configuração é fornecida como uma configuração de registro para os VDAs. Observe que o novo e mais curto código de conexão não oferece compatibilidade retroativa com VDAs mais antigos.
Nota:
O novo e mais curto código de conexão não oferece compatibilidade retroativa com VDAs mais antigos.

Pré-requisitos

VDA - CVAD 2411 e posterior

Configuração da conexão

Para habilitar o novo código de conexão mais curto:
  1. Abra o Editor do Registro do Windows usando regedit.exe.
  2. navegar para HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Graphics\ScreenShare
  3. Crie um valor DWORD chamado CodeType e defina o valor como 1.
Esta chave controla o código de conexão a ser usado, 0 para o código de conexão mais longo e antigo, 1 para o novo código curto.
screen5

Iniciando uma sessão de compartilhamento de tela

Como compartilhador, para compartilhar uma sessão, procure o ícone do indicador de status gráfico HDX na área de notificação do Windows. Clique com o botão direito do mouse para exibir o menu e selecione ‘Compartilhamento de tela’ > ‘Compartilhar minha tela’.
compartilhamento de tela 1
Após o início do compartilhamento de tela, uma caixa de diálogo aparecerá com o código de conexão que pode ser usado para ingressar na sessão de compartilhamento de tela. Este código pode ser usado por um ou mais visualizadores para se conectar à sua sessão de compartilhamento de tela.
Clique em 'Copiar para a área de transferência' ou selecione e copie manualmente o código de conexão mostrado na caixa de diálogo.
O código de conexão pode então ser colado no aplicativo de sua escolha, como um aplicativo de e-mail ou Microsoft Teams, por exemplo, para ser distribuído a outros usuários.
Uma vez que o código de conexão tenha sido copiado, a caixa de diálogo pode ser fechada clicando em 'Ok' ou no 'x' no canto superior direito.
O código de conexão ativo atual pode ser recuperado da opção de menu Compartilhar tela > Código de conexão a qualquer momento enquanto a sessão estiver sendo compartilhada.
screen6
Nota:
Tenha cuidado com quem você compartilha o código de conexão; todos os usuários com quem você compartilhou o código de conexão podem potencialmente se conectar à sua sessão ativa de compartilhamento de tela.
Uma vez iniciada uma sessão de compartilhamento de tela, uma borda amarela aparecerá ao redor da sessão Citrix para indicar que o compartilhamento de tela HDX está ativo, mas nenhum visualizador ainda se juntou.
screen7
Quando um visualizador se conecta à sessão de compartilhamento de tela, a borda mudará de cor para vermelho, indicando que a sessão de compartilhamento de tela está ativa e tem visualizadores conectados.
screen8
Observe que, se você tiver várias telas ativas em sua sessão Citrix, todas as telas serão compartilhadas via compartilhamento de tela, e os espectadores poderão ver todas as telas conectadas em sua sessão.
Atualmente, não há suporte para compartilhar apenas um único monitor ou um subconjunto de monitores conectados em sua sessão.
Por padrão, até 100 espectadores podem se conectar a uma única sessão de compartilhamento de tela, embora esse limite possa ser restrito pelo seu administrador Citrix.

Regerar novos códigos de conexão

Enquanto o código de conexão estiver ativo, novos usuários podem usá-lo para entrar na sua sessão de compartilhamento de tela. Se o código tiver expirado, os visualizadores existentes permanecerão conectados, mas nenhum novo usuário poderá se conectar à sua sessão de compartilhamento de tela. Para permitir que novos usuários se conectem à sua sessão, você precisará regerar um novo código de conexão.
O novo código de conexão pode ser recuperado na opção de menu ‘Compartilhamento de tela’ > ‘Código de conexão’ a qualquer momento enquanto a sessão estiver sendo compartilhada.
screen9

Parando o compartilhamento de tela

Para parar o compartilhamento de tela, procure o ícone do indicador de status gráfico HDX na área de notificação do Windows. Clique com o botão direito do mouse para exibir o menu e selecione ‘Compartilhamento de tela’ > ‘Parar de compartilhar minha tela’. O compartilhamento de tela será interrompido imediatamente, e todos os visualizadores atuais serão desconectados da sua sessão. A borda vermelha desaparecerá para indicar que o compartilhamento de tela foi interrompido.
screen10

Dar controle de mouse e teclado

A qualquer momento na sessão de compartilhamento de tela, como compartilhador, você pode entregar o controle do mouse e do teclado a um visualizador específico.
Uma vez entregue, esse visualizador compartilhará o controle total do seu mouse e teclado com você em sua sessão Citrix.
Para compartilhar o controle do mouse e do teclado, abra o ícone do indicador de status gráfico na área de notificação do Windows. Clique com o botão direito nele para exibir o menu e selecione ‘Compartilhamento de tela’ > ‘Dar controle’ e selecione um dos visualizadores ativos para entregar o controle.
screen11
O visualizador selecionado receberá uma notificação indicando que ele tem controle do mouse e do teclado.
screen12
Para parar o compartilhamento do mouse e do teclado e retomar o controle, abra o ícone do indicador de status gráfico na área de notificação do Windows. Clique com o botão direito nele para exibir o menu e selecione ‘Compartilhamento de tela’ > ‘Dar controle’ e desmarque os visualizadores ativos.
screen13
O visualizador será notificado de que perdeu o controle do mouse e do teclado.
screen14
Observação:
Você só pode compartilhar o controle do mouse e do teclado com um visualizador por vez. Um visualizador também pode solicitar o controle do mouse e do teclado. Quando isso ocorrer, você será notificado da solicitação e poderá optar por permitir ou negar a solicitação.
screen17

Registro de eventos

Para fins de segurança e auditoria, os eventos de compartilhamento de tela no VDA do compartilhador agora são coletados e registrados, o que permitirá ao administrador rastrear a atividade de compartilhamento de tela nos VDAs do compartilhador. As seguintes informações e eventos são registrados durante uma sessão de compartilhamento de tela sessão:
  • Início/Parada do Compartilhamento – Evento que denota o início e a parada da sessão de compartilhamento de tela
  • Solicitações de conexão – IP e nome de usuário do visualizador que solicitou a conexão, juntamente com o código de conexão usado e a decisão da conexão (conexão concedida/negada devido a uma falha de autenticação ou decisão do compartilhador)
  • Solicitações de Controle de Tela – IP e nome de usuário do visualizador que solicitou o controle de tela, juntamente com a decisão (concedido/negado)
  • Ações do Visualizador - IP e nome de usuário do visualizador que se desconectou da sessão de compartilhamento de tela ou liberou o controle da tela do compartilhador.
tela15

Visualizando uma sessão de compartilhamento de tela

Para se conectar às sessões de outra pessoa, procure o ícone do indicador de status gráfico HDX na área de notificação do Windows. Clique com o botão direito nele para exibir o menu e selecione ‘Compartilhar tela’ > ‘Visualizar a tela de outra pessoa’.
compartilhamento de tela 4
Você será solicitado a inserir um código de conexão. O compartilhador de tela HDX terá fornecido este código a você. Digite ou cole a string de conexão da sessão, conforme fornecido pelo usuário que está compartilhando a sessão, na caixa de texto.
Ao clicar em ‘Conectar’, o código de conexão será validado e, se a validação for bem-sucedida, a conexão de compartilhamento de tela com a sessão do compartilhador será estabelecida e o visualizador de compartilhamento de tela será aberto automaticamente e mostrará a tela (ou telas) do compartilhador.
Ao se conectar à sessão, o compartilhador será notificado de sua participação em sua sessão de compartilhamento de tela.
tela16

Ajustando a escala da exibição

Se o compartilhador usar uma resolução de monitor superior à sua ou se usar vários monitores durante a sessão, o reprodutor de compartilhamento de tela ajustará automaticamente a resolução. Para desativar o dimensionamento e visualizar a resolução nativa dos monitores do compartilhador, selecione as setas diagonais no canto superior esquerdo do reprodutor de compartilhamento de tela.

Desconectar de uma sessão de compartilhamento de tela

Para se desconectar da sessão de compartilhamento de tela, feche o reprodutor de compartilhamento de tela a qualquer momento. Para reconectar, se o código de conexão não tiver expirado, você pode usar o mesmo código para se juntar novamente à sessão de compartilhamento de tela com o compartilhador. Se o código de conexão tiver expirado, o compartilhador precisará gerar um novo código para você. A expiração do código de conexão é controlada pela Política de compartilhamento de tela de tempo limite de conexão, que pode ser definida por um administrador.

Solicitar controle de mouse e teclado

Por padrão, o compartilhador tem controle total do mouse e teclado na sessão de compartilhamento de tela. Como visualizador, você pode solicitar o controle de mouse e teclado ao compartilhador.
Para solicitar o controle de mouse e teclado, clique no 'ícone do mouse' no canto superior esquerdo do visualizador de compartilhamento de tela. O compartilhador será notificado de sua solicitação e poderá permiti-la ou negá-la. Assim que o compartilhador aprovar a solicitação de controle de mouse e teclado, tanto você como visualizador quanto o compartilhador de tela compartilharão o controle de mouse e teclado dentro da sessão.
tela17
Observação:
O compartilhador pode retomar o controle exclusivo do mouse e teclado a qualquer momento.
tela18