Citrix Virtual Apps and Desktops

Configurações de política de multimídia

A seção Multimídia inclui configurações de política para gerenciar streaming de áudio e vídeo HTML5 e Windows em sessões de usuário.

Aviso

Editar o Registro incorretamente pode causar problemas sérios que podem exigir a reinstalação do seu 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. Certifique-se de fazer backup do Registro antes de editá-lo.

Políticas de multimídia

Por padrão, todas as políticas de multimídia definidas no Delivery Controller™ são armazenadas nestes Registros:

Políticas de máquina:

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\MultimediaPolicies

Políticas de usuário:

HKEY_LOCAL_MACHINE\Software\Policies\Citrix{User Session ID}\User\MultimediaPolicies

Para localizar a ID da sessão de usuário atual, execute o comando qwinsta na linha de comando do Windows.

Redirecionamento de vídeo HTML5

Controla e otimiza a forma como os servidores Citrix Virtual Apps and Desktops™ entregam conteúdo web multimídia HTML5 aos usuários.

Por padrão, essa configuração está desativada.

Imagem de redirecionamento HTML5

Imagem gráfica de redirecionamento HTML5

Nesta versão, esse recurso está disponível apenas para páginas web controladas. Ele exige a adição de JavaScript às páginas web onde o conteúdo multimídia HTML5 está disponível, por exemplo, vídeos em um site de treinamento interno.

Para configurar o redirecionamento de vídeo HTML5:

  1. Copie o arquivo HdxVideo.js de %Program Files%/Citrix/ICA Service/HTML5 Video Redirection na instalação do VDA para o local da sua página web interna.
  2. Insira esta linha em sua página web (se sua página web tiver outros scripts, inclua HdxVideo.js antes desses scripts): <script src="HdxVideo.js" type="text/javascript"\></script>

Observação: Se HdxVideo.js não estiver no mesmo local da sua página web, use o atributo src para especificar o caminho completo para ele.

Considere que o JavaScript não é adicionado às suas páginas web controladas e o usuário reproduz um vídeo HTML5. Nesse caso, o Citrix Virtual Apps and Desktops usa a renderização do lado do servidor por padrão.

Para que o redirecionamento de vídeos HTML5 funcione, permita Redirecionamento do Windows Media. Essa política é obrigatória para Server Fetch Client Render e necessária para Client Side Fetching. O Client Side Fetching, por sua vez, também exige que a busca de conteúdo do lado do cliente do Windows Media seja Permitida.

O Microsoft Edge não oferece suporte a esse recurso.

O HdxVideo.js substitui os controles do reprodutor HTML5 do navegador pelos seus próprios. Para verificar se a política de redirecionamento de vídeo HTML5 está em vigor em um determinado site, compare os controles do reprodutor com um cenário em que a política de redirecionamento de vídeo HTML5 é Proibida:

(Controles personalizados da Citrix quando a política é Permitida)

Imagem de áudio de redirecionamento HTML5

(Controles nativos da página web quando a política é Proibida ou não configurada)

Imagem de vídeo de redirecionamento HTML5

Os seguintes controles de vídeo são compatíveis:

  • reproduzir
  • pausar
  • buscar
  • repetir
  • áudio
  • tela cheia

Você pode visualizar uma página de teste de redirecionamento de vídeo HTML5.

TLS, redirecionamento de vídeo HTML5 e redirecionamento de conteúdo do navegador

Você pode usar o redirecionamento de vídeo HTML5 para:

  • Redirecionar vídeos de sites HTTPS
  • Ou
  • Redirecionamento de conteúdo do navegador para redirecionar o site inteiro

O JavaScript injetado nesses sites deve estabelecer uma conexão TLS com o Citrix HDX HTML5 Video Redirection Service (WebSocketService.exe) em execução no VDA. O Citrix HDX HTML5 Video Redirection Service no armazenamento de certificados no VDA gera dois certificados personalizados para:

  • Realizar o redirecionamento de vídeo
  • Manter a integridade TLS da página web

O HdxVideo.js usa WebSockets Seguros para se comunicar com o WebSocketService.exe em execução no VDA. Esse processo é executado como uma conta de Sistema Local e faz a terminação SSL e o mapeamento de sessão de usuário.

O WebSocketService.exe está escutando em 127.0.0.1 porta 9001.

Limitar a qualidade do vídeo

Essa configuração se aplica apenas ao Windows Media e não ao HTML5. Ela exige que você ative a Otimização para redirecionamento multimídia do Windows Media pela WAN.

Essa configuração especifica o nível máximo de qualidade de vídeo permitido para uma conexão HDX™. Quando configurada, a qualidade máxima do vídeo é limitada ao valor especificado, garantindo que a Qualidade de Serviço (QoS) multimídia seja mantida em um ambiente.

Por padrão, essa configuração não está configurada.

Para limitar o nível máximo de qualidade de vídeo permitido, escolha uma das seguintes opções:

  • 1080p/8.5mbps
  • 720p/4.0mbps
  • 480p/720kbps
  • 380p/400kbps
  • 240p/200kbps

