Vai al contenuto principale
Torna ai plugin
@capgo/capacitor-android-kiosk
Tutorial
@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 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 - Ingresso in 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 - Uscita 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

Verifica 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

Verifica 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

Ingresso in 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

Uscita 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

Continua da qui: Utilizzo di @capgo/capacitor-android-kiosk

Se stai utilizzando Utilizzando @capgo/capacitor-android-kiosk per pianificare il 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, e Chiavi di API per i dettagli di implementazione in API Chiavi.