1. 下載與安裝海康 MVS SDK
首先，訪問海康機器人官網的下載中心，選擇 “Machine Vision” 模塊下的 MVS 軟件包。
1. 打開瀏覽器，進入：https://www.hikrobotics.com/cn/
2. 下載最新版的 MVS 安裝包（通常以 MVS_x.x.x_x64.exe 命名）。
3. 雙擊運行安裝程序，按照默認路徑安裝即可。這會在系統中部署所需的動態鏈接庫、示例程序以及文檔。
2. 查找與準備運行時庫
安裝完成后，進入安裝目錄（默認為 C:\Program Files\HikRobotics\MVS\Runtime），你會看到一系列 .dll 和 .lib 文件：
- DLL 目錄：包含各類動態庫，如
MvCameraControl.dll、GenApi.dll等。 - LIB 目錄：靜態庫文件，可供鏈接器使用。
請記下這兩個目錄的完整路徑，后續在 Qt 工程中需要引用。
3. 在 Qt 項目中配置 SDK
在 Qt Creator 中打開你的工程（.pro 文件）。在文件末尾添加以下配置：
# HikVision 相機 SDK 路徑
# #############################################################
#
# load HikVision Camera SDK
#
# #############################################################INCLUDEPATH+=".\libary\camera\Includes"
LIBS+=".\libary\camera\Libraries\CLAllSerial_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\CLProtocol_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\CLSerCOM.lib"
LIBS+=".\libary\camera\Libraries\GCBase_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\GenApi_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\GenCP_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\Log_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\log4cpp_MD_VC120_v3_0.lib"
LIBS+=".\libary\camera\Libraries\MvCameraControl.lib"
LIBS+=".\libary\camera\Libraries\XmlParser_MD_VC120_v3_0.lib"
若使用 Halcon 也需類似配置 Halcon 的包含路徑和庫路徑，具體可參照 Halcon 環境配置文章。
4. 示例代碼：查找并打印相機序列號
在主函數中調用 MVS SDK 接口，枚舉網絡或 USB 相機，并打印其序列號：
#include <QApplication>
#include <QDebug>
#include "MvCameraControl.h"int main(int argc, char *argv[])
{QApplication a(argc, argv);MV_CC_DEVICE_INFO_LIST cameraList;bool isGige = true; // true：枚舉 GigE 相機；false：枚舉 USB 相機int nRet = MV_CC_EnumDevices(isGige ? MV_GIGE_DEVICE : MV_USB_DEVICE,&cameraList);if (nRet != MV_OK) {qCritical() << "枚舉相機失敗，錯誤碼：" << nRet;return -1;}if (cameraList.nDeviceNum == 0) {qWarning() << "未檢測到任何相機";return -1;}for (int i = 0; i < cameraList.nDeviceNum; ++i) {const char* serial = isGige? reinterpret_cast<char*>(cameraList.pDeviceInfo[i]->SpecialInfo.stGigEInfo.chSerialNumber): reinterpret_cast<char*>(cameraList.pDeviceInfo[i]->SpecialInfo.stUsb3VInfo.chSerialNumber);qDebug() << "查找到相機序列號：" << serial;}return a.exec();
}
編譯并運行該程序，若控制臺中能正常打印出相機的序列號，即表示 SDK 環境配置成功。
5. 小結與常見問題
- 找不到頭文件：請確認
INCLUDEPATH已正確指向Includes目錄。 - 鏈接錯誤：檢查
.lib文件名稱與版本；若使用不同編譯器或架構（x86/x64），需對應版本庫。 - 運行缺少 DLL：運行時拷貝所有
Bin下的 DLL 到 exe 目錄，或添加到系統PATH。 - Halcon 集成：在同一工程中配置 Halcon 庫時，注意 Halcon 的頭文件版本與 MVS SDK 不沖突。
按照以上步驟，便可順利在 Qt/Halcon 項目中集成海康 MVS 相機 SDK，實現相機的枚舉與控制。祝開發順利！
