Webview KioskDevice
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. 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. Brightness
Set the app window brightness from 0 (very dim) to 100 (very dark).
Use -1 to disable (i.e. the system default brightness will be used).
Default: -1
4. 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
5. 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
6. 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
7. 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
8. 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.
Default: (blank)
9. Custom Auth Password
Specify a custom password to protect your settings or when unlocking from the kiosk state.
For user-owned devices that utilises screen pinning, this will only work if you are using an unlock method provided by the app.
Device-level unpin methods (e.g. gestures/holding overview + back button simultaneously) will bypass this setting. To enhance security, please refer to the security documentation.
Leave this setting blank to use your device's biometrics or credentials.
Default: (blank)
10. 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
11. Device Owner
For more information about Device Owner, see the Security documentation.
11.1. Lock Task Features
Webview Kiosk The settings below are extracted from the official documentations:
| Feature | Description |
|---|---|
Show Home Button | Shows the Home button. Enable for custom launchers—tapping an enabled Home button has no action unless you allowlist the default Android launcher. LOCK_TASK_FEATURE_HOME |
Show Overview Button | Shows the Overview button (tapping this button opens the Recents screen). If you enable this button, you must also enable the Home button. LOCK_TASK_FEATURE_OVERVIEW |
Enable Global Actions | Enables the global actions dialog that shows when long-pressing the power button. The only feature that's enabled when setLockTaskFeatures() hasn't been called. A user typically can't power off the device if you disable this dialog. LOCK_TASK_FEATURE_GLOBAL_ACTIONS |
Enable Notifications | Enables notifications for all apps. This shows notification icons in the status bar, heads-up notifications, and the expandable notification shade. If you enable this button, you must also enable the Home button. Tapping notification actions and buttons that open new panels doesn't work in lock task mode. LOCK_TASK_FEATURE_NOTIFICATIONS |
Show System Info | Enables the status bar's system info area that contains indicators such as connectivity, battery, and sound and vibrate options. LOCK_TASK_FEATURE_SYSTEM_INFO |
Enable Keyguard | Enables any lock screen that might be set on the device. Typically not suitable for devices with public users such as information kiosks or digital signage. LOCK_TASK_FEATURE_KEYGUARD |
Block Activity Start in Task | Enable blocking of non-allowlisted activities from being started into a locked task. This requires Android 11 (API level 30). LOCK_TASK_FEATURE_BLOCK_ACTIVITY_START_IN_TASK |
11.2. Dhizuku
11.2.1. Request Permission on Launch
When enabled, if Dhizuku is installed and has not granted Webview Kiosk access to Device Owner privileges, prompt the user for permission.
Default: true