Guide
Tutoriel sur Android Kiosk
Utilisation de @capgo/capacitor-android-kiosk
Plugin Android Capacitor pour la gestion du mode kiosque et de la fonctionnalité du lanceur. Ce plugin est uniquement disponible pour Android. Pour le mode kiosque iOS, utilisez la fonctionnalité Guided Access du appareil.
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 kiosque.isSetAsLauncher- Vérifie si l'application est définie comme l'application de lancer du dispositif (application principale).enterKioskMode- Met l'application en mode kiosque, masquant l'interface utilisateur système et bloquant les boutons matériel. Il démarre également un service de maintien en vie 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 lancer pour que cela fonctionne efficacement.exitKioskMode- Quitte le mode kiosque, restituant l'interface utilisateur système normale et la fonctionnalité des boutons matériel. Il arrête également le service de maintien en vie en avant-plan démarré dans enterKioskMode().
Exemple d'utilisation
isInKioskMode
Vérifie si l'application est actuellement exécutée 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 lancer du dispositif (application principale).
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);
enterKioskMode
Met l'application en mode kiosque, masquant l'interface utilisateur système et bloquant les boutons matériel. Il démarre également un service de maintien en vie 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 lancer pour que cela fonctionne efficacement.
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.enterKioskMode();
exitKioskMode
Quitte le mode kiosque, restituant l'interface utilisateur système normale et la fonctionnalité des boutons matériel. Il arrête également le service de maintien en vie 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/
Continuez de l'utilisation de @capgo/capacitor-android-kiosk
Si vous utilisez En utilisant @capgo/capacitor-android-kiosk pour planifier le tableau de bord et les opérations API, connectez-le avec @capgo/capacitor-android-kiosk pour les détails d'implémentation dans @capgo/capacitor-android-kiosk, Prise en main pour les détails d'implémentation dans Prise en main, Vue d'ensemble de API pour les détails d'implémentation dans Vue d'ensemble de API, Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.