Anleitungen

Erste Schritte mit Unity und Android XR

Lesezeit: 6 Minuten
Profil von Luke Hopkins ansehen
Luke Hopkins Developer Relations Engineer, Android

Samsung Galaxy XR ist da – mit Android XR! Dieser Blogpost ist Teil unserer Android XR Spotlight Week, in der wir Ressourcen wie Blogposts, Videos, Beispielcode und mehr bereitstellen, um Ihnen zu helfen, Ihre Apps für Android XR zu entwickeln und vorzubereiten. 

Es gab noch nie einen besseren Zeitpunkt, um in die XR-Entwicklung einzusteigen. Im Dezember haben wir Android XR angekündigt, die neue Android-Plattform von Google, die auf offenen Standards wie OpenXR und Vulkan basiert und die XR-Entwicklung so zugänglich wie nie zuvor macht.


In Kombination mit den vorhandenen XR-Tools von Unity erhalten Sie einen leistungsstarken und ausgereiften Entwicklungs-Stack. So können XR-Apps erstellt und bereitgestellt werden, die auf mehreren Geräten funktionieren.

openxr_face_tracking2.webp

Unabhängig davon, ob Sie bereits Erfahrung mit der XR-Entwicklung haben oder nicht, möchten wir Ihnen den Einstieg erleichtern.

In diesem Blog erfahren Sie, wie Sie mit der Entwicklung für Android XR und Unity beginnen können. Wir konzentrieren uns auf die praktischen Schritte, um Ihre Umgebung zu konfigurieren, das Paket-Ökosystem zu verstehen und mit dem Erstellen zu beginnen.

Am Ende dieses Blogs werden Sie ein gutes Verständnis für Folgendes haben:

  • Paket-Ökosystem
  • Wichtige Einrichtungsschritte
  • Eingabemethoden
  • Datenschutz und Berechtigungen
  • Kompositionsebenen

Unity für die Android XR-Entwicklung

Unity ist aufgrund seiner plattformübergreifenden Kompatibilität eine gute Wahl. Sie können einmal entwickeln und dann auf Android XR und anderen XR-Geräten bereitstellen.

Wenn Sie Unity verwenden, profitieren Sie von einem ausgereiften XR-Ökosystem und entsprechenden Tools. Es bietet bereits etablierte Pakete wie das XR Interaction Toolkit, das OpenXR-Plug-in, XR-Kompositionsebenen, XR Hands, einen umfangreichen Asset Store mit XR-kompatiblen Komponenten und Vorlagen sowie XR-Simulations- und Testtools. Seit der Veröffentlichung von Unity 6 im November profitieren Sie außerdem von der verbesserten Leistung der Universal Render Pipeline (URP), der besseren Unterstützung von Vulkan-Grafiken und den erweiterten Build-Profilen.

Hier sind einige Beispielprojekte, die Ihnen eine Vorstellung davon geben, was möglich ist:

Grundlegende Einrichtung: Ihre Entwicklungsgrundlage

Unity 6 – Anforderungen und Installation

Sie benötigen Unity 6, um Ihre App zu erstellen, da frühere Versionen Android XR nicht unterstützen. Installieren Sie zuerst Unity Hub und dann Unity 6 mit dem Android Build Support-Modul. Folgen Sie dazu dieser Anleitung.

unity6.png

Android XR-Build-Profile: Vereinfachung der Konfiguration

Unity-Build-Profile sind Projekt-Assets, in denen Ihre plattformspezifischen Einstellungen und Konfigurationen gespeichert werden. Anstatt 15–20 verschiedene Einstellungen in mehreren Menüs manuell festzulegen, können Sie ein Build-Profil verwenden, um dies automatisch zu tun.
Sie können Ihre eigenen Build-Profile erstellen, aber wir empfehlen, das von uns erstellte dedizierte Android XR-Build-Profil zu verwenden.

Sie können Ihr Build-Profil auswählen, indem Sie in Ihrem Unity-Projekt „Datei“ > „Build-Profil“ auswählen. Eine vollständige Anleitung findest du auf der Workflow-Seite Für Android XR entwickeln.

Wenn Sie eigene Änderungen vornehmen, können Sie ein neues Build-Profil erstellen und es für Ihr Team freigeben. So sorgen Sie für eine einheitliche Build-Erfahrung.

buildprofiles.png

Nach diesen Schritten können Sie Ihr APK für Android XR-Geräte erstellen und ausführen.

Grafik-API: Warum Vulkan wichtig ist

