Bien démarrer avec OpenXR

Vous pouvez développer avec OpenXR sur HoloLens 2 ou un casque immersif Windows Mixed Reality sur le bureau. Si vous n’avez pas accès à un casque, vous pouvez utiliser le HoloLens 2 Emulator ou le simulateur Windows Mixed Reality à la place.

Bien démarrer avec OpenXR pour HoloLens 2

Pour commencer à développer des applications OpenXR pour HoloLens 2 :

  1. Configurez un appareil HoloLens 2 ou installez une version récente de l’émulateur HoloLens 2.

Et voilà ! Le runtime de l’API OpenXR est préinstallé sur HoloLens 2 appareils, et vous recevrez des mises à jour automatiques via le Windows Store.

Pour vous assurer que vous disposez du dernier runtime OpenXR avec toutes les extensions présentes, vous pouvez lancer l’application Store à partir de l’appareil ou de l’émulateur HoloLens. Ouvrez le menu en haut à droite de l’application Du Windows Store, sélectionnez Téléchargements et mises à jour, puis choisissez Obtenir les mises à jour.

Notes

Si vous utilisez l’émulateur, l’image de l’émulateur est réinitialisée chaque fois que vous la démarrez. Par conséquent, il vous suffit de vous assurer que vous disposez de la dernière version de l’image de l’émulateur HoloLens 2.

Prise en main d’OpenXR pour Windows Mixed Reality casques

Pour commencer à développer des applications OpenXR pour des casques Windows Mixed Reality immersifs :

  1. Vérifiez que vous exécutez au moins la mise à jour Windows 10 octobre 2020 (20H2), qui est la version minimale prise en charge du système d’exploitation pour Windows Mixed Reality utilisateurs finaux pour exécuter des applications OpenXR. Les versions antérieures de Windows 10 doivent toujours fonctionner avec OpenXR, mais peuvent ne pas avoir de performances ou de qualité idéales. Si vous utilisez une version antérieure de Windows 10, vous pouvez effectuer une mise à niveau à l’aide de l’Assistant mise à jour Windows 10.
  2. Configurez un casque Windows Mixed Reality ou activez le simulateur Windows Mixed Reality.

Et voilà ! Le Windows Mixed Reality runtime OpenXR est installé et activé automatiquement pour tous les utilisateurs Windows Mixed Reality. Le Microsoft Store conserve ensuite le runtime à jour.

Si vous utilisez plusieurs casques VR sur votre PC, gardez à l’esprit que le runtime OpenXR actif peut être modifié par le logiciel système d’un autre fournisseur. Pour réactiver le Windows Mixed Reality OpenXR Runtime, dans le menu Démarrer, lancez « Mixed Reality Portail », puis sélectionnez « Corriger » en haut de la fenêtre. Si ce bouton est manquant, le runtime OpenXR est déjà actif.

Obtention des outils OpenXR pour Windows Mixed Reality

Si vous développez des applications OpenXR pour HoloLens 2 ou PC VR, vous pouvez trouver cet outil OpenXR Tools pour Windows Mixed Reality’application utile. Il fournit une démonstration de diverses fonctionnalités OpenXR et d’une page d’exécution OpenXR qui contient des informations clés sur le runtime actif et le casque actuel.

Pour rechercher et installer l’application OpenXR Tools, sur votre HoloLens 2, accédez à l’application Store et recherchez « OpenXR ».

Lors de l’utilisation de l’émulateur HoloLens 2, le moyen le plus simple d’installer OpenXR Tools pour Windows Mixed Reality consiste à utiliser le portail d’appareil Windows. Dans le portail, accédez à la page « OpenXR », puis, sous Fonctionnalités du développeur, sélectionnez le bouton Installer . Cela fonctionne également sur les appareils HoloLens 2 physiques.

OpenXR Tools for Windows Mixed Reality app

Exploration de l’API OpenXR et de l’exemple d’application

Veillez à installer les outils dont vous aurez besoin pour le développement OpenXR si ce n’est déjà fait.

Le projet BasicXrApp montre un exemple OpenXR simple avec des fichiers projet Win32 et UWP HoloLens 2 dans Visual Studio. Étant donné que la solution contient un projet UWP HoloLens, vous aurez besoin de la charge de travail de développement plateforme Windows universelle installée dans Visual Studio pour l’ouvrir entièrement.

Bien que les fichiers de projet Win32 et UWP soient séparés en raison des différences dans l’empaquetage et le déploiement, le code de l’application à l’intérieur de chaque projet est presque exactement le même !

Pour une visite guidée de l’API OpenXR, consultez cette vidéo de 60 minutes de l’exemple BasicXrApp dans Visual Studio. La vidéo montre comment chacun des principaux composants de l’API OpenXR peut être utilisé dans votre propre moteur, et illustre également certaines des applications basées sur OpenXR aujourd’hui :

Exécution de votre application OpenXR

Après avoir créé un bureau OpenXR Win32 .EXE, vous pouvez l’utiliser avec un casque VR sur n’importe quelle plateforme VR de bureau qui prend en charge OpenXR, quel que soit le type de casque.

Après avoir créé un package d’application UWP OpenXR, vous pouvez déployer ce package sur un appareil HoloLens 2 ou sur le HoloLens 2 Emulator.

Utilisation d’OpenXR dans un projet existant

Pour commencer à utiliser OpenXR dans un projet existant, vous allez inclure le chargeur OpenXR. Le chargeur découvre le runtime OpenXR actif sur l’appareil et fournit l’accès aux fonctions principales et aux fonctions d’extension qu’il implémente.

Vous pouvez référencer le package officiel openXR NuGet à partir de votre projet de Visual Studio ou inclure la source officielle du chargeur OpenXR à partir du dépôt de GitHub Khronos. L’une ou l’autre approche vous donne accès aux fonctionnalités principales d’OpenXR 1.0, ainsi qu’aux extensions publiées et MSFT publiéesKHREXT.

Si vous souhaitez également expérimenter des MSFT_preview extensions, vous pouvez copier dans les en-têtes OpenXR en préversion à partir du dépôt Mixed Reality GitHub.

Référencer le package officiel OpenXR NuGet

Le package NuGet OpenXR.Loader est le moyen le plus simple de référencer un chargeur OpenXR prédéfini .DLL dans votre solution Visual Studio C++. Cela vous donnera accès aux fonctionnalités principales d’OpenXR 1.0, ainsi qu’aux extensions publiées et MSFT publiéesKHREXT.

Pour ajouter une référence de package OpenXR.Loader NuGet à votre solution C++ Visual Studio :

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet qui utilisera OpenXR, puis sélectionnez Gérer les packages NuGet....
  2. Basculez vers l’onglet Parcourir et recherchezOpenXR.Loader.
  3. Sélectionnez le package OpenXR.Loader , puis sélectionnez Installer dans le volet d’informations à droite.
  4. Sélectionnez OK pour accepter les modifications apportées à votre projet.
  5. Ajoutez-y #include <openxr/openxr.h> un fichier source pour commencer à utiliser l’API OpenXR.

Pour voir un exemple de l’API OpenXR en action, consultez l’exemple d’application BasicXrApp .

Inclure la source officielle du chargeur OpenXR

Si vous souhaitez créer le chargeur vous-même, par exemple pour éviter le chargeur supplémentaire .DLL, vous pouvez extraire les sources officielles du chargeur Khronos OpenXR dans votre projet. Cela vous donnera accès aux fonctionnalités principales d’OpenXR 1.0, ainsi qu’aux extensions publiées et MSFT publiéesKHREXT.

Pour commencer ici, suivez les instructions du dépôt Khronos OpenXR-SDK sur GitHub. Le projet est configuré pour être généré avec CMake. Si vous utilisez MSBuild, vous devez copier le code dans votre propre projet.

Utilisation d’extensions en préversion

Les MSFT_preview extensions répertoriées dans la feuille de route d’extension sont des extensions de fournisseur expérimentales en préversion pour recueillir des commentaires. Ces extensions concernent uniquement les appareils de développement et seront supprimées lorsque l’extension réelle est fournie.

Si vous souhaitez tester les extensions disponibles MSFT_preview , suivez les étapes suivantes pour mettre à jour votre projet :

  1. Suivez l’une des approches ci-dessus pour intégrer un chargeur OpenXR dans votre projet.
  2. Remplacez les en-têtes OpenXR standard dans votre projet par les en-têtes d’aperçu du dépôt Mixed Reality OpenXR sur GitHub.

Pour activer ensuite la prise en charge de l’extension en préversion sur votre HoloLens 2 cible ou pc de bureau :

  1. Pour vous assurer que vous disposez du dernier runtime OpenXR avec toutes les extensions présentes, lancez l’application Store à partir de l’appareil ou de l’émulateur cible, ouvrez le menu en haut à droite, sélectionnez Téléchargements et mises à jour , puis choisissez Obtenir les mises à jour.
  2. Installez l’application OpenXR Tools pour Windows Mixed Reality à partir du Microsoft Store sur l’appareil cible et exécutez-la.
  3. Accédez à l’onglet Paramètres et activez la dernière préversion du runtime OpenXR. Cela active le runtime d’aperçu sur votre appareil, avec des extensions d’aperçu activées. OpenXR Tools for Windows Mixed Reality app Settings tab
  4. Vérifiez que la version du runtime affichée sous l’onglet Runtime OpenXR des outils OpenXR pour Windows Mixed Reality correspond à la version requise des extensions d’aperçu que vous envisagez d’essayer. Si c’est le cas, vous devez voir l’extension dans la liste Extensions . Une fois qu’une extension stable est disponible, son extension en préversion sera supprimée.
    OpenXR Tools for Windows Mixed Reality app OpenXR Runtime tab

Consultez le Mixed Reality dépôt OpenXR pour obtenir la documentation de ces extensions en préversion et des exemples de leur utilisation.

Dépannage

Si vous rencontrez des problèmes de mise en place et d’exécution avec le développement OpenXR, consultez nos conseils de dépannage.