DJI/shangyun: 上云API二次开发项目仓库 @ 6be85e26e7846ba72f81dd67a728c970ea688779

上云API二次开发项目仓库

Ryuiso 6be85e26e7 no message		hai 5 meses
Backend	6be85e26e7 no message	hai 5 meses
Web	4f68378cc9 分享按钮位置修改	hai 10 meses
docs	cfe84b070c 移动位置	hai 1 ano
.gitignore	b726226434 Initial commit	hai 1 ano
README.md	38358dab29 更新 'README.md'	hai 1 ano

上云 API v1.10.0 发布记录

发布日期

2024.04.07

发布列表

Matrice 3D/3TD 设备属性：
- 新增广角镜头、变焦镜头、红外测温相关设备属性
- 相机模式（camera_mode）枚举值变更
大疆机场 2：
- 设备属性新增静音模式
- 直播功能：
- 新增 WebRTC 直播协议类型
- 新增直播相机切换协议
- 指令飞行功能：
- 新增相机曝光设置、红外相机温度显示等负载控制能力
- 完善夜间作业能力：设置对焦模式、切换低光智能模式等
- 新增全景图拍照模式
- 新增负载控制能力：框选变焦
- 新增自定义飞行区功能，并提供了自定义飞行区文件模板
- 新增 AirSense 功能

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Pilot 2	9.1.0.21
M350 RTK	09.01.01.02
Matrice 30/30T	09.01.00.06
M300 RTK（搭配 DJI RC Plus）	59.01.00.01
M300 RTK（搭配 DJI 带屏遥控器行业版）	09.00.05.03
DJI RC Plus	03.02.09.07
DJI 带屏遥控器行业版	09.00.05.01
Mavic 3E/3T Mavic 3M	09.02.07.06
DJI RC Pro 行业版	02.01.03.19

机场上云

产品	固件版本
Matrice 3D/3TD	09.02.0108
DJI RC Pro 行业版	02.01.0319
大疆机场 2	09.02.0108
Matrice 30/30T	09.01.0006
DJI RC Plus	03.02.0907
大疆机场	01.06.1704

上云 API v1.9.0 发布记录

发布日期

2024.02.22

发布列表

航线文件格式（DJI WPML）：
- 新增全景图拍照动作支持
- 航带飞行新增支持变高航带
大疆机场：
- 设备属性新增静音模式
- 直播功能：新增 WebRTC 直播协议类型
- 指令飞行功能：
- 新增相机曝光设置、红外相机温度显示等负载控制能力
- 完善夜间作业能力：设置对焦模式、切换低光智能模式等
- 新增全景图拍照模式
- 新增支持 POI
- 新增自定义飞行区功能，并提供了自定义飞行区文件模板。

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Pilot 2	9.1.0.21
M350 RTK	09.01.01.02
Matrice 30/30T	09.01.00.06
M300 RTK（搭配 DJI RC Plus）	59.01.00.01
M300 RTK（搭配 DJI 带屏遥控器行业版）	09.00.05.03
DJI RC Plus	03.02.09.07
DJI 带屏遥控器行业版	09.00.05.01
Mavic 3E/3T Mavic 3M	09.00.05.05
DJI RC Pro 行业版	02.01.02.02

机场上云

产品	固件版本
Matrice 3D/3TD	09.00.06.01
DJI RC Pro 行业版	02.01.02.02
大疆机场 2	09.00.06.01
Matrice 30/30T	09.01.0006
DJI RC Plus	03.02.0907
大疆机场	01.06.1704

上云 API V1.8.0 发布记录

发布日期

2023.12.11

发布列表

新增支持大疆机场 2 和 Matrice 3D/3TD 机型
航线文件格式（DJI WPML）新增 Matrice 3D/3TD 机型对字段的支持
大疆机场 2 的物模型协议相对于大疆机场的物模型协议差异如下：
- 航线管理功能：下发任务（Method: flighttask_prepare）新增航线精度类型字段（wayline_precision_type）
- 远程调试功能：新增 4G Dongle 相关协议
- 指令飞行功能：
- 一键起飞协议（Method: takeoff_to_point）中部分字段为必填项
- flyto 飞向目标点(Method: fly_to_point) 和一键起飞（Method: takeoff_to_point）协议新增最低飞行高度说明：飞行器有最低飞行高度(20 m)安全保障机制，如果飞行器相对起飞点高度低于 20 m，会先上升到 20 m

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Pilot 2	8.0.0.38
M350 RTK	08.00.00.04
Matrice 30/30T	08.00.00.03
M300 RTK（搭配 DJI RC Plus）	58.00.00.10
M300 RTK（搭配 DJI 带屏遥控器行业版）	07.00.01.00
DJI RC Plus	02.02.05.07
DJI 带屏遥控器行业版	07.00.01.01
Mavic 3E/3T Mavic 3M	07.01.20.01
DJI RC Pro 行业版	02.01.01.08

