### 如何通过 Python 连接海康威视的 MVS（多目视觉传感器） 为了成功连接海康威视的多目视觉传感器 (MVS)，需要完成以下几个方面的配置和操作： #### 1. 环境准备 在开始之前，需确保已安装必要的依赖项以及开发工具包。以下是具体的准备工作： - **安装 Microsoft Visual Studio (MVS)** 下载地址可以通过海康机器人官网获取[^2]。 - **Python 开发环境** 使用支持版本的 Python，并确认其路径已被正确配置到系统的 PATH 中。 #### 2. 添加模块路径 为了让 Python 能够识别 Hikvision 提供的相关功能模块 `MvImport`，需要将其路径加入到项目的环境中。假设该模块位于以下位置： ```plaintext D:\MVS\MVS\Development\Samples\Python\MvImport ``` 可以在脚本开头动态添加此路径： ```python import sys sys.path.append(r"D:\MVS\MVS\Development\Samples\Python\MvImport") ``` #### 3. 核心代码示例 下面是一个简单的 Python 示例代码，用于初始化并捕获来自海康威视多目视觉传感器的数据流： ```python from MvCameraControl_class import * # 导入核心类库 def main(): device_list = MV_CC_DEVICE_INFO_LIST() # 创建设备列表对象 # 枚举设备 ret = MvCamera.MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, device_list) if ret != 0: print(f"枚举设备失败! 错误码: {ret}") return if device_list.nDeviceNum == 0: print("未发现任何设备!") return print(f"检测到 {device_list.nDeviceNum} 台设备") cam = MvCamera() # 打开第一个设备 st_device_info = cast(device_list.pDeviceInfo[0], POINTER(MV_CC_DEVICE_INFO)).contents ret = cam.MV_CC_CreateHandle(st_device_info) if ret != 0: print(f"创建句柄失败! 错误码: {ret}") return ret = cam.MV_CC_OpenDevice(MV_ACCESS_Exclusive, 0) if ret != 0: print(f"打开设备失败! 错误码: {ret}") return try: # 设置触发模式为连续采集 ret = cam.MV_CC_SetEnumValue('TriggerMode', 0) if ret != 0: print(f"设置 TriggerMode 失败! 错误码: {ret}") # 启动抓图 ret = cam.MV_CC_StartGrabbing() if ret != 0: print(f"启动抓图失败! 错误码: {ret}") while True: st_frame_info = MV_FRAME_OUT_INFO_EX() memset(byref(st_frame_info), 0, sizeof(st_frame_info)) data_buf = (c_ubyte * st_frame_info.nFrameLen)() ret = cam.MV_CC_GetOneFrameTimeout(data_buf, st_frame_info.nWidth*st_frame_info.nHeight*3, byref(st_frame_info), 1000) if ret == 0: print(f"帧号: {st_frame_info.nFrameNum}, 宽度: {st_frame_info.nWidth}, 高度: {st_frame_info.nHeight}") image = np.array(data_buf).reshape((st_frame_info.nHeight, st_frame_info.nWidth, 3)) # 将数据转换成图像矩阵 cv2.imshow('Image', image) key = cv2.waitKey(1) if key == ord('q'): break except KeyboardInterrupt: pass finally: # 停止抓图 ret = cam.MV_CC_StopGrabbing() if ret != 0: print(f"停止抓图失败! 错误码: {ret}") # 关闭设备 ret = cam.MV_CC_CloseDevice() if ret != 0: print(f"关闭设备失败! 错误码: {ret}") if __name__ == "__main__": main() ``` 上述代码实现了基本的功能流程，包括设备枚举、参数设置、图像捕捉及显示等功能[^3]。 --- #### 注意事项 - 如果相机已经被其他程序占用，则可能会导致无法正常连接或运行错误。因此，在执行 Python 脚本前，请确保没有任何第三方应用程序正在访问目标摄像头设备。 - 对于更复杂的场景需求，比如调整曝光时间或者增益控制等高级选项，可通过调用对应的 API 函数来实现自定义配置。 --- ###