Manging your Headset with MQDH
This page covers common tasks you can accomplish in MQDH, such as:
Change the device nickname Device nicknames help identify them more easily.
To give your device a nickname:
- In MQDH, select Device Manager from the left navigation pane.
- Under Devices, to the right of your device, select the gear icon to open the Device Settings window.
- Under General and to the right of Device Nickname, select Change.
- In the Device Nickname dialog, enter a new nickname for the device.
- Select Save to save the new nickname.
Turn off the Boundary System The
boundary system creates a virtual boundary to ensure your safety while immersed in the VR experience.
For development and debugging purposes, you can turn off the boundary system.
To turn off the boundary system:
- In MQDH, select Device Manager from the left navigation pane.
Under Device Actions, toggle off Boundary.
You can also press the CTRL + Shift + G keyboard shortcut to turn the boundary system on or off.
Note: During development, you often debug directly in the development environment without wearing the headset, so it’s safe to turn off boundaires. When you are no longer actively developing, we recommend turning the boundary system back on.
Turn off the Proximity Sensor The proximity sensor ensures the headset goes to sleep when not in use.
For development and debugging purposes, you can turn off the proximity sensor to keep the device in an active state. This can make it much easier for you to capture screenshots, record videos, and step through code.
To turn off the Proximity Sensor:
- In MQDH, select Device Manager from the left navigation pane.
Under Device Actions, turn off Proximity Sensor to keep the headset in the active state for a select number of hours.
You can also press the CTRL + Shift + P keyboard shortcut to turn on or off the proximity sensor.
Note: Turning off the proximity sensor means your device will not go to sleep, and your battery won’t last as long as it would with the proximity sensor on. When you no longer need the headset to be in an active state continuously, we highly recommend turning the headset off, leaving the device charging, or turning the proximity sensor back on.
Enable Android Developer Bridge (ADB) Android Developer Bridge (ADB) is a command-line tool bundled with MQDH which enables you to communicate with your Meta Quest headset during development.
Note: ADB is a utility that is part of the
Android SDK and is also part of the MQDH install. If you have previously installed the Android SDK, you may have a different ADB version already running on your computer. The different ADB instances can conflict with each other, giving you unexpected results.
If MQDH detects multiple adb paths on startup, it displays a warning message. If this warning message appears when you start MQDH, you can use the existing ADB version installed on your computer by changing the ADB path in MQDH.
To change the ADB path in MQDH:
- In MQDH, select Settings from the left navigation pane.
- Under the General tab, ensure that the path displayed under ADB Path is set to the correct ADB installation path.
- To change the path, to the right of ADB Path, select Edit, and either select from options under Detected ADB Clients, or specify a path for one under Specify ADB Client. Select Restart MQDH to restart the app with the new ADB installation selection.
With MQDH, you can connect the headset wirelessly to the computer using ADB over WiFi. Ensure that your headset and development machine are connected to the same Wi-Fi network.
To enable ADB over Wi-Fi:
- Open the Device Manager page from the left navigation pane.
- Under Device Actions, toggle on ADB over Wi-Fi. The status under ADB over WiFi changes to enabled.
- Disconnect the USB cable from the headset to continue using your headset wirelessly.
Link is a tool that speeds up development by enabling you to stream apps from your development machine directly to your headset.
Note: Link causes your device to behave like a PC VR headset until the tool is explicitly turned off. To speed up testing build time, we recommend using Link during XR application development, even if you only intend to release your app as a standalone headset app.
To enable Link with MQDH:
- Open the Device Manager page from the left navigation pane.
- Under Device Actions, next to Meta Quest Link, open the Select Mode drop-down list, and select either Cable or Air Link connection modes.
- Select the button next to the connection mode to toggle on Meta Quest Link.
To switch between Air Link and Cable connection modes:
- Under Device Actions, next to Meta Quest Link, toggle off Meta Quest Link.
- Under Device Actions, next to Meta Quest Link, open the Select Mode drop-down list, and select either Cable and Air Link.
- Select the button next to the connection mode to toggle on Meta Quest Link.
To learn more about using Link, see
Link.
To view and update MQDH settings:
- Open MQDH.
- In the left navigation pane, select Settings.
- Select one of the following four tabs to view and edit settings:
- General, for general settings, including ADB Path, System Sound, and more.
- About, for general information about the MQDH installation, such as MQDH Version and Terms of Service.
- Notifications, for notification settings.
- Internal, for additional system settings.
