DJI Cloud API Sample - Dock 3 适配版

🔗 代码仓库: GitHub | Gitee (国内访问速度更快) 🔗 开源大疆航线程序: GitHub

⚠️ 重要说明:

这是一个第三方开发的 DJI Cloud API 适配项目，非 DJI 官方项目

专门针对 DJI Dock 3（机场3） 进行了适配和优化

基于 DJI Cloud SDK 1.2.5 开发

第三方开发的 DJI 云平台示例项目，提供了与 DJI Dock 3 机场及配套无人机进行云端交互的完整解决方案。

💬 技术交流 & 商用咨询: 添加微信（见文末二维码）获取技术支持和商用版本服务

📋 目录

项目简介
功能特性
技术栈
系统架构
环境要求
快速开始
配置说明
API 文档
项目结构
开发指南
常见问题
注意事项
相关链接
免责声明
许可证
贡献
技术支持
交流与商用

📖 项目简介

本项目是基于 DJI Cloud API 开发的第三方云平台示例应用，专门针对 DJI Dock 3（机场3） 进行了适配和功能优化。

💻 界面预览 (开源版)

关于本项目

项目性质: 第三方开发，非 DJI 官方项目
适配设备: DJI Dock 3 机场及配套飞行器
技术基础: 基于 DJI Cloud SDK 1.2.5 和 Cloud API 协议
开发目的: 为开发者提供 Dock 3 云平台集成的参考实现

支持的设备

✅ DJI Dock 3 - 第三代智能机场
✅ DJI Matrice 3D/3TD - Dock 3 配套飞行器
✅ DJI RC Plus - 遥控器（部分功能）

与官方 Demo 的区别

本项目在 DJI Cloud API 基础上进行了以下适配：

针对 Dock 3 的特性进行了功能优化
适配了 Dock 3 的新增设备状态和控制指令
优化了 Matrice 3 系列飞行器的数据处理
提供了更完整的中文文档和示例

✨ 功能特性

核心功能（Dock 3 适配）

🚁 Dock 3 设备管理 - 机场、无人机、遥控器的接入与管理
📍 航线任务 - 支持 Dock 3 的航线任务下发、执行监控
📹 实时直播 - 支持 RTMP、RTSP、WebRTC、GB28181 等多种协议
📷 媒体管理 - Matrice 3D/3TD 照片/视频上传、下载、预览
🗺️ 地图服务 - 设备定位、航线展示、禁飞区管理
📊 设备监控 - Dock 3 OSD 数据、HMS 健康管理、设备状态监控
🔄 固件升级 - Dock 3 及飞行器固件在线升级
📝 日志管理 - 设备日志上传与分析
⚙️ 远程控制 - 云端遥控、相机控制、云台控制

高级功能

🔐 JWT 身份认证
🔌 MQTT 消息通信
🌐 WebSocket 实时推送
📦 对象存储集成（MinIO/阿里云 OSS/AWS S3）
🎯 飞行区域管理
🔧 设备配置同步

🛠️ 技术栈

后端

框架: Spring Boot 2.7.12
语言: Java 11
数据库: MySQL 8.0
缓存: Redis
消息队列: MQTT (Eclipse Paho)
ORM: MyBatis Plus 3.4.2
对象存储: MinIO / 阿里云 OSS / AWS S3
API 文档: Swagger/OpenAPI

前端

框架: Vue 3.2.26
构建工具: Vite 2.4.0
UI 组件: Ant Design Vue 2.2.8
地图: 高德地图 (AMap)
视频播放: flv.js, Agora RTC SDK
状态管理: Vuex 4.0.2
路由: Vue Router 4
HTTP 客户端: Axios
实时通信: MQTT.js, WebSocket

🏗️ 系统架构

┌─────────────────────────────────────────────────────────────┐
│                         前端应用 (Vue 3)                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │ 设备管理 │  │ 航线任务 │  │ 实时直播 │  │ 媒体管理 │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
└─────────────────────────────────────────────────────────────┘
           │                    │                    │
           ▼                    ▼                    ▼
