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 →

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 im 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 Einrichtungsleitfaden für die C++-Entwicklungsumgebung von Epic.

3. Installieren Sie das .NET 8.0 SDK.

4. Installieren Sie Android Studio (Quail 4 | 2026.1.4 oder höher).

Android-Build-Unterstützung installieren

Da Android XR auf bestimmten SDK-Versionen basiert, müssen Sie die richtigen Android-Build-Tools zusammen mit Unreal Engine installieren.

1. Öffnen Sie den Epic Games Launcher.

2. Klicken Sie neben der installierten Engine-Version (Schaltfläche „Starten“) auf den Drop-down-Pfeil 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 Dateiendungen zu registrieren.

3. Installieren Sie Java JDK 17.

4. Verwenden Sie in Android Studio den SDK Manager, um die folgenden spezifischen Versionen zu installieren, 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 für die erweiterte 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 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ü Projektstandardeinstellungen die Zielplattform auf Mobil fest.
4. Stellen Sie das Qualitäts-Preset auf Skalierbar ein, 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-Levels und Grafikeinstellungen für Android XR festzulegen:

1. Wählen Sie Bearbeiten > Projekteinstellungen aus.
2. Rufen Sie Platforms > Android auf.
3. Wenn der Button SDK-Lizenz akzeptieren rot hervorgehoben ist, klicken Sie darauf.
4. Im Abschnitt APKPackaging:
   • Legen Sie Minimum 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 aus.

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

Rendereinstellungen konfigurieren

Um die für Android XR erforderlichen hohen Bildraten und die visuelle Klarheit zu erreichen, müssen Sie auch Unreal Engine so konfigurieren, dass der optimierte mobile Rendering-Pfad verwendet wird:

1. Wählen Sie Bearbeiten > Projekteinstellungen aus und gehen Sie zu Engine > Rendern.

2. Wählen Sie im Bereich 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. Hinweis: Wenn Sie diese Option aktivieren, muss der Editor neu gestartet und der Shader kompiliert werden.

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

4. Legen Sie im Bereich Mobil für MSAA für Mobilgeräte den Wert 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.

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

   2. Wähle Mobile Multi-View aus.

      Dadurch kann die Engine beide Augen in einem einzigen 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.