Mixed Reality Utility Kit - Samples

1. Use the Code button on the GitHub repo or run:

   git clone https://github.com/oculus-samples/Unity-MRUtilityKitSample.git
   
2. Make sure you are using Unity 2022.3.15f1 or newer.
   Note: Unity 6 may produce Gradle build errors (e.g., “Resource Not Found”) that do not occur in Unity 2022.3. If you encounter Gradle errors in Unity 6, use Unity 2022.3.x LTS instead.
3. In the Unity Hub → Projects, click Add, then Add project from disk and select the folder you just cloned.
4. Ensure the following are installed via the Asset Store inside your project:
   • Meta XR Core SDK⁠
   • Meta XR MR Utility Kit SDK⁠
5. In Unity’s Project window, navigate to Assets/MRUKSamples to find and open the sample scenes.

1. Navigate to File → Build Profiles and select the sample scene that you want to test on your device.
2. Either Build And Run or build an APK and then navigate to the build destination folder and copy the APK to your device using Meta Quest Developer Hub.

1. Open the Unity-MRUtilityKitSample project in Unity.
2. Navigate to the Assets folder and right-click on MRUKSamples and select Export Package....
3. Save the package in an easy location to retrieve later.
4. Open your own project and click on Assets → Import Package → Custom Package... from the menu bar.
5. Find the package you saved in step 3 and click Open.

MRUKBase

A basic scene showing the core functionality of MR Utility Kit leveraging the EffectMesh prefab to visualize the scene data.

View sample⁠

Floor Zone

Identify a clean, unobstructed floor area in the room using semantic anchor data.

View sample⁠

Multi Spawn

Spawn multiple prefabs across different locations in a room using anchor queries and spacing constraints.

View sample⁠

Nav Mesh

Create a Unity NavMesh for AI agents to move intelligently around the physical room using spatial data.

View sample⁠

Virtual Home

Reskin the real world with a customizable prefab-based interior layout using semantic anchors.

View sample⁠

Passthrough Relighting

Apply virtual lighting and shadows to passthrough content using live scene data and interactive controls.

View sample⁠

Scene Decorator

Automatically populate rooms with decoration presets applied using placement constraints and surface masks.

View sample⁠

Destructible Mesh

Create destructible geometry by segmenting the global mesh. Interact using controllers or editor tools.

View sample⁠

Environment Panel Placement

Use the Environment Raycasting API to anchor UI panels to vertical surfaces in your room.

View sample⁠

Space Map

Visualize a room map using a texture-based heatmap with gradient-based spatial indicators.

View sample⁠

Keyboard Tracking

Track and visualize a physical keyboard using MRUK-compatible object tracking.

View sample⁠

Bouncing Ball

Demonstrates physics interactions as virtual balls collide with the scanned environment’s structure.

View sample⁠

QR Code Detection

Identify and track QR codes in real-world environments.

View sample⁠

• Mixed Reality Motifs Instant Content Placement.

• Mixed Reality Best Practices Design MR apps that are comfortable, intuitive, and immersive.