Capteur de lumière Plugin Capacitor

Utiliser @capgo/capacitor-light-sensor

Plugin Capacitor pour accéder au capteur de lumière ambiante de l'appareil.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode	Description
isAvailable	Vérifiez si le capteur de luminosité est disponible sur l'appareil actuel. Vous devez toujours vérifier la disponibilité du capteur avant de tenter de l'utiliser.
start	Commencez à écouter les mises à jour du capteur de luminosité. Cela lancera les mesures du capteur à l'intervalle spécifié. Utilisez addListener pour recevoir les données du capteur.
stop	Arrêtez l'écoute des mises à jour du capteur de luminosité. Cela stoppera le capteur et économisera la batterie.
checkPermissions	Vérifiez l'état actuel des permissions pour les capteurs à taux d'échantillonnage élevé. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour des intervalles de mise à jour inférieurs à 200 ms.
requestPermissions	Demandez la permission pour les capteurs à taux d'échantillonnage élevé. Sur Android 12+, cela demande la permission HIGH_SAMPLING_RATE_SENSORS.

Exemples

isAvailable()

Vérifiez si le capteur de luminosité est disponible sur l'appareil actuel. Vous devez toujours vérifier la disponibilité du capteur avant de tenter de l'utiliser.

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

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

start()

Commencez à écouter les mises à jour du capteur de luminosité. Cela lancera les mesures du capteur à l'intervalle spécifié. Utilisez addListener pour recevoir les données du capteur.

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

await LightSensor.start({ updateInterval: 500 });

stop()

Arrêtez l'écoute des mises à jour du capteur de luminosité. Cela stoppera le capteur et économisera la batterie.

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

await LightSensor.stop();

checkPermissions()

Vérifiez l'état actuel des permissions pour les capteurs à taux d'échantillonnage élevé. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour des intervalles de mise à jour de capteurs inférieurs à 200 ms.

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

const status = await LightSensor.checkPermissions();

requestPermissions()

Demandez la permission pour les capteurs à taux d'échantillonnage élevé. Sur Android 12+, cela demande la permission HIGH_SAMPLING_RATE_SENSORS.

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

const status = await LightSensor.requestPermissions();

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou LightSensor.removeAllListeners() pour supprimer tous les listeners.

Référence complète

• dépôt GitHub
• Documentation
• Référence API

Continuer avec l'utilisation de @capgo/capacitor-light-sensor

Si vous utilisez Utiliser @capgo/capacitor-light-sensor pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-light-sensor pour les détails d'implémentation dans @capgo/capacitor-light-sensor, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.