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

Auslieferung für Android

Einrichtung

Die meisten Standalone-Headsets laufen unter Android, und die OpenXR-Unterstützung macht sich auf dem Weg zu diesen Plattformen.

Bevor Sie die OpenXR-spezifischen Anweisungen befolgen, müssen Sie zunächst Ihr System für den Export zu Android im Allgemeinen einrichten, einschließlich:

• Installieren von OpenJDK 17

• Installieren von Android Studio

• Configuring the location of the Android SDK in Godot

Siehe Exportieren für Android für die vollständigen Details. Kehren Sie hierher zurück, wenn Sie diese Schritte abgeschlossen haben.

Warnung

Der Mobile Vulkan-Renderer bietet zwar viele Optimierungen für mobile Geräte, aber wir arbeiten noch an kleinen Macken. Es ist sehr ratsam, im Moment noch den Kompatibilität-Renderer zu verwenden (OpenGL), wenn Sie für Android-basierte XR-Geräte entwickeln.

Gradle-Android-Build

Bemerkung

Offizielle Unterstützung für die Android-Plattform wurde der OpenXR-Spezifikation zunächst nicht hinzugefügt, was dazu führte, dass verschiedene Anbieter eigene Loader erstellten, um OpenXR auf ihren Headsets verfügbar zu machen. Langfristig ist zu erwarten, dass alle Anbieter den offiziellen OpenXR-Loader übernehmen, aber zunächst müssen diese Loader zu Ihrem Projekt hinzugefügt werden.

Um den herstellerspezifischen OpenXR-Loader in Ihr Projekt einzubinden, müssen Sie einen Gradle-Android-Build einrichten.

Wählen Sie Android Build Template installieren... aus dem Menü Projekt:

Dadurch wird ein Ordner namens android innerhalb Ihres Projekts erstellt, der alle für Android benötigten Runtimes enthält. Sie können diese Installation nun anpassen. Godot zeigt dies nicht im Editor an, aber Sie können es mit einem Dateibrowser finden.

Sie können mehr über Gradle-Builds hier lesen: Gradle-Builds für Android.

Installation des Vendors-Plugins

The vendors plugin can be downloaded from the Asset Store, search for "OpenXR vendors".

You will find the installed files inside the addons folder. Alternatively you can manually install the vendors plugin by downloading it from the release page here. You will need to copy the assets/addons/godotopenxrvendors folder from the zip file into your projects addons folder.

Das Haupt-Repository des Vendors-Plugins finden Sie hier.

Bemerkung

From Godot 4.6 onwards, the vendor plugin is now an optional but recommended plugin. Godot can export directly to most Android-compatible devices. This can be useful for demonstration and tutorial projects where a single APK can be deployed to multiple devices. The vendor plugin unlocks vendor specific implementations and settings, and may be required to release on app stores.

Erstellen der Export-Vorgaben

Sie müssen für jedes Gerät eine eigene Exportvorgabe einrichten, da jedes Gerät seinen eigenen Loader benötigt.

Open Project and select Export... Click on Add.. and select Android. Next change the name of the export preset for the device you're setting this up for, say Meta Quest. And enable Use Gradle Build. Next change the XR Mode to OpenXR. If you want to use one-click deploy (described below), ensure that Runnable is enabled.

If you've installed the vendor plugin you will also find entries for the different headsets under XR Features. Select the entry for your headset, if you see one. Otherwise, enable the Khronos plugin.

Scroll to the bottom of the list and you'll find additional XR feature sections, currently only Meta XR Features, Pico XR Features, Magicleap XR Features and Khronos XR Features for HTC are available. You will need to select the appropriate settings if you wish to use these features.

Ausführung auf Ihrem Gerät vom Godot-Editor aus

Wenn Sie Ihre Exporteinstellungen wie oben beschrieben vorgenommen haben und Ihr Headset an Ihren Computer angeschlossen ist und korrekt erkannt wird, können Sie es direkt aus dem Godot-Editor mit Ein-Klick-Auslieferung starten:

Für einige Geräte auf einigen Plattformen müssen Sie möglicherweise einige zusätzliche Schritte durchführen, damit Ihr Gerät korrekt erkannt wird.

Beim Meta Quest 2 müssen Sie beispielsweise den Entwicklermodus auf dem Headset aktivieren, und wenn Sie Windows verwenden, müssen Sie spezielle ADB-Treiber installieren. Weitere Einzelheiten finden Sie in der offiziellen Meta Quest-Entwicklerdokumentation.

Wenn Sie Probleme mit der Ein-Klick-Bereitstellung haben, lesen Sie den Abschnitt Troubleshooting.