How to Understand Android Kiosk Mode: Difference between revisions

From wizarPOS
m (Simon moved page Demo for Kiosk Mode to How to Understand Android Kiosk Mode: Normalize the title)
No edit summary
Line 5: Line 5:
** '''Control Over App Lifecycle:''' Programmatically manage app operations, including auto-restarting apps upon exit and preventing users from switching to other apps.
** '''Control Over App Lifecycle:''' Programmatically manage app operations, including auto-restarting apps upon exit and preventing users from switching to other apps.
* '''Purpose of Kiosk Mode:''' Kiosk mode is instrumental in maintaining the security and controlled use of public devices, ensuring they operate within predefined limits.
* '''Purpose of Kiosk Mode:''' Kiosk mode is instrumental in maintaining the security and controlled use of public devices, ensuring they operate within predefined limits.
== Enabling Kiosk Mode ==
== Enabling Kiosk Mode below Android 12 ==
* '''Use of AIDL Interface:''' Android kiosk mode can be enabled through the Application Interface Definition Language (AIDL) provided by the system.
* '''Use of AIDL Interface:''' Android kiosk mode can be enabled through the Application Interface Definition Language (AIDL) provided by the system.
* '''Import Required Service:''' Utilize the ''''wizarviewagentassistant'''' service.
* '''Import Required Service:''' Utilize the ''''wizarviewagentassistant'''' service.
* '''Service Initialization:''' When initiating the service, use ''''com.wizarpos.wizarviewagentassistant'''' as the package name and ''''com.wizarpos.wizarviewagentassistant.SystemExtApiService'''' as the class name.
* '''Service Initialization:''' When initiating the service, use ''''com.wizarpos.wizarviewagentassistant'''' as the package name and ''''com.wizarpos.wizarviewagentassistant.SystemExtApiService'''' as the class name.
== Required Permissions ==
=== Required Permissions ===
The application declares the following permissions in the manifest:
The application declares the following permissions in the manifest:


   android.permission.MANAGE_ACTIVITY_STACKS
   android.permission.MANAGE_ACTIVITY_STACKS


== API Overview ==
=== API Overview ===
=== <big>startLockTaskMode</big>===
==== <big>startLockTaskMode</big>====
   <syntaxhighlight lang="java">boolean startLockTaskMode(int taskId);</syntaxhighlight>
   <syntaxhighlight lang="java">boolean startLockTaskMode(int taskId);</syntaxhighlight>
Request to put this activity in a mode where the user is locked to a restricted set of applications.
Request to put this activity in a mode where the user is locked to a restricted set of applications.
Line 30: Line 30:
|}
|}


== Download ==
=== Download ===
==== AIDL====
==== AIDL====
Please download the [http://ftp.wizarpos.com/advanceSDK/ISystemExtApi.aidl AIDL]
Please download the [http://ftp.wizarpos.com/advanceSDK/ISystemExtApi.aidl AIDL]
==== Demo ====
==== Demo ====
Please download the [http://ftp.wizarpos.com/advanceSDK/KioskDemo-One2Two.zip demo]
Please download the [http://ftp.wizarpos.com/advanceSDK/KioskDemo-One2Two.zip demo]
== Enabling Kiosk Mode in Android 12 ==
Please refero to [https://developer.android.com/work/dpc/dedicated-devices/lock-task-mode#java Lock task mode]

Revision as of 08:04, 19 January 2024

Overview of Android Kiosk Mode

Android kiosk mode is a specialized mode designed for public-use devices. It is commonly utilized in self-service kiosks, display devices, and similar applications in commercial and educational settings. In this mode, user access is limited to specific apps and features, and the ability to alter system settings or install new apps is restricted.

  • Key Features of Kiosk Mode:
    • Restricted User Behavior: You can limit actions like changing screen brightness, adjusting volume, accessing the notification bar, and using physical buttons.
    • Control Over App Lifecycle: Programmatically manage app operations, including auto-restarting apps upon exit and preventing users from switching to other apps.
  • Purpose of Kiosk Mode: Kiosk mode is instrumental in maintaining the security and controlled use of public devices, ensuring they operate within predefined limits.

Enabling Kiosk Mode below Android 12

  • Use of AIDL Interface: Android kiosk mode can be enabled through the Application Interface Definition Language (AIDL) provided by the system.
  • Import Required Service: Utilize the 'wizarviewagentassistant' service.
  • Service Initialization: When initiating the service, use 'com.wizarpos.wizarviewagentassistant' as the package name and 'com.wizarpos.wizarviewagentassistant.SystemExtApiService' as the class name.

Required Permissions

The application declares the following permissions in the manifest:

 android.permission.MANAGE_ACTIVITY_STACKS

API Overview

startLockTaskMode

boolean startLockTaskMode(int taskId);

Request to put this activity in a mode where the user is locked to a restricted set of applications.

Parameters
taskId int: task id.
Returns
boolean true:success ; false: failed;

Download

AIDL

Please download the AIDL

Demo

Please download the demo

Enabling Kiosk Mode in Android 12

Please refero to Lock task mode