センサーの定数について

Windows センサーと場所プラットフォームでは、さまざまな方法で定数が使用されます。 プラットフォームでは、センサー ドライバー コードで使用できるさまざまな定数が定義されています。 センサーの製造元は、カスタム定数を定義できます。 プラットフォームで定義された定数の定義は、Sensors.h ファイルにあります。 プラットフォーム定義のセンサー定数の詳細については、「 定数」を参照してください。

センサーとデータの編成

このプラットフォームでは、センサーとデータを次の方法で整理します。

• カテゴリは、センサー デバイスの幅広いクラスを表します。 カテゴリを使用すると、類似した種類の情報を提供する可能性が高いセンサーや、何らかの方法で関連するセンサーをグループ化できます。 各カテゴリは GUID 定数で 表されます。 たとえば、緯度と経度の座標を報告するセンサーは、位置センサー カテゴリに属します。 これは、SENSOR_CATEGORY_LOCATION定数で表されます。
• センサーの種類は、特定の種類のセンサーを表します。 各センサーの種類は、特定のカテゴリに適合します。 異なる種類の 2 つのセンサーは、同じカテゴリまたは異なるカテゴリに属することができます。 各センサーの種類は、 GUID 定数で表されます。 たとえば、グローバル配置システム センサーは、SENSOR_TYPE_LOCATION_GPS定数によって識別されます。 ただし、IP アドレスを使用して現在の場所を提供するセンサーは、SENSOR_TYPE_LOCATION_LOOKUP定数によって識別されます。 ただし、両方のセンサーは場所センサー カテゴリに属します。
• データ型は、センサーが提供できる特定の種類の情報を表します。 センサーのデータ型には、高度などの実際の測定値を含めることができます。メートルなどのデータを表現するために使用される単位に関する情報。および データの参照ポイント (海面など)。 各データ型は PROPERTYKEY 定数で表されます。 たとえば、海抜をメートル単位で表すデータ型は、SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS定数によって識別されます。
• データをレポートする場合、値はデータ フィールドに含まれていると言われ、関連するデータ フィールドのコレクションがデータ レポートを構成します。 データ レポートは、 IPortableDeviceValues インターフェイスを使用してパッケージ化されます。 各データ レポートには、少なくとも 1 つの有効なデータ フィールドと、データ レポートの作成時を識別するタイム スタンプが含まれている必要があります。 タイム スタンプは、SENSOR_DATA_TYPE_TIMESTAMP定数で表されます。

その他の定数

プログラムでは、他の定数も使用する必要があります。 これらの定数には、次のものが含まれます。

• センサーのプロパティ (SENSOR_PROPERTY_DESCRIPTIONなど)。 通常、これらの定数はセンサーを記述するために使用されます。 一部のセンサー プロパティはセンサーによって提供される必要があり、一部のプロパティはクライアント アプリケーションによって設定でき、一部は常にセンサーから同じ値を返す必要があります。 「 Sensor Properties reference」セクションでは、各プロパティに関するこの情報を提供します。
• SENSOR_EVENT_STATE_CHANGEDなどのイベント定数。 イベント定数には、イベントの種類を表す GUIDs と、イベント パラメーターの型を表す PROPERTYKEYが含まれます。 これらの定数は、ISensor::SetEventInterest や ISensor::GetEventInterest などのメソッド呼び出しに使用します。

カスタム定数

センサーの製造元は、カスタム定数を定義できます。 たとえば、センサーは、プラットフォームで定義されていないカテゴリに属することができます。 カスタム定数を定義するセンサーを使用する前に、センサーの製造元はヘッダー ファイルを発行するなどして値を公開する必要があります。 詳細については、センサーに付属のドキュメントを参照してください。