Soglie del sensore chiaro
Questo argomento fornisce informazioni sulle soglie del sensore di luce.
La tabella seguente mostra le soglie predefinite del driver per il sensore di luce. L'intervallo predefinito per il sensore di luce è 10 Hz. Per altre informazioni sui tipi visualizzati nella colonna di tipo, vedere la struttura PROPVARIANT.
| Chiave di proprietà | Tipo | Obbligatorio/facoltativo | Valore predefinito | Descrizione |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Necessario | 0.25f | Quantità minima di variazione di illuminazione necessaria per raggiungere la soglia, misurata in percentuali di lux. Un valore pari a 0,25f indica il 25% della variazione dell'illuminazione. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Facoltativo | 1.0f | Quantità minima di variazione di illuminazione necessaria per raggiungere la soglia, misurata in lux. Un valore pari a 1,0f indica una variazione di 1 lux nell'illuminazione. Nota: L'implementazione di questa soglia è altamente consigliata nei dispositivi portatili perché consente di ridurre il consumo di energia della batteria in ambienti di luce ambientale insufficiente. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Obbligatorio se il colore è supportato. Facoltativo in caso contrario | 0.01f | Quantità minima di modifica della coordinata del colore CIE 1931 x necessaria per raggiungere la soglia, espressa come differenza assoluta. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Obbligatorio se il colore è supportato. Facoltativo in caso contrario | 0.01f | Quantità minima di modifica della coordinata di colore y CIE 1931 necessaria per raggiungere la soglia, espressa come differenza assoluta. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Obbligatorio se il colore è supportato. Facoltativo in caso contrario | 50.0f | Quantità minima di modifica della temperatura della luce necessaria per raggiungere la soglia, misurata in Kelvins. |
Il sensore di luce deve segnalare nuovi campioni di dati solo se il valore LUX cambia. Questo modello di report consigliato garantisce che il sensore di luce non segnala ripetutamente nuovi campioni di dati, quando si trova in un ambiente lux completamente scuro,zero (0).
Se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference non viene fornito, i driver del sensore di luce ambientale devono segnalare una lettura di esempio all'estensione della classe dei sensori chiamando SensorCxSensorDataReady quando viene soddisfatta PKEY_SensorData_LightLevel_Lux soglia. La soglia di PKEY_SensorData_LightLevel_Lux viene espressa come percentuale di differenza in lux. Ad esempio, se questo valore soglia è impostato su 0,25f e l'ultimo esempio segnalato all'estensione della classe del sensore era pari a 40 lux, il campione successivo da segnalare deve essere inferiore a 30 lux o maggiore di 50 lux (+/-25% di 40). Se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference viene fornito oltre a PKEY_SensorData_LightLevel_Lux, i sensori di luce ambientale devono segnalare una lettura di esempio all'estensione della classe dei sensori se vengono soddisfatte entrambe le soglie. Ad esempio, se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference è impostato su 4,0 lux e PKEY_SensorData_LightLevel_Lux è impostato su 0,25 (ad esempio 25%) e se il valore dell'ultima lettura del campione segnalato all'estensione della classe dei sensori è 4 lux, la soglia più restrittiva è PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Pertanto, la lettura del campione successivo da segnalare deve essere 0 lux o 8 lux. Relativamente, se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference è impostato su 4,0 lux e PKEY_SensorData_LightLevel_Lux è impostato su 0,25 (ad esempio 25%) ma il valore dell'ultima lettura del campione segnalato all'estensione della classe dei sensori è 40 lux, la soglia più restrittiva è PKEY_SensorData_LightLevel_Lux. In questo caso, la lettura del campione successivo da segnalare deve essere 30 lux o 50 lux. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference non è mai impostato senza PKEY_SensorData_LightLevel_Lux.
Quando il driver del sensore segnala componenti di colore x e Chromaticity y, i driver del sensore di luce ambientale devono supportare anche PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY e soglie di PKEY_SensorData_LightTemperature_Kelvins. Il driver del sensore di luce ambientale segnala una lettura di esempio all'estensione della classe dei sensori quando viene soddisfatta la PKEY_SensorData_LightChromaticityX, la PKEY_SensorData_LightChromaticityY o la soglia di PKEY_SensorData_LightTemperature_Kelvins.
I driver del sensore di luce ambientale devono sempre segnalare una lettura di esempio immediatamente dopo l'estensione della classe dei sensori chiama il callback EvtSensorStart indipendentemente dai valori soglia. Questo esempio è noto come lettura iniziale dell'esempio.
Nota
Il driver del sensore di luce ambientale deve anche segnalare una lettura di esempio all'estensione della classe del sensore quando il campo dati IsValid cambia, indipendentemente dalle soglie impostate.
Quando PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference e PKEY_SensorData_LightLevel_Lux sono impostati su 0,0f, il driver deve segnalare letture di esempio all'estensione della classe dei sensori a ogni intervallo. Quando PKEY_SensorData_LightChromaticityX o PKEY_SensorData_LightChromaticityY o PKEY_SensorData_LightTemperature_Kelvins è impostato su 0,0f, il driver deve segnalare le letture di esempio all'estensione della classe dei sensori a ogni intervallo. La creazione di un esempio di sensore a ogni intervallo è nota come flusso di campioni di sensori.
Nota
In modalità di soglia non segnalare esempi consecutivi che hanno PKEY_SensorData_IsValid impostato su FALSE. In altre parole, in modalità di soglia, inviare solo il primo esempio in cui PKEY_SensorData_IsValid è stato spostato su FALSE.