Een Unity 2019-project migreren naar Unity 2020 + OpenXR

Artikel
07/12/2023

Voor de soepelste migratie raden we u aan alle stappen in dit artikel in de aangegeven volgorde uit te voeren. Hier volgt een overzicht van de belangrijkste stappen:

Werk MRTK bij naar de nieuwste stabiele versie.
Verplaats uw project naar Unity 2019 XR-invoegtoepassingsbeheer.
Kies 'Windows Mixed Reality'.
Upgrade naar Unity 2020.3 LTS.
Gebruik het Mixed Reality Feature Tool om meer pakketten te installeren.
XR-invoegtoepassingsbeheer configureren voor OpenXR.

1. MRTK bijwerken naar de nieuwste stabiele versie

Als u MRTK al gebruikt, raden we u aan om als eerste stap in uw migratie het hulpprogramma Mixed Reality functie uit te voeren en bij te werken naar de nieuwste stabiele versie van MRTK.

Selecteer de gewenste functies

Notitie

De beschrijvingen en afbeeldingen in deze sectie zijn gebaseerd op de meest recente versie van het hulpprogramma. Als de instructies niet overeenkomen met wat u ziet, controleert u of u geen oudere versie van het hulpprogramma gebruikt.

Open het Microsoft Mixed Reality-functieprogramma en klik op de knop Start.
Selecteer de knop Bladeren (dit is de knop met drie punten in de onderstaande afbeelding), navigeer naar uw project en open het.
Selecteer Functies ontdekken.

Opmerking: mogelijk moet u enkele seconden wachten terwijl het hulpprogramma de pakketten van de feeds vernieuwt.
Op de pagina Functies ontdekken ziet u dat er een lijst met zes pakketgroepen is.
Klik op de knop '+' links van Mixed Reality Toolkit en selecteer vervolgens de nieuwste versie van Mixed Reality Toolkit Foundation.

De functies importeren

Nadat u uw selectie(s) hebt gemaakt, klikt u op Functies ophalen.
Op de pagina Functies importeren worden in de linkerkolom Functies de pakketten weergegeven die u zojuist hebt geselecteerd. In de rechterkolom , Vereiste afhankelijkheden, worden eventuele afhankelijkheden weergegeven. U kunt op de koppeling Details klikken voor een van deze items voor meer informatie.
Wanneer u klaar bent om verder te gaan, selecteert u Importeren. Op de pagina Controleren en goedkeuren kunt u informatie over de pakketten bekijken.
Selecteer Goedkeuren. In het functieprogramma wordt een bericht weergegeven dat uw project is bijgewerkt.
Ga terug naar de Unity-editor en klik op een leeg gebied in de gebruikersinterface. Er wordt een bericht weergegeven waarin staat dat uw pakketten worden geïmporteerd.

Als u deze upgrade uitvoert terwijl u Unity 2019 gebruikt, kunt u de MRTK Project Configurator bekijken en eventuele 'afgeschafte API'-waarschuwingen zien over hoe u up-to-date kunt worden. In de waarschuwingen wordt opgegeven wat u moet wijzigen. Als u deze MRTK-upgrade niet eerst uitvoert, is de oude API mogelijk verdwenen en krijgt u deze waarschuwingen niet meer.

Meer informatie over het hulpprogramma Mixed Reality functie.

2. Uw project verplaatsen naar Unity 2019 XR-invoegtoepassingsbeheer

Nadat u MRTK hebt bijgewerkt, kunt u Unity 2019 opdracht geven om XR-invoegtoepassingsbeheer te gebruiken.

Selecteer in de Unity-editor op de menubalkProjectinstellingenbewerken>.
Selecteer in de linkerkolom van het venster Projectinstellingen de optie XR-invoegtoepassingsbeheer.

Op dit punt ziet u mogelijk een knop met de naam Knop XR-invoegtoepassingsbeheer installeren . Als dat het zo is, gaat u verder met de onderstaande stappen. Als u het XR-beheersysteem al hebt geïnstalleerd, kunt u de rest van de stappen in deze sectie overslaan en doorgaan met de volgende sectie, 'Kies 'Windows Mixed Reality'.

Klik op de knop XR-invoegtoepassingsbeheer installeren .
Er wordt een dialoogvenster met de naam Ingebouwde VR gedetecteerd weergegeven en u wordt gevraagd of u het ingebouwde VR-pakket wilt verwijderen. Klik op OK.
Het dialoogvenster Ingebouwde VR ingeschakeld wordt weergegeven. Klik op OK. Hiermee schakelt u de ingebouwde VR uit.
Het venster MRTK Project Configurator wordt weergegeven en u wordt gevraagd een XR-pijplijn in te schakelen. Selecteer de tweede optie, XR SDK/SR Management.
Klik op de volgende pagina in de Configurator op Instellingen weergeven.

3. Kies 'Windows Mixed Reality'

We zijn nog niet helemaal klaar om OpenXR te installeren, maar met deze volgende reeks stappen kunt u alle API's opschonen die alleen beschikbaar en ondersteund werden op het pad 'Ingebouwd XR'. (Als u MRTK gebruikt, wordt het grootste deel hiervan voor u geabstraheerd.)

