Android Kiosk Plugin Capacitor

Utilizzare @capgo/capacitor-android-kiosk

Plugin Android Kiosk di Capacitor 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

bunx cap sync Esegue una copia del nativo code del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

Esegui API in un colpo solo

Esempi

isInKioskMode()

Verifica se l'app è in modalità kiosk attualmente.

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()

Immetti la modalità kiosk, nascondendo l'interfaccia utente del sistema e bloccando i pulsanti hardware. Inoltre, avvia un servizio di keep-alive 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 dal modalità kiosk, ripristinando l'interfaccia utente e le 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');

setAsLauncher()

Apre la schermata di impostazioni del dispositivo di home per consentire all'utente di impostare questa app come launcher. Ciò è richiesto per la funzionalità della modalità kiosk completa.

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

await CapacitorAndroidKiosk.setAsLauncher();
// User will be prompted to select this app as the home app

setAllowedKeys()

Imposta quali tasti hardware sono consentiti di funzionare in modalità kiosk. Di default, tutti i tasti hardware sono bloccati in modalità kiosk.

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

// Allow volume keys only
await CapacitorAndroidKiosk.setAllowedKeys({
  volumeUp: true,
  volumeDown: true,
  back: false,
  home: false,
  recent: false
});

Riferimento completo

• repository del GitHub
• Dal documento
• Riferimento API

Continua dall'uso di @capgo/capacitor-android-kiosk

__CAPGO_KEEP_0__ riferimento 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, Getting Started 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 Chiavi di API.