1. 上云 API 2 FAQ
上云 API 2 知识库
  • 上云 API 2 FAQ
    • 上云 API 2 航线编辑器地图中机库位置与实际位置不一致
    • k3s 安装失败报错：x509: certificate signed by unknown authority
    • RC Pro 安装 Pilot 2 APP 时报错：未安装应用
    • 上云 API 2 中调用 SDK 的 getDeviceList 接口报错 404
    • 上云 API 2 在安装底座管理平台时报错：set password into system management failed: send request failed
    • 上云 API 2 安装底座报错：container loki is unhealthy
    • 在服务器手动部署 上云 API 2 底座后，访问底座管理平台报错：无法访问此网站
    • 在上云 API 2 管理平台更改一些配置后点击保存，一段时间后发现部分容器处于 Created 状态
    • 上云 API 2 在航线编辑器组件中创建航线报错：提交失败，请重试
    • 上云 API 2 执行 CodeMeter 安装脚本失败，提示 dpkg: error processing package codemeter-lite
    • 可视化部署底座时报错：install system management failed: exit status 1
    • 上云 API 2 底座安装 4G 增强图传服务后，4G 网络无法正常连接，设备无法通过 4G 链路上云
    • 上云 API 2 底座可视化部署安装过程中，提示缺少必要依赖包
    • 上云 API 2 航线编辑器，点击左上角返回按钮，无法退回上一级页面
    • 上云 API 2 订阅 subscribeDroneOpenProgress / CloseProgress 接口收不到数据
    • 上云 API 2 驾驶舱组件无法开启机场和无人机直播
    • 上云 API 2 通过 SDK 上传固件超时，提示连接失败
    • 上云 API 2 通过 SDK 提交固件升级后，查询进度无返回，前端组件页面进度停留在 0%
    • 上云 API 2 可视化部署安装底座，上传证书提示错误代码 7011：检测为非法证书
    • 使用上云 API 2 航线编辑组件创建航线保存失败，F12 控制台报错 ERR_CONNECTION_RESET
    • 使用上云 API 2 SDK 接口 createReconstruction 创建建模任务时需要传参 FolderId，这个 id 如何获取
    • 创建建模任务后 监听状态变更接口 listenReconstructionStatusChanged 返回的 state（建图文件状态）一直卡在 12（等待 Terra Cloud 资源中）
    • 如何使用上云 API 2 SDK 接口计算飞机镜头在地面上的覆盖面积
    • 将上云 API 2 航线预览页面封装成 Vue 组件后，切换路由再次进入时页面无法正常渲染
    • 上云 API 2 前端组件在开发环境正常，但部署到生产环境后页面报错 crypto.randomUUID is not a function
    • 使用上云 API 2 SDK 三维重建接口 createReconstruction 如何传参才能生成点云（LAS）？
    • 调用上云 API 2 SDK 接口 liveModule.start 开启直播偶现报错 213003 是什么原因
    • 运行上云 API 2 的 SDK Demo 失败，报错缺少 libatomic.so.1
    • 使用上云 API 2 SDK 接口 subscribeLiveStream() 订阅无人机直播视频帧，一段时间后直播卡顿或 SDK 收不到帧数据
    • 上云 API 2 SDK 初始化失败，日志报错 libVolcEngineRTC.so 加载失败
    • 在 上云 API 2 SDK 回调线程中调用 Future.get() 导致查询超时
    • 卸载上云 API2 底座后 AIO 管理后台仍可访问
    • 前端引入上云 API 2 前端组件的 paas.js 后，控制台输入 window.FH2 返回 undefined
    • 使用上云 API 2 SDK 收不到订阅的监听回调，日志报错 ws is not open / error -3
    • 使用上云 API 2 SDK 接口 createCustomizedFlightAreas 创建多边形限飞区失败，日志报错 err -5、230001
    • 在上云 API 2 前端设备管理组件上传固件失败，网页报错 TimeoutError
    • 建模任务创建后 listenReconstructionStatusChanged 立即回失败态（state=8）
    • 使用上云 API SDK 接口 getFlightTaskList 查询任务列表，传入空 sn 列表查不到任务数据
    • 使用上云 API 2 SDK 接口 createReconstruction 建模成功，但 getModelFileUrl 一直返回空 URL，成果 ZIP 无法生成
    • 一键起飞后实际飞行高度与设置预期不符，飞行器先爬升再下降
    • 上云 API 2 航线编辑器编辑保存后没有 Promise 回调，业务逻辑应写在哪里
    • 访问上云 API 2 前端组件的官方 HTML Demo 驾驶舱页面正常，改为 Vue 项目后驾驶舱页面能加载完成但显示状态异常
    • 前端组件在开发环境可以正常使用，但部署到生产环境后，部分 SDK 资源加载失败
    • 可视化页面部署安装时 「Terra 建模服务」下的「SERVER_IP」应该填内网 IP 还是外网 IP？
    • 飞行任务结束后媒体文件没有正常回传，调用 SDK 接口 getMediaFilesList 查询不到照片
    • 上云 API 2 如何设置航线编辑器组件的地图默认加载中心点
    • 上云 API 2 SDK 初始化正常但获取设备列表返回 ERROR_OPERATION_FAILED（httpCode=0 / errno=113 connect failed）
    • 使用上云 API 2 SDK 接口 getDroneInstance 获取不到飞行器实例
    • 已通过 SDK 获取负载控制权但负载操控接口返回 -6、负载监听无消息
    • 如何使用上云 API 2 SDK 接口 createReconstruction 生成高斯泼溅（3DGS）成果？
    • 使用上云 API 2 航线编辑器组件创建航线后未自动进入航线编辑界面，如何继续编辑航线？
    • 调用 getWaylineList 后业务接口已返回，异步查询结果还未回调
    • 在上云 API 2 可视化页面部署底座时设置密码后点击确定后页面无响应
    • 服务器异常停电，重启上云 API 2 底座服务容器之后报错：container pf-atc-service is unhealthy
    • 管理后台的密码忘记了怎么办？怎么修改管理后台的密码？
    • 在上云 API 2 底座安装包下的 env 文件中修改启用 HTTPS 相关配置后执行 ./setuptools update 报错
    • 在上云 API 2 的管理后台配置三方 Minio 后媒体管理航线管理异常
    • 使用上云 API 2 建模成功但调用 getQualityReport 接口返回状态始终为"质量报告生成中"
    • 在上云 API 2 可视化页面部署成功后 无法正常进入 AIO 管理后台，页面提示：请先激活再使用系统
    • 上云 API 2 底座部署过程中部分容器报错：unhealthy
    • 上云 API 2 手飞设备如何上云
    • 上云 API 2 底座管理平台首次激活扫码无反应，无法扫出激活码
  • 上云 API 2 常见 QA
    • 产品能力和设备运行与管控底座
    • 许可证相关
    • 安装部署
    • 设备上云
    • 前端组件
    • SDK
      • 01 接入与初始化
      • 02 飞行任务
      • 03 设备状态
      • 04 飞行控制
      • 05 媒体文件与建模
      • 06 直播与录制
      • 07 航线管理
      • 08 固件·RTK·飞行区
      • 09 信号地图
  1. 上云 API 2 FAQ

上云 API 2 手飞设备如何上云

上云 API 2 手飞设备上云（JSBridge 方式）#

您可通过在 DJI Pilot 2 内嵌 WebView 中加载自定义 H5 页面，使用 JSBridge 接口实现手飞设备上云。

前提条件#

已安装 最新版本的 DJI Pilot 2
飞机和遥控器已升至最新版本且已完成配对
已获取底座的 MQTT 地址（格式：tcp://IP:端口）
遥控器网络可访问底座 MQTT 地址（默认端口 1883）
已在 DJI 开发者网站申请成为上云 API 的开发者（申请地址：https://developer.dji.com/cn/），获取以下三个凭证：
凭证说明
appId开发者网站上申请的上云 API appId
appKey开发者网站上申请的上云 API appKey
license开发者网站上申请的上云 API license
特别注意： JSBridge 所有接口在调用前必须先完成 License 认证（platformVerifyLicense），未认证情况下发起 JS 通信将失败。

操作步骤#

步骤一：准备 H5 页面#

客户需自行开发一个 H5 页面，部署到遥控器可访问的 Web 服务器上。有两种方式：
方式一（推荐）：使用配套 Skill 生成
参考下方"配套工具"章节，通过 Claude Code Skill 一键生成完整 H5 页面，无需手写代码。
方式二：从零自行开发
参考 JSBridge 官方接口文档，了解所有可用接口及参数说明：
https://developer.dji.com/doc/cloud-api-tutorial/cn/api-reference/pilot-to-cloud/jsbridge.html
在 H5 页面的 verifyLicense 函数中填入在 DJI 开发者网站申请的凭证：

