保姆级教程：用Python ONVIF库控制海康摄像头（含PTZ、预置点、截图代码）

Python ONVIF实战：从零构建海康摄像头智能控制系统

在智能安防和物联网应用场景中，摄像头早已不再是简单的视频采集设备。当我们需要实现自动化巡检、智能监控或与其他系统集成时，直接通过编程接口控制摄像头就成为刚需。ONVIF协议作为安防行业的通用语言，让我们能够用统一的方式操作不同品牌的设备。本文将带您从零开始，用Python构建一个功能完整的海康摄像头控制系统，涵盖设备发现、PTZ控制、预置点管理和自动截图等核心功能。

1. 环境准备与ONVIF基础

1.1 工具链配置

开始前需要确保开发环境准备就绪。推荐使用Python 3.8+版本，这是目前最稳定的选择。关键依赖库包括：

pip install onvif-zeep==0.2.12 requests==2.28.1 python-dotenv==0.21.0

为什么选择这些特定版本？ onvif-zeep 0.2.12与海康设备的兼容性最好，而requests 2.28.1修复了之前版本的一些安全漏洞。python-dotenv则用于安全地管理设备凭证。

1.2 海康设备ONVIF配置

在开始编程前，需要确保摄像头已正确配置ONVIF协议：

1. 登录摄像头Web管理界面（通常为http://设备IP）
2. 进入"配置"→"网络"→"高级配置"→"集成协议"
3. 勾选"启用ONVIF"并创建专用账户（建议权限设为管理员）

注意：海康设备默认可能禁用ONVIF，这是安全考虑。务必设置强密码并定期更换。

1.3 设备发现机制

在局域网中发现支持ONVIF的设备，可以使用以下代码片段：

from onvif import ONVIFCamera

def discover_devices():
    discovery = ONVIFCamera.discovery()
    devices = discovery.search()
    for device in devices:
        print(f"发现设备: {device['EPR']} @ {device['XAddrs']}")

这个方法会返回设备的唯一标识(EPR)和访问地址(XAddrs)。对于海康设备，通常还会显示型号和固件版本信息。

2. 建立可靠连接与媒体服务

2.1 连接初始化最佳实践

与摄像头建立稳定连接需要考虑多种因素：

import zeep
from onvif import ONVIFCamera

class CameraController:
    def __init__(self, ip, username, password, port=80):
        self.ip = ip
        self.credentials = (username, password)
        
        # 处理zeep的XML解析问题
        def zeep_pythonvalue(self, xmlvalue):
            return xmlvalue
        zeep.xsd.simple.AnySimpleType.pythonvalue = zeep_pythonvalue
        
        try:
            self.camera = ONVIFCamera(
                ip, port, username, password,
                wsdl_dir='/path/to/cached/wsdl'  # 推荐缓存WSDL文件
            )
            self.media = self.camera.create_media_service()
            self.pro