Bien démarrer avec OpenXRGetting started with OpenXR

Vous pouvez développer avec OpenXR sur HoloLens 2 ou un casque immersif Windows Mixed Reality sur le bureau.You can develop using OpenXR on a HoloLens 2 or Windows Mixed Reality immersive headset on the desktop. Si vous n’avez pas accès à un casque, vous pouvez utiliser l’émulateur HoloLens 2 ou Windows Mixed Reality Simulator à la place.If you don't have access to a headset, you can use the HoloLens 2 Emulator or the Windows Mixed Reality Simulator instead.

Prise en main de OpenXR pour HoloLens 2Getting started with OpenXR for HoloLens 2

Pour commencer à développer des applications OpenXR pour HoloLens 2 :To start developing OpenXR applications for HoloLens 2:

  1. Configurez un HoloLens 2 ou suivez les instructions pour installer une version récente de l’émulateur hololens 2.Set up a HoloLens 2 or follow the instructions to install a recent version of the HoloLens 2 emulator. 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.You should already have OpenXR 1.0 ready to go if you're using a recent emulator image or the device has updated its OS.
  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.Make sure you've got the latest OpenXR runtime with all extensions present by launching the Store app from the device or emulator.
    • Ouvrez le menu en haut à droite, sélectionnez téléchargements et mises à jour, puis choisissez récupérer les mises à jour.Open the menu in the upper-right, select Downloads and updates, and choose Get updates.

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 est préférable de s’assurer que vous disposez de la dernière version de l’image de l’émulateur HoloLens 2.If you're using the emulator, the emulator image will reset each time you start it, and so your best bet is to just make sure that you have the latest version of the HoloLens 2 emulator image.

Prise en main de OpenXR pour les casques Windows Mixed RealityGetting started with OpenXR for Windows Mixed Reality headsets

Pour commencer à développer des applications OpenXR pour des casques Windows mixtes immersifs :To start developing OpenXR applications for immersive Windows Mixed Reality headsets:

  1. Assurez-vous que vous exécutez au moins la mise à jour Windows 10 2019 (1903), qui est la configuration minimale requise pour que les utilisateurs finaux Windows Mixed realisation exécutent des applications OpenXR.Be sure you're running at least the Windows 10 May 2019 Update (1903), which is the minimum requirement for Windows Mixed Reality end users to run OpenXR applications. Si vous utilisez une version antérieure de Windows 10, vous pouvez procéder à une mise à niveau à l’aide de l' Assistant Mise à jour de Windows 10.If you're on an earlier version of Windows 10, you can upgrade by using the Windows 10 Update Assistant.
  2. Configurez un casque Windows Mixed Reality ou suivez les instructions pour activer le simulateur Windows Mixed Reality.Set up a Windows Mixed Reality headset or follow the instructions to enable the Windows Mixed Reality simulator.

C’est tout !That's it! Le runtime OpenXR Windows Mixed Reality est installé et activé automatiquement pour tous les utilisateurs de Windows Mixed Reality.The Windows Mixed Reality OpenXR runtime is installed and made active automatically for all Windows Mixed Reality users. Le Microsoft Store maintient le runtime à jour.The Microsoft Store then keeps the runtime up to date.

Pour réactiver le runtime OpenXR Windows Mixed Reality, lancez le portail de réalité mixte à partir du menu Démarrer, puis sélectionnez « corriger » en haut de la fenêtre.To activate the Windows Mixed Reality OpenXR Runtime again, launch Mixed Reality Portal from the Start menu, and select "Fix it" at the top of the window. Si ce bouton est manquant, le runtime OpenXR est déjà actif.If that button is missing, the OpenXR runtime is already active.

Obtention de la Outils de développement OpenXR pour Windows Mixed RealityGetting the OpenXR Developer Tools for Windows Mixed Reality

Pour tester le runtime OpenXR Windows Mixed Reality, vous pouvez installer l' application OpenXR outils de développement pour Windows Mixed Reality.To try out the Windows Mixed Reality OpenXR Runtime, you can install the OpenXR Developer Tools for Windows Mixed Reality app. 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.This app provides a demo of various OpenXR features, along with a System Status page with key information about the active runtime and current headset.

