Groups

In this article:


Overview

Groups are admin-defined groups of devices that share the same content (apps and files) & settings (like Wi-Fi network and launch method). If you add or remove an app or file to or from a group, that app or file will be added/removed from all devices within the group. Likewise, if you change a group's setting such as the launch method, that launch method will be applied to all devices in the group. 

Groups only support a single device type. For example, you cannot add both Pico Neo 2 devices and VIVE Focus Plus devices to the same group. Additionally, devices cannot be assigned to multiple groups simultaneously. 

Create a Group

  1. In the side navigation menu select Create a Group.
  2. Enter a name for the group.
  3. Specify the Device Type that will be added to this group (i.e., whether group will be used to manage Pico Neo 2 devices, HTC VIVE Focus Plus devices, etc.).
  4. Click Create Group.
  5. You will now be directed to the group's overview page and see the group as a menu item listed beneath Devices.


Add Devices to a Group

Once you have set up devices with ArborXR, you have two options for assigning devices to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question.
  2. Click Add Devices.
  3. Select devices then click Add. 
This modal will filter out incompatible device types along with devices that have already been added to the group.

Option 2: Device Index Page

  1. Navigate to the All devices page.
  2. Select relevant devices.
  3. Click Assign to Group.
    1. If you have multiple device types selected (e.g. Pico Neo 2 devices and VIVE Focus Plus devices), select one of the device type options from the dropdown that appears on clicking Assign to Group.
  4. Select the relevant group.
  5. Click Assign.
If any of the selected devices are already in a group and you select to reassign them to a different group, the content and settings of the new group will be applied. 


Deploy Apps to Devices in a Group

Once you have uploaded apps to ArborXR, have two options for assigning apps to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question.
  2. Tab over to Apps & Files.
  3. Click Add Apps.
  4. Select relevant apps and specify the version of the selected apps.
    • If you do not manually specify a version, the latest available version of the selected app(s) will be deployed to the group. For more information on version management see this article.
  5. Click Add to Group.
This modal will filter out apps already added to the group.
On clicking Add to Group, the app(s) will install on to the devices in the group the next time the devices come online and connect to ArborXR's servers.

Option 2: Content Library Page

  1. Navigate to the Apps page which is beneath Content Library in the side navigation menu.
  2. Select relevant apps and specify the version of the selected apps.
    • If you do not manually specify a version, the latest available version of the selected app(s) will be deployed to the group. For more information on version management see this article.
  3. Click Add to Group.
    • If you have multiple apps selected each with different device compatibility, select one of the device type options from the dropdown that appears on clicking Add to Group.
  4. Select the relevant group(s).
  5. Click Add.
On clicking Add, the app(s) will install on to the devices in the group the next time the devices come online and connect to ArborXR's servers.


Deploy Files to Devices in a Group

Once you have uploaded files to ArborXR, have two options for assigning files to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question via the side navigation menu.
  2. Tab over to Apps & Files.
  3. Click Add Files.
  4. Select relevant files.
  5. Click Add to Group.
This modal will filter out files already added to the group.
On clicking Add to Group, the file(s) will install on to the devices in the group the next time the devices come online and connect to ArborXR's servers.

Option 2: Content Library Page

  1. Navigate to the Files page which is beneath Content Library in the side navigation menu.
  2. Select relevant files.
  3. Click Add to Group.
  4. Select the relevant group(s).
  5. Click Add.

On clicking Add, the file(s) will install on to the devices in the group the next time the devices come online and connect to ArborXR's servers.


Track the Status of Content Deployments

The status of content deployments to a group of devices can be tracked in real time via the status column in the  Apps & Files tab of a device group. Hover over the status column to see the count of devices the app or file is pending to deploy to, actively installing on, or successfully installed on. Click View Details for even more information. 


Uninstall Apps from Devices in a Group

  1. Navigate to the group in question via the side navigation menu.
  2. Tab over to Apps & Files.
  3. Select the apps you wish to uninstall.
  4. Click Remove from Group.
