当前位置：首页 > news >正文

Qt联合Halcon开发四：【详细图解】海康相机配置并链接测试

news 2025/7/2 19:13:32

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();
}