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 2 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://kbremote.blob.core.windows.net/apk/current/com.procoit.kioskbrowser.apk">APK File</a></li> </ol> <p>Please see recent changes relating to <a href="https://help.android-kiosk.com/en/article/google-play-kiosk-browser-16i9l3k/">Google Play deployment</a>.</p> <p>||| <strong>v2.6.5</strong> is the last version supporting Android 4.0 - 4.3. The APK for 4.0 - 4.3 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="securitymodulekioskbrowsersamsungknoxdeprecateddownload">Security Module - Kiosk Browser (Samsung Knox) DEPRECATED - 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 2 installation methods:

Please see recent changes relating to Google Play deployment.

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

Kiosk Browser Provisioner - Download

Google Play APK File

Security Module - Kiosk Browser (Samsung Knox) DEPRECATED - 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.

||| Please note, when using the multi-tap method, you must tap a minimum of 4 times very quickly.

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 howeve

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

M3 Mobile Barcode Scanning Device Integration

Accepted Answer

Devices with built in barcode scanners are built for speed and reliability that no camera barcode scanner can match.

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

Devices Tested

M3 SM15

ScanEmul Application

The pre-installed ScanEmul 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 ScanEmul from the application drawer
Tap the DEFAULT profile
Enable Intent Ouput (tick box)
Make sure Intent action is set to com.android.server.scannerservice.broadcast

ScanEmul Application in App Drawer

![ScanEmul Application](https://storage.crisp.chat/users/helpdesk/website/99f4d12b-e989-4521-a5e7-35225f7de1e6/13dc0523-6ae5-4de5-a273-c

Frequently Read Articles

Browse All Categories