Pasar al contenido principal
Volver a plugins
@capgo/capacitor-android-kiosk
Tutorial
@capgo/capacitor-android-kiosk

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

Plugin de Android Kiosk de Capacitor para controlar el modo de kiosk y la funcionalidad del lanzador. Este plugin es solo para Android. Para el modo de 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á ejecutándose actualmente en modo de kiosk.
  • isSetAsLauncher - Verifica si la aplicación está configurada como el lanzador del dispositivo (aplicación de inicio).
  • enterKioskMode - Inicia el modo de kiosco, 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 del dispositivo para que esto funcione de manera efectiva.
  • exitKioskMode - Sale del modo de kiosco, 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().

Uso de Ejemplo

isInKioskMode

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

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 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 kiosco, 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 del dispositivo para que esto funcione de manera efectiva.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Sale del modo de kiosco, 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

If you are using Usando @capgo/capacitor-android-kiosk to plan dashboard and API operations, connect it with @capgo/capacitor-android-kiosk para obtener detalles de implementación en @capgo/capacitor-android-kiosk, Inicio para obtener detalles de implementación en Inicio, Resumen de API para obtener detalles de implementación en Resumen de API, Introducción para obtener detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Claves.