Controleer in het venster Projectinstellingen van Unity Editor of u zich op de pagina Beheer van XR-invoegtoepassing bevindt.
Voer een van de volgende handelingen uit:
- Als u zich op de HoloLens 2 richt:
  Zorg ervoor dat u zich op het tabblad Universeel Windows-platform bevindt (dit is het tweede tabblad met het Windows-logo) en selecteer vervolgens onder Invoegtoepassingen de optie Windows Mixed Reality.
- Als u zich richt op Desktop VR:
  Zorg ervoor dat u zich op het tabblad Bureaublad bevindt (dit is het eerste tabblad waarop een afbeelding van een beeldscherm wordt weergegeven) en selecteer vervolgens onder Invoegtoepassingende optie Windows Mixed Reality.
Het venster MRTK Project Configurator wordt opnieuw weergegeven. Klik op de knop Volgende en klik vervolgens nogmaals op Volgende . (U kunt even de tijd nemen om de uitleg op deze pagina's te lezen voordat u verdergaat.)
Selecteer TMP Essentials importeren.
Selecteer Gereed. Hiermee wordt de Configurator gesloten.
Sluit het venster Projectinstellingen , sla uw project op en sluit Unity af.

Notitie

Wanneer u XR-invoegtoepassingsbeheer gebruikt in Unity 2019, wordt Azure Spatial Anchors (ASA) niet ondersteund. Als uw project ASA-code heeft, kunt u deze pas testen nadat u Unity 2020 hebt geïnstalleerd. Anders moet u uw app in deze fase kunnen valideren.

4. Upgraden naar Unity 2020.3 LTS

Installeer de nieuwste LTS-patchversie van Unity 2020.3.
Open uw Unity 2019-project in Unity 2020.3.

U ziet een dialoogvenster waarin u wordt gevraagd of u uw project wilt upgraden naar een nieuwere versie van Unity. Klik op BEVESTIGEN.

Als u eerder AR Foundation 2.0 gebruikte, wordt u automatisch door het project verplaatst naar AR Foundation 4.0.

5. Gebruik het Mixed Reality-functieprogramma om meer pakketten te installeren

Gebruik het Mixed Reality Feature Tool om de onderstaande pakketten te importeren.

Als u ASA gebruikt, opent u de vervolgkeuzelijst Azure Mixed Reality Services en selecteert u de nieuwste versie van Azure Spatial Anchors SDK Core en Azure Spatial Anchors SDK voor Windows.
Open de vervolgkeuzelijst Platformondersteuning en selecteer de nieuwste versie van Mixed Reality OpenXR-invoegtoepassing.
Nadat de pakketten zijn geladen, wordt het dialoogvenster Waarschuwing weergegeven waarin u wordt gevraagd of u de Unity-editor opnieuw wilt starten om back-ends in te schakelen. Selecteer Ja.
Wanneer Unity opnieuw wordt geopend, wordt de MRTK Project Configurator weergegeven. Neem even de tijd om de uitleg in het venster te lezen en selecteer vervolgens Toepassen.
Er verschijnt een dialoogvenster waarin wordt aangegeven dat Unity opnieuw moet worden opgestart om het invoersysteem van kracht te laten worden. Selecteer Toepassen.

6. XR-invoegtoepassingsbeheer configureren voor OpenXR

Nadat Unity opnieuw is geopend, kunt u OpenXR instellen als de runtime:

Selecteer Projectinstellingen bewerken> in de menubalk.

Kijk in de kolom aan de linkerkant en controleer of u zich op de pagina XR-invoegtoepassingsbeheer en op het tabblad Universeel Windows-platform bevindt (er staat een afbeelding van het Windows-logo op het tabblad).
Selecteer OpenXR in de lijst Invoegtoepassingsproviders.
Selecteer in dezelfde sectie Microsoft HoloLens functiegroep.
Er staat nu een gele waarschuwingsdriehoek naast OpenXR. Beweeg de muisaanwijzer over de driehoek, lees het bericht in de pop-up en selecteer de driehoek.
In het venster OpenXR-projectvalidatie worden verschillende problemen vermeld. Selecteer de knop Alles herstellen .
Er blijft één probleem bestaan en u moet ten minste één interactieprofiel toevoegen. Klik hiervoor op Bewerken. Hiermee gaat u naar de instellingen voor de OpenXR-invoegtoepassing in het venster Projectinstellingen .
Selecteer het plusteken (+) drie keer en kies telkens een ander profiel:

Interactieprofiel voor ogen staren

Microsoft-profiel voor handinteractie

Microsoft Motion Controller-profiel

Als het Eye Gaze Interaction Profile of een ander profiel wordt weergegeven met een gele driehoek ernaast, selecteert u de driehoek en klikt u vervolgens in het venster OpenXR-projectvalidatie op de knop Herstellen .
Selecteer in de sectie OpenXR-functiegroepende optie Microsoft HoloLens en selecteer vervolgens Handtracering en bewegingscontrollermodel als deze nog niet zijn geselecteerd.
Klik op de vervolgkeuzelijst Modus diepteverzending en selecteer vervolgens Diepte 16-bits.
Sluit het venster Projectinstellingen en alle andere vensters die nog geopend zijn.