Bienvenue dans Mixed Reality Feature ToolWelcome to the Mixed Reality Feature Tool

Image de la bannière de Mixed Reality Feature Tool

Important

Pour le moment, Mixed Reality Feature Tool est disponible seulement pour Unity.The Mixed Reality Feature Tool is only available for Unity at the moment. Si vous développez dans Unreal, reportez-vous à la documentation sur l’installation des outils.If you're developing in Unreal, refer to the tools installation documentation.

Mixed Reality Feature Tool est un nouveau moyen pour les développeurs de découvrir, de mettre à jour et d’ajouter des packages de fonctionnalités de réalité mixte dans des projets Unity.The Mixed Reality Feature Tool is a new way for developers to discover, update, and add Mixed Reality feature packages into Unity projects. Vous pouvez rechercher des packages par nom ou par catégorie, voir leurs dépendances et même voir les changements proposés pour votre fichier manifeste de projets avant l’importation.You can search packages by name or category, see their dependencies, and even view proposed changes to your projects manifest file before importing. Si vous n’avez peut-être jamais travaillé avec un fichier manifeste auparavant, sachez qu’il s’agit d’un fichier JSON contenant tous vos packages de projet.If you've never worked with a manifest file before, it's a JSON file containing all your projects packages. Une fois que vous avez validé les packages souhaités, Mixed Reality Feature Tool les télécharge dans le projet de votre choix.Once you've validated the packages you want, the Mixed Reality Feature tool will download them into the project of your choice.

Configuration requiseSystem requirements

Pour pouvoir exécuter Mixed Reality Feature Tool, voici ce dont vous avez besoin :Before you can run the Mixed Reality Feature Tool, you'll need:

Notes

Mixed Reality Feature Tool fonctionne actuellement seulement sur Windows, mais la prise en charge de MacOS sera bientôt disponible !The Mixed Reality Feature Tool currently only runs on Windows, but MacOS support is coming soon!

TéléchargementDownload

Une fois que votre environnement est configuré :Once you have your environment set up:

1. Mise en route1. Getting started

Lancez Mixed Reality Feature Tool à partir du fichier exécutable, qui affiche la page de démarrage lors du premier lancement :Launch the Mixed Reality Feature Tool from the executable file, which displays the start page on first launch:

Mise en route

Dans la page de démarrage, vous pouvez :From the start page, you can:

  • Configurer les paramètres de l’outil en utilisant le bouton avec l’icône d’engrenageConfigure tool settings using the gear icon button
  • Utiliser le bouton avec le point d’interrogation pour lancer le navigateur web par défaut et afficher notre documentationUse the question mark button to launch the default web browser and display our documentation
  • Sélectionner Start pour commencer la découverte des packages de fonctionnalitésSelect Start to begin discovering feature packages

2. Découverte et acquisition de packages de fonctionnalités2. Discovering and acquiring feature packages

Le catalogue des packages de fonctionnalités est récupéré dès que vous appuyez sur Start.The feature package catalog is retrieved as soon as you press Start. Les fonctionnalités sont regroupées par catégorie pour faciliter les recherches.Features are grouped by category to make things easier to find. Par exemple, la catégorie Mixed Reality Toolkit vous permet de choisir parmi plusieurs fonctionnalités :For example, the Mixed Reality Toolkit category has several features for you to choose from:

Découverte et acquisition

Une fois que vous avez effectué vos choix, sélectionnez Get features pour récupérer tous les packages nécessaires auprès du catalogue.Once you've made your choices, select Get features to fetch all the required packages from the catalog. Pour plus d’informations, consultez Découverte et acquisition des fonctionnalités.For more information, please see discovering and acquiring features.

3. Importation de packages de fonctionnalités3. Importing feature packages

Après l’acquisition, l’ensemble complet des packages est présenté ainsi qu’une liste des dépendances requises.Following acquisition, the complete set of packages is presented, along with a list of required dependencies. Si vous avez besoin de modifier des sélections de fonctionnalités ou de packages, c’est le moment :If you need to change any feature or package selections, this is the time:

Importation de packages

Nous vous recommandons vivement d’utiliser le bouton Validate pour vérifier que le projet Unity peut importer correctement les fonctionnalités sélectionnées.We highly recommend using the Validate button to ensure the Unity project can successfully import the selected features. Après la validation, vous voyez une boîte de dialogue contextuelle avec un message indiquant la réussite ou bien une liste des problèmes identifiés.After validation, you'll see a pop-up dialog with a success message or a list of identified issues.

Vous devez également définir l’emplacement du projet Unity cible avant d’importer.You also need to set the location of the target Unity project before you import. Utilisez le bouton avec les points de suspension à gauche du champ du chemin du projet pour le désigner.Use the ellipsis button to the left of the project path field to browse. Quand vous avez fini de naviguer dans votre système de fichiers, ouvrez le dossier contenant votre projet Unity cible.When you're done navigating your file system, open the folder containing your target Unity project.

Notes

La boîte de dialogue qui s’affiche quand vous recherchez le dossier du projet Unity contient « _ » comme nom de fichier.The dialog that's displayed when browsing for the Unity project folder contains '_' as the file name. Une valeur doit être présente pour le nom de fichier pour permettre la sélection du dossier.There must be a value for the file name to enable the folder to be selected.

Sélectionnez Import pour continuer.Select Import to continue.

Notes

Une fois que vous avez cliqué sur le bouton Import, si des problèmes subsistent, vous voyez un simple message.After clicking the Import button, if any issues remain a simple message will be displayed. La recommandation est de cliquer sur No et d’utiliser le bouton Validate pour visualiser et résoudre les problèmes.The recommendation is to click No and to use the Validate button to view and resolve the issues.

Pour plus d’informations, consultez Importation des fonctionnalités.For more information, please see importing features.

4. Examen et approbation des modifications du projet4. Reviewing and approving project changes

La dernière étape consiste à examiner et à approuver les modifications proposées dans le manifeste et les fichiers de projet :The final step is reviewing and approving the proposed changes to the manifest and project files:

  • Les modifications proposées pour le manifeste s’affichent à gauche.The proposed changes to the manifest are displayed on the left
  • Les fichiers à ajouter au projet sont listés à droite.The files to be added to the project are listed to the right
  • Le bouton Compare permet l’affichage côte à côte du manifeste actuel et des modifications proposées.The Compare button allows for side by side viewing of the current manifest and the proposed changes

Autorisation

Pour plus d’informations, consultez Examen et approbation des modifications du projet.For more information, see reviewing and approving project modifications.

5. Projet mis à jour5. Project updated

Quand les modifications proposées sont approuvées, votre projet Unity cible est mis à jour de façon à référencer les fonctionnalités de réalité mixte sélectionnées :When the proposed changes are approved, your target Unity project is updated to reference the selected Mixed Reality features:

Projet mis à jour

Le dossier Packages du projet Unity contient maintenant un sous-dossier MixedReality avec le ou les fichiers de package de fonctionnalités, et le manifeste contient la ou les références appropriées.The Unity project's Packages folder now has a MixedReality subfolder with the feature package file(s) and the manifest will contain the appropriate reference(s).

Revenez à Unity, attendez que les nouvelles fonctionnalités sélectionnées se chargent, puis commencez à créer !Return to Unity, wait for the new selected features to load, and start building!

Voir aussiSee also