Getting started with OpenXR - Mixed Reality (2024)

  • Article

You can develop using OpenXR on a HoloLens 2 or Windows Mixed Reality immersive headset on the desktop. If you don't have access to a headset, you can use the HoloLens 2 Emulator or the Windows Mixed Reality Simulator instead.

Getting started with OpenXR for HoloLens 2

To start developing OpenXR applications for HoloLens 2:

  1. Set up a HoloLens 2 device or install a recent version of the HoloLens 2 emulator.

That's it! The OpenXR API runtime is preinstalled on HoloLens 2 devices, and you'll receive automatic updates through the Store.

To make sure you've got the latest OpenXR runtime with all extensions present, you can launch the Store app from the HoloLens device or emulator. Open the menu in the upper-right of the Store app, select Downloads and updates, and choose Get updates.

Note

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.

Getting started with OpenXR for Windows Mixed Reality headsets

To start developing OpenXR applications for immersive Windows Mixed Reality headsets:

  1. Be sure you're running at least the Windows 10 October 2020 Update (20H2), which is the minimum supported OS release for Windows Mixed Reality end users to run OpenXR applications. Earlier versions of Windows 10 should still work with OpenXR but may not have ideal performance or quality. If you're on an earlier version of Windows 10, you can upgrade by using the Windows 10 Update Assistant.
  2. Set up a Windows Mixed Reality headset or enable the Windows Mixed Reality simulator.

That's it! The Windows Mixed Reality OpenXR runtime is installed and made active automatically for all Windows Mixed Reality users. The Microsoft Store then keeps the runtime up to date.

If you've been using multiple VR headsets on your PC, keep in mind that the active OpenXR runtime may be changed by another vendor's system software. To reactivate the Windows Mixed Reality OpenXR Runtime, on the Start menu, launch "Mixed Reality Portal" and then select "Fix it" at the top of the window. If that button is missing, the OpenXR runtime is already active.

If you're developing OpenXR applications for HoloLens 2 or PC VR, you might find this OpenXR Tools for Windows Mixed Reality app useful. It provides a demo of various OpenXR features and an OpenXR Runtime page that contains key information about the active runtime and current headset.

To find and install the OpenXR Tools app, on your HoloLens 2, go to the Store app and search for "OpenXR."

When using the HoloLens 2 emulator, the easiest way to install the OpenXR Tools for Windows Mixed Reality is through the Windows Device Portal. In the Portal, navigate to the "OpenXR" page and then, under Developer Features, select the Install button. This also works on physical HoloLens 2 devices.

Getting started with OpenXR - Mixed Reality (1)

Exploring the OpenXR API and sample app

Be sure to install the tools you'll need for OpenXR development if you haven't already.

The BasicXrApp project shows a simple OpenXR sample with Win32 and UWP HoloLens 2 project files in Visual Studio. 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.

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!

For a tour of the OpenXR API, check out this 60-minute video of the BasicXrApp sample in Visual Studio. 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:

Running your OpenXR app

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.

After building an OpenXR UWP app package, you can deploy that package to either a HoloLens 2 device or the HoloLens 2 Emulator.

Using OpenXR in an existing project

To get started with OpenXR in an existing project, you'll include the OpenXR loader. The loader discovers the active OpenXR runtime on the device and provides access to the core functions and extension functions that it implements.

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. Either approach will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

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.

Reference official OpenXR NuGet package

The OpenXR.Loader NuGet package is the easiest way to reference a prebuilt OpenXR loader .DLL in your Visual Studio C++ solution. This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

To add an OpenXR.Loader NuGet package reference to your Visual Studio C++ solution:

  1. In Solution Explorer, right-click the project that will use OpenXR and select Manage NuGet Packages....
  2. Switch to the Browse tab and search for OpenXR.Loader.
  3. Select the OpenXR.Loader package and select Install in the details pane to the right.
  4. Select OK to accept the changes to your project.
  5. Add #include <openxr/openxr.h> to a source file to start using the OpenXR API.

To see an example of the OpenXR API in action, check out the BasicXrApp sample app.

Include official OpenXR loader source

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. This will give you access to OpenXR 1.0 core features, plus published KHR, EXT and MSFT extensions.

To get started here, follow the instructions in the Khronos OpenXR-SDK repo on GitHub. 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.

Using preview extensions

The MSFT_preview extensions listed in the extension roadmap are experimental vendor extensions being previewed to gather feedback. These extensions are for developer devices only and will be removed when the real extension ships.

If you're interested to try out the available MSFT_preview extensions, go through the following steps to update your project:

  1. Follow either of the approaches above to integrate an OpenXR loader into your project.
  2. Replace the standard OpenXR headers in your project with the preview headers from the Mixed Reality OpenXR repo on GitHub.

To then activate preview extension support on your target HoloLens 2 or desktop PC:

  1. 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. Install the OpenXR Tools for Windows Mixed Reality app from the Microsoft Store onto the target device and run it.
  3. Navigate to the Settings tab and enable Use latest preview OpenXR runtime. This enables the preview runtime on your device, which has preview extensions activated.Getting started with OpenXR - Mixed Reality (2)
  4. Confirm the Runtime version shown on the OpenXR Runtime tab of the OpenXR Tools for Windows Mixed Reality matches the required version of the preview extensions you plan to try. If so, you should see the extension in the Extensions list. Once a stable extension is available, its preview extension will be removed.
    Getting started with OpenXR - Mixed Reality (3)

See the Mixed Reality OpenXR repo for documentation of these preview extensions and samples of how to use them.

Troubleshooting

If you have trouble getting up and running with OpenXR development, check out our troubleshooting tips.

Getting started with OpenXR - Mixed Reality (2024)

