Zum Inhalt springen

@capgo/capacitor-android-kiosk

Sperren Sie Android-Geräte mit Kiosk-Modus und Launcher-Kontrolle auf eine einzige App.

@capgo/capacitor-android-kiosk sichert Tablet-Flotten auf eine einzige Capacitor-Erfahrung mit Kiosk-Modus, Launcher-Pinning und Hardware-Tastenrichtlinien.

PlattformSupportNotizen
iOSNeinAndroid-fokussiert
AndroidJaDevice-Owner-Provisioning gemäß README
WebNeinNicht zutreffend
  • isInKioskMode - Prüft, ob die App derzeit im Kiosk-Modus läuft.
  • isSetAsLauncher - Prüft, ob die App als Geräte-Startbildschirm (Home-App) festgelegt ist.
  • enterKioskMode - Betritt den Kiosk-Modus, blendet die System-UI aus und blockiert die Hardware-Tasten. Startet zusätzlich einen Foreground-Keep-Alive-Service, damit die App seltener vom System beendet wird. Damit dies effektiv funktioniert, muss die App als Geräte-Startbildschirm festgelegt sein.
  • exitKioskMode - Verlässt den Kiosk-Modus und stellt die normale System-UI sowie die Hardware-Tasten-Funktion wieder her. Stoppt außerdem den in enterKioskMode() gestarteten Foreground-Keep-Alive-Service.
MethodeBeschreibung
isInKioskModePrüft, ob die App gerade im Kiosk-Modus läuft.
isSetAsLauncherPrüft, ob die App als Standard-Launcher (Home-App) festgelegt ist.
enterKioskModeAktiviert den Kiosk-Modus, blendet die System-UI aus und blockiert Hardware-Buttons. Startet außerdem einen Foreground-Keep-Alive-Service, damit die App seltener vom System beendet wird. Damit das effektiv funktioniert, muss die App als Standard-Launcher festgelegt sein.
exitKioskModeBeendet den Kiosk-Modus, stellt die normale System-UI und die Funktion der Hardware-Buttons wieder her. Stoppt außerdem den Foreground-Keep-Alive-Service, der in enterKioskMode() gestartet wurde.
setAsLauncherÖffnet die Einstellungen des Startbildschirms des Geräts, damit der Benutzer diese App als Launcher festlegen kann. Dies ist für die volle Kiosk-Modus-Funktionalität erforderlich.
setAllowedKeysLegt fest, welche Hardware-Tasten im Kiosk-Modus funktionieren dürfen. Standardmäßig sind alle Hardware-Tasten im Kiosk-Modus gesperrt.
getPluginVersionDie native Capacitor Plugin-Version abrufen.

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-android-kiosk.

Wenn du es nutzt @capgo/capacitor-android-kiosk um Dashboard- und API-Operationen zu planen, verbinde es mit Nutzung von @capgo/capacitor-android-kiosk für die native Funktion bei der Nutzung von @capgo/capacitor-android-kiosk, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für das Implementierungsdetail in API Keys und Geräte für das Implementierungsdetail in Devices.