Langkah ke konten utama
Logo Capgo
Kembali ke plugin
@capgo/capacitor-android-kiosk
Tutorial
@capgo/capacitor-android-kiosk

Android Kiosk

Mengunci Perangkat Android ke Mode Kiosk dengan Fungsi Launcher dan Pengendalian Tombol Kunci

Unduhan/Bulan

3.1k

GitHub Bintang

11

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 Guided Access 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. Juga memulai 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. Juga menghentikan layanan keep-alive di depan yang dimulai dalam enterKioskMode().

Contoh Penggunaan

isInKioskMode

Memeriksa 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

Memeriksa 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. Juga memulai 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. Juga menghentikan 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 Using @capgo/capacitor-android-kiosk to plan dashboard and API operations, connect it with @capgo/capacitor-android-kiosk for the implementation detail in @capgo/capacitor-android-kiosk, untuk detail implementasi di @Capacitor/__CAPGO_KEEP_1__-android-kiosk, Panduan Pemula API Overview for the implementation detail in API Overview, untuk detail implementasi di Ringkasan __Capacitor__, Pendahuluan API Keys untuk detail implementasi di API Keys.