Migrera ett Unity 2019-projekt till Unity 2020 + OpenXR

Artikel
07/12/2023

För den smidigaste migreringen rekommenderar vi att du slutför alla steg i den här artikeln i den ordning som visas. Här är en översikt över de viktigaste stegen:

Uppdatera MRTK till den senaste stabila versionen.
Flytta projektet till Unity 2019 XR Plug-in Management.
Välj "Windows Mixed Reality".
Uppgradera till Unity 2020.3 LTS.
Använd funktionsverktyget Mixed Reality för att installera fler paket.
Konfigurera XR-plugin-hantering för OpenXR.

1. Uppdatera MRTK till den senaste stabila versionen

Om du redan använder MRTK rekommenderar vi att det första steget i migreringen är att köra Mixed Reality funktionsverktyget och uppdatera till den senaste stabila versionen av MRTK.

Välj de funktioner som du vill använda

Anteckning

Beskrivningarna och bilderna i det här avsnittet baseras på den senaste versionen av verktyget. Om anvisningarna inte matchar det du ser kontrollerar du att du inte använder en äldre version av verktyget.

Öppna Funktionsverktyget för Microsoft Mixed Reality och klicka sedan på knappen Starta.
Välj knappen Bläddra (det är knappen "tre punkter" i bilden nedan) och navigera sedan till projektet och öppna det.
Välj Identifiera funktioner.

Obs! Du kan behöva vänta några sekunder medan verktyget uppdaterar paketen från feeds.
Observera att det finns en lista över sex paketgrupper på sidan Identifiera funktioner .
Klicka på knappen "+" till vänster om Mixed Reality Toolkit och välj sedan den senaste versionen av Mixed Reality Toolkit Foundation.

Importera funktionerna

När du har gjort dina val klickar du på Hämta funktioner.
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.
När du är redo att gå vidare väljer du Importera. På sidan Granska och godkänn kan du granska information om paketen.
Välj Godkänn. Funktionsverktyget visar ett meddelande om att projektet har uppdaterats.
Gå tillbaka till Unity-redigeraren och klicka på ett tomt område i användargränssnittet. Du ser ett meddelande om att paketen importeras.

Genom att göra den här uppgraderingen medan du fortfarande använder Unity 2019 kan du visa MRTK Project Configurator och se eventuella "inaktuella API"-varningar om hur du hämtar aktuellt. Varningarna talar om för dig vad du ska ändra. Om du inte gör den här MRTK-uppgraderingen först kan det gamla API:et vara borta och du får inte dessa varningar.

Läs mer om funktionsverktyget för Mixed Reality.

2. Flytta projektet till Unity 2019 XR Plug-in Management

När du har uppdaterat MRTK kan du instruera Unity 2019 att använda XR-plugin-hantering.

I Unity-redigeraren på menyraden väljer du Redigera>projektinställningar.
I den vänstra kolumnen i fönstret Projektinställningar väljer du Hantering av XR-plugin-program.

Nu kan du se en knapp med etiketten Install XR Plugin Management button (Installera XR-plugin-hantering ). I så fall fortsätter du med stegen nedan. Om du redan har installerat XR-hanteringssystemet kan du hoppa över resten av stegen i det här avsnittet och fortsätta till nästa avsnitt, "Välj "Windows Mixed Reality".

Klicka på knappen Install XR Plugin Management (Installera hantering av XR-plugin-program).
En dialogruta med namnet Inbyggd VR Har identifierats visas och frågar om du vill ta bort det inbyggda VR-paketet. Klicka på OK.
Dialogrutan Inbyggd VR-aktiverad visas. Klicka på OK. Detta inaktiverar inbyggd VR.
Fönstret MRTK Project Configurator visas och begär att du aktiverar en XR-pipeline. Välj det andra alternativet XR SDK/SR Management.
På nästa sida i Configurator klickar du på Visa inställningar.

3. Välj "Windows Mixed Reality"

