5.   服務(wù)

5.1      PTZ節(jié)點(diǎn)

5.1.1.   常規(guī)

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

 

所有PTZ節(jié)點(diǎn)都應(yīng)有以下特性：

• Token – 用于引用云臺節(jié)點(diǎn)的唯一標(biāo)識符。

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

• SupportedPTZSpaces – PTZ節(jié)點(diǎn)可用的坐標(biāo)系列表。對于每個坐標(biāo)系，云臺節(jié)點(diǎn)應(yīng)指定其允許范圍。

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

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

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

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

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

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

請求（REQUEST）： 空消息。

響應(yīng)（RESPONSE）：

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

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

錯誤（FAULTS）：

         None

訪問權(quán)限類（ACCESS CLASS）：

      READ_MEDIA

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

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

請求（REQUEST）： 空消息。

      • NodeToken [tt:ReferenceToken]

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

響應(yīng)（RESPONSE）：

       • PTZNode [tt:PTZNode]

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

錯誤（FAULTS）：

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

       設(shè)備上沒有此類PTZ節(jié)點(diǎn)。

訪問權(quán)限類（ACCESS CLASS）：

      READ_MEDIA

5.2      PTZ配置

5.2.1.   常規(guī)

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

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

• PTZNodeToken – 對PTZ配置所屬的PTZ節(jié)點(diǎn)的強(qiáng)制引用。

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

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

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

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

• DefaultAbsoluteZoomPositionSpace – 如果PTZ節(jié)點(diǎn)支持絕對變焦運(yùn)動，則應(yīng)默認(rèn)指定一個絕對變焦位置空間。

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

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

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

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

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

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

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

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

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

 

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