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 simulatorn.

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 och välj Hämta uppdateringar.

Anteckning

Om du använder emulatorn återställs emulatoravbildningen varje gång du startar den, så det bästa är att se till att du har den senaste versionen av emulatoravbildningen HoloLens 2.

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 headset Windows Mixed Reality eller följ anvisningarna 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 också fungerar på fysiska HoloLens 2 enheter.

OpenXR Utvecklarverktyg för Windows Mixed Reality app

Utforska OpenXR-API:et 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 development (Universal Windows Platform-utveckling) installerad i Visual Studio att öppna den helt.

Ä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 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 idag:

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ärnfunktionerna, samt publicerade KHR tillägg EXT och MSFT .

Om du även är intresserad av att experimentera med tillägg kan du kopiera i förhandsversionen MSFT_preview av OpenXR-huvuden 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, samt 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 Explorer hö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 acceptera ä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äsarekällorna till projektet. Detta ger dig åtkomst till OpenXR 1.0-kärnfunktionerna, samt 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örhandsgranskningstillägg

Tilläggen MSFT_preview som anges i tilläggsöversikten ä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 går du 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 Standard OpenXR-huvudena i projektet med förhandsgranskningshuvudena från Mixed Reality OpenXR-lagringsplatsen GitHub.

Så här aktiverar du stöd för förhandsversionstillägget 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 Use latest preview OpenXR runtime (Använd senaste förhandsversion av OpenXR-körning). Detta aktiverar förhandsgranskningskörningen på enheten, där förhandsgranskningstillägg har aktiverats. Fliken OpenXR Utvecklarverktyg för Windows Mixed Reality för Inställningar för utvecklare
  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.
    Fliken Systemstatus Utvecklarverktyg OpenXR Windows Mixed Reality app

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.