Komma igång med OpenXR

Du kan utveckla med OpenXR på en HoloLens 2 eller Windows Mixed Reality integrerande headset på skrivbordet. Om du inte har åtkomst till ett headset kan du använda HoloLens 2 Emulator eller Windows Mixed Reality Simulator.

Komma igång med OpenXR för HoloLens 2

Börja utveckla OpenXR-program för HoloLens 2:

1. Konfigurera en HoloLens 2 eller följ anvisningarna för att installera en ny version av HoloLens 2-emulatorn. Du bör redan ha OpenXR 1.0 redo att användas om du använder en ny emulatoravbildning eller om enheten har uppdaterat sitt operativsystem.
2. Kontrollera att du har den senaste OpenXR-körningen med alla tillägg som finns genom att starta Store-appen från enheten eller emulatorn.
   • Öppna menyn uppe till höger, välj Nedladdningar och uppdateringar ochvälj Hämta uppdateringar.

Komma igång med OpenXR för Windows Mixed Reality headset

Börja utveckla OpenXR-program för integrerande Windows Mixed Reality headset:

1. Se till att du kör minst Maj 2019-uppdatering för Windows 10 (1903), vilket är minimikravet för att Windows Mixed Reality slutanvändarna ska kunna köra OpenXR-program. Om du har en tidigare version av Windows 10 kan du uppgradera med hjälp av Windows 10 Update Assistant.
2. Konfigurera ett Windows Mixed Reality headset eller följ instruktionerna för att aktivera Windows Mixed Reality simulatorn.

Klart! Den Windows Mixed Reality OpenXR-körningen installeras och aktiveras automatiskt för alla Windows Mixed Reality användare. Den Microsoft Store ser sedan till att körningen är uppdaterad.

Om du vill Windows Mixed Reality OpenXR Runtime igen startar du Portalen för Mixad verklighet från Start-menyn och väljer "Åtgärda det" överst i fönstret. Om den knappen saknas är OpenXR-körningen redan aktiv.

Hämta OpenXR-Utvecklarverktyg för Windows Mixed Reality

Om du vill prova Windows Mixed Reality OpenXR Runtime kan du installera OpenXR-Utvecklarverktyg för Windows Mixed Reality appen. Den här appen innehåller en demonstration av olika OpenXR-funktioner, tillsammans med en systemstatussida med viktig information om den aktiva körningen och det aktuella headsetet.

När du använder HoloLens 2-emulatorn är det enklaste sättet att installera OpenXR-Utvecklarverktyg för Windows Mixed Reality via Windows Enhetsportalen. Gå till sidan "OpenXR" och klicka sedan på knappen "Installera" under "Utvecklarfunktioner", som även fungerar på fysiska HoloLens 2 enheter.

Utforska OpenXR API och exempelappen

Se till att installera de verktyg som du behöver för OpenXR-utveckling om du inte redan har gjort det.

BasicXrApp-projektet visar ett enkelt OpenXR-exempel med Win32- och UWP HoloLens 2-projektfiler i Visual Studio. Eftersom lösningen innehåller ett HoloLens UWP-projekt behöver du arbetsbelastningen Universal Windows Platform-utveckling installerad i Visual Studio för att helt öppna den.

Även om Win32- och UWP-projektfilerna är separata på grund av skillnader i paketering och distribution, är appkoden i varje projekt nästan exakt densamma!

Köra din OpenXR-app

När du har byggt en OpenXR Win32-.EXE kan du använda den med ett VR-headset på valfri VR-skrivbordsplattform som stöder OpenXR, oavsett typ av headset.

När du har byggt ett OpenXR UWP-appaket kan du distribuera det paketet till antingen en HoloLens 2-enhet eller HoloLens 2 Emulator.

Learning OpenXR API

En rundtur i OpenXR-API:et finns i den här 60-minutersvideon med BasicXrApp-exemplet i Visual Studio. Videon visar hur var och en av de viktigaste komponenterna i OpenXR-API:et kan användas i din egen motor och visar även några av de program som bygger på OpenXR i dag:

Använda OpenXR i ett befintligt projekt

För att komma igång med OpenXR i ett befintligt projekt inkluderar du OpenXR-inläsaren. Inläsaren identifierar den aktiva OpenXR-körningen på enheten och ger åtkomst till de kärnfunktioner och tilläggsfunktioner som den implementerar.

