MixedRealityToolkit Dev_Unity_2017.2.0 branch

This is a development branch for Windows Mixed Reality immersive headset support.

IMPORTANT You will also need a recent Windows Insider SDK Preview installed, or you will not be able to build this branch.

New Features!

If you're looking for Controller models:

• See the MotionControllerTest scene.
• See:
  • ControllerVisualizer.cs
  • ControllerInfo.cs
  • GLTFComponentStreamingAssets.cs
  • The entire Utilities\Scripts\GLTF folder.
• IMPORTANT You will also need a recent Windows Insider SDK installed, or you will not be able to build these scripts. Please install the SDK found here.
• IMPORTANT Currently, motion controller's GLTF 3D model is only visible when you deploy through Visual Studio. In Unity's game mode, you should assign override model.

If you're looking for teleporting:

• See the MotionControllerTest scene.
• Controls are the same as the Cliff House, using either an Xbox controller or motion controllers. Thumbstick up for teleport, down for backup, left/right for rotation.
• See:
  • MixedRealityTeleport.cs
  • MixedRealityCameraParent.prefab
  • TeleportMarker.prefab

If you're looking for Xbox controller input via the MixedRealityToolkit's InputManager:

• See the InputTapTest scene.
• You can use the Xbox controller A to tap.
• Press A and hold to do hold started, canceled and completed.
• Press A and left joystick to trigger the navigation events.
• See:
  • GamepadInput.cs

If you're looking for Boundary tools:

• See the BoundaryTest scene.
• The Boundary folder has the scripts that support defining the floor for your immersive applications.
• The scripts help to draw the floor for immersive headsets and also allows you to check if an object is within those bounds.
• See:
  • BoundaryManager.cs
  • MixedRealityCameraParent.prefab

External\How To docs folder is meant to help everyone with migrating forward or any simple doubts they might have about the process. Please feel free to grow all these sections. We can't wait to see your additions!

Prerequisites:

1. See Development PC specs for tips on developing for immersive headsets.
2. Holograms 100 has been updated with how to setup Windows Mixed Reality in your app.
3. How to navigate the Windows Mixed Reality home.
4. Development PC needs to be on a recent Windows Insider SDK and a Windows Insider build as below.
   1. Launch Settings > Updates and Security > Windows Insider Program > Get Insider Preview builds
   2. Install the SDK found here.
5. Unity 2017.2.0f3 MRTP with Mixed Reality API support. This build of Unity can be found here.
   1. Please read more about Immersive headset details.
6. Visual Studio 2017.

Please note:

1. We will not merge this branch into master until we have a publicly available non-beta Unity that supports it and a HoloLens build that works with these new APIs.
2. You can use this branch with Windows Creators Update builds on your PC and deploy it to Windows Anniversary Update HoloLens flight.
3. Windows Creators Update flights don’t ship on HoloLens.

MixedRealityToolkit contains the following feature areas:

1. Boundary
2. Build
3. Input
4. Sharing
5. Spatial Mapping
6. Spatial Sound
7. Spatial Understanding
8. Utilities

To learn how to add the MixedRealityToolkit to your project see the Getting Started guide.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.