Este guia detalha as versões recomendadas do mecanismo, os SDKs necessários e as configurações do projeto Android ao desenvolver um app do Unreal Engine para Android XR.
Pré-requisitos
Antes de configurar o Unreal Engine para o desenvolvimento de Android XR, instale os seguintes aplicativos e ferramentas:
Faça o download e instale o Epic Games Launcher.
- No Epic Games Launcher, instale a versão 5.6.1 (ou mais recente) do Unreal Engine.
Configure seu sistema para criar código C++, por exemplo, usando o Visual Studio 2022 para Windows ou o Xcode para macOS. Para mais informações, consulte a configuração do ambiente de desenvolvimento em C++ da Epic.
Instale o SDK do.NET 8.0.
Instale o Android Studio (Panda 4 | 2025.3.4 Patch 1 ou mais recente).
Instalar o suporte para build do Android
Como o Android XR depende de versões específicas do SDK, é necessário instalar as ferramentas de build do Android corretas junto com o Unreal Engine.
- Abra o Epic Games Launcher.
Clique na seta suspensa ao lado da versão instalada do mecanismo (botão "Iniciar") e clique em Opções.
- Role a tela até as opções de instalação, selecione Android e clique em Aplicar.
- Se solicitado, permita que o mecanismo registre as extensões de arquivo necessárias.
Instale o Java JDK 17.
No Android Studio, use o SDK Manager para instalar as seguintes versões específicas exigidas pelos exemplos do Android XR:
- Plataformas do SDK: 34, 35 e 36
- NDK: 29.0.x
- Ferramentas de linha de comando (todos os itens)
Siga o guia avançado de configuração e solução de problemas da Epic para configurar as seguintes variáveis de ambiente do sistema:
ANDROID_HOMEJAVA_HOMENDK_ROOT
Criar um projeto Unreal XR
Em seguida, crie um projeto e configure-o com os plug-ins e entradas de XR necessários:
- Inicie o Unreal Engine 5.6.1.
- Em Novas categorias de projetos, selecione o modelo Realidade virtual.
- No menu Padrões do projeto, defina a Plataforma de destino como Dispositivo móvel.
- Defina a predefinição de qualidade como escalonável para promover o desempenho ideal no hardware XR móvel.
- Escolha um nome para o projeto e clique em Criar.
Definir configurações do Android
Depois que o projeto for aberto, conclua estas etapas para definir os níveis de API do Android e as configurações de gráficos necessárias para o Android XR:
- Acesse Editar > Configurações do projeto.
- Acesse Plataformas > Android.
- Se o botão Aceitar licença do SDK estiver destacado em vermelho, clique nele.
- Na seção APKPackaging:
- Defina Versão mínima do SDK como
34. - Defina a versão do SDK de destino como
34(ou mais recente).
- Defina Versão mínima do SDK como
Role a tela até a seção Build e selecione Support Vulkan.
O Vulkan é a API gráfica recomendada e de alto desempenho para o Android XR.
Definir configurações de renderização
Para alcançar as altas taxas de frames e a clareza visual necessárias para o Android XR, você também precisa configurar o Unreal Engine para usar o caminho de renderização móvel otimizado:
- Acesse Edit > Project Settings e navegue até Engine > Rendering.
Na seção Renderizador de encaminhamento, selecione Sombreamento de encaminhamento.
O renderizador direto é muito mais rápido para realidade virtual móvel do que o renderizador adiado padrão. Para ativar esse recurso, é necessário reiniciar o editor e compilar o shader.
Na seção Configurações padrão, defina o Método de antialiasing como MSAA.
Na seção Dispositivo móvel, defina MSAA para dispositivos móveis como 4x.
O MSAA oferece os resultados mais nítidos para VR sem os efeitos de desfoque causados pelo AA temporal (TAA).
Na seção RV:
Desmarque HDR móvel.
Desativar o HDR em dispositivos móveis reduz drasticamente a sobrecarga de pós-processamento.
Selecione Visualização Múltipla para Dispositivos Móveis.
Isso permite que o mecanismo renderize os dois olhos em uma única passagem, melhorando significativamente o desempenho da CPU.
Consulte também
Para instruções detalhadas sobre como implantar um projeto de modelo em um dispositivo Android, consulte Configurar projetos do Unreal Engine para desenvolvimento no Android.