Vai al contenuto

@capgo/capacitor-android-kiosk

Blocca i dispositivi Android su un'unica app con kiosk mode e controllo del launcher.

@capgo/capacitor-android-kiosk blocca i tablet della flotta su un'unica esperienza Capacitor con modalità kiosk, launcher pinning e policy sui tasti hardware.

PiattaformaSupportoNote
iOSNoFocalizzato su Android
AndroidSìProvisioning device owner come da README
WebNoNon applicabile
  • isInKioskMode - Verifica se l'app è attualmente in esecuzione in modalità kiosk.
  • isSetAsLauncher - Verifica se l'app è impostata come launcher del dispositivo (app home).
  • enterKioskMode - Entra in modalità kiosk, nascondendo l'UI di sistema e bloccando i pulsanti hardware. Avvia anche un servizio foreground keep-alive per ridurre la probabilità che il sistema chiuda l'app. Per funzionare efficacemente, l'app deve essere impostata come launcher del dispositivo.
  • exitKioskMode - Esce dalla modalità kiosk, ripristinando l'UI di sistema normale e la funzionalità dei pulsanti hardware. Ferma anche il servizio foreground keep-alive avviato in enterKioskMode().
MetodoDescrizione
isInKioskModeVerifica se l'app è attualmente in esecuzione in modalità kiosk.
isSetAsLauncherVerifica se l'app è impostata come launcher del dispositivo (home app).
enterKioskModeAttiva la modalità kiosk, nascondendo la UI di sistema e bloccando i tasti hardware. Avvia anche un servizio foreground keep-alive, così che il sistema abbia meno probabilità di chiudere l'app. Perché funzioni davvero, l'app deve essere impostata come launcher del dispositivo.
exitKioskModeDisattiva la modalità kiosk, ripristinando la UI di sistema e i tasti hardware. Ferma anche il servizio foreground keep-alive avviato con enterKioskMode().
setAsLauncherApre le impostazioni della schermata Home del dispositivo per consentire all'utente di impostare questa app come launcher. Necessario per il pieno funzionamento della modalità kiosk.
setAllowedKeysImposta quali tasti hardware possono funzionare in modalità kiosk. Di default, tutti i tasti hardware sono bloccati in modalità kiosk.
getPluginVersionOttieni la versione nativa del plugin Capacitor.

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-android-kiosk.

Se stai usando @capgo/capacitor-android-kiosk per pianificare le operazioni della dashboard e di API, collegalo a Utilizzo di @capgo/capacitor-android-kiosk per la funzionalità nativa in Utilizzo di @capgo/capacitor-android-kiosk, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione in Chiavi API, e Dispositivi per i dettagli di implementazione in Dispositivi.