Kiosk (Single App) Mode on Android devices

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

Kiosk mode on Android devices has great usage in restaurants, retail stores, museums, amusement parks etc. They can be used as information kiosks or can be made interactive, which 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 in Single App mode.

Description

Single App Mode can be configured:

1. On Dashboard
2. 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

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.
6. 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. Configure gesture to exit Single App Mode: With this you can configure the gesture with which you can exit the Single App Mode. Select one option from the drop-down:
      
      You cannot configure gesture to exit Single App Mode if you have selected the option to run all the time. In that case, the setting Configure gesture to exit Single App Mode will be disabled.
      1. Swipe Toward the Center from the Bottom Left of the Screen
      2. Swipe Toward the Center from the Bottom Right of the Screen
      3. Swipe Toward the center from the Top Left of the screen
      4. Swipe Toward the center from the Top Right of the screen
      5. Display a Small Draggable Scalefusion Icon on the Screen: This places a small draggable Scalefusion Icon on the device screen which the end user can drag and place anywhere on the limit of the device screen. When user taps on the icon, the pop-up to Enter passcode opens where the user needs to enter the Scalefusion Exit Passcode as configured in the Android Device Profile where this device is enrolled.
         
         a. The setting Allow Floating Window should be enabled in Secure Settings (Device Profile > Restrictions > Device Settings)
         
         

         b. If Notification Center is also enabled in device profile then the draggable Scalefusion icon will not be visible on the device screen in SAM mode. Instead, settings icon will be available in notification center. To exit from Single App Mode, you need to click on Settings and enter exit passcode
   4. 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, for example, by pressing the app switch key. Ultimately depends on app behavior.
   5. 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).
7. After doing all the settings, click Next and then Update Profile. Your device will now run in Single App Mode.

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 the 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 the Dashboard, they will use this URL as the launch URL. For more details on overriding default URLs using custom fields, please click here.

No Device Profile is applied

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

1. On the Scalefusion Dashboard, navigate to Devices
2. From the list of registered devices, click on View Details over the device that 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 a single app, click on the Chrome browser's icon.
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 the 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 the delay value to launch the application (in seconds) and also launch the 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 to your Device
   • If you make any changes to default settings on the Dashboard, they will take precedence over settings done through the device.

Exit from Single App Mode

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

When SAM mode is set at the device level

1. Swipe from the left bottom corner of the device screen to the center of the screen diagonally.
2. You will get a prompt to enter the exit passcode. Enter the exit passcode and tap OK
3. You will get the Settings screen. Tap on Set Default Application.
4. The application that was set up in Single App mode will have a dot next to it. Tap on the Clear button at the bottom.
5. Note that the dot will be removed from the application, disabling the Single App Mode.
6. If you go back (through the back arrow on top), your device will no longer be in SAM mode.

When SAM mode is set from the 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.