Übersicht
Abschnitt mit dem Titel „Übersicht“Capacitor 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 Kiosk-Modus auf iOS verwenden Sie die Funktion Guided Access des Geräts.
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“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 Kiosk-Modus ein, versteckt die System-UI und blockiert die Hardware-Tasten. Außerdem startet ein Hintergrund-Dienst, der dafür sorgt, dass die App weniger wahrscheinlich vom System beendet wird. Die App muss als Geräte-Startseite konfiguriert sein, damit dies effektiv funktioniert.exitKioskMode- Beendet den Kiosk-Modus, restauriert die normale System-UI und die Funktionalität der Hardware-Tasten. Außerdem beendet den Hintergrund-Dienst, der in enterKioskMode() gestartet wurde.
Öffentlich API
Abschnitt mit dem Titel “Öffentlich API”| Methode | Beschreibung |
|---|---|
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 und restauriert die normale System-UI und die Funktionalität der Hardware-Tasten. Außerdem wird der Vordergrund-Keep-Alive-Dienst, der in enterKioskMode() gestartet wurde, gestoppt. |
setAsLauncher | Öffnet die Einstellungen der Geräte-Startseite, um dem Benutzer zu ermöglichen, diese App als Launcher festzulegen. Dies ist erforderlich für die volle Funktionalität des Kiosk-Modus. |
setAllowedKeys | Legt fest, welche Hardware-Tasten in Kiosk-Modus funktionieren dürfen. Standardmäßig werden alle Hardware-Tasten im Kiosk-Modus blockiert. |
getPluginVersion | Ermittelt die native Capacitor-Plugin-Version. |
Quelle der Wahrheit
Abschnitt mit dem Titel “Quelle der Wahrheit”Diese Referenz wird von src/definitions.ts in capacitor-android-kiosk.