Direct Preview im Android XR Engine Hub 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.
XR-Headsets
Kabelgebundene XR-Brillen

Die Funktion „Direkte Vorschau“ ist eine Funktion im Android XR Engine Hub, mit der Sie komplexe Interaktionen direkt im Editor Ihrer Game Engine mit Live-Daten vom Android XR-Gerät testen und optimieren können. Dadurch wird der übliche, zeitaufwendige Build- und Bereitstellungszyklus in der XR-Entwicklung vollständig umgangen.

Bei der direkten Vorschau wird nicht jedes Mal, wenn Sie eine Änderung vornehmen, ein vollständiges APK exportiert. Stattdessen rendert und debuggt Ihr Hostcomputer den Inhalt, streamt den visuellen Viewport direkt auf Ihr physisches Android XR-Gerät und streamt unterstützte OpenXR-Erweiterungen in Echtzeit zurück an den Hostcomputer.

OpenXR-Unterstützung für die direkte Vorschau

Mit der direkten Vorschau können Sie sofort Tests mit geringer Latenz im Viewport Ihrer Engine für die folgenden gestreamten Erweiterungen durchführen:

Funktion oder Möglichkeit OpenXR-Erweiterungsstring

Geräteankerpersistenz

XR_ANDROID_device_anchor_persistence

Raycast

XR_ANDROID_raycast

Trackables (Ebenen/Tiefe)

XR_ANDROID_trackables

Objekt-Tracking

XR_ANDROID_trackables_object

Szenen-Meshing

XR_ANDROID_scene_meshing

Gesichtstracking

XR_ANDROID_face_tracking

Eye-Tracking

XR_ANDROID_eye_tracking

Passthrough-Kamerastatus

XR_ANDROID_passthrough_camera_state

Handinteraktion

XR_EXT_hand_interaction

Erste Schritte mit der direkten Vorschau im Android Engine Hub

Folgen Sie der Anleitung in den folgenden Abschnitten, um die direkte Vorschau zu aktivieren, Ihr physisches Android XR-Gerät zu konfigurieren und die direkte Vorschau mit geringer Latenz in Ihrer Spiel-Engine zu aktivieren und zu starten:

Android XR Engine Hub herunterladen und installieren

Laden Sie zuerst die aktuelle Version des Android XR Engine Hub herunter und installieren Sie sie.

Android XR-Gerät verbinden und konfigurieren

Verbinden und konfigurieren Sie als Nächstes Ihr Android XR-Gerät für die direkte Vorschau:

  1. Schließen Sie alle geöffneten Game Engine-Editoren.
  2. Öffnen Sie den Android XR Engine Hub.

    Der Bildschirm „Geräte-Manager“ im Android XR Engine Hub

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

  4. Wählen Sie im Drop-down-Menü „Gerät“ oben auf der Benutzeroberfläche Ihr verbundenes Android XR-Gerät aus.

    Wähle das Gerät aus, das du mit der Direktvorschau verwenden möchtest.

  5. Prüfen Sie, ob der Stream-Client initialisiert wurde:

    1. Klicken Sie auf Stream-Client installieren , um den erforderlichen Daemon auf Ihrem Headset bereitzustellen.
    2. Klicken Sie für Aktive OpenXR-Runtime auf Festlegen , um Engine-Aufrufe vom Hostcomputer an den Gerätestream umzuleiten.

    Direct Preview im Android XR Engine Hub aktivieren

Direkte Vorschau in Ihrer Spiel-Engine konfigurieren und starten

Konfigurieren und starten Sie schließlich die direkte Vorschau in Ihrer Spiel-Engine:

  1. Führen Sie die Schritte zur erstmaligen Einrichtung und Konfiguration für Ihre Spiel-Engine aus:

  2. Folgen Sie der Anleitung im Abschnitt „Direkte Vorschau starten“ für Ihre Game Engine, wenn Sie die direkte Vorschau starten möchten: