概述
Pilot 开放插件
Pilot 开放插件是 MSDK 面向 DJI Pilot 作业环境的扩展形态。开发者可以将企业的任务、数据和业务流程做成 Android 插件,安装到带屏遥控器上,并与 Pilot 协同运行。
Pilot 负责飞行、图传、地图等基础作业;插件负责行业业务。插件通过 MSDK 复用 Pilot 的硬件和开放能力,并在插件浮窗及开放 UI 能力范围内提供业务交互。
为什么需要 Pilot 开放插件
使用传统 MSDK 开发独立应用时,通常需要自行建设设备连接、图传显示、地图渲染、飞行交互和作业界面等基础能力。
对于已经拥有成熟行业业务系统、但首次将业务流程延伸到无人机作业现场的团队,除了需要接入自身的任务、数据和流程,还要额外建设图传显示、地图渲染、飞行交互与设备连接等飞行应用基础能力,开发周期更长,后续维护成本也更高。
Pilot 开放插件不仅减少重复开发,更让行业应用可以直接使用 Pilot 已具备的专业作业能力:
- 图传与 AR:在图传画面中展示目标、缺陷、风险区域和作业指引。
- 地图能力:展示任务点、巡检路线、限制区域和行业空间数据。
- 本地建模:监听建模状态、获取建模成果,并接入企业成果管理流程。
- 业务交互:通过插件浮窗、自定义组件、对话框和页面跳转承载任务确认、信息录入和流程引导。
团队因此可以将研发重点放在行业任务、数据和流程上,而不必重新建设一套完整的飞行应用。
说明: Pilot 开放插件适合在既有 Pilot 作业流程中增加行业业务能力。如果需要完全自定义飞行 App 的产品形态和整体交互,独立 MSDK 应用仍是更合适的选择。
它能为行业作业带来什么
Pilot 开放插件可以把已有行业业务延伸到飞手使用的遥控器上,让作业人员在飞行过程中获取任务信息,并完成必要的确认、记录和处置。
| 作业环节 | 可提供的帮助 | 示例能力 |
|---|---|---|
| 作业前 | 展示任务范围、目标位置、作业规则和资源准备状态 | 地图控件、插件浮窗、自定义 UI 组件 |
| 作业中 | 在图传或地图开放区域提示目标、风险区域和处置步骤 | AR 投射、图传绘制、地图控件、对话框 |
| 作业后 | 导出成果、确认作业结果,并与业务系统衔接 | 文件传输、本地建模、MSDK 原生能力 |
| 行业场景 | Pilot 插件可提供的帮助 |
|---|---|
| 电力、风机巡检 | 标出杆塔、设备和缺陷位置,展示巡检路线与任务点 |
| 公安、消防、应急 | 展示目标位置、警戒范围和现场处置提示 |
| 测绘、建模 | 展示作业区域,监听建模状态并获取建模成果 |
| 安防、园区巡逻 | 展示巡逻任务、事件位置和处置规则 |
| 工程建设、矿山 | 展示工地要素、区域边界和作业数据 |
可以调用哪些能力
| 能力类别 | 内容 | 作用 |
|---|---|---|
| Pilot 开放 UI 能力 | 插件浮窗、自定义 UI 组件、地图控件、AR 投射、图传绘制、对话框、页面跳转 | 在 Pilot 提供的开放范围内展示业务信息并处理业务交互 |
| Pilot 平台能力 | 插件连接状态、服务配置、Pilot Action、本地建模、文件传输 | 支撑插件与 Pilot 的协作和运行 |
| MSDK 原生能力 | Key 操作、航线任务、码流等 | 通过 Pilot 访问飞行器能力 |
完整能力列表、接口说明和示例见能力地图。
与独立 MSDK 应用有什么区别
| 对比项 | 独立 MSDK 应用 | Pilot 开放插件 |
|---|---|---|
| 应用形态 | 独立运行的飞行应用 | 与 Pilot 协同运行的行业插件 |
| 飞行与作业基础能力 | 由开发者自行构建或整合 | 复用 Pilot 已有的飞行、图传、地图、AR、建模等开放能力 |
| 研发重点 | 同时建设飞行能力与行业能力 | 聚焦行业任务、数据和业务流程 |
| 与 Pilot 的关系 | 独立连接和运行 | 通过 Pilot 访问硬件,并在 Pilot 提供的插件浮窗及开放 UI 能力范围内进行业务交互 |
| 适用场景 | 需要完整自定义飞行 App | 希望在 Pilot 作业流程中扩展行业能力 |
Pilot 与插件如何协作
插件是独立安装在带屏遥控器上的 Android 应用,与 Pilot 运行在不同进程中,并通过 MSDK 提供的跨进程机制协作。
| 组成 | 职责 |
|---|---|
| 插件进程 | 运行行业业务代码,包括任务处理、数据接入和业务流程 |
| Pilot 进程 | 持有飞行器硬件连接,提供飞行、图传、地图等作业能力 |
| MSDK | 负责插件与 Pilot 的通信,开发者无需处理跨进程细节 |
当使用 SDKLinkMode.REMOTE_PILOT 初始化 MSDK 时,应用即以 Pilot 插件模式运行。除链路模式和新增的 Pilot 开放能力外,MSDK 的 Key、回调、错误码和注册流程与原生开发保持一致。
说明: 插件不能任意修改或接管 Pilot 原有界面。界面交互需遵循 Pilot 提供的开放能力,例如插件浮窗、自定义 UI 组件、地图控件、AR 投射、图传绘制、对话框和页面跳转等。
插件如何在 Pilot 中使用
插件安装到遥控器后,由 Pilot 自动识别与管理。用户启用插件并完成连接后,即可调用开放能力并通过插件浮窗进入插件页面。
- 安装插件 APK。
- 在 Pilot 插件管理界面启用插件。
- 等待插件与 Pilot 建立连接。
- 通过插件浮窗进入插件页面并使用行业功能。
- 不再使用时,在插件管理界面停用插件。




说明: 插件与 Pilot 的接口契约存在版本对应关系,连接时 MSDK 会自动校验。