KB: Full Screen Mode & Hiding the Toolbar
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 > HidePopularKB: Screensaver
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.
(https://storage.crisp.chat/users/helpdesk/website/99f4d12b-e989-4521PopularKB: Camera Barcode Scanning
Kiosk Browser uses the ZXing barcode scanning library which is an open source software suite for reading bar codes from various sources. It is licensed under the Apache License v2.0.
There are multiple ways to use the barcode scanner.
Barcode Scanning Keyboard
We have worked with the creators of a barcode scanning keyboard to provide a working solution to enable you to scan barcode data directly intoSome readersKB: PDF Support
Kiosk Browser includes PDF support (v2.5.9 and up) by utilising the JavaScript library PDF.js. PDFs can be loaded either from a local file or remote web server, for example any of the following would work:Some readersKB: App Drawer
In certain scenarios you may wish to provide easy access to a small number of applications already installed on the device, this is where the app drawer feature is useful. It provides a bottom drawer where the end user can tap an app icon from a predefined list.
Enable App Drawer
In order to use the app drawer it first must be enabled under Settings >Some readersKB: Printing via Bluetooth
From version 2.0.31 its possible to print directly to bluetooth printers via JavaScript using a native printer language such as ESC/POS.
If you are looking to print via Google Cloud Print please see this article.
You must first pair the bluetooth printer in Android settings and define it as the default within Settings Bluetooth.
(https://storage.crisp.chat/users/helpdesk/website/f891df320cad6Some readersKB: Automatic Page Reload Options
Enabling Automatic Page Reloads
The Idle Page Timeout setting allows you to force the home page URL to be reloaded after a set period of time, when the device is idle.
This option can be found under Settings General Idle Page Timeout.
Upon enabling this Idle Page Timeout, you should also select the timeout duration in the next menu Settings GeneSome readersKiosk Browser - Automatic Configuration JSON
The automatic config feature in Kiosk Browser allows you to specify a Url (Settings Advanced) where Kiosk Browser will check for config changes every 15 mins. For example https://www.android-kiosk.com/kbconfig.json This allows you to keep your devices configured consistently but also allows you to easily make changes.
The below list of properties is a complete list of all configuration properties. They are all optional, if you do not include a specific property, the default setting from KioskSome readersKB: Toolbar Buttons & Their Functions
In order to customise the user experience within Kiosk Browser, you can ensure that only the relevant buttons are displayed on the toolbar.
All buttons can be added and removed within the Settings Toolbar menu as below.
App Icon (enabled by default)
(https://storage.crisp.chat/users/helpdesk/website/99f4d12b-e989-4521-a5e7-35225f7de1e6/6322844fSome readersKB: Custom Error & Access Denied Pages
Custom Error Page
By default when a page cannot be displayed (such as loss of internet connection) Kiosk Browser will automatically show the built in error page. In most scenarios this page is not user friendly (see example below).
To enable your own custom error page, place your HTML page in kioskbrowser/errorpage/ as per our storage article and ensure the file is named index.htm. Enable Custom Error PageFew readersKB: Standalone Mode
Standalone Mode
By default Kiosk Browser behaves like a launcher, this means you can set it as the default and the user cannot exit the launcher without entering a password. This is ideal for environments where you wish to lock down the entire tablet interface, but what if you wish to just lock down the contents and behaviour of the browser for a very specific requirement? This is where Standalone Mode comes in.
You can enable by going to Settings Advanced Standalone Mode.
WheFew readersKB: NFC
From version 2.0.16 and up it's now possible to use NFC to scan tags containing a URL (NDEF).
By default it is turned off. You can turn NFC on under Settings Hardware NFC.
When scanning a tag, only http://, https:// and file:// prefixes are supported, all other tags will display a warning "tag not supported". All URLs will be checked to see if they are permitted in the whitelist (if enabled).
To write a URL to an NFC tag we recommend using NFC Tools on Google Play (htFew readersKB: Bookmarks Bar
In certain scenarios you may wish to provide easy access to a number of websites as well as the default homepage, this is where the bookmarks feature is useful. It provides a side menu where the end user can tap a website from a predefined list of websites. The bookmarks bar is automatically closed if still open after 40 seconds.
Setup Bookmarks
There are two settings to control how websites appear in the list of bookmarks. The first is Settings Toolbar Bookmarks. ThisFew readersKB: XML Import & Export
XML Import is incredibly useful if you wish to bulk provision a large number of devices where the configuration of each device needs to be identical. Note Remote Management can also configure large numbers of devices via configuration profiles but it has a number of requirements such as Google Play services and an active internet connection.Few readersKB: File/Camera Uploads
File and Camera Uploads
It is possible to capture an image from the camera and upload this via a file input tag.
All you need to do is create your webform and include an input with the type "file".
Please note the "accept=" filter is currently not supported.Few readers