Partager via

Configurer un nouveau projet OpenXR avec MRTK

Le moyen le plus simple de configurer votre projet Unity pour la réalité mixte consiste à utiliser le Mixed Reality Toolkit (MRTK). MRTK pour Unity est un kit de développement multiplateforme open source conçu pour faciliter la création d’applications de réalité mixte étonnantes.

Infographie montrant certaines des fonctionnalités du Mixed Reality Toolkit.

MRTK fournit un système d’entrée multiplateforme, des composants fondamentaux et des blocs de construction communs pour les interactions spatiales. Il peut vous aider à accélérer le développement de votre application pour Microsoft HoloLens, Windows Mixed Reality casques immersifs (VR) et de nombreux autres appareils VR/AR. Le projet vise à réduire les obstacles à l’entrée, permettant à tout le monde de créer des applications de réalité mixte et de contribuer à la communauté à mesure que nous grandissons tous.

MRTK prend en charge un large éventail de plateformes, notamment :

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • casques Windows Mixed Reality

  • Casques OpenVR (HTC Vive / Oculus Rift)

  • Suivi de la main Ultraleap

  • Appareils Android et iOS

Remarque

Vous pouvez également configurer un nouveau projet OpenXR sans MRTK.

Autres options de configuration non-OpenXR à prendre en compte

Windows XR : Microsoft ne recommande pas d’utiliser le plug-in Windows XR pour les nouveaux projets dans Unity 2020. Au lieu de cela, vous devez utiliser le plug-in OpenXR Mixed Reality. Toutefois, si vous utilisez Unity 2019 et que vous avez besoin d’AR Foundation 2.0 pour la compatibilité avec les appareils ARCore/ARKit, ce plug-in permet cette prise en charge.

XR hérité :

Si vous utilisez toujours Unity 2019 ou une version antérieure, Microsoft recommande d’utiliser la prise en charge XR intégrée héritée.

Si vous démarrez un nouveau projet, nous vous recommandons d’installer Unity 2020 à la place et d’utiliser le plug-in Mixed Reality OpenXR.

Prise en main d’OpenXR : Créer un projet Unity

  1. Lancez Unity Hub.

  2. Sous l’onglet Projets , cliquez sur Nouveau projet.

    Capture d’écran d’Unity Hub dans l’onglet Projets avec le bouton Nouveau projet mis en évidence.

  3. Cliquez sur la liste déroulante sous Nouveau projet, puis sélectionnez la version Rédacteur souhaitée.

    Capture d’écran d’Unity Hub avec la liste déroulante Rédacteur version affichée.

  4. Vérifiez que le modèle choisi est 3D Core.

  5. Dans la zone Nom du projet, entrez un nom pour votre projet, par exemple, « Didacticiel MRTK ».

  6. Dans la zone Emplacement , cliquez sur l’icône de dossier, puis accédez au dossier dans lequel vous souhaitez enregistrer votre projet et sélectionnez-le. Vous pouvez également créer un dossier.

    Capture d’écran d’Unity Hub avec 3D, Nom du projet, Emplacement et Créer mis en évidence.

  7. Cliquez sur Créer un projet. Cela ouvre votre projet dans Unity.

    Capture d’écran de votre projet ouvert dans Unity.

Attention

Lorsque vous travaillez sur Windows, il existe une limite de MAX_PATH de 255 caractères. Unity est affecté par ces limites et peut ne pas être compilé si un chemin d’accès de fichier dépasse 255 caractères. Par conséquent, nous vous recommandons de stocker votre projet Unity le plus près possible de la racine du lecteur.

Définir votre cible de build

  1. Dans la barre de menus, sélectionnezParamètres de build de fichier>....

    Pour générer une application pour Windows Mixed Reality, vous devez choisir une cible de build. Les paramètres de build pour plateforme Windows universelle (UWP) ciblent n’importe quel appareil, y compris les casques immersifs comme hp Reverb G2. Il s’agit du meilleur choix si vous créez pour le HoloLens 2. Toutefois, si vous ciblez la réalité virtuelle de bureau, nous vous recommandons d’utiliser la plateforme autonome PC, Mac & Linux.

  2. Effectuez l’une des opérations suivantes :

    Si vous ciblez Desktop VR :

    • Conservez la plateforme autonome PC, Mac & Linux , qui est sélectionnée par défaut sur un nouveau projet Unity :

    Capture d’écran de la fenêtre Paramètres de build ouverte dans l’éditeur unity avec PC, Mac & plateforme autonome mise en évidence

    Si vous ciblez le HoloLens 2 :

    • Sous Plateforme, sélectionnez plateforme Windows universelle. Vérifiez que les paramètres suivants sont actifs :

    Type de build : Projet D3D

    Version du Kit de développement logiciel (SDK) cible : Dernière version installée

    Version minimale de la plateforme : 10.0.10240.0

    Version de Visual Studio : Dernière version installée

    Capture d’écran de la fenêtre Paramètres de build ouverte dans l’éditeur unity avec plateforme Windows universelle en surbrillance.

  3. Cliquez sur le bouton Changer de plateforme . Unity affiche une barre de progression pendant qu’il change de plateforme.

  4. Une fois le processus de changement de plateforme terminé, fermez la fenêtre Paramètres de build.

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