Nachdem Sie Ihr Unity-Projekt mit einem Android XR-Build-Profil eingerichtet haben, sollten Sie zuerst prüfen, ob Vulkan als Grafik-API festgelegt ist. Android XR ist als Vulkan-First-Plattform konzipiert. Im März 2025 kündigte Google an, dass Vulkan jetzt die offizielle Grafik-API für Android ist. Es handelt sich um eine moderne, hardwarenahe Grafik-API, mit der Entwickler die Leistung moderner GPUs maximieren und erweiterte Funktionen wie Raytracing und Multithreading für realistische und immersive Gaming-Grafiken freischalten können.

Diese Standards bieten die beste Kompatibilität für Ihre vorhandenen Anwendungen und reduzieren die Probleme und Kosten der Portierung. Außerdem können Sie erweiterte Android XR-Funktionen wie URP Application Space Warp und Foveated Rendering aktivieren. 

Unity 6 verarbeitet Vulkan automatisch. Wenn Sie also das Android XR-Build-Profil verwenden, konfiguriert Unity Vulkan als Grafik-API. So erhalten Sie Zugriff auf alle erweiterten Android XR-Funktionen, ohne dass eine manuelle Konfiguration erforderlich ist.

Sie können Ihre Einstellungen für die Grafik-API unter „Bearbeiten“ > „Projekteinstellungen“ > „Player“ > „Android-Tab“ > „Weitere Einstellungen“ > „Grafik-APIs“ prüfen.

graphics-api.png
appentrypoint.png

Das Paket-Ökosystem

Für Android XR in Unity sind zwei verschiedene Pakete verfügbar. Eine Möglichkeit ist die Verwendung der Android XR-Erweiterungen für Unity, die andere die Verwendung des Unity OpenXR: Android XR-Pakets.

Das klingt vielleicht nach ein und derselben Sache, aber lassen Sie mich das erklären.

Das Paket Unity OpenXR: Android XR ist das offizielle Unity-Paket für die Android XR-Unterstützung. Er bietet die meisten Android XR-Funktionen, die über OpenXR-Standards verfügbar gemacht werden. Außerdem wird die Integration von AR Foundation für Mixed-Reality-Funktionen ermöglicht. Der Hauptvorteil des Unity OpenXR: Android XR-Pakets besteht darin, dass es eine einheitliche API zur Unterstützung von XR-Geräten bietet.


Die Android XR-Erweiterungen für Unity sind das XR-Paket von Google, das speziell für die Entwicklung für Android XR-Geräte entwickelt wurde. Es ergänzt das Unity OpenXR-Paket um zusätzliche Funktionen wie Umgebungsüberblendungsmodi, Szenen-Meshing, Bild-Tracking und Körper-Tracking. Der Nachteil ist, dass Sie nur für Android XR-Geräte entwickeln können.


Welche Option Sie wählen, hängt von Ihren spezifischen Anforderungen ab. Wir empfehlen jedoch im Allgemeinen Unity OpenXR: Android XR, da Sie damit weitaus mehr Flexibilität bei den Geräten haben, mit denen Ihre App kompatibel ist. Je nach den Anforderungen Ihrer Anwendung können Sie dann Android XR-Erweiterungen für Unity hinzufügen.

Pakete installieren

Wenn Sie ein neues Paket hinzufügen möchten, öffnen Sie Ihr Projekt in Unity und wählen Sie „Window“ > „Package Management“ > „Package Manager“ aus.

Hier können Sie diese Pakete über den Tab „Unity Registry“ installieren:

packagemanager.png

Sie können das Android XR-Paket für Unity über GitHub installieren. Wählen Sie dazu das Pluszeichen ➕ und dann „Install package from git URL“ (Paket über Git-URL installieren) aus und geben Sie „https://github.com/android/android-xr-unity-package.git“ ein.

packagemanager2.png

Erforderliche OpenXR-Funktionen

Nachdem Sie die erforderlichen Pakete installiert haben, aktivieren Sie einige Hauptfunktionen, damit Ihr Projekt funktioniert.

Sie können die OpenXR-Einstellung für Android aktivieren: „Edit“ -> „Projekteinstellungen“ -> „XR Plugin Management“ -> Klicken Sie auf „Android“ und aktivieren Sie „OpenXR“.

xrpluginmgmt.png

Als Nächstes müssen wir die Unterstützung für „Android XR-Unterstützung“ aktivieren. Andere OpenXR-Funktionen werden wir bei Bedarf behandeln. Derzeit muss nur die Unterstützung für Android XR aktiviert sein.

Eingabe

Android XR unterstützt die Eingabe per Hand, Stimme, Eye-Tracking, Tastatur und Controller. Wir empfehlen, das XR Interaction Toolkit und XR Hands zu installieren, da diese die besten Prefabs für den Einstieg enthalten. Mit diesen Prefabs haben Sie alles, was Sie für die Unterstützung von Händen und Controllern in Ihrer App benötigen.