机场上云

产品	固件版本
Matrice 3D/3TD	09.00.01.00
DJI RC Pro 行业版	02.01.01.08
大疆机场 2	09.00.01.00
Matrice 30/30T	08.00.0003
DJI RC Plus	02.02.0405
大疆机场	01.05.0905

上云 API V1.7.0 发布记录

发布日期

2023-09-18

发布列表

航线管理功能
- 新增模拟飞行调试 simulate_mission
- 新增航线 2.0 功能
- 新增 return_home_info 事件通知
指令飞行功能
- 新增模拟飞行调试 simulate_mission
- 上线指令飞行 2.0 功能
- 新增 lookat camera_look_at 与分屏协议 camera_screen_split
- 新照片、视频存储设置协议 photo_storage_set 和 video_storage_set
新增 ESDK 互联互通、PSDK 互联互通
新增 PSDK 和喊话器相关协议
新增 AirSense 功能

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
M350 RTK	07.01.00.01
Matrice 30/30T	07.01.00.26
M300 RTK（搭配 DJI RC Plus）	57.01.00.01
M300 RTK（搭配 DJI 带屏遥控器行业版）	07.00.01.00
DJI RC Plus	02.02.0405
DJI 带屏遥控器行业版	07.00.01.01
Mavic 3E/3T Mavic 3M	07.01.10.03
DJI RC Pro 行业版	02.01.00.03

机场上云

产品	固件版本
Matrice 30/30T	07.01.00.26
DJI RC Plus	02.02.0405
大疆机场	01.05.0902

上云 API V1.6.0 发布记录

发布日期

2023-07-18

发布列表

飞行器设备属性更新：增加 RID 工作状态、国家区域码

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
M350 RTK	07.00.00.02
Matrice 30/30T	07.00.01.46
M300 RTK（搭配 DJI RC Plus）	57.00.01.00
M300 RTK（搭配 DJI 带屏遥控器行业版）	07.00.01.00
DJI RC Plus	01.02.04.45
DJI 带屏遥控器行业版	07.00.01.01
Mavic 3E/3T Mavic 3M	07.00.01.02
DJI RC Pro 行业版	02.00.05.01

产品	Pilot版本
DJI RC Plus	7.0.3.9
DJI RC Pro 行业版	7.0.2.2
DJI 带屏遥控器行业版	7.0.2.5

机场上云

产品	固件版本
Matrice 30/30T	07.00.0146
DJI RC Plus	01.02.0445
大疆机场	01.04.0705
DJI Pilot 2	7.0.3.9

上云 API V1.5.0 发布记录

发布日期

2023-05-18

发布列表

新增支持机型：Matrice 350 RTK
Matrice 300 RTK 新增支持遥控器：DJI RC Plus
航线管理教程新增断点续飞内容
告警文案查询json文件更新
- hms.json

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
M350 RTK	07.00.00.01
M3E/M3T/M3M	06.01.06.06
M30/M30T	06.01.10.02
M300 RTK	57.00.01.00（仅支持 DJI RC Plus）
M300 RTK	07.00.01.00（仅支持 DJI 带屏遥控器行业版）
DJI RC Plus	01.02.04.40
DJI RC Pro 行业版	02.00.04.07
DJI 带屏遥控器行业版	07.00.01.00

产品	Pilot版本
DJI RC Plus	7.0.1.0
DJI RC Pro 行业版	6.1.2.2

机场上云

产品	固件版本
M30/M30T	06.02.0803
DJI RC Plus	01.02.0367
大疆机场	01.03.0902 一旦机场固件版本升级至 01.03.0902，不允许回滚，因为这将导致设备上线异常。
DJI Pilot 2	6.1.2.2

上云 API V1.4.0 发布记录

发布日期

2023-04-25

发布列表

功能集合 > 机场功能集：新增指令飞行教程
云端 API > MQTT：
- 航线管理：新增 航线暂停和航线恢复的协议以及断点续飞的能力
- 远程日志：新增支持 minio
- Topic 定义：新增 DRC Topic 与结构示例
- 设备属性：新增指令飞行相关设备属性、调色盘属性
- 新增指令飞行功能：
- 飞行控制：飞行方向和云台转向控制、一键起飞、flyto
- 负载控制：拍照、录像、停止录像、双击 AIM等
- 事件上报：避障、HSI 信息、直播链路延迟信息
错误码：新增指令飞行相关错误码

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
M3E/M3T/M3M	06.01.06.06
M30/M30T	06.01.10.02
M300 RTK	04.01.00.00
DJI RC Plus	01.02.03.66
DJI RC Pro 行业版	02.00.04.07
DJI Pilot 2	6.1.2.2