Le plug-in OpenXR Mixed Reality se présente 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 afficher les modifications proposées dans le fichier manifeste de votre projet 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é, accédez au fichier exécutable MixedRealityFeatureTool.exe, puis utilisez-le pour lancer l’outil de fonctionnalité Mixed Reality.

    Capture d’écran de l’ouverture de MixedRealityFeatureTool.

Importer les packages Mixed Reality Toolkit et OpenXR

  1. Dans l’outil fonctionnalité Mixed Reality, sélectionnez Démarrer.

    Capture d’écran de l’écran d’ouverture de l’outil feature Mixed Reality.

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

    Ouvrir votre projet

    Remarque

    La zone Chemin d’accès du projet dans l’outil doit contenir une valeur, de sorte qu’elle insère une barre oblique inverse (« _ ») 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.

    Capture d’écran de l’écran Mixed Reality feature Tool Project Path.

  3. Sélectionnez Découvrir les fonctionnalités.

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

    Groupes main de packages dans l’outil de fonctionnalité Mixed Reality

  5. Cliquez sur le bouton « + » à gauche de Mixed Reality Toolkit (0 sur 10), puis sélectionnez la dernière version de Mixed Reality Toolkit Foundation.

    Remarque

    Le package Mixed Reality Toolkit Foundation est le seul package qui doit être importé et configuré pour pouvoir utiliser MRTK avec votre projet. Ce package inclut les composants principaux requis pour créer une application de réalité mixte.

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

    Capture d’écran des sélections de package dans l’outil feature Mixed Reality.

  7. Une fois que vous avez effectué vos sélections, cliquez sur Obtenir des fonctionnalités.

  8. Sélectionnez Valider pour valider les packages que vous avez sélectionnés. Vous devriez voir une boîte de dialogue indiquant Aucun problème de validation n’a été détecté. Dans ce cas, cliquez sur OK.

  9. Dans 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 de l’un de ces éléments pour en savoir plus à leur sujet.

  10. Lorsque vous êtes prêt à passer à autre chose, sélectionnez Importer. Dans la page Vérifier et approuver , vous pouvez consulter des informations sur les packages.

  11. Sélectionnez Approuver.

  12. Revenez à unity Rédacteur et cliquez sur une zone vide dans l’interface utilisateur. Vous verrez une barre de progression vous indiquant que vos packages sont en cours d’importation.

Configurer les paramètres back-end d’entrée

  1. Une fois que Unity a importé le package, un avertissement s’affiche pour vous demander si vous souhaitez activer les back-ends en redémarrant l’éditeur. Sélectionnez Oui.

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

Configurer le projet pour le HoloLens 2 via la validation de projet (MR OpenXR 1.6+)

Si vous développez pour la réalité virtuelle de bureau, ignorez cette section et accédez à Configurer le projet pour la réalité virtuelle de bureau.

  1. Dans la barre de menus, cliquez sur Mixed Reality > Paramètres > de validation de projet HoloLens 2 Application (UWP) pour activer les règles de validation pour HoloLens 2. Pour les plug-ins MR OpenXR antérieurs à la version 1.9, l’élément de menu disponible est Mixed Reality > Paramètres > de projet recommandés project Apply pour HoloLens 2.
  2. Dans la fenêtre de validation du projet qui s’affiche, vérifiez que vous êtes sur l’onglet Plateforme UWP (indiqué par le logo Windows), puis cliquez sur Corriger tout pour résoudre les problèmes de validation. Notez que des problèmes peuvent subsister après avoir cliqué sur Corriger tout. Dans ce cas, essayez de cliquer à nouveau sur Corriger tout, ignorez tous les problèmes marqués comme « spécifiques à la scène » (le cas échéant), puis passez en revue les autres problèmes (le cas échéant) pour voir s’il y a des suggestions de modifications que vous souhaitez apporter.
  3. Le projet est presque prêt pour HoloLens 2 déploiement à ce stade. Passez à Configurer les paramètres du lecteur pour l’étape suivante.

