A Visualização Direta permite testar e iterar interações complexas diretamente no Unreal Editor usando dados em tempo real do dispositivo Android XR. Com a Visualização Direta, a máquina host renderiza e depura o conteúdo, transmite a janela de visualização diretamente para o 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 Visualização 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.x ou 5.8.x.
- Configuração do projeto: conclua todas as etapas do guia de configuração do projeto do Unreal Engine.
- Android XR Engine Hub: conclua todas as etapas na seção Primeiros passos do guia do Android XR Engine Hub para instalar e configurar sua máquina host para o Direct Preview.
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:
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 que não tenha usado com a Visualização Direta, siga as mesmas etapas novamente.
Para cada projeto, verifique se ele tem um link simbólico para a pasta de plug-ins do fornecedor.
Definir configurações do projeto
Defina as configurações do projeto para o streaming de visualização direta:
- Acesse Configurações do projeto > Platforms > Windows.
- Para RHI para Vulkan.
- Acesse Edit > Plugins.
- Ative o plug-in AndroidXRStreaming.
- Acesse Edit > Configurações do projeto > Description.
- Ative a opção Iniciar em RV.
Ativar o ambiente de execução de streaming
Agora que o projeto tem o plug-in AndroidXRStreaming ativado, verifique se o ambiente de execução do Android XR Streaming está presente:
- Acesse Project Settings > Plugins > AndroidXRStreaming.
Clique em Ativar o streaming do Android XR.
Reinicie o Unreal Engine para aplicar as mudanças.
Configurar o cliente de streaming
Configure o cliente de streaming com diferentes opções para seu projeto:
- Acesse Project Settings > Plugins.
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:
- Auto Start Client On Preview: quando ativada, inicia o app cliente de pré-lançamento em qualquer dispositivo válido selecionado ao clicar em Start VR Preview no editor.
- Auto Stop Client On Preview: quando ativada, encerra o cliente de visualização quando a visualização de RV do editor é interrompida.
- Auto Select Compatible Device: quando ativada, seleciona automaticamente o primeiro dispositivo compatível conectado à máquina ao pesquisar dispositivos.
- Show Error Dialogs: quando ativada, exibe outras caixas de diálogo de erro. Por exemplo, uma caixa de diálogo de erro será exibida se você tentar iniciar uma visualização 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 pesquisa dispositivos conectados e lista os compatíveis (determinados pela presença do app cliente de prévia direta no Android XR Engine Hub).
Iniciar visualização direta
Inicie a Visualização Direta para transmitir diretamente do Unreal Engine:
Conecte o dispositivo Android XR à máquina host usando um cabo USB-C de alta qualidade.
Se você nunca usou esse dispositivo com a Prévia Direta, conecte e configure o dispositivo para a Prévia Direta no Android XR Engine Hub antes de iniciar a Prévia Direta pelo mecanismo de jogo.
No Unreal Editor, clique em Play level in VR. Não use a opção comum Play in Editor ao iniciar a Visualização Direta.