遥控动作
一、功能介绍
遥控能力让插件控制 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 | 主相机(或左相机) |
FPV | FPV 相机 |
RIGHT | 右相机 |
UP | 上置相机 |
三、API 参考
以下接口方法的完整定义(含入参枚举)请查看 API 文档:IRemoteControlManager。
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 |