Zum Hauptinhalt springen
Capgo-Logo
Zurück zu Plugins
@capgo/capacitor-android-kiosk
Anleitung
@capgo/capacitor-android-kiosk

Android-Kiosk

Android-Geräte mit Launcher-Funktion und Hardware-Tastensteuerung in Kiosk-Modus sperren

Downloads/Monat

3,1k

GitHub Sterne

13

Leitfaden

Anleitung zum Android-Kiosk

Verwendung von @capgo/capacitor-android-kiosk

Capacitor-Android-Kiosk-Plugin zur Kontrolle des Kiosk-Modus und der Launcher-Funktion. Dieser Plugin ist Android-spezifisch. Für den iOS-Kiosk-Modus verwenden Sie die Funktion Guided Access des Geräts.

Installieren

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

Wie dieser Plugin Funktionen bereitstellt

  • isInKioskMode - Überprüft, ob die App derzeit im Kiosk-Modus läuft.
  • isSetAsLauncher - Überprüft, ob die App als Geräte-Home-App (Home-App) konfiguriert ist.
  • enterKioskMode - Setzt den Kiosk-Modus ein, versteckt das System-UI und blockiert die Hardware-Tasten. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um sicherzustellen, dass die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Home-App konfiguriert sein, damit dies effektiv funktioniert.
  • exitKioskMode - Beendet den Kiosk-Modus, restauriert das normale System-UI und die Funktionalität der Hardware-Tasten. Außerdem wird der im enterKioskMode()-Aufruf gestartete Vordergrund-Keep-Alive-Dienst beendet.

- Beispielverwendung

isInKioskMode

- Überprüft, ob die App derzeit im Kiosk-Modus läuft.

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

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

isSetAsLauncher

- Überprüft, ob die App als Geräte-Home-App (Home-App) konfiguriert ist.

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

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

enterKioskMode

- Setzt den Kiosk-Modus ein, versteckt das System-UI und blockiert die Hardware-Tasten. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um sicherzustellen, dass die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Home-App konfiguriert sein, damit dies effektiv funktioniert.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

- Beendet den Kiosk-Modus, restauriert das normale System-UI und die Funktionalität der Hardware-Tasten. Außerdem wird der im enterKioskMode()-Aufruf gestartete Vordergrund-Keep-Alive-Dienst beendet.

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

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

- Vollständige Referenz

Weitermachen von @capgo/capacitor-android-kiosk

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-kiosk verwenden Verwendung von @capgo/capacitor-android-kiosk Um das Dashboard und die API-Operationen zu planen, verbinden Sie es mit @API/__CAPGO_KEEP_1__-android-kiosk @capgo/capacitor-android-kiosk für die Implementierungsdetails for the implementation detail in @capgo/capacitor-android-kiosk, Anleitung zum Starten für die Implementierungsdetails __CAPGO_KEEP_0__-Übersicht Implementierungsdetails für die API-Übersicht for the implementation detail in API Overview, @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-kiosk Für die Implementierungsdetails in der Einführung und API Schlüssel Für die Implementierungsdetails in API Schlüssel.