VS2012 + OpenCV 3.0 編譯報錯「無法打開 NuiApi.h」的排查步驟

錯誤含義

NuiApi.h 是 Microsoft Kinect SDK 的頭文件，非 OpenCV 自帶。報錯說明專案中包含了引用 Kinect 的代碼（或誤引用），但未配置 Kinect SDK 的包含目錄與庫目錄。

排查步驟

1. 全盤搜索：在解決方案目錄下搜索 NuiApi.h，確認是否存在。若無，說明未安裝 Kinect SDK 或安裝路徑未加入包含目錄。
2. 檢查引用代碼：打開報錯的 .cpp/.h，看是否有 #include <NuiApi.h>。若項目不需要 Kinect，直接刪除該引用及相關代碼。
3. 配置 Kinect SDK（若確需）：
   • 安裝 Kinect for Windows SDK v2.0。
   • 屬性頁 → C/C++ → General → Additional Include Directories 加入 $(KINECTSDK20_DIR)\inc。
   • Linker → General → Additional Library Directories 加入 $(KINECTSDK20_DIR)\lib\x86（或 x64）。
   • Linker → Input → Additional Dependencies 加入 Kinect20.lib。
4. 查看頭文件內部：打開 NuiApi.h，搜索 #pragma comment(lib，可見其自動鏈接的庫名。

常見誤區

OpenCV 3.0 本身不依賴 Kinect SDK。若從網上下載的 Demo 含 Kinect 采集代碼，請根據自身需求裁剪或完整配置環境。