Lors de l’utilisation de l’émulateur HoloLens 2, le moyen le plus simple d’installer OpenXR Outils de développement pour Windows Mixed Reality se fait via le portail de périphériques Windows.When using the HoloLens 2 emulator, the easiest way to install the OpenXR Developer Tools for Windows Mixed Reality is through the Windows Device Portal. Accédez à la page « OpenXR », puis cliquez sur le bouton « installer » sous « fonctionnalités pour les développeurs », qui fonctionne également sur les appareils HoloLens 2 physiques.Navigating to the "OpenXR" page and then clicking the "Install" button under "Developer Features", which also works on physical HoloLens 2 devices.

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

Création d’un exemple d’application OpenXRBuilding a sample OpenXR app

Veillez à installer les outils dont vous aurez besoin pour le développement OpenXR si vous ne l’avez pas déjà fait.Be sure to install the tools you'll need for OpenXR development if you haven't already.

Le projet BasicXrApp illustre un exemple OpenXR simple avec des fichiers projet Win32 et UWP 2 dans Visual Studio.The BasicXrApp project shows a simple OpenXR sample with Win32 and UWP HoloLens 2 project files in Visual Studio. Étant donné que la solution contient un projet UWP HoloLens, vous avez besoin de la charge de travail de développement plateforme Windows universelle installée dans Visual Studio pour l’ouvrir entièrement.Because the solution contains a HoloLens UWP project, you'll need the Universal Windows Platform development workload installed in Visual Studio to fully open it.

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 !While the Win32 and UWP project files are separate because of differences in packaging and deployment, the app code inside each project is almost exactly the same!

Après la génération d’un bureau OpenXR Win32. EXE, vous pouvez l’utiliser avec un casque VR sur toute plateforme Desktop VR qui prend en charge OpenXR, quel que soit le type de casque.After building an OpenXR Win32 desktop .EXE, you can use it with a VR headset on any desktop VR platform that supports OpenXR, whatever the headset type.

Après avoir créé un package d’application OpenXR UWP, vous pouvez déployer ce package sur un appareil hololens 2 ou sur l’émulateur hololens 2.After building an OpenXR UWP app package, you can deploy that package to either a HoloLens 2 device or the HoloLens 2 Emulator.

Apprentissage de l’API OpenXRLearning the OpenXR API

Pour une visite guidée de l’API OpenXR, consultez cette vidéo de 60 minutes de l’exemple BasicXrApp dans Visual Studio.For a tour of the OpenXR API, check out this 60-minute video of the BasicXrApp sample in 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 :The video shows how each of the major components of the OpenXR API can be used in your own engine, and also demonstrates some of the applications built on OpenXR today:

Intégrer le chargeur OpenXR dans un projetIntegrate the OpenXR loader into a project

Pour commencer à utiliser OpenXR dans un projet existant, vous devez inclure le chargeur OpenXR.To get started with OpenXR in an existing project, you'll include the OpenXR loader. 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.The loader discovers the active OpenXR runtime on the device and provides access to the core functions and extension functions that it implements.

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.You can reference the official OpenXR NuGet package from your Visual Studio project or include the official OpenXR loader source from the Khronos GitHub repo. 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 .Either approach will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

Si vous êtes intéressé par l’expérimentation des MSFT_preview Extensions, vous pouvez copier les en-têtes OpenXR en préversion à partir du GitHub référentiel de la réalité mixte.If you're interested to experiment with MSFT_preview extensions as well, you can copy in preview OpenXR headers from the Mixed Reality GitHub repo.

Référencer le package NuGet officiel OpenXRReference official OpenXR NuGet package

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++.The OpenXR.Loader NuGet package is the easiest way to reference a prebuilt OpenXR loader .DLL in your Visual Studio C++ solution. Cela vous permet d’accéder aux fonctionnalités principales de OpenXR 1,0, ainsi KHR EXT qu’aux MSFT Extensions publiées et.This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

Pour ajouter une référence de package NuGet OpenXR. Loader à votre solution Visual Studio C++ :To add an OpenXR.Loader NuGet package reference to your Visual Studio C++ solution:

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le projet qui utilisera OpenXR et sélectionnez gérer les packages NuGet....In Solution Explorer, right-click the project that will use OpenXR and select Manage NuGet Packages....
  2. Basculez vers l’onglet Parcourir et recherchez OpenXR. Loader.Switch to the Browse tab and search for OpenXR.Loader.
  3. Sélectionnez le package OpenXR. Loader et sélectionnez installer dans le volet des détails à droite.Select the OpenXR.Loader package and select Install in the details pane to the right.
  4. Sélectionnez OK pour accepter les modifications apportées à votre projet.Select OK to accept the changes to your project.
  5. Ajoutez #include <openxr/openxr.h> à un fichier source pour commencer à utiliser l’API OpenXR.Add #include <openxr/openxr.h> to a source file to start using the OpenXR API.

