5.   服務

5.1      PTZ節(jié)點

5.1.1.   常規(guī)

         支持PTZ的設備可以有多個PTZ節(jié)點。PTZ節(jié)點可以表示機械PTZ驅(qū)動器。上傳的云臺驅(qū)動程序或數(shù)字云臺驅(qū)動程序。PTZ節(jié)點是PTZ控制API中的最低級別實體，反映了支持的PTZ功能。PTZ節(jié)點由其名稱或其引用令牌引用。PTZ服務不提供創(chuàng)建或操作PTZ節(jié)點的操作。

 

所有PTZ節(jié)點都應有以下特性：

• Token – 用于引用云臺節(jié)點的唯一標識符。

• Name – 安裝程序提供的名稱。

• SupportedPTZSpaces – PTZ節(jié)點可用的坐標系列表。對于每個坐標系，云臺節(jié)點應指定其允許范圍。

• MaximumNumberOfPresets – 如果支持一個預置，則所有預置操作應都可用于該云臺節(jié)點。

• HomeSupported – 指定起始位置可用的布爾運算符。如果設置為真，則該云臺節(jié)點可以進行原位（Home Position）操作。

• AuxiliaryCommands – 支持的輔助命令列表。如果列表不為空，則該PTZ節(jié)點可以進行輔助操作。設備可以使用核心規(guī)范中描述的輔助命令。

• MaximumNumberOfPresetTors – 可以創(chuàng)建的預設巡航數(shù)量。如果支持一個或多個預設巡航，則該PTZ節(jié)點應提供所需的預設巡航操作。

5.1.2.   節(jié)點獲取（GetNodes）

具有PTZ功能的設備執(zhí)行節(jié)點獲取操作時，應返回設備上所有可用的PTZ節(jié)點。

請求（REQUEST）： 空消息。

響應（RESPONSE）：

      • PTZNode – 可選，unbounded[tt:PTZNode]

       設備上現(xiàn)有PTZ節(jié)點列表。

錯誤（FAULTS）：

         None

訪問權限類（ACCESS CLASS）：

      READ_MEDIA

5.1.3.    獲取節(jié)點（GetNode）

支持PTZ的設備應實現(xiàn)GetNode操作并返回所請求PTZ的屬性節(jié)點（如果存在）。否在，設備應以適當?shù)墓收闲畔⑦M行響應。

請求（REQUEST）： 空消息。

      • NodeToken [tt:ReferenceToken]

       對要請求的PTZ節(jié)點的引用。

響應（RESPONSE）：

       • PTZNode [tt:PTZNode]

       請求的PTZ節(jié)點屬性。

錯誤（FAULTS）：

       • env:Sender – ter:InvalidArgVar – ter:NoEntity

       設備上沒有此類PTZ節(jié)點。

訪問權限類（ACCESS CLASS）：

      READ_MEDIA

5.2      PTZ配置

5.2.1.   常規(guī)

PTZ配置包含對其所屬PTZ節(jié)點的引用。客戶端無法更改此引用。

以下元素是PTZ配置的一部分：

• PTZNodeToken – 對PTZ配置所屬的PTZ節(jié)點的強制引用。

• DefaultAbsolutePanTiltPositionSpace – 如果PTZ節(jié)點支持絕對水平/俯仰運動，則應默認指定一個絕對水平/俯仰位置空間。

• DefaultRelativePanTiltTranslationSpace – 如果PTZ節(jié)點支持相對水平/俯仰運動，則應默認指定一個相對水平/俯仰轉(zhuǎn)換空間作。

• DefaultContinuousPanTiltVelocitySpace – 如果PTZ節(jié)點支持連續(xù)水平/俯仰運動，則應默認指定一個連續(xù)的水平/俯仰速度空間作。

• DefaultPanTiltSpeedSpace – 如果PTZ節(jié)點支持絕對或者相對運動，則應默認指定一個水平/俯仰速度空間。

• DefaultAbsoluteZoomPositionSpace – 如果PTZ節(jié)點支持絕對變焦運動，則應默認指定一個絕對變焦位置空間。

• DefaultRelativeZoomTranslationSpace – 如果PTZ節(jié)點支持相對變焦運動，則應默認指定一個相對變焦轉(zhuǎn)換空間。

• DefaultContinuousZoomVelocitySpace – 如果PTZ節(jié)點支持連續(xù)變焦運動，則應默認指定一個連續(xù)變焦速度空間。

• DefaultPTZSpeed – 如果PTZ節(jié)點支持絕對或相對的PTZ，則應指定默認的PTZ水平/俯仰和變焦速度。

• DefaultPTZTimeout – 如果PTZ節(jié)點支持連續(xù)運動，則應指定默認超時時間，超時后云臺停止運動。

• PanTiltLimits – 對于支持絕對水平/俯仰的PTZ節(jié)點，應存在水平/俯仰限制元素。如果存在該元素，則表示支持可配置的水平/俯仰限制。如果啟用了限制，則水平/俯仰運動應始終保持在規(guī)定范圍內(nèi)。限制值設置為-INF或+INF時，表示無效限制。

• ZoomLimits – 對于支持絕對變焦的PTZ節(jié)點，應存在變焦限制元素。如果存在該元素，則表似乎支持可配置的變焦限制。如果啟動了限制，則變焦運動應始終保持在規(guī)定范圍內(nèi)。限制值設置為-INF或+INF時，表示無效限制。

• MoveRamp –設備移動時使用的可選加速度斜變。

• PresetRamp –設備在調(diào)用預置位時可選加速斜變。

• PresetTourRamp –設備在執(zhí)行巡航時可選加速斜變

 

引入默認的position/translation/velocity 空間，允許客戶端發(fā)送運動請求，而無需指定特定的坐標系。默認速度用于控制運動請求（absolute,relative,preset）的速度，而無需指定顯式速度。水平/俯仰定義的二維空間限制范圍映射到特定絕對水平/俯仰的位置空間。PTZ節(jié)點至少需要一個水平/俯仰位置空間來支持限制。這些限制適用于所有受支持的絕對、相對和連續(xù)水平/俯仰運動。應在規(guī)定限值的坐標系內(nèi)檢測限值。這在實踐中意味著，即使在不同的坐標系中指定了移動，請求的移動應轉(zhuǎn)換為可檢查限制的限制坐標系。當規(guī)定了相對或連續(xù)的運動，超過規(guī)定的限制時，PTZ裝置必須沿著指定的限制運動。必須相應的解釋變焦限制。