Konfigurera ett nytt OpenXR-projekt med MRTK

  • Artikel

Det enklaste sättet att konfigurera Unity-projektet för mixad verklighet är med Mixed Reality Toolkit (MRTK). MRTK för Unity är ett plattformsoberoende utvecklingspaket med öppen källkod som är utformat för att göra det enkelt att skapa fantastiska appar för mixad verklighet.

Informationsgrafik som visar några av funktionerna i Mixed Reality Toolkit.

MRTK tillhandahåller ett plattformsoberoende indatasystem, grundläggande komponenter och vanliga byggstenar för rumsliga interaktioner. Det kan hjälpa dig att påskynda programutvecklingen för Microsoft HoloLens, Windows Mixed Reality integrerande (VR) headset och många andra VR/AR-enheter. Projektet syftar till att minska inträdeshindren, göra det möjligt för alla att skapa program för mixad verklighet och bidra tillbaka till communityn när vi alla växer.

MRTK stöder ett brett utbud av plattformar, inklusive:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Headset för Windows Mixed Reality

  • Headset för OpenVR (HTC Vive/Oculus Rift)

  • Ultraleap handspårning

  • Android- och iOS-enheter

Anteckning

Vi introducerade nyligen MRTK3, den tredje generationen av Microsoft Mixed Reality Toolkit for Unity som bygger på Unitys XR Management-system och XR Interaction Toolkit, med bättre stöd för en mängd olika OpenXR-kompatibla enheter och ett nytt designspråk. Mer information finns i MRTK3-dokumentationen.

Anteckning

Du kan också konfigurera ett nytt OpenXR-projekt utan MRTK.

Andra konfigurationsalternativ som inte är OpenXR att överväga

Windows XR: Microsoft rekommenderar inte att du använder Windows XR-plugin-programmet för nya projekt i Unity 2020. I stället bör du använda Mixed Reality OpenXR-plugin-programmet. Men om du använder Unity 2019 och behöver AR Foundation 2.0 för kompatibilitet med ARCore/ARKit-enheter aktiverar det här plugin-programmet det stödet.

Viktigt

Det här plugin-programmet i Unity 2019 är inte kompatibelt med Azure Spatial Anchors.

Äldre XR:

Om du fortfarande använder Unity 2019 eller tidigare rekommenderar Microsoft att du använder det äldre inbyggda XR-stödet. Även om Windows XR-plugin-programmet fungerar i Unity 2019 rekommenderar vi det inte eftersom det inte är kompatibelt med Azure Spatial Anchors på Unity 2019.

Om du startar ett nytt projekt rekommenderar vi att du installerar Unity 2020 i stället och använder Mixed Reality OpenXR-plugin-programmet.

Komma igång med OpenXR: Skapa ett nytt Unity-projekt

  1. Starta Unity Hub.

  2. Klicka på Nytt projekt på fliken Projekt.

    Skärmbild av fliken Unity Hub i Projekt med knappen Nytt projekt markerad.

  3. Klicka på listrutan under Nytt projekt och välj sedan önskad redigeringsversion.

    Skärmbild av Unity Hub med listrutan Redigerareversion.

  4. Kontrollera att den valda mallen är 3D Core.

  5. I rutan Projektnamn anger du ett namn för projektet, till exempel "MRTK-självstudie".

  6. I rutan Plats klickar du på mappikonen och navigerar sedan till mappen där du vill spara projektet och markerar det. Du kan också skapa en ny mapp.

    Skärmbild av Unity Hub med 3D, Projektnamn, Plats och Skapa markerat.

  7. Klicka på Create Project (Skapa projekt). Projektet öppnas i Unity.

    Skärmbild av projektet som är öppet i Unity.

Varning

Sökvägar i Windows kan vara högst 255 tecken långa (MAX_PATH). Unity påverkas av dessa gränser och kompileringen kan misslyckas om en filsökväg är längre än 255 tecken. Därför rekommenderar vi att du lagrar ditt Unity-projekt så nära roten på enheten som möjligt.

Ange ditt byggmål

  1. På menyraden väljer du Inställningarförfilbygge>....

    Om du vill skapa en app för Windows Mixed Reality måste du välja ett byggmål. Bygginställningarna för Universell Windows-plattform (UWP) riktar sig mot alla enheter, inklusive uppslukande headset som HP Reverb G2. Det här är det bästa valet om du skapar för HoloLens 2. Men om du riktar in dig på skrivbords-VR rekommenderar vi att du använder den fristående plattformen PC, Mac & Linux.

  2. Gör något av följande:

    Om du riktar in dig på Desktop VR:

    • Behåll den fristående plattformen PC, Mac & Linux som väljs som standard i ett nytt Unity-projekt:

    Skärmbild av fönstret Skapa inställningar som är öppet i Unity-redigeraren med PC, Mac & fristående plattform markerad

    Om du riktar in dig på HoloLens 2:

    • Under Plattform väljer du Universell Windows-plattform. Kontrollera att följande inställningar är aktiva:

    Byggtyp: D3D-projekt

    Mål-SDK-version: Senaste installerade

    Lägsta plattformsversion: 10.0.10240.0

    Visual Studio-version: Senast installerad

    Skärmbild av fönstret Skapa inställningar som är öppet i Unity-redigeraren med Universell Windows-plattform markerat.

  3. Klicka på knappen Växla plattform . Unity visar en förloppsindikator när den växlar plattformar.

  4. När växlingsplattformsprocessen är klar stänger du fönstret Bygginställningar .

Ladda ned och installera funktionsverktyget för Mixed Reality

Mixed Reality OpenXR-plugin-programmet kommer i form av ett paket för Unity. Det bästa sättet att identifiera, uppdatera och importera funktionspaket är med Mixed Reality funktionsverktyget. Du kan söka i paket efter namn eller kategori, se deras beroenden och visa föreslagna ändringar i projektets manifestfil innan du importerar.

  1. Ladda ned den senaste versionen av Mixed Reality-funktionsverktyget från Microsoft Download Center.

  2. När nedladdningen är klar navigerar du till den körbara filen MixedRealityFeatureTool.exe och använder den sedan för att starta Mixed Reality funktionsverktyget.

    Skärmbild av Att öppna MixedRealityFeatureTool.

Importera paketen Mixed Reality Toolkit och OpenXR

  1. I funktionsverktyget Mixed Reality väljer du Start.

    Skärmbild av öppningsskärmen för Mixed Reality funktionsverktyget.

  2. Välj knappen Bläddra (det är knappen "tre punkter" i bilden nedan) och gå sedan till projektet och öppna det.

    Öppna projektet

    Anteckning

    Rutan Projektsökväg i verktyget måste innehålla ett värde, så den infogar ett omvänt snedstreck ("_") som standard.

    När du har valt en mapp kontrollerar verktyget att det är en giltig Unity-projektmapp.

    Skärmbild av skärmen Mixed Reality funktionsverktygets projektsökväg.

  3. Välj Identifiera funktioner.

    Obs! Du kan behöva vänta några sekunder medan verktyget uppdaterar paketen från feeds.

  4. Observera att det finns en lista över sex paketgrupper på sidan Identifiera funktioner .

    Huvudgrupperna med paket i funktionsverktyget för Mixed Reality

  5. Klicka på knappen "+" till vänster om Mixed Reality Toolkit (0 av 10) och välj sedan den senaste versionen av Mixed Reality Toolkit Foundation.

    Anteckning

    Mixed Reality Toolkit Foundation-paketet är det enda paketet som måste importeras och konfigureras för att kunna använda MRTK med ditt projekt. Det här paketet innehåller de kärnkomponenter som krävs för att skapa ett program för Mixad verklighet.

  6. Klicka på knappen "+" till vänster om Plattformssupport (0 av 5) och välj sedan den senaste versionen av Mixed Reality OpenXR-plugin-programmet.

    Skärmbild av paketval i funktionsverktyget för Mixed Reality.

  7. När du har gjort dina val klickar du på Hämta funktioner.

  8. Välj Verifiera för att verifiera de paket som du har valt. Du bör se en dialogruta med texten Inga valideringsproblem har identifierats. När du gör det klickar du på OK.

  9. På sidan Importera funktioner visas de paket som du precis har valt i kolumnen till vänster, Funktioner. Kolumnen till höger, Obligatoriska beroenden, visar eventuella beroenden. Du kan klicka på länken Information för något av dessa objekt om du vill veta mer om dem.

  10. När du är redo att gå vidare väljer du Importera. På sidan Granska och godkänn kan du granska information om paketen.

  11. Välj Godkänn.

  12. Gå tillbaka till Unity-redigeraren och klicka på ett tomt område i användargränssnittet. Du ser en förloppsindikator som visar att dina paket importeras.

Konfigurera inställningar för indataserverdelen

  1. När Unity har importerat paketet visas en varning som frågar om du vill aktivera serverdelarna genom att starta om redigeraren. Välj Ja.

    Skärmbild av unity-omstartsalternativet.

Konfigurera projektet för HoloLens 2 via projektverifiering (MR OpenXR 1.6+)

