Aller directement au contenu principal
Retour aux plugins

Capteur de lumière

Accédez au capteur de lumière ambiante pour mesurer les niveaux d'éclairement en lux avec des mises à jour en temps réel

Guide

Tutoriel sur le Capteur de Lumière

Utilisation de @capgo/capacitor-capteur-de-lumière

Capacitor plugin pour l'accès au capteur de lumière de l'appareil.

Installer

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

Ce que ce Plugin Expose

  • isAvailable - Vérifier si le capteur de lumière est disponible sur le dispositif actuel. Vous devriez toujours vérifier la disponibilité du capteur avant de tenter d'utiliser celui-ci.
  • start - Démarrer l'écoute des mises à jour du capteur de lumière. Cela commencera les mesures du capteur à l'intervalle spécifié. Utilisez addListener pour recevoir les données du capteur.
  • stop - Arrêter l'écoute des mises à jour du capteur de lumière. Cela arrêtera le capteur et économisera la batterie.
  • checkPermissions - Vérifiez l'état de permission actuel pour les capteurs à haute fréquence d'échantillonnage. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour les intervalles d'actualisation des capteurs inférieurs à 200ms.

Exemple d'utilisation

isAvailable

Vérifiez si le capteur de lumière est disponible sur le dispositif actuel. Vous devriez 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 lumière. Cela commencera 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 d'écouter les mises à jour du capteur de lumière. Cela arrêtera le capteur et économisera la batterie.

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

await LightSensor.stop();

checkPermissions

Vérifiez l'état de permission actuel pour les capteurs à haute fréquence d'échantillonnage. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour les intervalles d'actualisation des capteurs inférieurs à 200ms.

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

const status = await LightSensor.checkPermissions();

Référence complète