Skip to main content
Configure ArborXR Home

Steps to configure ArborXR Home on groups and individual ungrouped devices.

Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago

Set the Headset Experience to ArborXR Home

ArborXR Home can be configured on both groups and on individual ungrouped devices:

  1. Navigate to the group or individual ungrouped device in question.

  2. Select the Headset Experience tab.

  3. Select ArborXR Home.

  4. See the rest of the guide below to customize which content is selectable in-VR
    ​


Add Managed and Unmanaged Apps

Under Visible Content:

  1. Click on Managed Apps to expand the section then select the managed apps that users should have access to within ArborXR Home.
    ​


    πŸ’‘ If a group or individual ungrouped device has already been configured to ArborXR Home, any managed apps added after the fact will automatically be selected as visible content that users will see in ArborXR Home.


  2. Click on Unmanaged Apps to expand the section then select the unmanaged apps that users should have access to within ArborXR Home.
    ​


    πŸ’‘ If a group or individual ungrouped device has already been configured to ArborXR Home, any unmanaged apps added after the fact will automatically be selected as visible content that users will see in ArborXR Home. For more information about unmanaged apps, see this article.



Add WebXR Links

Under Visible Content, click on WebXR Links to expand the section then select the WebXR Link(s) that users should have access to within ArborXR Home.


πŸ’‘ If a group or individual ungrouped device has already been configured to ArborXR Home, any WebXR Links added after the fact will automatically be selected as visible content that users will see in ArborXR Home.



Add Videos

Under Visible Content, click on Videos to expand the section then select the Video(s) that users should have access to within ArborXR Home.
​


πŸ’‘ If a group or individual ungrouped device has already been configured to ArborXR Home, any Videos added after the fact will automatically be selected as visible content that users will see in ArborXR Home.



Configure In-VR Shortcut Settings

Under Settings, click Show Shortcuts to expand the section then select the settings users should have access to within ArborXR Home.
​


πŸ’‘ For more information about settings shortcuts, see this article.



Configure Admin PIN

Click Admin PIN to expand the section then optionally lock ArborXR Home's Advanced Settings menu with a 4 to 10 digit numeric PIN.
​


πŸ’‘ For more information about Advanced Settings, see this article.



Configure Filters

Click Filter by Tags to expand this section then optionally select the tags which you would like to use as filters in ArborXR Home.
​


πŸ’‘ For more information about filtering ArborXR Home by tags, see this article.



Customize Environment

Under Appearance click Background to expand the section.

Option 1: ArborXR Lounge (Default)

πŸ’‘ ArborXR Lounge is a warm and welcoming 3D space and is the default environment for ArborXR Home.

  1. Navigate to the group or individual ungrouped device in question.

  2. Select the Headset Experience tab.

  3. Select ArborXR Home.

  4. Under Appearance click Background to expand the section.

  5. Select ArborXR Lounge, if it is not already selected.
    ​

  6. Click Change Banner to upload a custom 1024 x 434px image to replace the default "ArborXR Home" banner.
    ​

  7. Select from one of the four skybox options.
    ​

  8. Scroll down and click Apply Changes.

Option 2: Custom 360Β° Image

πŸ’‘ Customize the ArborXR Home experience by using a custom 360Β° image as the background.

  1. Navigate to the group or individual ungrouped device in question.

  2. Select the Headset Experience tab.

  3. Select ArborXR Home.

  4. Under Appearance click Background to expand the section.

  5. Select 360Β° Background.
    ​

  6. Upload a custom 360Β° image to be used as the background environment for ArborXR Home. The maximum supported image file size is 200 MB.

  7. Scroll down and click Apply Changes.

Option 3: Custom 3D Environment (.gtlf or .glb)

πŸ’‘ Customize the ArborXR Home experience by using a custom 3D environment (.gtlf or .glb). This is in beta as we work towards fully productizing the feature.

🚩 Only available on the Essential and Enterprise Plans.

  1. Navigate to the Files page and upload the 3D environment .gltf or .glb file. Specify Android/obb/app.xrdm.launcher as the File Location. For more information about uploading files, see this article.
    ​

  2. Configure the device/group's Headset Experience to ArborXR Home with ArborXR Lounge configured as the background.
    ​

  3. Add the 3D environment .gltf or .glb to the device/group. For more information about adding files to groups, see this article.

πŸ’‘

  • Feel free to use ArborXR's 3D environment, ArborXR Lounge, as a template and customize it according to your needs. Download the template from GitHub.

  • Only install one .gltf or .glb file per group. If multiple .gltf or .glb files are assigned to the same group, the first file will be used as the custom environment.

  • Once the .gltf or .glb file has installed on devices in the group, it will automatically be used as the background environment in ArborXR Home and override the ArborXR Lounge environment.

  • ​Limitation: The ArborXR Home preview will not display the custom 3D environment.


Customize the Colors

Under the Appearance section, select Colors.

Option A: Select from Existing Template

Select the desired template then scroll down and click Apply.

Option B: Create Custom Template

Within the Colors section click Customize Colors. This will reveal the various elements of the in-VR UI that you're able to customize.

  1. Customize each of the six sections by entering the desired color hex or select the color square itself to expand it.

  2. You will notice a Contrast rating beneath some of these values. To ensure the comfort of your users, we've developed this color customization feature with Web Content Accessibility Guidelines (WCAG) in mind.

    1. Contrast: Low - We recommend increasing the contrast for accessibility purposes.

    2. Contrast: AA - Accompanied by a green checkmark, this is the best contrast ratio you can achieve.
      ​


      πŸ’‘ We will not prevent you from using colors combinations that do not meet WCAG. We only issue accessibility warnings.


  3. After you've customized your theme, you can click Apply your changes or Save this template for use on other devices and device groups.

    1. To Save a customized theme, select the πŸ’Ύ icon.

    2. A modal will appear and you will be given the option to name your theme.

    3. Once saved, your customized theme will be selectable in the Colors section anywhere within your organization.
      ​


      ⚠️ Up to two custom themes can be saved. They cannot be edited or deleted.



Configure Language and Menu Title

Click Launcher Menu to expand the section then:

  1. Configure the desired Language for ArborXR Home.
    ​


    πŸ’‘ Supported languages include Chinese (Traditional), Dutch, English, French, German, Hindi, Italian, Japanese, Korean, Portuguese (Brazilian) and Spanish.


  2. Enter a custom Menu Title to be shown in the header bar of ArborXR Home.


    πŸ’‘ The default menu title is "Content".


  3. Click Apply Changes.

Did this answer your question?