Mit Link kannst du deine Iterationszeit verkürzen, indem du die App, die du in Unity oder Unreal entwickelst, direkt aus dem Editor auf deinem Gerät startest, wenn du Wiedergeben (►) auswählst. Auf diese Weise musst du die App nicht mehr jedes Mal, wenn du sie während der Entwicklung testen möchtest, auf dem PC erstellen und auf einem Meta Quest-Headset bereitstellen.

Hinweis: Link wird derzeit nur unter Windows unterstützt. Falls du macOS für die Entwicklung verwendest oder kein Headset zur Verfügung hast, empfehlen wir stattdessen den Meta-XR-Simulator.

Dieses Thema umfasst Folgendes:

Beschreibung der Meta Horizon Link-Entwicklungsapp

Ressourcen für die Einrichtung und grundlegende Nutzung von Link

Nützliche Einstellungen und Tipps zur Fehlerbehebung beim Testen deiner Apps mit Link

Link ist kompatibel mit Meta Quest 3S-, Meta Quest 3-, Meta Quest 2- und Meta Quest Pro-Headsets.

Voraussetzungen

Meta-Entwicklungskonto

Voraussetzungen für die Verwendung von Link⁠

Einschränkungen

Im Meta Horizon Store veröffentlichte Apps haben keinen Zugriff auf Entwicklungs- und experimentelle Features, selbst wenn diese Features in den Link-Einstellungen aktiviert sind.

Achtung: Überprüfe deine App vor der Veröffentlichung im Store zunächst auf dem Gerät, um sicherzugehen, dass sie wie erwartet funktioniert.

Das grafische Erscheinungsbild und die Performance einer App bei der Ausführung mit Link kann sich von der Ausführung auf einem Meta Quest-Headset unterscheiden.

Link bewirkt, dass sich dein Gerät wie ein PC-VR-Headset verhält, bis das Tool explizit ausgeschaltet wird.

Meta Horizon Link einrichten

Befolge diese Schritte, um eine Vorschau deiner Szene mit Link zu sehen:

Lade Link herunter⁠ und installiere die App auf deinem Gerät.

Setze dein Headset auf.

Öffne die Einstellungen in deinem Headset.

Wähle Quest Link aus und aktiviere Quest Link.

Wähle Quest Link starten aus, um Link auf deinem Entwicklungs-PC und auf deinem Headset zu starten.

Drücke in deinem Unity-Projekt Play (►), um die App auf deinem Headset auszuführen.

Feature-Einstellungen für die Entwicklung konfigurieren

OpenXR-Runtime aktivieren

Navigiere in der Meta Quest Link-App zu Einstellungen > Allgemein.

Gehe zu OpenXR-Runtime und wähle Meta Horizon Link als aktiv einstellen aus. Nach dem Aktivieren wird die Option ausgegraut angezeigt.

Runtime-Features für Entwickler*innen ein- oder ausschalten

Navigiere in der Meta Horizon Link-App zu Einstellungen > Entwickler.

Vergewissere dich, dass die Option Runtime-Features für Entwickler aktiviert ist.

Feature-Unterstützung über Link sicherstellen

Angenommen, du möchtest eine App testen, die Passthrough, Eye-Tracking und natürliche Gesichtsausdrücke verwendet.

Navigiere in der Meta Horizon Link-App zu Einstellungen > Entwickler.

Achte darauf, dass die folgenden Optionen aktiviert sind:

Passthrough via Meta Horizon Link

Eye-Tracking via Meta Horizon Link

Natürliche Gesichtsausdrücke via Meta Horizon Link

Hinweis: Die Optionen für diese Features werden erst angezeigt, nachdem du Runtime-Features für Entwickler aktiviert hast.

Nach dem Einschalten der einzelnen Features solltest du die jeweiligen Dialogfelder lesen. Wähle Aktivieren aus, wenn du zustimmst.

Falls dein Unity- oder Unreal-Projekt bereits geöffnet ist, starte den Editor neu, nachdem du die Features über Link aktiviert hast.

Verbindung testen

Schließe dein Headset mit einem USB-C-Kabel an und führe die folgenden Schritte in der Meta Horizon Link-App aus:

