共用方式為


關於範例和工具

Windows SDK 包含實用的程式碼範例和工具,可協助您瞭解及使用 Windows 感應器和位置平台和相關 API。

範例

Windows SDK 包含下列感應器 API 範例。 您可以在安裝 Windows SDK 的 \Samples\winui\Sensors 資料夾中找到感應器 API 範例。 例如,如果您在磁片磁碟機 C 上安裝 Windows SDK,您會在下列資料夾中找到範例:C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\winui\Sensors。

範例名稱 描述
AmbientLightAware 此 MFC 範例示範如何藉由從電腦上的環境光線感應器讀取資料,並根據光源條件變更文字大小,以使用感應器 API。 您可以看到程式碼,示範如何管理事件,以及如何要求使用者權限。 您也可以查看如何根據不同光源條件管理使用者介面的範例。 如需詳細資訊,請參閱 建立Light-Aware使用者介面
您必須安裝 Visual Studio 2008 才能建置此範例。

如需詳細資訊,請參閱範例隨附ReadMe.txt名為 的檔案。

您也可以從程式碼庫下載 AmbientLightAware 範例。 如需詳細資訊,請參閱 環境光線感知 下載頁面。

工具

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 的子資料夾中。

檔案名稱 描述
VirtualLightSensor.exe 此程式提供滑杆控制項,可讓您變更虛擬感應器報告之光線資料的層級。
VirtualLightSensorDriver.dll 模擬光線感應器的邏輯感應器驅動程式。
VirtualLightSensorDriver.inf 虛擬光線感應器驅動程式的 INF 檔案。

安裝虛擬光線感應器

使用虛擬光線感應器應用程式之前,您必須先安裝邏輯感應器驅動程式。 請遵循下列步驟:

  1. 以系統管理員身分開啟命令視窗。
  2. 變更為 Windows SDK Bin 資料夾。
  3. 輸入 pnputil -a VirtualLightSensorDriver.inf
  4. 出現提示時,仍然按一下 [ 安裝此驅動程式軟體]。
  5. 等候命令視窗回報驅動程式已成功安裝。

執行虛擬光線感應器

若要執行虛擬光線感應器,只要按兩下.exe檔案即可。 當出現提示時,請務必啟用感應器。

當您執行程式時,您可能會注意到感應器可用之前有延遲。 虛擬光線感應器使用者介面會在標題列中顯示「等候中」訊息,而邏輯感應器管理員會建立邏輯感應器的裝置節點。 等候訊息消失之後,您可以使用滑杆來設定虛擬光線感應器的 lux 輸出層級。

下圖顯示處於就緒狀態的虛擬光線感應器使用者介面。

虛擬光線感應器使用者介面

關於邏輯感應器

SENSOR_CATEGORY_LIGHT