Limites do sensor de luz
Este tópico fornece informações sobre os limites do sensor de luz.
A tabela a seguir mostra os limites padrão do driver para o sensor de luz. O intervalo padrão para o sensor de luz é 10 Hz. Para obter mais informações sobre os tipos mostrados na coluna de tipo, consulte a estrutura PROPVARIANT.
| Chave de propriedade | Tipo | Obrigatório/Opcional | Valor padrão | Descrição |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Obrigatório | 0,25f | Quantidade mínima de alteração de analfabetidade necessária para atingir o limite, medida em percentuais de lux. Um valor de 0,25f significa uma alteração de 25% na illuminância. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Opcional | 1,0f | Quantidade mínima de alteração de illuminância necessária para atingir o limite, medido em lux. Um valor de 1,0f significa 1 alteração lux na idminiância. Nota: A implementação desse limite é altamente recomendada em dispositivos portáteis, pois ajuda a reduzir o consumo de energia da bateria em ambientes de pouca luz ambiente. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Obrigatório se houver suporte para cor. Opcional caso contrário, | 0,01f | Quantidade mínima de alteração da coordenada de cor CIE 1931 x necessária para atingir o limite, expressa como uma diferença absoluta. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Obrigatório se houver suporte para cor. Opcional caso contrário, | 0,01f | Quantidade mínima de alteração da coordenada de cor CIE 1931 y necessária para atingir o limite, expressa como uma diferença absoluta. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Obrigatório se houver suporte para cor. Opcional caso contrário, | 50.0f | Quantidade mínima de alteração da temperatura leve necessária para atingir o limite, medido em Kelvins. |
O sensor de luz deve relatar novos exemplos de dados somente se o valor LUX for alterado. Esse modelo de relatório recomendado garante que o sensor de luz não relate novos exemplos de dados repetidamente, quando ele estiver em um ambiente LUX completamente escuro e zero (0).
Se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference não for fornecido, os drivers de sensor de luz ambiente deverão relatar uma leitura de exemplo para a extensão de classe de sensores chamando SensorsCxSensorDataReady quando PKEY_SensorData_LightLevel_Lux limite for atingido. O limite de PKEY_SensorData_LightLevel_Lux é expresso como um percentual de diferença no lux. Por exemplo, se esse valor limite for definido como 0,25f e o último exemplo relatado para a extensão da classe de sensor for de 40 lux, a próxima amostra a ser relatada deverá ser inferior a 30 lux ou maior que 50 lux (+/-25% de 40). Se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference for fornecido além de PKEY_SensorData_LightLevel_Lux, os sensores de luz ambiente deverão relatar uma leitura de exemplo para a extensão de classe de sensores se ambos os limites forem atingidos. Por exemplo, se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference estiver definido como 4,0 lux e PKEY_SensorData_LightLevel_Lux estiver definido como 0,25 (ou seja, 25%) e se o valor da última leitura de exemplo relatada à extensão de classe de sensores for 4 lux, o limite mais restritivo será PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Portanto, a próxima leitura de exemplo a ser relatada deve ser 0 lux ou 8 lux. Comparativamente, se PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference estiver definido como 4,0 lux e PKEY_SensorData_LightLevel_Lux estiver definido como 0,25 (ou seja, 25%), mas o valor da última leitura de exemplo relatada à extensão de classe de sensores for 40 lux, o limite mais restritivo será PKEY_SensorData_LightLevel_Lux. Nesse caso, a próxima leitura de exemplo a ser relatada deve ser 30 lux ou 50 lux. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference nunca é definido sem PKEY_SensorData_LightLevel_Lux.
Quando o driver do sensor relata os componentes de cor Chromaticity x e Chromaticity y, os drivers do sensor de luz ambiente também devem dar suporte a limites de PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY e PKEY_SensorData_LightTemperature_Kelvins. O driver do sensor de luz ambiente relata uma leitura de exemplo para a extensão de classe de sensores quando o PKEY_SensorData_LightChromaticityX, o PKEY_SensorData_LightChromaticityY ou o limite de PKEY_SensorData_LightTemperature_Kelvins é atingido.
Os drivers de sensor de luz ambiente sempre devem relatar uma leitura de exemplo imediatamente após a extensão de classe de sensores chamar o retorno de chamada EvtSensorStart , independentemente dos valores de limite. Este exemplo é conhecido como a leitura de exemplo inicial.
Observação
O driver do sensor de luz ambiente também deve relatar uma leitura de exemplo para a extensão de classe do sensor quando o campo de dados IsValid for alterado, independentemente dos limites que estão sendo definidos.
Quando PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference e PKEY_SensorData_LightLevel_Lux são definidos como 0,0f, o driver deve relatar leituras de exemplo para a extensão de classe de sensores em cada intervalo. Quando PKEY_SensorData_LightChromaticityX ou PKEY_SensorData_LightChromaticityY ou PKEY_SensorData_LightTemperature_Kelvins é definido como 0,0f, o driver deve relatar leituras de exemplo para a extensão de classe de sensores em cada intervalo. Relatar um exemplo de sensor em cada intervalo é conhecido como streaming de exemplo de sensor.
Observação
No modo de limite, não relate exemplos consecutivos que tenham PKEY_SensorData_IsValid definido como FALSE. Em outras palavras, no modo de limite, envie apenas o primeiro exemplo no qual PKEY_SensorData_IsValid foi alternado para FALSE.