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. Google Play 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

Question 1

Provisioning Devices

Accepted Answer

|| Please note Android 9.0 is supported in v2.7.1 (build 251) and up 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

Samsung specific features can be configured with our Security Module for Samsung Devices, however the only additional feature offered is full device screenshots (unless running low

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. Google Play 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

Granting Permissions (Android 6.0 and up)

Accepted Answer

When launching Kiosk Browser for the first time on Android 6.0 you will be prompted to grant a number of permissions. Whilst this goes against the standard guidance we feel it's best to ask once in a Kiosk environment otherwise your end users may see permission prompts. You can also access this screen via Settings > About > Permissions.

For example, if you wish to use the Barcode Scanner, Kiosk Browser requires permission to use the camera, if this permission is denied then the barcode scanner will not work.

These permissions can be denied within Android Settings > Apps > Kiosk Browser > Permissions, however doing this will will cause the above functions to fail.

Permissions Management Screen

There are two further specific permission we request one of which is called Draw over other apps, this allows us to block access to the notification bar. As above you will be prompted to enable this on first launch however the setting can be found in Android Settings > Apps > Gear Icon > Draw over other apps > Kiosk Browser.

The second is called **Modify sy

Frequently Read Articles

Browse All Categories