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-Brillen
Informationen zu XR-Gerätetypen →

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

Vorbereitung

Bevor Sie 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.1 (oder höher) von Unreal Engine.

  2. Richten Sie Ihr System ein, um C++-Code zu erstellen (z. B. mit Visual Studio 2022 für Windows oder Xcode für macOS). Weitere Informationen finden Sie im Leitfaden zur Einrichtung der C++ Entwicklungsumgebung von Epic.

  3. Installieren Sie das .NET 8.0 SDK.

  4. Installieren Sie Android Studio (Panda 4 | 2025.3.4 Patch 1 oder höher).

Android-Build-Support installieren

Da für Android XR bestimmte SDK-Versionen erforderlich sind, müssen Sie die richtigen Android-Build-Tools zusammen mit 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. Erlauben Sie der Engine bei Aufforderung, alle erforderlichen Dateierweiterungen 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 Platforms: 34, 35 und 36
    • NDK: 29.0.x
    • Command-line Tools (alle Elemente)

  5. Folgen Sie der erweiterten Einrichtungs- und Fehlerbehebungsanleitung 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 5.6.1.
  2. Wählen Sie unter New Project Categories (Neue Projektkategorien) die Vorlage Virtual Reality (Virtuelle Realität) aus.
  3. Legen Sie im Menü Project Defaults (Projektstandardeinstellungen) für Target Platform (Zielplattform) die Option Mobile (Mobil) fest.
  4. Legen Sie für Quality Preset (Qualitätsvoreinstellung) die Option Scalable (Skalierbar) fest, um eine optimale Leistung auf mobiler XR-Hardware zu erzielen.
  5. Wählen Sie einen Projektnamen aus und klicken Sie dann auf Create (Erstellen).

Android-Einstellungen konfigurieren

Nachdem Sie Ihr Projekt geöffnet haben, führen Sie die folgenden Schritte aus, um die erforderlichen Android-API-Ebenen 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 Accept SDK License (SDK-Lizenz akzeptieren) rot hervorgehoben ist, klicken Sie darauf.
  4. Im Abschnitt APKPackaging :
    • Legen Sie für Minimum SDK Version (Mindest-SDK-Version) den Wert 34 fest.
    • Legen Sie für Target SDK Version (Ziel-SDK-Version) den Wert 34 (oder höher) fest.

  5. Scrollen Sie weiter zum Abschnitt Build (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 Bildraten und die visuelle Klarheit zu erzielen, müssen Sie Unreal Engine auch so konfigurieren, dass der optimierte mobile Rendering-Pfad verwendet wird:

  1. Wählen Sie Edit > Project Settings (Bearbeiten > Projekteinstellungen) und dann Engine > Rendering (Engine > Rendering) aus.

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

    Der Forward-Renderer ist für mobile VR deutlich schneller als der standardmäßige Deferred-Renderer. Beachten Sie, dass dies einen Neustart des Editors und die Kompilierung von Shadern erfordert.

  3. Legen Sie im Abschnitt Default Settings (Standardeinstellungen) für Anti-Aliasing Method (Anti-Aliasing-Methode) die Option MSAA fest.

  4. Legen Sie im Abschnitt Mobile (Mobil) für Mobile MSAA (Mobiles MSAA) die Option 4x fest.

    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. Deaktivieren Sie Mobile HDR (Mobiles HDR).

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

    2. Wählen Sie Mobile Mehrfachdarstellung aus.

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

Weitere Informationen

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