Bagikan melalui

Tentang Konstanta Sensor

  • Artikel

Platform Sensor Windows dan Lokasi menggunakan konstanta dalam banyak cara. Platform ini menentukan berbagai konstanta yang dapat Anda gunakan dalam kode driver sensor Anda. Produsen sensor dapat menentukan konstanta kustom. Anda dapat menemukan definisi konstanta yang ditentukan platform dalam file Sensors.h. Untuk informasi mendetail tentang konstanta sensor yang ditentukan platform, lihat Konstanta.

Organisasi Sensor dan Data

Platform ini mengatur sensor dan data dengan cara berikut.

  • Kategori mewakili kelas perangkat sensor yang luas. Kategori memungkinkan Anda mengelompokkan sensor yang kemungkinan akan memberikan jenis informasi serupa, atau terkait dalam beberapa cara. Setiap kategori diwakili oleh konstanta GUID . Misalnya, sensor yang melaporkan koordinat lintang dan bujur termasuk dalam kategori sensor lokasi. Ini diwakili oleh konstanta SENSOR_CATEGORY_LOCATION.
  • Jenis sensor mewakili jenis sensor tertentu. Setiap jenis sensor cocok dengan kategori tertentu. Dua sensor dari berbagai jenis dapat termasuk dalam kategori yang sama atau kategori yang berbeda. Setiap jenis sensor diwakili oleh konstanta GUID . Misalnya, sensor sistem posisi global akan diidentifikasi oleh konstanta SENSOR_TYPE_LOCATION_GPS. Namun, sensor yang menyediakan lokasi saat ini dengan menggunakan alamat IP akan diidentifikasi oleh konstanta SENSOR_TYPE_LOCATION_LOOKUP. Namun, kedua sensor akan termasuk dalam kategori sensor lokasi.
  • Jenis data mewakili jenis informasi tertentu yang dapat disediakan sensor. Jenis data sensor dapat berisi nilai pengukuran aktual, seperti ketinggian; informasi tentang unit yang digunakan untuk mengekspresikan data, seperti meter; dan titik referensi untuk data, seperti permukaan laut. Setiap jenis data diwakili oleh konstanta PROPERTYKEY . Misalnya, jenis data yang mewakili ketinggian di atas permukaan laut, dalam meter, akan diidentifikasi oleh konstanta SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS.
  • Saat melaporkan data, nilai dikatakan terkandung dalam bidang data, dan kumpulan bidang data terkait membentuk laporan data. Laporan data dibungkus bersama dengan menggunakan antarmuka IPortableDeviceValues . Setiap laporan data harus berisi setidaknya satu bidang data yang valid dan stempel waktu yang mengidentifikasi kapan laporan data dibuat. Stempel waktu diwakili oleh konstanta SENSOR_DATA_TYPE_TIMESTAMP.

Konstanta Lainnya

Program Anda juga harus menggunakan konstanta lain. Konstanta ini mencakup hal-hal berikut:

  • Properti sensor, seperti SENSOR_PROPERTY_DESCRIPTION. Biasanya, konstanta ini digunakan untuk menggambarkan sensor. Beberapa properti sensor harus disediakan oleh sensor, beberapa properti dapat diatur oleh aplikasi klien, dan beberapa harus selalu mengembalikan nilai yang sama dari sensor. Bagian referensi Properti Sensor menyediakan informasi ini untuk setiap properti.
  • Konstanta peristiwa, seperti SENSOR_EVENT_STATE_CHANGED. Konstanta peristiwa termasuk GUID, yang mewakili jenis peristiwa, dan PROPERTYKEYs, yang mewakili jenis parameter peristiwa. Anda akan menggunakan konstanta ini untuk panggilan metode, seperti ISensor::SetEventInterest dan ISensor::GetEventInterest.

Konstanta Kustom

Produsen sensor dapat menentukan konstanta kustom. Misalnya, sensor dapat termasuk dalam kategori yang tidak ditentukan oleh platform. Sebelum Anda dapat menggunakan sensor yang menentukan konstanta kustom, produsen sensor harus menerbitkan nilai, misalnya dengan menerbitkan file header. Untuk informasi selengkapnya, lihat dokumentasi yang disediakan dengan sensor.