Erste Schritte mit OpenXRGetting started with OpenXR

Sie können mit OpenXR auf einem immersiven HoloLens 2- oder Windows Mixed Reality-Headset auf dem Desktop entwickeln.You can develop using OpenXR on a HoloLens 2 or Windows Mixed Reality immersive headset on the desktop. Wenn Sie keinen Zugriff auf ein Headset haben, können Sie stattdessen den hololens 2-Emulator oder den Windows Mixed Reality-Simulator verwenden.If you don't have access to a headset, you can use the HoloLens 2 Emulator or the Windows Mixed Reality Simulator instead.

Getting Started with openxr for hololens 2Getting started with OpenXR for HoloLens 2

So beginnen Sie mit der Entwicklung von openxr-Anwendungen für hololens 2:To start developing OpenXR applications for HoloLens 2:

  1. Richten Sie einen hololens 2 ein, oder befolgen Sie die Anweisungen, um eine aktuelle Version des hololens 2-Emulators zu installieren.Set up a HoloLens 2 or follow the instructions to install a recent version of the HoloLens 2 emulator. Openxr 1,0 sollte bereits bereit sein, wenn Sie ein Aktuelles emulatorimage verwenden oder das Gerät sein Betriebssystem aktualisiert hat.You should already have OpenXR 1.0 ready to go if you're using a recent emulator image or the device has updated its OS.
  2. Stellen Sie sicher, dass Sie über die neueste openxr-Laufzeit mit allen vorhandenen Erweiterungen verfügen, indem Sie die Store -APP vom Gerät oder Emulator starten.Make sure you've got the latest OpenXR runtime with all extensions present by launching the Store app from the device or emulator.
    • Öffnen Sie das Menü in der oberen rechten Ecke, und wählen Sie Downloads und Updates und dann Updates herunterladen aus.Open the menu in the upper-right, select Downloads and updates, and choose Get updates.

Hinweis

Wenn Sie den Emulator verwenden, wird das emulatorimage jedes Mal zurückgesetzt, wenn Sie es starten. Daher sollten Sie sicherstellen, dass Sie über die neueste Version des hololens 2-Emulatorbildsverfügen.If you're using the emulator, the emulator image will reset each time you start it, and so your best bet is to just make sure that you have the latest version of the HoloLens 2 emulator image.

Einstieg in openxr für Windows Mixed Reality-HeadsetsGetting started with OpenXR for Windows Mixed Reality headsets

So beginnen Sie mit der Entwicklung von openxr-Anwendungen für immersive Windows Mixed Reality-Headsets:To start developing OpenXR applications for immersive Windows Mixed Reality headsets:

  1. Stellen Sie sicher, dass Sie mindestens das Windows 10-Update von Mai 2019 (1903) ausführen. Dies ist die Mindestanforderung für Endbenutzer von Windows Mixed Reality, openxr-Anwendungen auszuführen.Be sure you're running at least the Windows 10 May 2019 Update (1903), which is the minimum requirement for Windows Mixed Reality end users to run OpenXR applications. Wenn Sie eine frühere Version von Windows 10 verwenden, können Sie ein Upgrade mit dem Windows 10 Update Assistantdurchführen.If you're on an earlier version of Windows 10, you can upgrade by using the Windows 10 Update Assistant.
  2. Richten Sie ein Windows Mixed Reality-Headset ein, oder befolgen Sie die Anweisungen zum Aktivieren des Windows Mixed Reality-Simulators.Set up a Windows Mixed Reality headset or follow the instructions to enable the Windows Mixed Reality simulator.

Das war's.That's it! Die Windows Mixed Reality openxr-Laufzeit wird installiert und automatisch für alle Windows Mixed Reality-Benutzer aktiviert.The Windows Mixed Reality OpenXR runtime is installed and made active automatically for all Windows Mixed Reality users. Der Microsoft Store speichert die Laufzeit dann auf dem neuesten Stand.The Microsoft Store then keeps the runtime up to date.

Wenn Sie die Windows Mixed Reality openxr-Laufzeit erneut aktivieren möchten, starten Sie das Mixed Reality-Portal über das Startmenü, und wählen Sie oben im Fenster die Option "reparieren" aus.To activate the Windows Mixed Reality OpenXR Runtime again, launch Mixed Reality Portal from the Start menu, and select "Fix it" at the top of the window. Wenn diese Schaltfläche fehlt, ist die openxr-Laufzeit bereits aktiv.If that button is missing, the OpenXR runtime is already active.