Du kan referera till det officiella OpenXR NuGet-paketet från ditt Visual Studio-projekt eller inkludera den officiella OpenXR-inläsaren från Khronos GitHub-lagringsplatsen. Endera metoden ger dig åtkomst till OpenXR 1.0-kärnfunktioner, plus publicerade KHR tillägg EXT och MSFT .

Om du även är intresserad av att experimentera med tillägg kan du kopiera i förhandsversionen av MSFT_previewMSFT_preview från Mixed Reality GitHub lagringsplatsen.

Referens för det officiella OpenXR NuGet-paketet

OpenXR.Loader NuGet-paketet är det enklaste sättet att referera till en förbyggd OpenXR-.DLL i din Visual Studio C++-lösning. Detta ger dig åtkomst till OpenXR 1.0-kärnfunktionerna, plus publicerade KHR tillägg EXT och MSFT .

Så här lägger du till en OpenXR.Loader NuGet-paketreferens Visual Studio C++-lösningen:

1. I Solution Explorerhögerklickar du på projektet som ska använda OpenXR och väljer Hantera NuGet-paket....
2. Växla till fliken Bläddra och sök efter OpenXR.Loader.
3. Välj OpenXR.Loader-paketet och välj Installera i informationsfönstret till höger.
4. Välj OK för att godkänna ändringarna i projektet.
5. Lägg #include <openxr/openxr.h> till i en källfil för att börja använda OpenXR-API:et.

Om du vill se ett exempel på OpenXR API i praktiken kan du titta på BasicXrApp-exempelappen.

Inkludera den officiella OpenXR-inläsaren

Om du vill skapa inläsaren själv, till exempel för att undvika extra inläsaren .DLL, kan du hämta de officiella Khronos OpenXR-inläsaren till projektet. Detta ger dig åtkomst till OpenXR 1.0-kärnfunktionerna, plus publicerade KHR tillägg EXT och MSFT .

Kom igång här genom att följa anvisningarna i Khronos OpenXR-SDK-lagringsplatsen på GitHub. Projektet är inställt på att byggas med CMake – om du använder MSBuild måste du kopiera koden till ditt eget projekt.

Använda förhandsversionstillägg

Tilläggen MSFT_preview som anges i MSFT_preview är experimentella leverantörstillägg som förhandsgranskas för att samla in feedback. Dessa tillägg är endast för utvecklarenheter och tas bort när det verkliga tillägget levereras.

Om du är intresserad av att prova de tillgängliga MSFT_preview tilläggen kan du gå igenom följande steg för att uppdatera projektet:

1. Följ någon av metoderna ovan för att integrera en OpenXR-inläsare i projektet.
2. Ersätt OpenXR-standardhuvudena i projektet med förhandsgranskningshuvudena från Mixed Reality OpenXR-lagringsplatsen GitHub.

Aktivera sedan stöd för förhandsversionstillägg på måldatorn HoloLens 2 eller stationär dator:

1. Kontrollera att du har den senaste OpenXR-körningen med alla tillägg genom att starta Store-appen från målenheten eller emulatorn, öppna menyn uppe till höger, välja Nedladdningar och uppdateringar och välja Hämta uppdateringar.
2. Installera OpenXR-Utvecklarverktyg för Windows Mixed Reality från Microsoft Store på målenheten och kör den.
3. Gå till fliken Developer Inställningar och aktivera Använd den senaste förhandsversionen av OpenXR Runtime. Detta aktiverar förhandsgranskningskörningen på enheten, som har förhandsgranskningstillägg aktiverade.
4. Bekräfta att körningsversionen som visas på fliken Systemstatus i OpenXR-Utvecklarverktyg för Windows Mixed Reality matchar den version av förhandsversionstilläggen som du planerar att prova. I så fall bör du se tillägget i listan Tillägg. När ett stabilt tillägg är tillgängligt tas dess förhandsversionstillägg bort.
   

Se Mixed Reality OpenXR-lagringsplatsen för dokumentation om dessa förhandsversionstillägg och exempel på hur du använder dem.

Felsökning

Om du har problem med att komma igång med OpenXR-utveckling kan du läsa våra felsökningstips.