Exercice - Importer et configurer des ressources

  • 10 minutes

Installer l'outil de fonctionnalités de réalité mixte

Pour importer le Mixed Reality Toolkit dans votre projet, vous utiliserez le Mixed Reality Feature Tool. L’outil permet aux développeurs de découvrir, mettre à jour et 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 exécutable 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.

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

  2. Sélectionnez le bouton Parcourir (il s’agit du bouton ... dans l’image suivante), accédez à votre projet et ouvrez-le.

    Ouvrir votre 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 attendre quelques secondes pendant que l’outil actualise les packages à partir des flux.

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

    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. Lorsque vous voyez une boîte de dialogue indiquant qu’aucun problème de validation n’a été détecté. Cliquez sur 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, puis quitter.

  12. 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 peut vous demander de mettre à jour des méthodes dans XR InteractionLayerMask. Sélectionnez le bouton I Made a Backup, Go Ahead !, puis attendez que Unity redémarre.

    Capture d'écran de la mise à jour des méthodes dans XR InteractionLayerMask.

  3. Dans la barre de menu, sélectionnez Modifier>Paramètres du projet. Sélectionnez Gestion du plug-in XR. Vérifiez que l’initialisation de XR au démarrage est sélectionnée, puis cochez la case Pour Ouvrir XR sous Fournisseurs de plug-ins.

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

  4. Le plug-in OpenXR se charge et deux éléments apparaissent sous OpenXR. Cochez la case pour le premier groupe de fonctionnalités Microsoft HoloLens. Sélectionnez le point d’exclamation jaune.

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

  5. Sélectionnez Fix all.

    Capture d’écran de Fix All.

    Certains avertissements peuvent rester. Ignorez-les pour l’instant.

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

  7. Sous profils d’interaction, sélectionnez +, puis ajoutez Microsoft Hand Interaction Profile et Eye Gaze Interaction Profile s’ils ne sont pas déjà ajoutés.

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

  8. Assurez-vous que Microsoft Hololens à gauche est sélectionné et que le suivi des mains, les fonctionnalités de réalité mixte et le modèle de contrôleur de mouvement à droite sont sélectionnés.

  9. Sélectionnez la marque d’exclamation jaune à côté du profil d’interaction du regard pour ramener la fenêtre Validation du projet. Vérifiez que vous êtes sous l’onglet plateforme UWP (l’onglet affiche le logo Windows), puis sélectionnez Résoudre tous les problèmes de validation. Notez que certains problèmes peuvent rester. Dans ce cas, sélectionnez Corriger tout , ignorez les problèmes marqués spécifiques à la scène, puis lisez les recommandations relatives aux problèmes restants (le cas échéant) et apportez les modifications souhaitées.

  10. Dans la fenêtre Paramètres du projet , sélectionnez MRTK3 et vérifiez s’il existe un profil valide. Si ce n’est pas le cas, recherchez MRTKProfile dans les packages du projet (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) et 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 fenêtre Paramètres du projet , sélectionnez Lecteur.

  3. Notez que dans la fenêtre Lecteur , le nom du produit est le didacticiel MRTK. Ce nom provient du nom de votre projet et sera le nom affiché dans le menu de démarrage de HoloLens.

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

    Conseil / Astuce

    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 Paramètres de publication , puis dans le champ Nom du package , entrez un nom approprié ; par exemple , MRTK-Tutorials-Getting-Started :

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

    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 De base (intégrée), puis sélectionnez Créer.

  2. Dans la fenêtre Projet, accédez au dossier Packages>>>Prefabs. 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 l’objet de jeu Main Camera , car l’objet de jeu MRTK XR Rig contient déjà une caméra.

    Capture d’écran du Mixed Reality Toolkit dans l’Inspecteur.

  4. Ajoutez l’élément prédéfini Simulateur d’entrée MRTK (Packages, >Simulation, >) à votre scène.

    Remarque

    Cette étape est facultative, mais requise par 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 , puis nommez et enregistrez votre projet.