Meta Developers

Samples for Scene can be found either within the Core SDK’s UPM package or as part of the Starter Samples. Each sample focuses on a common use case, but tries to keep it to a minimum to demonstrate individual features.

Custom Scene Manager: Use the OVRAnchor API to create your own Scene Manager. Part of the Core SDK samples.
Mixed Reality: Use Scene, Passthrough and Boundary in a single sample. Part of the Core SDK samples.
Scene Manager (deprecated): Visualize an existing Scene Model using simple Plane and Volume prefabs, using the deprecated OVRSceneManager. Part of the Starter Samples.

For more Scene samples, please see Mixed Reality Utility Kit.

Prerequisites

Before tackling any of the samples, you should:

have your developer environment set up correctly by following the Build Your First App page.
have a good high-level understanding of Scene, as described in the Scene Overview.
you can run these samples directly in Unity by setting up Link for App Development.
For Starter Samples: have downloaded the Starter Samples project, as described in the Starter Samples page.
For Core SDK UPM samples: have extracted the samples from the Meta XR Core package, as described below.

The samples stored within the Meta XR Core SDK package are under the header “Mixed Reality Sample” and must be extracted from the Unity Package Manager window as shown in the Import Samples for Meta XR SDKs page.

On the menu, go to Window > Package Manager > Meta XR Core SDK > Samples to import or update Mixed Reality Samples.
In the Unity Editor, find Mixed Reality Samples under the Project tab. One way is to use the search field with scope set as In Asset.
Drag and drop the sample onto the Hierarchy panel. And Ensure that you have set the permissions correctly for accessing Spatial Data: In OVRCameraRig > OVRManager > Quest Features, make sure to set Scene Support to Required. This will add the correct manifest tags.
Further down in the OVRManager > Permission Requests On Startup, make sure to check the Scene checkbox. This will perform a runtime permission request when the app begins.
If you have previously created an Android Manifest, update it by going to the menu Meta > Tools > Update AndroidManifest.xml.

All samples require a Scene Model, which means you need to have run Space Setupon-device. The more robust your Space Setup process was, the richer your experience will be when you run the samples. You can create and clear your Scene Model any time in the Meta Quest headset by going to Settings > Physical Space > Space Setup. Note that if you build and run one of the samples on-device before you have captured a Scene Model, the sample will trigger the Space Setup process to set up your room.

Reference Apps

Reference Apps are applications which combine multiple APIs together to create a compelling short experience. These Reference Apps should serve as more advanced tutorials that show how to extend the basic samples into more realistic use cases. They are distributed via individual GitHub repositories under the larger Oculus Samples repository.

Phanto

Phanto showcases the best practices in using Scene Model and Scene Mesh for an action packed game. Find out more on the Phanto GitHub repository.

Discover

Discover is a Mixed Reality (MR) project that demonstrates how to use key MR features and quickly integrate them in your own project. Here you can see how to use Scene API, Interaction SDK, Passthrough, Spatial Anchors and Shared Spatial Anchors. Discover is available on the Meta Horizon Store and GitHub.

The World Beyond

The World Beyond is a room-scale Mixed Reality game using Scene capabilities together with passthrough, voice, and hand tracking capabilities. This app turns your room into a forest and lets you play with a delightful creature named Oppy, who interacts with you and your space in new ways. The World Beyond is available on the Meta Horizon Store and GitHub.

Did you find this page helpful?