Accédez au capteur de lumière ambiante pour mesurer l'éclairement en lux avec des mises à jour en temps réel
Commencez par isAvailable() et les autres méthodes principales listées ci-dessous.
Support des plateformes
Section intitulée « Support des plateformes »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Le Web | Non | Protéger avec Capacitor.getPlatform() |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »isAvailable- Vérifiez si le capteur de luminosité est disponible sur l'appareil actuel. Vérifiez toujours la disponibilité du capteur avant de l'utiliser.start- Commencez à écouter les mises à jour du capteur de luminosité. Cela lancera les mesures du capteur à l'intervalle spécifié. UtilisezaddListenerpour recevoir les données du capteur.stop- Arrêtez l'écoute des mises à jour du capteur de luminosité. Cela arrêtera le capteur et préservera la batterie.checkPermissions- Vérifiez l'état actuel de la permission pour les capteurs à taux d'échantillonnage élevé. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour des intervalles de mise à jour du capteur inférieurs à 200 ms.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
isAvailable | Vérifie 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 lumière. Cela démarre les mesures du capteur à l'intervalle spécifié. Utilisez addListener pour recevoir les données du capteur. |
stop | Arrête d’écouter les mises à jour du capteur de lumière. Cela arrête le capteur et économise la batterie. |
addListener | Ajoutez un écouteur pour les événements de changement du capteur de luminosité. L’écouteur est appelé chaque fois que de nouvelles données du capteur sont disponibles. |
removeAllListeners | Supprime tous les listeners des événements du capteur de lumière. |
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 des capteurs 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. |
getPluginVersion | Récupère la version actuelle du plugin. |
Source de vérité
Section intitulée « Source de vérité »Cette référence est synchronisée depuis src/definitions.ts dans capacitor-light-sensor.
Poursuivre avec @capgo/capacitor-light-sensor
Section intitulée « Poursuivre avec @capgo/capacitor-light-sensor »Si vous utilisez @capgo/capacitor-light-sensor pour planifier les opérations du dashboard et de API, connectez-l’avec Utiliser @capgo/capacitor-light-sensor pour la fonctionnalité native dans Utilisation de @capgo/capacitor-light-sensor, 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, Clés API pour les détails d'implémentation dans « Clés API », et Appareils pour les détails d'implémentation dans Devices.