Ambang sensor cahaya
Topik ini menyediakan informasi tentang ambang sensor cahaya.
Tabel berikut menunjukkan ambang default driver untuk sensor cahaya. Interval default untuk sensor cahaya adalah 10 Hz. Untuk informasi selengkapnya tentang jenis yang diperlihatkan di kolom jenis, lihat struktur PROPVARIANT.
| Kunci properti | Jenis | Wajib/opsional | Nilai default | Deskripsi |
|---|---|---|---|---|
| PKEY_SensorData_LightLevel_Lux | VT_R4 | Diperlukan | 0,25f | Jumlah minimum perubahan iluminasi yang diperlukan untuk mencapai ambang batas, diukur dalam persentase lux. Nilai 0,25f berarti 25% perubahan penerangan. |
| PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference | VT_R4 | Opsional | 1.0f | Jumlah minimum perubahan iluminasi yang diperlukan untuk mencapai ambang batas, diukur dalam luks. Nilai 1,0f berarti 1 lux berubah dalam penerangan. Catatan: Menerapkan ambang ini sangat disarankan pada perangkat portabel karena membantu mengurangi konsumsi daya baterai di lingkungan cahaya sekitar rendah. |
| PKEY_SensorData_LightChromaticityX | VT_R4 | Diperlukan jika warna didukung. Opsional jika tidak | 0,01f | Jumlah minimum perubahan koordinat warna CIE 1931 x yang diperlukan untuk mencapai ambang batas, yang dinyatakan sebagai perbedaan mutlak. |
| PKEY_SensorData_LightChromaticityY | VT_R4 | Diperlukan jika warna didukung. Opsional jika tidak | 0,01f | Jumlah minimum perubahan koordinat warna CIE 1931 y yang diperlukan untuk mencapai ambang batas, yang dinyatakan sebagai perbedaan mutlak. |
| PKEY_SensorData_LightTemperature_Kelvins | VT_R4 | Diperlukan jika warna didukung. Opsional jika tidak | 50,0f | Jumlah minimum perubahan suhu cahaya yang diperlukan untuk mencapai ambang batas, diukur dalam Kelvins. |
Sensor cahaya harus melaporkan sampel data baru hanya jika nilai LUX berubah. Model pelaporan yang direkomendasikan ini memastikan bahwa sensor cahaya tidak melaporkan sampel data baru berulang kali, ketika berada di lingkungan LUX yang benar-benar gelap, nol (0).
Jika PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference tidak disediakan, driver sensor cahaya sekitar harus melaporkan pembacaan sampel ke ekstensi kelas sensor dengan memanggil SensorsCxSensorDataReady saat ambang PKEY_SensorData_LightLevel_Lux terpenuhi. Ambang PKEY_SensorData_LightLevel_Lux dinyatakan sebagai persentase perbedaan dalam luks. Misalnya, jika nilai ambang batas ini diatur ke 0,25f dan sampel terakhir yang dilaporkan ke ekstensi kelas sensor adalah 40 lux, sampel berikutnya yang akan dilaporkan harus lebih rendah dari 30 lux atau lebih besar dari 50 lux (+/-25% dari 40). Jika PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference disediakan selain PKEY_SensorData_LightLevel_Lux, sensor cahaya sekitar harus melaporkan pembacaan sampel ke ekstensi kelas sensor jika kedua ambang terpenuhi. Misalnya, jika PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference diatur ke 4,0 lux dan PKEY_SensorData_LightLevel_Lux diatur ke 0,25 (yaitu 25%) dan jika nilai pembacaan sampel terakhir yang dilaporkan ke ekstensi kelas sensor adalah 4 lux, ambang batas yang paling ketat adalah PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference. Oleh karena itu, pembacaan sampel berikutnya yang akan dilaporkan harus 0 lux atau 8 lux. Secara komparatif, jika PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference diatur ke 4,0 lux dan PKEY_SensorData_LightLevel_Lux diatur ke 0,25 (yaitu 25%) tetapi nilai pembacaan sampel terakhir yang dilaporkan ke ekstensi kelas sensor adalah 40 lux, ambang batas yang paling ketat adalah PKEY_SensorData_LightLevel_Lux. Dalam hal ini, pembacaan sampel berikutnya yang akan dilaporkan harus 30 lux atau 50 lux. PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference tidak pernah diatur tanpa PKEY_SensorData_LightLevel_Lux.
Ketika driver sensor melaporkan komponen warna Chromaticity x dan Chromaticity y, driver sensor cahaya sekitar juga harus mendukung ambang batas PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY, dan PKEY_SensorData_LightTemperature_Kelvins. Driver sensor cahaya sekitar melaporkan pembacaan sampel ke ekstensi kelas sensor saat PKEY_SensorData_LightChromaticityX, PKEY_SensorData_LightChromaticityY, atau ambang PKEY_SensorData_LightTemperature_Kelvins terpenuhi.
Driver sensor cahaya sekitar harus selalu melaporkan satu sampel pembacaan segera setelah ekstensi kelas sensor memanggil panggilan balik EvtSensorStart terlepas dari nilai ambang batas. Sampel ini dikenal sebagai pembacaan sampel awal.
Catatan
Driver sensor cahaya sekitar juga harus melaporkan pembacaan sampel ke ekstensi kelas sensor saat bidang data IsValid berubah, terlepas dari ambang batas yang ditetapkan.
Ketika PKEY_SensorData_LightLevel_Lux_Threshold_AbsoluteDifference dan PKEY_SensorData_LightLevel_Lux diatur ke 0,0f, driver harus melaporkan pembacaan sampel ke ekstensi kelas sensor pada setiap interval. Saat PKEY_SensorData_LightChromaticityX atau PKEY_SensorData_LightChromaticityY atau PKEY_SensorData_LightTemperature_Kelvins diatur ke 0,0f, driver harus melaporkan pembacaan sampel ke ekstensi kelas sensor di setiap interval. Melaporkan sampel sensor di setiap interval dikenal sebagai streaming sampel sensor.
Catatan
Dalam mode ambang batas, jangan laporkan sampel berturut-turut yang telah PKEY_SensorData_IsValid diatur ke FALSE. Dengan kata lain, dalam mode ambang batas, hanya kirim sampel pertama di mana PKEY_SensorData_IsValid dialihkan ke FALSE.