图传建模

2026-11-05评分加载中…

一、功能介绍

建模能力让插件感知 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
最近修改: