Preparing Your Project for Mixed Reality

Preparing Your Project for Mixed Reality

This post will cover how to prepare your Unity Project to use the Mixed Reality Toolkit.  We will be modifying the project’s settings, and ensuring we’re all set to create our first scene.

What you’ll need

If you haven’t done so already, be sure you’ve properly setup your development environment and you’ve imported the Mixed Reality Toolkit into your project.  You’ll also need to be familiar with the Unity Editor and its interface controls.  If you are not, there is a great tutorial series to get you started.

Getting Started

Open your project and navigate to the Mixed Reality Project Settings Wizard via:

Mixed Reality Toolkit/Configure/Apply Mixed Reality Project Settings...

Next you’ll see the Project Settings Wizard.  You’ll want to enable the following options:

  • Target Windows Universal UWP
  • Enable XR
  • Build for Direct3D
  • Target Occluded Devices
    • If you’re also targeting the HoloLens, these settings will be automatically detected and updated for you when the app runs on the device
  • Use the Toolkit specific input manager axes
  • Enable .NET scripting back-end

Then press Apply.  It’ll take a moment for the editor to switch the build platform and re-import and serialize the assets.  Once finished, navigate to the Editor Build window to double check the wizard completed successfully via File/Build Settings...

ProTip: You can access the build window via Ctrl + Shift + B

Next, we will configure the scene.  Navigate to the Scene Settings Wizard via:

Mixed Reality Toolkit/Configure/Apply Mixed Reality Scene Settings...

You’ll see the Scene Settings Wizard, with all the default settings already enabled for you.  Press Apply.

In your scenes hierarchy you should now see the standard scene prefabs.

Next you’ll want to create a new folder in your project’s folder and name it the same as your project.  This folder will contain all the assets specific to your project under the Assets root folder.  Inside that folder you’ll want to create the following folders:

  • Animations
  • Materials
  • Meshes
  • Prefabs
  • Scenes
  • Scripts
  • Textures

Then save your scene in the Assets/<Your Project Name>/Scenes folder.

From here, you’re all set to start creating custom content for your project. Good Luck!

Comments are closed.