Skip to main content

Configure ArborXR Kiosk Mode

Steps to configure Kiosk Mode on groups and individual ungrouped devices.

Josh Franzen avatar
Written by Josh Franzen
Updated over 2 weeks ago

Step 1: Set the Kiosk Experience to Kiosk Mode

ArborXR Kiosk Mode 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 Kiosk Mode.


Step 2: Designate the Kiosk App

Under Visible Content, designate a single managed app or unmanaged app as the kiosk app.

πŸ’‘ Apps 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 apps and add to groups:

If you use pre-installed or store downloaded apps and would like to designate one of these apps as the kiosk app, you will need to create Unmanaged Apps.


Step 3: Configure Quick Access Menu

πŸ’‘ ArborXR Kiosk Mode comes with a quick access menu that opens on pressing the home button. The quick access menu provides quick access to device settings along with the option to restart the kiosk app. However, ArborXR's quick access menu is only supported non-Meta Horizon managed services devices. See this help article to learn more about home button behavior in ArborXR Kiosk Mode.

Under Quick Access Menu:

  • Enable or disable ArborXR's quick access menu, which opens upon pressing the home button and pauses the kiosk app, by toggling Open with Home button on or off.
    ​


    ⚠️ If you toggle off ArborXR's quick access menu, the remainder of this article is not relevant as it is about configuring various aspects of the quick access 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.

  • ⚠️ 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's quick access menu 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 Kiosk Mode'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 Kiosk Mode, allowing users to access the device home environment.

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


Step 6: Customize Environment

Under Background, configure the background environment for ArborXR's quick access menu.

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 7: 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 8: 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

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.

Enable Hand and Body Tracking

The user is asked whether to enable hand and body tracking and acknowledge privacy policy. ⚠️ This is required since ArborXR Home supports hand tracking as the default fallback input method.


Step 9: Save Changes

Scroll down and click Save.

Did this answer your question?