1. 快速入门
上云 API 2 说明文档(KOC3)
  • 快速开始
  • 申请许可证
  • 联系我们
  • 软件下载
  • 使用上云 API 2 设备模拟器
  • 鉴权接入指南
  • 部署上云 API 2 应用运行与设备管控底座
    • 部署指南
    • 部署前准备
    • 开始部署
    • 能力扩展
  • 设备上云
    • 设备上云
    • 设备固件版本
  • 集成前端独立组件
    • 集成指南
    • 驾驶舱和设备小窗
    • 驾驶舱模块化配置
    • 设备管理组件
    • 航线组件
    • 直播大屏
    • 飞行记录
    • 集成参考
    • PaasJS 新增特性
  • SDK 文档
    • 基本介绍
      • SDK 简介
      • 功能特性
    • 快速入门
      • 准备工作
      • 使用流程
    • 接口调用
      • 接口调用时序图
    • SDK API 文档
      • 使用 API 文档查阅接口详情
    • SDK版本迁移指南
      • 迁移概述
      • 新增方法详情
      • API 变更详情
      • 迁移操作步骤
    • 功能集合
      • SDK初始化
      • SDK配置
      • DRC链路
      • 飞机状态监听
      • 飞向目标点
      • 飞行参数设置
      • 飞行记录导出
      • POI 环绕飞行
      • 一键起飞
      • 航线任务管理
      • 航线任务控制
      • 航线资产管理
      • 机场状态监听
      • 控制权管理
      • 机场控制
      • 飞行控制
      • AI Box 管理
      • AI 智能告警
      • 机载 AI 控制
      • 机载 AI 算法管理
      • PSDK 控制
      • PSDK 资源管理
      • RTK 标定
      • 安全服务
      • 固件管理
      • 媒体服务
      • 日志管理
      • 三维重建
      • 设备管理
      • 设备保修维护
      • 设备健康管理
      • 设备远程调试
      • 设备在线状态
      • 相机控制
      • 直播录制
      • 直播设备管理
      • 直播视频流
      • 直播同步
      • 中继器控制
      • 自定义 SEI
      • WHEP 自定义拉流
      • 网络测速
      • 地图元素管理
      • 频闪灯配置
  • 使用上云 API 2 AI Plugin
    • 上云 API 2 AI Plugin 使用指南
  • 使用上云 API 2 二次开发 Demo
    • 上云 API 2 二次开发 Demo 部署指南
    • 上云 API 2 二次开发 Demo - 无人机管理平台使用说明
  • 排障指南
    • 前端独立组件排障指南
    • SDK排障指南
  1. 快速入门

使用流程

前提条件#

已安装 JDK 8 或更高版本。
已获取 SDK 和 Demo。
已引入 Jar 包。

一、通过Flight Hub SDK Java Demo 快速入门#

Flight Hub SDK Java Demo 展示了如何使用 Flight Hub SDK 视频直播的主要功能。Demo 提供了完整的交互式和非交互式运行模式,支持视频直播核心 SDK 功能。
flight_hub_sdk_demo/
├── src/main/java/com/dji/flighthubsdk/demo/
│   ├── FlightHubSDKDemo.java      # 主演示程序
│   └── ConfigManager.java         # 配置管理器
├── config.json                    # JSON 配置文件
├── build.sh                       # 构建脚本
└── README.md                      # 说明文档
环境要求:
Java:Java 1.8 或更高版本
操作系统:Linux (x86_64)
CPU 架构: amd64 / x86_64
网络:能够访问 FlightHub 服务器

1. 配置 Demo的config 文件#

创建 config.json 配置文件:
{
  "server": {
    "address": "http://xx.xx.xx.xx",
    "port": "30812",
    "notification_server": "ws://xx.xx.xx.xx:30812/openapi/v0.9/notification/ws/v1/notifications"
  },
  "sdk": {
    "log_level": "info",
    "log_to_console": false,
    "log_file_path": "flight_hub_sdk.log",
    "log_max_file_size": 4194304,
    "log_max_files": 1000,
    "drtc_config_path": "drtc_config_node.json"
  },
  "app": {
    "encoding": "UTF-8",
    "working_dir": "."
  },
  "rtmp": {
    "server_url": "rtmp://xx.xx.xx.xx/live/",
    "stream_key": "livestream?secret=XXXXXX",
    "frame_rate": 30,
    "bitrate": 4000000,
    "width": 1920,
    "height": 1080,
    "enabled": false
  },
  "auth": {
    "header_key": "x-demo-uuid",
    "header_value": "YOUR_AUTH_VALUE"
  }
}

2. 设置配置文件#

创建 config.properties 文件指定 SDK JAR 路径:

3. 编译和运行#

使用 Gradle(推荐)
使用构建脚本

4. 使用交互式模式#

1.
启动程序。
建议拿到包后先使用 demo 文件夹下已打包好的 flight-hub-sdk-demo-executable.jar, 填写 config.json 文件后先执行一次测试环境。
2.
程序启动流程。
自动加载配置文件
初始化 SDK
获取设备列表
选择设备(如果多个设备)
显示主菜单
[1] 拉取码流
[2] 拍照
[3] 退出
[4] 监听飞机 OSD
[5] Flyto
[6] Flyto Stop
...
- 输入数字选择功能(1-13)
- 按Enter键执行功能
- 观察日志输出
- 按Enter键返回主菜单

部分功能测试详解#

选取设备#

设备选择:终端上将自动拉取设备列表,输入对应数字选择对应设备进行测试。

拉取码流测试#

选择:输入 1 并按 Enter
功能:获取机库和飞行器直播流
输出:实时码流数据保存到 stream_data/ 目录
文件:dji_stream_dock_*.h264, dji_stream_drone_*.h264
停止:按 Enter 键停止

拍照测试#

选择:输入 2 并按 Enter
功能:执行飞行器拍照操作
输出:拍照成功/失败状态
停止:按 Enter 键返回

监听飞机 OSD 测试#

选择:输入 4 并按 Enter
功能:监听飞行器状态数据
输出:电池、姿态、位置、模式、风速信息
停止:按 Enter 键返回

FlyTo 飞行测试#

选择:输入 5 并按 Enter
功能:执行点到点飞行任务
输出:飞行任务启动状态和进度
停止:按 Enter 键返回

控制权测试#

获取控制权:选择 8 或 11
释放控制权:选择 9 或 12
监听状态:选择 10 或 13
输出:控制权状态变化

常见错误及解决方法#

SDK 初始化失败
设备连接失败
检查设备序列号是否正确
确认设备在线状态
验证网络连接

调试方法#

启用详细日志。
{
  "sdk":{
    "log_level":"debug"
  }
}

二、单功能场景#

下文以调用获取飞行器实例、执行拍照接口,实现操控飞行器拍照为例。
上一页
准备工作
下一页
接口调用时序图
Built with