# Cloud-API

**Repository Path**: gdu-sdk/cloud-api

## Basic Information

- **Project Name**: Cloud-API
- **Description**: Cloud-API是无人机机库/机载设备直接接入到第三方WEB应用平台的API接口套件，通过标准网络协议与数据规范，直接调用机库无人机相关功能。
该技术方案旨在赋能客户构建独立云端应用系统，实现远程设备监控、任务调度及数据管理等功能，无需依赖我司UVER飞行平台，从而满足客户对自主可控、高度定制化的云端平台应用需求，但开发门槛略高，需客户独立开发设计相关飞行管理业务流程。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 12
- **Forks**: 3
- **Created**: 2025-09-04
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloud-API

#### 介绍
普宙机库上云 API 主要是采用业界通用的 MQTT、HTTPS 和 WebSocket 协议，把飞机的能力抽象成物联网设备的物模型，开发者可以很方便的基于这个物模型进行业务开发，同时不用去关心飞机本身复杂的飞行控制问题。

#### 软件架构
![上云api架构](https://developer.gdu-tech.com/img/mobile-sdk-framework.fdc31acb.png)


#### 安装教程

1.  准备一个MQTT Broke服务器，并提供 IP、端口号、账号和密码

2.  电脑和机库使用网线直连，进入到嵌入式平台（http://145.192.1.162:8099/EmbeddedWeb/nestControl）中进行配置 系统设置--通讯配置--上云API MQTT，进入嵌入式平台的账号密码联系技术支持提供

![配置上云api mqtt](images/README.${unixTime}.png)

3.  进入嵌入式平台的产测模式，打开上云api3.0的开关即可

（1）进入调试模式

![进入调试模式](images/README.${unixTime}-1.png)

（2）进入工具箱

![进入工具箱](images/README.${unixTime}-2.png)

（3）进入产测模式

![进入产测模式](images/README.${unixTime}-3.png)

（4）选择机库成果配置为 飞机主动上传成果文件 ，打开上云api开关 使用上云 API 3.0（新版）

![打开开关](images/README.${unixTime}-4.png)

(5) 配置完成，退出产测模式（切记，一定要退出）

4. 机库重启

![机库重启](images/image.png)

#### 常见问题

[FAQ.md](FAQ.md)

#### 调试

打开MQTTX工具，监听机库的OSD消息，正常上报后，即为配置完成。

#### 贡献指南

欢迎贡献代码和文档。请遵循以下步骤：

1. Fork 项目。
2. 创建新分支。
3. 提交更改。
4. 发起 Pull Request。