Die openxr-Entwicklertools für die gemischte Realität von WindowsGetting the OpenXR Developer Tools for Windows Mixed Reality

Um die Windows Mixed Reality openxr-Laufzeit auszuprobieren, können Sie die openxr-Entwicklertools für die Windows Mixed Reality-Appinstallieren.To try out the Windows Mixed Reality OpenXR Runtime, you can install the OpenXR Developer Tools for Windows Mixed Reality app. Diese APP bietet eine Demo verschiedener openxr-Features sowie eine System Status Seite mit wichtigen Informationen zur aktiven Laufzeit und zum aktuellen Headset.This app provides a demo of various OpenXR features, along with a System Status page with key information about the active runtime and current headset.

Wenn Sie den hololens 2-Emulator verwenden, ist die einfachste Möglichkeit zum Installieren des openxr-Entwicklertools für Windows Mixed Reality über das Windows-Geräte Portal.When using the HoloLens 2 emulator, the easiest way to install the OpenXR Developer Tools for Windows Mixed Reality is through the Windows Device Portal. Navigieren zur Seite "openxr" und anschließendes Klicken auf die Schaltfläche "installieren" unter "Entwickler Features", die auch auf physischen hololens-2-Geräten funktioniert.Navigating to the "OpenXR" page and then clicking the "Install" button under "Developer Features", which also works on physical HoloLens 2 devices.

Openxr Entwicklertools für Windows Mixed Reality-App

Aufbauen einer openxr-Beispiel-AppBuilding a sample OpenXR app

Stellen Sie sicher, dass Sie die Tools installieren, die Sie für die openxr-Entwicklung benötigen, sofern noch nicht geschehen.Be sure to install the tools you'll need for OpenXR development if you haven't already.

Das Projekt basicxrapp zeigt ein einfaches openxr-Beispiel mit Win32-und UWP hololens 2-Projektdateien in Visual Studio an.The BasicXrApp project shows a simple OpenXR sample with Win32 and UWP HoloLens 2 project files in Visual Studio. Da die Projekt Mappe ein hololens-UWP-Projekt enthält, benötigen Sie die Arbeitsauslastung der universelle Windows-Plattform Entwicklung , die in Visual Studio installiert ist, um Sie vollständig zu öffnen.Because the solution contains a HoloLens UWP project, you'll need the Universal Windows Platform development workload installed in Visual Studio to fully open it.

Obwohl die Win32-und UWP-Projektdateien aufgrund von Unterschieden bei der Verpackung und Bereitstellung getrennt sind, ist der app-Code in jedem Projekt nahezu identisch.While the Win32 and UWP project files are separate because of differences in packaging and deployment, the app code inside each project is almost exactly the same!

Nach dem Aufbau eines openxr Win32-Desktops. EXE, Sie können es mit einem VR-Headset auf jeder Desktop-VR-Plattform verwenden, die openxr unterstützt, je nachdem, welchen Typ der Headset hat.After building an OpenXR Win32 desktop .EXE, you can use it with a VR headset on any desktop VR platform that supports OpenXR, whatever the headset type.

Nachdem Sie ein openxr UWP-App-Paket aufgebaut haben, können Sie Dieses Paket entweder auf einem hololens 2-Gerät oder auf dem hololens 2-Emulator bereitstellen.After building an OpenXR UWP app package, you can deploy that package to either a HoloLens 2 device or the HoloLens 2 Emulator.

Erlernen der openxr-APILearning the OpenXR API

Eine Tour durch die openxr-API finden Sie in diesem 60-minütigen Video zum Beispiel " basicxrapp " in Visual Studio.For a tour of the OpenXR API, check out this 60-minute video of the BasicXrApp sample in Visual Studio. Das Video zeigt, wie die einzelnen Hauptkomponenten der openxr-API in ihrer eigenen Engine verwendet werden können, und es werden auch einige der Anwendungen veranschaulicht, die heute auf openxr basieren:The video shows how each of the major components of the OpenXR API can be used in your own engine, and also demonstrates some of the applications built on OpenXR today:

Integrieren des openxr-Lade Moduls in ein ProjektIntegrate the OpenXR loader into a project

Für den Einstieg in openxr in einem vorhandenen Projekt fügen Sie das openxr-Lade Modul ein.To get started with OpenXR in an existing project, you'll include the OpenXR loader. Das Lade Modul ermittelt die aktive openxr-Laufzeit auf dem Gerät und ermöglicht den Zugriff auf die Kernfunktionen und Erweiterungsfunktionen, die es implementiert.The loader discovers the active OpenXR runtime on the device and provides access to the core functions and extension functions that it implements.

Sie können auf das offizielle openxr nuget-Paket aus Ihrem Visual Studio-Projekt verweisen oder die offizielle openxr-Lade Programmquelle aus dem GitHub-Repository Khronos einschließen.You can reference the official OpenXR NuGet package from your Visual Studio project or include the official OpenXR loader source from the Khronos GitHub repo. Beide Ansätze erhalten Zugriff auf openxr 1,0 Core-Features sowie veröffentlichte KHR EXT MSFT Erweiterungen und Erweiterungen.Either approach will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

Wenn Sie auch mit Erweiterungen experimentieren möchten MSFT_preview , können Sie die Vorschau von openxr-Headern aus dem GitHub-Repository mit gemischter Realität kopieren.If you're interested to experiment with MSFT_preview extensions as well, you can copy in preview OpenXR headers from the Mixed Reality GitHub repo.

Verweis auf das offizielle openxr-nuget-PaketReference official OpenXR NuGet package

Das openxr. Loader -nuget-Paket ist die einfachste Möglichkeit, auf ein vorab erstelltes openxr-Lade Modul zu verweisen. DLL in Ihrer Visual Studio C++-Lösung.The OpenXR.Loader NuGet package is the easiest way to reference a prebuilt OpenXR loader .DLL in your Visual Studio C++ solution. Dadurch erhalten Sie Zugriff auf openxr 1,0 Core-Features sowie veröffentlichte KHR EXT MSFT Erweiterungen und Erweiterungen.This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

So fügen Sie eine openxr. Loader-nuget-Paket Referenz zu Ihrer Visual Studio C++-Projekt Mappe hinzu:To add an OpenXR.Loader NuGet package reference to your Visual Studio C++ solution:

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, das openxr verwendet, und wählen Sie nuget-Pakete verwalten... aus.In Solution Explorer, right-click the project that will use OpenXR and select Manage NuGet Packages....
  2. Wechseln Sie zur Registerkarte Durchsuchen , und suchen Sie nach openxr. Loader.Switch to the Browse tab and search for OpenXR.Loader.
  3. Wählen Sie das Paket openxr. Loader aus, und wählen Sie im Detailbereich auf der rechten Seite die Option installieren aus.Select the OpenXR.Loader package and select Install in the details pane to the right.
  4. Wählen Sie OK aus, um die Änderungen am Projekt zu übernehmen.Select OK to accept the changes to your project.
  5. Fügen Sie #include <openxr/openxr.h> einer Quelldatei hinzu, um mit der Verwendung der openxr-API zu beginnen.Add #include <openxr/openxr.h> to a source file to start using the OpenXR API.

Ein Beispiel für die openxr-API in Aktion finden Sie in der basicxrapp -Beispiel-app.To see an example of the OpenXR API in action, check out the BasicXrApp sample app.

Offizielle openxr-Ladedienst Quelle einbeziehenInclude official OpenXR loader source

Wenn Sie das Lade Modul selbst erstellen möchten, z. b. um das zusätzliche Lade Modul zu vermeiden. DLL, Sie können die offiziellen Khronos openxr-Lade Quell Quellen in Ihr Projekt abrufen.If you want to build the loader yourself, for example to avoid the extra loader .DLL, you can pull the official Khronos OpenXR loader sources into your project. Dadurch erhalten Sie Zugriff auf openxr 1,0 Core-Features sowie veröffentlichte KHR EXT MSFT Erweiterungen und Erweiterungen.This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

Befolgen Sie zum Einstieg die Anweisungen im Repository " Khronos openxr-SDK" auf GitHub.To get started here, follow the instructions in the Khronos OpenXR-SDK repo on GitHub. Das Projekt ist für die Erstellung mit cmake eingerichtet. Wenn Sie MSBuild verwenden, müssen Sie den Code in Ihr eigenes Projekt kopieren.The project is set up to build with CMake - if you're using MSBuild, you'll need to copy the code into your own project.

Verwenden von Vorschau ErweiterungenUsing preview extensions

Die MSFT_preview Erweiterungen in der Erweiterungs Roadmap sind experimentelle Lieferanten Erweiterungen, die in der Vorschau angezeigt werden, um Feedback zu sammeln.The MSFT_preview extensions listed in the extension roadmap are experimental vendor extensions being previewed to gather feedback. Diese Erweiterungen gelten nur für Entwickler Geräte und werden entfernt, wenn die echte Erweiterung ausgeliefert wird.These extensions are for developer devices only and will be removed when the real extension ships.

Wenn Sie die verfügbaren Erweiterungen testen möchten, führen Sie MSFT_preview die folgenden Schritte aus, um Ihr Projekt zu aktualisieren:If you're interested to try out the available MSFT_preview extensions, go through the following steps to update your project:

  1. Befolgen Sie einen der oben genannten Vorgehensweisen, um ein openxr-Lade Modul in Ihr Projekt zu integrieren.Follow either of the approaches above to integrate an OpenXR loader into your project.
  2. Ersetzen Sie die openxr-Standard Header in Ihrem Projekt durch die Vorschau Header aus dem Mixed Reality openxr-Repository auf GitHub.Replace the standard OpenXR headers in your project with the preview headers from the Mixed Reality OpenXR repo on GitHub.

So aktivieren Sie die Vorschau Erweiterungs Unterstützung auf ihren Ziel-hololens 2 oder auf dem Desktop-PC:To then activate preview extension support on your target HoloLens 2 or desktop PC:

  1. Um sicherzustellen, dass Sie über die neueste openxr-Laufzeit mit allen vorhandenen Erweiterungen verfügen, starten Sie die Store -App aus dem Zielgerät oder Emulator, öffnen Sie das Menü in der oberen rechten Ecke, wählen Sie Downloads und Updates , und klicken Sie auf Updates erhalten.To make sure you've got the latest OpenXR runtime with all extensions present, launch the Store app from within the target device or emulator, open the menu in the upper-right, select Downloads and updates and choose Get updates.
  2. Installieren Sie die openxr-Entwicklertools für die Windows Mixed Reality-App vom Microsoft Store auf dem Zielgerät, und führen Sie Sie aus.Install the OpenXR Developer Tools for Windows Mixed Reality app from the Microsoft Store onto the target device and run it.
  3. Navigieren Sie zur Registerkarte Entwicklereinstellungen , und aktivieren Sie neueste Vorschauversion openxr Runtime verwenden.Navigate to the Developer Settings tab and enable Use latest preview OpenXR runtime. Dadurch wird die Vorschau Laufzeit auf Ihrem Gerät aktiviert, für die Vorschau Erweiterungen aktiviert sind.This enables the preview runtime on your device, which has preview extensions activated. Openxr Entwicklertools für Windows Mixed Reality-App Developer Settings-RegisterkarteOpenXR Developer Tools for Windows Mixed Reality app Developer Settings tab
  4. Vergewissern Sie sich, dass die auf der Registerkarte System Status des openxr-Entwicklertools für Windows Mixed Reality angezeigte Laufzeitversion mit der erforderlichen Version der Vorschau Erweiterungen übereinstimmt, die Sie ausprobieren möchten.Confirm the Runtime version shown on the System Status tab of the OpenXR Developer Tools for Windows Mixed Reality matches the required version of the preview extensions you plan to try. Wenn dies der Fall ist, sollte die Erweiterung in der Liste Erweiterungen angezeigt werden.If so, you should see the extension in the Extensions list. Sobald eine stabile Erweiterung verfügbar ist, wird die Vorschau Erweiterung entfernt.Once a stable extension is available, its preview extension will be removed.
    Openxr Entwicklertools für Windows Mixed Reality-app System Status (Registerkarte)OpenXR Developer Tools for Windows Mixed Reality app System Status tab

Eine Dokumentation zu diesen Vorschau Erweiterungen und Beispielen zur Verwendung finden Sie im Repository " Mixed Reality openxr ".See the Mixed Reality OpenXR repo for documentation of these preview extensions and samples of how to use them.

ProblembehandlungTroubleshooting

Wenn Sie Probleme mit der openxr-Entwicklung haben, sehen Sie sich unsere Tipps zur ProblemBehandlung an.If you have trouble getting up and running with OpenXR development, check out our troubleshooting tips.