Vai direttamente al contenuto principale
Indietro ai plugin
@capgo/capacitor-android-kiosk
Guida
@capgo/capacitor-android-kiosk

Android Kiosk

Blocca dispositivi Android in modalità kiosk con funzionalità di launcher e controllo delle chiavi hardware

Guida

Tutorial su 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

Cos'è che questo plugin esporre

  • 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 - Ingressa modalità kiosk, nascondendo l'interfaccia utente del sistema e bloccando i pulsanti hardware. Inoltre, avvia un servizio di mantenimento in primo piano per ridurre la probabilità che l'app venga uccisa dal sistema. L'app deve essere impostata come launcher del dispositivo per funzionare efficacemente.
  • exitKioskMode - Esci dalla modalità kiosk, ripristinando l'interfaccia utente del sistema normale e la funzionalità dei pulsanti hardware. Inoltre, ferma il servizio di mantenimento 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

Ingressa modalità kiosk, nascondendo l'interfaccia utente del sistema e bloccando i pulsanti hardware. Inoltre, avvia un servizio di mantenimento in primo piano per ridurre la probabilità che l'app venga 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 dalla modalità kiosk, ripristinando l'interfaccia utente del sistema normale e la funzionalità dei pulsanti hardware. Inoltre, ferma il servizio di mantenimento in primo piano avviato in enterKioskMode().

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

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

Riferimento completo

Keep going from Using @capgo/capacitor-android-kiosk

If you are using Utilizzando @capgo/capacitor-android-kiosk per pianificare la dashboard e le operazioni di @API Connettilo con @capgo/capacitor-android-kiosk per i dettagli di implementazione in @capgo/capacitor-android-kiosk Avvio per i dettagli di implementazione in Avvio Panoramica di @API per i dettagli di implementazione in Panoramica di @API Introduzione per i dettagli di implementazione in Introduzione Chiavi di @API per i dettagli di implementazione in API Chiavi.