Configurer manuellement le projet pour le HoloLens 2

Si vous développez pour la réalité virtuelle de bureau, ignorez cette section et accédez à Configurer le projet pour la réalité virtuelle de bureau.

  1. Vérifiez que la fenêtre Paramètres du projet est ouverte. Si ce n’est pas le cas, dans la barre de menus, sélectionnez Modifier les>paramètres du projet.

  2. Dans la fenêtre Paramètres du projet, vérifiez que vous êtes sur la page Gestion du plug-in XR et dans l’onglet plateforme Windows universelle.

    Capture d’écran de la fenêtre Paramètres du projet ouverte sur la page gestion du plug-in XR et plateforme Windows universelle onglet.

  3. Vérifiez que l’option Initialiser XR au démarrage est sélectionnée, puis, sous Fournisseurs de plug-in, cliquez sur OpenXR.

    Capture d’écran de la fenêtre Paramètres du projet, dans le plateforme Windows universelle, avec l’option Initialiser XR au démarrage sélectionnée et le plug-in OpenXR mis en évidence.

  4. Le plug-in OpenXR se charge, puis plusieurs éléments apparaissent sous OpenXR. Sélectionnez Microsoft HoloLens groupe de fonctionnalités.

    Capture d’écran de la fenêtre Paramètres du projet avec le plug-in OpenXR et le groupe de fonctionnalités Microsoft HoloLens mis en évidence.

Notez qu’il existe un triangle d’avertissement jaune en regard d’OpenXR. Cela indique que vous avez des paramètres incompatibles qui doivent être résolus. Pour savoir comment résoudre ce problème, ignorez la section suivante sur la configuration de la réalité virtuelle et passez à la section suivante, Résolution des paramètres incompatibles.

Configurer le projet pour la réalité virtuelle de bureau via la validation de projet (MR OpenXR 1.9+)

  1. Dans la barre de menus, cliquez sur Mixed Reality > Paramètres > de validation de projet Application Win32 (autonome) pour activer les règles de validation pour une application XR de bureau.
  2. Dans la fenêtre de validation du projet qui s’affiche, vérifiez que vous êtes sous l’onglet Plateforme autonome, puis cliquez sur Corriger tout pour résoudre les problèmes de validation. Notez que des problèmes peuvent subsister après avoir cliqué sur Corriger tout. Dans ce cas, essayez de cliquer à nouveau sur Corriger tout, ignorez tous les problèmes marqués comme « spécifiques à la scène » (le cas échéant), puis passez en revue les autres problèmes (le cas échéant) pour voir s’il y a des suggestions de modifications que vous souhaitez apporter.

Configurer manuellement le projet pour la réalité virtuelle de bureau

  1. Vérifiez que la fenêtre Paramètres du projet est ouverte. Si ce n’est pas le cas, accédez à la barre de menus, puis sélectionnez Modifier les>paramètres du projet.

  2. Dans la fenêtre Paramètres du projet , vérifiez que vous êtes sur la page Gestion du plug-in XR et dans l’onglet PC, Mac & Linux autonome .

    Capture d’écran de la fenêtre Paramètres du projet ouverte sur la page gestion du plug-in XR et l’onglet autonome PC, Mac & Linux.

  3. Vérifiez que l’option Initialiser XR au démarrage est sélectionnée, puis, sous Fournisseurs de plug-in, cliquez sur OpenXR.

    Capture d’écran de la fenêtre Paramètres du projet, dans l’onglet PC, Mac & Linux autonome, avec l’option Initialiser XR au démarrage sélectionnée et le plug-in OpenXR mis en évidence.

  4. Le plug-in OpenXR se charge, puis deux éléments apparaissent sous OpenXR. Sélectionnez le premier, Windows Mixed Reality groupe de fonctionnalités.

    Capture d’écran de la fenêtre Paramètres du projet avec le plug-in OpenXR et Windows Mixed Reality groupe de fonctionnalités mis en évidence.

Notez qu’il existe désormais un triangle d’avertissement jaune en regard d’OpenXR. Cela indique que vous avez des paramètres incompatibles qui doivent être résolus. Pour savoir comment résoudre ce problème, passez à la section suivante, Résolution des paramètres incompatibles.

Résolution des paramètres incompatibles

Importante

