Partager via

Configurer un nouveau projet OpenXR sans MRTK

  • Article

Bien que Microsoft et la communauté aient créé des outils code source ouvert tels que mixed Reality Toolkit (MRTK) qui configurent automatiquement votre environnement pour la réalité mixte, certains développeurs peuvent souhaiter créer leurs expériences à partir du terrain.

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 Mixed Reality OpenXR. 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 êtes toujours sur Unity 2019 ou 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 Projects, cliquez sur New project.

    Capture d’écran d’Unity Hub sous l’onglet Projects avec le bouton New Project mis en évidence.

  3. Cliquez sur la liste déroulante sous New Project, puis sélectionnez la version d’éditeur de votre choix.

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

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

  5. Dans la zone Project name, entrez un nom pour votre projet, par exemple, « MRTK Tutorial ».

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

    Capture d’écran d’Unity Hub avec 3D, Project Name, Location et Create mis en évidence.

  7. Cliquez sur Create Project (Créer le projet). Votre projet s’ouvre dans Unity.

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

Attention

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

Définir votre cible de build

  1. Dans la barre de menus, sélectionnez Fichier>Paramètres de build....

    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 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 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 la plateforme PC, Mac &Autonome mise en surbrillance

    Si vous ciblez HoloLens 2 :

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

    Build Type : D3D Project

    Target SDK Version : Latest Installed

    Minimum Platform Version : 10.0.10240.0

    Visual Studio Version : Latest installed

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

  3. Cliquez sur le bouton Switch Platform. Unity affiche une barre de progression pendant le changement de plateforme.

  4. Une fois le processus de changement de plateforme terminé, fermez la fenêtre Build Settings.

Télécharger et installer Mixed Reality Feature Tool

Le plug-in Mixed Reality OpenXR 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 mixed reality Feature Tool. 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é, accédez au fichier exécutable MixedRealityFeatureTool.exe , puis utilisez-le pour lancer Mixed Reality Feature Tool.

    Capture d’écran de l’ouverture de MixedRealityFeatureTool

Importer le plug-in Mixed Reality OpenXR

  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 « trois points » dans l’image ci-dessous), puis accédez au dossier contenant votre projet Unity, puis ouvrez-le.

    Ouvrir votre projet

    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.

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

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

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

Configurer les paramètres du 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 de Unity

Configurer le projet pour 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 > Project Validation Settings > HoloLens 2 Application (UWP) pour activer les règles de validation pour HoloLens 2. Pour les plug-ins MR OpenXR avant la version 1.9, l’élément de menu disponible est Mixed Reality > Project > Apply recommandé des paramètres de projet pour HoloLens 2.
  2. Dans la fenêtre de validation du projet qui s’affiche, vérifiez que vous êtes sous l’onglet plateforme UWP (indiqué par le logo Windows), puis cliquez sur Résoudre tous les problèmes de validation. Notez qu’il peut y avoir des problèmes qui restent après avoir cliqué sur Corriger tout. Dans ce cas, essayez de cliquer à nouveau sur Corriger tout , ignorez les problèmes marqués « spécifiques à la scène » (le cas échéant) et passez au reste des problèmes (le cas échéant) pour voir s’il existe des modifications suggérées que vous souhaitez apporter.
  3. Le projet est presque prêt pour le déploiement d’HoloLens 2 à ce stade. Passez à l’étape suivante pour configurer les paramètres du lecteur.

Configurer le projet pour HoloLens 2 manuellement

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 des plug-ins XR et sous l’onglet plateforme Windows universelle.

    Capture d’écran de la fenêtre Project Settings ouverte sur la page XR Plugin Management et l’onglet de la plateforme Windows universelle.

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

    Capture d’écran de la fenêtre Paramètres du projet, à l’intérieur du plateforme Windows universelle, avec initialiser XR au démarrage sélectionné et le plug-in OpenXR mis en surbrillance.

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

    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 surbrillance.

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 vr 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 > Project Validation Settings > Win32 Application (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 Résoudre tous les problèmes de validation. Notez qu’il peut y avoir des problèmes qui restent après avoir cliqué sur Corriger tout. Dans ce cas, essayez de cliquer à nouveau sur Corriger tout , ignorez les problèmes marqués « spécifiques à la scène » (le cas échéant) et passez au reste des problèmes (le cas échéant) pour voir s’il existe des modifications suggérées que vous souhaitez apporter.

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

  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, 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 des plug-ins XR et dans l’onglet Pc, Mac et Linux Autonome .

    Capture d’écran de la fenêtre Paramètres du projet ouverte à l’onglet Gestion des plug-ins XR et PC, Mac &Linux Autonome.

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

    Capture d’écran de la fenêtre Paramètres du projet, à l’intérieur de l’onglet PC, Mac &Linux autonome, avec initialiser XR au démarrage sélectionné et le plug-in OpenXR mis en surbrillance.

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

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

Notez qu’il y a maintenant 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

Important

Les images de cette section affichent les options de l’onglet plateforme Windows universelle. Toutefois, les instructions sont identiques pour l’onglet Bureau VR, sauf indication contraire.

  1. Placez le curseur sur le triangle d’avertissement jaune en regard d’OpenXR, puis 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 OpenXR Project Validation, plusieurs problèmes sont répertoriés. Sélectionnez le bouton Fix All. REMARQUE : Cette liste peut être différente en fonction de l’onglet dans lequel vous vous trouverez.

    Capture d’écran du bouton Fix All dans la fenêtre OpenXR Project Validation.

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

    Capture d’écran de la fenêtre Project Settings avec les paramètres OpenXR affichés.

  4. Sous Interaction Profiles, notez le bouton signe plus (+).

    Capture d’écran du bouton Add Interaction Profile.

  5. Cliquez trois fois sur le bouton, chaque fois que vous choisissez un autre profil :

    Profil Eye Gaze Interaction

    Profil d’interaction avec la main de Microsoft

    Profil Microsoft Motion Controller

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

    Si Eye Gaze Interaction Profile ou tout autre profil apparaît avec un triangle jaune à côté, sélectionnez le triangle, puis dans la fenêtre OpenXR Project Validation, cliquez sur le bouton Fix. Lorsque vous avez terminé, fermez la fenêtre OpenXR Project Validation.

    Capture d’écran du bouton Fix pour le profil d’interaction Eye Gaze.

  6. Dans la fenêtre Project Settings sous OpenXR Feature Groups, vérifiez que les éléments suivants sont sélectionnés :

    Si vous êtes dans l’onglet Vr de bureau :

    Windows Mixed Reality

    Suivi de la main

    Modèle de contrôleur de mouvement

    Capture d’écran de l’onglet Groupes de fonctionnalités OpenXR pour 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 Depth Submission Mode, puis sélectionnez Depth 16 Bit.

    Capture d’écran de l’option Depth 16 Bit sélectionnée comme Depth Submission Mode.

    Conseil

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

    Remarque

    Le paramètre Render Mode, situé juste au-dessus de Depth Submission Mode, est défini par défaut sur Single Pass Instanced. Dans les applications de réalité mixte, la scène est restituée 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 à la fois sur le temps processeur et GPU. Le rendu d’instance à passage 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 Project Settings, sélectionnez Player.

  2. Notez que dans la fenêtre Lecteur, la zone Nom du produit est déjà remplie. 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

    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.

  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 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.

  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 OpenXR Mixed Reality pour des exemples de projets Unity montrant comment créer des applications Unity pour les casques HoloLens 2 ou Mixed Reality à l’aide du plug-in Mixed Reality OpenXR.

Voir aussi