Langkah ke konten utama

Panduan

Tutorial Android Kiosk

Menggunakan @capgo/capacitor-android-kiosk

Plugin Android Kiosk Capacitor untuk mengontrol mode kiosk dan fungsi launcher. Plugin ini hanya tersedia untuk Android. Untuk mode kiosk iOS, gunakan fitur Akses Terarah 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 perangkat keras. Selain itu, mulai layanan keep-alive di depan untuk mengurangi kemungkinan aplikasi 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. Selain itu, berhenti layanan keep-alive di depan yang dimulai dalam enterKioskMode().

Contoh Penggunaan

isInKioskMode

Pengecekan apakah aplikasi sedang berjalan di mode kiosk.

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

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

isSetAsLauncher

Pengecekan apakah aplikasi ditetapkan sebagai launcher perangkat (aplikasi utama).

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. Selain itu, mulai layanan keep-alive di depan untuk mengurangi kemungkinan aplikasi 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. Selain itu, berhenti layanan keep-alive di depan yang dimulai dalam enterKioskMode().

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

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

Referensi Lengkap

Teruskan dari Menggunakan @capgo/capacitor-android-kiosk

Jika Anda menggunakan Menggunakan @capgo/capacitor-android-kiosk untuk merencanakan dashboard dan operasi API, hubungkannya dengan @capgo/capacitor-android-kiosk untuk detail implementasi di @capgo/capacitor-android-kiosk, Getting Started untuk detail implementasi di Getting Started, API Overview untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Pendahuluan, dan API Keys untuk detail implementasi di API Keys.