Les images de cette section affichent les options sous l’onglet plateforme Windows universelle. Toutefois, les instructions sont les mêmes pour l’onglet Desktop VR, sauf indication contraire.

  1. Placez le curseur sur le triangle d’avertissement jaune en regard d’OpenXR, lisez le message dans la fenêtre contextuelle, puis sélectionnez le triangle.

    Capture d’écran de l’avertissement concernant les paramètres incompatibles.

  2. Dans la fenêtre Validation de projet OpenXR , plusieurs problèmes sont répertoriés. Sélectionnez le bouton Corriger tout . REMARQUE : cette liste peut être différente selon l’onglet dans lequel vous vous trouvez.

    Capture d’écran du bouton Corriger tout dans la fenêtre Validation de projet OpenXR.

  3. Un problème persiste et vous indique que vous devez ajouter au moins un profil d’interaction. Pour ce faire, cliquez sur Modifier. Vous accédez ainsi aux paramètres du plug-in OpenXR dans la fenêtre Paramètres du projet .

    Capture d’écran de la fenêtre Paramètres du projet avec les paramètres OpenXR affichés.

  4. Sous Profils d’interaction, notez le bouton signe plus (+).

    Capture d’écran du bouton Ajouter un profil d’interaction.

  5. Cliquez sur le bouton trois fois, chaque fois en choisissant un profil différent :

    Profil d’interaction du regard

    Profil d’interaction de la main Microsoft

    Profil du contrôleur de mouvement Microsoft

    Capture d’écran des profils d’interaction à ajouter.

    Si le profil d’interaction du regard, ou tout autre profil, s’affiche avec un triangle jaune à côté, sélectionnez le triangle, puis dans la fenêtre Validation du projet OpenXR , cliquez sur le bouton Corriger . Lorsque vous avez terminé, fermez la fenêtre Validation de projet OpenXR .

    Capture d’écran du bouton Corriger pour le profil d’interaction du regard.

  6. Dans la fenêtre Paramètres du projet , sous Groupes de fonctionnalités OpenXR, vérifiez que les éléments suivants sont sélectionnés :

    Si vous êtes dans l’onglet Desktop VR :

    Windows Mixed Reality

    Suivi de la main

    Modèle de contrôleur de mouvement

    Capture d’écran des groupes de fonctionnalités OpenXR pour l’onglet Desktop VR.

    Si vous êtes dans l’onglet plateforme Windows universelle :

    Microsoft HoloLens

    Suivi de la main

    Modèle de contrôleur de mouvement

    Capture d’écran des fonctionnalités sélectionnées pour OpenXR.

  7. Cliquez sur la liste déroulante Mode d’envoi de profondeur , puis sélectionnez Profondeur 16 bits.

    Capture d’écran de profondeur 16 bits sélectionné pour le mode d’envoi de profondeur.

    Conseil

    La réduction du format profondeur à 16 bits est facultative, mais elle peut améliorer les performances graphiques de votre projet. Pour plus d’informations, consultez Partage de mémoire tampon de profondeur (HoloLens).

    Remarque

    Le paramètre Mode rendu , situé juste au-dessus du mode d’envoi de profondeur, est défini par défaut sur Instance à passe unique. Dans les applications de réalité mixte, la scène est rendue deux fois : une fois pour chaque œil. Le résultat est la « vision stéréoscopique ». Cela double la quantité de calcul nécessaire. Il est donc important de sélectionner le chemin de rendu le plus efficace dans Unity pour économiser le temps processeur et GPU. Le rendu d’instance à passe unique est le meilleur choix ici : nous vous recommandons de l’activer par défaut pour chaque projet. Pour en savoir plus à ce sujet, consultez la documentation Unity.

Configurer les paramètres du lecteur

  1. Dans la colonne de gauche de la fenêtre Paramètres du projet , sélectionnez Lecteur.

  2. Notez que dans la fenêtre Lecteur , la zone Nom du produit est déjà renseignée. Il s’agit du nom de votre projet et du nom affiché dans le menu Démarrer d’HoloLens.

    Capture d’écran des paramètres de publication Unity avec la zone Nom du projet renseignée.

    Conseil

    Pour faciliter la localisation de l’application pendant le développement, ajoutez un trait de soulignement devant le nom pour la trier en haut de n’importe quelle liste.

  3. Cliquez sur la liste déroulante Paramètres de publication, puis dans le champ Nom du package , entrez un nom approprié.

    Capture d’écran des paramètres de publication Unity avec la zone nom du package renseignée.

    Remarque

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

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

Vous êtes maintenant prêt à commencer à développer avec OpenXR dans Unity !

Exemples de projets Unity

Consultez le référentiel d’exemples d’Mixed Reality OpenXR pour des exemples de projets Unity montrant comment créer des applications Unity pour des casques HoloLens 2 ou Mixed Reality à l’aide du plug-in OpenXR Mixed Reality.

Voir aussi