Direct Preview für Unreal Engine 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 →

Mit der direkten Vorschau können Sie komplexe Interaktionen direkt im Unreal Editor mit Live-Daten vom Android XR-Gerät testen und iterieren. Bei der direkten Vorschau rendert und debuggt der Hostcomputer den Inhalt, streamt den visuellen Darstellungsbereich direkt auf Ihr physisches Android XR-Gerät und streamt unterstützte OpenXR-Erweiterungen in Echtzeit zurück an den Host.

Folgen Sie dieser Anleitung, um die direkte Vorschau für Ihr Projekt in Unreal Engine einzurichten.

Vorbereitung

Bevor Sie beginnen, sollten Sie prüfen, ob Ihre Entwicklungsumgebung die folgenden Anforderungen erfüllt:

• Unreal Engine-Version: Unreal Engine 5.6.x oder 5.8.x.
• Projekteinrichtung: Führen Sie alle Schritte im Leitfaden Unreal Engine-Projekt einrichten aus.

• Android XR Engine Hub: Führen Sie alle Schritte im Abschnitt Erste Schritte des Android XR Engine Hub-Leitfadens aus, um Ihren Hostcomputer für die Direct Preview zu installieren und zu konfigurieren.

• Hardware:

  • Verwenden Sie einen Hostcomputer mit Windows 11.
  • Verwenden Sie eine moderne Grafikkarte mit Unterstützung für Vulkan Video Encoding.
  Wichtig: Aktualisieren Sie Ihre GPU-Treiber auf die aktuellen Versionen, bevor Sie alle Vulkan-Funktionen prüfen.

Android XR-Plug-ins einrichten

Richten Sie Unreal Engine mit den erforderlichen Android XR-Plug-ins ein:

1. Folgen Sie der Anleitung in der Kurzanleitung zu Android XR-Erweiterungen für Unreal Engine.

   Wenn Sie später ein neues Projekt erstellen oder ein Projekt öffnen, das Sie noch nicht mit der Direktvorschau verwendet haben, führen Sie diese Schritte noch einmal aus.

2. Achten Sie darauf, dass jedes Projekt einen Symlink zum Ordner „vendor/plugins“ hat.

Projekteinstellungen konfigurieren

Konfiguriere deine Projekteinstellungen für das Direct Preview-Streaming:

1. Gehen Sie zu Projekteinstellungen > Platforms > Windows.
2. Für RHI bis Vulkan.
3. Gehen Sie zu Edit > Plugins (Bearbeiten > Plug-ins).
4. Aktivieren Sie das AndroidXRStreaming-Plug-in.
5. Gehen Sie zu Edit > Project Settings > Description (Bearbeiten > Projekteinstellungen > Beschreibung).
6. Aktiviere In VR starten.

Streaminglaufzeit aktivieren

Nachdem das Plug-in AndroidXRStreaming im Projekt aktiviert wurde, prüfen Sie, ob die Android XR-Streaming-Laufzeit vorhanden ist:

1. Gehen Sie zu Project Settings > Plugins > AndroidXRStreaming.

2. Klicken Sie auf AndroidXR-Streaming aktivieren.

   

   Hinweis: Dazu wird eine sitzungsbasierte Umgebungsvariable für den Unreal Engine-Prozess festgelegt. Es müssen also keine Registry-Einträge geändert werden, auch wenn mehrere Laufzeiten auf dem Computer vorhanden sind.

3. Starten Sie die Unreal Engine neu, um diese Änderungen zu übernehmen.

Streaming-Client konfigurieren

Konfigurieren Sie den Streaming-Client mit verschiedenen Optionen für Ihr Projekt:

1. Gehen Sie zu Projekteinstellungen > Plug-ins.

2. Prüfen Sie im Abschnitt AndroidXRStreamingClient die folgenden Optionen und aktivieren oder deaktivieren Sie sie entsprechend den Anforderungen Ihres Projekts:

   • Auto Start Client On Preview: Wenn diese Option aktiviert ist, wird die Vorschau-Client-App auf jedem gültigen, ausgewählten Gerät gestartet, wenn Sie im Editor auf Start VR Preview klicken.
   • Auto Stop Client On Preview: Wenn diese Option aktiviert ist, wird der Vorschauclient beendet, wenn die VR-Vorschau im Editor beendet wird.
   • Kompatibles Gerät automatisch auswählen: Wenn diese Option aktiviert ist, wird bei der Suche nach Geräten automatisch das erste kompatible Gerät ausgewählt, das mit dem Computer verbunden ist.
   • Fehlerdialoge anzeigen: Wenn diese Option aktiviert ist, werden zusätzliche Fehlerdialoge angezeigt (z. B. wenn Sie versuchen, eine VR-Vorschau zu starten, ohne ein Clientgerät auszuwählen). Deaktivieren Sie diese Option, um diese Dialogfelder auszublenden.
   • Aktualisieren: Wenn diese Option aktiviert ist, wird über die Schaltfläche Aktualisieren nach verbundenen Geräten gesucht und es werden kompatible Geräte aufgelistet. Kompatibel sind Geräte, auf denen die Direct Preview-Client-App im Android XR Engine Hub vorhanden ist.

Direktvorschau starten

Starten Sie die direkte Vorschau, um direkt aus der Unreal Engine zu streamen:

1. Verbinden Sie Ihr Android XR-Gerät über ein hochwertiges USB‑C-Kabel mit Ihrem Hostcomputer.

   Hinweis: Sie müssen die Entwickleroptionen und das Debugging auf dem Android XR-Gerät aktivieren, damit Ihr Hostcomputer ADB-Befehle (Android Debug Bridge) senden kann.

2. Wenn Sie dieses Gerät noch nie mit der Direktvorschau verwendet haben, verbinden und konfigurieren Sie es für die Direktvorschau im Android XR Engine Hub, bevor Sie die Direktvorschau über Ihre Spiel-Engine starten.

3. Klicken Sie im Unreal Editor auf Play level in VR (Level in VR spielen). Verwenden Sie beim Starten der direkten Vorschau nicht die übliche Option Play in Editor (Im Editor wiedergeben).