开发者参考手册

DTS（数字孪生服务）提供了丰富的开发者工具与对接接口。本手册提供了外部系统对接、消息解析脚本以及内置 API 的大纲指引（详细内容已迁移至独立的 《DTS对接开发指南》 ），同时保留了空间拓扑与 ImageMask 分析、AI 算法快速落地以及 BV 相机 Profile 介绍的完整内容。如需查阅这些完整本地章节，请点击下方对应链接。

1. 外部系统对接开发

DTS 提供了标准化的数据分发服务，支持第三方系统通过以下方式进行对接开发： - 数据订阅：支持通过 Redis 消息队列、WebSocket 长连接或 HTTP 回调接收设备上报的 BV JSON 数据。 - 服务反控：第三方系统携带 APIKey 调用标准 API，实现对实体的服务调用与控制。 - 详细参考：关于接口地址、请求/返回参数及鉴权方式，请前往 DTS对接开发指南 - 外部系统对接 查阅。

2. 消息解析脚本开发规范

对于采用自定义/透传数据格式的产品，DTS 允许在沙箱环境中编写脚本进行数据转换： - 脚本支持：支持使用 JavaScript (ES6) 和 Python 语言编写消息解析脚本。 - 上行解析：将设备上报的透传/自定义格式数据转换为 DTS 标准的 BV JSON 格式。 - 下行解析：将 DTS 下发的标准 BV JSON 指令转换为设备可识别的特定指令格式。 - 详细参考：关于解析脚本的入参出参定义及编写规范，请前往 DTS对接开发指南 - 消息解析脚本开发规范 查阅。

3. 基础工具类 API 参考

在编写消息解析脚本、请求脚本或数据推送函数时，DTS 提供了多个内置 of 工具类： - Console 类：用于在沙箱环境中打印调试日志。 - CoreApi 类：提供对实体、属性、事件及节点关系的查询与操作接口。 - FileStorage 类：用于临时或持久化存储脚本执行中的文件。 - MockXMLHttpRequest 类：在解析脚本中模拟 HTTP 请求。 - JtsGeometry 类：提供空间拓扑计算与几何对象分析（如判断点是否在多边形内）。 - 详细参考：关于各工具类的 API 函数签名及使用示例，请前往 DTS对接开发指南 - 基础工具类API参考 查阅。

4. 空间拓扑与 ImageMask 高级分析

DTS 支持高级的空间地理计算与影像遮罩（ImageMask）分析： - 空间计算：基于 JTS 提供相交、包含、距离计算等空间拓扑关系判定。 - ImageMask 遮罩：支持利用影像遮罩技术进行地理围栏判定或特定区域的状态计算。 - 详细参考：关于空间数据格式、ImageMask 的算法逻辑及配置示例，请查看本地文档 04.02_空间拓扑与ImageMask高级分析.md。

5. AI 算法的快速应用落地

DTS 支持将外部 AI 算法服务化并快速应用于任务规则引擎中： - 算法注册：在产品服务定义中注册外部 AI 算法的请求地址与入参。 - 任务联动：在任务管理中，通过规则引擎配置在满足条件时自动调用该 AI 算法服务，实现智能闭环控制。 - 详细参考：关于算法服务的接入规范、输入输出设计及落地案例，请查看本地文档 04.03_AI算法的快速应用落地.md。

6. 附录：BV 相机产品 Profile 介绍

介绍了大视景（BV）标准相机的产品本体描述（Profile）： - 功能定义：包含相机常用的属性（如在线状态、云台角度）、事件（如人脸识别、移动侦测）以及服务（如云台控制、抓拍）。 - 详细参考：关于 BV 相机 Profile 的完整 JSON 结构及字段定义，请查看本地文档 04.04_附录：BV相机产品Profile介绍.md。