Reproduzir vários vídeos simultaneamente no mesmo servidor consome grandes quantidades de recursos e pode afetar a escalabilidade do servidor.

Redirecionamento do Microsoft Teams

Essa configuração permite a otimização do Microsoft Teams, com base na tecnologia HDX.

Política de otimização para Microsoft Teams

Se essa política estiver ativada e você estiver usando uma versão compatível do aplicativo Citrix Workspace™, essa chave do Registro será definida como 1 no VDA. O aplicativo Microsoft Teams lê a chave para carregar no modo VDI. Observe que não é necessário definir a chave do Registro manualmente.

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

Nome: MSTeamsRedirSupport

Valor: DWORD (1 - ativado, 0 - desativado)

Observação:

Considere que você está usando VDAs versão 1906.2 ou posterior com versões mais antigas do Controller, que não têm a política disponível no Studio. Um exemplo de uma versão mais antiga do Controller é a versão 7.15. Nesse caso, a otimização HDX é ativada por padrão no VDA. Se a versão do aplicativo Workspace for 1907 ou posterior, o Microsoft Teams será iniciado no modo otimizado. Para obter informações sobre ressalvas na mistura de Controllers 7.15 LTSR e VDAs CR, consulte o artigo da Central de Conhecimento CTX205549.

Nesse caso, para desativar o recurso para usuários específicos, você pode substituir a configuração do Registro. Substitua as configurações do Registro usando uma política de grupo para aplicar um script de logon à unidade organizacional do usuário.

Por padrão, o redirecionamento do Microsoft Teams está ativado.

Conferência multimídia

Essa configuração permite ou impede o uso da tecnologia otimizada de redirecionamento de webcam por aplicativos de videoconferência.

Por padrão, o suporte a videoconferência é permitido.

Ao adicionar essa configuração a uma política, verifique se a configuração de redirecionamento do Windows Media está presente e definida como Permitido (o padrão).

Ao usar a Conferência multimídia, verifique se as seguintes condições são atendidas:

  • Drivers fornecidos pelo fabricante para a webcam usada para conferência multimídia estão instalados no cliente.
  • Conecte a webcam ao dispositivo do usuário antes de iniciar uma sessão de videoconferência. O servidor usa apenas uma webcam instalada por vez. Se várias webcams estiverem instaladas no dispositivo do usuário, o servidor tentará usar cada webcam em sucessão. Essa tentativa continua até que uma sessão de videoconferência seja criada com sucesso.

Essa política não é necessária ao redirecionar a webcam usando o redirecionamento USB genérico. Nesse caso, instale os drivers da webcam no VDA.

Otimização para redirecionamento multimídia do Windows Media pela WAN

Essa configuração se aplica apenas ao Windows Media e não ao HTML5. A configuração permite o seguinte:

  • Transcodificação multimídia em tempo real
  • Permite o streaming de áudio e vídeo para dispositivos móveis em redes degradadas
  • Melhora a experiência do usuário, aprimorando a forma como o conteúdo do Windows Media é entregue pela WAN.

Por padrão, a entrega de conteúdo do Windows Media pela WAN é otimizada.

Ao adicionar essa configuração a uma política, certifique-se de que a configuração de Redirecionamento do Windows Media esteja presente e definida como Permitido.

Quando essa configuração é ativada, a transcodificação multimídia em tempo real é implantada automaticamente conforme necessário para permitir o streaming de mídia. Além disso, proporciona uma experiência de usuário perfeita mesmo em condições extremas de rede.

Usar GPU para otimizar o redirecionamento multimídia do Windows Media pela WAN

Essa configuração se aplica apenas ao Windows Media e permite que a transcodificação multimídia em tempo real seja feita na Unidade de Processamento Gráfico (GPU) no Virtual Delivery Agent (VDA). Isso melhora a escalabilidade do servidor. A transcodificação de GPU está disponível apenas se o VDA tiver uma GPU compatível para aceleração de hardware. Caso contrário, a transcodificação reverte para a CPU.

Observação: A transcodificação de GPU é compatível apenas com GPUs NVIDIA.

Por padrão, o uso da GPU no VDA para otimizar a entrega de conteúdo do Windows Media pela WAN é proibido.

Ao adicionar essa configuração a uma política, certifique-se de que as seguintes configurações estejam presentes e definidas como Permitido:

  • Redirecionamento do Windows Media
  • Otimização para configurações de redirecionamento multimídia do Windows Media pela WAN

Prevenção de fallback do Windows Media

Essa configuração se aplica ao redirecionamento de conteúdo do navegador, HTML5 e Windows Media. Para que ele ofereça suporte a HTML5, defina a política de redirecionamento de vídeo HTML5 como Permitido.

Os administradores podem usar a configuração de política de prevenção de fallback do Windows Media para especificar os métodos que são tentados para entregar conteúdo transmitido aos usuários.

Por padrão, essa configuração não está configurada. Quando a configuração é definida como Não configurado, o comportamento é o mesmo que Reproduzir todo o conteúdo.

