Panduan
Cara menggunakan Light Sensor di Capacitor
Menggunakan @capgo/capacitor-light-sensor
Plugin Capacitor untuk mengakses sensor cahaya sekitar pada perangkat.
Instal
bun add @capgo/capacitor-light-sensor
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { LightSensor } from '@capgo/capacitor-light-sensor';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
isAvailable |
Cek apakah sensor cahaya tersedia di perangkat saat ini. Anda harus selalu mengecek ketersediaan sensor sebelum mencoba menggunakannya. |
start |
Mulai mendengarkan update sensor cahaya. Ini akan memulai pengukuran sensor pada interval yang ditentukan. Gunakan addListener untuk menerima data sensor. |
stop |
Berhenti mendengarkan update sensor cahaya. Ini akan menghentikan sensor dan menghemat baterai. |
checkPermissions |
Cek status izin saat ini untuk sensor dengan sampling rate tinggi. Pada Android 12+, izin HIGH_SAMPLING_RATE_SENSORS diperlukan untuk interval update sensor di bawah 200ms. |
requestPermissions |
Minta izin untuk sensor dengan sampling rate tinggi. Pada Android 12+, ini akan meminta izin HIGH_SAMPLING_RATE_SENSORS. |
Contoh
isAvailable()
Cek apakah sensor cahaya tersedia di perangkat saat ini. Anda harus selalu mengecek ketersediaan sensor sebelum mencoba menggunakannya.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const { available } = await LightSensor.isAvailable();
start()
Mulai mendengarkan update sensor cahaya. Ini akan memulai pengukuran sensor pada interval yang ditentukan. Gunakan addListener untuk menerima data sensor.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.start({ updateInterval: 500 });
stop()
Berhenti mendengarkan update sensor cahaya. Ini akan menghentikan sensor dan menghemat baterai.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.stop();
checkPermissions()
Cek status izin saat ini untuk sensor dengan sampling rate tinggi. Pada Android 12+, izin HIGH_SAMPLING_RATE_SENSORS diperlukan untuk interval update sensor di bawah 200ms.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
Minta izin untuk sensor dengan sampling rate tinggi. Pada Android 12+, ini akan meminta izin HIGH_SAMPLING_RATE_SENSORS.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
Mendengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau LightSensor.removeAllListeners() untuk menghapus semua listener.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-light-sensor
Jika Anda menggunakan Menggunakan @capgo/capacitor-light-sensor untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-light-sensor untuk detail implementasi di @capgo/capacitor-light-sensor, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.