页面跳转

2026-11-05评分加载中…

一、功能介绍

页面跳转能让插件控制 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_HOMEPilot 主页
PILOT_MAPPilot 地图页
PILOT_WAYPOINT_MISSION_LISTPilot 航线展示页
PILOT_ALBUMPilot 相册页selfDefineValue 传 cameraIndex,默认 "0"
PILOT_DEFAULTPilot 当前页面常用于「回到 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) 即可。

效果预览:

页面跳转

悬浮窗页面跳转

页面跳转

Sample页面跳转

三、API 参考

以下接口方法的完整定义(含入参数据模型、枚举)请查看 API 文档:INavigateManageropen in new window。

INavigateManager 是页面跳转管理接口总入口,对外开放以下方法:

项说明
INavigateManager页面跳转管理接口总入口
navigateToPage控制服务端跳转到指定页面

四、Sample 源码获取

页面跳转 Sampleopen in new window


五、常见问题(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
最近修改: