cloud-apilisted
Install: claude install-skill wsadexq/refactored-system
# DJI 上云 API
大疆上云 API 是基于大疆行业版无人机(机场、DJI Pilot 2、遥控器、负载)对外提供的云平台接入接口,采用"端-边-云"架构:**无人机不能直接上云**,必须通过网关设备(大疆机场或遥控器)间接接入。
- 网关设备(机场 / 遥控器)→ 第三方云平台,通信协议为 MQTT / HTTPS / WebSocket
- 网关注册登录时会上报飞机与负载的能力(物模型)
- 本技能只处理云平台侧接入与解析,不涉及飞控底层
## 安装后的路径与文档定位
- 从已加载技能的实际目录读取 `reference/`,并使用该目录下脚本的绝对路径执行命令;任务当前目录不一定是技能目录。
- 安装版自带 `KNOWLEDGE_SOURCES.md`、`THIRD_PARTY_NOTICES.md` 与 `INSTALLATION.md`;源码模式的这些文件在仓库根目录。不要假设安装版父目录仍是源码仓库。
- 深度查询前,运行安装版 `scripts/locate_dji_docs.py`(源码模式用仓库根目录的同名脚本)。用户明确提供路径时传 `--docs-root`;否则依次检查 `DJI_CLOUD_API_DOCS` 和任务当前目录的 `docs/Cloud-API-Doc`。明确配置无效时停止回退并报告。
- 定位成功仅证明路径存在;核对官方目录 Git HEAD 与来源说明基准后,再读取对应官方章节。未核对时不声称是最新或固定版本。
- 缺少官方文档时可依据现有笔记解释和运行离线校验,明确说明来源及覆盖范围;无法核实的字段或兼容性请用户提供官方目录,不猜测、不自动联网下载。
## 何时使用
- 部署大疆上云服务端(MQTT 网关 / HTTPS / WebSocket / 对象存储)
- 解析设备上报的物模型数据(OSD 属性 / 事件 / 服务响应)
- 向设备下发指令(航线任务 / 直播 / 媒体 / 固件升级 / HMS 查询)
- 排查设备上下线、拓扑更新、订阅不到数据、错误码等问题
- 区分两种场景:**Dock-to-Cloud**(机场上云,无人值守)与 **Pilot-to-Cloud**(遥控器 + DJI Pilot 2 上云,有人操作)
## 基础架构
```
第三方云平台(你的服务端)
├── MQTT 网关 ← 设备长连接,收发属性/服务/事件/上下线(Broker)
├── HTTPS 服务 ← 短连接接口(航线管理/媒体管理/地图元素/态势感知)
├── WebSocket 服务 ← 服务端向 Pilot/Web 推送(地图元素/态势感知)
└── 对象存储 ← 航线文件/媒体文件存储
设备端
├── 大疆机场(Dock) → MQTT/HTTPS 上云(Dock-to-Cloud)
├── 遥控器 + DJI Pilot 2 → MQTT/HTTPS/WebSocket/JSBridge 上云(Pilot-to-Cloud)
└── 无人机/负载 → 不直接上云,由网关代理上报
```
## 通信协议速查
| 协议 | 用途 | 关键点 |
|---|---|---|
| MQTT | 设备长连接,属性/服务/事件/上下线/DRC | Topic 前缀 `sys/`(基础)与 `thing/`(物模型),字段按具体 Topic/接口要求携带 `tid`/`bid`/`method`/`data`/`timestamp` |