SuperAPI AI 工具集

cloudapi2-payload

编程与开发

查看项目

更新于 11-12 16:17

技能介绍

该技能是 DJI Cloud API 2 PSDK 负载域接入助手,服务于需要编写 Java 代码控制第三方 PSDK 负载的集成商开发者。其核心用途是帮助开发者正确调用 PsdkControlModule(34 个方法)与 PsdkResourceModule(7 个方法),避免因 SDK 过度声明而写出编译失败或运行时不可用的代码。

主要能力覆盖:探照灯控制(开关、亮度、模式、校准、微调、广角、随云台)、喊话器控制(播放音频/TTS、重播、停止、音量、播放模式、TTS 参数)、PSDK 设备发现与状态订阅、播放进度/浮窗文本/UI 资源订阅、PSDK Widget 数值与输入框设置,以及喊话器音频资源的上传(STS 凭证 + 直传对象存储)与资源 CRUD。

使用方式上,该技能强调若干关键规则:控制类 setter 与 DRC Northbound 订阅必须先调用 connectDrcLink;PsdkControlModule 从 Drone 获取,PsdkResourceModule 从 Workspace 获取且必须判空;psdkIndex 为 int 类型,来自状态摘要回调,不能与相机负载的 String 索引混用;所有 listen 为单参数无 error 回调,失败时靠返回 -1 和判空感知;cancel 签名分两类且参数顺序不同;入参类型存在不对称(如 searchlightModeSet 传 int、speakerPlayModeSet 传枚举);音频资源上传是 getSTS→upload→create→播放的四步流程,每步有独立失败点。

适用场景包括:编写 PSDK 负载控制代码、排查 psdkIndex 来源不明、listen 返回 -1、回调收到 null、cancel 编译不过等问题。限制方面,Java SDK 不支持实时喊话(源码已注释关闭)和抛投器控制(仅 javadoc 提及但无方法),实时喊话需在浏览器侧结合 RTC 实现;枚举值存在不等于能力存在。该技能还强制反幻觉规则,要求示例代码必须来源于参考文档或官方 SDK 源码,禁止按枚举或 javadoc 反推 API。