Om du utvecklar för desktop VR hoppar du över det här avsnittet och går till Konfigurera projektet för skrivbords-VR.

  1. På menyraden klickar du på Mixed Reality > Project Validation Settings > HoloLens 2 Application (UWP) för att aktivera verifieringsreglerna för HoloLens 2. För MR OpenXR-plugin-program före version 1.9 är menyalternativet tillgängligt Mixed Reality > Project > Apply rekommenderade projektinställningar för HoloLens 2.
  2. I projektverifieringsfönstret som visas kontrollerar du att du är på fliken UWP-plattform (anges med Windows-logotypen) och klickar på Åtgärda alla för att lösa valideringsproblemen. Observera att det kan finnas problem kvar när du har klickat på Åtgärda alla. I så fall kan du försöka klicka på Åtgärda allt igen, ignorera eventuella problem som är markerade som "scenspecifika" (om det finns några) och gå igenom resten av problemen (om det finns några) för att se om det finns några föreslagna ändringar som du vill göra.
  3. Projektet är nästan klart för HoloLens 2 distribution i det här läget. Fortsätt till Konfigurera spelarinställningar för nästa steg.

Konfigurera projektet för HoloLens 2 manuellt

Om du utvecklar för desktop VR hoppar du över det här avsnittet och går till Konfigurera projektet för skrivbords-VR.

  1. Kontrollera att fönstret Projektinställningar är öppet. Annars väljer du Redigera>projektinställningar på menyraden.

  2. I fönstret Projektinställningar kontrollerar du att du är på sidan XR-plugin-hantering och på fliken Universell Windows-plattform.

    Skärmbild av fönstret Projektinställningar som är öppet på hanteringssidan för XR-plugin-programmet och fliken Universell Windows-plattform.

  3. Kontrollera att Initialize XR on Startup (Initiera XR vid start) är markerat och klicka sedan på OpenXR under Plugin Providers (Plugin-leverantörer).

    Skärmbild av fönstret Projektinställningar i Universell Windows-plattform med Initiera XR vid start markerat och OpenXR-plugin-programmet markerat.

  4. OpenXR-plugin-programmet läses in och sedan visas flera objekt under OpenXR. Välj Microsoft HoloLens funktionsgrupp.

    Skärmbild av fönstret Projektinställningar med OpenXR-plugin-programmet och Microsoft HoloLens-funktionsgruppen markerade.

Observera att det finns en gul varningstriangel bredvid OpenXR. Detta indikerar att du har inkompatibla inställningar som måste lösas. Om du vill ta reda på hur du åtgärdar detta hoppar du över nästa avsnitt om att konfigurera för VR och fortsätter med följande avsnitt, Lösa inkompatibla inställningar.

