WLWebview Kiosk
Settings

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:

OptionOrientationDescription
AutounspecifiedNo preference specified: let the system decide the best orientation.
portraitWould like to have the screen in a portrait orientation: display taller than wide, ignoring sensor data.
90°landscapeWould like to have the screen in a landscape orientation: display wider than tall, ignoring sensor data.
180°reversePortraitWould like to have the screen in portrait orientation, turned in the opposite direction from normal portrait.
270°reverseLandscapeWould 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).

OptionDescription
OPEN_KIOSK_CONTROL_PANELSee Web Browsing -> Kiosk Control Panel Region for more details.
GO_HOMENavigates to the Home Screen.
DISABLEDDo 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.

OptionDescription
DefaultRequire authentication for lock task mode (device owner, fully-managed/company-owned devices), off for screen pinning (user-owned devices).
OffUnlock without requiring authentication.
RequirePrompt 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