Windows Mixed Reality
The Windows Mixed Reality platform provides a wide range of capabilities able to run under Windows 10 machines with a Mixed Reality headset and the HoloLens 1 / 2 devices.
To develop for the Windows Mixed Reality platform, you will need:
- A Windows 10 PC
- Visual Studio 2019 community edition or greater
- The Mixed Reality Portal, installed and running (for Mixed Reality Headset)
- The XRTK.SDK package installed (first)
- The XRTK.WindowsMixedReality package (once a Mixed Reality Scene has been setup)
It is advantageous to also have a Mixed Reality headset, however the Mixed Reality Portal also provides simulation capabilities for testing.
For HoloLens development:
- The development tools are now included with the Windows 10 SDKs
- (Optionally) if you do not have a device, you can install the HoloLens Emulator
- The Hololens Emulator guide also covers the necessary steps to deploy to a HoloLens Device (or simulator)
- For OpenVR on Windows Mixed Reality, you simply need to ensure that
OpenVRis one of the configured platforms in the Unity legacy XR settings for the
- For Windows Mixed Reality on UWP, you simply need to ensure that
Windows Mixed Realityis one of the configured platforms in the Unity legacy XR settings for the
UWPplatform. This is also required for HoloLens development.
The following capabilities are currently available for the Windows Mixed Reality platform
- Headset Tracking
- Boundary tracking
- Windows Mixed Reality controllers (Windows 10 only)
- HoloLens Hands implementation (HoloLens 2 only)
- Spatial Awareness (HoloLens 1 & 2 only)
Create a new Unity Project
Switch to the
Setup the Legacy XR settings in "Edit -> Project Settings -> Player -> XR Settings" for
Windows Mixed Realityto the
Add the XRTK UPM registry to Unity by Opening the Unity Package Manager (
Window -> Package manager), selecting the
Advanceddrop down and clicking on
Advanced Project Settings, then Adding the following details:
Return to the Unity Package manager and select
My Registriesin the Sources) dropdown (next to the
When prompted, install the Windows Mixed Reality platform configuration in to your current project
Close the Unity Package Manager and return to your scene
Select or create the scene you want to create Mixed Reality Content in
Mixed Reality Toolkit -> Configurein the Unity Menu. THis will update your scene and add the MixedRealityToolkit instance.
Provided you have configured the Legacy XR settings for each platform correctly, the project will run.
For Windows 10
- Ensure the Mixed Reality Portal is running before playing
- For builds, you will need to open the Visual Studio project and package the solution for Windows 10
For HoloLens 1 / 2
- Ensure you have correctly setup the Device portal on the device and it is accessbile
- For builds, you will need to open the Visual Studio project and package the solution for HoloLens
If there is anything not mentioned in this document or you simply want to know more, raise an RFI (Request for Information) request here.