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

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

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

Le plugin Capacitor pour l'accès 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 - Arrêtez d'écouter les mises à jour du capteur de lumière. Cela arrêtera le capteur et économisera la batterie.
  • 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 à échantillonnage élevé. 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 de l'utiliser.

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

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

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.

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

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

stop

Arrêter l'écoute des 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 à échantillonnage élevé. 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 à partir de l'utilisation de @capgo/capacitor-capteur-de-lumière

If vous utilisez En utilisant @capgo/capacitor-sensibilite a la lumiere pour planifier le tableau de bord et les operations de API, connectez-l’avec @capgo/capacitor-sensibilite a la lumiere pour les details d'implementation dans @capgo/capacitor-sensibilite a la lumiere, Prise en main pour les details d'implementation dans Prise en main, Vue d'ensemble de API pour les details d'implementation dans Vue d'ensemble de API, Introduction pour les details d'implementation dans Introduction, et Clés de API pour les détails d'implémentation dans les API clés.