Schwellenwerte des Lichtsensors
Dieses Thema enthält Informationen zu den Schwellenwerten des Lichtsensors.
In der folgenden Tabelle sind die Standardschwellenwerte des Treibers für den Lichtsensor aufgeführt. Das Standardintervall für den Lichtsensor beträgt 10 Hz. Weitere Informationen zu den in der Typspalte angezeigten Typen finden Sie in der PROPVARIANT-Struktur.
| Eigenschaftenschlüssel | Typ | Erforderlich/Optional | Standardwert | Beschreibung |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Erforderlich | 0,25f | Minimale Änderung der Beleuchtungsstärke, die erforderlich ist, um den Schwellenwert zu erreichen, gemessen in Prozent von Lux. Ein Wert von 0,25f bedeutet eine Änderung der Beleuchtungsstärke um 25 %. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Optional | 1.0f | Minimale Änderung der Beleuchtungsstärke, die erforderlich ist, um den Schwellenwert zu erreichen, gemessen in Lux. Ein Wert von 1,0f bedeutet 1 Lux Änderung der Beleuchtungsstärke. Hinweis: Die Implementierung dieses Schwellenwerts wird auf tragbaren Geräten dringend empfohlen, da er den Akkuenergieverbrauch in Umgebungen mit geringem Umgebungslicht reduziert. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Erforderlich, wenn Farbe unterstützt wird. Andernfalls optional | 0,01f | Minimale Änderung der CIE 1931 x-Farbkoordinate, die erforderlich ist, um den Schwellenwert zu erreichen, ausgedrückt als absoluter Unterschied. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Erforderlich, wenn Farbe unterstützt wird. Andernfalls optional | 0,01f | Minimale Änderung der CIE 1931 y-Farbkoordinate, die erforderlich ist, um den Schwellenwert zu erreichen, ausgedrückt als absoluter Unterschied. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Erforderlich, wenn Farbe unterstützt wird. Andernfalls optional | 50.0f | Minimale Änderung der Lichttemperatur, die erforderlich ist, um den Schwellenwert zu erreichen, gemessen in Kelvin. |
Der Lichtsensor muss neue Datenproben nur melden, wenn sich der LUX-Wert ändert. Dieses empfohlene Berichtsmodell stellt sicher, dass der Lichtsensor keine neuen Datenstichproben wiederholt meldet, wenn er sich in einer vollständig dunklen Lux-Umgebung mit null (0) befindet.
Wenn PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference nicht bereitgestellt wird, müssen Umgebungslichtsensortreiber einen Beispiellesewert an die Sensorklassenerweiterung melden, indem sie SensorsCxSensorDataReady aufrufen, wenn PKEY_SensorData_LightLevel_Lux Schwellenwert erreicht wird. Der PKEY_SensorData_LightLevel_Lux Schwellenwert wird als Prozentsatz der Differenz in Lux ausgedrückt. Wenn beispielsweise dieser Schwellenwert auf 0,25f festgelegt ist und die letzte der Sensorklassenerweiterung gemeldete Stichprobe 40 Lux betrug, sollte die nächste zu meldende Stichprobe entweder kleiner als 30 Lux oder größer als 50 Lux (+/-25 % von 40) sein. Wenn zusätzlich zu PKEY_SensorData_LightLevel_Lux PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference bereitgestellt wird, müssen Umgebungslichtsensoren der Sensorklassenerweiterung einen Beispielwert melden, wenn beide Schwellenwerte erfüllt sind. Wenn beispielsweise PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference auf 4,0 Lux und PKEY_SensorData_LightLevel_Lux auf 0,25 (d. h. 25 %) festgelegt ist und der Wert des letzten Stichprobenwerts, der der Sensorklassenerweiterung gemeldet wurde, 4 Lux beträgt, ist der restriktivste Schwellenwert PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Daher sollte der nächste zu meldende Stichprobenwert 0 Lux oder 8 Lux sein. Wenn PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference auf 4,0 Lux und PKEY_SensorData_LightLevel_Lux auf 0,25 (d. h. 25 %) festgelegt ist, der Wert des letzten Stichprobenwerts, der der Sensorklassenerweiterung gemeldet wurde, jedoch 40 Lux beträgt, ist der restriktivste Schwellenwert PKEY_SensorData_LightLevel_Lux. In diesem Fall sollte der nächste zu meldende Stichprobenwert 30 Lux oder 50 Lux sein. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference wird nie ohne PKEY_SensorData_LightLevel_Lux festgelegt.
Wenn der Sensortreiber Die Farbkomponenten "Chromaticity x" und "Chromaticity y" meldet, müssen Umgebungslichtsensortreiber auch PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY und PKEY_SensorData_LightTemperature_Kelvins Schwellenwerte unterstützen. Der Umgebungslichtsensortreiber meldet einen Beispiellesewert an die Sensorklassenerweiterung, wenn entweder der PKEY_SensorData_LightChromaticityX, der PKEY_SensorData_LightChromaticityY oder der schwellenwert für die PKEY_SensorData_LightTemperature_Kelvins erreicht ist.
Umgebungslichtsensortreiber müssen unabhängig von den Schwellenwerten immer einen Beispielwert sofort melden, nachdem die Sensorklassenerweiterung den EvtSensorStart-Rückruf aufgerufen hat. Dieses Beispiel wird als erster Beispiellesevorgang bezeichnet.
Hinweis
Der Umgebungslichtsensortreiber muss auch einen Beispiellesevorgang an die Sensorklassenerweiterung melden, wenn sich das IsValid-Datenfeld ändert, unabhängig davon, welche Schwellenwerte festgelegt werden.
Wenn PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference und PKEY_SensorData_LightLevel_Lux auf 0,0f festgelegt sind, muss der Treiber in jedem Intervall Beispielmesswerte an die Sensorklassenerweiterung melden. Wenn PKEY_SensorData_LightChromaticityX , PKEY_SensorData_LightChromaticityY oder PKEY_SensorData_LightTemperature_Kelvins auf 0,0f festgelegt ist, muss der Treiber in jedem Intervall Beispiellesewerte an die Sensorklassenerweiterung melden. Das Melden eines Sensorbeispiels in jedem Intervall wird als Sensorbeispielstreaming bezeichnet.
Hinweis
Melden Sie im Schwellenwertmodus keine aufeinander folgenden Beispiele, für die PKEY_SensorData_IsValid auf FALSE festgelegt sind. Anders ausgedrückt: Senden Sie im Schwellenwertmodus nur das erste Beispiel, in dem PKEY_SensorData_IsValid auf FALSE umgestellt wurde.