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

Android Kiosk

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

Downloads/Monat

3.100

GitHub Sterne

11

Richtlinie

Tutorial zum Android-Kiosk

Mit @capgo/capacitor-android-kiosk

Capacitor Android-Kiosk-Plugin zur Steuerung des Kiosk-Modus und der Launcher-Funktion. Dieses Plugin ist Android-only. 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 diese Erweiterung 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) festgelegt ist.
  • enterKioskMode - Gibt den Kiosk-Modus ein, indem die System-UI versteckt und die Hardware-Tasten blockiert werden. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, damit die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Startseite festgelegt sein, damit dies effektiv funktioniert.
  • exitKioskMode - Beendet den Kiosk-Modus, indem die normale System-UI und die Funktionalität der Hardware-Tasten wiederhergestellt werden. Außerdem wird der Vordergrund-Keep-Alive-Dienst, der in enterKioskMode() gestartet wurde, gestoppt.

Beispiel für die Verwendung

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-Startseite (Home-App) festgelegt ist.

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

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

enterKioskMode

Gibt den Kiosk-Modus ein, indem die System-UI versteckt und die Hardware-Tasten blockiert werden. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, damit die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Startseite festgelegt sein, damit dies effektiv funktioniert.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Beendet den Kiosk-Modus, indem die normale System-UI und die Funktionalität der Hardware-Tasten wiederhergestellt werden. 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

Weitermachen von Using @capgo/capacitor-android-kiosk

Wenn Sie Using verwenden Using @capgo/capacitor-android-kiosk um das Dashboard und API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-android-kiosk für die Implementierungsdetails in @capgo/capacitor-android-kiosk Einstieg für die Implementierungsdetails in Einstieg 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üssel.