Migrer un projet Unity 2019 vers Unity 2020 + OpenXR

2025-02-18

Pour une migration plus fluide, nous vous recommandons d’effectuer toutes les étapes décrites dans cet article dans l’ordre présenté. Voici une vue d’ensemble des principales étapes :

Mettez à jour MRTK vers la dernière version stable.
Déplacez votre projet vers Unity 2019 XR Plug-in Management.
Choisissez « Windows Mixed Reality ».
Effectuez une mise à niveau vers Unity 2020.3 LTS.
Utilisez l’outil de fonctionnalité Mixed Reality pour installer d’autres packages.
Configurez la gestion des plug-ins XR pour OpenXR.

1. Mettre à jour MRTK vers la dernière version stable

Si vous utilisez déjà MRTK, nous vous suggérons que la première étape de votre migration soit d’exécuter l’outil de fonctionnalité Mixed Reality et de mettre à jour vers la dernière version stable de MRTK.

Sélectionnez les fonctionnalités souhaitées

Remarque

Les descriptions et les images de cette section sont basées sur la version la plus récente de l’outil. Si les instructions ne correspondent pas à ce que vous voyez, case activée pour vous assurer que vous n’utilisez pas une version antérieure de l’outil.

Ouvrez Microsoft Mixed Reality Feature Tool, puis cliquez sur le bouton Démarrer.
Sélectionnez le bouton Parcourir (il s’agit du bouton « trois points » dans l’image ci-dessous), accédez à votre projet, puis ouvrez-le.
Sélectionnez Découvrir les fonctionnalités.

Remarque : vous devrez peut-être attendre quelques secondes pendant que l’outil actualise les packages à partir des flux.
Dans la page Découvrir les fonctionnalités , notez qu’il existe une liste de six groupes de packages.
Cliquez sur le bouton « + » à gauche de Mixed Reality Toolkit, puis sélectionnez la dernière version de Mixed Reality Toolkit Foundation.

Importer les fonctionnalités

Une fois que vous avez effectué vos sélections, cliquez sur Obtenir des fonctionnalités.
Dans la page Importer des fonctionnalités , la colonne de gauche, Fonctionnalités, affiche les packages que vous venez de sélectionner. La colonne de droite, Dépendances requises, affiche toutes les dépendances. Vous pouvez cliquer sur le lien Détails de l’un de ces éléments pour en savoir plus à leur sujet.
Lorsque vous êtes prêt à passer à autre chose, sélectionnez Importer. Dans la page Vérifier et approuver , vous pouvez consulter des informations sur les packages.
Sélectionnez Approuver. L’outil fonctionnalité affiche un message indiquant que votre projet a été mis à jour.
Revenez à unity Rédacteur et cliquez sur une zone vide dans l’interface utilisateur. Vous verrez un message vous indiquant que vos packages sont importés.

En effectuant cette mise à niveau tout en utilisant Unity 2019, vous pouvez afficher le configurateur de projet MRTK et voir les avertissements d'« API déconseillées » sur la façon d’être à jour. Les avertissements vous indiquent ce qu’il faut modifier. Si vous n’effectuez pas cette mise à niveau MRTK en premier, l’ancienne API est peut-être supprimée et vous n’aurez pas ces avertissements.

En savoir plus sur l’outil de fonctionnalité Mixed Reality.

2. Déplacer votre projet vers gestion des plug-ins Unity 2019 XR

Après avoir mis à jour MRTK, vous pouvez demander à Unity 2019 d’utiliser la gestion des plug-ins XR.

Dans l’éditeur Unity de la barre de menus, sélectionnez Modifier les>paramètres du projet.
Dans la colonne de gauche de la fenêtre Paramètres du projet , sélectionnez Gestion du plug-in XR.

À ce stade, vous pouvez voir un bouton intitulé Bouton Installer la gestion du plug-in XR . Si c’est le cas, poursuivez avec les étapes ci-dessous. Si le système de gestion XR est déjà installé, vous pouvez ignorer les autres étapes de cette section et passer à la section suivante, « Choisir Windows Mixed Reality ».

Cliquez sur le bouton Installer la gestion des plug-ins XR .
Une boîte de dialogue nommée Vr intégré détecté s’affiche et vous demande si vous souhaitez supprimer le package VR intégré. Cliquez sur OK.
La boîte de dialogue Intégré à vr activé s’affiche . Cliquez sur OK. Cela désactive la réalité virtuelle intégrée.
La fenêtre MRTK Project Configurator s’affiche et vous demande d’activer un pipeline XR. Sélectionnez la deuxième option, Gestion du Kit de développement logiciel (SDK) XR/SR.
Dans la page suivante du Configurator, cliquez sur Afficher les paramètres.

3. Choisissez « Windows Mixed Reality »

