Kiosk (Single App) Mode on Android devices

With Scalefusion's Single App Mode feature you can lockdown your Android device and turn it into Kiosk mode. Kiosk Mode means to set an app as default and make it run all time on the Android device. 

Kiosk mode on Android devices has a great usage in restaurants, retail stores, museums, amusement parks etc. They can be used as information kiosks or can be made interactive that helps in providing important information to customers. However, you need to perform some settings to lock down your device in kiosk mode.

This document describes how you can set up your Android device to run into Single App mode.

Before You Begin

  1. You must have a valid Scalefusion dashboard account.

Description

Single App Mode can be configured:

  • On Dashboard
  • On Device

On Dashboard

The devices can be in two different states, one on which device profile is applied and another on which no device profile is applied. Single app mode can be configured through Dashboard in both cases.

Device Profile is applied

In Device Profile settings, Scalefusion should be set as Launcher
  1. Navigate to Device Profiles & Policies > Device Profile.
  2. Select the Android device profile on which you need to set the application in Single App Mode.
  3. Click on Edit Device Profile
  4. In the Device Profile Settings window, go to KIOSK/LAUNCHER SETTINGS -> SINGLE APP MODE
  5. In the Set a Default Application to run always drop-down, choose an application from the list of enabled applications that will be set to run as the default app.
This drop-down lists all the apps you enabled in the Select Apps section

  1. Once you select the app, you can do the following settings:
    1. Run All the Time: Select this checkbox to set the app to run all the time. By default, the app is set to run all the time.
    2. Enter delay to launch the app (in seconds): If you do not want the app to run all the time, you can even set delay time (in seconds) after which the app will launch. To set a delay time, uncheck the Run All the time checkbox and enter the delay value (in seconds).
    3. Retain application state when an app is relaunched: Select this option to retain the application state when it is relaunched due to an invariant user action that causes a blocked app to be opened like for example pressing the app switch key. Ultimately depends on app behavior.
    4. Show Update in Progress screen: Enabling this will show the update's progress screen whenever the default app is being updated. This option can be enabled only when you make the default app Run All the Time (the Run All the time checkbox is checked).
Google Chrome or Scalefusion Browser

If you have selected Google Chrome or Scalefusion Browser to run as default, you can do the following settings:

  • Run All the Time: Either select this checkbox to set the app to run all the time or set a delay time after which the app will start running
  • Enter Auto Refresh Interval: Set the time interval after which the page should automatically refresh.
  • Specify the Default Launch URL: Specify a URL that will be used as the launch page when the browser opens.
  • Override with Device Custom Property: If you have defined a custom field and want to apply that at device level, select this checkbox and choose the property (defined in custom fields) you want to use. For all the devices where the value for the field you have selected is set on Dashboard, they will use this URL as the launch URL. For more details on overriding default URL using custom fields, please click here.
  1. After doing all the settings, click Next and then Update Profile.

Your device will now run in Single App Mode.

No Device Profile is applied

The devices on which no device profile is applied, they can also be set in Single App mode. To do so, follow these steps:

  1. On Scalefusion Dashboard, navigate to Devices
  2. From the list of registered devices, click on View Details over the device which you want to set in Single App mode.
  3. This opens the device's details page. Here, in the Device view click on the app's icon (that has to be set in Single App Mode). For example, to set Chrome Browser to run as single app, click on the Chrome browser's icon.
    If any app is not available in the device view, you can publish it from the Play for Work Apps section on the Scalefusion dashboard (if your device is EMM managed).
  4. Once you click the icon, you will see three options on the right side - Enable Application, Hide App Icon, and Set Default.
  5. Toggle on Set Default.
  6. As soon as you toggle it on, you can do the following additional settings:
    1. Run All the Time: Toggle on this setting if you want the selected app to run all the time. If not, you can set a delay time after which the app will start running. By default, the app is set to run all the time. To set a delay time, toggle off the Run All the time option and enter the delay value (in seconds).
    2. Default URL: Specify a URL that will be used as the launch page when the browser opens. The URL that you enter here, gets automatically added to the list of Allowed Websites under Device Profiles & Policies -> Allowed Websites
    3. Refresh Browser: If you want the browser to refresh automatically, enable this setting and set the time interval after which the page should automatically refresh.
Default URL and Refresh Browser settings come up only when you select Scalefusion browser or Google Chrome to run as default apps.

After doing all the settings, click Apply.

Your device will have the Chrome browser running in single-app mode with the required URL (for example https://www.google.com/) as the default launch URL.

On Device

  1. Launch Scalefusion app on your device
  2. Tap on three vertical dots on the top right and then on Settings
  3. In Settings, tap on Set Default Application
  4. Next, from the list of applications, tap on the application that you want to run in single app mode (For eg. Google Chrome)
  5. Once you select Chrome (or any app) you will be asked to enter delay value to launch the application (in seconds) and also launch URL. Enter both and tap Ok
  6. You will see Chrome selected with a dot next to it. Tap Save

Your device would successfully be set with Google Chrome running in Single App mode. Similarly you can set any other app in Single App mode.

If you are configuring Single App mode via your device, please ensure:

- No Device Profile is applied tn your Device
- If you make any changes to default settings on Dashboard, they will take precedence over settings done through the device.

Exit from Single App Mode

If a device setup in Single App Mode (SAM), you can exit from it on the device by following these steps:

When SAM mode is setup at the device level

  1. Swipe from the left bottom corner of the device screen to the center of the screen diagonally.

  1. You will get a prompt to enter the exit passcode. Enter the exit passcode and tap OK

  1. You will get the Settings screen. Tap on Set Default Application.

  1. The application which was set up in Single App mode will have a dot next to it. Tap on Clear button at the bottom.

  1. Note that the dot will be removed from the application, disabling the Single App Mode.

  1. If you go back (through back arrow on top), your device will no longer be in SAM mode.

When SAM mode is setup from Device Profile

If SAM is set up at the device profile level, then after providing the exit password, tap on Exit Scalefusion on the Settings screen. This unlocks your device.


How did we do?


Powered by HelpDocs (opens in a new tab)