Important
代わりに UWP センサー API を 使用してください。
COM ベースの Sensor API は非推奨であり、新しいアプリケーションでは使用しないでください。 追加の機能や拡張機能は計画されておらず、サポートは制限されます。
Windows SDK には、Windows センサーと場所のプラットフォームと関連 API を理解して使用するのに役立つ便利なコード サンプルとツールが含まれています。
Samples
Windows SDK には、次の Sensor API サンプルが含まれています。 Sensor API のサンプルは、Windows SDK をインストールした \Samples\winui\Sensors という名前のフォルダーにあります。 たとえば、Windows SDK をドライブ C にインストールした場合、C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\winui\Sensors フォルダーにサンプルがあります。
| サンプルの名前 | Description |
|---|---|
| AmbientLightAware | この MFC サンプルでは、コンピューター上の環境光センサーからデータを読み取り、照明条件に応じてテキスト サイズを変更することで、Sensor API を使用する方法を示します。 イベントを管理する方法と、ユーザーのアクセス許可を要求する方法を示すコードを確認できます。 さまざまな照明条件に基づいてユーザー インターフェイスを管理する方法の例も確認できます。 詳細については、「 Light-Aware ユーザー インターフェイスの作成」を参照してください。 このサンプルをビルドするには、Visual Studio 2008 がインストールされている必要があります。 |
詳細については、サンプルに含まれている ReadMe.txt という名前のファイルを参照してください。
コード ギャラリーから AmbientLightAware サンプルをダウンロードすることもできます。 詳細については、「アンビエントライト対応」ダウンロードページを参照してください。
Tools
Windows SDK には、ハードウェア ベースの光センサー デバイスをシミュレートするために使用できる仮想光センサーが含まれています。 このツールを使用すると、AmbientLightAware サンプルにデータを提供して、サンプル内のコードがどのように動作するかを確認できます。
次の表では、仮想ライト センサーの実行に使用する必要があるファイルについて説明します。 これらのファイルは、Windows SDK をインストールした Bin という名前のフォルダーにあります。 たとえば、32 ビット コンピューターのドライブ C に Windows SDK をインストールした場合、仮想ライト センサー ファイルは C:\Program Files\Microsoft SDKs\Windows\v7.0\Bin フォルダーにあります。 64 ビット コンピューターでは、64 ビット バージョンのツールを使用する必要があります。 Windows SDK では、64 ビット ツールは x64 という名前のサブフォルダーにあります。
| ファイル名 | Description |
|---|---|
| VirtualLightSensor.exe | このプログラムは、仮想センサーが報告するライト データのレベルを変更できるスライダー コントロールを提供します。 |
| VirtualLightSensorDriver.dll | 光センサーをシミュレートする論理センサー ドライバー。 |
| VirtualLightSensorDriver.inf | 仮想光センサー ドライバーの INF ファイル。 |
仮想光センサーのインストール
仮想光センサー アプリケーションを使用する前に、論理センサー ドライバーをインストールする必要があります。 次の手順に従います。
- 管理者としてコマンド ウィンドウを開きます。
- Windows SDK Bin フォルダーに移動します。
- 「pnputil -a VirtualLightSensorDriver.inf」と入力します。
- プロンプトが表示されたら、[ このドライバソフトウェアをインストールする]をクリックします。
- ドライバーが正常にインストールされたことを報告するコマンド ウィンドウを待ちます。
仮想光センサーの実行
仮想ライト センサーを実行するには、.exe ファイルをダブルクリックするだけです。 メッセージが表示されたら、必ずセンサーを有効にしてください。
プログラムを実行すると、センサーが使用可能になるまでに遅延があることに気付く場合があります。 仮想光センサーのユーザー インターフェイスは、論理センサー マネージャーが論理センサーのデバイス ノードを作成するときに、タイトル バーに "待機中" というメッセージを表示します。 待機中のメッセージが消えてから、スライダーを使用して仮想光センサーの lux 出力レベルを設定できます。
次の図は、仮想光センサーのユーザー インターフェイスが準備完了状態であることを示しています。
