Exercice - Importer et configurer des ressources

  • 10 minutes

Installer Mixed Reality Feature Tool

Pour importer le Mixed Reality Toolkit dans votre projet, vous utiliserez le Mixed Reality Feature Tool. L’outil Mixed Reality Feature Tool 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, puis utilisez-le pour lancer l’outil 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.

    Capture de l’écran d’ouverture de Mixed Reality Feature Tool.

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

    Capture d’écran de l’écran de sélection de projet.

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

    Capture de l’écran du chemin de projet dans Mixed Reality Feature Tool.

  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.

    Capture d’écran des principaux groupes de packages dans 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.

    Capture d’écran des sélections de packages dans Mixed Reality Feature Tool.

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

    Capture d'écran de la sélection de toutes les fonctionnalités de 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. Sélectionnez Oui.

    Capture d’écran de l’option de redémarrage de Unity

  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.

    Capture d'écran de la mise à jour des méthodes dans 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.

    Capture d'écran d’Initialiser XR au démarrage.

  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.

    Capture d'écran de l’option Open XR.

  6. Sélectionnez Fix all.

    Capture d'écran de Tout corriger.

    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.

    Capture d'écran de l’option Ajouter des profils d’interaction.

  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.

    Capture d’écran du profil MRTK.

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.

    Capture d’écran de Publishing Settings dans Unity avec la zone Project Name renseignée.

    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 :

    Capture d’écran de Publishing Settings dans Unity avec la zone Package Name renseignée.

    Notes

    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.

    Capture d'écran de l’ajout de MRTK XR Rig dans l’inspecteur.

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

    Capture d’écran de Mixed Reality Toolkit dans l’inspecteur.

  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 elle est obligatoire pour les simulations dans l’éditeur.

    Capture d'écran du simulateur d’entrée.

  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.