1.   范圍

         本文檔定義了用于配置和操作云臺變焦控制器的web服務(wù)接口。此外，還定義了相關(guān)事件。

Web服務(wù)的使用不在本文檔的范圍內(nèi)。請參考ONVIF核心規(guī)范。

2.   引用標(biāo)準(zhǔn)

ONVIF核心規(guī)范 <http://www.onvif.org/specs/core/ONVIF-Core-Specification.pdf>

ONVIF 媒體服務(wù)規(guī)范 <http://www.onvif.org/specs/srv/media/ONVIF-Media-Service-Spec.pdf>

3.   術(shù)語與定義

3.1      定義

Digital PTZ	數(shù)字PTZ	減少或調(diào)整圖像來校正圖像位置與比率的函數(shù)。
Optical zoom	光學(xué)變焦	通過移動攝像機(jī)光學(xué)系統(tǒng)中的變焦鏡頭來調(diào)整設(shè)備的焦距（視角）。
PTZ node	PTZ節(jié)點	映射到PTZ設(shè)備及其功能的低級PTZ實體。
Field of View	視場角	攝像機(jī)在某個特定的位置和方向上看到范圍。
Nadir	最低點	安裝在天花板上向下看的半球攝像機(jī)下面的方向。
E-flip	電子翻轉(zhuǎn)	PTZ在俯仰運動中通過最低點時旋轉(zhuǎn)圖像和控制方向。

 

3.2      縮寫

PTZ	Pan/tilt/zoom	云臺
E-Flip	Electrical flip	電子翻轉(zhuǎn)
FOV	Field of View	視場角

 

3.3      中英

絕對移動 Absolute Move 相對移動 Relative Move 連續(xù)移動 Continuous Move

4.   概述

         云臺模型分為云臺單元的水平/俯仰移動組件和變焦組件兩部分。為了操作云臺單元，該服務(wù)提供絕對移動、相對移動和連續(xù)移動操作。這些操作采用不同的坐標(biāo)系和單位。

 

         云臺服務(wù)提供絕對移動服務(wù)將PTZ設(shè)備移動到絕對位置。服務(wù)期望絕對位置作為引用絕對坐標(biāo)系的參數(shù)。可以隨意設(shè)置水平/俯仰和變焦的速度。速度值為不包含任何方向的正標(biāo)量。在不知道當(dāng)前位置的情況下，無法單獨指定水平/俯仰運動的速度。這種需要指定位置的方法通常會產(chǎn)生一種不流暢、不直觀的動作。

 

         云臺服務(wù)引入相對移動，無需知道當(dāng)前位置來來操縱半球。該操作期望位置轉(zhuǎn)換做為引用相對坐標(biāo)系的參數(shù)。本規(guī)范區(qū)分了相對坐標(biāo)系和絕對坐標(biāo)系，因為在某些情況下，對于一個明確定義的相對坐標(biāo)系，不存在絕對坐標(biāo)系。相對移動可以指定速度，絕對移動也一樣。

 

         最后，PTZ設(shè)備可以通過連續(xù)移動(ContinuousMove)命令以一定的速度在某個方向上連續(xù)移動。因此，速度向量既包含方向又包含速度信息。后者用向量的長度來表示。

         水平/俯仰和變焦坐標(biāo)可以通過使用適當(dāng)?shù)目臻gURI來增加坐標(biāo)來唯一指定。空間URI唯一地表示底層坐標(biāo)系。5.7節(jié)定義了一組標(biāo)準(zhǔn)坐標(biāo)系。如果PTZ節(jié)點支持相應(yīng)類型的移動，則PTZ節(jié)點應(yīng)實現(xiàn)這些坐標(biāo)系統(tǒng)。在很多情況下，水平/俯仰位置由水平和俯仰角度在球坐標(biāo)系中來表示。在固定的百萬像素攝像機(jī)上操作的數(shù)字PTZ可以通過靜態(tài)投影平面上的像素位置來表示攝像機(jī)的觀看方向。因此，在這種情況下需要不同的坐標(biāo)系來捕捉PTZ設(shè)備的物理或虛擬運動。PTZ節(jié)點也可以定義自己特定于設(shè)備的坐標(biāo)系，以使得客戶端能夠利用該PTZ節(jié)點的特定屬性。

 

         通過GetNode或GetNodes操作來檢索PTZ節(jié)點描述包含特定PTZ節(jié)點支持的所有坐標(biāo)系。每個坐標(biāo)系屬于以下其中一個：

 

      • AbsolutePanTiltPositionSpace

      • RelativePanTiltTranslationSpace

      • ContinuousPanTiltVelocitySpace

      • PanTiltSpeedSpace

      • AbsoluteZoomPositionSpace

      • RelativeZoomTranslationSpace

      • ContinuousZoomVelocitySpace

      • ZoomSpeedSpace

如果云臺節(jié)點不支持某一組的坐標(biāo)系，則該云臺節(jié)點將不能進(jìn)行相應(yīng)的移動操作。例如，如果列表不包含AbsolutePanTiltPositionSpace，則當(dāng)指定了絕對的水平/俯仰位置時，絕對移動操作將失敗。相應(yīng)的命令部分描述特定移動命令所需的空間。

此服務(wù)的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