How to Understand Android Kiosk Mode: Difference between revisions

From wizarPOS
No edit summary
No edit summary
Line 1: Line 1:
== Android kiosk mode instruction ==
== Overview of Android Kiosk Mode ==
Android kiosk mode is a special mode in which users can only access specific apps or features and cannot change system settings or install other apps freely. This mode is commonly used in public devices such as self-service kiosks, display devices, etc. in commercial and educational environments.
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 ==
* '''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:


In Android kiosk mode, you can restrict user behavior, such as prohibiting changes to screen brightness, volume adjustment, accessing notification bars, disabling physical buttons, etc. In addition, you can also programmatically control the lifecycle of apps, such as restarting apps automatically when they exit, preventing users from switching to other apps.
In summary, Android kiosk mode helps you better manage and control public devices, ensuring they remain in a secure and controllable state.
== Enable Android kiosk mode ==
To enable Android kiosk mode, you can use AIDL interface provided by the system. To use this interface, import wizarviewagentassistant. When starting the service, pass com.wizarpos.wizarviewagentassistant as the package name and com.wizarpos.wizarviewagentassistant.SystemExtApiService as the class name.
=== Permission ===
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 20: Line 24:
|-
|-
| taskId|| '''int:''' task id.
| taskId|| '''int:''' task id.
|}
{|
|-
|}
{|class="wizarpostable"
|-
|-
!  scope="row" colspan="2" | Returns
!  scope="row" colspan="2" | Returns
Line 32: 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]

Revision as of 17:16, 9 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

  • 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