Nous ne sommes pas encore prêts à installer OpenXR, mais cette prochaine série d’étapes vous aide à obtenir propre sur toutes les API qui n’étaient disponibles et prises en charge que sur le chemin « XR intégré ». (Si vous utilisez MRTK, la plupart de ces informations sont abstraites pour vous.)

Dans la fenêtre Paramètres du projet Unity Rédacteur, vérifiez que vous êtes sur la page Gestion du plug-in XR.
Effectuez l’une des opérations suivantes :
- Si vous ciblez le HoloLens 2 :
  Vérifiez que vous êtes dans l’onglet plateforme Windows universelle (il s’agit du deuxième onglet et affiche le logo Windows), puis, sous Fournisseurs de plug-ins, sélectionnez Windows Mixed Reality.
- Si vous ciblez Desktop VR :
  Vérifiez que vous êtes dans l’onglet Bureau (il s’agit du premier onglet et affiche une image d’un moniteur), puis, sous Fournisseurs de plug-ins, sélectionnez Windows Mixed Reality.
La fenêtre MRTK Project Configurator s’affiche à nouveau. Cliquez sur le bouton Suivant , puis cliquez de nouveau sur Suivant . (Vous pouvez prendre un moment pour lire les explications sur ces pages avant de continuer.)
Sélectionnez Importer le Essentials TMP.
Sélectionnez Terminé. Cela ferme le Configurator.
Fermez la fenêtre Paramètres du projet , enregistrez votre projet, puis quittez Unity.

4. Mise à niveau vers Unity 2020.3 LTS

Installez la dernière version du correctif LTS d’Unity 2020.3.
Ouvrez votre projet Unity 2019 dans Unity 2020.3.

Vous verrez une boîte de dialogue vous demandant si vous souhaitez mettre à niveau votre projet vers une version plus récente d’Unity. Cliquez sur CONFIRMER.

Si vous utilisiez précédemment AR Foundation 2.0, le projet vous fera passer automatiquement à AR Foundation 4.0.

5. Utiliser l’outil de fonctionnalité Mixed Reality pour installer d’autres packages

Utilisez l’outil de fonctionnalité Mixed Reality pour importer les packages ci-dessous.

Ouvrez la liste déroulante Prise en charge de la plateforme et sélectionnez la dernière version de Mixed Reality plug-in OpenXR.
Une fois les packages chargés, une boîte de dialogue Avertissement s’affiche vous demandant si vous souhaitez redémarrer l’éditeur Unity afin d’activer les back-ends. Sélectionnez Oui.
Lors de la réouverture d’Unity, le configurateur de projet MRTK s’affiche. Prenez un moment pour lire les explications dans la fenêtre, puis sélectionnez Appliquer.
Une boîte de dialogue s’affiche indiquant qu’Unity doit être redémarré pour que le système d’entrée prenne effet. Sélectionnez Appliquer.

6. Configurer la gestion des plug-ins XR pour OpenXR

Une fois Unity rouvert, vous pouvez définir OpenXR comme runtime :

Dans la barre de menus, sélectionnez Modifier les>paramètres du projet.

Regardez dans la colonne de gauche et vérifiez que vous êtes sur la page Gestion du plug-in XR et dans l’onglet plateforme Windows universelle (il y a une image du logo Windows sous l’onglet).
Dans la liste Fournisseurs de plug-ins , sélectionnez OpenXR.
Dans la même section, sélectionnez Microsoft HoloLens groupe de fonctionnalités.
Notez qu’il existe désormais un triangle d’avertissement jaune en regard d’OpenXR. Placez le curseur sur le triangle, lisez le message dans la fenêtre contextuelle, puis sélectionnez le triangle.
Dans la fenêtre Validation de projet OpenXR , plusieurs problèmes sont répertoriés. Sélectionnez le bouton Corriger tout .
Un problème persiste et vous indique que vous devez ajouter au moins un profil d’interaction. Pour ce faire, cliquez sur Modifier. Cela vous permet d’accéder aux paramètres du plug-in OpenXR dans la fenêtre Paramètres du projet .
Sélectionnez le bouton signe plus (+) trois fois, chaque fois en choisissant un profil différent :

Profil d’interaction du regard

Profil d’interaction de la main Microsoft

Profil du contrôleur de mouvement Microsoft

Si le profil d’interaction du regard, ou tout autre profil, s’affiche avec un triangle jaune à côté, sélectionnez le triangle, puis dans la fenêtre Validation du projet OpenXR , cliquez sur le bouton Corriger .
Dans la section Groupes de fonctionnalités OpenXR, sélectionnez Microsoft HoloLens, puis sélectionnez Suivi de la main et modèle de contrôleur de mouvement s’ils ne sont pas déjà sélectionnés.
Cliquez sur la liste déroulante Mode d’envoi de profondeur , puis sélectionnez Profondeur 16 bits.
Fermez la fenêtre Paramètres du projet et toutes les autres fenêtres qui sont encore ouvertes.