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

Android-Kiosk

Android-Geräte in Kiosk-Modus sperren, einschließlich Launcher-Funktion und Hardware-Tastensteuerung

Monatliche Downloads

3.100

GitHub Sterne

11

Führung

Anleitung zu Android Kiosk

Mit @capgo/capacitor-android-kiosk

Capacitor Android Kiosk-Plugin zur Kontrolle des Kiosk-Modus und der Launcher-Funktion. Dieser Plugin ist nur für Android verfügbar. 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

Was dieser Plugin bereitstellt

  • isInKioskMode - Überprüft, ob die App derzeit im Kiosk-Modus läuft.
  • isSetAsLauncher - Überprüft, ob die App als Geräte-Startseite (Home-App) konfiguriert ist.
  • enterKioskMode - Setzt den Gerätelauncher und aktiviert das Kioskmodus, wodurch die System-UI und die Hardware-Tasten blockiert werden. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um sicherzustellen, dass die App nicht vom System beendet wird. Die App muss als Gerätelauncher konfiguriert sein, damit dies effektiv funktioniert.
  • exitKioskMode - Beendet den Kioskmodus und aktiviert die normale System-UI und die Hardware-Tasten-Funktion. Außerdem wird der Vordergrund-Keep-Alive-Dienst, der in enterKioskMode() gestartet wurde, gestoppt.

Beispielanwendung

isInKioskMode

Überprüft, ob die App derzeit im Kioskmodus 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ätelauncher (Startbildschirm) konfiguriert ist.

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

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

enterKioskMode

Setzt den Gerätelauncher und aktiviert das Kioskmodus, wodurch die System-UI und die Hardware-Tasten blockiert werden. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um sicherzustellen, dass die App nicht vom System beendet wird. Die App muss als Gerätelauncher konfiguriert sein, damit dies effektiv funktioniert.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Beendet den Kioskmodus und aktiviert die normale System-UI und die Hardware-Tasten-Funktion. Außerdem wird der Vordergrund-Keep-Alive-Dienst, der in enterKioskMode() gestartet wurde, gestoppt.

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

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

Vollständige Referenz

Fortsetzen Sie mit der Verwendung von @capgo/capacitor-android-kiosk

Wenn Sie Mit @capgo/capacitor-android-kiosk um die Planung Ihres Dashboards und die API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-android-kiosk für die Implementierungsdetails in @capgo/capacitor-android-kiosk, Zur Anleitung für die Implementierungsdetails in Zur Anleitung, API-Übersicht für die Implementierungsdetails in API-Übersicht, Einführung für die Implementierungsdetails in Einführung, und API-Schlüssel für die Implementierungsdetails in API Schlüsseln.