Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Usar el editor XR

En 2024, presentamos el «editor Godot XR <https://godotengine.org/article/godot-editor-horizon-store-early-access-release/>`__, una versión del editor Godot diseñada para ejecutarse de forma nativa en dispositivos XR, lo que permite la creación, el desarrollo y la exportación de aplicaciones y juegos 2D, 3D y XR directamente en el dispositivo.

The app can be downloaded from the Google Play Store, Meta Horizon Store, or from the Godot download page.

Nota

El editor XR está en acceso anticipado mientras seguimos perfeccionando la experiencia. Véase Limitaciones y problemas conocidos a continuación.

XR devices support

For now, the Godot XR editor is only available for Android XR devices, and the following Meta Quest devices running Meta Horizon OS v69 or higher:

• Meta Quest 2

• Meta Quest 3

• Meta Quest 3s

• Meta Quest Pro

Nota

Estamos trabajando para agregar soporte para más dispositivos XR, incluidos los dispositivos PCVR.

Permisos de tiempo de ejecución

• All files access permission: Enables the editor to create, import, and read project files from any file locations on the device. Without this permission, the editor is still functional, but has limited access to the device's files and directories.

• REQUEST_INSTALL_PACKAGES: Permite al editor instalar APK de proyectos exportados.

• RECORD_AUDIO: Se solicita cuando la configuración del proyecto audio/driver/enable_input está habilitada.

• USE_SCENE (META ONLY): Required to enable and access the scene APIs when running an XR project.

Consejos y trucos

Entrada

• Para una mejor experiencia y un alto nivel de productividad, se recomienda conectar un teclado y un ratón Bluetooth para interactuar con el editor XR. El editor XR admite todos los atajos y asignaciones de teclas habituales (https://docs.godotengine.org/en/stable/tutorials/editor/default_key_mapping.html).

• Al interactuar con controladores rastreados o manos rastreadas, puede activar la configuración del editor interface/touchscreen/enable_long_press_as_right_click para habilitar el clic derecho mediante una pulsación prolongada.

• Al interactuar con controladores o manos rastreadas, puede aumentar el tamaño de la barra de desplazamiento usando la configuración del editor interface/touchscreen/increase_scrollbar_touch_area.

Multi-tasking on Quest

• Theater View can be used to fullscreen the Editor window.

• Habilite Multitarea sin interrupciones, disponible en Configuración experimental de Quest, para habilitar la capacidad de realizar una transición rápida entre un proyecto XR en ejecución y la ventana del editor.

• Al desarrollar un proyecto que no sea XR, el icono de la aplicación del editor Godot brindará la posibilidad de cambiar entre la ventana del editor y la ventana de reproducción cuando esta última esté activa, usando la función Menú de aplicaciones de Quest.

• Al desarrollar y ejecutar un proyecto XR, puede recuperar la ventana del editor de la siguiente manera:

  • Presionar el botón Meta para invocar la barra de menú

  • Haciendo clic en el icono de la aplicación del editor Godot para abrir el Menú de la aplicación y seleccionando el mosaico Ventana del editor.

Sincronización de proyectos

• La sincronización de proyectos mediante Git, puede realizarse al descargar un cliente de Git para Android. Recomendamos Terminal Termux, un emulador de terminal de Android que proporciona acceso a utilidades de terminal comunes como Git y SSH.

  • Nota: Para usar Git con la terminal de Termux, deberá otorgarle permiso de ESCRITURA. Esto se puede hacer ejecutando el siguiente comando <https://wiki.termux.com/wiki/Termux-setup-storage> desde la terminal: termux-setup-storage

Plugins

• Los plugins de GDExtension funcionan como se espera, pero requieren que el desarrollador del plugin proporcione binarios nativos de Android.

Limitaciones y problemas conocidos

Estas son las limitaciones y problemas conocidos del editor XR:

• No hay soporte para C#/Mono.

• Sin soporte para editores de scripts externos.

• Aunque disponible, el renderizador Vulkan Forward+ no está recomendado debido a los severos problemas de rendimiento.