Configuración del proyecto de Unreal Engine

En esta guía, se detallan las versiones recomendadas del motor, los SDKs requeridos 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 Epic Games Launcher.

   1. Desde el iniciador de Epic Games, instala la versión 5.6.1 (o una posterior) 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 (Panda 4 | 2025.3.4 parche 1 o una versión posterior).

Cómo instalar la compatibilidad con la compilación de Android

Dado que 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 Epic Games Launcher.

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

   1. Desplázate 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 SDK Manager para instalar las siguientes versiones específicas que requieren los ejemplos 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 avanzada de configuración 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 Unreal XR

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

1. Inicia Unreal Engine 5.6.1.
2. En New Project Categories, selecciona la plantilla Virtual Reality.
3. En el menú Project Defaults, configura la Target Platform como 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.

Configura los parámetros de Android

Una vez que se abra tu proyecto, completa estos pasos para establecer los niveles de API de Android y la configuración de gráficos requeridos 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 Minimum SDK Version en 34.
   • Establece la versión del SDK de destino en 34 (o una versión posterior).

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

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

Cómo configurar los parámetros de renderización

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

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

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

   El renderizador de avance es mucho más rápido para la RV en dispositivos móviles que el renderizador diferido predeterminado. Ten en cuenta que habilitar esta opción requiere que se reinicie el editor y se compile el sombreador.

3. En la sección Configuración predeterminada, establece el Método de suavizado en 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 AA temporal (TAA).

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

   1. Borra HDR para dispositivos móviles.

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

   2. Selecciona Vista múltiple móvil.

      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 Cómo configurar proyectos de Unreal Engine para el desarrollo de Android.