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

Android Kiosk

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

Guide

Tutoriel sur Android Kiosk

Utilisation de @capgo/capacitor-android-kiosk

Plugin Android Kiosk de Capacitor 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é Guided Access du dispositif.

Installation

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 maintenance 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 kiosk, restituant l'interface utilisateur système normale et la fonctionnalité des boutons de matériel. Il arrête également le service de maintenance de premier plan démarré dans enterKioskMode().

Exemple d'utilisation

isInKioskMode

Vérifie si l'application est actuellement exécutée en mode kiosk.

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 du dispositif (application d'accueil).

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

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

enterKioskMode

Entre en mode kiosque, masquant l'interface utilisateur système et bloquant les boutons de 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

Sort de mode kiosque, restituant l'interface utilisateur système normale et la fonctionnalité des boutons de 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

Si vous utilisez L'utilisation de @capgo/capacitor-android-kiosk pour planifier la console et les opérations API, connectez-le avec @capgo/capacitor-android-kiosk pour les détails d'implémentation dans @capgo/capacitor-android-kiosk, Démarrage pour les détails d'implémentation dans Démarrage, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, 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.