Aller directement au contenu principal
Retour aux plugins
@capgo/capacitor-sensibilite-a-la-lumiere
Tutoriel
@capgo/capacitor-sensibilite-a-la-lumiere

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 accéder au capteur de lumière ambiante du dispositif.

Install

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

Ce que ce plugin expose

  • 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 l'utiliser.
  • 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.
  • stop - Arrêtez d'écouter les mises à jour du capteur de lumière. Cela arrêtera le capteur et économisera la batterie.
  • checkPermissions - Vérifiez l'état actuel des autorisations pour les capteurs à haute fréquence d'échantillonnage. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour les intervalles d'actualisation du capteur 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 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

Continuez de l'étape Utilisation @capgo/capacitor-capteur-de-lumière

Si vous utilisez Utilisation @capgo/capacitor-capteur-de-lumière pour planifier l'interface utilisateur et les opérations API, connectez-le à @capgo/capacitor-capteur-de-lumière pour les détails d'implémentation dans @capgo/capacitor-capteur-de-lumière, Démarrage pour les détails d'implémentation dans Getting Started, API Aperçu pour les détails d'implémentation dans API Aperçu, Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.