Question 1

Provisioning Devices

Accepted Answer

When provisioning a device using our provisioning app your device is locked down in the most secure way possible. Kiosk Browser becomes the "device owner" meaning that it is granted more permissions vs a standard Kiosk Browser installation.

Key Features:

Streamlined setup process (embed licence keys or remote management registration key)
Automatically grant majority of permissions
Set the default launcher programmatically without user intervention
Hide home button and recents button/block access to home and recents hardware buttons (Android 6.0 or higher)
Block access to the status bar (top of the screen) using official methods, rather than workaround
Update applications (Update Manager via remote management) or via our JavaScript interface, Android 6.0 or higher
Reboot device on schedule (Android 7.0 or higher)
Disable lock screen programatically
Block launching of applications not in app drawer (apps launched from JavaScript unaffected)
Disable booting into safe mode (Android 6.0 or higher)
Prevents Kiosk Browser from being uninstalled without factory reset

Android 6.0 or higher supported To start the provisioning process your device (the target device you want to install Kiosk Browser on) either needs to be brand new out of the box or factory reset.

Method 1. QR Code (Android 7.0 or higher)

Q: JS: Device Information

Device Information JavaScript Functions | You can find the JavaScript test page at https://www.android-kiosk.com/jstest.htm Just set this as the Kiosk URL on your device to test the functions. Get WiFi SSID Returns WIFI SSID, requires version 1.42 or higher. <script> //GET WIFI SSID function getWIFISSID() { return Android.getWIFISSID(); } </script> <a href="javascript:console.log(getWIFISSID());">Get WiFi SSID</a> Get IP Address Returns IP address of WiFi adapter, requires version 2.0.6 or higher. <script> //GET IP ADDRESS function getIPAddress() { return Android.getIPAddress(); } </script> <a href="javascript:console.log(getIPAddress());">Get IP Address</a> Get Device Battery Level Returns device battery percentage, requires version 1.42 or higher. <script> //RETRIEVES CURRENT BATTERY LEVEL & DISPLAYS IN TOAST function getDeviceBatteryLevel() { return Android.getBatteryLevel(); } </script> <a href="javascript:console.log(getDeviceBatteryLevel());">Get Device Battery Level</a> Get Charging State Returns charging state (true or false), requires version 2.0.34 or higher. <script> //GET CHARGING STATE function isCharging() { return Android.isCharging(); } </script> <a href="javascript:console.log(isCharging());">Get Charging State</a><br/> Get MAC Address Returns device MAC address (normally WiFi), requires version 1.42 or higher. Please note that the MAC address and IMEI can no longer be read from

Q: Installing

There are three installation methods: Provisioner App (most secure and feature rich), please see the provisioning article . Google Play APK File ||| v2.6.5 is the last version supporting Android 4.0 - 4.3. The APK can be found here . Kiosk Browser Provisioner - Download Google Play APK File Security Module - Kiosk Browser (Samsung Knox) - Download We recommend provisioning rather than using the Security Module. APK File

Q: How do I exit/access settings?

There are two methods for exiting/accessing settings. Method 1 Either press the hardware menu button or menu button in the top right hand corner of the screen, tap Settings and then tap "Exit to Launcher/Exit" button. Enter the default password of 0000 (zero zero zero zero) and tap OK . If you have hidden the toolbar, by default you can automatically show the toolbar again by swiping down from the top edge of the screen. If you have turned the swipe option off please see Method 2 . Method 2 Tap anywhere within the webpage 4 times in quick succession to open the password dialog. Enter the default password of 0000 (zero zero zero zero) and tap OK . Go to Admin > Exit to Launcher . Potential Issues (exit not working) Some device manufacturers prevent switching of launchers programmatically which means the standard "Exit to launcher" function does not work. Device manufacturers known to have this issue are Xiaomi & Huawei however some users have reported issues with Lenovo & Acer devices. To work around this, open Kiosk Browser s

The QR code method was introduced in Android 7

Question 2

JS: Device Information

Accepted Answer

Device Information JavaScript Functions

| You can find the JavaScript test page at https://www.android-kiosk.com/jstest.htm Just set this as the Kiosk URL on your device to test the functions.

Get WiFi SSID

Returns WIFI SSID, requires version 1.42 or higher.


Get WiFi SSID

Get IP Address

Returns IP address of WiFi adapter, requires version 2.0.6 or higher.


Get IP Address

Get Device Battery Level

Returns device battery percentage, requires version 1.42 or higher.


Get Device Battery Level

Get Charging State

Returns charging state (true or false), requires version 2.0.34 or higher.


Get Charging State

Get MAC Address

Returns device MAC address (normally WiFi), requires version 1.42 or higher. Please note that the MAC address and IMEI can no longer be read from

Question 3

Installing

Accepted Answer

There are three installation methods:

||| v2.6.5 is the last version supporting Android 4.0 - 4.3. The APK can be found here.

Kiosk Browser Provisioner - Download

Google Play APK File

Security Module - Kiosk Browser (Samsung Knox) - Download

We recommend provisioning rather than using the Security Module. APK File

Question 4

Full Screen Mode & Hiding the Toolbar

Accepted Answer

**View content in full screen mode, removing the Navigation Bar and the Toolbar. **

Full Screen Mode
If you have an Android 4.4 device or higher you can hide the bottom bar (known as the Navigation or System Bar) using the full screen setting - Settings > Display > Full Screen Mode, which is known as immersive mode (image 1 below).

If your device is running Android 4.3 or lower you can only remove the system bar if your device is rooted via Settings > Root Features > Hide System Bar.

System Bar shown below displays the back, home and recent items menu buttons.

Same page shown below with System Bar removed, allowing more page content to be displayed on the device.

|| Note: that the system bar / navigation bar cannot be permanently hidden and will always reappear on swipe up. This is a feature by design (in Android), and cannot be changed.

Hiding the Toolbar The Toolbar can also be hidden, which will prevent access to Kiosk Browser settings unless swipe down is enabled. If swipe down is disabled, then settings can be accessed by via

Question 5

How do I exit/access settings?

Accepted Answer

There are two methods for exiting/accessing settings.

Method 1
Either press the hardware menu button or menu button in the top right hand corner of the screen, tap Settings and then tap "Exit to Launcher/Exit" button. Enter the default password of 0000 (zero zero zero zero) and tap OK.

If you have hidden the toolbar, by default you can automatically show the toolbar again by swiping down from the top edge of the screen. If you have turned the swipe option off please see Method 2.

Method 2 Tap anywhere within the webpage 4 times in quick succession to open the password dialog. Enter the default password of 0000 (zero zero zero zero) and tap OK. Go to Admin > Exit to Launcher.

Potential Issues (exit not working) Some device manufacturers prevent switching of launchers programmatically which means the standard "Exit to launcher" function does not work. Device manufacturers known to have this issue are Xiaomi & Huawei however some users have reported issues with Lenovo & Acer devices. To work around this, open Kiosk Browser s

Question 6

Screensaver

Accepted Answer

There are three types of screensaver that can be used within Kiosk Browser. The screensaver function is activated when the device has been idle for a specified amount of time (default is 5 minutes).

To enable, go to Settings > Display > tick Screensaver. To change the timeout from the default tap "Screensaver Timeout" and select the timeout you require.

To select the screensaver type tap Screensaver Type.

Image This plays a slideshow of images (JPG/PNG) stored in the screensaver folder. By default the image will change every 45 seconds. To change the default just tap Slide Delay and select the value you require. By default images will display in the order they are stored on the filesystem i.e. 1.jpg, 2.jpg, 3.jpg etc… If you wish to randomise order images are displayed use the setting Randomise Screensaver Images.

You will need to use a file manager/explorer in order to place images in the relevant directory.

Video This plays one video file on loop, it supports either MKV or MP4 formats. Place a file named kioskvideo.mp4 or kioskvideo.mkv in the screensaver folder. If your video file isn't looping please see [this](https://help.android-kiosk.c

Frequently Read Articles

Browse All Categories