Android Kiosk

Usando @capgo/capacitor-android-kiosk

Capacitor Plugin de Android Kiosk para controlar el modo kiosk y la funcionalidad del lanzador. Este plugin es solo para Android. Para el modo kiosk de iOS, utilice la función de Acceso Guiado del dispositivo.

Instalar

bun add @capgo/capacitor-android-kiosk
bunx cap sync

¿Qué Este Plugin Exposa?

• isInKioskMode - Verifica si la aplicación está ejecutándose actualmente en modo kiosk.
• isSetAsLauncher - Verifica si la aplicación está configurada como el lanzador del dispositivo (aplicación de inicio).
• enterKioskMode - Inicia el modo kiosk, ocultando la interfaz de usuario del sistema y bloqueando los botones de hardware. También inicia un servicio de mantenimiento de primer plano para que la aplicación sea menos probable que sea eliminada por el sistema. La aplicación debe estar configurada como el lanzador del dispositivo para que esto funcione de manera efectiva.
• exitKioskMode - Sale del modo de kiosk, restaurando la interfaz de usuario y la funcionalidad de los botones de hardware a su estado normal. También detiene el servicio de mantenimiento de primer plano iniciado en enterKioskMode().

Ejemplo de uso

isInKioskMode

Verifica si la aplicación está actualmente ejecutándose en modo de kiosk.

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);

isSetAsLauncher

Verifica si la aplicación está configurada como la aplicación de arranque del dispositivo (aplicación de inicio).

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);

enterKioskMode

Inicia el modo de kiosk, ocultando la interfaz de usuario y bloqueando los botones de hardware. También inicia un servicio de mantenimiento de primer plano para que la aplicación sea menos probable que sea eliminada por el sistema. La aplicación debe estar configurada como la aplicación de arranque del dispositivo para que esto funcione de manera efectiva.

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Sale del modo de kiosk, restaurando la interfaz de usuario y la funcionalidad de los botones de hardware a su estado normal. También detiene el servicio de mantenimiento de primer plano iniciado en enterKioskMode().

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

Referencia completa

• GitHub: https://github.com/Cap-go/capacitor-android-kiosk/
• Documentación: /docs/plugins/android-kiosk/