Configurar a Prévia direta para o Unreal Engine

Com a visualização direta, é possível testar e iterar interações complexas diretamente no Unreal Editor usando dados ativos do dispositivo Android XR. Com a prévia direta, a máquina host renderiza e depura o conteúdo, transmite a janela de visualização visual diretamente para seu dispositivo Android XR físico e transmite as extensões OpenXR compatíveis de volta para o host em tempo real.

Siga este guia para configurar a Prévia direta no seu projeto no Unreal Engine.

Pré-requisitos

Antes de começar, verifique se o ambiente de desenvolvimento atende aos seguintes requisitos:

• Versão do Unreal Engine: Unreal Engine 5.6.1 ou mais recente.
• Configuração do projeto: siga todas as etapas do guia de configuração do projeto do Unreal Engine.

• Hub do mecanismo do Android XR: siga todas as etapas na seção começar do guia do Hub do mecanismo do Android XR para instalar e configurar a máquina host para a prévia direta.

• Hardware:

  • Use uma máquina host com o Windows 11.
  • Use uma placa de vídeo moderna com suporte à codificação de vídeo Vulkan.

Configurar plug-ins do Android XR

Configure o Unreal Engine com os plug-ins necessários do Android XR:

1. Siga as etapas no guia de início rápido das extensões do Android XR para Unreal Engine.

   Depois, se você criar um novo projeto ou abrir um projeto que não usou com a Prévia direta, siga as mesmas etapas novamente.

2. Para cada projeto, verifique se ele tem um link simbólico para a pasta de plug-ins do fornecedor.

Definir configurações do projeto

Configure as configurações do projeto para o streaming da Prévia direta:

1. Navegue até Configurações do projeto > Plataformas > Windows.
2. De RHI para Vulkan.
3. Acesse Editar > Plug-ins.
4. Ative o plug-in AndroidXRStreaming.
5. Navegue até Editar > Configurações do projeto > Descrição.
6. Ative a opção Iniciar na RV.

Ativar o ambiente de execução de streaming

Agora que o projeto tem o plug-in AndroidXRStreaming ativado, verifique se o tempo de execução do Android XR Streaming está presente:

1. Acesse Project Settings > Plugins > AndroidXRStreaming.

2. Clique em Ativar o streaming do AndroidXR.

   

3. Reinicie o Unreal Engine para aplicar essas mudanças.

Configurar o cliente de streaming

Configure o cliente de streaming com diferentes opções para seu projeto:

1. Acesse Configurações do projeto > Plug-ins.

2. Na seção AndroidXRStreamingClient, revise cada uma das seguintes opções e ative ou desative-as de acordo com o que você precisa para seu projeto:

   • Iniciar cliente automaticamente na prévia: quando ativada, inicia o app cliente de prévia em qualquer dispositivo válido e selecionado ao clicar em Iniciar prévia de RV no editor.
   • Parar automaticamente o cliente na prévia: quando ativada, encerra o cliente de prévia quando a prévia de RV do editor é interrompida.
   • Selecionar automaticamente dispositivo compatível: quando ativada, essa opção seleciona automaticamente o primeiro dispositivo compatível conectado à máquina ao pesquisar dispositivos.
   • Mostrar caixas de diálogo de erro: quando ativada, mostra caixas de diálogo de erro adicionais (por exemplo, uma caixa de diálogo de erro aparece se você tentar iniciar uma prévia de RV sem selecionar um dispositivo cliente). Desative essa opção para ocultar essas caixas de diálogo.
   • Atualizar: quando ativado, o botão Atualizar procura dispositivos conectados e lista os compatíveis (determinado pela presença do app cliente de prévia direta no Hub do mecanismo Android XR).

Iniciar prévia direta

Inicie a Prévia direta para fazer streaming diretamente do Unreal Engine:

1. Conecte o dispositivo Android XR à máquina host usando um cabo USB-C de alta qualidade.

2. Se você nunca usou esse dispositivo com a Prévia direta, conecte e configure o dispositivo para a Prévia direta no hub do Android XR Engine antes de iniciar a Prévia direta pelo mecanismo de jogo.

3. No Unreal Editor, clique em Jogar nível em RV. Não use a opção Reproduzir no Editor ao iniciar a Prévia direta.