Pasar al contenido principal
Volver a plugins
@capgo/capacitor-android-kiosk
Tutoriales
por github.com/Cap-go

Android Kiosk

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

Guía

Tutorial sobre 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é Esta Plugin Exposa

  • isInKioskMode - Verifica si la aplicación está actualmente ejecutándose en modo kiosk.
  • isSetAsLauncher - Verifica si la aplicación está configurada como lanzador de 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 lanzador de 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 de 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

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 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 de 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, Inicio para los detalles de implementación en Inicio, Resumen de API para los detalles de implementación en Resumen de API Introducción para los detalles de implementación en Introducción, y API Claves para los detalles de implementación en API Claves.