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