FAQs

How do I enable OpenXR in Windows Mixed Reality? ›

Windows Mixed Reality
  1. Start the Mixed Reality Portal software.
  2. Click the 'Fix it' button on the notification banner at the top of the screen. This will set Windows mixed reality as your default OpenXR runtime.

Why won't OpenXR runtime work? ›

If you're having problems running OpenXR™ titles with VIVE Streaming, check the SteamVR settings. Make sure VIVE Streaming is running on both your headset and computer and that the headset is detected in the SteamVR window. On your computer, open SteamVR settings.

How do I activate OpenXR? ›

Go to Settings on the left side menu. Go to the General tab. Press Set Oculus as active. If the button is disabled Oculus is configured for OpenXR.

What is the difference between OpenXR and Windows Mixed Reality? ›

OpenXR provides high-performance, royalty-free access to AR/VR, while Windows Mixed Reality operates mainly in VR space. Windows Mixed Reality aims at mass-market entry with compatibility with standard laptops and PCs, OpenXR focuses on extensive hardware reach.

How do I fix Windows Mixed Reality? ›

I got a "Something went wrong" error message, or I'm having problems in the Mixed Reality Portal
  1. Disconnect both headset cables from your PC.
  2. Restart your PC.
  3. Reconnect your headset.

What do you need for Windows Mixed Reality? ›

Setting up a Windows Mixed Reality Device
  • OS: Windows 10.
  • Processor: Intel® i5-6600 / AMD Ryzen 5 1500X equivalent or greater.
  • Memory: 8 GB RAM.
  • Graphics: NVIDIA GeForce® GTX 1060 3GB / AMD Radeon™ RX 480 equivalent or greater.

How do I switch to OpenXR? ›

In SteamVR Settings, select Show Advanced Settings. Select Developer, then Set SteamVR as OpenXR Runtime.

How do you reset OpenXR settings? ›

If an application can no longer start, use the OpenXR Toolkit Companion app (found on the desktop or Start menu) and select the Safe mode before starting the application, then use Ctrl+F1+F2+F3 (regardless of custom key combinations) to hard reset all settings.

What is the difference between open VR and OpenXR? ›

OpenXR & OpenVR. Without going into the technicalities of these two runtimes, OpenXR is an open standard developed by the Khronos Group while OpenVR is developed by Valve for SteamVR. The default runtime of SteamVR is OpenVR, although you can also translate SteamVR applications to OpenXR.

How to get OpenXR runtime? ›

  1. From your computer, open the SteamVR app.
  2. Head to Settings.
  3. Select Show in Advanced Settings.
  4. Head to the Developer tab.
  5. Set Current OpenXR runtime as "OpenXR runtime"
  6. Launch Microsoft Flight Simulator.
  7. Put your headset on.
Jan 27, 2024

What is the difference between OpenXR and WebXR? ›

WebXR focuses on enabling immersive experiences directly within internet browsers, catering to a broader audience of users. In contrast, OpenXR is specifically designed for creating VR, AR, and MR applications that are compatible across XR devices like mixed reality headsets and VR glasses.

Is Windows Mixed Reality dead? ›

In January 2023, Microsoft laid off entire teams which were developing HoloLens, Virtual Reality, and Mixed Reality products. On December 21, 2023, Microsoft announced that WMR has been deprecated and will be removed in Windows 11 version 24H2 expected in late-2024.

Do you need the OpenXR toolkit? ›

From the OpenXR Toolkit developer: "AS OF 2024, SUPPORT FOR OPENXR TOOLKIT IS DISCONTINUED. THERE IS NO NEW DEVELOPMENT AND NO TECH SUPPORT OF ANY SORT. THE DEVELOPER DOES NOT RECOMMEND TO INSTALL/USE OPENXR TOOLKIT, AS IT IS KNOWN TO CAUSE ISSUES WITH MANY OF THE NEWER GAMES RELEASED IN SINCE 2024."

How do I optimize Windows Mixed Reality? ›

The Optimize Window can be opened by navigating to Mixed Reality > Utilities > Optimize Window from the top bar menu in the Unity Editor. The Active Build Target is the build platform currently targeted by the project for compiling.

How to install OpenXR on Windows? ›

Installation
  1. Run the OpenXR-Toolkit.msi program. 📝 Note: You may be warned that Windows protected your PC because this software is not trusted. ...
  2. Follow the instructions to complete the installation procedure. ...
  3. Launch the OpenXR Toolkit Companion app to confirm that the software is active.

How do I get to Windows Mixed Reality settings? ›

The Experience options setting (Settings > Mixed reality > Headset display > Experience options) gives you the ability to change the Windows Mixed Reality performance settings.

How do I connect my VR to Windows Mixed Reality? ›

Connect the headset to your computer, and then open Windows Mixed Reality.
  1. Attach the headset connector to the single port on the split headset cable.
  2. Connect the headset to a USB 3.0 port on your computer. ...
  3. Connect the cable to the Mini DisplayPort on your computer.

Top Articles
Latest Posts
Recommended Articles
Article information

Author: Arline Emard IV

Last Updated:

Views: 5769

Rating: 4.1 / 5 (72 voted)

Reviews: 95% of readers found this page helpful

Author information

Name: Arline Emard IV

Birthday: 1996-07-10

Address: 8912 Hintz Shore, West Louie, AZ 69363-0747

Phone: +13454700762376

Job: Administration Technician

Hobby: Paintball, Horseback riding, Cycling, Running, Macrame, Playing musical instruments, Soapmaking

Introduction: My name is Arline Emard IV, I am a cheerful, gorgeous, colorful, joyous, excited, super, inquisitive person who loves writing and wants to share my knowledge and understanding with you.