5.   服務(wù)

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

5.1.1.   常規(guī)

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

 

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

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

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

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

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

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

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

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

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

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

請(qǐng)求（REQUEST）： 空消息。

響應(yīng)（RESPONSE）：

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

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

錯(cuò)誤（FAULTS）：

         None

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

      READ_MEDIA

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

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

請(qǐng)求（REQUEST）： 空消息。

      • NodeToken [tt:ReferenceToken]

       對(duì)要請(qǐng)求的PTZ節(jié)點(diǎn)的引用。

響應(yīng)（RESPONSE）：

       • PTZNode [tt:PTZNode]

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

錯(cuò)誤（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配置包含對(duì)其所屬PTZ節(jié)點(diǎn)的引用。客戶端無(wú)法更改此引用。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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