Android Kiosk

Utilizzo di @capgo/capacitor-android-kiosk

Capacitor Plugin per Android Kiosk per il controllo del modalità kiosk e della funzionalità del launcher. Questo plugin è disponibile solo per Android. Per la modalità kiosk su iOS, utilizzare la funzione Guided Access del dispositivo.

Installa

bun add @capgo/capacitor-android-kiosk
bunx cap sync

Cosa Questo Plugin Espone

• isInKioskMode - Controlla se l'app è attualmente in esecuzione in modalità kiosk.
• isSetAsLauncher - Controlla se l'app è impostata come launcher del dispositivo (app di home).
• enterKioskMode - Inserisce la modalità kiosk, nascondendo l'interfaccia utente del sistema e bloccando i pulsanti hardware. Inoltre, avvia un servizio di keep-alive in primo piano, in modo che l'app sia meno probabile di essere uccisa dal sistema. L'app deve essere impostata come launcher del dispositivo per funzionare efficacemente.
• exitKioskMode - Esci dal modalità kiosk, ripristinando l'interfaccia utente e la funzionalità dei pulsanti hardware normali. Inoltre, ferma il servizio di keep-alive in primo piano avviato in enterKioskMode().

Esempio di utilizzo

isInKioskMode

Controlla se l'app è attualmente in esecuzione in modalità kiosk.

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

const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);

isSetAsLauncher

Controlla se l'app è impostata come launcher del dispositivo (app di home).

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

const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);

enterKioskMode

Avvia la modalità kiosk, nascondendo l'interfaccia utente e bloccando i pulsanti hardware. Inoltre, avvia un servizio di keep-alive in primo piano, in modo che l'app sia meno probabile di essere uccisa dal sistema. L'app deve essere impostata come launcher del dispositivo per funzionare efficacemente.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Esci dal modalità kiosk, ripristinando l'interfaccia utente e la funzionalità dei pulsanti hardware normali. Inoltre, ferma il servizio di keep-alive in primo piano avviato in enterKioskMode().

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

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

Riferimento completo

• GitHub: https://github.com/Cap-go/capacitor-android-kiosk/
• Documentazione: /docs/plugins/android-kiosk/