광원 센서 임계값
이 항목에서는 광원 센서 임계값에 대한 정보를 제공합니다.
다음 표에서는 광원 센서에 대한 드라이버의 기본 임계값을 보여 줍니다. 광원 센서의 기본 간격은 10Hz입니다. 형식 열에 표시된 형식에 대한 자세한 내용은 PROPVARIANT 구조를 참조하세요.
| 속성 키 | 형식 | 필수/선택 | 기본값 | Description |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | 필수 | 0.25f | 임계값에 도달하는 데 필요한 최소 조명 변경량(lux의 백분율)입니다. 값이 0.25f이면 조명이 25% 변경되는 것을 의미합니다. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | 선택 사항 | 1.0f | 임계값에 도달하는 데 필요한 최소 조명 변경량(lux)입니다. 값이 1.0f이면 조명이 1lux 변경된 것을 의미합니다. 참고: 이 임계값을 구현하는 것은 낮은 주변 광원 환경에서 배터리 전력 소비를 줄이는 데 도움이 되므로 휴대용 디바이스에서 매우 권장됩니다. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | 색이 지원되는 경우 필수입니다. 그렇지 않으면 선택 사항입니다. | 0.01f | 임계값에 도달하는 데 필요한 CIE 1931 x 색 좌표의 최소 변경 크기이며 절대적인 차이로 표현됩니다. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | 색이 지원되는 경우 필수입니다. 그렇지 않으면 선택 사항입니다. | 0.01f | 임계값에 도달하는 데 필요한 CIE 1931 y 색 좌표의 최소 변경 크기이며 절대적인 차이로 표현됩니다. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | 색이 지원되는 경우 필수입니다. 그렇지 않으면 선택 사항입니다. | 50.0f | 켈빈스(Kelvins)로 측정된 임계값에 도달하는 데 필요한 최소 광온 변화량입니다. |
광원 센서는 LUX 값이 변경된 경우에만 새 데이터 샘플을 보고해야 합니다. 이 권장 보고 모델은 광원 센서가 완전히 어두운 0(0) LUX 환경에 있을 때 새 데이터 샘플을 반복적으로 보고하지 않도록 합니다.
PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference 제공되지 않으면 앰비언트 광원 센서 드라이버는 PKEY_SensorData_LightLevel_Lux 임계값에 도달하면 SensorsCxSensorDataReady 를 호출하여 센서 클래스 확장에 샘플 판독값을 보고해야 합니다. PKEY_SensorData_LightLevel_Lux 임계값은 lux에서 차이의 백분율로 표시됩니다. 예를 들어 이 임계값이 0.25f로 설정되고 센서 클래스 확장에 보고된 마지막 샘플이 40lux인 경우 보고할 다음 샘플은 30lux보다 낮거나 50lux(+/-25%의 40)보다 커야 합니다. PKEY_SensorData_LightLevel_Lux 외에도 PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference 제공되는 경우 주변 광원 센서는 두 임계값이 모두 충족되는 경우 센서 클래스 확장에 샘플 판독값을 보고해야 합니다. 예를 들어 PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference 4.0lux로 설정되고 PKEY_SensorData_LightLevel_Lux 0.25(즉, 25%)로 설정되고 센서 클래스 확장에 보고된 마지막 샘플 읽기 값이 4lux인 경우 가장 제한적인 임계값은 PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. 따라서 보고할 다음 샘플 읽기는 0lux 또는 8lux여야 합니다. 비교적 PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference 4.0lux로 설정되고 PKEY_SensorData_LightLevel_Lux 0.25(즉, 25%)로 설정되어 있지만 센서 클래스 확장에 보고된 마지막 샘플 읽기 값이 40lux인 경우 가장 제한적인 임계값은 PKEY_SensorData_LightLevel_Lux. 이 경우 보고할 다음 샘플 읽기는 30lux 또는 50lux여야 합니다. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference PKEY_SensorData_LightLevel_Lux 없이 설정되지 않습니다.
센서 드라이버가 Chromaticity x 및 Chromaticity y 색 구성 요소를 보고하는 경우 주변 광원 센서 드라이버도 PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY 및 PKEY_SensorData_LightTemperature_Kelvins 임계값을 지원해야 합니다. 앰비언트 광원 센서 드라이버는 PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY 또는 PKEY_SensorData_LightTemperature_Kelvins 임계값이 충족되면 센서 클래스 확장에 샘플 판독값을 보고합니다.
주변 광원 센서 드라이버는 센서 클래스 확장이 임계값에 관계없이 EvtSensorStart 콜백을 호출한 직후에 항상 하나의 샘플 판독값을 보고해야 합니다. 이 샘플을 초기 샘플 읽기라고 합니다.
참고
또한 앰비언트 광원 센서 드라이버는 설정되는 임계값에 관계없이 IsValid 데이터 필드가 변경될 때 센서 클래스 확장에 샘플 판독값을 보고해야 합니다.
PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference 및 PKEY_SensorData_LightLevel_Lux 0.0f로 설정되면 드라이버는 매 간격마다 센서 클래스 확장에 샘플 판독값을 보고해야 합니다. PKEY_SensorData_LightChromaticityX 또는 PKEY_SensorData_LightChromaticityY 또는 PKEY_SensorData_LightTemperature_Kelvins 0.0f로 설정된 경우 드라이버는 매 간격마다 센서 클래스 확장에 샘플 판독값을 보고해야 합니다. 모든 간격으로 센서 샘플을 보고 하는 것을 센서 샘플 스트리밍이라고 합니다.
참고
임계값 모드에서는 PKEY_SensorData_IsValid FALSE로 설정된 연속 샘플을 보고하지 마세요. 즉, 임계값 모드에서는 PKEY_SensorData_IsValid FALSE로 전환된 첫 번째 샘플만 보냅니다.