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 this week

Step 1: Set the Kiosk 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 Kiosk Experience tab.

  3. In the Headset Experience section, select ArborXR Home.


Step 2: Configure Visible Content

Under Visible Content, check the checkboxes next to content (apps, unmanaged apps, videos, or webXR links) to make them appear in ArborXR Home.

πŸ’‘ Content must be uploaded to your ArborXR Content Library and added to the group in question in order to appear in the Visible Apps section. See the following help articles for steps to upload content and add to groups:

If you use pre-installed or store downloaded apps and would like to display these apps in ArborXR Home, you will need to create Unmanaged Apps.

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


Step 3: Configure Language and Menu Title

Under Launcher Menu:

  • Set the desired Language for ArborXR Home. Supported languages include Chinese (Traditional), Dutch, English, French, German, Hindi, Italian, Japanese, Korean, Portuguese (Brazilian) and Spanish.

  • Set a custom Menu Title, which is shown in the header bar of ArborXR Home. By default this is set to Content.

  • Upload a custom Menu Icon, which is shown in the top left hand corner of the ArborXR Home UI. By default, your organization icon is set as the Menu Icon but this can be overridden on a per group basis.

  • ⚠️ Only available on the Enterprise plan: Display or hide ArborXR Branding. If displayed, the "powered by ArborXR" logo will appear in the bottom right hand corner of the ArborXR Home UI.


Step 4: Configure In-VR Shortcut Settings

Under Show Shortcuts, select the device settings users should have access to within ArborXR Home like Wi-Fi, Bluetooth, and casting.
​

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


Step 5: Configure Admin PIN

Under Admin PIN, optionally lock ArborXR Home's Advanced Settings menu with a 4 to 10 digit numeric PIN. You may want to lock the Advanced Settings menu with a PIN because it contains an option to temporarily exit ArborXR Home, allowing users to access the device home environment.

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


Step 6: Configure Tags to be Displayed as Filters in ArborXR Home

Under Categorize by Tags, 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.


Step 7: Customize Environment

Under Background, configure the background environment for ArborXR Home.

Option 1: ArborXR Lounge (Default)

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

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

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

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

  4. 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. Select 360Β° Background.
    ​

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

  3. 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. Navigate to the group in question and configure ArborXR Lounge 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.


Step 8: Customize the Colors of the ArborXR Home UI

Under Color Themes, customize the theme of ArborXR Home's UI with a template theme or with a custom theme by clicking Create New Theme.


Step 9: Configure Shared Mode Settings on Horizon Managed Services Devices

ArborXR offers controls to manage shared mode settings on devices updated to Horizon OS v78 and higher.

Term

Definition

Default Configuration in ArborXR

Identity

In shared mode "identity" refers to the requirement for users to log in with a managed Meta account. If you choose to require an account, anyone using the device will have to log in with a managed Meta account.

Disabled, meaning logging in with a managed Meta account is not required

Session Passcodes

Ask the user to create a passcode so they can continue their session after a break.

Disabled

Session Timeout

The configurable duration of inactivity after which a user's session automatically ends. Available options are 15, 30, 45, and 60 minutes.

60 minutes, representing the maximum allowed duration by Meta

Offline Mode

Users can start sessions without an internet connection.

Enabled

Controller Free

Enable hand tracking on the device. Users will not be prompted to manually enable hand tracking during the session introduction steps.

Disabled

Stationary Boundary by Default

The guardian will default to a stationary boundary that persists across sessions.

Disabled

Wake Controllers

Ask the user to confirm that controllers are connected.

Disabled

Adjust Device Fit

Guide the user through fitting the device properly.

Disabled

However, the following session introduction steps cannot be turned off:

Term

Definition

Acknowledge Safety

The user acknowledges health and safety warnings.

Agree to Terms of Service

The user agrees to the Terms of Service.


Step 10: Enforce Single Sign-On

In-VR SSO ensures that only authorized users can access the content installed on the device.

Once Single Sign-On has been configured for your organization, you can optionally enforce in-VR SSO by checking the Enable Single Sign-On checkbox. Click Configure Single Sign-On for steps to connect your identity provider.

If in-VR SSO is configured, upon powering on the device users will not be able to access ArborXR Home until they sign in with their corporate credentials.
​


Step 11: Save Changes

Scroll down and click Save.

Did this answer your question?