Saltar al contenido principal
Volver a plugins
@capgo/capacitor-android-kiosk
Tutoriales
@capgo/capacitor-android-kiosk

Módulo de modo kiosk de Android

Bloquear dispositivos Android en modo kiosk con funcionalidad de lanzador y control de teclas de hardware

Guía

Tutorial de Android Kiosk

Usando @capgo/capacitor-android-kiosk

Capacitor Plugin de Android Kiosk para el control del 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é se expone con este plugin?

  • isInKioskMode - Verifica si la aplicación está actualmente ejecutándose 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 del 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 kiosk, restaurando la interfaz de usuario del sistema normal y la funcionalidad de los botones del hardware. 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 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 lanzador de dispositivo (aplicación de inicio).

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

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

enterKioskMode

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

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

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

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

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

Referencia Completa

Sigue adelante desde Usando @capgo/capacitor-android-kiosk

Si estás utilizando Usando @capgo/capacitor-android-kiosk para planificar la consola de dashboard y las operaciones de API, conecta con @capgo/capacitor-android-kiosk para los detalles de implementación en @capgo/capacitor-android-kiosk, Getting Started para los detalles de implementación en Getting Started, API Resumen para los detalles de implementación en API Resumen, Introducción para los detalles de implementación en Introducción, y API Claves para los detalles de implementación en API Claves.