Erste Schritte mit OpenXR

Sie können mit OpenXR auf einem immersiven HoloLens 2- oder Windows Mixed Reality-Headset auf dem Desktop entwickeln. Wenn Sie keinen Zugriff auf ein Headset haben, können Sie stattdessen die HoloLens 2 Emulator oder den Windows Mixed Reality Simulator verwenden.

Erste Schritte mit OpenXR für HoloLens 2

So entwickeln Sie OpenXR-Anwendungen für HoloLens 2:

1. Richten Sie ein HoloLens 2 Gerät ein oder installieren Sie eineaktuelle Version des HoloLens 2 Emulators.

Das ist alles! Die OpenXR-API-Laufzeit wird auf HoloLens 2 Geräten vorinstalliert, und Sie erhalten automatische Updates über die Store.

Um sicherzustellen, dass Sie die neueste OpenXR-Runtime mit allen vorhandenen Erweiterungen haben, können Sie die Store-App aus dem HoloLens Gerät oder Emulator starten. Öffnen Sie das Menü oben rechts in der Store-App, wählen Sie Downloads und Updates aus, und wählen Sie "Updates abrufen" aus.

Hinweis

Wenn Sie den Emulator verwenden, wird das Emulatorimage jedes Mal zurückgesetzt, wenn Sie es starten, und so ist ihr bestes Ziel, einfach sicherzustellen, dass Sie über die neueste Version des HoloLens 2 Emulatorimages verfügen.

Erste Schritte mit OpenXR für Windows Mixed Reality Headsets

So entwickeln Sie OpenXR-Anwendungen für immersive Windows Mixed Reality Headsets:

1. Stellen Sie sicher, dass Sie mindestens das Windows 10 Oktober 2020 Update (20H2) ausführen, das die mindest unterstützte Betriebssystemversion für Windows Mixed Reality Endbenutzer ist, um OpenXR-Anwendungen auszuführen. Frühere Versionen von Windows 10 sollten weiterhin mit OpenXR arbeiten, aber möglicherweise keine ideale Leistung oder Qualität haben. Wenn Sie eine frühere Version von Windows 10 verwenden, können Sie mithilfe des Windows 10 Update-Assistenten upgraden.
2. Richten Sie ein Windows Mixed Reality Headset ein oder aktivieren Sie den Windows Mixed Reality Simulator.

Das ist alles! Die Windows Mixed Reality OpenXR-Runtime wird installiert und für alle Windows Mixed Reality Benutzer automatisch aktiv gemacht. Der Microsoft Store hält dann die Laufzeit auf dem neuesten Stand.

Wenn Sie mehrere VR-Headsets auf Ihrem PC verwenden, beachten Sie, dass die aktive OpenXR-Runtime möglicherweise von der Systemsoftware eines anderen Anbieters geändert werden kann. Um die Windows Mixed Reality OpenXR-Runtime erneut zu aktivieren, starten Sie im Startmenü "Mixed Reality Portal", und wählen Sie dann oben im Fenster "Beheben" aus. Wenn diese Schaltfläche fehlt, ist die OpenXR-Laufzeit bereits aktiv.

Abrufen der OpenXR-Tools für Windows Mixed Reality

Wenn Sie OpenXR-Anwendungen für HoloLens 2 oder PC VR entwickeln, finden Sie möglicherweise diese OpenXR-Tools für Windows Mixed Reality App nützlich. Es bietet eine Demo verschiedener OpenXR-Features und einer OpenXR-Runtime-Seite, die wichtige Informationen über die aktive Laufzeit und das aktuelle Headset enthält.

Um die OpenXR-Tools-App zu finden und zu installieren, wechseln Sie HoloLens 2 zu der Store App, und suchen Sie nach "OpenXR".

Wenn Sie den HoloLens 2-Emulator verwenden, wird die einfachste Möglichkeit zum Installieren der OpenXR-Tools für Windows Mixed Reality über das Windows Device Portal ausgeführt. Navigieren Sie im Portal zur Seite "OpenXR", und wählen Sie dann unter "Entwicklerfeatures" die Schaltfläche " Installieren " aus. Dies funktioniert auch auf physischen HoloLens 2 Geräten.

Erkunden der OpenXR-API und Beispiel-App

Stellen Sie sicher, dass Sie die Tools installieren, die Sie für die OpenXR-Entwicklung benötigen, wenn Sie noch nicht vorhanden sind.

Das BasicXrApp-Projekt zeigt ein einfaches OpenXR-Beispiel mit Win32 und UWP HoloLens 2 Projektdateien in Visual Studio. Da die Lösung ein HoloLens UWP-Projekt enthält, benötigen Sie die Universelle Windows-Plattform Entwicklungslast, die in Visual Studio installiert ist, um sie vollständig zu öffnen.

Während die Win32- und UWP-Projektdateien aufgrund von Unterschieden in der Verpackung und Bereitstellung getrennt sind, ist der App-Code in jedem Projekt fast genau gleich!

Eine Tour durch die OpenXR-API finden Sie in diesem 60-minütigen Video des BasicXrApp-Beispiels in Visual Studio. Das Video zeigt, wie jede der wichtigsten Komponenten der OpenXR-API in Ihrem eigenen Modul verwendet werden kann und zeigt auch einige der anwendungen, die heute auf OpenXR basieren:

Ausführen Ihrer OpenXR-App

Nachdem Sie ein OpenXR Win32-Desktop-.EXE erstellt haben, können Sie es mit einem VR-Headset auf jeder Desktop-VR-Plattform verwenden, die OpenXR unterstützt, unabhängig vom Headsettyp.

Nachdem Sie ein OpenXR-UWP-App-Paket erstellt haben, können Sie dieses Paket entweder auf einem HoloLens 2 Gerät oder dem HoloLens 2 Emulator bereitstellen.

