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

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

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

Vorbereitung

Bevor Sie beginnen, müssen die folgenden Anforderungen an Ihre Entwicklungsumgebung erfüllt sein:

  • Android XR Engine Hub: Führen Sie alle Schritte im Abschnitt „Erste Schritte“ des Leitfadens zum Android XR Engine Hub aus, um Ihren Hostcomputer für die Direktvorschau 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.

Android XR-Plug-ins einrichten

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

  1. Folgen Sie der Anleitung im Schnellstartleitfaden zu Android XR-Erweiterungen für die 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 dieselben Schritte noch einmal aus.

  2. Achten Sie bei jedem Projekt darauf, dass es einen Symlink zum Ordner mit den Anbieter-Plug-ins hat.

Projekteinstellungen konfigurieren

Konfigurieren Sie die Projekteinstellungen für das Streaming der Direktvorschau:

  1. Gehen Sie zu Projekteinstellungen > Plattformen > Windows.
  2. Ändern Sie RHI in Vulkan.
  3. Gehen Sie zu Bearbeiten > Plug-ins.
  4. Aktivieren Sie das Plug-in AndroidXRStreaming.
  5. Gehen Sie zu Bearbeiten > Projekteinstellungen > Beschreibung.
  6. Aktivieren Sie In VR starten.

Streaming-Laufzeit aktivieren

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

  1. Gehen Sie zu Projekteinstellungen > Plug-ins > AndroidXRStreaming.

  2. Klicken Sie auf AndroidXR-Streaming aktivieren.

    Android XR Streaming-Laufzeit aktivieren

  3. Starten Sie die Unreal Engine neu, damit diese Änderungen übernommen werden.

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 jede der folgenden Optionen und aktivieren oder deaktivieren Sie sie entsprechend Ihren Anforderungen für das Projekt:

    • Client bei Vorschau automatisch starten: Wenn diese Option aktiviert ist, wird die Vorschau Client-App auf jedem gültigen, ausgewählten Gerät gestartet, wenn Sie im Editor auf VR Vorschau starten klicken.
    • Client bei Vorschau automatisch beenden: Wenn diese Option aktiviert ist, wird der Vorschau Client 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.
    • Fehlerdialogfelder anzeigen: Wenn diese Option aktiviert ist, werden zusätzliche Fehlerdialogfelder angezeigt Ein Fehlerdialogfeld wird beispielsweise angezeigt, 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, sucht die Schaltfläche Aktualisieren nach verbundenen Geräten und listet kompatible Geräte auf. Die Kompatibilität wird durch das Vorhandensein der Direktvorschau-Client-App im Android XR Engine Hub bestimmt.

Direktvorschau starten

Starten Sie die Direktvorschau, 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.

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

  3. Klicken Sie im Unreal Editor auf Level in VR spielen. Verwenden Sie beim Starten der Direktvorschau nicht die übliche Option Im Editor spielen.