Allez directement au contenu principal
Retour aux plugins
@capgo/capacitor-android-kiosk
Tutoriel
@capgo/capacitor-android-kiosk

Android Kiosk

Verrouiller les appareils Android en mode kiosk avec une fonctionnalité de lancement et un contrôle des touches de clavier

Guide

Tutoriel sur Android Kiosk

Utilisation de @capgo/capacitor-android-kiosk

Capacitor Android Kiosk Plugin pour le contrôle du mode kiosque et de la fonctionnalité de lancement. Ce plugin est spécifique à Android. Pour le mode kiosque iOS, utilisez la fonctionnalité Guided Access 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 kiosque.
  • isSetAsLauncher - Vérifie si l'application est définie comme l'application de démarrage du dispositif (application d'accueil).
  • enterKioskMode - Met en mode kiosque, cachant 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 démarrage du dispositif 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 maintenance en avant-plan démarré dans enterKioskMode().

Exemple d'utilisation

isInKioskMode

Vérifie si l'application est actuellement en cours d'exécution 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 démarrage (application d'accueil).

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);

enterKioskMode

Met en mode kiosque, cachant 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 démarrage du dispositif 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 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

Continuez à partir de l'utilisation de @capgo/capacitor-android-kiosk

If vous utilisez En utilisant @capgo/capacitor-android-kiosk pour planifier l'interface de bord et les opérations de API, connectez-l’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 Clés de API pour les détails d'implémentation dans les API clés.