Question 1

KB: 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: KB: Installing

<p>There are three installation methods:</p> <ol> <li>Provisioning (most secure and feature rich), please see the <a href="/en/article/provisioning-devices-1kgrrg5/">provisioning article</a>.</li> <li><a href="https://play.google.com/store/apps/details?id=com.procoit.kioskbrowser">Google Play</a></li> <li><a href="https://kbremote.blob.core.windows.net/apk/current/com.procoit.kioskbrowser.apk">APK File</a></li> </ol> <p>||| <strong>v2.6.5</strong> is the last version supporting Android 4.0 - 4.3. The APK can be found <a href="https://kbremote.blob.core.windows.net/apk/archive/2.6.5_213.apk">here</a>.</p> <h6 id="kioskbrowserprovisionerdownload">Kiosk Browser Provisioner - Download</h6> <p><a href="https://play.google.com/store/apps/details?id=com.procoit.kioskbrowserprovisioner">Google Play</a> <a href="https://kbremote.blob.core.windows.net/apk/current/com.procoit.kioskbrowserprovisioner.apk">APK File</a></p> <h6 id="securitymodulekioskbrowsersamsungknoxdownload">Security Module - Kiosk Browser (Samsung Knox) - Download</h6> <p>We recommend provisioning rather than using the Security Module. <a href="https://kbremote.blob.core.windows.net:443/apk/current/com.procoit.kioskbrowsersec.apk">APK File</a></p>

The QR code method was introduced in Android 7

Question 2

KB: 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 3

JS: Device Information

Accepted Answer

Device Information

Please note most functions apply to both Kiosk Browser and Launcher but some are specific the individual product.

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

```

Get C

Question 4

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 screen 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 se

Question 5

KB: 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 6

Zebra TC Series Integration (Barcode Scanner)

Accepted Answer

Zebra TC devices such as the TC20/TC25, TC51 & TC70 are built for enterprise and industrial use. They have built in barcode scanners for speed and reliability that no camera barcode scanner can match.

We have worked with a number of Zebra TC devices to ensure that Kiosk Browser & Kiosk Launcher integrate with the barcode scanner in the best way possible.

Zebra DataWedge Application

The Zebra DataWedge application sends barcode scan results in the form of keyboard input (HID) by default, so if Kiosk Browser/Launcher has focus on a textbox within your web application the barcode result will automatically be entered into that field. However there are scenarios where you may want to receive the results of scans differently or receive the data of multiple scans. To send the results directly to Kiosk Browser/Launcher follow the steps below:

Open DataWedge application
Tap Profile0 (default)
Scroll down to Keystroke output and untick Enabled
Scroll down to Intent output and tick Enabled
In the Intent action field type in com.procoit.kioskbrowser.BARCODESCANEVENT OR com.procoit.kiosklauncher.BARCODESCANEVENT
Make sure that Intent delivery is set to Send via startService

Zebra Data Wedge Application

Frequently Read Articles

Browse All Categories