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

Äldre XR:

Om du fortfarande använder Unity 2019 eller tidigare rekommenderar Microsoft att du använder stöd för äldre inbyggd XR.

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

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

  1. Starta Unity Hub.

  2. På fliken Projekt klickar du på Nytt 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 den redigeringsversion du vill använda.

    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 väljer det. Du kan också skapa en ny mapp.

    Skärmbild av Unity Hub där 3D, Project Name (Projektnamn), Location (Plats) och Create (Skapa) är markerade.

  7. Klicka på Create Project (Skapa projekt). Detta öppnar ditt projekt 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 byggmålet

  1. På menyraden väljer du Inställningar för filbygge>....

    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. Detta ä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 och 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 och Linux som är vald som standard i ett nytt Unity-projekt:

    Skärmbild av fönstret Bygginställningar som är öppet i Unity-redigeraren med PC, Mac och fristående plattform markerade

    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: Senast installerad

    Lägsta plattformsversion: 10.0.10240.0

    Visual Studio-version: Senast installerad

    Skärmbild av fönstret Bygginställningar som öppnas 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

Plugin-programmet Mixed Reality OpenXR kommer i form av ett paket för Unity. Det bästa sättet att identifiera, uppdatera och importera funktionspaket är med funktionsverktyget för Mixed Reality. Du kan söka efter 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 för att starta funktionsverktyget för Mixed Reality.

    Skärmbild av Att öppna MixedRealityFeatureTool.

Importera Plugin-programmet Mixed Reality OpenXR

  1. I funktionsverktyget för mixad verklighet 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 den.

    Öppna ditt projekt

    Kommentar

    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 Projektsökväg för mixed reality-funktionsverktyg.

  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.

    De viktigaste grupperna av paket i funktionsverktyget för Mixad verklighet

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

  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 visar kolumnen till vänster, Funktioner, de paket som du precis har valt. 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 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 (som anges av Windows-logotypen) och klickar på Åtgärda alla för att lösa valideringsproblemen. Observera att det kan finnas problem som kvarstår 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 några) och gå igenom resten av problemen (om 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 XR-plugin-hantering och på fliken Universell Windows-plattform.

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

  3. Se till att Initiera XR vid start är valt och klicka sedan på OpenXR under 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 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å Valideringsinställningar > för Mixed Reality-projekt > 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 som kvarstår 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 några) och gå igenom resten av problemen (om 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 ser du till att du är på sidan XR Plug-in Management och på fliken PC, Fristående Mac och Linux .

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

  3. Se till att Initiera XR vid start är valt och klicka sedan på OpenXR under Plugin-leverantörer.

    Skärmbild av fönstret Projektinställningar på fliken Pc, Mac och Linux fristående, 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, funktionsgruppen OpenXR Plugin och Windows Mixed Reality 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 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 som visas.

  4. Anteckna plustecknet (+) under Interaktionsprofiler.

    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ögen, eller någon annan profil, visas med en gul triangel bredvid den väljer du triangeln och klickar sedan på knappen Åtgärda i fönstret Projektverifiering i OpenXR. När du är klar stänger du fönstret Validering av OpenXR-projekt.

    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.

    Dricks

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

    Kommentar

    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 återgivningsvägen i Unity för att spara både cpu- och GPU-tid. Återgivning med enkel passinstans är det bästa valet här – vi rekommenderar att du aktiverar den 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. Det här är hämtat från projektnamnet och kommer att vara namnet som visas i HoloLens-Start-menyn.

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

    Dricks

    För att 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 Unity-publiceringsinställningar med paketnamnsrutan ifylld.

    Kommentar

    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 Lagringsplatsen för OpenXR Mixed Reality-exempel för unity-exempelprojekt som visar hur du skapar Unity-program för HoloLens 2- eller Mixed Reality-headset med plugin-programmet Mixed Reality OpenXR.

Se även