Saltar al contenido

@capgo/capacitor-android-kiosk

Fija dispositivos Android a una sola app con el modo kiosk y el control del launcher.

@capgo/capacitor-android-kiosk Bloquea las tablets de la flota en una única experiencia de Capacitor mediante modo kiosk, fijación del launcher y políticas de teclas de hardware.

PlataformaSoporteNotas
iOSNoEnfocado en Android
AndroidSíAprovisionamiento de Device owner según el README
WebNoNo aplicable
  • isInKioskMode - Comprueba si la app se está ejecutando actualmente en modo kiosco.
  • isSetAsLauncher - Comprueba si la app está configurada como launcher del dispositivo (app de inicio).
  • enterKioskMode - Entra en modo kiosco, ocultando la UI del sistema y bloqueando los botones físicos. También inicia un servicio keep-alive en primer plano para reducir la probabilidad de que el sistema cierre la app. Para que esto funcione bien, la app debe estar configurada como launcher del dispositivo.
  • exitKioskMode - Sale del modo kiosk, restaurando la interfaz del sistema y la funcionalidad de los botones físicos. También detiene el servicio keep-alive en primer plano iniciado en enterKioskMode().
MétodoDescripción
isInKioskModeComprueba si la app se está ejecutando en modo kiosco.
isSetAsLauncherComprueba si la app está configurada como launcher del dispositivo (app de inicio).
enterKioskModeEntra en modo kiosco, oculta la UI del sistema y bloquea los botones físicos. También inicia un servicio keep-alive en primer plano para que el sistema tenga menos probabilidades de cerrar la app. Para que funcione bien, la app debe estar configurada como launcher del dispositivo.
exitKioskModeSale del modo kiosco, restaura la UI del sistema y la funcionalidad de los botones físicos. También detiene el servicio keep-alive en primer plano iniciado en enterKioskMode().
setAsLauncherAbre la configuración de pantalla de inicio del dispositivo para que el usuario establezca esta app como launcher. Es necesario para la funcionalidad completa del modo kiosk.
setAllowedKeysDefine qué teclas físicas pueden funcionar en modo kiosco. Por defecto, todas las teclas físicas están bloqueadas en modo kiosco.
getPluginVersionObtén la versión del plugin nativo Capacitor.

Esta referencia se sincroniza desde src/definitions.ts en capacitor-android-kiosk.

Si estás usando @capgo/capacitor-android-kiosk para planificar las operaciones del dashboard y de API, conéctalo con Uso de @capgo/capacitor-android-kiosk para la funcionalidad nativa en Uso de @capgo/capacitor-android-kiosk, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para los detalles de implementación en las claves de API, y Dispositivos para el detalle de implementación en Devices.