1. 上云 API 2 常见 QA
上云 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 常见 QA

产品能力和设备运行与管控底座

Q:上云 API 2 和上云 API 1 有什么区别?#

上云 API 2 是一个帮助软件集成商(ISV)与企业开发者通过 「免费 + 开放核心能力 + 原生被集成的设计」 的后台服务基座 PaaS 软件产品,提供二次开发 SDK + 前端组件 + AI Plugin 和 AI Coding 脚手架 + 设备模拟器 + 调试工具等一系列开放能力,用户可以通过上云 API 2 更高效更快速地实现基于 DJI 硬件的二次开发与垂直行业解决方案交付。
上云 API 1 本质上是通过业界通用的 MQTT 开放的大疆机场和无人机设备的硬件原子协议,解决三方开发者针对 DJI 设备的接入和复杂飞行控制硬件问题。

Q:无人机使用 4G 链路与机场通信时,数据经过哪类服务器?#

公共 4G 图传: 数据经过大疆图传服务器。
私有化 4G 图传: 数据经过用户内网部署的图传服务器,由该服务完成飞行器与机场之间的数据转发。

Q:上云 API 2 是否支持 4G 私有化增强图传?#

支持。

Q:上云 API 2 是否支持模型重建?#

支持,在勾选安装模型重建功能之前,您的服务器需要带有 GPU,具体服务器设备要求您可以参考上云 API 2 说明文档。

Q:上云 API 2 支持哪些前端独立组件?#

上云 API 2 提供驾驶舱、航线编辑器、飞行记录和设备管理维保 4 大组件,支持主题&配置定制化,并提供 AI plugin 帮助您快速集成前端组件到您的二次开发项目中。

Q:上云 API 2 是否支持自定义配置对象存储?#

支持,您可以在管理后台自定义配置对象存储。

Q:上云 API 2 是否支持虚拟设备调试?#

上云 API 2 新增支持了大疆虚拟设备调试功能,帮助您降低开发门槛,无需真机即可快速开始开发。

Q:上云 API 2 是否支持设备远程切换设备的云服务平台?#

上云 API 2 支持设备远程在不同的上云 API 2 服务之间互相切换,同时也支持上云 API 2 服务与司空 2 公有云、司空 2 私有化之间的云服务互相切换。

Q:上云 API 2 是否支持实时获取设备的 OSD 和 HMS 数据?#

支持,您可以通过上云 API 2 SDK 实时订阅设备的 OSD 和 HMS 数据,实现诸如实时轨迹绘制、设备告警功能。

Q:上云 API 2 是否支持通过 MQTT over WebSocket 直接订阅设备 OSD 数据?#

目前不支持直连 EMQX 获取 OSD 数据,OSD 数据需通过 SDK 对应的监听接口获取,例如:
无人机位置:Drone.listenAircraftLocation(callback)
当前版本请使用 SDK 接口。在后续迭代版本中会支持 MQTT 桥接同时兼容上云 API 1 协议。

Q:飞行器产生的媒体文件可以上传到哪些存储服务?#

支持使用底座自带的 MinIO,也可在 AIO 管理后台配置兼容 S3 协议的自托管对象存储。

Q:可以关闭 WebRTC 只使用 RTMP 协议推流吗?#

可以,在安装包目录下修改 env 文件,将 WebRTC 开关关闭:
修改后执行 ./setuptools update 使配置生效。

Q:在上云 API 2 中,可以直接连接底座的数据库查询数据吗?#

底座数据库未对外开放端口,仅允许底座内部容器间访问,外部服务无法直接连接,建议通过 SDK 接口获取所需数据。

Q:在管理后台配置了自定义存储桶后,飞行产生的所有数据都会存到该存储桶中吗?还是有一部分会存到大疆的桶里?#

所有数据均存储在配置的存储桶中。

Q:自签名证书到期或需要更新时,必须重启整个平台吗?有没有办法跳过重启?#

更新自签名证书后需要重启相关服务才能使新证书生效,无法完全跳过重启步骤。
可以只重启证书相关的容器,而不是全量重启整个平台:

Q:M4TD 在上云 API 2 航线组件生成的航线里,负载标识的值是 99-2-0,但上云 API 文档里写的是 99-0-0,哪个是对的?#

两个都是对的,不是冲突,是不同镜头的区别。
负载标识格式为 {type}-{subtype}-{gimbalindex},其中 subtype 表示镜头类型:
各 subtype 取值对应的镜头类型,参见「SDK / 04 飞行控制」Q11。
文档里 99-0-0 只是以广角镜头为例,该航线使用的是红外镜头所以 subtype=2,这是正常的。M4TD 是三光机型(广角+变焦+红外),不同镜头的 subtype 值不同。

Q:航线里用了可见光和红外两个镜头,和文档里 99-0-0 的格式好像对不上,是航线文件有问题吗?#

不要混淆:
99-0-0 格式:是上云 API 中控制单个镜头操作(如拍照、变焦)时使用的负载标识格式,0 是指广角镜头的示例
payloadSubEnumValue 字段(如 visable,ir):是测绘航线中用来指定哪个镜头参与测绘采集的字段,可以同时包含多个镜头
两者含义不同,visable,ir 表示航线在执行时同时使用可见光和红外两个镜头采集数据,属于正常配置。
上一页
上云 API 2 底座管理平台首次激活扫码无反应,无法扫出激活码
下一页
许可证相关
Built with