futuresoftwarelab / Unity-Discover

Discover is a showcase of the Meta Quest Mixed Reality APIs. This project demonstrate how to use Passthrough, Spatial Anchors, Scene API, Colocation and Shared Anchors.

Discover

Discover is a Mixed Reality (MR) project that demonstrates how to use key MR features and quickly integrate them in your own project.

This codebase is available both as a reference and as a template for MR projects.

The majority of Discover is licensed under MIT LICENSE, however files from Text Mesh Pro, and Photon SDK, are licensed under their respective licensing terms.

See the CONTRIBUTING file for how to help out.

This project was built using the Unity engine with Photon Fusion.

You will be able to test the game out on AppLab - Discover.

Project Description

In this project you can see how we use Scene API, Interaction SDK, Passthrough, Spatial Anchors and Shared Spatial Anchors.

The project also includes the Meta Utilities and Meta Input Utilities packages, which contain many useful tools and methods.

How to run the project in Unity

1. Configure the project with Meta Quest and Photon

2. Make sure you're using Unity 2022.3.1f1 or newer.

3. Load the Assets/Discover/Scenes/Discover scene.

4. To test in Editor you will need to use Quest Link:

   Quest Link

   • Enable Quest Link:
     • Put on your headset and navigate to "Quick Settings"; select "Quest Link" (or "Quest Air Link" if using Air Link).
     • Select your desktop from the list and then select, "Launch". This will launch the Quest Link app, allowing you to control your desktop from your headset.
   • With the headset on, select "Desktop" from the control panel in front of you. You should be able to see your desktop in VR!
   • Navigate to Unity and press "Play" - the application should launch on your headset automatically.

Dependencies

This project makes use of the following plugins and software:

• Unity 2022.3.1f1 or newer
• Dependencies Hunter
• Meta Avatars SDK
• Meta XR Utilities
• Meta XR Platform SDK
• Meta XR Interaction SDK
• ParrelSync
• Photon Fusion
• Photon Voice 2
• Unity Toolbar Extender
• UniTask
• NaughtyAttributes

The following is required to test this project within Unity:

• The Oculus App

Getting the code

First, ensure you have Git LFS installed by running this command:

git lfs install

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

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

Documentation

More information can be found in the Documentation section of this project.

• Configuration
• Discover Overview
• Project Structure

Custom Packages:

• Meta Colocation
• Meta Utilities
• Meta Input Utilities
• Meta Avatars Utilities