Mobile、Payload 和 Cloud 解决的是不同的问题
Mobile SDK 支持应用从兼容的移动环境访问受支持的飞行器和相机的功能。Payload SDK 面向负载集成;Cloud API 面向受支持企业级产品的云端集成。它们是不同的集成层。在选择之前,先确定您需要的是遥控器侧的拍摄界面、定制负载,还是运行层面的云服务。不能仅因企业级 Cloud API 文档中出现了名称相似的能力,就认定消费级飞行器的官方应用具备同样的功能。请从所需功能出发,再将其对应到合适的受支持接口。 如果需求只是同步配置与录制,就不要无故加入自主飞行。把范围限定在镜头本身,并记录每项功能的访问与连接要求。 要在您自己的应用中调用巡检计算与数据,请参阅巡检指南的 API 与 MCP 服务器。
把兼容性当作完整的组合来读
兼容性是飞行器、遥控器、SDK 版本与固件的组合,必要时还包括操作系统、相机和连接方式。本指南核查的 V5 资料包含对 Mini 4 Pro 的支持,这说明了为什么关于 Mini 系列的笼统旧说法并不可靠。产品出现在支持列表中,仍不等于每项任务或相机功能都受支持。请阅读版本说明、逐个 API 的支持信息以及运行时的能力查询结果。把日期、文档链接与测试过的配置一并保存,以便其他开发者复现结果。 将“受支持”“不受支持”“未验证”作为三种不同状态加以区分。在 SDK 更新前后运行同一组有界测试,并明确指出行为上的变化。
一次最小化的航拍集成测试
我们原创的验证顺序是:连接与遥测、相机配置、录制状态、云台指令,最后才是飞行任务。把指令成功提交与所请求状态确实发生这两件事分开确认。对于航点,要测试高度基准、坐标、航向、云台行为、到达动作、中断、恢复以及连接丢失。官方航点功能、SDK 任务执行和由应用驱动虚拟摇杆指令是三种不同的实现。飞行前先使用受支持的仿真或地面验证,并在加入复杂的电影化路径之前完成故障处理。 为成组设置设计部分失败的报告机制。录制可能已经开始,而镜头或构图的更改却失败了。只有在所需条件都得到确认后,才批准一条拍摄。
YOUR NEXT STEP
付诸实践。
- 不要混用 V4/V5 或 Android/iOS 的兼容性说法。
- 产品出现在支持列表中,不等于每个 API 都受支持。
来源与编辑范围
说明和练习均为原创编辑内容。与产品相关的具体条件,请对照所链接的文档版本核实。
- DJI — Mobile SDK V5 release notes and supported products ↗
- DJI — Mobile-SDK-Android-V5 official repository ↗
- DJI — Cloud API documentation ↗
- DJI — Payload SDK official repository ↗
研究日期:2026年10月21日。请核对链接所指版本、支持的硬件和适用条件。证据包括直接审读的文本和官方检索索引记录。
阅读方法论与未解问题 →