Wähle Geräte aus und überprüfe, ob dein Headset angezeigt wird.

Wähle das verbundene Gerät und dann rechts im Menü die Option Geräteeinrichtung aus.

Wähle Link-Kabel und dann Weiter aus.

Wähle auf der Seite Dein Headset verbinden die Option Weiter aus.

Wähle auf der Seite Kabelverbindung überprüfen Verbindung testen aus.

Stelle sicher, dass nach Abschluss des Tests die Meldung Kompatible Verbindung angezeigt wird.

Für Farb-Passthrough sollte die USB-Verbindung eine effektive Bandbreite von mindestens 2 Gbit/s bereitstellen.

Wenn beim Test die Meldung Inkompatible Verbindung zurückgegeben wird oder die Bandbreite zu niedrig ist, musst du unter Umständen ein anderes USB-C-Kabel verwenden. Verwende das Meta Horizon Link-Kabel⁠, um Kompatibilität zu gewährleisten.

Bandbreite überprüfen

Mit dem integrierten USB-Geschwindigkeitstest der Meta Horizon Link-App kannst du jederzeit die Verbindungsgeschwindigkeit testen:

Navigiere in der Meta Horizon Link-App zu Geräte.

Wähle das verbundene Gerät aus.

Wähle USB-Verbindungstest und dann Verbindung testen aus.

Link-Verbindung auf dem Headset testen

Führe die folgenden Schritte auf deinem Headset aus, um sicherzustellen, dass sich dein Headset korrekt mit Link verbindet:

Gehe zu Einstellungen > System.

Aktiviere die Zugriffsoption neben Quest Link.

Grundlegende Link-Nutzung bei der App-Entwicklung

Als Entwickler*in kannst du Link auf zwei verschiedene Arten nutzen:

Szene im Unity Editor mit Play (►) direkt ausführen

Projekt als eigenständige PC-App ausführen

Unabhängig vom Modus erfasst die App sämtliche Tracking-Daten von deinem Headset.

Das Ausführen deiner App auf einem PC über Link funktioniert in den meisten Fällen ähnlich wie auf dem Headset. Wenn du die App auf einem PC über Link für Play-in-Editor und eigenständige Modi ausführst, siehst du (als Nutzer*in) einen 3D-Bildschirm der App in deinem Viewport des Headsets. Außerdem wird dir der normale Bildschirm der App auf dem PC-Bildschirm angezeigt.

Hinweis: Stelle sicher, dass du deinen Plug-in Provider, wie etwa OpenXR, unter Edit > Project Settings > XR Plug-in Management > Windows, Linux and Mac settings aktiviert hast.

Näherungssensor deaktivieren

Ein Schritt des standardmäßigen Entwicklungs-Workflows besteht darin, den Näherungssensor im Meta Quest Developer Hub (MQDH) zu deaktivieren.

Verbinde dein Headset mit deinem Entwicklungs-PC.

Öffne MQDH auf deinem Computer.

Wähle in der linken Navigationsleiste im MQDH die Option Device Manager aus.

Wähle dein Headset in der Liste Devices aus.

Suche den Eintrag Proximity Sensor unter Device Actions.

Deaktiviere den Näherungssensor. Nach der Trennung vom MQDH bleibt der Näherungssensor für 10 Minuten oder wie andernfalls in der Einstellung beschrieben deaktiviert.

Link-Protokolle aus dem Unity Editor und dem OculusLogGather-Tool erfassen

Falls du Link-Protokolle erfassen möchtest, kannst du dazu den Unity Editor und die Oculus-App verwenden.

Navigiere im Unity Editor zu Window > General > Console.

Wähle Play aus, während PC Link auf deinem Headset aktiv ist.

Klicke auf die drei Punkte oben rechts in der Konsole und wähle Open Editor Log aus.

Suche OculusLogGather.exe auf deinem Datenträger. Der Speicherort dieser Datei hängt davon ab, wo du die Oculus-App installiert hast. Normalerweise befindet sie sich im Ordner C:\Programme\Oculus\Support\oculus-diagnostics.

Führe OculusLogGather.exe aus.