The World Beyond

The World Beyond is a Mixed Reality (MR) project that demonstrates key MR features and how to integrate them into your project using the Presence Platform features.

This codebase serves as a reference and template for MR projects. You can test the experience on App Lab - The World Beyond.

Project Description

This project showcases the Scene API, Passthrough, Voice SDK, Interaction SDK, and Audio Spatializer features.

Built using the Unity engine with Unity 6000.0.50f1 or higher, it includes the MRUK (Mixed Reality Utility Kit) package, which provides useful tools and methods for mixed reality experiences.

How to Run the Project in Unity

1. Use Unity 6000.0.50f1 or higher.

2. Load the TheWorldBeyond.unity scene.

3. To test in the Editor, use Quest Link:

   Quest Link

   • Enable Quest Link:
     • Put on your headset, go to "Quick Settings", and select "Quest Link" (or "Quest Air Link" if using Air Link).
     • Select your desktop from the list, then select "Launch". This opens the Quest Link app, allowing desktop control from your headset.
   • With the headset on, select "Desktop" from the control panel in front of you. You should see your desktop in VR.
   • Navigate to Unity and press "Play"; the application should launch on your headset automatically.
   • Note: For Scene API, room data must exist before connecting the device; disconnect Link, run Room Setup on your Quest, then reconnect Link.

4. For Mac users: Build an APK and deploy it to your device.

Dependencies

This project uses the following plugins and software:

• Unity 6000.0.50f1 or higher
• MRUK (Mixed Reality Utility Kit)
• Meta XR Interaction SDK
• Voice SDK
• Audio Spatializer

To test this project within Unity, you need:

• The Meta Quest App
• Mac or Windows

Getting the Code

First, ensure you have Git LFS installed by running:

git lfs install

Then, clone this repository using the "Code" button above or this command:

git clone https://github.com/oculus-samples/Unity-TheWorldBeyond.git

Documentation

More information is available in the sections below:

• Scene Structure & Prefabs
• Scene API Guide
• Passthrough Implementation
• Voice Integration
• Interaction Systems
• Audio Spatializer
• Sample Scenes

Health & Safety Guidelines

When building mixed reality experiences, evaluate your content to offer users a comfortable and safe experience. Refer to the Mixed Reality H&S Guidelines before designing and developing your app using this sample project or Presence Platform Features.

Remarks

• When prompted to update the hand tracking settings, choose "keep OVRHands".
• During the APK build, you may be prompted about "Unsupported Input Handling". Choose "Yes" (Ignore and continue).

License

The majority of TheWorldBeyond is licensed under MIT LICENSE; files from Text Mesh Pro are licensed under their respective terms.

Contribution

See the CONTRIBUTING file for information on how to contribute.