Dela via

Konfigurera ett nytt OpenXR-projekt utan MRTK

  • Artikel

Microsoft och communityn har skapat öppen källkod verktyg som Mixed Reality Toolkit (MRTK) som automatiskt konfigurerar din miljö för mixad verklighet, men vissa utvecklare kanske vill skapa sina erfarenheter från grunden.

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 Mixed Reality OpenXR-plugin-programmet

  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 navigera sedan till mappen som innehåller Unity-projektet och öppna det.

    Öppna projektet

    Anteckning

    Rutan Projektsökväg i verktyget måste innehålla ett visst 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 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.

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

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

  8. På sidan Importera funktioner visas de paket som du precis har valt i kolumnen Till vänster, Funktioner. Kolumnen på höger sida, 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.

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

  10. Välj Godkänn.

  11. Gå tillbaka till Unity-redigeraren och klicka på ett tomt område i användargränssnittet. Du ser ett förloppsfält som visar att paketet 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 alternativet För omstart av Unity.

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

Om du utvecklar för skrivbords-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 har markerats som "scenspecifika" (om 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 just nu. Fortsätt till Konfigurera spelarinställningar för nästa steg.

Konfigurera projektet för HoloLens 2 manuellt

Om du utvecklar för skrivbords-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 Hantering av XR-plugin-program och på fliken Universell Windows-plattform.

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

  3. Kontrollera att Initiera XR vid start har valts och klicka sedan på OpenXR under Plugin-providers.

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

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 (Fristående) för att aktivera verifieringsreglerna för en skrivbords-XR-app.
  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 har markerats som "scenspecifika" (om 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 och på fliken PC, Mac & Fristående Linux .

    Skärmbild av fönstret Projektinställningar som är öppet på sidan för XR-plugin-hantering och pc, Mac & fristående Linux-flik.

  3. Kontrollera att Initiera XR vid start har valts och klicka sedan på OpenXR under Plugin-providers.

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

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. Instruktionerna är dock desamma för fliken Skrivbords-VR, 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 OpenXR-projektverifiering 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 Validering av OpenXR-projekt.

  3. Ett problem kvarstår och anger att du måste lägga till minst en interaktionsprofil. Om du vill göra det klickar du 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 Eye Gaze Interaction Profile, eller någon annan profil, visas med en gul triangel bredvid den väljer 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 eye gaze-interaktionsprofilen.

  6. I fönstret Projektinställningar under OpenXR-funktionsgrupper kontrollerar du att följande är markerade:

    Om du är på fliken Skrivbords-VR:

    Windows Mixed Reality

    Handspårning

    Rörelsestyrenhetsmodell

    Skärmbild av OpenXR-funktionsgrupper för fliken Skrivbords-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 bitar.

    Skärmbild av djup 16 bitar som valts för djupöverföringsläge.

    Tips

    Det är valfritt att minska djupformatet till 16 bitar, 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 vision". Detta fördubblar mängden nödvändig databehandling, så det är viktigt att välja den mest effektiva återgivningsvägen i Unity för att spara både cpu- och GPU-tid. Enkel direktinstansåtergivning ä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 till vänster väljer du Spelare.

  2. Observera att rutan Produktnamn redan är fylld 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