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: docs/mrtk3-overview/getting-started/mrtk3-sample-scenes.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Exploring MRTK3 sample scenes
3
3
parent: Getting started with MRTK3
4
-
nav_order: 1
4
+
nav_order: 5
5
5
---
6
6
7
7
# Exploring MRTK3 sample scenes
@@ -22,7 +22,7 @@ We list below just a few of them.
22
22
23
23
This sample scene offers a wide variety of interaction examples. Despite the name, this scene is a good example of cross-platform input, including hand tracking, controller input, and mouse input. Examples of several different UI controls and interactables are present, including the volumetric UI systems.
Copy file name to clipboardExpand all lines: docs/mrtk3-overview/getting-started/mrtk3-tutorials.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: MRTK3 tutorials
3
3
parent: Getting started with MRTK3
4
-
nav_order: 2
4
+
nav_order: 6
5
5
---
6
6
7
7
# Exploring MRTK3 tutorials
@@ -15,6 +15,6 @@ Several tutorials have been created to help developers learn about MRTK3's vario
15
15
16
16
The [MRTK3 Aquarium project](https://learn.microsoft.com/windows/mixed-reality/develop/unity/mrtk3-aquarium) provides a Unity in-editor tutorial that explores various MRTK3 features. Set in an underwater scene, you'll be introduced to the creatures of the aquarium and the objects that make up their habitat. Using MRTK3 features, you'll add interactivity to the aquarium, enabling you to create an aquarium of your very own!
[Zappy's Playground](https://learn.microsoft.com/windows/mixed-reality/develop/unity/playground-tutorial) is a cross-platform developer sample project that showcases how to develop intuitive and comprehensive end-to-end experiences for mixed reality. It makes use of many advanced features present in MRTK3, such as Gaze Interaction, Hand Menus, and Spatial Audio.
Copy file name to clipboardExpand all lines: docs/mrtk3-overview/getting-started/overview.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,9 +9,9 @@ Welcome to the MRTK3! This guide serves as a starting point for using MRTK to bu
9
9
10
10
## Where should I go next?
11
11
12
-
[Exploring MRTK features](exploring-features/mrtk3-tutorials.md): Learn about MRTK's features through our tutorial project and explore our example scenes.
12
+
[Exploring MRTK features](./mrtk3-tutorials.md): Learn about MRTK's features through our tutorial project and explore our example scenes.
13
13
14
-
[Set up an MRTK Project](setting-up/setup-dev-env.md): Learn how to create an AR/VR ready Unity project using MRTK
14
+
[Set up an MRTK Project](./setup-dev-env.md): Learn how to create an AR/VR ready Unity project using MRTK
15
15
16
16
[Test and Deploy your app](../test-and-deploy/overview.md): Learn how to test and deploy your application on a device.
If your target platform is a Quest device, your Unity installation needs to include the Android Build Support Module and its submodules. More more information specifics, see the [Oculus Developer documentation](https://developer.oculus.com/documentation/unity/book-unity-gsg/#install-unity-editor).
After setting up the development environment, there are few options for creating a Unity Project with MRTK3.
27
27
28
-
-[Starting from a Template Project](setup-template.md): This guide walks you through cloning a template project, which is pre-configured to consume all MRTK3 packages. This template project is set up with Unity project settings for running your application on a device.
29
-
-[Starting from a New Project](setup-new-project.md): This guide walks you through adding vital MRTK3 packages to a new Unity project. The guide also helps you set up the Unity project settings for running your application on a device.
28
+
-[Starting from a Template Project](./setup-template.md): This guide walks you through cloning a template project, which is pre-configured to consume all MRTK3 packages. This template project is set up with Unity project settings for running your application on a device.
29
+
-[Starting from a New Project](./setup-new-project.md): This guide walks you through adding vital MRTK3 packages to a new Unity project. The guide also helps you set up the Unity project settings for running your application on a device.
Copy file name to clipboardExpand all lines: docs/mrtk3-overview/getting-started/setup-new-project.md
+15-13Lines changed: 15 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ nav_order: 3
8
8
9
9
Since MRTK3 is a collection of loosely coupled packages, consuming MRTK3 is done differently than the way you consume MRTK 2.x. We don't ship MRTK as a Unity project, so you have to manually add MRTK3 packages to your project in order to consume them.
10
10
11
-
You're not expected to consume every MRTK package. See [which features are useful to you](../../packages/packages-overview.md) and add only the dependencies that matter.
11
+
You're not expected to consume every MRTK package. See [which features are useful to you](../packages/packages-overview.md) and add only the dependencies that matter.
12
12
13
13
## Setting up a new Unity project with MRTK3
14
14
@@ -32,10 +32,10 @@ These two packages, along with their dependencies (automatically added by the Fe
32
32
33
33
Be sure to select the `org.mixedrealitytoolkit.*` packages, and not the deprecated packages. The `com.microsoft.mrtk.*` packages have been deprecated, and are no longer supported.
34
34
35
-
35
+
36
36
37
37
> [!NOTE]
38
-
> For more information on MRTK3 packages, see the [package overview page](../../packages/packages-overview.md).
38
+
> For more information on MRTK3 packages, see the [package overview page](../packages/packages-overview.md).
39
39
40
40
When you're finished selecting packages, click **Get features**, and then follow the instructions in the Mixed Reality Feature Tool to import the selected packages into your Unity project.
41
41
@@ -55,18 +55,20 @@ Once imported, MRTK3 requires a profile to be set for the standalone target plat
55
55
1. Navigate to **Edit > Project Settings**.
56
56
1. Under **Project Settings**, navigate to **MRTK3** and then switch to the standalone tab. Note that the profile is initially unspecified.
57
57
1. Populate the field with the default MRTK profile that ships with the core package. You can type in the keyword "MRTKprofile" in the search bar of the project window; make sure you search in `All`. Alternatively, you can find the profile under `Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset`.
58
-
> [!NOTE]
59
-
> Not all of the MRTK subsystems are shown in the screenshot below. The MRTK subsystems that you see may be different depending on the MRTK3 packages you've added to your project.
60
58
61
-
59
+
> [!NOTE]
60
+
> Not all of the MRTK subsystems are shown in the screenshot below. The MRTK subsystems that you see may be different depending on the MRTK3 packages you've added to your project.
61
+
62
+
63
+
62
64
1. Switch to the tabs of other build target(s) you want to use (for example, UWP, Android) and check to see if the profile is assigned. If not, repeat the previous step on the current tab.
63
65
64
66
### 5. Configure OpenXR-related settings
65
67
66
68
Once imported, MRTK3 requires some configuration on OpenXR if you're targeting an XR device such as HoloLens 2 or Quest.
67
69
68
70
> [!NOTE]
69
-
> The following instructions apply to HoloLens 2 or WMR headsets. If you're targeting Quest, refer to the instructions on the [Quest deployment page](../../test-and-deploy/quest-deployment.md#deployment-prerequisites).
71
+
> The following instructions apply to HoloLens 2 or WMR headsets. If you're targeting Quest, refer to the instructions on the [Quest deployment page](../test-and-deploy/quest-deployment.md#deployment-prerequisites).
70
72
71
73
1. Navigate to **Edit > Project Settings**.
72
74
@@ -77,11 +79,11 @@ Once imported, MRTK3 requires some configuration on OpenXR if you're targeting a
1. Under **Project Settings**, navigate to **XR Plug-in Management > OpenXR > Interaction Profiles** and add the following three profiles for UWP and Standalone:
87
89
@@ -94,19 +96,19 @@ Once imported, MRTK3 requires some configuration on OpenXR if you're targeting a
1. For HoloLens 2, we recommend that you set **Depth Submission Mode** to 16-bit in the settings above.
104
106
1. For immersive headsets, you can use 24-bit depth submission. See the [Microsoft development docs for Unity](https://learn.microsoft.com/windows/mixed-reality/develop/unity/recommended-settings-for-unity?tabs=openxr#enable-depth-buffer-sharing) for more info.
105
107
106
108
### 6. Congratulations, the project setup is now finished
107
109
108
-
Proceed to [creating a new MRTK3 scene](../setting-up/setup-new-scene.md).
110
+
Proceed to [creating a new MRTK3 scene](./setup-new-scene.md).
109
111
110
112
## Next steps
111
113
112
-
Once you've finished setting up your Unity project, learn how to [experience your application on a device](../../test-and-deploy/overview.md)
114
+
Once you've finished setting up your Unity project, learn how to [experience your application on a device](../test-and-deploy/overview.md)
0 commit comments