┌─────────────────────────────────────────────────────────────┐
│                    后端服务 (Spring Boot)                     │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │ REST API │  │  MQTT    │  │ WebSocket│  │ Cloud SDK│   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
└─────────────────────────────────────────────────────────────┘
           │                    │                    │
           ▼                    ▼                    ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│    MySQL     │  │     Redis    │  │  对象存储     │
└──────────────┘  └──────────────┘  └──────────────┘
           │
           ▼
┌─────────────────────────────────────────────────────────────┐
│                      MQTT Broker                             │
└─────────────────────────────────────────────────────────────┘
           │
           ▼
┌─────────────────────────────────────────────────────────────┐
│              DJI Dock 3 + Matrice 3D/3TD                     │
└─────────────────────────────────────────────────────────────┘

💻 环境要求

必需环境

JDK: 11 或更高版本
Maven: 3.6+
Node.js: 14.0+
npm/yarn/pnpm: 任意包管理器

依赖服务

MySQL: 8.0+
Redis: 5.0+
MQTT Broker: EMQX/Mosquitto 等
对象存储: MinIO/阿里云 OSS/AWS S3（可选）

🚀 快速开始

1. 克隆项目

# 从 GitHub 克隆
git clone https://github.com/hecongyuan/dji_cloud_dock3.git

# 或者从 Gitee 克隆 (国内访问速度更快)
git clone https://gitee.com/hecongyuan/dji_cloud_dock3.git

cd dji_cloud_dock3

### 2. 初始化数据库

