Fork of https://github.com/honza889/cordova-plugin-kiosk

Changes: Topbar is enabled. the wait for user to press button to start is set to 1ms Shutdown button work - Work in progress

Cordova Kiosk Mode

Cordova plugin to create Cordova application with "kiosk mode". App with this plugin can be set as Android launcher. If app starts as launcher, it blocks hardware buttons and statusbar, so the user cannot close the app until the app request it.

This plugin does not change behavior of application until it is set as launcher - home screen of the device.

Escape from app with this plugin is possible only using javascript call KioskPlugin.exitKiosk() or by uninstalling app using adb. (Keeping USB debug allowed recommended.) If applications starts as usual (not as launcher), no restrictions are applied.

• Official plugin website: https://github.com/honza889/cordova-plugin-kiosk
• Example app: https://github.com/honza889/cordova-kiosk-demo

Note for iOS: This plugin is for Android only for now. Support of iOS would be useless, because this feature is built in iOS as Guided Access (see Settings - General - Accessibility - Guided Access)

About

By adding this Cordova plugin the Cordova app becomes the the homescreen (also known as launcher) of Android device and will block any atempt of user to escape.

To add plugin into existing Cordova / Phonegap application:

cordova plugin add https://github.com/honza889/cordova-plugin-kiosk.git

The AndroidManifest.xml should be updated immediately. If not, you can force it by removing and re-adding Android platform:

cordova platform rm android
cordova platform add android

To it work user have to set this application as launcher (see below) and start it by pressing Home button/by restarting device.

WARNING Before installation ensure you have USB debug mode enabled. Without it you can have problem to remove app from device.

Exiting from Kiosk mode using Javascript:

KioskPlugin.exitKiosk();

If the app is running in kiosk mode can be detected too:

KioskPlugin.isInKiosk(function(isInKiosk){ ... });

By similar way it is possible to detect whether is application set as launcher:

KioskPlugin.isSetAsLauncher(function(isLauncher){ ... });

Current version allows also to set allowed key codes, so you app can enable volume up/down buttons for example:

KioskPlugin.setAllowedKeys([ 24, 25 ]);

For complete example see: https://github.com/honza889/cordova-kiosk-demo

Tips

• To remove this application use adb: (Do not install it without USB debug mode enabled!) (com.example.hello replace with package of your app from your config.xml)

    $ANDROID_HOME/platform-tools/adb uninstall com.example.hello
  

• To change launcher (reset setting which launcher is default):

• Alcatel: Settings - Applications - All - (This Application) / Launcher - Clear defaults, after Home press will be asked for default to set

• Xiaomi: Settings - Installed apps - Defaults - Launcher

• To disable screenlock: ("slide to unlock")

• Alcatel: Settings - Security - Set up screen lock - None

• Xiaomi: Settings - Additional settings - Developer options - Skip screen lock

"Application Error - The connection to the server was unsuccessful. (file:///android_asset/www/index.html)" occurred

• This can occur when Cordova's MainActivity is started too soon after system boot-up. Because this is native HomeActivity here - if you will see this error message, try increase delay in timer.schedule in HomeActivity.java.

• Another reason can be the index.html is missing.

• Another reason can be too long loading of index.html -- you can set timeout of Cordova's WebView in config.xml of application: (value is in milliseconds)

    <preference name="loadUrlTimeoutValue" value="60000" />