Zum Hauptinhalt springen
Capgo-Logo
Zurück zu Plugins
@capgo/capacitor-android-kiosk
Tutorial
von github.com/Cap-go

Android Kiosk

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

Downloads/Woche

3.1k

GitHub Sterne

10

Richtlinie

Tutorial zu Android Kiosk

Mit @capgo/capacitor-android-kiosk

Capacitor Android-Kiosk-Plugin zur Kontrolle des Kiosk-Modus und der Launcher-Funktion. Dieser 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, sodass 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 im enterKioskMode()-Aufruf gestartete Vordergrund-Keep-Alive-Dienst gestoppt.

Beispiel zur 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, sodass 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 im enterKioskMode()-Aufruf gestartete Vordergrund-Keep-Alive-Dienst 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 einen Dashboard und API-Betrieb 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.