xrinteractiontoolkit.png

Nachdem sowohl das XR Hands- als auch das XR Interactive-Toolkit installiert wurden, empfehle ich, die Starter-Assets und die Hands Interaction Demo zu importieren. Anschließend müssen Sie die Profile Hand Interaction und Khronos Simple Controller aktivieren und die Funktionen „Handtracking Subsystem“ und „Meta Handtracking Aim“ aktivieren.

Sie können diese Einstellungen unter Edit > Project Settings > XR Plug-in Management > OpenXR bearbeiten.

profiles.png

Wir empfehlen außerdem das Unity-Prefab XR Origin, das die Position und Ausrichtung des Nutzers im XR-Bereich darstellt. Dieses enthält die Kamera-Rig- und Tracking-Komponenten, die zum Rendern Ihrer XR-Inhalte aus dem richtigen Blickwinkel erforderlich sind.

Am einfachsten lässt sich dieses Prefab hinzufügen, indem Sie es aus der Demo zur Handintegration importieren, die wir zuvor importiert haben. Sie finden es unter Hands Integration Toolkit > Hand Interaction > Prefabs > XR Origin.

prefabs.png

Ich empfehle, dieses Prefab anstelle der Option „XR Origin“ in Ihren Spielobjekten zu verwenden, da es den XR Input Modality Manager verwendet, der automatisch zwischen den Händen und Controllern des Nutzers wechselt. So lässt sich am besten zwischen Händen und Controllern wechseln.

Datenschutz und Berechtigungen: Vertrauen der Nutzer gewinnen

Unabhängig davon, was Sie entwickeln, müssen Sie Laufzeitberechtigungen von den Nutzern einholen. Das liegt daran, dass die Umgebungserkennung, das Eye-Tracking, die Mimik-Erkennung und das Handtracking Zugriff auf Daten ermöglichen, die für den Nutzer möglicherweise sensibler sind.

Diese Funktionen bieten mehr personenbezogene Daten als herkömmliche Desktop- oder mobile Apps. Mit den Laufzeitberechtigungen haben Nutzer die volle Kontrolle darüber, welche Daten sie freigeben möchten. Um die Sicherheits- und Datenschutzrichtlinien von Android einzuhalten, gibt es in Android XR Berechtigungen für jede dieser Funktionen.

Wenn Sie beispielsweise das XR Hands-Paket für benutzerdefinierte Handgesten verwenden, müssen Sie die Berechtigung für das Handtracking anfordern (siehe unten), da dieses Paket viele Informationen über die Hände des Nutzers erfassen muss. Dazu gehören beispielsweise das Erfassen der Handgelenkspositionen sowie der Winkel- und Lineargeschwindigkeiten.

Hinweis: Eine vollständige Liste der Erweiterungen, für die Berechtigungen erforderlich sind, finden Sie auf der XR-Entwicklerwebsite.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Visuelle Qualität mit Kompositionsebenen verbessern

Eine Kompositionsebene ist die empfohlene Methode zum Rendern von UI-Elementen. Damit können Elemente in einer viel höheren Qualität als mit der Standard-Rendering-Pipeline von Unity angezeigt werden, da alles direkt im Compositor der Plattform gerendert wird.

Wenn Sie beispielsweise Text anzeigen, ist es wahrscheinlicher, dass das Standard-Unity-Rendering unscharfen Text, weiche Kanten und visuelle Artefakte aufweist. Mit Kompositionsebenen ist der Text klarer, die Umrisse sind schärfer und die Nutzung ist insgesamt besser.


Neben Text werden auch Videos, Bilder und UI-Elemente in einer viel höheren Qualität gerendert. Dazu wird die native Unterstützung für die Compositor-Ebenen der Laufzeit genutzt.

Wenn du Composition Layers aktivieren möchtest, öffne den Package Manager, wähle „Unity Register“ aus und installiere „XR Composition Layers“.

Erstellen und ausführen

Nachdem Sie die OpenXR-Pakete installiert und die Funktionen aktiviert haben, können Sie jetzt ein Prefab-Setup für Hand- und Kopfbewegungen erstellen und direkt auf Ihrem Headset testen.

Nächste Schritte: Fähigkeiten erweitern

Nachdem Sie Ihre Android XR-Entwicklungsumgebung eingerichtet und die wichtigsten Konzepte verstanden haben, können Sie mit den folgenden Schritten Ihre XR-Entwicklung fortsetzen:

Wichtige Ressourcen für die Weiterbildung:

Beispielprojekte:

Verfasst von:
Weiterlesen