遥控动作

2026-11-05评分加载中…

一、功能介绍

遥控能力让插件控制 Pilot 的主画面显示哪一路相机。飞行器通常有多路相机(如主相机、FPV、左右负载等),插件可以按业务需要把 Pilot 图传主画面切换到指定的那一路,例如切到 FPV 辅助起降、切到负载相机执行作业。

1.1 能力总览

能力描述
切换主画面相机把 Pilot 图传主画面切换到指定相机

1.2 应用场景

  • 起降辅助:切换到 FPV 相机,观察飞行器下方与周边
  • 作业查看:切换到负载相机,查看任务画面

二、接口调用示例

以下示例假设你已完成 SDK 初始化,且插件与 Pilot 已连接就绪(连接状态获取见插件连接状态文档)。所有接口都通过管理器单例 RemoteControlManager.getInstance() 调用。

2.1 切换主画面相机(switchToPrimaryCameraView)

传入目标相机的 ComponentIndexType,回调分成功 / 失败:

val rcManager = RemoteControlManager.getInstance()              // 获取管理器单例

rcManager.switchToPrimaryCameraView(
    ComponentIndexType.FPV,                                     // 目标相机:切到 FPV
    object : CommonCallbacks.CompletionCallback {
        override fun onSuccess() { /* 已切换 */ }
        override fun onFailure(error: IDJIError) { /* error.errorCode() */ }
    }
)

ComponentIndexType 是 MSDK 的通用相机索引枚举,常用取值:

取值含义
LEFT_OR_MAIN主相机(或左相机)
FPVFPV 相机
RIGHT右相机
UP上置相机

三、API 参考

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

IRemoteControlManager 是遥控管理接口总入口,对外开放以下方法:

项说明
IRemoteControlManager遥控管理接口总入口
switchToPrimaryCameraView把 Pilot 主画面切换到指定相机

四、常见问题(FAQ)

Q1:切换回调 REMOTE_DISCONNECTED?

连接未就绪(delegate 未注入)时调用会立即回调该错误。请在连接状态为 CONNECTED 后再调用,或在回调里处理该错误后重试。

Q2:ComponentIndexType 该传哪个值?

它是 MSDK 的通用相机索引枚举,按飞行器实际相机布局选择:主 / 左相机用 LEFT_OR_MAIN,FPV 用 FPV,右、上相机分别用 RIGHT / UP。目标相机在当前机型不存在时会切换失败,可从 error.errorCode() 判断。

附录:错误码速查

以下错误码来自 dji.open.pilot.base.error.RemoteError:

错误码常量触发场景处理建议
REMOTE_DISCONNECTED连接未就绪时调用等连接状态 CONNECTED 后重试;见 Q1
最近修改: