Aan de slag met OpenXR

U kunt ontwikkelen met Behulp van OpenXR op een HoloLens 2 of Windows Mixed Reality insluitende headset op het bureaublad. Als u geen toegang hebt tot een headset, kunt u in plaats daarvan de HoloLens 2 Emulator of de Windows Mixed Reality Simulator gebruiken.

Aan de slag met OpenXR voor HoloLens 2

OpenXR-toepassingen ontwikkelen voor HoloLens 2:

  1. Stel een HoloLens 2 apparaat in of installeer een recente versie van de HoloLens 2 emulator.

Dat is alles. De OpenXR API-runtime is vooraf geïnstalleerd op HoloLens 2 apparaten en u ontvangt automatische updates via de Store.

Om ervoor te zorgen dat u de nieuwste OpenXR-runtime hebt met alle extensies die aanwezig zijn, kunt u de Store-app starten vanaf het HoloLens apparaat of emulator. Open het menu in de rechterbovenhoek van de Store-app, selecteer Downloads en updates en kies Updates downloaden.

Notitie

Als u de emulator gebruikt, wordt de installatiekopieën van de emulator telkens opnieuw ingesteld wanneer u deze start, en daarom kunt u het beste controleren of u de nieuwste versie van de HoloLens 2 emulatorinstallatiekopieën hebt.

Aan de slag met OpenXR voor Windows Mixed Reality headsets

OpenXR-toepassingen ontwikkelen voor insluitende Windows Mixed Reality headsets:

  1. Zorg ervoor dat u ten minste de update van Windows 10 oktober 2020 (20H2) uitvoert. Dit is de minimaal ondersteunde besturingssysteemrelease voor Windows Mixed Reality eindgebruikers om OpenXR-toepassingen uit te voeren. Eerdere versies van Windows 10 moeten nog steeds werken met OpenXR, maar hebben mogelijk geen ideale prestaties of kwaliteit. Als u een eerdere versie van Windows 10 gebruikt, kunt u upgraden met behulp van de Windows 10 Update-assistent.
  2. Stel een Windows Mixed Reality headset in of schakel de Windows Mixed Reality simulator in.

Dat is alles. De Windows Mixed Reality OpenXR-runtime wordt geïnstalleerd en automatisch actief gemaakt voor alle Windows Mixed Reality gebruikers. De Microsoft Store houdt de runtime vervolgens up-to-date.

Als u meerdere VR-headsets op uw pc hebt gebruikt, moet u er rekening mee houden dat de actieve OpenXR-runtime kan worden gewijzigd door de systeemsoftware van een andere leverancier. Als u de Windows Mixed Reality OpenXR Runtime opnieuw wilt activeren, start u in het startmenu 'Mixed Reality Portal' en selecteert u 'Herstellen' bovenaan het venster. Als deze knop ontbreekt, is de OpenXR-runtime al actief.

De OpenXR-hulpprogramma's voor Windows Mixed Reality

Als u OpenXR-toepassingen ontwikkelt voor HoloLens 2 of PC VR, vindt u deze OpenXR Tools voor Windows Mixed Reality app mogelijk nuttig. Het biedt een demo van verschillende OpenXR-functies en een OpenXR Runtime-pagina met belangrijke informatie over de actieve runtime en huidige headset.

Als u de app OpenXR Tools wilt zoeken en installeren, gaat u op uw HoloLens 2 naar de Store-app en zoekt u naar 'OpenXR'.

Wanneer u de HoloLens 2 emulator gebruikt, is de eenvoudigste manier om de OpenXR Tools for Windows Mixed Reality te installeren via de Windows Device Portal. Ga in de portal naar de pagina OpenXR en selecteer vervolgens onder Functies voor ontwikkelaars de knop Installeren . Dit werkt ook op fysieke HoloLens 2 apparaten.

OpenXR Tools for Windows Mixed Reality app

De OpenXR-API en voorbeeld-app verkennen

Installeer de hulpprogramma's die u nodig hebt voor OpenXR-ontwikkeling als u dat nog niet hebt gedaan.

Het BasicXrApp-project toont een eenvoudig OpenXR-voorbeeld met Win32- en UWP-HoloLens 2 projectbestanden in Visual Studio. Omdat de oplossing een HoloLens UWP-project bevat, hebt u de Universeel Windows-platform ontwikkelworkload nodig die in Visual Studio is geïnstalleerd om het volledig te openen.

Hoewel de Win32- en UWP-projectbestanden gescheiden zijn vanwege verschillen in verpakking en implementatie, is de app-code in elk project bijna precies hetzelfde!

Bekijk deze 60 minuten durende video van het BasicXrApp-voorbeeld in Visual Studio voor een rondleiding door de OpenXR-API. De video laat zien hoe elk van de belangrijkste onderdelen van de OpenXR-API kan worden gebruikt in uw eigen engine, en laat ook enkele van de toepassingen zien die momenteel op OpenXR zijn gebouwd:

Uw OpenXR-app uitvoeren

Nadat u een OpenXR Win32-desktop .EXE hebt gebouwd, kunt u deze gebruiken met een VR-headset op elk desktop VR-platform dat OpenXR ondersteunt, ongeacht het type headset.

Nadat u een OpenXR UWP-app-pakket hebt gebouwd, kunt u dat pakket implementeren op een HoloLens 2 apparaat of de HoloLens 2 Emulator.

OpenXR gebruiken in een bestaand project

Als u aan de slag wilt gaan met OpenXR in een bestaand project, neemt u het OpenXR-laadprogramma op. De loader detecteert de actieve OpenXR-runtime op het apparaat en biedt toegang tot de kernfuncties en extensiefuncties die worden geïmplementeerd.

U kunt naar het officiële OpenXR NuGet-pakket verwijzen vanuit uw Visual Studio project of de officiële OpenXR-laadbron opnemen uit de Khronos-opslagplaats GitHub opslagplaats. Beide benaderingen bieden u toegang tot OpenXR 1.0-kernfuncties, plus gepubliceerde KHREXT en MSFT extensies.

Als u ook wilt experimenteren met MSFT_preview extensies, kunt u kopiëren in preview OpenXR-headers uit de Mixed Reality GitHub opslagplaats.

Referentie officieel OpenXR NuGet-pakket

Het NuGet-pakket OpenXR.Loader is de eenvoudigste manier om te verwijzen naar een vooraf samengesteld OpenXR-laadprogramma .DLL in uw Visual Studio C++-oplossing. Hiermee krijgt u toegang tot openXR 1.0-kernfuncties, plus gepubliceerde KHREXT en MSFT extensies.

Een OpenXR.Loader NuGet-pakketreferentie toevoegen aan uw Visual Studio C++-oplossing:

  1. Klik in Solution Explorer met de rechtermuisknop op het project dat OpenXR gebruikt en selecteer NuGet-pakketten beheren....
  2. Ga naar het tabblad Bladeren en zoek naar OpenXR.Loader.
  3. Selecteer het OpenXR.Loader-pakket en selecteer Installeren in het detailvenster aan de rechterkant.
  4. Selecteer OK om de wijzigingen in uw project te accepteren.
  5. Voeg #include <openxr/openxr.h> toe aan een bronbestand om te beginnen met het gebruik van de OpenXR-API.

Als u een voorbeeld van de OpenXR-API in actie wilt zien, bekijkt u de BasicXrApp-voorbeeld-app .

Officiële OpenXR-laadprogrammabron opnemen

Als u het laadprogramma zelf wilt bouwen, bijvoorbeeld om het extra laadprogramma te voorkomen .DLL, kunt u de officiële Khronos OpenXR-laadprogrammabronnen naar uw project halen. Hiermee krijgt u toegang tot openXR 1.0-kernfuncties, plus gepubliceerde KHREXT en MSFT extensies.

Volg de instructies in de Khronos OpenXR-SDK-opslagplaats op GitHub om hier aan de slag te gaan. Het project is ingesteld om te bouwen met CMake. Als u MSBuild gebruikt, moet u de code naar uw eigen project kopiëren.

Preview-extensies gebruiken

De MSFT_preview extensies die in de roadmap voor extensies worden vermeld, zijn experimentele leveranciersextensies die worden bekeken om feedback te verzamelen. Deze extensies zijn alleen voor ontwikkelaarsapparaten en worden verwijderd wanneer de echte extensie wordt verzonden.

Als u de beschikbare MSFT_preview extensies wilt uitproberen, voert u de volgende stappen uit om uw project bij te werken:

  1. Volg een van de bovenstaande benaderingen om een OpenXR-laadprogramma te integreren in uw project.
  2. Vervang de standaard OpenXR-headers in uw project door de preview-headers uit de Mixed Reality OpenXR-opslagplaats op GitHub.

Als u vervolgens ondersteuning voor preview-extensies wilt activeren op uw doel-HoloLens 2 of desktop-pc:

  1. Als u wilt controleren of u de nieuwste OpenXR-runtime hebt met alle extensies , start u de Store-app vanuit het doelapparaat of de emulator, opent u het menu in de rechterbovenhoek, selecteert u Downloads en updates en kiest u Updates ophalen.
  2. Installeer de OpenXR Tools voor Windows Mixed Reality-app vanuit de Microsoft Store op het doelapparaat en voer deze uit.
  3. Ga naar het tabblad Instellingen en schakel De nieuwste Preview OpenXR-runtime gebruiken in. Hierdoor wordt de preview-runtime op uw apparaat ingeschakeld, waarop preview-extensies zijn geactiveerd. OpenXR Tools for Windows Mixed Reality app Settings tab
  4. Controleer of de Runtime-versie die wordt weergegeven op het tabblad OpenXR Runtime van de OpenXR Tools voor Windows Mixed Reality overeenkomt met de vereiste versie van de preview-extensies die u wilt proberen. Als dat het geval is, ziet u de extensie in de lijst Extensies . Zodra een stabiele extensie beschikbaar is, wordt de preview-extensie verwijderd.
    OpenXR Tools for Windows Mixed Reality app OpenXR Runtime tab

Zie de Mixed Reality OpenXR-opslagplaats voor documentatie over deze preview-extensies en voorbeelden van hoe u deze kunt gebruiken.

Problemen oplossen

Als u problemen ondervindt met het aan de slag gaan met OpenXR-ontwikkeling, bekijkt u onze tips voor probleemoplossing.