Passer 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

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

plugin de capteur de lumière prévisualisation QR code

En utilisant @capgo/capacitor-light-sensor

le plugin Capacitor pour accéder au capteur de lumière ambiant du dispositif.

Installer

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 tenter d'y accéder.
  • 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 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 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 tenter d'utiliser celui-ci.

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 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.

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

const status = await LightSensor.checkPermissions();

Référence complète

Continuez de l'utilisation de @capgo/capacitor-capteur-de-lumière

Si vous utilisez L'utilisation de @capgo/capacitor-capteur-de-lumière planer le tableau de bord et les opérations API, connectez-le à @capgo/capacitor-sensibilisation à la lumière pour les détails d'implémentation dans @capgo/capacitor-sensibilisation à la lumière, Démarrage pour les détails d'implémentation dans Démarrage, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, 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.