页面跳转
一、功能介绍
页面跳转能让插件控制 Pilot 跳转到指定页面,或从 Pilot 跳回插件自己的页面。例如插件在业务流程中需要用户去 Pilot 地图页确认航线,或从 Pilot 浮层一键回到插件主界面,都由这一能力完成。跳转目标通过一个枚举描述,覆盖 Pilot 主页、地图、相册、航线列表以及插件自定义页面等。
1.1 能力总览
| 能力 | 描述 |
|---|---|
| 页面跳转 | 控制 Pilot 跳转到指定页面,或跳回插件 App 页面 |
1.2 应用场景
- 引导操作:业务流程中跳转到 Pilot 地图页让用户确认航线
- 返回插件:从 Pilot 浮层跳回插件的某个 Activity
- 查看素材:一键跳转到 Pilot 相册页查看指定相机的素材
二、接口调用示例
以下示例假设你已完成 SDK 初始化,且插件与 Pilot 已连接就绪(连接状态获取见插件连接状态文档)。所有接口都通过管理器单例 NavigateManager.getInstance() 调用。
2.1 跳转到指定页面(navigateToPage)
跳转目标由 NavigateAction 描述:多数页面只需一个 NavigateAction.Value 枚举;少数页面(相册、插件自定义页)还需通过第二个参数 selfDefineValue 传附加信息。
val navigateManager = NavigateManager.getInstance() // 获取管理器单例
// 示例一:跳转到 Pilot 地图页(只需枚举)
val toMap = NavigateAction(NavigateAction.Value.PILOT_MAP)
navigateManager.navigateToPage(toMap, object : CommonCallbacks.CompletionCallback {
override fun onSuccess() { /* 已跳转 */ }
override fun onFailure(error: IDJIError) { /* error.errorCode() */ }
})
// 示例二:跳回插件自定义页面(selfDefineValue 传目标 Activity 全路径)
val toPlugin = NavigateAction(
NavigateAction.Value.SELF_DEFINE,
"com.example.plugin.MainActivity" // TODO: 替换为你的 Activity 全路径
)
navigateManager.navigateToPage(toPlugin, object : CommonCallbacks.CompletionCallback {
override fun onSuccess() { /* 已跳回插件页面 */ }
override fun onFailure(error: IDJIError) { /* error.errorCode() */ }
})
NavigateAction.Value 的可选目标如下:
| 枚举 | 目标页面 | 备注 |
|---|---|---|
PILOT_HOME | Pilot 主页 | |
PILOT_MAP | Pilot 地图页 | |
PILOT_WAYPOINT_MISSION_LIST | Pilot 航线展示页 | |
PILOT_ALBUM | Pilot 相册页 | selfDefineValue 传 cameraIndex,默认 "0" |
PILOT_DEFAULT | Pilot 当前页面 | 常用于「回到 Pilot」 |
PLUGIN_APP | 插件 App | 跳转到插件 App |
REMOTE_VIEW_PAGE_ACTIVITY | 插件自定义 Activity | 启动并跳转到 Open Pilot 插件自定义 Activity |
SELF_DEFINE | 插件指定页面 | selfDefineValue 传目标 Activity 全路径 |
NONE | 空 / 未定义 |
说明: 需要携带附加信息的只有两类:
PILOT_ALBUM(相机序号)和SELF_DEFINE(Activity 全路径)。其余枚举直接用单参构造NavigateAction(value)即可。
效果预览:


三、API 参考
以下接口方法的完整定义(含入参数据模型、枚举)请查看 API 文档:INavigateManager。
INavigateManager 是页面跳转管理接口总入口,对外开放以下方法:
| 项 | 说明 |
|---|---|
INavigateManager | 页面跳转管理接口总入口 |
navigateToPage | 控制服务端跳转到指定页面 |
四、Sample 源码获取
五、常见问题(FAQ)
Q1:什么时候需要传第二个参数 selfDefineValue?
只有两类目标需要:PILOT_ALBUM 传相机序号 cameraIndex(默认 "0"),SELF_DEFINE 传目标 Activity 的全路径。其余枚举用单参构造 NavigateAction(value) 即可,selfDefineValue 会被忽略。
Q2:SELF_DEFINE 和 REMOTE_VIEW_PAGE_ACTIVITY 有什么区别?
SELF_DEFINE 跳回插件 App 中你指定的某个 Activity(需传全路径);REMOTE_VIEW_PAGE_ACTIVITY 启动并跳转到 Open Pilot 插件的自定义 Activity。按你要落到的目标页面选择对应枚举。
Q3:调用 navigateToPage 回调 REMOTE_DISCONNECTED / EXECUTION_FAILED?
REMOTE_DISCONNECTED:连接未就绪时调用,等连接状态CONNECTED后重试。EXECUTION_FAILED:调用过程异常(如SELF_DEFINE的 Activity 全路径无效)。确认枚举与selfDefineValue传值正确。
附录:错误码速查
以下错误码来自 dji.open.pilot.base.error.RemoteError:
| 错误码常量 | 触发场景 | 处理建议 |
|---|---|---|
REMOTE_DISCONNECTED | 连接未就绪时调用 | 等连接状态 CONNECTED 后重试;见 Q3 |
EXECUTION_FAILED | 跳转调用过程异常 | 确认枚举与 selfDefineValue 传值正确;见 Q3 |