SETTING UP YOUR DEVICE - temporarily-permanent/open-toren-dag GitHub Wiki

In this documentation we'll do the following:

  • Pair Your headset with the Meta Horizon mobile app
  • Install Android Debug Bridge
  • Install Link
  • Install Meta Quest Developer Hub

Prerequisites

To fully set up your device for development and testing, you need the following:

Pair headset with Meta Horizon mobile app

  1. Open the Meta Horizon app.
    For instructions on installing the Meta Horizon mobile app, see Install the Meta Horizon mobile app on your phone.
  2. Sign in with your Meta developer account credentials through the app.
  3. Pair your headset with the app.
  4. Put on your headset and follow the instructions in the headset to finish the setup. For detailed setup instructions and troubleshooting, refer to the Getting started with your Meta Quest support page.

Set your device to "Developer Mode"

  1. Open the Meta Horizon mobile app.
  2. Navigate to Menu > Devices and then select your device.
  3. Go to Headset settings > Developer Mode and then enable Developer mode.
  4. Use a USB-C cable to connect the headset to your computer, and then put on the headset.
  5. Go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.
  6. (optional) When asked to allow USB debugging, select Always allow from this computer.

To Verify the connection:

  1. Open the existing Unity project.
  2. Navigate to File > Build Settings.
  3. In the platform list, select Android, and then select Switch Platform. if the target is already set to Android, Skip to the next step.
  4. In the platform list, select the Meta headset. if you don't see the meta headset in the list, select Refresh.
  5. Select Build And Run, specify a name and location for the .apk(android executable) file to output, and select Save to build the app and run it on your headset. If the app runs succesfully on the headset, you have properly connected your device.

After verifying that your device is connected, set up the following tools to assist with connecting, testing, and debugging your device:

Link
Link is a development tool that enables you to stream applications from your development machine to a Meta Quest headset. With Link, you can significantly decrease XR application development time by launching your app on your headset directly from the Scene view of the Unity Editor, without the need to build and deploy the app for an Android platform. you do this by simply pluggin in the USB-C and start a Link session with your computer.
Note: Link is currently only supported on Windows.

Enable Android Debug Bridge

Android Debug Bridge (ADB) is a command-line utility that enables you to perform a number of useful actions during XR development, including:

  • Installing apps to your headset
  • Debugging apps on your headset
  • Copying files to your headset

ADB is included with Unity’s Android SDK tools installation and located inside the /Android/SDK/platform-tools/ folder.

To enable ADB:

  1. Ensure that you have connected the device via USB
  2. Install the Oculus USB driver.
    Windows: Download the OEM USB driver, extract the oculus-adb-driver-2.0 ZIP file, go to the /oculus-go-adb-driver-2.0/usb_driver/ folder, right-click the android_winusb.inf file, and select Install.
    macOS: Skip to step 3, as you don't need any additional USB drivers.
  3. Add the installation directory to your system path. Windows: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:

C:\Program Files\Unity\Hub\Editor<version>\Editor\Data\PlaybackEngines\AndroidPlayer\SDK\platform-tools

macOS: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:

/Applications/Unity/Hub/Editor//PlaybackEngines/AndroidPlayer/SDK/platform-tools

  1. Open the command line on your development machine and run the following command to check the connected device:

adb devices

You should see output similar to the following:

List of devices attached 1PASH9BB939351 device

For additional documentation on using ADB with Meta Quest devices, including manual app installation, additional commands, and troubleshooting, see Android Debug Bridge for Meta Quest
FOr motre detailed information about using ADB, see Android Debug Bridge

Set up Link

Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use Meta XR Simulator

To set up link on your development machine:

  1. Download Link
  2. Put on your headset
  3. Open the Quick Settings window by selecting the clock on the left side of the menu bar.
  4. Open Settings, select System > Quest Link, and toggle Quest Link on.
  5. Select Launch Quest Link to start Link on your development machine and on your headset.

For more details on Link, see Use Link for App Development

Download and install MQDH

Meta Quest Developer Hub (MQDH) is an application for Windows and MacOS that allows developers to manage their devices, debug their apps, and submit their apps to the Store.

  1. Download and install the Meta Quest Developer Hub application for macOS or Windows
  2. Open the application and log in using your Meta Developer credentials
  3. n the left navigation pane, choose Device Manager. All the devices you have set up are displayed in the main pane. Each device is shown with its status, which includes the device ID and connection status. The active device shows a green Active designator.

For more information about MQDH, see Meta Quest Developer Hub Overview.

Learn more

To learn more about Meta Quest device setup and connection, see the following resources:

⚠️ **GitHub.com Fallback** ⚠️