Windows 7 感應器平台開發實戰：環境光線感應器自動調整字體大小與對比度

前言：感知環境的智慧型應用

Windows 7 感應器與定位平台讓應用程式能感知物理環境並自我調適。環境光線感應器可讓螢幕在陽光下自動提高亮度/對比度、在暗室降低刺眼度；定位 API 統一 GPS、Wi-Fi、基地台定位，免除協議解析負擔。平台特色：硬體獨立（統一 API）、隱私優先（預設關閉、使用者授權）、多應用共享、定位簡單化。

實驗目標

修改 MFC 應用程式 AmbientLightAware，整合環境光線感應器，根據平均照度 (lux) 自動調整範例文字字體大小，實現「可調式閱讀器」效果。

系統需求

• Visual Studio 2008 SP1
• Windows 7 + Windows 7 SDK
• 相容環境光線感應器硬體或虛擬感應器驅動程式

核心架構與類別設計

感應器 API 核心為 ISensorManager，提供感應器枚舉、事件訂閱、權限請求。兩大事件接收類別：

• CAmbientLightAwareSensorManagerEvents：處理感應器管理器事件（OnSensorEnter 新感應器上線），內含 Initialize/Uninitialize/AddSensor/RemoveSensor
• CAmbientLightAwareSensorEvents：處理單一感應器事件（OnDataUpdated、OnStateChanged、OnLeave），維護 m_mapLux 記錄各感應器最新照度值

實作關鍵步驟

1. 專案設定

• 連結器加入 sensorsapi.lib
• StdAfx.h 包含 <Sensors.h>、<SensorAPI.h>
• 加入四個事件類別檔案

2. 感應器管理器初始化 (Initialize)

• CoCreateInstance 建立 ISensorManager
• SetEventSink 訂閱 OnSensorEnter
• GetSensorsByType(SENSOR_TYPE_AMBIENT_LIGHT) 列舉現有光線感應器
• RequestPermissions 彈出使用者授權對話框（僅首次顯示）
• 對每個感應器呼叫 AddSensor 並請求初始資料報告

3. 單一感應器處理 (AddSensor)

• ISensor::SetEventSink 註冊 CAmbientLightAwareSensorEvents 實例
• 加入 m_Sensors 對應表

4. 事件處理邏輯

• OnStateChanged：狀態變為 SENSOR_STATE_READY 時請求資料報告、更新 UI
• OnDataUpdated：取得 ISensorDataReport，提取 SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX (PROPVARIANT)，更新 m_mapLux，呼叫 UpdateLux 計算平均值並刷新 UI
• OnLeave：感應器離線時移除對應表項目、清理 m_mapLux、更新平均值
• OnEvent：保留擴充點，本範例直接回傳 S_OK

5. 資料提取與平均值計算

// GetSensorData 中
PROPVARIANT var; PropVariantInit(&var);
pDataReport->GetSensorValue(SENSOR_DATA_TYPE_LIGHT_LEVEL_LUX, &var);
// var.vt == VT_R4, var.fltVal 即為 lux 值
m_mapLux[sensorID] = var.fltVal;
PropVariantClear(&var);
UpdateLux(); // 計算所有感應器平均值

6. UI 更新 (CAmbientLightAwareDlg::UpdateLux)

• 根據平均照度區間選擇字體大小/粗細/顏色
• 建立新字體物件，設定靜態控制項 IDC_STATIC_SAMPLE
• 觸發重繪 (InvalidateRect)

7. 應用程式進入點整合

• InitInstance：CoInitializeEx、建立對話框、呼叫 InitAmbientLightAware
• 對話框 OnInitDialog 呼叫初始化
• OnPaint 繪製範例文字
• 關閉時 CleanUp 呼叫 Uninitialize、CoUninitialize

執行結果

手電筒照射/遮蔽感應器，觀察範例文字在高照度下放大、低照度下縮小，模擬真實閱讀器自適應行為。

總結

本實驗完整示範 Windows 7 感應器平台整合流程：權限模型、感應器枚舉、事件驅動資料處理、PROPVARIANT 資料提取、多感應器資料融合與 UI 回應。掌握此模式，可輕鬆擴充至加速計、GPS、人體偵測等多元感應器應用。