If your devices are running on Android 12 operating systems, you need to give ManageXR special permissions in order to deploy OBBs and write files to the Android/obb folder. The devices on Android 12 include all Meta Quest devices on firmware v51 and above.
Learn more about why these permissions are necessary and strategies for deploying files via ManageXR in this Android 12 explainer.
How to find devices with missing Android OBB permissions
When was your device registered with ManageXR?
ManageXR now obtains OBB permissions from devices automatically during device setup. Devices provisioned with ManageXR after April 6th 2023 have already granted OBB permissions.
You only need to give ManageXR permission to deploy OBBs on a device if the device:
Was registered with ManageXR before April 6th 2023 (all registered after automatically grant permission during setup);
Uses or will upgrade to the Android 12 operating system (this includes all Meta Quest 2, Meta Quest Pro devices).
AND
You plan to deploy OBBs to your device now or in the future. See the "Does this apply to my deployment" section of the FAQs for more info on what it means to deploy OBBs.
You can quickly find which devices still require Android OBB permissions by going to your device list and filtering it by Missing Android 12 OBB Permission:
How to grant Android OBB permissions
Part 1. Configure how and when notifications to grant Android OBB permission show up on your device
1. Navigate to your device's Configuration > Device Settings > All Devices and find Android Permissions:
2. Choose how and when you want users to request permissions from users:
How to notify | When to notify | Required Device Experience mode | Explanation |
Show badge in Settings Toolbar |
When Configuration deploys OBBs |
ManageXR Home Screen
OR
Kiosk Mode + Shortcut Menu ON
[Premium Plan Required] | Users have to click on the ... menu in the Settings Toolbar to find the notification to grant permissions (See "Grant Permissions from within the headset" section below). Only show the notification when the current configuration applied to the device deploys OBBs with an App or files to Android/obb.
This is a user-driven approach to obtaining permission and best for end-users who feel comfortable navigating the menus. |
Show badge in Settings Toolbar |
When OBB permission is not granted | ManageXR Home Screen
OR
Kiosk Mode + Shortcut Menu ON
[Premium Plan Required] | Users have to click on the ... menu in the Settings Toolbar to find the notification to grant permissions (See "Grant Permissions from within the headset" section below).
It will always show up whenever a device has not yet granted Android OBB permissions |
Request Permission on boot |
When Configuration deploys OBBs | Any device experience
[Essential or Premium Plan] | Show permission request when device boots up and the current configuration applied to the device deploys OBBs or files to Android/obb. |
Request Permission on boot |
When OBB permission is not granted | Any device experience
[Essential or Premium Plan] | Show permission request when device boots up. It will always show up whenever a device has not yet granted Android OBB permissions. |
3. Save your configuration:
Part 2: Grant permissions from within the headset
Follow these steps to accept permission in-headset (skip to step 4 if you configured your devices to "Request Permission on boot" in Part 1):
1. Boot up and put on your device
2. Click the Meta button on your controller to go to the Home Screen or Kiosk Mode Shortcut Menu. Select the three dots ... on the right end of the toolbar:
3. Select the Permission Needed notification button. It will appear as a gear icon with arrows around it:
4. Select the Grant App Permission button
5. This will open a window with a toggle to give ManageXR the permissions to Install Unknown Apps. Toggle Allow from this source ON.
You've now completed the steps and granted the required permission! 🎉
You can confirm that your device has updated its OBB permissions by checking out the Android 12 Permissions section of your Device Information page. You should see a check mark next to Android 12 Obb Permission now!
FAQs
Does this apply to my deployment?
Does this apply to my deployment?
You only need to worry about granting Android OBB permissions if you are currently deploying OBBs or plan to in the future. The two ways you might be accomplishing this right now are by deploying an OBB with your app or by deploying files to Android/obb:
Can I preemptively grant permissions on my devices, even if they aren't on firmware v51 / Android 12 yet?
Can I preemptively grant permissions on my devices, even if they aren't on firmware v51 / Android 12 yet?
Yes! Once your devices download the latest version of the ManageXR Admin App (v1.7.19), you will be able to preemptively grant permission in-headset. You can also grant Android OBB permission on your devices at any time the the Device Setup Tool.
If you're having trouble getting your device to download the latest Meta firmware, we recommend connecting it to Wi-Fi and giving it a reboot.
I'm on the Essential plan and don't have the ManageXR Home Screen. How can I grant permissions on my devices?
I'm on the Essential plan and don't have the ManageXR Home Screen. How can I grant permissions on my devices?
Configure your Android 12 OBB permission to Request permission on boot. The next time your device reboots, you will see a request to grant permissions.
I configured my Android Permission request behavior, but it isn't showing up in-headset. What should I do?
I configured my Android Permission request behavior, but it isn't showing up in-headset. What should I do?
Confirm that your Configuration has your desired values for how and when to notify users in-headset that Android OBB permission is required.
Confirm that your device is on version 1.7.19 of the ManageXR Admin App or higher.
If you are on the Essential plan or your devices are not using the ManageXR Home Screen and not using Kiosk Mode with the Shortcut Menu ON, you will need to set Configuration > Device Settings > Android Permissions > Android 12 OBB Permission > How to Notify to Request permission on boot.
Need more help?
Talk to a member of our team using the chat bubble in the bottom right of your screen, or reach out to support@managexr.com