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設備移動到絕對位置。服務期望絕對位置作為引用絕對坐標系的參數??梢噪S意設置水平/俯仰和變焦的速度。速度值為不包含任何方向的正標量。在不知道當前位置的情況下,無法單獨指定水平/俯仰運動的速度。這種需要指定位置的方法通常會產生一種不流暢、不直觀的動作。
云臺服務引入相對移動,無需知道當前位置來來操縱半球。該操作期望位置轉換做為引用相對坐標系的參數。本規范區分了相對坐標系和絕對坐標系,因為在某些情況下,對于一個明確定義的相對坐標系,不存在絕對坐標系。相對移動可以指定速度,絕對移動也一樣。
最后,PTZ設備可以通過連續移動(ContinuousMove)命令以一定的速度在某個方向上連續移動。因此,速度向量既包含方向又包含速度信息。后者用向量的長度來表示。
水平/俯仰和變焦坐標可以通過使用適當的空間URI來增加坐標來唯一指定??臻gURI唯一地表示底層坐標系。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 |


