海康SDK PTZ服务规范说明书

"海康SDK手册是关于ISAPI协议中PTZ功能部分的详细规范，适用于所有符合ISAPI协议的接口定义。该手册涵盖了PTZ服务和相关资源的多种操作，包括控制、能力查询、预置点、巡游等功能。" 本文档主要介绍了海康SDK中与PTZ（Pan-Tilt-Zoom，即云台变焦）相关的服务和接口，适用于开发人员进行视频监控系统中的PTZ设备控制。ISAPI（Internet Services API）协议是海康威视提供的一个网络摄像机接口标准，用于实现对摄像机的高级功能控制。 1. **介绍** 这部分对整个文档的目的进行了阐述，即介绍ISAPI协议的PTZ功能部分，帮助开发者理解和使用相关接口。 2. **符合性** 所有的接口定义都遵循ISAPI协议，并且此规范是ISAPI协议的一部分。这意味着所有的架构、术语和关系都与ISAPI IPMD文档保持一致，确保了兼容性和标准化。 3. **词汇表和关系** - **词汇表** 提供了关键术语的定义，帮助理解文档中的专业词汇。 - **基本PTZ空间类型XML** 描述了PTZ设备在进行平移、倾斜和缩放操作时的空间表示方式，可能涉及到XML格式的数据交换。 4. **PTZ服务和资源** 这一部分详细列出了多个PTZ相关的HTTP接口，包括： - **PTZCtrl** 是PTZ服务的总入口，提供对PTZ设备的基本控制。 - **/ISAPI/PTZCtrl/capabilities** 用于获取PTZ设备的能力信息，如最大平移速度、最大缩放级别等。 - **/ISAPI/PTZCtrl/channels** 接口与特定通道（camera channel）的PTZ功能交互。 - **/ISAPI/PTZCtrl/channels/<ID>** 具体操作指定通道的PTZ功能，如设置或查询状态。 - **/ISAPI/PTZCtrl/channels/<ID>/capabilities** 获取特定通道的PTZ能力。 - **/ISAPI/PTZCtrl/channels/<ID>/homeposition** 与设备的归位功能相关，可以设置或查询家位置。 - **/ISAPI/PTZCtrl/channels/<ID>/homeposition/goto** 控制设备返回家位置。 - **/ISAPI/PTZCtrl/channels/<ID>/continuous** 连续平移/倾斜操作。 - **/ISAPI/PTZCtrl/channels/<ID>/momentary** 瞬时平移/倾斜操作。 - **/ISAPI/PTZCtrl/channels/<ID>/relative** 相对移动操作。 - **/ISAPI/PTZCtrl/channels/<ID>/absolute** 绝对位置移动操作。 - **/ISAPI/PTZCtrl/channels/<ID>/digital** 数字输入/输出控制，可能涉及红外、警报等。 - **/ISAPI/PTZCtrl/channels/<ID>/status** 查询PTZ的状态信息，如当前位置、速度等。 - **/ISAPI/PTZCtrl/channels/<ID>/presets** 预置点管理，包括创建、删除和查询预置点。 - **/ISAPI/PTZCtrl/channels/<ID>/presets/<ID>** 操作特定预置点。 - **/ISAPI/PTZCtrl/channels/<ID>/presets/<ID>/goto** 转到指定预置点。 - **/ISAPI/PTZCtrl/channels/<ID>/patrols** 巡航路径管理。 - **/ISAPI/PTZCtrl/channels/<ID>/patrols/<ID>** 操作特定巡航路径。 这些接口提供了对PTZ设备全方位的控制，包括但不限于平移、倾斜、缩放、预置点设置、巡航路径的设定与执行，以及设备状态的查询，使得开发者能够构建出复杂而精细的视频监控解决方案。 通过海康SDK，开发者可以利用这些接口编写应用程序，实现对PTZ摄像机的远程控制，以满足各种监控场景的需求，如自动跟踪、预设点切换、巡航路径设定等。同时，由于遵循了ISAPI协议，这些功能可以应用于海康威视的多种产品，保证了软件的可移植性和互操作性。