Exercice - Importer et configurer des ressources

  • 10 minutes

Installer Mixed Reality Feature Tool

Pour importer Mixed Reality Toolkit dans votre projet, nous allons utiliser Mixed Reality Feature Tool, qui permet aux développeurs de découvrir, de mettre à jour et d’importer des packages de fonctionnalités. Vous pouvez rechercher des packages par nom ou par catégorie, voir leurs dépendances et voir les changements proposés pour votre fichier manifeste de projets avant l’importation.

  1. Téléchargez la dernière version de Mixed Reality Feature Tool à partir du Centre de téléchargement Microsoft.

  2. Une fois le téléchargement terminé, ouvrez le fichier MixedRealityFeatureTool.exe et utilisez-le pour lancer Mixed Reality Feature Tool.

    Remarque

    Avant de pouvoir exécuter Mixed Reality Feature Tool, vous devrez peut-être installer le runtime .NET 6.0.

Importer le package de base MRTK Unity

  1. Dans Mixed Reality Feature Tool, sélectionnez Start.

    Screenshot of the Mixed Reality Feature Tool opening screen.

  2. Sélectionnez le bouton Parcourir (le bouton « trois points » dans l’image ci-dessous), accédez à votre projet, puis ouvrez-le.

    Screenshot of the Select Project screen.

    Une fois que vous avez sélectionné un dossier, l’outil vérifie qu’il s’agit d’un dossier de projet Unity valide.

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. Sélectionnez Discover Features.

    Remarque

    Vous devrez peut-être patienter quelques secondes, pendant que l’outil actualise les packages à partir des flux.

  4. Sur la page Découvrir des fonctionnalités, notez qu’il existe une liste des groupes de packages disponibles.

    Screenshot of the main groups of packages in the Mixed Reality Feature Tool.

  5. Sélectionnez le bouton + à gauche de Platform Support (0 of 5), puis sélectionnez la dernière version du Plug-in OpenXR Mixed Reality.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Sélectionnez le bouton Select All à droite de MRTK3 afin que toutes les fonctionnalités soient sélectionnées.

    Screenshot of selecting all feature of MRTK3.

    Remarque

    Si vous voyez des packages marqués comme dépréciés, vous devez les supprimer et vous assurer que l’option Settings > Feature > Show deprecated packages est désélectionnée.

  7. Une fois vos sélections effectuées, sélectionnez Obtenir des fonctionnalités.

  8. Sélectionnez Validate pour valider les packages sélectionnés. Vous devriez voir une boîte de dialogue indiquant qu’aucun problème de validation n’a été détecté. Lorsque vous le faites, sélectionnez OK.

  9. Sur la page Importer des fonctionnalités, dans la colonne de gauche, Fonctionnalités, les packages que vous avez sélectionnés sont affichés. La colonne de droite, Dépendances requises, affiche toutes les dépendances. Vous pouvez sélectionner le lien Détails pour chacun de ces éléments pour en savoir plus.

  10. Lorsque vous êtes prêt à continuer, sélectionnez Importer. Sur la page Examiner et approuver, vous pouvez consulter des informations sur les packages.

  11. Sélectionnez Approuver.

  12. Cliquez sur Quitter.

  13. Revenez à l’éditeur Unity et sélectionnez une zone vide dans l’interface utilisateur. Vous verrez une barre de progression indiquant que vos packages sont importés.

Configurer le projet Unity

  1. Une fois qu’Unity a importé les packages, un avertissement s’affiche pour vous demander si vous souhaitez activer les serveurs principaux en redémarrant l’éditeur. Cliquez sur Oui.

    Screenshot of Unity Restart Option.

  2. Unity vous posera des questions sur la mise à jour des méthodes dans XR InteractionLayerMask. Sélectionnez le bouton I Made a Backup, Go Ahead! et attendez le redémarrage de Unity.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Dans la barre de menus, sélectionnez Mixed Reality>Project>Apply recommended project settings for HoloLens.

  4. Dans la barre de menus, sélectionnez Edit>Project Settings.... Sélectionnez XR Plugin-in Management. Vérifiez que Initialize XR on Startup est sélectionné puis, sous Plugin Providers, sélectionnez Open XR.

    Screenshot of Initialize XR on Startup.

  5. Le plug-in OpenXR se charge, puis deux éléments s’affichent sous OpenXR. Sélectionnez le premier, Microsoft HoloLens feature group. Sélectionnez le point d’exclamation jaune.

    Screenshot of Open XR option.

  6. Sélectionnez Fix all.

    Screenshot of Fix All.

    Certains avertissements peuvent s’afficher. Ignorez-les pour l’instant.

  7. Sélectionnez OpenXR sous XR Plug-in Management.

  8. Sous Interaction Profiles, ajoutez Microsoft Hand Interaction et Eye Gaze Interaction Profile s’ils n’ont pas été ajoutés.

    Screenshot of Add Interaction Profiles.

  9. Vérifiez que Microsoft Hololens sur la gauche est sélectionné et que Hand Tracking, Mixed Reality Features et Motion Controller Model à droite sont sélectionnés.

  10. Sélectionnez le signe d’avertissement en regard de Eye Gaze Interaction Profile pour rétablir la Project Validation. Vérifiez que vous êtes sous l’onglet UWP platform (celui avec le logo Windows), puis cliquez sur Fix All pour résoudre les problèmes de validation. Notez que des problèmes peuvent subsister après un clic sur Fix All. Dans ce cas, sélectionnez à nouveau Fix All, ignorez tous les problèmes marqués Scene specific, puis lisez les recommandations pour les problèmes restants (le cas échéant) et apportez les modifications souhaitées.

  11. Sous Project Settings, sélectionnez MRTK3 et vérifiez s’il existe un profil valide. S’il n’y en a pas, recherchez MRTKProfile dans les packages du projet (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset), puis affectez-le au profil.

    Screenshot of MRTK profile.

Configurer les paramètres du projet

  1. Dans la barre de menu, sélectionnez Edit>Project Settings.

  2. Dans la colonne de gauche de la fenêtre Project Settings, sélectionnez Player.

  3. Notez que dans la fenêtre Player, le Product Name est « MRTK Tutorial ». Ce nom est tiré de votre nom de projet et sera le nom affiché dans le menu Démarrer de HoloLens.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    Conseil

    Pour faciliter la localisation de l’application pendant le développement, ajoutez un trait de soulignement devant le nom pour qu’il apparaisse au début d’une liste.

  4. Sélectionnez la liste déroulante Publishing Settings puis, dans le champ Package name, entrez un nom approprié, par exemple MRTK-Tutoriel-Bien-Démarrer :

    Screenshot of Unity Publishing Settings with the package name box filled in.

    Remarque

    Le nom de package est l’identificateur unique de l’application. Si vous souhaitez éviter le remplacement des versions précédemment installées de l’application avec le même nom, vous devez modifier cet identificateur avant de déployer l’application.

  5. Fermez la fenêtre Paramètres du projet.

Créer la scène et configurer MRTK

  1. Dans la barre de menus, sélectionnez Fichier>Nouvelle scène. Sélectionnez l’option Basic (Built-in), puis Create.

  2. Dans la fenêtre Projet, accédez au dossier Préfabriqués dans Packages, Entrée MRTK et Ressources. Faites glisser l’élément prédéfini MRTK XR Rig dans la hiérarchie de la scène.

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. Supprimez le GameObject Caméra principale, car le GameObject MRTK XR Rig contient déjà une caméra.

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  4. Ajoutez l’élément prédéfini Simulateur d’entrée MRTK (Packages, Entrée MRTKSimulation, Préfabriqués) à votre scène.

    Remarque

    Cette étape est facultative, mais requise par les simulations dans l’éditeur.

    Screenshot of the input simulator.

  5. Dans la barre de menus, sélectionnez Fichier>Enregistrer sous....

  6. Accédez au dossier Assets>Scenes, nommez votre projet, puis enregistrez ce dernier.