Passthrough over Link
Passthrough over Link is a feature that significantly decreases the iteration time when developing passthrough-enabled apps. It allows running such apps while using
Link, eliminating the need to build the app on a PC and deploy it to a Meta Quest device every time you test it during development. With Passthrough over Link, it is faster than ever to create mixed reality experiences.
Passthrough over Link allows you to:
- Use a developer platform such as Unity or Unreal Engine to run a passthrough-enabled app by launching the app directly in the editor.
- Quickly iterate during development when using the Passthrough API. (We support passthrough and hands functionalities).
Note: Passthrough over Link is a developer-only feature aimed at increasing your development speed by previewing your passthrough-enabled apps while still in development. That being said, the visual appearance and performance characteristics of the experience are slightly different between running over Link and running on a Meta Quest device.
This section outlines the prerequisites for using Passthrough over Link.
To use Passthrough over Link, you need the following hardware:
- A PC that meets the specifications for running Link
- A Quest line device (for example, a Quest 2)
- A compatible USB-C cable to use for Link. For Color Passthrough, the USB connection should provide an effective bandwidth of at least 2 Gbps. You can measure the connection speed by using the USB speed tester built into the PC app: go to Devices, select the connected device, click USB Test, and then click Test Connection. If the connection speed is low, try using a different cable and USB adapter.
The essential software for using Passthrough over Link is:
- Meta Quest build v37.0 or later
- Meta Quest Link PC app with version v37.0 or later, which you can download from the Meta Quest website
Important: You must enable the Developer Runtime Features and Passthrough over Meta Quest Link toggles in the Meta Quest Link PC app by clicking Settings > Beta. The Passthrough over Meta Quest Link toggle appears only when you enable the previous toggle.
Note: You must sign in to your developer account in the Meta Quest Link PC app and in your Meta Quest headset.
To use this feature you must be in Native version 37 or higher.
Before running your app, you must enable Link.
Native developers can use Passthrough over Link to test their apps during the development process. The apps must be made to build on PC and run on the host as OpenXR apps. Passthrough over Link uses the same Passthrough APIs as the ones used in a Native Meta Quest Android app. For example, you must ensure that the
device supports passthrough by querying the appropriate system properties. For details, read the
Implement Passthrough guide.
The Passthrough over Link feature is available only to developers, and can be toggled on/off through the host PC using the Meta Quest Link PC app. When toggled on, data captured from the head-mounted display’s cameras, including camera images of the physical environment, will be transmitted to and processed on the host PC. Passthrough over Link is off by default.
The first time you toggle on Passthrough over Link, the following consent modal appears.
You only need to give your consent once.
At no point during the execution of Passthrough over Link do the camera images sent to the host PC leave the host PC, except to be sent back to the headset to be displayed.
Meta Quest Link and Screenshots
Be aware that due to the privacy constraints, screenshots you take of your Passthrough application while Link is active may not include background passthrough content but show a dark background. If you have issues with showing Passthrough content in your screenshots, disconnect the Link cable.