Verwenden von OpenXR in einem vorhandenen Projekt

Um mit OpenXR in einem vorhandenen Projekt zu beginnen, fügen Sie das OpenXR-Ladeprogramm hinzu. Der Loader erkennt die aktive OpenXR-Runtime auf dem Gerät und bietet Zugriff auf die Kernfunktionen und Erweiterungsfunktionen, die sie implementiert.

Sie können auf das offizielle OpenXR-NuGet-Paket aus Ihrem Visual Studio Projekt verweisen oder die offizielle OpenXR-Ladequelle aus dem Khronos-GitHub Repo einschließen. Jeder Ansatz bietet Ihnen Zugriff auf OpenXR 1.0-Kernfeatures sowie veröffentlichte KHREXT und MSFT Erweiterungen.

Wenn Sie auch mit Erweiterungen experimentieren MSFT_preview möchten, können Sie in der Vorschau von OpenXR-Headern aus dem Mixed Reality GitHub-Repo kopieren.

Referenz des offiziellen OpenXR-NuGet-Pakets

Das OpenXR.Loader-NuGet-Paket ist die einfachste Möglichkeit, auf einen vorab integrierten OpenXR-Ladeer .DLL in Ihrer Visual Studio C++-Lösung zu verweisen. Dadurch erhalten Sie Zugriff auf OpenXR 1.0-Kernfeatures sowie veröffentlichte KHREXT und MSFT Erweiterungen.

So fügen Sie einen OpenXR.Loader NuGet Paketreferenz zu Ihrer Visual Studio C++-Lösung hinzu:

1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, das OpenXR verwendet, und wählen Sie "NuGet Pakete verwalten" aus.
2. Wechseln Sie zur Registerkarte "Durchsuchen ", und suchen Sie nach OpenXR.Loader.
3. Wählen Sie das OpenXR.Loader-Paket aus, und wählen Sie "Installieren" im Detailbereich rechts aus.
4. Wählen Sie "OK" aus, um die Änderungen an Ihrem Projekt zu akzeptieren.
5. Fügen Sie #include <openxr/openxr.h> einer Quelldatei hinzu, um mit der OpenXR-API zu beginnen.

Um ein Beispiel der OpenXR-API in Aktion anzuzeigen, lesen Sie die BasicXrApp-Beispiel-App .

Offizielle OpenXR-Ladequelle einschließen

Wenn Sie den Ladegerät selbst erstellen möchten, z. B. um den zusätzlichen Ladevorgang .DLL zu vermeiden, können Sie die offiziellen Khronos OpenXR-Ladequellen in Ihr Projekt ziehen. Dadurch erhalten Sie Zugriff auf OpenXR 1.0-Kernfeatures sowie veröffentlichte KHREXT und MSFT Erweiterungen.

Um hier zu beginnen, folgen Sie den Anweisungen im Khronos OpenXR-SDK-Repo auf GitHub. Das Projekt wird eingerichtet, um mit CMake zu erstellen – wenn Sie MSBuild verwenden, müssen Sie den Code in Ihr eigenes Projekt kopieren.

Verwenden von Vorschauerweiterungen

Die MSFT_preview in der Erweiterungs-Roadmap aufgeführten Erweiterungen sind experimentelle Anbietererweiterungen, die vorschauiert werden, um Feedback zu sammeln. Diese Erweiterungen sind nur für Entwicklergeräte vorgesehen und werden entfernt, wenn die echte Erweiterungsschiffe ausgeliefert werden.

Wenn Sie interessiert sind, die verfügbaren MSFT_preview Erweiterungen auszuprobieren, führen Sie die folgenden Schritte aus, um Ihr Projekt zu aktualisieren:

1. Folgen Sie einer der oben genannten Ansätze, um einen OpenXR-Ladeer in Ihr Projekt zu integrieren.
2. Ersetzen Sie die standardmäßigen OpenXR-Header in Ihrem Projekt durch die Vorschauheader aus dem Mixed Reality OpenXR-Repo auf GitHub.

Um dann die Vorschauerweiterungsunterstützung auf Ihrem Ziel-HOLOLENS 2 oder Desktop-PC zu aktivieren:

1. Um sicherzustellen, dass Sie die neueste OpenXR-Runtime mit allen vorhandenen Erweiterungen haben, starten Sie die Store App innerhalb des Zielgeräts oder Emulators, öffnen Sie das Menü oben rechts, wählen Sie Downloads und Updates aus, und wählen Sie "Updates abrufen" aus.
2. Installieren Sie die OpenXR-Tools für Windows Mixed Reality-App aus dem Microsoft Store auf dem Zielgerät und führen Sie sie aus.
3. Navigieren Sie zur Registerkarte Einstellungen, und aktivieren Sie die neueste Vorschau-OpenXR-Runtime. Dies ermöglicht die Vorschau-Laufzeit auf Ihrem Gerät, die Vorschauerweiterungen aktiviert hat.
4. Bestätigen Sie die Auf der Registerkarte "OpenXR-Runtime" der OpenXR-Tools für Windows Mixed Reality die erforderliche Version der Vorschauerweiterungen, die Sie ausprobieren möchten. Wenn ja, sollten Sie die Erweiterung in der Liste "Erweiterungen " sehen. Sobald eine stabile Erweiterung verfügbar ist, wird die Vorschauerweiterung entfernt.
   

Sehen Sie sich die Mixed Reality OpenXR-Repo zur Dokumentation dieser Vorschauerweiterungen und Beispiele für die Verwendung dieser Erweiterungen an.

Problembehandlung

Wenn Sie Probleme mit der OpenXR-Entwicklung haben, lesen Sie unsere Tipps zur Problembehandlung.