Streaming no Unreal

  • Artigo
  • Aplica-se a:
    HoloLens, HoloLens 2

Às vezes, "streaming" é chamado de "comunicação remota holográfica". Para saber mais, confira Visão geral da comunicação remota holográfica

O streaming de um computador para o HoloLens fornece duas vantagens principais:

  • Ele permite que o aplicativo de realidade misturada aproveite a capacidade computacional dos computadores.
  • Ele ajuda a acelerar o tempo de iteração do desenvolvimento.

Para começar, baixe o Holographic Remoting Player no seu dispositivo HoloLens. O Holographic Remoting Player permite o streaming direto do seu aplicativo para o player de comunicação remota no HoloLens por meio das seguintes fontes:

  • O editor do Unreal Engine
  • Um executável empacotado do Windows

Durante o streaming, você tem acesso a quase todas as mesmas funcionalidades do HoloLens que teria ao executar um aplicativo em um dispositivo. Isso inclui o acompanhamento da articulação da mão, se você está usando um HoloLens 2, o mapeamento espacial e as âncoras espaciais, mas exclui os recursos desta lista.

Observação

  • A qualidade de streaming é altamente dependente da força da rede Wi-Fi.
  • Todos os recursos são habilitados automaticamente para o player de comunicação remota holográfica. Se você encontrar uma funcionalidade que exija permissão de usuário (por exemplo, acompanhamento de olho) para funcionar por streaming, mas não durante a execução no dispositivo, verifique se você habilitou os recursos adequados nas configurações do seu projeto.

Limitações de streaming

As malhas de mão, a câmera do HoloLens e o teclado do sistema não estão disponíveis por streaming. Observe que a entrada de fala para aplicativos transmitidos por streaming pode ser adquirida por meio do microfone do computador em que você está fazendo streaming.

OpenXR

O Unreal 4.26 em execução no OpenXR é compatível com streaming para as versões 2.4.0 e posteriores do Player de Comunicação Remota Holográfica. Para obter o suporte mais recente aos recursos com a Comunicação Remota Holográfica, confira as páginas Histórico de versão e Solução de problemas.

Suporte a dispositivos

Origem HoloLens 1ª geração HoloLens 2 Headsets imersivos
Editor do Unreal ✔️ ✔️ ✔️
Pacote do Windows ❌ ✔️ ✔️

Observação

A partir do streaming da Comunicação Remota Holográfica versão 2.2.0 também está disponível para Windows computadores em execução Windows Mixed Reality.

Streaming do editor do Unreal

Como desenvolvedor, você descobrirá que o streaming por meio do editor do Unreal para o dispositivo HoloLens oferece benefícios significativos durante o teste. Ou seja, você não precisa mais esperar que o aplicativo seja compilado e implantado para experimentar as atualizações.

Encontre instruções detalhadas do streaming por meio do editor do Unreal em nossa série de tutoriais.

Streaming de um executável empacotado do Windows

No Unreal 4.25.1 em diante, você pode transmitir seu aplicativo para um dispositivo HoloLens 2 por meio de um executável empacotado do Windows:

  1. Acesse Arquivo > Projeto de Pacote > Windows no menu do editor.

    • Escolha uma localização para salvar o pacote e Selecionar Pasta.

  2. Depois que o pacote terminar de ser compilado, abra o Holographic Remoting Player no HoloLens 2 e anote o endereço IP.

  3. Deixe o Holographic Remoting Player aberto e use o prompt de linha de comando para:

    • Executar cd no diretório local em que você salvou o pacote.
    • Digite o seguinte comando: <App Name>.exe -vr -HoloLensRemoting=<IP Address>

Observação

O nome do aplicativo nas configurações do projeto deverá ser usado automaticamente para criar o pacote do Windows. Se ele for diferente por algum motivo, use o nome do executável do Windows no prompt de comando.

Observação

Se o acompanhamento ocular não estiver funcionando ao transmitir de um executável empacotado, desabilite os outros plug-ins com rastreadores oculares com suporte para PC (exemplo: Magic Leap) ou execute o aplicativo na linha de comando com o argumento de acompanhamento ocular relevante (confira opções de linha de comando).

Pressione ENTER e veja seu aplicativo começar a ser transmitido.

Opções de linha de comando

Outras opções de linha de comando para streaming em cada plataforma no Unreal Engine 4.26+ podem ser encontradas na tabela abaixo.

Opção Descrição
-HoloLensRemoting=<IP address:port> Usa o endereço IP (e a porta opcional) do dispositivo do HoloLens 2 para se conectar. Se nenhuma porta for fornecida, o padrão será 8265.
-RemotingBitrate=<bitrate> (opcional) Padrão 8000. Taxa máxima de transferência de rede (KB/s).
-HoloLensRemotingListen (opcional) Iniciar um servidor de escuta
-HoloLensRemotingListenPort=<port> (opcional) Usa a porta a ser escutada. Usado para se conectar a um computador ou VM de um dispositivo HoloLens.
-HoloLens1Remoting=<IP address> (preterido na 4.26) Usa o endereço IP do dispositivo do HoloLens 1 para se conectar
-eyetracking=WindowsMixedRealityEyeTracker (opcional) Usar o rastreador ocular Windows Mixed Reality

Veja também