@capgo/capacitor-android-kiosk
Blocca i dispositivi Android su un'unica app con kiosk mode e controllo del launcher.
Panoramica
Sezione intitolata “Panoramica”@capgo/capacitor-android-kiosk blocca i tablet della flotta su un'unica esperienza Capacitor con modalità kiosk, launcher pinning e policy sui tasti hardware.
Supporto piattaforme
Sezione intitolata “Supporto piattaforme”| Piattaforma | Supporto | Note |
|---|---|---|
| iOS | No | Focalizzato su Android |
| Android | Sì | Provisioning device owner come da README |
| Web | No | Non applicabile |
Funzionalità principali
Sezione intitolata “Funzionalità principali”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().
Pubblico API
Sezione intitolata “API pubblica”| Metodo | Descrizione |
|---|---|
isInKioskMode | Verifica se l'app è attualmente in esecuzione in modalità kiosk. |
isSetAsLauncher | Verifica se l'app è impostata come launcher del dispositivo (home app). |
enterKioskMode | Attiva 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. |
exitKioskMode | Disattiva la modalità kiosk, ripristinando la UI di sistema e i tasti hardware. Ferma anche il servizio foreground keep-alive avviato con enterKioskMode(). |
setAsLauncher | Apre 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. |
setAllowedKeys | Imposta quali tasti hardware possono funzionare in modalità kiosk. Di default, tutti i tasti hardware sono bloccati in modalità kiosk. |
getPluginVersion | Ottieni la versione nativa del plugin Capacitor. |
Fonte di verità
Sezione intitolata “Fonte di verità”Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-android-kiosk.
Continua da @capgo/capacitor-android-kiosk
Sezione intitolata “Continua da @capgo/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.