Lompat ke konten utama
Logo Capgo
Kembali ke plugin
@capgo/capacitor-android-kiosk
Tutorial
oleh github.com/Cap-go

Android Kiosk

Mengunci perangkat Android ke mode kiosk dengan fungsi launcher dan kontrol tombol hardware

Unduh per minggu

1.6k

GitHub Bintang

9

Petunjuk

Tutorial pada Android Kiosk

Menggunakan @capgo/capacitor-android-kiosk

Plugin Android Capacitor untuk Kontrol Mode Kiosk dan Fungsi Launcher. Plugin ini hanya tersedia untuk Android. Untuk mode kiosk iOS, gunakan fitur Akses Terpandu perangkat.

Instal

bun add @capgo/capacitor-android-kiosk
bunx cap sync

Apa yang Dibuka oleh Plugin ini

  • isInKioskMode - Mengecek apakah aplikasi sedang berjalan dalam mode kiosk.
  • isSetAsLauncher - Mengecek apakah aplikasi telah ditetapkan sebagai launcher perangkat (aplikasi utama).
  • enterKioskMode - Masuk ke mode kiosk, menyembunyikan antarmuka sistem dan menghalangi tombol hardware. Juga memulai layanan keep-alive di depan, sehingga aplikasi kurang mungkin dibunuh oleh sistem. Aplikasi harus ditetapkan sebagai launcher perangkat untuk ini bekerja efektif.
  • exitKioskMode - Keluar dari mode kiosk, mengembalikan antarmuka sistem normal dan fungsi tombol perangkat keras. Juga menghentikan layanan keep-alive depan yang dimulai dalam enterKioskMode().

Contoh Penggunaan

isInKioskMode

Memeriksa apakah aplikasi sedang berjalan dalam mode kiosk.

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

const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);

isSetAsLauncher

Memeriksa apakah aplikasi telah ditetapkan sebagai launcher perangkat (aplikasi home).

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

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

enterKioskMode

Masuk ke mode kiosk, menyembunyikan antarmuka sistem dan menghalangi tombol perangkat keras. Juga memulai layanan keep-alive depan sehingga aplikasi kurang mungkin dibunuh oleh sistem. Aplikasi harus ditetapkan sebagai launcher perangkat untuk ini bekerja efektif.

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

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

Keluar dari mode kiosk, mengembalikan antarmuka sistem normal dan fungsi tombol perangkat keras. Juga menghentikan layanan keep-alive depan yang dimulai dalam enterKioskMode().

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

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

Referensi Lengkap