Configuração do projeto do Unreal Engine

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Saiba mais sobre esses dispositivos →
Headsets XR
Óculos XR com fio
Saiba mais sobre esses dispositivos →

Este guia detalha as versões recomendadas do mecanismo, os SDKs necessários e as configurações do projeto do Android ao desenvolver um app do Unreal Engine para o Android XR.

Pré-requisitos

Antes de configurar o Unreal Engine para o desenvolvimento do Android XR, instale os seguintes aplicativos e ferramentas:

  1. Baixe e instale o inicializador da Epic Games.

    1. No Inicializador da Epic Games, instale a versão 5.6.x ou 5.8.x do Unreal Engine.

  2. 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.

  3. Instale o SDK do .NET 8.0.

  4. Instale o Android Studio (Rabbit 2 | 2026.2.2 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 com o Unreal Engine.

  1. Abra o Inicializador da Epic Games.

  2. Clique na seta suspensa ao lado da versão instalada do Engine (botão Iniciar) e clique em Opções.

    1. Role até as opções de instalação, selecione Android e clique em Apply.
    2. Se solicitado, permita que o mecanismo registre as extensões de arquivo necessárias.

  3. Instale o Java JDK 17.

  4. 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)

  5. Siga o guia de configuração avançada e solução de problemas da Epic para configurar as seguintes variáveis de ambiente do sistema:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Criar um projeto XR do Unreal

Em seguida, crie um novo projeto e configure-o com os plug-ins e as entradas de XR necessários:

  1. Inicie o Unreal Engine (versão 5.6.x ou 5.8.x).
  2. Em New Project Categories, selecione o modelo Realidade Virtual.
  3. No menu Project Defaults, defina a Target Platform como Mobile.
  4. Defina a Predefinição de qualidade como Escalonável para promover o desempenho ideal no hardware de XR para dispositivos móveis.
  5. Escolha um nome para o projeto e clique em Criar.

Defina as configurações do Android

Depois que o projeto estiver aberto, siga estas etapas para definir os níveis de API do Android e as configurações gráficas necessárias para o Android XR:

  1. Acesse Edit > Project Settings.
  2. Acesse Platforms > Android.
  3. Se o botão Accept SDK License estiver destacado em vermelho, clique nele.
  4. Na seção APKPackaging:
    • Defina Minimum SDK Version como 34.
    • Defina a Versão do SDK de destino como 34 (ou mais recente).

  5. Role para baixo até a seção Build e selecione Support Vulkan.

    A Vulkan é a API gráfica recomendada e de alto desempenho para o Android XR.

Definir as configurações de renderização

Para alcançar as altas taxas de quadros 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 otimizado para dispositivos móveis:

  1. Acesse Edit > Project Settings e navegue até Engine > Rendering.

  2. Na seção Forward Renderer, selecione Forward Shading.

    O renderizador de encaminhamento é significativamente mais rápido para RV móvel do que o renderizador adiado padrão. Para ativar esse recurso, é necessário reiniciar o editor e compilar o sombreador.

  3. Na seção Default Settings, defina o Anti-Aliasing Method como MSAA.

  4. Na seção Dispositivo móvel, defina MSAA para dispositivos móveis como 4x.

    O MSAA fornece os resultados mais nítidos para RV sem os efeitos de desfoque causados pelo AA temporal (TAA).

  5. Na seção VR:

    1. Desmarque HDR para dispositivos móveis.

      Desativar o High Dynamic Range em dispositivos móveis reduz drasticamente a sobrecarga de pós-processamento.

    2. Selecione Multiview 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 Como configurar projetos do Unreal Engine para desenvolvimento Android.