5.   服務

5.1      PTZ節點

5.1.1.   常規

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

 

所有PTZ節點都應有以下特性：

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

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

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

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

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

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

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

5.1.2.   節點獲取（GetNodes）

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

請求（REQUEST）： 空消息。

響應（RESPONSE）：

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

       設備上現有PTZ節點列表。

錯誤（FAULTS）：

         None

訪問權限類（ACCESS CLASS）：

      READ_MEDIA

5.1.3.    獲取節點（GetNode）

支持PTZ的設備應實現GetNode操作并返回所請求PTZ的屬性節點（如果存在）。否在，設備應以適當的故障信息進行響應。

請求（REQUEST）： 空消息。

      • NodeToken [tt:ReferenceToken]

       對要請求的PTZ節點的引用。

響應（RESPONSE）：

       • PTZNode [tt:PTZNode]

       請求的PTZ節點屬性。

錯誤（FAULTS）：

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

       設備上沒有此類PTZ節點。

訪問權限類（ACCESS CLASS）：

      READ_MEDIA

5.2      PTZ配置

5.2.1.   常規

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• PresetRamp –設備在調用預置位時可選加速斜變。

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

 

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