机场上云

产品	固件版本
M30/M30T	06.02.0803
DJI RC Plus	01.02.0367
大疆机场	01.03.0902 一旦机场固件版本升级至 01.03.0902，不允许回滚，因为这将导致设备上线异常。
DJI Pilot 2	6.1.2.2

即将支持的功能列表

飞行器和机场可以通过私有 4G 增强图传服务器传输数据

上云 API V1.3.2 发布记录

发布日期

2023-03-10

发布功能列表

机场：

设备属性：新增机场空调状态，更新飞行器电池保养信息
配置更新：新增 License 配置
航线任务：新增条件任务
远程调试：新增机场空调工作模式切换

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
M3E/M3T/M3M	06.01.06.06
M30/M30T	06.01.10.02
M300 RTK	04.01.00.00
DJI RC Plus	01.02.03.66
DJI RC Pro 行业版	02.00.04.07
DJI Pilot 2	6.1.2.2

机场上云（适配实体机场，非单板）

产品	固件版本
M30/M30T	06.01.10.02
DJI RC Plus	01.02.03.66
大疆机场	01.02.05.00
DJI Pilot 2	6.1.2.2

即将支持的功能列表

指令飞行

上云API V1.3.1 发布记录

发布日期

2022-12-12

发布功能列表

机场上云API 远程调试:
- 新增 API: 图传增强
HMS 告警文案更新
Pilot上云API 媒体管理：
- 媒体文件上传结果上报 API 增加上传文件结果码
- 新增 API：文件组上传完成后回调
新增机型支持：DJI Mavic 3 多光谱版
Demo 新增example: 固件管理、媒体优先级上传、图传增强

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列 DJI Mavic 3 多光谱版	05.00.05.06
DJI RC Pro	02.00.03.03
DJI Pilot 2	5.2.1.3

产品	固件版本
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云（适配实体机场，非单板）

产品	固件版本
Matrice 30 系列	05.01.02.14
DJI RC Plus	01.02.03.39
大疆机场	00.03.00.04
DJI Pilot 2	6.0.1.1

即将支持的功能列表

机场上云API：

飞行器急停控制
飞行器返航备降点控制
一键自检

上云API V1.3.0 发布记录

发布日期

2022-11-18

发布功能列表

机场上云API：

远程调试：飞行器电池保养状态切换、飞行器电池模式切换、机场声光报警开关切换
媒体管理：媒体文件上传优先级控制
航线管理：设备返航退出状态通知

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列	05.00.02.04
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云（适配实体机场，非单板）

产品	固件版本
Matrice 30 系列	05.01.02.12
大疆机场	00.03.00.01
DJI Pilot 2	6.0.1.1

即将支持的功能列表

机场上云API：

设备通信备份链路切换
飞行器急停控制
飞行器返航备降点控制
一键自检

上云API V1.3.0 beta3 发布记录

发布日期

2022-11-14

发布功能列表

机场：

新增配置更新协议：支持配置 NTP 服务 Host

修复的问题

机场部署时，MQTT 账号密码设置无效

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列	05.00.02.06
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云（适配实体机场，非单板）

产品	固件版本
Matrice 30 系列	05.01.02.12
大疆机场	00.03.00.01
DJI Pilot 2	6.0.0.25

即将支持的功能列表

媒体文件上传优先级控制
飞行器电池保养状态切换
飞行器设备退出状态通知
机场电池保存模式切换
机场声光报警开关切换

上云API V1.3.0 beta2 发布记录

发布日期

2022-11-04

发布功能列表

机场：

设备管理功能，新增设备属性设置API，支持以下几项的飞行器属性设置。
- 飞行器夜航灯状态 night_lights_state
- 限高 height_limit
- 限远 distance_limit_status
- 避障 obstacle_avoidance
新增机场属性：

机场属性	说明	结构
activation_time	机场激活时间(unix时间戳)	int
maintain_status	机场保养状态	struct
air_conditioner_mode	空调工作模式	enum
battery_store_mode	电池运行模式	enum
alarm_state	机场声光报警状态	enum
drone_battery_maintenance_info	飞行器电池保养信息	struct
backup_battery	机场备用电池信息	struct

新增 Demo 机场功能预览视频
新增 Mavic 3 行业系列相关参数到航线文件格式
更新云端 API 错误码

修复的问题

机场无法使用minio：已修复

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列	05.00.02.04
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云（适配实体机场，非单板）

产品	固件版本
Matrice 30 系列	04.05.12.14
大疆机场	04.05.12.19
DJI Pilot 2	6.0.0.25

即将支持的功能列表

媒体文件上传优先级控制
飞行器电池保养状态切换
飞行器设备退出状态通知
机场电池保存模式切换
机场声光报警开关切换

上云API V1.3.0 beta1 发布记录

