1.范围
本文档定义了用于配置和操作云台变焦控制器的web服务接口。此外,还定义了相关事件。
Web服务的使用不在本文档的范围内。请参考ONVIF核心规范。
2.引用标准
ONVIF核心规范 <http://www.onvif.org/specs/core/ONVIF-Core-Specification.pdf>
ONVIF 媒体服务规范 <http://www.onvif.org/specs/srv/media/ONVIF-Media-Service-Spec.pdf>
3.术语与定义
3.1定义
Digital PTZ | 数字PTZ | 减少或调整图像来校正图像位置与比率的函数。 |
Optical zoom | 光学变焦 | 通过移动摄像机光学系统中的变焦镜头来调整设备的焦距(视角)。 |
PTZ node | PTZ节点 | 映射到PTZ设备及其功能的低级PTZ实体。 |
Field of View | 视场角 | 摄像机在某个特定的位置和方向上看到范围。 |
Nadir | 最低点 | 安装在天花板上向下看的半球摄像机下面的方向。 |
E-flip | 电子翻转 | PTZ在俯仰运动中通过最低点时旋转图像和控制方向。 |
3.2缩写
PTZ | Pan/tilt/zoom | 云台 |
E-Flip | Electrical flip | 电子翻转 |
FOV | Field of View | 视场角 |
3.3中英
绝对移动 Absolute Move 相对移动 Relative Move 连续移动 Continuous Move
4.概述
云台模型分为云台单元的水平/俯仰移动组件和变焦组件两部分。为了操作云台单元,该服务提供绝对移动、相对移动和连续移动操作。这些操作采用不同的坐标系和单位。
云台服务提供绝对移动服务将PTZ设备移动到绝对位置。服务期望绝对位置作为引用绝对坐标系的参数。可以随意设置水平/俯仰和变焦的速度。速度值为不包含任何方向的正标量。在不知道当前位置的情况下,无法单独指定水平/俯仰运动的速度。这种需要指定位置的方法通常会产生一种不流畅、不直观的动作。
云台服务引入相对移动,无需知道当前位置来来操纵半球。该操作期望位置转换做为引用相对坐标系的参数。本规范区分了相对坐标系和绝对坐标系,因为在某些情况下,对于一个明确定义的相对坐标系,不存在绝对坐标系。相对移动可以指定速度,绝对移动也一样。
最后,PTZ设备可以通过连续移动(ContinuousMove)命令以一定的速度在某个方向上连续移动。因此,速度向量既包含方向又包含速度信息。后者用向量的长度来表示。
水平/俯仰和变焦坐标可以通过使用适当的空间URI来增加坐标来唯一指定。空间URI唯一地表示底层坐标系。5.7节定义了一组标准坐标系。如果PTZ节点支持相应类型的移动,则PTZ节点应实现这些坐标系统。在很多情况下,水平/俯仰位置由水平和俯仰角度在球坐标系中来表示。在固定的百万像素摄像机上操作的数字PTZ可以通过静态投影平面上的像素位置来表示摄像机的观看方向。因此,在这种情况下需要不同的坐标系来捕捉PTZ设备的物理或虚拟运动。PTZ节点也可以定义自己特定于设备的坐标系,以使得客户端能够利用该PTZ节点的特定属性。
通过GetNode或GetNodes操作来检索PTZ节点描述包含特定PTZ节点支持的所有坐标系。每个坐标系属于以下其中一个:
• AbsolutePanTiltPositionSpace
• RelativePanTiltTranslationSpace
• ContinuousPanTiltVelocitySpace
• PanTiltSpeedSpace
• AbsoluteZoomPositionSpace
• RelativeZoomTranslationSpace
• ContinuousZoomVelocitySpace
• ZoomSpeedSpace
如果云台节点不支持某一组的坐标系,则该云台节点将不能进行相应的移动操作。例如,如果列表不包含AbsolutePanTiltPositionSpace,则当指定了绝对的水平/俯仰位置时,绝对移动操作将失败。相应的命令部分描述特定移动命令所需的空间。
此服务的WSDL在http://www.onvif.org/onvif/ver20/ptz/wsdl/ptz.wsdl指定。
表1:引用的命名空间(带前缀)
前缀 | 命名空间URI |
env | http://www.w3.org/2003/05/soap-envelope |
ter | http://www.onvif.org/ver10/error |
xs | http://www.w3.org/2001/XMLSchema |
tt | http://www.onvif.org/ver10/schema |
tptz | http://www.onvif.org/ver20/ptz/wsdl |