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.

Prise en main de OpenXR pour HoloLens 2

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

  1. configurez un HoloLens 2 ou suivez les instructions pour installer une version récente de l’émulateur HoloLens 2. Vous devez déjà disposer de OpenXR 1,0 prêt à l’emploi si vous utilisez une image d’émulateur récente ou si l’appareil a mis à jour son système d’exploitation.
  2. Assurez-vous que vous disposez de la dernière version du runtime OpenXR avec toutes les Extensions présentes en lançant l’application du Windows Store à partir de l’appareil ou de l’émulateur.
    • Ouvrez le menu en haut à droite, sélectionnez téléchargements et mises à jour, puis choisissez récupérer les mises à jour.

Remarque

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 est préférable de s’assurer que vous disposez de la dernière version de l’image de l’émulateur HoloLens 2.

prise en main de OpenXR pour les casques Windows Mixed Reality

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

  1. assurez-vous que vous exécutez au moins la Mise à jour de mai 2019 de Windows 10 (1903), qui est la configuration minimale requise pour Windows Mixed Reality les utilisateurs finaux d’exécuter des applications OpenXR. si vous utilisez une version antérieure de Windows 10, vous pouvez procéder à une mise à niveau à l’aide de l' Assistant Windows 10 Update.
  2. configurez un Windows Mixed Reality casque ou suivez les instructions pour activer 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 maintient le runtime à jour.

pour réactiver le Windows Mixed Reality Runtime OpenXR, lancez le portail de réalité mixte à partir du menu Démarrer et sélectionnez « Fix it » en haut de la fenêtre. Si ce bouton est manquant, le runtime OpenXR est déjà actif.

Obtention de la Outils de développement OpenXR pour Windows Mixed Reality

pour tester le Windows Mixed Reality Runtime OpenXR, vous pouvez installer le Outils de développement OpenXR pour Windows Mixed Reality application. Cette application fournit une démonstration de diverses fonctionnalités OpenXR, ainsi qu’une page d’État du système avec des informations clés sur le runtime actif et le casque actuel.

lors de l’utilisation de l’émulateur de HoloLens 2, le moyen le plus simple d’installer le Outils de développement OpenXR pour Windows Mixed Reality s’effectue via le portail des appareils Windows. accédez à la page « OpenXR », puis cliquez sur le bouton « installer » sous « fonctionnalités du développeur », qui fonctionne également sur les appareils HoloLens 2 physiques.

Outils de développement OpenXR pour l’application Windows Mixed Reality

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 vous ne l’avez pas déjà fait.

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

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

Exécution de votre application OpenXR

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

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

Learning de l’API OpenXR

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 composants principaux de l’API OpenXR peut être utilisé dans votre propre moteur et illustre également certaines des applications générées sur OpenXR aujourd’hui :

Utilisation de OpenXR dans un projet existant

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

vous pouvez référencer le package NuGet officiel OpenXR à partir de votre projet Visual Studio ou inclure la source OpenXR loader officielle à partir du Khronos GitHub référentiel. Les deux approches vous permettront d’accéder aux fonctionnalités principales de OpenXR 1,0, KHR ainsi EXT qu’aux extensions publiées et MSFT .

si vous êtes intéressé par l’expérimentation des MSFT_preview extensions, vous pouvez MSFT_preview à partir de la réalité mixte GitHub référentiel.

référencer le package NuGet officiel OpenXR

le package OpenXR. loader NuGet 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 permet d’accéder aux fonctionnalités principales de OpenXR 1,0, ainsi KHREXT qu’aux MSFT Extensions publiées et.

pour ajouter un OpenXR. loader NuGet référence du package à votre solution Visual Studio C++ :

  1. dans Explorateur de solutions, cliquez avec le bouton droit sur le projet qui utilisera OpenXR et sélectionnez gérer NuGet Packages....
  2. Basculez vers l’onglet Parcourir et recherchez OpenXR. Loader.
  3. Sélectionnez le package OpenXR. Loader et sélectionnez installer dans le volet des détails à droite.
  4. Sélectionnez OK pour accepter les modifications apportées à votre projet.
  5. Ajoutez #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 de chargeur OpenXR officielle

Si vous souhaitez créer vous-même le chargeur, par exemple pour éviter que le chargeur supplémentaire .DLL, vous pouvez extraire les sources de chargeur OpenXR Khronos officielles dans votre projet. Cela vous permet d’accéder aux fonctionnalités principales de OpenXR 1,0, ainsi KHREXT qu’aux MSFT Extensions publiées et.

Pour commencer, suivez les instructions de Khronos OpenXR-SDK référentiel 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 des extensions d’aperçu

Les MSFT_preview Extensions répertoriées dans la feuille de MSFT_preview sont des extensions de fournisseur expérimentales prévisualisées pour recueillir des commentaires. Ces extensions sont destinées aux appareils de développement uniquement et seront supprimées lors de la livraison de l’extension réelle.

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

  1. Suivez l’une des approches ci-dessus pour intégrer un chargeur OpenXR à votre projet.
  2. Remplacez les en-têtes OpenXR standard de votre projet par les en-têtes d’aperçu de la OpenXR de la réalité mixte référentiel sur GitHub.

pour activer la prise en charge de l’extension preview sur votre HoloLens 2 cible ou votre ordinateur de bureau :

  1. Pour vous assurer que vous disposez de la dernière version du runtime OpenXR avec toutes les Extensions présentes, lancez l’application du Windows 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 récupérer les mises à jour.
  2. installez le Outils de développement OpenXR pour Windows Mixed Reality application à partir du Microsoft Store sur le périphérique cible, puis exécutez-le.
  3. accédez à l’onglet Paramètres du développeur et activez utiliser la dernière version préliminaire du runtime OpenXR. Cela active le runtime Preview sur votre appareil, pour lequel les extensions d’aperçu sont activées. OpenXR Outils de développement pour Windows Mixed Reality onglet Paramètres de développement d’applications
  4. confirmez la version du Runtime affichée sous l’onglet état du système de la Outils de développement OpenXR pour Windows Mixed Reality correspond à la version requise des extensions préliminaires que vous envisagez d’essayer. Dans ce cas, l’extension doit apparaître dans la liste Extensions . Une fois qu’une extension stable est disponible, son extension d’aperçu est supprimée.
    OpenXR Outils de développement pour Windows Mixed Reality onglet état du système de l’application

Pour obtenir de la documentation sur ces extensions préliminaires et des exemples d’utilisation, consultez le référentiel OpenXR de la réalité mixte .

Dépannage

Si vous ne parvenez pas à vous lancer avec le développement OpenXR, consultez nos conseils de dépannage.