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
Copy file name to clipboardExpand all lines: Documentation/GettingStartedWithTheMRTK.md
+17-23Lines changed: 17 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# Getting started with the Mixed Reality Toolkit
1
+
# Getting Started with MRTK
2
2
3
3

4
4
@@ -17,29 +17,28 @@ To get started with the Mixed Reality Toolkit you will need:
17
17
## Get the latest MRTK Unity packages
18
18
1. Go to the [MRTK release page](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases).
19
19
2. Under Assets, download both `Microsoft.MixedRealityToolkit.Unity.Examples.unitypackage` and `Microsoft.MixedRealityToolkit.Unity.Foundation.unitypackage`
20
-
> The Mixed Reality Toolkit is available via [multiple delivery mechanisms](DownloadingTheMRTK.md) and in the future will be available via the Unity package manager.
21
20
22
-
## Import MRTK packages into your Unity project
23
-
1. Create a new Unity project, or open an existing project. When creating a project, make sure to select "3D" as the template type.
21
+
The Mixed Reality Toolkit is available via [multiple delivery mechanisms](DownloadingTheMRTK.md) and in the future will be available via the Unity package manager.
24
22
25
-
> We used 2018.3.9f1 for this tutorial, though any Unity 2018.3.x release should work.
23
+
## Import MRTK packages into your Unity project
24
+
1. Create a new Unity project, or open an existing project. When creating a project, make sure to select "3D" as the template type. We used 2018.3.9f1 for this tutorial, though any Unity 2018.3.x release should work.
26
25
27
26
2. Import the `Microsoft.MixedRealityToolkit.Unity.Foundation.unitypackage` you downloaded by going into "Asset -> Import Package -> Custom Package", selecting the .unitypackage file, ensure all items to import are checked, and then selecting "Import".
28
27
29
28
3. Import `Microsoft.MixedRealityToolkit.Unity.Examples.unitypackage` following the same steps as above. The examples package is optional but contains useful demonstration scenes for current MRTK features.
30
29
31
-
> After importing the Foundation package, you may see a setup prompt like the following:
MRTK is attempting to set up your project for building Mixed Reality solutions by doing the following:
35
+
* Enable XR Settings for your current platform (enabling the XR checkbox).
36
+
* Force Text Serialization / Visible Meta files (recommended for Unity projects using source control).
37
+
38
+
Accepting these options is completely optional, but recommended.
40
39
41
40
42
-
> Some prefabs and assets require TextMesh Pro, meaning you have to have the TextMesh Pro package installed and the assets in your project (Window -> TextMeshPro -> Import TMP Essential Resources). **After you import TMP Essentials Resources, you need to restart Unity to see changes**.
41
+
Some prefabs and assets require TextMesh Pro, meaning you have to have the TextMesh Pro package installed and the assets in your project (Window -> TextMeshPro -> Import TMP Essential Resources). **After you import TMP Essentials Resources, you need to restart Unity to see changes**.
43
42
44
43
45
44
## Open and run the HandInteractionExamples scene in editor
> **Note** Note that the other configuration profiles in this picker are from other scenes in the examples
94
-
package. If you did not install the examples package, you would not have been prompted to
95
-
choose a specific profile (as the foundation package only contains a single
96
-
MixedRealityToolkitConfigurationProfile - the default one). The other profiles are part of their
97
-
respective example scenes (for example, the HandInteractionAllExampleMixedRealityToolkitConfigurationProfile)
98
-
is part of the [HandInteractionExamples scene](README_HandInteractionExamples.md).
92
+
> **NOTE**: Note that the other configuration profiles in this picker are from other scenes in the examples package. If you did not install the examples package, you would not have been prompted to choose a specific profile (as the foundation package only contains a single MixedRealityToolkitConfigurationProfile - the default one). The other profiles are part of their respective example scenes (for example, the HandInteractionAllExampleMixedRealityToolkitConfigurationProfile) is part of the [HandInteractionExamples scene](README_HandInteractionExamples.md).
99
93
100
94
You will then see the following in your Scene hierarchy:
101
95
@@ -107,8 +101,8 @@ Which contains the following:
107
101
* MixedRealityPlayspace - The parent object for the headset, which ensures the headset / controllers and other required systems are managed correctly in the scene.
108
102
* The Main Camera is moved as a child to the Playspace - Which allows the playspace to manage the camera in conjunction with the SDK's
109
103
110
-
> **Note** While working in your scene, **DO NOT move the Main Camera** (or the playspace) from the scene origin (0,0,0). This is controlled by the MRTK and the active SDK.
111
-
> If you need to move the players start point, then **move the scene content and NOT the camera**!
104
+
**Note** While working in your scene, **DO NOT move the Main Camera** (or the playspace) from the scene origin (0,0,0). This is controlled by the MRTK and the active SDK.
105
+
If you need to move the players start point, then **move the scene content and NOT the camera**!
112
106
113
107
6. Hit play and test out hand simulation by pressing spacebar.
0 commit comments