Device setup

To build and run your AR app on a Meta Quest device, some device setup steps are required. The following sections explain the necessary steps to prepare your Meta Quest device for AR app development.

Getting started

If you are setting up a Meta Quest device for the first time, refer to Meta's Set up Development Environment and Headset article to learn how to set your headset into Developer Mode and deploy your app via Android Debug Bridge (ADB).

Meta software update

For the best experience on your Meta Quest device, consider updating to the latest version of the Meta Quest software. This will ensure that you have access to Meta's latest enhancements and bug fixes. You can update your Meta Quest software by going to Settings > System > Software Update in the universal menu on your device.

Space Setup

Some AR Foundation features require information from Meta's Space Setup before they can report any information. For example, AR Foundation can't track any planes, bounding boxes, or meshes until your user completes Space Setup.

Refer to the following instructions to run Space Setup on your device:

  1. Press the universal menu button /the universal menu button on your right Touch controller to access the universal menu.
  2. Go to Settings > Physical Space > Space Setup and select the Set up button.
  3. Follow the prompts in your headset to complete Space Setup.
Note

If Space Setup is not an available option in the Settings > Physical Space menu on your device, you must update to a more recent version of the Meta Quest software for this option to appear.

Permissions

Your app's user must grant an Android system permission before you can access Space Setup data. Refer to Permissions for more information.