Lompat ke konten utama
@capgo/capacitor-light-sensor API Perangkat Terbuka Sumber

Sensor Cahaya plugin Capacitor

Akses sensor cahaya lingkungan untuk mengukur tingkat cahaya dalam lux dengan pembaruan waktu nyata

Pasang

bun add @capgo/capacitor-light-sensor bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-light-sensor
  • pnpm add @capgo/capacitor-light-sensor
  • yarn add @capgo/capacitor-light-sensor

Panduan

Cara menggunakan Sensor Cahaya di Capacitor

Test di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin Sensor Cahaya code

Menggunakan @capgo/capacitor-light-sensor

Plugin Capacitor untuk mengakses sensor cahaya lingkungan perangkat.

Pasang

bun add @capgo/capacitor-light-sensor
bunx cap sync

bunx cap sync mengcopy kode native code ke proyek-proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

import { LightSensor } from '@capgo/capacitor-light-sensor';

lihat kode API secara langsung

Metode Deskripsi
isAvailable Periksa apakah sensor cahaya tersedia pada perangkat saat ini. Pastikan selalu memeriksa ketersediaan sensor sebelum mencobanya.
start Mulai mendengarkan pembaruan sensor cahaya. Ini akan memulai pengukuran sensor pada interval yang ditentukan. Gunakan addListener untuk menerima data sensor.
stop Hentikan mendengarkan pembaruan sensor cahaya. Ini akan menghentikan sensor dan menghemat baterai.
checkPermissions Periksa status izin saat ini untuk sensor pengambilan sampel tinggi. Pada Android 12+, izin HIGH_SAMPLING_RATE_SENSORS diperlukan untuk interval pembaruan sensor di bawah 200ms.
requestPermissions Minta izin untuk sensor pengambilan sampel tinggi. Pada Android 12+, ini meminta izin HIGH_SAMPLING_RATE_SENSORS.

Contoh

isAvailable()

Periksa apakah sensor cahaya tersedia pada perangkat saat ini. Pastikan selalu memeriksa ketersediaan sensor sebelum mencobanya.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const { available } = await LightSensor.isAvailable();

start()

Mulai mendengarkan pembaruan 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 pembaruan sensor cahaya. Ini akan menghentikan sensor dan menghemat baterai.

import { LightSensor } from '@capgo/capacitor-light-sensor';

await LightSensor.stop();

checkPermissions()

Periksa status izin saat ini untuk sensor pengambilan sampel tinggi. Pada Android 12+, izin HIGH_SAMPLING_RATE_SENSORS diperlukan untuk interval pembaruan sensor di bawah 200ms.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.checkPermissions();

requestPermissions()

Minta izin untuk sensor pengambilan sampel tinggi. Pada Android 12+, ini 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() ketika layar dimatikan, atau LightSensor.removeAllListeners() untuk membersihkan setiap listener.

Panduan lengkap

Teruskan dari Menggunakan @capgo/capacitor-sensor Cahaya

Jika Anda menggunakan Menggunakan @capgo/capacitor-sensor Cahaya untuk merencanakan dashboard dan operasi API, hubungkannya dengan @capgo/capacitor-sensor Cahaya untuk detail implementasi di @capgo/capacitor-sensor Cahaya Dokumentasi untuk detail implementasi di Dokumentasi Ringkasan API untuk detail implementasi di Ringkasan API Pendahuluan untuk detail implementasi di Pendahuluan, dan Kunci API untuk detail implementasi di Kunci API.

FAQ

FAQ Sensor Cahaya

Bagaimana cara menginstal plugin Sensor Cahaya di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-sensor cahaya" (atau "npm install @capgo/capacitor-sensor cahaya"), kemudian jalankan "bunx cap sync" agar projek iOS dan Android dapat menangkap code. Import dari "@capgo/capacitor-sensor cahaya" di aplikasi code.

Apakah @capgo/capacitor-sensor cahaya dapat digunakan dengan React, Vue dan Angular?

Ya. Sensor Cahaya adalah paket Capacitor, sehingga dapat digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-sensor cahaya?

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang masih dipelihara.

Apakah @capgo/capacitor-sensor cahaya gratis dan terbuka sumber?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capacitor-sensor cahaya/ dan paket dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya bisa memperbarui code yang menggunakan Sensor Cahaya tanpa melalui tinjauan App Store?

Pemasangan atau pengupgrade plugin mengubah kode native code, sehingga memerlukan pembangunan toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat dikirimkan secara langsung dengan Capgo pembaruan hidup.

Kirim perubahan Sensor Cahaya tanpa menunggu tinjauan aplikasi

Setelah plugin masuk dalam pembangunan toko Anda, Capgo pembaruan hidup mengirimkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit-menit.

Mulai dengan Capgo