title | description | author | ms.author | ms.date | ms.topic | keywords |
---|---|---|---|---|---|---|
Add the Mixed Reality OpenXR Plugin to your Unity project |
Learn how to add the Mixed Reality OpenXR Plugin to your Unity project. |
satyapoojasama |
vinnietieto |
03/24/2022 |
article |
Unity, mixed reality, development, getting started, new project, Windows Mixed Reality, XR, Unity 2020, Unity 2019, OpenXR |
If you have a Unity project that's already set up for OpenXR (you have the Unity OpenXR plugin installed and configured) and you want to add the capability to target your app for HoloLens 2 or Windows Mixed Reality headsets, follow the instructions below.
To determine if your project has the Mixed Reality OpenXR plugin installed:
-
In Unity, on the menu bar, select Edit > Project Settings.
-
Ensure that you're on the XR Plug-in Management page with the Universal Windows Platform settings (Windows logo tab) displayed.
-
If Microsoft HoloLens feature group is grayed out or doesn't exist, the Mixed Reality OpenXR plugin isn't installed.
:::image type="content" source="images/028-ms-hololens-feature-group.png" alt-text="Screenshot of XR Plug-in Management window.":::
-
If the plugin is installed, proceed to the section named configure the project to use the Mixed Reality OpenXR Plugin. Otherwise, continue to follow the instructions below.
- If you're targeting HoloLens 2, see configure for HoloLens 2 via Project Validation for further instructions. Alternatively, to apply recommended settings by hand, see configure for HoloLens 2 manually.
- If you're targeting Windows Mixed Reality headsets, see configure for desktop VR.