Unreal Engine-Projekt einrichten

XR‑Geräte, für die der Leitfaden gilt
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.
Informationen zu XR-Gerätetypen →
XR-Headsets
Kabelgebundene XR-Datenbrille
Informationen zu XR-Gerätetypen →

In diesem Leitfaden werden die empfohlenen Engine-Versionen, die erforderlichen SDKs und die Android-Projekteinstellungen für die Entwicklung einer Unreal Engine-App für Android XR beschrieben.

Vorbereitung

Bevor Sie die Unreal Engine für die Android XR-Entwicklung einrichten können, müssen Sie die folgenden Anwendungen und Tools installieren:

  1. Laden Sie den Epic Games Launcher herunter und installieren Sie ihn.

    1. Installieren Sie über den Epic Games Launcher die Version 5.6.x oder 5.8.x der Unreal Engine.

  2. Richten Sie Ihr System so ein, dass C++-Code erstellt werden kann (z. B. mit Visual Studio 2022 für Windows oder Xcode für macOS). Weitere Informationen finden Sie unter C++-Entwicklungsumgebung einrichten von Epic.

  3. Installieren Sie das .NET 8.0 SDK.

  4. Installieren Sie Android Studio (Rabbit 2 | 2026.2.2 oder höher).

Android-Build-Unterstützung installieren

Da Android XR auf bestimmte SDK-Versionen angewiesen ist, müssen Sie die richtigen Android-Build-Tools zusammen mit der Unreal Engine installieren.

  1. Öffnen Sie den Epic Games Launcher.

  2. Klicken Sie auf den Drop-down-Pfeil neben der installierten Engine-Version (Schaltfläche „Starten“) und dann auf Optionen.

    1. Scrollen Sie weiter zu den Installationsoptionen, wählen Sie Android aus und klicken Sie auf Übernehmen.
    2. Wenn Sie dazu aufgefordert werden, erlauben Sie der Engine, alle erforderlichen Dateiendungen zu registrieren.

  3. Installieren Sie Java JDK 17.

  4. Installieren Sie in Android Studio mit dem SDK-Manager die folgenden spezifischen Versionen, die für die Android XR-Beispiele erforderlich sind:

    • SDK-Plattformen: 34, 35 und 36
    • NDK: 29.0.x
    • Befehlszeilentools (alle Elemente)

  5. Folgen Sie der Anleitung zur erweiterten Einrichtung und Fehlerbehebung von Epic, um die folgenden Systemumgebungsvariablen zu konfigurieren:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Unreal XR-Projekt erstellen

Erstellen Sie als Nächstes ein neues Projekt und konfigurieren Sie es mit den erforderlichen XR-Plug-ins und -Eingaben:

  1. Starten Sie Unreal Engine (Version 5.6.x oder 5.8.x).
  2. Wählen Sie unter New Project Categories (Neue Projektkategorien) die Vorlage Virtual Reality aus.
  3. Legen Sie im Menü Projektstandardwerte die Zielplattform auf Mobil fest.
  4. Setzen Sie die Qualitätsvoreinstellung auf Skalierbar, um eine optimale Leistung auf mobiler XR-Hardware zu erzielen.
  5. Wählen Sie einen Projektnamen aus und klicken Sie auf Erstellen.

Android-Einstellungen konfigurieren

Nachdem Sie Ihr Projekt geöffnet haben, führen Sie die folgenden Schritte aus, um die erforderlichen Android API-Level und Grafikeinstellungen für Android XR festzulegen:

  1. Wählen Sie Edit > Project Settings (Bearbeiten > Projekteinstellungen) aus.
  2. Gehen Sie zu Platforms > Android (Plattformen > Android).
  3. Wenn die Schaltfläche SDK-Lizenz akzeptieren rot hervorgehoben ist, klicken Sie darauf.
  4. Im Abschnitt APKPackaging:
    • Legen Sie die Mindestens erforderliche SDK-Version auf 34 fest.
    • Legen Sie die SDK-Zielversion auf 34 (oder höher) fest.

  5. Scrollen Sie weiter zum Abschnitt Build und wählen Sie Support Vulkan (Vulkan unterstützen) aus.

    Vulkan ist die empfohlene, leistungsstarke Grafik-API für Android XR.

Rendering-Einstellungen konfigurieren

Um die für Android XR erforderlichen hohen Frameraten und die visuelle Klarheit zu erreichen, müssen Sie Unreal Engine auch so konfigurieren, dass der optimierte Renderingpfad für Mobilgeräte verwendet wird:

  1. Gehen Sie zu Edit > Project Settings (Bearbeiten > Projekteinstellungen) und rufen Sie Engine > Rendering auf.

  2. Wählen Sie im Abschnitt Forward Renderer die Option Forward Shading aus.

    Der Forward-Renderer ist für mobile VR deutlich schneller als der standardmäßige Deferred-Renderer. Wenn Sie diese Option aktivieren, müssen Sie den Editor neu starten und die Shader kompilieren.

  3. Legen Sie im Abschnitt Standardeinstellungen für die Anti-Aliasing-Methode den Wert MSAA fest.

  4. Setzen Sie im Bereich Mobilgeräte die Option MSAA für Mobilgeräte auf 4x.

    MSAA liefert die schärfsten Ergebnisse für VR ohne die Unschärfeeffekte, die durch Temporal AA (TAA) verursacht werden.

  5. Im Abschnitt VR:

    1. Entferne das Häkchen bei Mobile HDR.

      Wenn Sie High Dynamic Range auf Mobilgeräten deaktivieren, wird der Aufwand für die Nachbearbeitung drastisch reduziert.

    2. Wähle Multiview auf Mobilgeräten aus.

      Dadurch kann die Engine beide Augen in einem einzigen Durchgang rendern, was die CPU-Leistung erheblich verbessert.

Weitere Informationen

Eine ausführliche Anleitung zum Bereitstellen eines Vorlagenprojekts auf einem Android-Gerät finden Sie unter Unreal Engine-Projekte für die Android-Entwicklung einrichten.