步骤二：在 DJI Pilot 2 中配置云平台入口#

1.
打开 DJI Pilot 2，进入云服务 → 开放平台。
2.
填写 H5 页面的完整访问地址，例如：http://192.168.1.100/cloud_jsbridge.html。

步骤三：在 H5 页面中完成上云连接#

H5 页面加载后，在配置区填写以下参数，然后点击"连接上云"：
参数说明示例
MQTT 地址底座 broker 地址tcp://192.168.1.100:1883
MQTT ClientID 后缀默认值WZR2J2
⚠️ 注意： MQTT ClientID 后缀只填后缀部分，不要把 SN 带进去。代码会自动拼接成 遥控器SN&后缀，若手动填入完整的 SN&后缀 会导致认证失败（403）。
点击"连接上云"后，页面将自动按以下流程执行，日志区会实时显示每个步骤状态：
1.
License 认证
2.
获取设备密钥
3.
建立 MQTT 连接
连接成功后状态栏显示"MQTT 已连接 — 设备在线"。

步骤四：验证上云状态#

状态栏显示"MQTT 已连接 — 设备在线"
点击"检查状态"按钮，日志区显示 thing 已加载: true、MQTT 连接状态: true

步骤五：使用直播功能（按需）#

上云成功后，可点击"加载直播"按钮加载直播模块，支持以下三种直播模式：
模式说明
video-on-demand服务器点播，依赖于 thing 模块，具体的点播命令参见设备物模型的直播服务。
video-by-manual手动点播，配置好直播类型参数之后，在图传页面可修改直播参数，停止直播。
video-demand-aux-manual混合模式，支持服务器点播，以及图传页面修改直播参数，停止直播。
注意：直播请确保遥控器可以访问底座的 TCP 30806、UDP 8000、TCP 1935 端口，如果直播报错，可以尝试在底座的管理平台将直播协议切换成RTMP的再试下

配套工具：JSBridge 上云 H5 生成 Skill#

为简化 H5 页面的开发工作，DJI 提供了一个 Claude Code Skill，可在对话中一键生成可直接部署的上云 H5 页面。

支持的功能#

功能说明
基础上云（必须）设备连接、License 认证、MQTT 建联、断线检测
直播（可选）liveshare 模块，支持 video-on-demand / video-by-manual / video-demand-aux-manual 三种推流模式

安装方式#

前提： 已安装 Claude Code CLI（需 Node.js 18+）。
1.
下载 Skill 压缩包：jsbridge-cloud-skill.tar.gz
2.
解压到 Claude Code 的 skills 目录：
3.
重启 Claude Code，在对话中输入：
/jsbridge-cloud 帮我生成手飞上云 H5 页面
Skill 会引导填写凭证和 MQTT 参数，并将生成的 HTML 写入 /tmp/cloud_jsbridge.html。
上一页
上云 API 2 底座部署过程中部分容器报错：unhealthy
下一页
上云 API 2 底座管理平台首次激活扫码无反应，无法扫出激活码
Built with