Configuración del proyecto de Unreal Engine

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Más información sobre los tipos de dispositivos de realidad extendida →
Visores de realidad extendida
Lentes de realidad extendida con cable
Más información sobre los tipos de dispositivos de realidad extendida →

En esta guía, se detallan las versiones recomendadas del motor, los SDKs necesarios y la configuración del proyecto de Android cuando se desarrolla una app de Unreal Engine para Android XR.

Requisitos previos

Antes de configurar Unreal Engine para el desarrollo de Android XR, debes instalar las siguientes aplicaciones y herramientas:

  1. Descarga e instala el Selector de Epic Games.

    1. Desde Epic Games Launcher, instala la versión 5.6.x o 5.8.x de Unreal Engine.

  2. Configura tu sistema para compilar código C++ (por ejemplo, con Visual Studio 2022 para Windows o Xcode para macOS). Para obtener más información, consulta la configuración del entorno de desarrollo de C++ de Epic.

  3. Instala el SDK de .NET 8.0.

  4. Instala Android Studio (Rabbit 2 | 2026.2.2 o una versión posterior).

Cómo instalar la compatibilidad con compilaciones de Android

Como Android XR depende de versiones específicas del SDK, debes instalar las herramientas de compilación de Android correctas junto con Unreal Engine.

  1. Abre el selector de Epic Games.

  2. Haz clic en la flecha desplegable junto a la versión instalada de Engine (botón Launch) y, luego, en Options.

    1. Desplázate más abajo hasta las opciones de instalación, selecciona Android y haz clic en Aplicar.
    2. Si se te solicita, permite que el motor registre las extensiones de archivo que necesite.

  3. Instala Java JDK 17.

  4. En Android Studio, usa el SDK Manager para instalar las siguientes versiones específicas que requieren las muestras de Android XR:

    • SDK Platforms: 34, 35 y 36
    • NDK: 29.0.x
    • Herramientas de línea de comandos (todos los elementos)

  5. Sigue la guía de configuración avanzada y solución de problemas de Epic para configurar las siguientes variables de entorno del sistema:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Crea un proyecto de XR de Unreal

A continuación, crea un proyecto nuevo y configúralo con los complementos y las entradas de XR necesarios:

  1. Inicia Unreal Engine (versión 5.6.x o 5.8.x).
  2. En New Project Categories, selecciona la plantilla Virtual Reality.
  3. En el menú Project Defaults, establece la Target Platform en Mobile.
  4. Establece el ajuste predeterminado de calidad en escalable para promover un rendimiento óptimo en el hardware de XR para dispositivos móviles.
  5. Elige un nombre para el proyecto y, luego, haz clic en Crear.

Establece la configuración de Android

Después de abrir el proyecto, completa estos pasos para establecer los niveles de API de Android y la configuración de gráficos necesarios para Android XR:

  1. Ve a Edit > Project Settings.
  2. Navega a Platforms > Android.
  3. Si el botón Accept SDK License está destacado en rojo, haz clic en él.
  4. En la sección APKPackaging, haz lo siguiente:
    • Establece la versión mínima del SDK en 34.
    • Establece la versión del SDK de destino en 34 (o una versión posterior).

  5. Desplázate más abajo hasta la sección Build y selecciona Support Vulkan.

    Vulkan es la API de gráficos de alto rendimiento recomendada para Android XR.

Establece la configuración de renderización

Para lograr las altas velocidades de fotogramas y la claridad visual que se requieren para Android XR, también debes configurar Unreal Engine para que use la ruta de renderización móvil optimizada:

  1. Ve a Edit > Project Settings y navega a Engine > Rendering.

  2. En la sección Forward Renderer, selecciona Forward Shading.

    El renderizador directo es mucho más rápido para la RV móvil que el renderizador diferido predeterminado. Ten en cuenta que, para habilitar esta opción, se debe reiniciar el editor y compilar el sombreador.

  3. En la sección Default Settings, configura Anti-Aliasing Method como MSAA.

  4. En la sección Mobile, establece Mobile MSAA en 4x.

    El MSAA proporciona los resultados más nítidos para la RV sin los efectos de desenfoque que causa el TAA.

  5. En la sección RV, haz lo siguiente:

    1. Borra HDR para dispositivos móviles.

      Inhabilitar el alto rango dinámico en dispositivos móviles reduce drásticamente la sobrecarga de procesamiento posterior.

    2. Selecciona Mobile Multi-View.

      Esto permite que el motor renderice ambos ojos en una sola pasada, lo que mejora significativamente el rendimiento de la CPU.

Consulta también

Para obtener instrucciones detalladas sobre cómo implementar un proyecto de plantilla en un dispositivo con Android, consulta Configura proyectos de Unreal Engine para el desarrollo de Android.