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 Version 6000.0.58f2 oder höher des Unity-Editors und Android Build Support, der Folgendes umfasst:

  • OpenJDK
  • Android SDK
  • Android NDK-Tools

Rendering-Engine auswählen

Wir empfehlen, die Vulkan Graphics API zum Rendern von Android XR-Apps zu verwenden. 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 aus und gehen Sie zu Weitere Einstellungen > Rendering.
  3. Wenn die Auto Graphics API aktiviert ist, deaktivieren Sie diese Einstellung, um den Bereich Graphics APIs (Grafik-APIs) aufzurufen.

  4. Wählen Sie im Abschnitt Graphics APIs (Grafik-APIs) die Schaltfläche Hinzufügen (+) und dann im Drop-down-Menü Vulkan aus.

    Beispiel für das Ändern der Grafiken-API-Einstellungen in der Benutzeroberfläche

  5. Ordnen Sie die Grafik-APIs mit den Ziehpunkten (=) neu an, sodass Vulkan an erster Stelle steht.

  6. Optional können Sie andere 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 Passthrough verwenden möchten, sollten Sie die Standard-URP-Einstellungen aktualisieren, um die beste Passthrough-Leistung unter Android XR zu erzielen.

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

Einstellung

Standort

Empfohlener Wert

HDR

Universal Render Pipeline Asset

Deaktiviert

Nachbearbeitung

Universelle Renderer-Daten

Deaktiviert

Asset-Einstellungen für die 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-Daten für Android XR:

  1. Suchen Sie das Universal Renderer Data Asset Ihres Projekts. Eine Möglichkeit dazu ist, t:UniversalRendererData in die Suchleiste des Fensters Projekt einzugeben.

  2. Entfernen Sie im Inspector unter dem Header Post-processing (Nachbearbeitung) das Häkchen bei Enabled (Aktiviert).

    Mit empfohlenen Einstellungen angezeigte Daten des Universal Renderers

Mindest-Android-API‑Level

Legen Sie für Ihr Projekt das minimale API-Level 24 fest, das für den OpenXR-Loader erforderlich ist. Andernfalls schlagen Ihre Builds möglicherweise fehl.

Führen Sie die folgenden Schritte aus, um die minimale Android-API-Ebene festzulegen.

  1. Wählen Sie Bearbeiten > Projekteinstellungen > Player aus.
  2. Wählen Sie den Tab „Android“ aus und öffnen Sie Andere Einstellungen.
  3. Wählen Sie im Abschnitt Identifizierung für Mindest-API-Level die Option 24 oder höher aus.

Anwendungseinstiegspunkt

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

  1. Wählen Sie Bearbeiten > Projekteinstellungen > Player aus.
  2. Wählen Sie den Tab Android aus und öffnen Sie Andere Einstellungen.
  3. Achten Sie im Abschnitt Konfiguration darauf, dass unter Application Entry Point (Anwendungseinstiegspunkt) GameActivity aktiviert und Activity deaktiviert ist.

Pop-up-Fenster

Die meisten Android XR-Apps erfordern Fenster mit anpassbarer Größe, da sie zum Rendern von Pop-ups wie Systemberechtigungsanfragen benötigt werden.

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

  1. Wählen Sie Bearbeiten > Projekteinstellungen > Player aus.
  2. Wählen Sie den Tab Android aus und öffnen Sie Auflösung und Darstellung.
  3. Aktivieren Sie im Bereich Auflösung die Option Resizable Activity (Aktivität mit anpassbarer Größe).

Siehe auch

OpenXR™ und das OpenXR-Logo sind Marken von The Khronos Group Inc. und sind in China, der Europäischen Union, Japan und dem Vereinigten Königreich als Marke eingetragen.