Seuils des capteurs de lumière
Cette rubrique fournit des informations sur les seuils du capteur de lumière.
Le tableau suivant présente les seuils par défaut du pilote pour le capteur de lumière. L’intervalle par défaut pour le capteur de lumière est de 10 Hz. Pour plus d’informations sur les types affichés dans la colonne de type, consultez la structure PROPVARIANT.
| Clé de propriété | Type | Obligatoire ou facultatif | Valeur par défaut | Description |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Obligatoire | 0,25f | Quantité minimale de modification de l’éclairage nécessaire pour atteindre le seuil, mesurée en pourcentages de lux. Une valeur de 0,25f signifie une variation de 25 % de l’éclairage. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Facultatif | 1.0f | Quantité minimale de modification de l’éclairage nécessaire pour atteindre le seuil, mesurée en lux. Une valeur de 1,0f signifie 1 variation de lux dans l’éclairage. Note: L’implémentation de ce seuil est fortement recommandée sur les appareils portables, car elle permet de réduire la consommation d’énergie de la batterie dans les environnements à faible luminosité ambiante. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Obligatoire si la couleur est prise en charge. Sinon, facultatif | 0,01f | Quantité minimale de modification de la coordonnée de couleur CIE 1931 x requise pour atteindre le seuil, exprimée sous la forme d’une différence absolue. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Obligatoire si la couleur est prise en charge. Sinon, facultatif | 0,01f | Quantité minimale de modification de la coordonnée de couleur CIE 1931 y requise pour atteindre le seuil, exprimée sous la forme d’une différence absolue. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Obligatoire si la couleur est prise en charge. Sinon, facultatif | 50.0f | Quantité minimale de changement de la température de lumière nécessaire pour atteindre le seuil, mesurée en Kelvins. |
Le capteur de lumière doit signaler de nouveaux échantillons de données uniquement si la valeur LUX change. Ce modèle de création de rapports recommandé garantit que le capteur de lumière ne signale pas de nouveaux échantillons de données à plusieurs reprises, lorsqu’il se trouve dans un environnement LUX zéro (0) complètement sombre.
Si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference n’est pas fourni, les pilotes de capteur de lumière ambiante doivent signaler un exemple de lecture à l’extension de classe capteurs en appelant SensorsCxSensorDataReady lorsque PKEY_SensorData_LightLevel_Lux seuil est atteint. Le seuil de PKEY_SensorData_LightLevel_Lux est exprimé sous la forme d’un pourcentage de différence dans lux. Par exemple, si cette valeur de seuil est définie sur 0,25f et que le dernier échantillon signalé à l’extension de la classe de capteur était de 40 lux, l’échantillon suivant à signaler doit être inférieur à 30 lux ou supérieur à 50 lux (+/-25 % sur 40). Si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference est fourni en plus de PKEY_SensorData_LightLevel_Lux, les capteurs de lumière ambiante doivent signaler un échantillon de lecture à l’extension de classe de capteurs si les deux seuils sont atteints. Par exemple, si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference est défini sur 4,0 lux et PKEY_SensorData_LightLevel_Lux est défini sur 0,25 (c’est-à-dire 25 %) et si la valeur du dernier échantillon de lecture signalé à l’extension de classe capteurs est de 4 lux, le seuil le plus restrictif est PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Par conséquent, l’échantillon de lecture suivant à signaler doit être 0 lux ou 8 lux. Comparativement, si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference est défini sur 4,0 lux et PKEY_SensorData_LightLevel_Lux est défini sur 0,25 (c’est-à-dire 25 %) mais que la valeur du dernier échantillon de lecture signalé à l’extension de classe capteurs est de 40 lux, le seuil le plus restrictif est PKEY_SensorData_LightLevel_Lux. Dans ce cas, l’exemple de lecture suivant à signaler doit être 30 lux ou 50 lux. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference n’est jamais défini sans PKEY_SensorData_LightLevel_Lux.
Lorsque le pilote de capteur signale des composants de couleur Chromaticity x et Chromaticity y, les pilotes de capteur de lumière ambiante doivent également prendre en charge les seuils PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY et PKEY_SensorData_LightTemperature_Kelvins. Le pilote du capteur de lumière ambiante signale un échantillon de lecture à l’extension de classe de capteurs lorsque le PKEY_SensorData_LightChromaticityX, le PKEY_SensorData_LightChromaticityY ou le seuil de PKEY_SensorData_LightTemperature_Kelvins est atteint.
Les pilotes de capteur de lumière ambiante doivent toujours signaler un échantillon de lecture immédiatement après que l’extension de classe capteurs a appelé le rappel EvtSensorStart , quelles que soient les valeurs de seuil. Cet exemple est appelé l’exemple de lecture initiale.
Notes
Le pilote du capteur de lumière ambiante doit également signaler un échantillon de lecture à l’extension de la classe de capteur lorsque le champ de données IsValid change, quels que soient les seuils définis.
Lorsque PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference et PKEY_SensorData_LightLevel_Lux sont définis sur 0,0f, le pilote doit signaler les exemples de lectures à l’extension de classe capteurs à chaque intervalle. Lorsque PKEY_SensorData_LightChromaticityX , PKEY_SensorData_LightChromaticityY ou PKEY_SensorData_LightTemperature_Kelvins est défini sur 0,0f, le pilote doit signaler les exemples de lectures à l’extension de classe capteurs à chaque intervalle. Le signalement d’un échantillon de capteur à chaque intervalle est appelé diffusion en continu d’échantillons de capteur.
Notes
En mode seuil, ne signalez pas les échantillons consécutifs dont PKEY_SensorData_IsValid défini sur FALSE. En d’autres termes, en mode seuil, envoyez uniquement le premier échantillon dans lequel PKEY_SensorData_IsValid a été basculé sur FALSE.