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 →

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 obligatorios 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 Epic Games Launcher, instala la versión 5.6.1 (o 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 (Quail 2 | 2026.1.2 o versiones posteriores).

Instala la compatibilidad con la compilación de Android

Debido a que Android XR se basa en versiones específicas del SDK, debes instalar las herramientas de compilación de Android correctas junto con Unreal Engine.

1. Abre Epic Games Launcher.

2. Haz clic en la flecha desplegable junto a la versión instalada del motor (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 Apply.
   2. Si se te solicita, permite que el motor registre las extensiones de archivo que requiera.

3. Instala Java JDK 17.

4. En Android Studio, usa 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
   • Command-line Tools (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 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, establece Target Platform en Mobile.
4. Establece Quality Preset en Scalable para promover un rendimiento óptimo en el hardware de XR para dispositivos móviles.
5. Elige un nombre para el proyecto y haz clic en Create.

Configura los parámetros de Android

Una vez que se abra 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 aparece resaltado en rojo, haz clic en él.
4. En la sección APKPackaging , haz lo siguiente:
   • Establece Minimum SDK Version en 34.
   • Establece Target SDK Version 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 recomendada y de alto rendimiento para Android XR.

Configura 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 directo es mucho más rápido para la RV para dispositivos móviles que el renderizador diferido predeterminado. Ten en cuenta que, para habilitar esta opción, se requiere un reinicio del editor y una compilación de sombreadores.

3. En la sección Default Settings, establece Anti-Aliasing Method en MSAA.

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

   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 Mobile HDR.

      Si inhabilitas el alto rango dinámico en dispositivos móviles, se reduce drásticamente la sobrecarga de 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 tecnología Android, consulta Cómo configurar proyectos de Unreal Engine para el desarrollo de Android.