Guide
Comment utiliser le capteur de lumière dans Capacitor
Utilisation de @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
bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { LightSensor } from '@capgo/capacitor-light-sensor';
API en un coup d'œil
| Méthode | Description |
|---|---|
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 à échantillonnage élevé. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour les intervalles de mise à jour du capteur inférieurs à 200ms. |
requestPermissions |
Demander les autorisations pour les capteurs à échantillonnage élevé. Sur Android 12+, cela demande la permission HIGH_SAMPLING_RATE_SENSORS. |
Examples
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()
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 de la permission pour les capteurs à haute fréquence d'échantillonnage. Sur Android 12+, la permission HIGH_SAMPLING_RATE_SENSORS est requise pour les intervalles de mise à jour du capteur inférieurs à 200ms.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
Demander la permission pour les capteurs à haute fréquence d'échantillonnage. Sur Android 12+, cela demande la permission HIGH_SAMPLING_RATE_SENSORS.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
Écouter les événements
addListener retourne un handle. Appelez handle.remove() lorsque l'écran est démonté, ou LightSensor.removeAllListeners() pour annuler tous les écouteurs.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-light-sensor
Si vous utilisez L'utilisation de @capgo/capacitor-light-sensor pour planifier l'interface de bord et les opérations de API, connectez-l’avec @capgo/capacitor-light-sensor pour les détails d'implémentation dans @capgo/capacitor-light-sensor Prise en main pour les détails d'implémentation dans Prise en main Vue d'ensemble de API 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.