Configuración del proyecto de Godot 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 Godot Engine para Android XR.

Requisitos previos

Antes de configurar un proyecto de Godot Engine para el desarrollo de Android XR, debes completar los siguientes requisitos previos:

1. Descarga Godot 4.6.2 del sitio web oficial de Godot.
2. Asegúrate de tener un visor de realidad extendida o algunos lentes de realidad extendida.
3. Instala Android Studio.

Instala la compatibilidad con la compilación de Android

Godot requiere herramientas de compilación de Android específicas para compilar y exportar paquetes para la computación espacial.

1. En Android Studio, usa SDK Manager para instalar los siguientes paquetes y herramientas:

   • Plataforma del SDK de Android: Android 14.0 ("UpsideDownCake") (nivel de API 34)
   • SDK de Android Build-Tools: Versión 34.0.0 o posterior
   • NDK: Cualquier versión 28.x
   • CMake: Versión 3.10.2

   Es posible que debas seleccionar Show Package Details en SDK Manager para ver todas las versiones disponibles de una herramienta.

2. En Godot, ve a Editor > Editor Settings > Export > Android y proporciona la ruta de acceso a tu SDK.

Crea un proyecto de Godot XR

Configura un proyecto nuevo para la renderización espacial:

1. Abre Godot y crea un proyecto nuevo.

2. En Renderer, selecciona Mobile.

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

   

3. Selecciona cualquier otra opción que desees y haz clic en Create.

4. Construye tu escena interna de realidad extendida (incluidos XROrigin3D y XRCamera3D) con la Guía oficial de configuración de escenas de realidad extendida de Godot.

   

Define la configuración del proyecto

A continuación, configurarás los parámetros de configuración del proyecto para habilitar OpenXR y configurar la canalización de renderización para el rendimiento de dispositivos móviles:

1. Abre Godot.
2. Configura los siguientes parámetros de configuración del proyecto para OpenXR:
   • Ve a Project > Project Settings > XR > OpenXR y selecciona Enabled.
   • Ve a Project > Project Settings > XR > Shaders y selecciona Enabled.

3. Ve a Rendering > Anti Aliasing > Quality > MSAA 3D y selecciona 4x.

   Este parámetro de configuración proporciona la mejor claridad en Android XR.

Configura tu proyecto para exportar a Android XR

Completa los siguientes pasos para configurar tu proyecto para exportar a Android XR:

1. Configura un ajuste preestablecido de exportación: Ve a Project > Export y haz clic en Add... > Android.

2. Completa la Guía de implementación: Sigue la Guía oficial de implementación de Android de Godot para obtener instrucciones paso a paso sobre los permisos y la implementación con un solo clic.

3. Verifica las versiones del SDK de tu proyecto:

   • Para el SDK mínimo: 34
   • Para el SDK de destino: 34

4. Configura el modo de realidad extendida: Establece el modo de realidad extendida en OpenXR en la configuración de exportación.

Instala el complemento de proveedores de OpenXR de Godot

Tu app debe usar el complemento de proveedores para acceder a extensiones específicas de Android XR. Sigue estos pasos para obtener una versión compatible:

1. En Godot, selecciona AssetLib.

2. Busca "Vendor".

   

3. Busca la versión 5.1 (o posterior) del complemento de proveedores de OpenXR de Godot y descárgala.

4. Una vez que se complete la descarga, selecciona Install.

   

Consulta también

Para obtener más información sobre el desarrollo de Android XR con Godot, consulta las siguientes páginas en la documentación de Godot Engine:

• Documentación oficial de realidad extendida de Godot
• Documentación de exportación de Android de Godot