You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
MRTK-Unity provides a set of foundational components and features to accelerate MR app development in Unity. Latest Release of MRTK (V2) supports HoloLens/HoloLens 2, WMR, and OpenVR platform.
7
+
MRTK-Unity provides a set of foundational components and features to accelerate MR app development in Unity. The latest Release of MRTK (V2) supports HoloLens/HoloLens 2, Windows Mixed Reality, and OpenVR platforms.
8
8
9
-
# What's MRTK-Unity good for
9
+
# MRTK-Unity goals
10
10
11
-
* Provide basic features as an easy to use SDK to reduce the barrier-to-entry to get started.
12
-
11
+
* Provide basic features as an easy to use SDK and reduce barriers to get started.
13
12
* Enable rapid prototyping by providing the basic building blocks for MR app development.
14
-
15
-
* Showcase best practices in MR with UI controls and interactions that matches the WMR and HoloLens Shell.
16
-
17
-
* Support a wide audience, allowing solutions to be built that will run on multiple VR / AR / XR platforms such as Mixed Reality, Steam/Open VR.
18
-
13
+
* Showcase best practices in MR with UI controls and interactions that matches the WMR and HoloLens shell.
14
+
* Support a wide audience, allowing solutions to be built that will run on multiple VR / AR / XR platforms such as Windows Mixed Reality, Steam and Open VR.
19
15
* Ensure an extensive framework for advanced integrators, with the ability to swap out core components with their own should they wish to, or simply extend the framework to add new capabilities.
20
16
21
-
22
-
# Required Software
17
+
# Required software
18
+
23
19
|[](https://www.microsoft.com/software-download/windows10)[Windows 10 FCU](https://www.microsoft.com/software-download/windows10)|[](https://unity3d.com/get-unity/download/archive)[Unity 3D](https://unity3d.com/get-unity/download/archive)|[](http://dev.windows.com/downloads)[Visual Studio 2017](http://dev.windows.com/downloads)|[](https://go.microsoft.com/fwlink/?linkid=852626)[Simulator (optional)](https://go.microsoft.com/fwlink/?linkid=852626)|
24
20
| :--- | :--- | :--- | :--- |
25
-
| To develop apps for mixed reality headsets, you need the Windows 10 Fall Creators Update | The Unity 3D engine provides support for building mixed reality projects in Windows 10 | Visual Studio is used for code editing, deploying and building UWP app packages | The Emulators allow you test your app without the device in a simulated environment |
26
-
21
+
| To develop apps for Windows Mixed Reality headsets, you need the Windows 10 Fall Creators Update | The Unity 3D engine provides support for building mixed reality projects in Windows 10 | Visual Studio is used for code editing, deploying and building UWP app packages | The Emulators allow you test your app without the device in a simulated environment |
27
22
28
-
# Supported Platform
23
+
# Supported platforms
29
24
30
25
The Mixed Reality Toolkit V2 will includes many APIs to accelerate the development of MR / XR / VR / AR projects for a range of supported devices, starting with
31
26
32
27
- Microsoft HoloLens
33
28
- Microsoft HoloLens 2
34
-
- Microsoft Immersive headsets (IHMD)
29
+
- Microsoft Windows Mixed Reality immersive headsets (WMR)
35
30
- OpenVR (HTC Vive / Oculus Rift)
36
31
37
32
# Feature areas
@@ -40,7 +35,7 @@ The Mixed Reality Toolkit V2 will includes many APIs to accelerate the developme
40
35
41
36
* Articulated Hands + Gestures (HoloLens 2)
42
37
43
-
* Eye Tracking (HoloLens2)
38
+
* Eye Tracking (HoloLens 2)
44
39
45
40
* Voice Commanding
46
41
@@ -59,29 +54,27 @@ The Mixed Reality Toolkit V2 will includes many APIs to accelerate the developme
59
54
* Diagnostic Tool
60
55
61
56
62
-
# Getting Started with MRTK
63
-
64
-
You can find out how to use MRTK to develop for Windows Mixed Reality on the MS Developer Site.
57
+
# Getting started with MRTK
65
58
66
59
The Mixed Reality team have prepared a few guides for getting up to speed on using the new Mixed Reality Toolkit, which can be found here:
67
60
68
61
*[Downloading the Mixed Reality Toolkit](/Documentation/DownloadingTheMRTK.md)
69
62
*[Getting Started with the Mixed Reality Toolkit](/Documentation/GettingStartedWithTheMRTK.md)
Find this readme, other documentation articles and the MRTK api reference on our [MRTK Dev Portal on github.io](https://microsoft.github.io/MixedRealityToolkit-Unity/).
65
+
Find this document, other documentation articles and the MRTK API reference on our [MRTK Dev Portal on github.io](https://microsoft.github.io/MixedRealityToolkit-Unity/).
73
66
74
-
# Engage with the Community
67
+
# Engage with the community
75
68
76
69
Join the conversation around MRTK on [Slack](https://holodevelopers.slack.com/).
77
70
78
71
Ask questions about using MRTK on [Stack Overflow](https://stackoverflow.com/questions/tagged/mrtk).
79
72
80
-
Search for solution or file a new issue in [GitHub](https://github.com/Microsoft/MixedRealityToolkit-Unity/issues) if you find something broken in MRTK code.
73
+
Search for solutions or file new issues in [GitHub](https://github.com/Microsoft/MixedRealityToolkit-Unity/issues).
81
74
82
-
Deep dive into project plan and learn how you can contribute to MRTK in our [wiki](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki).
75
+
Deep dive into future plans and learn how you can contribute to MRTK in our [wiki](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki).
83
76
84
-
Join our weekly community shiproom to hear directly from the feature team. (link to come soon)
77
+
Join our weekly community shiproom to hear directly from the feature team. (link coming soon)
85
78
86
79
For issues related to Windows Mixed Reality that aren't directly related to the MRTK, check out the [Windows Mixed Reality Developer Forum](https://forums.hololens.com/).
87
80
@@ -92,14 +85,14 @@ One radical change to the Mixed Reality Toolkit vNext, will be the standards and
92
85
93
86
New examples will follow strict guidelines, such as:
94
87
95
-
* Each example must have a use and demonstrate a real world test case (no tests).
88
+
* Each example must have utility and demonstrate a real world test case (no tests).
96
89
* Each example will use a standardized template, so all examples have the same look and feel.
97
90
* Each sample will be fully documented, detailing both the use case it is demonstrating and how to implement the features demonstrated.
98
91
99
92
> Check the "Work In Progress" section of the [Windows Mixed Reality - vNext SDK](MRTK-SDK.md) for a peek at the first new example.
100
93
101
94
102
-
**External\How To** docs folder is meant to help everyone with migrating forward or any simple doubts they might have about the process.
95
+
The **External\How To** docs folder contains guides on migrating between versions and process troubleshooting.
103
96
Please feel free to grow all these sections. We can't wait to see your additions!
104
97
105
98
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
@@ -110,16 +103,10 @@ For more information see the [Code of Conduct FAQ](https://opensource.microsoft.
| 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. |
112
105
113
-
### Learn more about MRTK Project
114
-
You can find our planning material on [our wiki](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki) under Project Management Section. You can always see the items the team is actively working on in the Iteration Plan issue.
115
-
116
-
### How to Contribute
117
-
View the [**How To Contribute**](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki/How-to-Contribute) wiki page for the most up to date instructions on contributing to the Mixed Reality Toolkit!
### For details on the different branches used in the Mixed Reality Toolkit repositories, check this[Branch Guide here](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki/Branch-Guide).
112
+
### For details on the different branches used in the Mixed Reality Toolkit repositories, check the[Branch Guide](https://github.com/Microsoft/MixedRealityToolkit-Unity/wiki/Branch-Guide).
0 commit comments