microsoft / MixedRealityDesignLabs_Unity

Mixed Reality Design Labs share experimental samples, explorations and learning from Windows Mixed Reality Design group. If you are looking for official toolkit, please use Mixed Reality Toolkit
MIT License
408 stars 110 forks source link

What is Mixed Reality Design Labs?

The Mixed Reality Design Labs (MRDL) is a collection of well-documented, open-source samples, based on the foundation of Mixed Reality Toolkit - Unity (MRTK). The goal is to inspire creators and help them build compelling, efficient Mixed Reality experiences.

MRTK offers building-block components, and MRDL leverages them to offer more complete experiences and samples. As the name suggests, these samples are experimental/’works-in-progress’, driven by experience design, which provide creators with concrete examples of best practices for app experiences, UX, and MRTK implementation. By ‘experimental’, we mean MRDL is not officially supported/maintained by Microsoft (e.g. updated to latest versions of Unity), whereas MRTK is officially supported/maintained.

Sample apps

MRDL samples have been a successful pipeline for taking app-specific interactions and pushing them back as controls/patterns for MRTK. MRTK/MRDL have blossomed into a symbiotic relationship where iteration on each side has made the other better. This repo is where Microsoft's Windows Mixed Reality Design team publishes sample apps and experiments. If you are looking for the official toolkit, please go to Mixed Reality Toolkit - Unity.

Sample app - Lunar Module
HoloLens 1st gen only
Sample app - Periodic Table
HoloLens, HoloLens 2, VR
Sample app - Surfaces
HoloLens 2 only
Lunar Module sample app Periodic Table of the Elements Surfaces
Lunar Module demonstrates how to extend Hololens' base gestures with two hand tracking and xbox controller input, reactive objects to surface mapping and plane finding, and simple menu systems. You can use this project's components to create your own mixed reality app experience. Periodic Table of the Elements app demonstrates how to use Object Collection to lay out an array of objects in three-dimensional space with various surface types. You can also find the example of using Fluent Design elements such as light, depth, motion and material. Surfaces demonstrates how to use Mixed Reality Toolkit(MRTK)'s input system and building blocks to create an app experience for HoloLens 2. It explores how we can create a tactile sensation with visual, audio, and fully articulated hand-tracking input.

Hydrating the sample app submodules

As soon as you clone, navigate inside the repo and init/update the project submodules with the following git commands:

cd MixedRealityDesignLabs_Unity
git submodule init
git submodule update

To update the submodules you'll still need to pull from the remote master by either going into the individual submodule directory and doing a git pull or by doing the following command to do pulls on all the submodules:

git submodule foreach git pull

The former MRDL prototyping framework built on HUX has been sunset, please consult releases for a previous verison of this repostiory.

Contributing

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.

Useful resources on Microsoft Windows Dev Center

Academy Design Development Community
See code examples.
Do a coding tutorial.
Watch guest lectures.
Get design guides.
Build user interface.
Learn interactions and input.
Get development guides.
Learn the technology.
Understand the science.
Join open source projects.
Ask questions on forums.
Attend events and meetups.