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

Android Kiosk

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

Ansicht auf __CAPGO_KEEP_0__

Führung

Using @capgo/capacitor-android-kiosk

Verwendung von @Capacitor/__CAPGO_KEEP_1__-android-kiosk

__CAPGO_KEEP_0__ Android Kiosk-Plugin für die 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.

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

Installieren

  • isInKioskMode Was dieser Plugin bereitstellt
  • isSetAsLauncher - Überprüft, ob die App derzeit im Kiosk-Modus läuft.
  • enterKioskMode - Setzt den Gerätelauncher und aktiviert den Kioskmodus, der das System-UI versteckt und Hardware-Tasten blockiert. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um das App-Verhalten zu verbessern.
  • exitKioskMode - Beendet den Kioskmodus und aktiviert das normale System-UI und die Hardware-Tasten-Funktion. Außerdem wird der Vordergrund-Keep-Alive-Dienst gestoppt, der in enterKioskMode() gestartet wurde.

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 den Kioskmodus, der das System-UI versteckt und Hardware-Tasten blockiert. Außerdem wird ein Vordergrund-Keep-Alive-Dienst gestartet, um das App-Verhalten zu verbessern.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

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

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

If Sie __CAPGO_KEEP_0__ verwenden Verwenden Sie @capgo/capacitor-android-kiosk um das API-Dashboard und API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-android-kiosk zur Implementierungsdetail in @capgo/capacitor-android-kiosk Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten API-Übersicht zur Implementierungsdetail in API-Übersicht Einführung zur Implementierungsdetail in Einführung und API-Schlüssel Für die Implementierungsdetails in API Schlüsseln.