1.   范圍

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

Web服務(wù)的使用不在本文檔的范圍內(nèi)。請(qǐng)參考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ù)語(yǔ)與定義

3.1      定義

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

 

3.2      縮寫

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

 

3.3      中英

絕對(duì)移動(dòng) Absolute Move 相對(duì)移動(dòng) Relative Move 連續(xù)移動(dòng) Continuous Move

4.   概述

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

 

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

 

         云臺(tái)服務(wù)引入相對(duì)移動(dòng)，無(wú)需知道當(dāng)前位置來(lái)來(lái)操縱半球。該操作期望位置轉(zhuǎn)換做為引用相對(duì)坐標(biāo)系的參數(shù)。本規(guī)范區(qū)分了相對(duì)坐標(biāo)系和絕對(duì)坐標(biāo)系，因?yàn)樵谀承┣闆r下，對(duì)于一個(gè)明確定義的相對(duì)坐標(biāo)系，不存在絕對(duì)坐標(biāo)系。相對(duì)移動(dòng)可以指定速度，絕對(duì)移動(dòng)也一樣。

 

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

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

 

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

 

      • AbsolutePanTiltPositionSpace

      • RelativePanTiltTranslationSpace

      • ContinuousPanTiltVelocitySpace

      • PanTiltSpeedSpace

      • AbsoluteZoomPositionSpace

      • RelativeZoomTranslationSpace

      • ContinuousZoomVelocitySpace

      • ZoomSpeedSpace

如果云臺(tái)節(jié)點(diǎn)不支持某一組的坐標(biāo)系，則該云臺(tái)節(jié)點(diǎn)將不能進(jìn)行相應(yīng)的移動(dòng)操作。例如，如果列表不包含AbsolutePanTiltPositionSpace，則當(dāng)指定了絕對(duì)的水平/俯仰位置時(shí)，絕對(duì)移動(dòng)操作將失敗。相應(yīng)的命令部分描述特定移動(dò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