Meta Developers

This is a basic tutorial that lets you quickly test the passthrough implementation. We highly recommend completing this tutorial to get started with integrating Passthrough in your project. You can also use this completed tutorial as a starter project for the other Passthrough tutorials that follow.

Before You Begin

Before you begin this tutorial, it is important to make sure the following checklist is complete.

Ready to use Meta Quest 2, Quest 3, or Meta Quest Pro headset. Ensure you have installed the latest software version.
Unity version 2022.3.15f1 and above (Unity 6+ is recommended)

1. Install Meta XR Core SDK

Follow the steps documented in the Import Meta XR SDKs in Unity Package Manager topic to download the Meta XR Core SDK.

2. Set Target Platform to Android

On the menu, go to File > Build Settings.
Under Platform, select Android.
Click Switch Platform.

3. Apply Configuration Settings

On the menu, go to Edit > Project Settings > Player, and then expand the Other Settings tab.
Under Rendering, set the Color Space to Linear.
Under Configuration, select IL2CPP from the Scripting Backend list.
Deselect the ARMv7 checkbox and select the ARM64 checkbox.

4. Install Unity OpenXR Plugin

For projects built on Unity 6+ that use Meta XR SDKs v74+, install the Unity OpenXR Plugin.

To install the OpenXR provider plugin:

Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
Select XR Plug-in Management in the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Windows, Mac, Linux settings tab, select OpenXR.
In the Android settings tab, select OpenXR.
Close the Project Settings window.
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
At the top left of the window, select Packages: and change the selection to Packages: In Project.
In the list of packages in the left menu, verify that there is a check mark beside the Unity OpenXR Plugin, indicating that the package is installed.

Note: Installing an XR plugin does not download and import the Meta XR SDKs in to your project. Make sure you download the Meta XR SDKs you need from the Unity Asset Store.

5. Connect Meta Quest Headset to Computer

Open your Meta Quest mobile app to enable the developer mode under the Headset Settings of your chosen headset.

Connect the headset to the computer using a USB-C cable and put on the Meta Quest headset.
Turn on the headset, go to Settings > System > Developer to turn on Enable custom settings and MTP Notification. You may need to reboot your headset to see the Developer tab under System.
Click Allow when prompted to allow access to data.
To verify the connection, open the Unity project, and then on the menu, go to File > Build Settings.
Select your Meta Quest headset from the Run Device list. If you don’t see the headset in the list, click Refresh.

6. Add OVRCameraRig

On the Hierarchy tab, right-click Main Camera, and click Delete.
On the Project tab, search for OVRCameraRig, and then drag and drop the OVRCameraRig prefab into the scene. You can also drag and drop it in the Hierarchy tab.

7. Add 3D Object

On the menu, go to GameObject > 3D Object > Sphere.
Select the 3D object and then on the Inspector tab, set the position (X, Y, Z) to (1, 1, 1) and scale to (X, Y, Z) to (0.5, 0.5, 0.5).
On the menu, go to Assets > Create > Material and rename the material to ball-color.
On the Inspector tab, under Main Maps, click the Albedo color field to open a color picker and change the color of your choice.
Drag and drop the material on the sphere.

8. Integrate Passthrough

On the Hierarchy tab, select OVRCameraRig, and then on the Inspector tab, do the following:
a. Under the OVRManager, under Tracking, set the Tracking Origin Type to Stage.
b. Under the OVRManager, under Quest Features, on the General tab, from the Passthrough Support list, select Supported.
c. Under the OVRManager, under Insight Passthrough, select Enable Passthrough to initialize passthrough during app startup.
d. Click Add Component, and then from the list, select OVRPassthroughLayer script.
e. Under the OVRPassthroughLayer script, set the Placement to Underlay. This enables background passthrough, which means that the physical world appears in the background and it enables to place the virtual 3D object in the front.
On the menu, go to Window > Rendering > Lighting, and then on the Environment tab, in the Skybox Material, select None. You can also quickly set the skybox material to none by typing None in the search box.
On the Hierarchy tab, expand OVRCameraRig > TrackingSpace > CenterEyeAnchor, and then on the Inspector tab, do the following:
a. From the Clear Flags list, select Solid Color.
b. Change the Background color to black and the alpha value to 0. You can also set the (R,G,B,A) values to (0, 0, 0, 0).

Build and test

Save project.
On the menu, go to File > Build Settings, and then click Add Open Scenes.
Make sure that the Run Device is set to Meta Quest headset that is connected via USB cable.
Click Build and Run.
Save the .APK file.
Put on the headset to test the passthrough. You should see the ball placed in front of your physical room.

Did you find this page helpful?