Ajoutez le plug-in OpenXR Mixed Reality à votre projet Unity existant

Si vous avez un projet Unity déjà configuré pour OpenXR (vous disposez du plug-in Unity OpenXR installé et configuré) et que vous souhaitez ajouter la possibilité de cibler votre application pour le HoloLens 2, suivez les instructions ci-dessous.

Pour déterminer si votre projet a installé le plug-in OpenXR Mixed Reality :

  1. Dans Unity, dans la barre de menus, sélectionnez Modifier>Project Paramètres.

  2. Vérifiez que vous êtes sur la page XR Plug-in Management avec les paramètres de la plateforme Windows universelle (onglet de logo Windows) affichés.

  3. Si le groupe de fonctionnalités Microsoft Hololens est grisé ou n’existe pas, le plug-in OpenXR Mixed Reality n’est pas installé.

    Screenshot of XR Plug-in Management window.

Télécharger et installer l’outil de fonctionnalité Mixed Reality

Le plug-in OpenXR Mixed Reality est fourni sous la forme d’un package pour Unity. La meilleure façon de découvrir, mettre à jour et importer des packages de fonctionnalités consiste à utiliser l’outil de fonctionnalité Mixed Reality. 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 l’outil de fonctionnalité Mixed Reality à partir du Centre de téléchargement Microsoft.

  2. Une fois le téléchargement terminé, décompressez le fichier et enregistrez-le sur votre ordinateur.

    Remarque

    Avant de pouvoir exécuter le Mixed Reality Feature Tool, vous devez installer le runtime .NET 5.0

  3. Dans le dossier décompressé, accédez au fichier exécutable MixedRealityFeatureTool.exe puis utilisez-le pour lancer Mixed Reality Feature Tool.

    Screenshot of Opening MixedRealityFeatureTool.

Importer le plug-in OpenXR Mixed Reality

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

    Screenshot of the Mixed Reality Feature Tool opening screen.

  2. Sélectionnez le bouton Parcourir (il s’agit du bouton « trois points » dans l’image ci-dessous), puis accédez au dossier contenant votre projet Unity, puis ouvrez-le.

    Open your project

    Notes

    Ma zone Project Path de l’outil doit contenir une certaine valeur. Ainsi, une barre oblique inverse (« _ ») est présente par défaut.

    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 de six groupes de packages.

    The main groups of packages in the Mixed Reality Feature Tool

  5. Cliquez sur le bouton « + » à gauche de Platform Support (0 sur 5), puis sélectionnez la dernière version de Mixed Reality OpenXR Plugin.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Une fois vos sélections effectuées, cliquez sur Obtenir des fonctionnalités.

  7. 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 c’est le cas, cliquez sur OK.

  8. Sur 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 pour chacun de ces éléments pour en savoir plus.

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

  10. Sélectionnez Approuver.

  11. Revenez à l’éditeur Unity et cliquez sur une zone vide dans l’interface utilisateur. Vous verrez une barre de progression indiquant que le package est importé.

  12. Dans Unity, vérifiez que vous êtes dans la fenêtre Project Paramètres, dans la page Gestion des plug-ins XR, puis dans l’onglet plateforme Windows universelle.

  13. Il existe maintenant deux groupes de fonctionnalités sous OpenXR. Sélectionnez le premier, Microsoft HoloLens feature group.

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

Voir aussi