Konfigurera projektet för skrivbords-VR via projektverifiering (MR OpenXR 1.9+)

  1. På menyraden klickar du på Mixed Reality > Project Validation Settings > Win32 Application (Standalone) (Win32-program (fristående) för att aktivera verifieringsreglerna för en XR-skrivbordsapp.
  2. I projektverifieringsfönstret som visas kontrollerar du att du är på fliken Fristående plattform och klickar på Åtgärda alla för att lösa valideringsproblemen. Observera att det kan finnas problem kvar när du har klickat på Åtgärda alla. I så fall kan du försöka klicka på Åtgärda allt igen, ignorera eventuella problem som är markerade som "scenspecifika" (om det finns några) och gå igenom resten av problemen (om det finns några) för att se om det finns några föreslagna ändringar som du vill göra.

Konfigurera projektet för skrivbords-VR manuellt

  1. Kontrollera att fönstret Projektinställningar är öppet. Annars går du till menyraden och väljer Redigera>projektinställningar.

  2. I fönstret Projektinställningar kontrollerar du att du är på sidan XR Plug-in Management (XR-plugin-hantering ) och på fliken PC, Mac & Linux Standalone (Fristående Linux ).

    Skärmbild av fönstret Projektinställningar som är öppet för hanteringssidan för XR-plugin-programmet och fliken Mac & fristående Linux.

  3. Kontrollera att Initialize XR on Startup (Initiera XR vid start) är markerat och klicka sedan på OpenXR under Plugin Providers (Plugin-leverantörer).

    Skärmbild av fönstret Projektinställningar på fliken Pc, Mac & Fristående Linux med Initiera XR vid start markerat och OpenXR-plugin-programmet markerat.

  4. OpenXR-plugin-programmet läses in och sedan visas två objekt under OpenXR. Välj den första Windows Mixed Reality funktionsgruppen.

    Skärmbild av fönstret Projektinställningar, openxr-plugin-programmet och Windows Mixed Reality-funktionsgruppen markerade.

Observera att det nu finns en gul varningstriangel bredvid OpenXR. Detta indikerar att du har inkompatibla inställningar som måste lösas. Om du vill ta reda på hur du åtgärdar detta fortsätter du till nästa avsnitt , Lösa inkompatibla inställningar.

Lösa inkompatibla inställningar

Viktigt

Bilderna i det här avsnittet visar alternativen på fliken Universell Windows-plattform. Anvisningarna är dock desamma för desktop VR-fliken, förutom där det anges.

  1. Hovra markören över den gula varningstriangeln bredvid OpenXR, läs sedan meddelandet i popup-fönstret och välj sedan triangeln.

    Skärmbild av varning om inkompatibla inställningar.

  2. I fönstret Projektverifiering i OpenXR visas flera problem. Välj knappen Åtgärda alla . Obs! Den här listan kan se annorlunda ut beroende på vilken flik du befinner dig i.

    Skärmbild av knappen Åtgärda alla i fönstret Projektverifiering i OpenXR.

  3. Ett problem kvarstår och anger att du måste lägga till minst en interaktionsprofil. Det gör du genom att klicka på Redigera. Detta tar dig till inställningarna för OpenXR-plugin-programmet i fönstret Projektinställningar .

    Skärmbild av fönstret Projektinställningar med OpenXR-inställningarna.

  4. Under Interaktionsprofiler noterar du plustecknet (+).

    Skärmbild av knappen Lägg till interaktionsprofil.

  5. Klicka på knappen tre gånger, varje gång du väljer en annan profil:

    Interaktionsprofil för ögonöga

    Microsoft Hand Interaction Profile

    Profil för Microsoft Motion Controller

    Skärmbild av interaktionsprofiler som ska läggas till.

    Om interaktionsprofilen för ögonöga, eller någon annan profil, visas med en gul triangel bredvid den markerar du triangeln och klickar sedan på knappen Åtgärda i OpenXR-projektverifieringsfönstret. När du är klar stänger du fönstret OpenXR-projektverifiering .

    Skärmbild av knappen Åtgärda för interaktionsprofilen för Ögonöga.

  6. Kontrollera att följande är markerat i fönstret Projektinställningar under OpenXR-funktionsgrupper:

    Om du är på fliken Desktop VR:

    Windows Mixed Reality

    Handspårning

    Rörelsestyrenhetsmodell

    Skärmbild av OpenXR-funktionsgrupper för fliken Desktop VR.

    Om du är på fliken Universell Windows-plattform:

    Microsoft HoloLens

    Handspårning

    Rörelsestyrenhetsmodell

    Skärmbild av valda funktioner för OpenXR.

  7. Klicka på listrutan Djupöverföringsläge och välj sedan Djup 16-bitars.

    Skärmbild av djup 16-bitars valt för djupöverföringsläge.

    Tips

    Det är valfritt att minska djupformatet till 16-bitars, men det kan förbättra grafikprestanda i projektet. Mer information finns i Djupbuffertdelning (HoloLens).

    Anteckning

    Inställningen Återgivningsläge , som ligger precis ovanför djupöverföringsläget, är som standard inställd på Single Pass Instanced. I appar för mixad verklighet återges scenen två gånger: en gång för varje öga. Resultatet är "stereoskopisk syn". Detta fördubblar mängden nödvändig databehandling, så det är viktigt att välja den mest effektiva renderingsvägen i Unity för att spara på både CPU- och GPU-tid. Enkel direktinstansrendering är det bästa valet här – vi rekommenderar att du aktiverar det som standard för varje projekt. Mer information om detta finns i Unity-dokumentationen.

Konfigurera spelarinställningar

  1. I fönstret Projektinställningar i kolumnen till vänster väljer du Spelare.

  2. Observera att rutan Produktnamn redan är ifylld i fönstret Spelare. Detta hämtas från projektnamnet och kommer att vara namnet som visas på Start-menyn i HoloLens.

    Skärmbild av Unity-publiceringsinställningar med rutan Projektnamn ifylld.

    Tips

    Om du vill göra appen enklare att hitta under utvecklingen lägger du till ett understreck framför namnet för att sortera det överst i en lista.

  3. Klicka på listrutan Publiceringsinställningar och ange sedan ett lämpligt namn i fältet Paketnamn .

    Skärmbild av Inställningar för Unity-publicering med paketnamnsrutan ifylld.

    Anteckning

    Paketnamnet är den unika identifieraren för appen. Om du vill undvika att skriva över tidigare installerade versioner av appen med samma namn bör du ändra den här identifieraren innan du distribuerar appen.

  4. Stäng fönstret Projektinställningar .

Nu är du redo att börja utveckla med OpenXR i Unity!

Unity-exempelprojekt

Kolla in OpenXR-Mixed Reality exempelrepo för unity-exempelprojekt som visar hur du skapar Unity-program för HoloLens 2 eller Mixed Reality headset med hjälp av Mixed Reality OpenXR-plugin-programmet.

Se även