拓展功能

PTZ（Pan Tilt Zoom）控制 中的 扩展功能 主要包含了三个部分，收藏点、联动点、全景拼接。

• 收藏点：PTZ 提供了坐标的收藏功能，用户通过添加收藏点按键，可以单独的保存当前画面和当前 PTZ 坐标。并且可以对当前的收藏点进行自定义命名。
• 联动点：相当于简化版本的收藏点，最大上限为四个，不支持自定义命名。
• 全景拼接：全景拼接是指通过 PTZ 的转动，对设备周围的环境进行拍摄。对获得的照片进行拼接最后获得一个设备周围的 360°全景图像。

收藏点

收藏点的面板如下：

添加收藏点的方式如下：

1. 用户通过 App 键控设备至期望位置，单击添加收藏点，并对其命名，此操作通过 DP 下发至设备，通过 E_TY_MSG_PTZ_PRESET_ADD 消息发送至 PTZ 组件。

2. 收到此消息后，PTZ 组件会先判断时候收藏点是否已经满了，满了则会上报添加收藏点失败，否则就会读取当前位置存入PTZ 配置，并且分配一个 ID 给此收藏点作为索引且通过发送 E_TY_MSG_PTZ_PRESET_ADD 消息到 event 组件上报云端。

   添加收藏点时，默认按照 Pan 变大方向排序保存，方便之后收藏点巡航的路径规划。

删除收藏点的方式如下：

1. 用户通过 App 下发 DP 至设备。

2. 设备通过 _TY_MSG_PTZ_PRESET_DEL 消息发送至 PTZ 组件，通过索引号对对应的收藏点配置进行删除，并上报删除成功。若找不到索引的收藏点则上报删除失败。

   收藏点最大数量为 16，达到最大数量后，需要删除收藏点才能继续新建收藏点。

联动点

添加联动点与添加收藏点流程类似。用户使用 App 下发 DP 添加联动点，但是联动点不需要命名，只有联动点需要区分，PTZ 组件收到 E_TY_MSG_PTZ_LINK_POS_SET。

全景拼接

全景拼接功能是运用 PTZ 的运动，对若干位置的进行拍摄，并且将拍摄的照片上传进行算法拼接，用户就能在 App 中查看到拼接完成的全景图。

全景拼接流程如下：

1. 设计上，不同的拼接类型由 App 下发至设备，同样设备通过消息组件的 E_TY_MSG_PTZ_PANORAMA 消息类型将命令 E_PANORAMA_START 发送至 PTZ 组件。
2. PTZ 组件收到此命令时将会判断是否在自检中，若在自检中则会上报设备自检中无法使用全景拼接功能，若设备不在自检中则保存消息中附带的全景拼接相关的信息至 PTZ 配置，并且进行自检。
3. 在自检完成后，PTZ 电机运动至第一目标位置，在到达位置后 PTZ 组件通过消息组件的 E_TY_MSG_PTZ_PANORAMA 消息类型向 event 组件发送 E_PANORAMA_SEND 命令。
4. event 会调动抓图组件抓图并通过 SDK 上传图片至 App，完成后通过上述消息类型发送 E_PANORAMA_SEND_DONE 至 PTZ 组件。
5. PTZ 收到后运动至下一个点然后重复上述流程，直到传完所有拼接所需图片。
6. 全景拼接的设备端任务结束，返回全景拼接前位置。

若在上述任意过程中发生异常（断网导致图片发送失败，隐私模式本地开启等），可通过消息组件的相同消息类型发送 E_PANORAMA_EXIT 命令来中断 PTZ 运动，并且返回之前的位置。