Onvif协议PTZ服务规范（一）PTZ Service Specification

  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