Pour voir un exemple de l’API OpenXR en action, consultez l’exemple d’application BasicXrApp .To see an example of the OpenXR API in action, check out the BasicXrApp sample app.

Inclure la source de chargeur OpenXR officielleInclude official OpenXR loader source

Si vous souhaitez créer vous-même le chargeur, par exemple pour éviter le chargeur supplémentaire. DLL, vous pouvez extraire les sources officielles Khronos OpenXR Loader dans votre projet.If you want to build the loader yourself, for example to avoid the extra loader .DLL, you can pull the official Khronos OpenXR loader sources into your project. Cela vous permet d’accéder aux fonctionnalités principales de OpenXR 1,0, ainsi KHR EXT qu’aux MSFT Extensions publiées et.This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

Pour commencer, suivez les instructions de la Khronos OpenXR-SDK référentiel sur GitHub.To get started here, follow the instructions in the Khronos OpenXR-SDK repo on 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.The project is set up to build with CMake - if you're using MSBuild, you'll need to copy the code into your own project.

Utilisation des extensions d’aperçuUsing preview extensions

Les MSFT_preview Extensions répertoriées dans la feuille de route d’extension sont des extensions de fournisseur expérimentales prévisualisées pour recueillir des commentaires.The MSFT_preview extensions listed in the extension roadmap are experimental vendor extensions being previewed to gather feedback. Ces extensions sont destinées aux appareils de développement uniquement et seront supprimées lors de la livraison de l’extension réelle.These extensions are for developer devices only and will be removed when the real extension ships.

Si vous souhaitez essayer les extensions disponibles, effectuez MSFT_preview les étapes suivantes pour mettre à jour votre projet :If you're interested to try out the available MSFT_preview extensions, go through the following steps to update your project:

  1. Suivez l’une des approches ci-dessus pour intégrer un chargeur OpenXR à votre projet.Follow either of the approaches above to integrate an OpenXR loader into your project.
  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.Replace the standard OpenXR headers in your project with the preview headers from the Mixed Reality OpenXR repo on GitHub.

Pour activer la prise en charge de l’extension de préversion sur votre ordinateur de bureau ou HoloLens 2 cible :To then activate preview extension support on your target HoloLens 2 or desktop PC:

  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.To make sure you've got the latest OpenXR runtime with all extensions present, launch the Store app from within the target device or emulator, open the menu in the upper-right, select Downloads and updates and choose Get updates.
  2. Installez l' application OpenXR outils de développement pour Windows Mixed Reality à partir du Microsoft Store sur le périphérique cible et exécutez-le.Install the OpenXR Developer Tools for Windows Mixed Reality app from the Microsoft Store onto the target device and run it.
  3. Accédez à l’onglet paramètres du développeur et activez utiliser la dernière version d’évaluation OpenXR Runtime.Navigate to the Developer Settings tab and enable Use latest preview OpenXR runtime. Cela active le runtime Preview sur votre appareil, pour lequel les extensions d’aperçu sont activées.This enables the preview runtime on your device, which has preview extensions activated. OpenXR Outils de développement de l’onglet Paramètres du développeur de l’application Windows Mixed RealityOpenXR Developer Tools for Windows Mixed Reality app Developer Settings tab
  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.Confirm the Runtime version shown on the System Status tab of the OpenXR Developer Tools for Windows Mixed Reality matches the required version of the preview extensions you plan to try. Dans ce cas, l’extension doit apparaître dans la liste Extensions .If so, you should see the extension in the Extensions list. Une fois qu’une extension stable est disponible, son extension d’aperçu est supprimée.Once a stable extension is available, its preview extension will be removed.
    OpenXR Outils de développement de l’onglet État du système de l’application Windows Mixed RealityOpenXR Developer Tools for Windows Mixed Reality app System Status tab

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 .See the Mixed Reality OpenXR repo for documentation of these preview extensions and samples of how to use them.

DépannageTroubleshooting

Si vous ne parvenez pas à vous lancer avec le développement OpenXR, consultez nos conseils de dépannage.If you have trouble getting up and running with OpenXR development, check out our troubleshooting tips.