On clicking Remove from Group, the app(s) will be uninstalled from the devices in the group the next time the devices come online and connect to ArborXR's servers.


Uninstall Files from Devices in a Group

  1. Navigate to the group in question via the side navigation menu.
  2. Tab over to Apps & Files.
  3. Select the file(s) you wish to uninstall.
  4. Click Remove from Group.

On clicking Remove from Group, the files(s) will be uninstalled from the devices in the group the next time the devices come online and connect to ArborXR's servers.


Configure ArborXR Home or Kiosk Mode

  1. Navigate to the device group in question.
  2. Tab over to Settings.
  3. Select Headset Experience from the sub navigation menu.
  4. Select between:
    1. ArborXR Home: ArborXR Home is ArborXR's VR launcher that locks down the device and prevents end users from accessing the device's home environment and stock settings. The apps and settings shown in ArborXR Home can be configured to ensure end-users only have access to what they need. Likewise, the background environment (360° image) can be customized so end-users have a branded experience within VR. For more information on the ArborXR Home, see this article
    2. Kiosk Mode: Kiosk mode allows only one app (the "kiosk app") to be launched upon powering on a device. This locks down the device and prevents end users from exiting the kiosk app and accessing other apps on the device. For more information on kiosk mode, see this article
    3. Device Home Environment: This is the device's default launcher (what you normally see when putting on the headset). While in this launch method, end-users have access to all apps and settings on this device.
  5. Click Apply Changes to apply to devices in the group. 
On clicking Apply Changes, the devices will be provisioned with the specified launch method configuration the next time they come online and connect to ArborXR's servers.


Enable/Disable Boundary (Pico only)

For Pico devices, the boundary can be remotely enabled or disabled via the ArborXR web portal. 

  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Headset Experience from the sub navigation menu. 
    1. Check the Boundary (Recommended) box to enable the boundary on devices.
    2. Uncheck the Boundary (Recommended) box to disable it on devices.
  4. Click Apply Changes to apply to devices in the group.
On clicking Apply Changes, the boundary configuration will be applied to devices the next time they come online and connect to ArborXR's servers.


Manage Date & Time and Language 

  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Headset Experience from the sub navigation menu. 
    1. Under Date & Time specify the desired time zone. 
    2. Under Language specify the desired language for the ArborXR Home app. 
  4. Click Apply Changes to apply to devices in the group.
On clicking Apply Changes, the specified Date & Time and Language will be applied to devices the next time they come online and connect to ArborXR's servers.


Manage Developer Options & USB File Transfer

For all device types, developer options & USB file transfer can be remotely enabled or disabled via the ArborXR web portal. 

  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Security from the sub navigation menu. 
    1. Uncheck the Developer Options box to disable developer options, or check to enable. 
    2. Uncheck the File Transfer via USB box to disable USB file transfer, or check to enable. 
  4. Click Apply Changes to apply to devices in the group.
On clicking Apply Changes, the specified configuration for  Developer Options and  File Transfer via USB will be applied to devices the next time they come online and connect to ArborXR's servers.


Provision Wi-Fi Configurations to Devices in a Group

ArborXR supports the configuration and remote deployment of open networks, WPA, as well as the personal and enterprise modes for both WPA2 and WPA3. For the enterprise modes various encryption protocols and authentication types are supported, including certificate-based authentication. For more information on supported Wi-Fi network configurations please see this article
  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Wi-Fi from the sub navigation menu.
  4. Click Add Configuration to open the Wi-Fi management modal.
    1. If you have configured Wi-Fi network(s) previously, those will show in the Library tab where you can select one or more listed Wi-Fi configurations then click Add.
    2. If you do not have Wi-Fi networks configured, or if you need to add a new one, tab over to Create New, enter your Wi-Fi network's details, then click Add. 

On clicking Add, devices will be provisioned with (and automatically connect to) the new network the next time they come online and connect to ArborXR's servers.


Have a suggestion or feature request? We'd love to hear!
Message ArborXR


Still need help? Contact Us Contact Us