Device
Timeout, rotation, camera, microphone, location, unlock shortcut
1. Keep Screen On
Enable this option to keep your device awake (no screen timeout).
Useful if you have a kiosk application that should always remain active.
Default: false
2. Device Rotation
Select one of:
| Option | Orientation | Description |
|---|---|---|
| Auto | unspecified | No preference specified: let the system decide the best orientation. |
| 0° | portrait | Would like to have the screen in a portrait orientation: display taller than wide, ignoring sensor data. |
| 90° | landscape | Would like to have the screen in a landscape orientation: display wider than tall, ignoring sensor data. |
| 180° | reversePortrait | Would like to have the screen in portrait orientation, turned in the opposite direction from normal portrait. |
| 270° | reverseLandscape | Would like to have the screen in landscape orientation, turned in the opposite direction from normal landscape. |
For more details, refer to Android's official documentation for R.attr.screenOrientation.
Default: Auto
3. Allow Camera
Set to true to give WebView access to your device's camera.
You will need to grant the CAMERA permission, which is required for the WebView's RESOURCE_VIDEO_CAPTURE feature.
Default: false
4. Allow Microphone
Set to true to give WebView access to your device's microphone.
You will need to grant the RECORD_AUDIO permission, which is required for the WebView's RESOURCE_AUDIO_CAPTURE feature.
Default: false
5. Allow Location
When enabled, websites can request the device's location.
You can choose to request precise location (FINE) or approximate location (COARSE).
For more information, refer to location/permissions#accuracy.
You will need to grant either ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION, required for the WebView's GeolocationPermissions.
Default: false
6. Back Button Hold Action
Customise the behaviour when the back button is held down (long pressed).
| Option | Description |
|---|---|
OPEN_KIOSK_CONTROL_PANEL | See Web Browsing -> Kiosk Control Panel Region for more details. |
GO_HOME | Navigates to the Home Screen. |
DISABLED | Do nothing (ignore long-press). |
Default: Open Kiosk Control Panel
7. Custom Unlock Shortcut
Provide a custom keyboard shortcut using a modifier key (CTRL/SHIFT/ALT/META) in combination with another standard key to unlock/unpin the application.
For example, CTRL+1.
This is useful for devices with no navigation buttons on screen and instead has a physical keyboard connected.
Please note that the shortcut will only trigger when there is no app-specific dropdown/alerts opened (e.g. from floating toolbar, address bar or "go home" confirmation dialog from multitap).
Default: (blank)
8. Unlock Auth Requirement
This setting only applies to in-app unlock methods, e.g. when unlocking
using Kiosk Control Panel or Custom Unlock Shortcut.
| Option | Description |
|---|---|
| Default | Require authentication for lock task mode (device owner, fully-managed/company-owned devices), off for screen pinning (user-owned devices). |
| Off | Unlock without requiring authentication. |
| Require | Prompt for biometrics or device credentials when unlocking. |
For user-owned devices without lock task mode, the device will auto-lock when unpinning, which is outside the control of Webview Kiosk.
Default: Default