Unity-Projekt einrichten

In diesem Leitfaden werden die empfohlenen Editorversionen, Grafikeinstellungen, URP-Einstellungen und Android-Projekteinstellungen für die Entwicklung einer Unity-Anwendung für Android XR beschrieben.

Voraussetzungen

Wenn Sie mit Unity entwickeln möchten, müssen Sie Unity Hub herunterladen und installieren.

Installieren Sie die Version 6000.0.23f1 oder höher des Unity-Editors und den Android Build Support. Dazu gehören:

  • OpenJDK
  • Android SDK
  • Android NDK-Tools

Rendering-Engine auswählen

Wir empfehlen die Verwendung der Vulkan Graphics API zum Rendern von Android XR-Apps. So wählen Sie Vulkan als Grafik-API aus:

  1. Klicken Sie in Unity auf Bearbeiten > Projekteinstellungen > Player.
  2. Wählen Sie den Tab Android und dann Weitere Einstellungen > Rendering aus.
  3. Wenn Auto Graphics API aktiviert ist, deaktivieren Sie diese Einstellung, um den Bereich Graphics APIs aufzurufen.

  4. Klicken Sie im Bereich Grafik-APIs auf die Schaltfläche Hinzufügen (+) und wählen Sie im Drop-down-Menü Vulkan aus.

    Beispiel, das zeigt, wie die Einstellungen der Grafik-API in der Benutzeroberfläche geändert werden

  5. Ordnen Sie die Grafik-APIs mithilfe der Handles (=) neu an, sodass Vulkan zuerst aufgeführt wird.

  6. Optional können Sie weitere Grafik-APIs auswählen und auf die Schaltfläche Entfernen (–) klicken, um sie zu entfernen.

Universal Render Pipeline

Android XR ist mit der Universal Render Pipeline (URP) kompatibel. Wenn Sie die Passthrough-Funktion verwenden möchten, sollten Sie die Standard-URP-Einstellungen aktualisieren, um die beste Passthrough-Leistung auf Android XR zu erzielen.

In der folgenden Tabelle finden Sie eine Liste der von Unity empfohlenen URP-Einstellungen, die in den folgenden Abschnitten ausführlicher erläutert werden.

Einstellung

Standort

Empfohlener Wert

HDR

Universal Render Pipeline Asset

Deaktiviert

Nachbearbeitung

Universal Renderer Data

Deaktiviert

Asset-Einstellungen der Universal Render Pipeline

So optimieren Sie Ihr Universal Render Pipeline-Asset für Android XR:

  1. Suchen Sie das Universal Render Pipeline-Asset Ihres Projekts. Eine Möglichkeit dazu ist, t:UniversalRenderPipelineAsset in die Suchleiste des Fensters Projekt einzugeben.

  2. Deaktivieren Sie unter dem Header Qualität die Option HDR.

    Universal Render Pipeline-Asset mit empfohlenen Einstellungen

Einstellungen für Universal Renderer-Daten

So optimieren Sie Ihre Universal Renderer Data für Android XR:

  1. Suchen Sie das Universal Renderer Data Asset Ihres Projekts. Sie können dazu beispielsweise t:UniversalRendererData in die Suchleiste des Fensters Projekt eingeben.

  2. Entfernen Sie im Inspector unter der Überschrift Nachbearbeitung das Häkchen bei Aktiviert.

    Universal Renderer-Daten mit empfohlenen Einstellungen

Mindest-Android-API-Level

Legen Sie für Ihr Projekt ein Mindest-API-Level von 24 fest, das vom OpenXR-Ladeprogramm benötigt wird. Andernfalls können Ihre Builds fehlschlagen.

So legen Sie die minimale Android API-Ebene fest:

  1. Gehe zu Bearbeiten > Projekteinstellungen > Wiedergabe.
  2. Wählen Sie den Tab „Android“ und dann Weitere Einstellungen aus.
  3. Wählen Sie im Abschnitt Identifikation für Minimale API-Ebene die Option „24“ oder höher aus.

Anwendungseinstiegspunkt

Konfigurieren Sie die folgenden Einstellungen für den Anwendungs-Einstiegspunkt:

  1. Gehe zu Bearbeiten > Projekteinstellungen > Wiedergabe.
  2. Wählen Sie den Tab Android und dann Weitere Einstellungen aus.
  3. Achten Sie im Abschnitt Application Entry Point darauf, dass GameActivity aktiviert und Activity deaktiviert ist.

Pop-up-Fenster

Die meisten Android XR-Apps erfordern Fenster, die sich in der Größe ändern lassen, da sie Pop-ups wie Systemberechtigungsanfragen rendern müssen.

So sorgen Sie dafür, dass Pop-up-Fenster richtig gerendert werden:

  1. Gehe zu Bearbeiten > Projekteinstellungen > Wiedergabe.
  2. Wählen Sie den Tab Android aus und aktivieren Sie Resizeable Activity.

Siehe auch