```bash
# 连接到 MySQL 数据库
mysql -u root -p

# 创建数据库
CREATE DATABASE cloud_sample CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 导入初始化脚本
mysql -u root -p cloud_sample < source/mysql/init.sql

3. 配置后端

📖 详细配置说明请参考 CONFIG.md 文档

复制配置文件模板：

cd source/backend_service/sample/src/main/resources
cp application.yml.example application.yml

编辑 application.yml，修改以下关键配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/cloud_sample
    username: root
    password: your_password

  redis:
    host: localhost
    port: 6379

mqtt:
  BASIC:
    host: localhost
    port: 1883
    username: admin
    password: public

oss:
  enable: true
  provider: minio
  endpoint: http://localhost:9000
  access-key: minioadmin
  secret-key: minioadmin
  bucket: dji-cloud

cloud-api:
  app:
    id: your_app_id
    key: your_app_key
    license: your_app_license

⚠️ 重要: 请在 DJI 开发者平台创建应用并获取 App ID、App Key 和 License

4. 启动后端

cd source/backend_service
mvn clean install
cd sample
mvn spring-boot:run

后端服务将在 http://localhost:6789 启动

5. 设备接入配置

Dock 3 设备接入

在 Dock 3 设备上配置云平台信息：
- 平台地址: http://your-server-ip:6789
- MQTT 地址: mqtt://your-server-ip:1883
- App ID: 在配置文件中设置的 cloud-api.app.id
确保 Dock 3 能够访问到服务器的以下端口：
- 6789 - HTTP API 端口
- 1883 - MQTT 端口
- 8083 - MQTT WebSocket 端口（DRC 远程控制）
设备上线后，可在前端页面的设备管理中查看设备状态

6. 启动前端

复制前端配置文件：

cd source/nginx/front_page/src/api/http
cp config.ts.example config.ts

编辑 config.ts，配置后端地址和 DJI 凭证：

export const CURRENT_CONFIG = {
  appId: 'your_app_id',
  appKey: 'your_app_key',
  appLicense: 'your_app_license',
  baseURL: 'http://localhost:6789/',
  websocketURL: 'ws://localhost:6789/api/v1/ws',
}

安装依赖并启动：

cd source/nginx/front_page
npm install
npm run serve

前端应用将在 http://localhost:5173 启动（端口可能不同）

7. 访问应用

前端应用: http://localhost:5173
后端 API 文档: http://localhost:6789/swagger-ui/index.html
WebSocket 地址: ws://localhost:6789/api/v1/ws

⚙️ 配置说明

数据库配置

spring:
  datasource:
    druid:
      url: jdbc:mysql://localhost:3306/cloud_sample?useSSL=false&allowPublicKeyRetrieval=true
      username: root
      password: your_password
      initial-size: 10
      min-idle: 10
      max-active: 20

MQTT 配置

支持两种 MQTT 连接：

BASIC - 基础 MQTT 连接（设备通信）
DRC - 远程控制 MQTT 连接

mqtt:
  BASIC:
    protocol: MQTT  # MQTT/WS/WSS
    host: localhost
    port: 1883
    username: admin
    password: public
    client-id: cloud-api-sample
  DRC:
    protocol: WS
    host: localhost
    port: 8083
    path: /mqtt

对象存储配置

MinIO（推荐用于开发）

oss:
  enable: true
  provider: minio
  endpoint: http://localhost:9000
  access-key: minioadmin
  secret-key: minioadmin
  bucket: dji-cloud
  expire: 3600

阿里云 OSS

oss:
  enable: true
  provider: ALIYUN
  endpoint: https://oss-cn-hangzhou.aliyuncs.com
  access-key: your_access_key
  secret-key: your_secret_key
  region: cn-hangzhou
  bucket: your_bucket
  role-arn: acs:ram::123456789:role/stsrole

AWS S3

oss:
  enable: true
  provider: aws
  endpoint: https://s3.us-east-1.amazonaws.com
  access-key: your_access_key
  secret-key: your_secret_key
  region: us-east-1
  bucket: your_bucket

直播配置

支持多种直播协议：

livestream:
  url:
    # RTMP 推流
    rtmp:
      url: rtmp://localhost:1935/rtp/
    
    # RTSP 流
    rtsp:
      username: dji-cloud-api
      password: 123456
      port: 8554
    
    # WebRTC (WHIP)
    whip:
      url: http://localhost:8088/rtc/v1/whip/?app=live&stream=
    
    # GB28181
    gb28181:
      serverIP: localhost
      serverPort: 8116
      serverID: 41010500002000000001

📚 API 文档

Swagger UI

启动后端服务后，访问：http://localhost:6789/swagger-ui/index.html

主要 API 端点

模块	端点	说明
设备管理	`/manage/api/v1/devices`	设备列表、详情、绑定
航线任务	`/wayline/api/v1/workspaces/{workspace_id}/jobs`	任务创建、执行、监控
媒体文件	`/media/api/v1/workspaces/{workspace_id}/files`	文件上传、下载、删除
实时控制	`/control/api/v1/devices/{device_sn}/drc`	远程控制、相机控制
地图服务	`/map/api/v1/workspaces/{workspace_id}/elements`	地图元素管理
存储服务	`/storage/api/v1/workspaces/{workspace_id}/sts`	临时凭证获取

WebSocket 事件

连接地址：ws://localhost:6789/api/v1/ws

主要事件类型：

device_online - 设备上线
device_offline - 设备离线
device_osd - 设备状态数据
device_hms - 设备健康信息
flight_task_progress - 任务执行进度

📁 项目结构

Cloud-API-Demo/
├── source/
│   ├── backend_service/          # 后端项目
│   │   ├── cloud-sdk/           # DJI Cloud SDK
│   │   └── sample/              # 示例应用
│   ├── nginx/front_page/         # 前端项目
│   │   ├── src/                 # 前端源码
│   │   ├── package.json
│   │   └── vite.config.ts
│   └── mysql/                   # 数据库脚本
│       └── init.sql             # 初始化 SQL
├── LICENSE
└── README.md

🔧 开发指南

后端开发

1. 实现 Cloud SDK 方法

创建服务类继承 SDK 抽象类：

@Service
public class DeviceServiceImpl extends AbstractDeviceService {
    
    @Override
    public void updateTopoOnline(UpdateTopo topo) {
        // 实现设备上线逻辑
        log.info("Device online: {}", topo.getDeviceSn());
    }
}

2. 调用 Cloud SDK 方法

注入服务并调用：

@Service
public class WaylineJobService {
    
    @Autowired
    private AbstractWaylineService waylineService;
    
    public void executeJob(String jobId) {
        waylineService.flightTaskPrepare(jobId);
    }
}

3. 实现 HTTP 接口

实现 SDK 定义的接口：

@RestController
public class DeviceController implements IDeviceApi {
    
    @Override
    public HttpResultResponse<List<Device>> getDevices() {
        // 实现获取设备列表
        return HttpResultResponse.success(deviceList);
    }
}

前端开发

1. API 调用

import { getDevices } from '@/api/manage'

const fetchDevices = async () => {
  const res = await getDevices({ workspace_id: workspaceId })
  if (res.code === 0) {
    devices.value = res.data
  }
}

2. MQTT 订阅

import { useMqtt } from '@/components/g-map/use-mqtt'

const { subscribe } = useMqtt()

subscribe('sys/product/+/status', (topic, message) => {
  console.log('Device status:', message)
})

3. WebSocket 连接

import { useConnectWebsocket } from '@/hooks/use-connect-websocket'

const { connect, on } = useConnectWebsocket()

connect()
on('device_osd', (data) => {
  console.log('OSD data:', data)
})

添加新功能

后端：
- 在 source/backend_service/sample/src/main/java/com/dji/sample/ 下创建新模块
- 定义 Controller、Service、DAO
- 在 application.yml 中添加配置
前端：
- 在 source/nginx/front_page/src/api/ 下添加 API 接口
- 在 source/nginx/front_page/src/components/ 下创建组件
- 在 source/nginx/front_page/src/pages/ 下添加页面
- 在 router 中配置路由

🐛 常见问题

1. 后端启动失败

问题: 数据库连接失败

com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

解决方案:

检查 MySQL 是否启动
确认数据库连接配置正确
检查防火墙设置

2. MQTT 连接失败

问题: 无法连接到 MQTT Broker

解决方案:

确认 MQTT Broker 已启动
检查端口是否被占用
验证用户名密码是否正确

3. 前端无法访问后端 API

问题: CORS 跨域错误

解决方案:

后端已配置 CORS，检查 CorsFilter 配置
确认前端配置的后端地址正确

4. 对象存储上传失败

问题: MinIO 连接失败

解决方案:

确认 MinIO 服务已启动
检查 bucket 是否已创建
验证访问密钥是否正确

5. Dock 3 设备无法上线

问题: Dock 3 连接不上平台

解决方案:

检查 Dock 3 网络连接是否正常
确认 Dock 3 配置的平台地址和端口正确
验证 App ID、Key、License 配置正确
检查服务器防火墙是否开放了必要端口（6789、1883、8083）
查看后端日志 logs/cloud-api-sample.log 排查问题

6. 航线任务执行失败

问题: 任务下发后 Dock 3 无响应

解决方案:

确认航线文件格式符合 Dock 3 要求
检查 Dock 3 当前状态是否允许执行任务
查看设备 HMS 信息，确认无异常告警
检查 MQTT 消息是否正常收发

7. 视频直播无法播放

问题: 前端无法看到实时视频

解决方案:

确认直播服务（RTMP/WebRTC）已正确配置
检查 Dock 3 是否已开启直播推流
验证网络带宽是否足够
查看浏览器控制台错误信息

📌 注意事项

Dock 3 特别说明

设备兼容性: 本项目专门针对 Dock 3 适配，其他型号设备可能需要额外适配
固件版本: 建议 Dock 3 固件版本保持最新，以获得最佳兼容性
网络要求: Dock 3 需要稳定的网络连接，建议使用有线网络或 4G/5G
App 凭证: 必须在 DJI 开发者平台创建应用并获取有效的 License

生产环境部署建议

安全加固:
- 修改默认的数据库密码
- 配置 HTTPS 证书
- 启用 MQTT 认证和 TLS
- 配置防火墙规则
性能优化:
- 使用 Nginx 反向代理
- 配置 Redis 集群
- 优化数据库索引
- 启用 CDN 加速
监控告警:
- 配置日志收集和分析
- 设置系统监控告警
- 定期备份数据库

🔗 相关链接

GitHub 仓库: https://github.com/hecongyuan/dji_cloud_dock3
Gitee 仓库: https://gitee.com/hecongyuan/dji_cloud_dock3
开源大疆航线程序: https://github.com/hecongyuan/dji_way_line
DJI 开发者平台: https://developer.dji.com
Cloud API 文档: https://developer.dji.com/doc/cloud-api-tutorial/cn/
DJI 技术支持: https://sdk-forum.dji.net/

⚠️ 免责声明

本项目为第三方开发的示例项目，仅供学习和参考使用。使用本项目产生的任何问题，开发者不承担责任。生产环境使用请自行评估风险并进行充分测试。

DJI、DJI Dock 3、Matrice 3D/3TD 等为 DJI 公司的注册商标。本项目与 DJI 公司无官方关联。

📝 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🤝 贡献

欢迎提交 Issue 和 Pull Request！

如果这个项目对你有帮助，请给个 Star ⭐️

📞 技术支持

Issues: 在本仓库提交 Issue
DJI 官方文档: https://developer.dji.com/doc/cloud-api-tutorial/cn/
DJI 开发者论坛: https://sdk-forum.dji.net/

💬 交流与商用

技术交流

如需技术交流、问题咨询或商用版本支持，欢迎添加微信：

扫码加作者进入社群，备注：dji_cloud_dock3

商用版本

本项目为开源学习版本。我们同时提供 商业版整套解决方案，包含以下核心产品：

产品模块	说明
🗺️ 商业版航线	专业航线规划与管理系统，支持复杂任务编排、多机协同、定时巡检、航线库管理，提供航线编辑器与 KMZ 导出
🏗️ 三维重建平台	高精度三维模型自动生成，支持倾斜摄影、正射影像输出、点云处理，实景三维可视化与量测分析
🤖 AI 算力平台	智能识别与分析处理平台，适配国产算能（Sophon）及英伟达 NVIDIA Jetson，支持边缘计算 + 云端协同推理

💰 整套价格：¥13.8万（含平台授权 + 部署 + 技术支持）

📞 欢迎咨询：添加微信（见下方二维码）获取详细方案，支持定制开发

如需以下额外服务，也可联系微信咨询：

🏢 企业级定制开发 - 根据业务需求定制功能
🔧 技术支持服务 - 提供专业的技术支持和培训
🚀 部署实施服务 - 协助生产环境部署和优化
📊 功能扩展开发 - 开发更多高级功能模块
🔐 安全加固服务 - 企业级安全方案设计与实施
📱 移动端开发 - iOS/Android 原生应用开发

📖 详细服务内容和案例请查看 CONTACT.md

注意: 本项目为第三方开发，仅供学习和参考使用。生产环境部署请根据实际情况进行安全加固和性能优化。

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
doc		doc
source		source
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
README_SECURITY.md		README_SECURITY.md
docker-compose.yml		docker-compose.yml
jt.png		jt.png
update_backend.sh		update_backend.sh
update_front.sh		update_front.sh
wx.JPG		wx.JPG
配置说明.md		配置说明.md

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

DJI Cloud API Sample - Dock 3 适配版

📋 目录

📖 项目简介

💻 界面预览 (开源版)

关于本项目

支持的设备

与官方 Demo 的区别

✨ 功能特性

核心功能（Dock 3 适配）

高级功能

🛠️ 技术栈

后端

前端

🏗️ 系统架构

💻 环境要求

必需环境

依赖服务

🚀 快速开始

1. 克隆项目

3. 配置后端

4. 启动后端

5. 设备接入配置

Dock 3 设备接入

6. 启动前端

7. 访问应用

⚙️ 配置说明

数据库配置

MQTT 配置

对象存储配置

MinIO（推荐用于开发）

阿里云 OSS

AWS S3

直播配置

📚 API 文档

Swagger UI

主要 API 端点

WebSocket 事件

📁 项目结构

🔧 开发指南

后端开发

1. 实现 Cloud SDK 方法

2. 调用 Cloud SDK 方法

3. 实现 HTTP 接口

前端开发

1. API 调用

2. MQTT 订阅

3. WebSocket 连接

添加新功能

🐛 常见问题

1. 后端启动失败

2. MQTT 连接失败

3. 前端无法访问后端 API

4. 对象存储上传失败

5. Dock 3 设备无法上线

6. 航线任务执行失败

7. 视频直播无法播放

📌 注意事项

Dock 3 特别说明

生产环境部署建议

🔗 相关链接

⚠️ 免责声明

📝 许可证

🤝 贡献

📞 技术支持

💬 交流与商用

技术交流

商用版本

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages