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...
Utilisation de l’éditeur XR
En 2024, nous avons introduit l'éditeur Godot XR, une version de l'éditeur de Godot conçue pour fonctionner nativement sur les appareils XR, permettant la création, le développement et l'exportation d'applications et de jeux 2D, 3D et XR directement sur l'appareil.
L'application peut être téléchargée à partir du Google Play Store, Meta Horizon Store, ou de la page de téléchargement de Godot.
Note
Cet éditeur XR est en bêta-test, pendant que nous continuons à raffiner l'expérience. Voir Limitations et problèmes connus ci dessous.
Support des appareils XR
Pour l'instant, l'éditeur Godot XR n'est disponible que pour les appareils Android XR, et les appareils Meta Quest suivants, avec Meta Horizon OS v69 ou supérieur :
Meta Quest 2
Meta Quest 3
Meta Quest 3s
Meta Quest Pro
Note
Nous travaillons à ajouter du support pour plus d'appareils XR, y compris des appareils PCVR.
Permissions pendant l'exécution
Permission d'accès à tous les fichiers : Permet à l'éditeur de créer, d'importer et de lire des fichiers de projet à partir de tous les emplacements de fichiers sur l'appareil. Sans cette autorisation, l'éditeur est toujours fonctionnel, mais a un accès limité aux fichiers et répertoires de l'appareil.
REQUEST_INSTALL_PACKAGES : Permet à l'éditeur d'installer les APKs du projet exporté.
USE_SCENE (META SEULEMENT) : Requis pour activer et accéder aux API de scène lors de l'exécution d'un projet XR.
Trucs & Astuces
Entrée
Pour une meilleure expérience et un haut niveau de productivité, il est recommandé de connecter un clavier et une souris bluetooth pour interagir avec l'éditeur XR. L'éditeur XR prend en charge tous les raccourcis habituels et mappages de touches.
When interacting with tracked controllers or tracked hands, you can toggle on the interface/touchscreen/enable_long_press_as_right_click editor setting to enable right-click by long press.
Lors de l'interaction avec des contrôleurs suivis ou des mains suivies, vous pouvez augmenter la taille de la barre de défilement en utilisant le paramètre de l'éditeur interface/touchscreen/increase_scrollbar_touch_area.
Multi-tasking sur Quest
Theater View can be used to fullscreen the Editor window.
Activez Multitâche fluide, disponible dans les Paramètres expérimentaux du Quest, pour permettre une transition rapide entre un projet XR en cours d'exécution et la fenêtre de l'éditeur.
Lors du développement d'un projet non-XR, l'icône de l'application d'éditeur Godot fournira la possibilité de passer entre la fenêtre Éditeur et la fenêtre Jouer lorsque cette dernière est active, en utilisant la fonction App menu du Quest.
Lorsque vous développez et exécutez un projet XR, vous pouvez ramener la fenêtre Éditeur en :
Pressing on the Meta button to invoke the menu bar
Clicking on the Godot editor app icon to summon the App menu, and select the Editor window tile.
Projects sync
La synchronisation des projets via Git peut être faite en téléchargeant un client Android Git. Nous recommandons le terminal Termux, un émulateur de terminal Android qui fournit l'accès aux utilitaires terminaux communs tels que Git et SSH.
Note : Pour utiliser Git avec le terminal Termux, vous devrez accorder une autorisation WRITE au terminal. Ceci peut être fait en exécutant la commande suivante à l'intérieur du terminal :
termux-setup-storage
Plugins
Les plugins GDExtension fonctionnent comme prévu, mais requirent au développeur de plugin de fournir des binaires Android natives.
Limitations et problèmes connus
Voici les limites connues et les problèmes de l'éditeur XR :
Pas de support C#/Mono.
Editeurs de scripts externes non-supporté.
Bien que disponible, le moteur de rendu Vulkan Forward+ n'est pas recommandé en raison de problèmes de performance graves.