Exercise - Configure Unity for Windows Mixed Reality

  • 10 minutes

We'll start by creating a new Unity project and configuring it for Windows Mixed Reality development. Unity offers some behaviors that are specific to mixed reality and those behaviors can be modified with project settings.

Create a new Unity project

  1. Launch the Unity Hub.

  2. In the Projects tab, select New Project.

    Screenshot of Unity Hub in Projects tab with the New Project button highlighted.

  3. Select the drop-down underneath New project and then choose the Editor version you want.

    Screenshot of Unity Hub with the Editor version drop-down displayed.

  4. Ensure the chosen template is 3D Core.

  5. In the Project name box, enter a name for your project; for example, "MRTK Tutorial."

  6. In the Location box, select the folder icon, and then navigate to the folder where you want to save your project and select it. You can also create a new folder.

    Screenshot of Unity Hub with 3D, Project Name, Location, and Create highlighted.

  7. Select Create Project. This opens your project in Unity.

    Screenshot of your project open in Unity.

Caution

When working on Windows, there is a MAX_PATH limit of 255 characters. Unity is affected by these limits and might fail to compile if any file path is longer than 255 characters. Therefore, we recommend that you store your Unity project as close to the root of the drive as possible.

Switch Build Platform

To target Windows Mixed Reality, your Unity project must be set to export as a Universal Windows Platform app. By default, the build settings for the Universal Windows Platform target any device, including immersive headsets. However, you can select a specific device using the Target Device drop down.

  1. In the menu bar, select File > Build Settings.

  2. In the Build Settings window, select Universal Windows Platform. If you see a message that says No Universal Windows Platform module loaded, select Install with Unity Hub, then select Install. You might need to close and reopen the Unity editor after install.

  3. Make sure the following settings are active:

    Architecture: ARM 64-bit

    Build Type: D3D Project

    Target SDK Version: Latest Installed

    Minimum Platform Version: 10.0.10240.0

    Visual Studio Version: Latest installed

    Build and Run on: Local Machine

    Build configuration: Release (there are known performance issues with Debug)

  4. Select the Switch Platform button. Unity displays a progress bar while it switches platforms.

  5. After the switch platform process is finished, close the Build Settings window.