发布日期

2022-10-21

发布功能列表

机场：

直播功能新增接口设置直播镜头
航线管理功能逻辑优化：
- 废弃接口：创建航线任务
- 新增接口：下发任务，执行任务，取消任务

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列	05.00.02.04
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云

产品	固件版本	备注
Matrice 30 系列大疆机场 DJI Pilot 2	04.05.12.14 00.02.05.14 6.0.0.25	适配实体机场（非单板）

即将支持的功能列表

机场新增：

通信链路切换
电池保养状态切换
电池保存模式切换
声光报警开关

上云API V1.2.0 发布记录

发布日期

2022-09-09

发布功能列表

机场新增支持：

HMS 功能、远程调试、固件升级、远程日志
一键返航
文件上传新增支持对象存储：aws、minio

支持产品列表与固件版本

DJI Pilot 2 上云

产品	固件版本
DJI Mavic 3 行业系列	05.00.02.04
Matrice 30 系列	04.05.10.03
Matrice 300 RTK	04.01.00.00
DJI Pilot 2	5.0.2.9

机场上云

产品	固件版本
Matrice 30 系列大疆机场 DJI Pilot 2	04.01.0021 99.02.0305 6.0.0.24

即将支持的功能列表

机场新增支持：

直播切换镜头
远程控制4G图传
航线任务逻辑优化：增加指令预下发、暂停等功能

DJI Pilot 2 新增支持：

文件上传新增支持对象存储：minio
媒体管理：
1. 新增上报文件夹上传结果接口：提供上传文件总数与成功上传文件数
2. 优化上报文件上传结果接口：提供媒体文件上传结果的标志位

上云API V1.1.0 发布记录

发布日期：

2022-07-22

重点功能：

支持通过机场上云。
支持将机场绑定到组织进行自定义的设备管理。
支持机场属性上报、上下线。
支持机场摄像头、无人机进行视频直播，直播协议支持RTMP、Agora、GB28181、RTSP。
支持机场通过云端下发航线任务。
支持机场自动上传媒体文件到云端。

支持产品列表：

DJI M30系列 + 大疆机场

上云API V1.0.0 发布记录

发布日期：

2022-03-21

重点功能：

支持无人机通过DJI Pilot 2登录注册上云（私有云或公有云）。
支持无人机视频直播，直播协议支持RTMP、Agora、GB28181、RTSP。
支持从DJI Pilot 2中直接发起直播请求。
支持DJI Pilot 2航线库云端同步。
支持大疆航线文件格式，全新的航线文件格式支持在M30系列、M300 RTK及后续新机型上运行。
支持DJI Pilot 2媒体库，支持媒体自动上传及手动上传。
支持DJI Pilot 2态势感知、地图元素功能。
支持DJI Pilot 2 内嵌webview上运行三方web页面。
支持DJI Pilot 2打开第三方App应用。
支持DJI Pilot 2 Log日志拉取。

支持产品列表：

DJI M30系列 + DJI Pilot 2
DJI M300 RTK + DJI Pilot 2

备注：该版本功能暂不支持大疆机场。

支持固件版本：

M300 RTK: v04.00.00.21
DJI Smart Controller: v04.00.00.18
M30 Series: v00.04.0501
DJI RC Plus: v01.02.0108
DJI Pilot 2: v4.0.0.74

已知问题列表：

媒体文件上传至minio对象存储时会出现上传失败的现象。

README.md

上云 API v1.10.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API v1.9.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API V1.8.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API V1.7.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API V1.6.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API V1.5.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

上云 API V1.4.0 发布记录

发布日期

发布列表

支持产品列表与固件版本

即将支持的功能列表

上云 API V1.3.2 发布记录

发布日期

发布功能列表

支持产品列表与固件版本

即将支持的功能列表

上云API V1.3.1 发布记录

发布日期

发布功能列表

支持产品列表与固件版本

即将支持的功能列表

上云API V1.3.0 发布记录

发布日期

发布功能列表

支持产品列表与固件版本

即将支持的功能列表

上云API V1.3.0 beta3 发布记录

发布日期

发布功能列表

修复的问题

支持产品列表与固件版本

即将支持的功能列表

上云API V1.3.0 beta2 发布记录

发布日期

发布功能列表

修复的问题

支持产品列表与固件版本

即将支持的功能列表

上云API V1.3.0 beta1 发布记录

发布日期

发布功能列表

支持产品列表与固件版本

即将支持的功能列表

上云API V1.2.0 发布记录

发布日期

发布功能列表

支持产品列表与固件版本

即将支持的功能列表

上云API V1.1.0 发布记录

发布日期：

重点功能：

支持产品列表：

上云API V1.0.0 发布记录

发布日期：

重点功能：

支持产品列表：

支持固件版本：

已知问题列表：