Para configurar essa definição, escolha uma das seguintes opções:

  • Reproduzir todo o conteúdo. Tentar a busca de conteúdo do lado do cliente e, em seguida, o Redirecionamento do Windows Media. Se não for bem-sucedido, reproduza o conteúdo no servidor.
  • Reproduzir todo o conteúdo somente no cliente. Tentar a busca do lado do cliente e, em seguida, o Redirecionamento do Windows Media. Se não for bem-sucedido, o conteúdo não é reproduzido.
  • Reproduzir apenas conteúdo acessível ao cliente no cliente. Tentar apenas a busca do lado do cliente. Se não for bem-sucedido, o conteúdo não é reproduzido.

Quando o conteúdo não é reproduzido, a seguinte mensagem de erro é exibida na janela do reprodutor (por uma duração padrão de 5 segundos):

"A empresa bloqueou o vídeo por falta de recursos"

Imagem de prevenção de fallback do Windows Media

A duração dessa mensagem de erro pode ser personalizada com a seguinte chave do Registro no VDA. Se a entrada do Registro não existir, a duração padrão será de 5 segundos.

O caminho do Registro varia dependendo da arquitetura do VDA:

\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream

Ou

\HKLM\SOFTWARE\Citrix\HdxMediastream

Chave do Registro:

Nome: VideoLoadManagementErrDuration

Tipo: DWORD

Intervalo: 1 - até o limite de DWORD (padrão = 5)

Unidade: segundos

Busca de conteúdo do lado do cliente do Windows Media

Essa configuração se aplica a HTML5 e Windows Media. A configuração permite que um dispositivo de usuário faça streaming de arquivos multimídia diretamente do provedor de origem na internet ou intranet, em vez de por meio do servidor host XenApp ou XenDesktop®.

Por padrão, essa configuração é Permitida. Permitir essa configuração melhora o uso da rede e a escalabilidade do servidor. Essa melhoria é alcançada movendo qualquer processamento de mídia do servidor host para o dispositivo do usuário. Ela também remove a exigência de que uma estrutura multimídia avançada, como Microsoft DirectShow ou Media Foundation, seja instalada no dispositivo do usuário. O dispositivo do usuário exige apenas a capacidade de reproduzir um arquivo de um URL.

Ao adicionar essa configuração a uma política, certifique-se de que a configuração de Redirecionamento do Windows Media esteja presente e definida como Permitido. Se o Redirecionamento do Windows Media estiver desativado, o streaming de arquivos multimídia para o dispositivo do usuário diretamente do provedor de origem também será desativado.

Redirecionamento do Windows Media

Essa configuração se aplica a HTML5 e Windows Media e controla e otimiza a forma como os servidores entregam streaming de áudio e vídeo aos usuários.

Por padrão, essa configuração é Permitida. Para HTML5, essa configuração não entra em vigor se a política de redirecionamento de vídeo HTML5 for Proibida.

Quando essa configuração é ativada, a qualidade do áudio e vídeo renderizados do servidor aumenta para um nível que se compara com áudio e vídeo reproduzidos localmente em um dispositivo de usuário. O servidor faz streaming de multimídia para o cliente na forma original e compactada e permite que o dispositivo do usuário descompacte e renderize a mídia.

O redirecionamento do Windows Media otimiza arquivos multimídia que são codificados com codecs que aderem aos padrões Microsoft DirectShow, DirectX Media Objects (DMO) e Media Foundation. Para reproduzir um determinado arquivo multimídia, um codec compatível com o formato de codificação do arquivo multimídia deve estar presente no dispositivo do usuário.

Por padrão, o áudio está desativado no aplicativo Citrix Workspace. Para permitir que os usuários executem aplicativos multimídia em sessões ICA®, ative o áudio ou dê permissão aos usuários para ativar o áudio na interface do aplicativo Citrix Workspace.

Selecione Proibido somente se a reprodução de mídia usando o redirecionamento do Windows Media parecer pior do que quando renderizada usando compactação ICA básica e áudio regular. Essa situação é rara, mas pode ocorrer em condições de baixa largura de banda, por exemplo, com mídia com baixa frequência de quadros-chave.

Tamanho do buffer de redirecionamento do Windows Media

Essa configuração é herdada e não se aplica a HTML5.

Essa configuração especifica um tamanho de buffer de 1 a 10 segundos para aceleração multimídia.

Por padrão, o tamanho do buffer é de 5 segundos.

Uso do tamanho do buffer de redirecionamento do Windows Media

Essa configuração é herdada e não se aplica a HTML5.

Essa configuração ativa ou desativa o uso do tamanho do buffer especificado na configuração de Tamanho do buffer de redirecionamento do Windows Media.

Por padrão, o tamanho do buffer especificado não é usado.

Se essa configuração estiver desativada ou se a configuração de Tamanho do buffer de redirecionamento do Windows Media não estiver configurada, o servidor usará o valor padrão do tamanho do buffer (cinco segundos).