Vi är inte riktigt redo att installera OpenXR ännu, men nästa steg hjälper dig att bli ren på alla API:er som bara var tillgängliga och som stöds på den inbyggda XR-sökvägen. (Om du använder MRTK abstraheras det mesta åt dig.)

I fönstret Projektinställningar för Unity-redigeraren kontrollerar du att du är på sidan XR-plugin-hantering .
Gör något av följande:
- Om du riktar in dig på HoloLens 2:
  Kontrollera att du är på fliken Universell Windows-plattform (det är den andra fliken och visar Windows-logotypen) och välj sedan Windows Mixed Reality under Plugin-leverantörer.
- Om du riktar in dig på Desktop VR:
  Se till att du är på fliken Skrivbord (det är den första fliken och visar en bild av en övervakare) och välj sedan Windows Mixed Reality under Plugin-leverantörer.
Fönstret MRTK Project Configurator visas igen. Klicka på knappen Nästa och sedan på Nästa igen. (Du kanske vill ta en stund att läsa förklaringarna på dessa sidor innan du går vidare.)
Välj Importera TMP Essentials.
Välj Klar. Detta stänger configuratorn.
Stäng fönstret Projektinställningar , spara projektet och avsluta sedan Unity.

Anteckning

När du använder XR-plugin-hantering i Unity 2019 stöds inte Azure Spatial Anchors (ASA). Om ditt projekt har ASA-kod kan du inte testa det förrän du har installerat Unity 2020. Annars bör du kunna verifiera din app i det här skedet.

4. Uppgradera till Unity 2020.3 LTS

Installera den senaste LTS-korrigeringsversionen av Unity 2020.3.
Öppna ditt Unity 2019-projekt i Unity 2020.3.

Du ser en dialogruta som frågar om du vill uppgradera projektet till en nyare version av Unity. Klicka på BEKRÄFTA.

Om du tidigare använde AR Foundation 2.0 flyttas projektet automatiskt vidare till AR Foundation 4.0.

5. Använd Mixed Reality-funktionsverktyget för att installera fler paket

Använd Mixed Reality-funktionsverktyget för att importera paketen nedan.

Om du använder ASA öppnar du listrutan Azure Mixed Reality Services och väljer den senaste versionen av Azure Spatial Anchors SDK Core och Azure Spatial Anchors SDK för Windows.
Öppna listrutan Plattformsstöd och välj den senaste versionen av Mixed Reality OpenXR-plugin-programmet.
När paketen har lästs in visas en varningsdialogruta som frågar om du vill starta om Unity-redigeraren för att aktivera serverdelar. Välj Ja.
När Unity öppnas igen visas MRTK Project Configurator . Läs förklaringarna i fönstret en stund och välj sedan Använd.
En dialogruta visas som anger att Unity måste startas om för att indatasystemet ska börja gälla. Välj Använd.

6. Konfigurera XR Plugin Management för OpenXR

När Unity öppnas igen kan du ange OpenXR som körningsmiljö:

Välj Redigera>projektinställningar på menyraden.

Titta i kolumnen till vänster och se till att du är på sidan XR-plugin-hantering och på fliken Universell Windows-plattform (det finns en bild av Windows-logotypen på fliken).
I listan Plug-in Providers (Plugin-leverantörer ) väljer du OpenXR.
I samma avsnitt väljer du Microsoft HoloLens funktionsgrupp.
Observera att det nu finns en gul varningstriangel bredvid OpenXR. Hovra markören över triangeln, läs sedan meddelandet i popup-fönstret och välj sedan triangeln.
I fönstret Projektverifiering i OpenXR visas flera problem. Välj knappen Åtgärda alla .
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 leder dig till inställningarna för OpenXR-plugin-programmet i fönstret Projektinställningar .
Välj plustecknet (+) 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

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.
I avsnittet OpenXR-funktionsgrupper väljer du Microsoft HoloLens och sedan Handspårnings- och rörelsestyrenhetsmodell om de inte redan har valts.
Klicka på listrutan Djupöverföringsläge och välj sedan Djup 16-bitars.
Stäng fönstret Projektinställningar och andra fönster som fortfarande är öppna.