Guide
Tutoriel sur Android Kiosk
Utilisation de @capgo/capacitor-android-kiosk
Capacitor Plugin Android Kiosk pour le contrôle du mode kiosk et de la fonctionnalité du lanceur. Ce plugin est spécifique à Android. Pour le mode kiosk iOS, utilisez la fonctionnalité d'Accès guidé du dispositif.
Installer
bun add @capgo/capacitor-android-kiosk
bunx cap sync
Ce que ce Plugin Expose
isInKioskMode- Vérifie si l'application est actuellement exécutée en mode kiosk.isSetAsLauncher- Vérifie si l'application est définie comme l'application de démarrage du dispositif (application d'accueil).enterKioskMode- Active le mode kiosk, masquant l'interface utilisateur système et bloquant les boutons de matériel. Il démarre également un service de maintien en avant de premier plan pour que l'application soit moins susceptible d'être tuée par le système. L'application doit être définie comme l'application de démarrage du dispositif pour que cela fonctionne efficacement.exitKioskMode- Quitte le mode kiosque, rétablissant l'interface utilisateur système normale et la fonctionnalité des boutons matériel.
Exemples d'utilisation
isInKioskMode
Vérifie si l'application est actuellement en mode kiosque.
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);
isSetAsLauncher
Vérifie si l'application est définie comme l'application de lancement du dispositif (application d'accueil).
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);
enterKioskMode
Entrez le mode kiosque, masquant l'interface utilisateur système et bloquant les boutons matériel. Il démarre également un service de maintenance en avant-plan pour que l'application soit moins susceptible d'être tuée par le système. L'application doit être définie comme l'application de lancement du dispositif pour que cela fonctionne efficacement.
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.enterKioskMode();
exitKioskMode
Quitte le mode kiosque, rétablissant l'interface utilisateur système normale et la fonctionnalité des boutons matériel. Il arrête également le service de maintenance en avant-plan démarré dans enterKioskMode().
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');
Référence complète
- GitHub: https://github.com/Cap-go/capacitor-android-kiosk/
- Documentation : /docs/plugins/android-kiosk/