Aller au contenu

@capgo/capacitor-android-kiosk

Verrouillez les appareils Android sur une seule application grâce au mode kiosk et au contrôle du launcher.

@capgo/capacitor-android-kiosk verrouille les tablettes d'une flotte sur une seule expérience Capacitor, avec le mode kiosque, l'épinglage du launcher et des politiques de boutons physiques.

PlateformeSupportNotes
iOSNonAxé Android
AndroidOuiProvisionnement du device owner selon le README
Le WebNonNon applicable
  • isInKioskMode - Vérifie si l'application est actuellement en mode kiosque.
  • isSetAsLauncher - Vérifie si l'application est définie comme lanceur de l'appareil (application d'accueil).
  • enterKioskMode - Active le mode kiosque, en masquant l'UI système et en bloquant les boutons physiques. Démarre également un service de premier plan (foreground) pour éviter que le système ne tue l'application. L'application doit être définie comme lanceur de l'appareil pour un fonctionnement optimal.
  • exitKioskMode - Désactive le mode kiosque, rétablissant l'UI système et les boutons physiques. Arrête également le service de premier plan lancé par enterKioskMode().
MéthodeDescription
isInKioskModeVérifie si l'application s'exécute actuellement en mode kiosque.
isSetAsLauncherVérifie si l’application est définie comme lanceur d’appareil (écran d’accueil).
enterKioskModePasse en mode kiosque en masquant l'interface système et en bloquant les boutons matériels. Démarre aussi un service foreground keep-alive pour limiter le risque que le système tue l'application. L'application doit être définie comme lanceur de l'appareil pour que cela fonctionne.
exitKioskModeQuitte le mode kiosque, rétablissant l'interface système et les boutons matériels. Arrête également le service de maintien en premier plan lancé par enterKioskMode().
setAsLauncherOuvre les paramètres de l’écran d’accueil de l’appareil pour permettre à l’utilisateur de définir cette application comme lanceur. Indispensable pour profiter pleinement du mode kiosk.
setAllowedKeysDéfinit quelles touches physiques sont autorisées à fonctionner en mode kiosque. Par défaut, toutes les touches physiques sont bloquées en mode kiosque.
getPluginVersionRécupère la version du plugin natif Capacitor.

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-android-kiosk.

Si vous utilisez @capgo/capacitor-android-kiosk pour planifier les opérations du dashboard et de API, connectez-l’avec Utilisation de @capgo/capacitor-android-kiosk pour la fonctionnalité native dans « Utilisation de @capgo/capacitor-android-kiosk », Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'introduction, Clés API pour les détails d'implémentation dans « Clés API », et Appareils pour les détails d'implémentation dans Devices.