Umbrales de sensor de luz
En este tema se proporciona información sobre los umbrales del sensor de luz.
En la tabla siguiente se muestran los umbrales predeterminados del controlador para el sensor de luz. El intervalo predeterminado para el sensor de luz es de 10 Hz. Para obtener más información sobre los tipos que se muestran en la columna de tipo, vea la estructura PROPVARIANT.
| Clave de propiedad | Tipo | Obligatorio/opcional | Valor predeterminado | Descripción |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Requerido | 0.25f | Cantidad mínima de cambio de iluminación necesaria para alcanzar el umbral, medido en porcentajes de lux. Un valor de 0,25f significa un cambio del 25 % en la iluminación. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Opcionales | 1.0f | Cantidad mínima de cambio de iluminación necesaria para alcanzar el umbral, medido en lux. Un valor de 1,0f significa 1 cambio de lux en iluminación. Nota: La implementación de este umbral es muy recomendable en dispositivos portátiles, ya que ayuda a reducir el consumo de energía de batería en entornos de luz ambiente bajos. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Obligatorio si se admite el color. Opcional en caso contrario, | 0.01f | Cantidad mínima de cambio de la coordenada de color CIE 1931 x necesaria para alcanzar el umbral, expresado como una diferencia absoluta. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Obligatorio si se admite el color. Opcional en caso contrario, | 0.01f | Cantidad mínima de cambio de la coordenada de color CIE 1931 y necesaria para alcanzar el umbral, expresado como una diferencia absoluta. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Obligatorio si se admite el color. Opcional en caso contrario, | 50.0f | Cantidad mínima de cambio de la temperatura de luz necesaria para alcanzar el umbral, medido en Kelvins. |
El sensor de luz debe notificar nuevas muestras de datos solo si cambia el valor LUX. Este modelo de informes recomendado garantiza que el sensor de luz no notifique nuevas muestras de datos repetidamente, cuando se encuentra en un entorno LUX completamente oscuro, cero (0).
Si no se proporciona PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference, los controladores de sensor de luz ambiental deben notificar una lectura de ejemplo a la extensión de clase sensors llamando a SensorsCxSensorDataReady cuando se alcanza PKEY_SensorData_LightLevel_Lux umbral. El umbral de PKEY_SensorData_LightLevel_Lux se expresa como un porcentaje de diferencia en lux. Por ejemplo, si este valor de umbral se establece en 0,25f y la última muestra notificada a la extensión de clase del sensor era de 40 lux, la siguiente muestra que se notificará debe ser inferior a 30 lux o mayor que 50 lux (+/-25% de 40). Si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference se proporciona además de PKEY_SensorData_LightLevel_Lux, los sensores de luz ambiente deben notificar una lectura de muestra a la extensión de clase sensors si se cumplen ambos umbrales. Por ejemplo, si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference se establece en 4,0 lux y PKEY_SensorData_LightLevel_Lux se establece en 0,25 (es decir, 25 %) y si el valor de la última lectura de muestra notificada a la extensión de clase sensors es 4 lux, el umbral más restrictivo es PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Por lo tanto, la siguiente lectura de ejemplo que se va a notificar debe ser 0 lux o 8 lux. Comparativamente, si PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference se establece en 4,0 lux y PKEY_SensorData_LightLevel_Lux se establece en 0,25 (es decir, 25 %) pero el valor de la última lectura de muestra notificada a la extensión de clase sensors es 40 lux, el umbral más restrictivo es PKEY_SensorData_LightLevel_Lux. En este caso, la siguiente lectura de ejemplo que se va a notificar debe ser de 30 lux o 50 lux. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference nunca se establece sin PKEY_SensorData_LightLevel_Lux.
Cuando el controlador del sensor notifica componentes cromática x y cromática y color, los controladores de sensor de luz ambiente también deben admitir PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY y umbrales de PKEY_SensorData_LightTemperature_Kelvins. El controlador de sensor de luz ambiental informa de una lectura de ejemplo a la extensión de clase sensors cuando se cumple el PKEY_SensorData_LightChromaticityX, el PKEY_SensorData_LightChromaticityY o el umbral de PKEY_SensorData_LightTemperature_Kelvins.
Los controladores de sensor de luz ambiental siempre deben notificar una lectura de muestra inmediatamente después de que la extensión de clase sensors llame a la devolución de llamada EvtSensorStart independientemente de los valores de umbral. Este ejemplo se conoce como la lectura inicial del ejemplo.
Nota
El controlador del sensor de luz ambiental también debe notificar una lectura de ejemplo a la extensión de clase del sensor cuando cambia el campo de datos IsValid, independientemente de los umbrales que se establezcan.
Cuando PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference y PKEY_SensorData_LightLevel_Lux se establecen en 0,0f, el controlador debe notificar lecturas de ejemplo a la extensión de clase sensors en cada intervalo. Cuando PKEY_SensorData_LightChromaticityX o PKEY_SensorData_LightChromaticityY o PKEY_SensorData_LightTemperature_Kelvins se establece en 0,0f, el controlador debe notificar lecturas de ejemplo a la extensión de clase sensors en cada intervalo. La generación de informes de una muestra de sensor a cada intervalo se conoce como streaming de muestras de sensor.
Nota
En el modo de umbral, no informe de muestras consecutivas que tengan PKEY_SensorData_IsValid establecido en FALSE. En otras palabras, en modo de umbral, solo envía el primer ejemplo en el que PKEY_SensorData_IsValid se cambió a FALSE.