图传建模
一、功能介绍
建模能力让插件感知 Pilot 的实景建模进度,并在建模完成后把建模文件移动到公共目录,便于插件读取和后续处理。插件通过监听拿到建模的进度、成功或失败三态回调,再按需把产物文件取出。
1.1 能力总览
| 能力 | 描述 |
|---|---|
| 建模状态监听 | 注册监听器,接收建模进度 / 成功 / 失败回调 |
| 移动建模文件 | 把建模产物文件移动到公共文件夹,回调返回路径 |
| 移除监听 | 移除建模状态监听器 |
1.2 应用场景
- 进度展示:在插件界面显示 Pilot 建模进度
- 产物取出:建模完成后把文件移到公共目录,供插件读取或上传
二、接口调用示例
以下示例假设你已完成 SDK 初始化,且插件与 Pilot 已连接就绪(连接状态获取见插件连接状态文档)。所有接口都通过管理器单例 PilotModelingManager.getInstance() 调用。
2.1 监听建模状态(addPilotModelingListener)
注册 IPilotModelingListener,接收进度、成功、失败三类回调:
val modelingManager = PilotModelingManager.getInstance() // 获取管理器单例
private val modelingListener = object : IPilotModelingListener {
override fun onProgressUpdate(progress: Double) {
// 建模进度(0.0 ~ 100.0)
}
override fun onSuccess() {
// 建模完成,可继续调用 moveModelingFileToPublic 取出产物(见 2.2)
}
override fun onFailure(error: IDJIError) {
// error.errorCode() 获取错误码
}
}
modelingManager.addPilotModelingListener(modelingListener) // 同一监听重复添加会自动去重
2.2 移动建模文件到公共目录(moveModelingFileToPublic)
建模完成后,把产物文件移动到公共文件夹,回调成功时返回目标路径:
modelingManager.moveModelingFileToPublic(object : CommonCallbacks.CompletionCallbackWithParam<String> {
override fun onSuccess(path: String) {
// path 为公共目录下的建模文件路径,供后续读取 / 上传
}
override fun onFailure(error: IDJIError) {
// error.errorCode() 获取错误码
}
})
2.3 移除监听(removePilotModelingListener)
页面销毁时移除监听器:
override fun onDestroy() {
super.onDestroy()
modelingManager.removePilotModelingListener(modelingListener)
}
三、接口概览
IPilotModelingManager 是建模管理接口总入口,对外开放以下方法:
| 项 | 说明 |
|---|---|
IPilotModelingManager | 建模管理接口总入口 |
addPilotModelingListener | 添加建模状态监听 |
removePilotModelingListener | 移除建模状态监听 |
moveModelingFileToPublic | 移动建模文件到公共文件夹,回调返回路径 |
四、常见问题(FAQ)
Q1:注册监听后什么时候能收到回调?
addPilotModelingListener 注册后不会立即回调当前状态,只在 Pilot 建模有进度、成功或失败时才回调。请把监听尽早注册,以免错过进度事件。同一监听重复添加会自动去重。
Q2:moveModelingFileToPublic 回调 REMOTE_DISCONNECTED / EXECUTION_FAILED?
REMOTE_DISCONNECTED:连接未就绪(delegate 未注入)时调用。等连接状态CONNECTED后重试。EXECUTION_FAILED:移动文件过程异常。确认建模已完成、产物文件存在后重试。
Q3:监听器需要手动移除吗?
需要。监听器由本地列表长期持有,不移除会让匿名内部类隐式持有页面引用,造成内存泄漏。请在页面销毁时成对调用 removePilotModelingListener。
附录:错误码速查
以下错误码来自 dji.open.pilot.base.error.RemoteError:
| 错误码常量 | 触发场景 | 处理建议 |
|---|---|---|
REMOTE_DISCONNECTED | 连接未就绪时调用 | 等连接状态 CONNECTED 后重试;见 Q2 |
EXECUTION_FAILED | 移动建模文件过程异常 | 确认建模完成、产物存在后重试;见 Q2 |