迁移概述
如何使用本指南
1.
2.
3.
4.
重要提示： 本指南基于用户层 API（ FlightHubSDK.java、Drone.java、Dock.java、Workspace.java等core/类），不是 SWIG 生成的I*.java接口。用户代码中调用的方法是drone.getCameraControlModule().drcTakePhoto()，而非底层包装方法。门面与内部实现： FlightHubSDK是面向用户的门面类（入口），FlightHubSdkManager是内部实现类。用户代码应通过FlightHubSDK获取所有设备实例和管理能力，不要直接调用FlightHubSdkManager。覆盖范围：本指南覆盖 core/用户层 API 的方法搬迁、改名、废弃和 Bean 字段变化。不覆盖：SWIG 生成层（I*.java）、运行时行为变化、枚举值增删。
变更概览
| 维度 | KOC2 | KOC3 |
|---|---|---|
core/ 类数 | 24 | 56（新增 32 个子模块） |
Drone 方法数 | 208（含 5 getter） | 21（全部 getter） |
Dock 方法数 | 89（含 2 getter） | 11（全部 getter） |
Workspace 方法数 | 64（含 10 getter） | 18（全部 getter） |
FlightHubSDK 门面方法数 | 16 | 19 |
DeviceDebugModule 方法数 | 68 | 55 |
| 纯新增方法数 | — | 296 |
| 搬迁方法数 | — | 317 |
核心架构变化
Drone、Dock、Workspace 上。KOC3 采用模块化架构：
Drone/Dock/Workspace 仅保留 get*Module() getter，所有业务方法搬迁到子模块。破坏性变更分类
| 分类 | 数量 | 说明 |
|---|---|---|
| A. 模块化搬迁 | 约 280 个 | 方法名不变，drone.xxx() → drone.getXxxModule().xxx() |
| B. 模块化 + DRC 前缀 | 约 40 个 | 调用路径变了，且方法名加了 drc/Drc 前缀 |
| C. 模块化 + 改名 | 约 6 个 | AircraftHMS→DeviceHMS 等 |
| D. 废弃 | 约 40 个 | Available 监听方法 + 其他移除方法 |
| E. DeviceDebugModule 拆分 | 约 18 个 | 网络测试/RTK标定/中继器控制拆到新模块，去掉 device_sn 参数 |
| F. FlightHubSDK 门面补齐 | 约 15 个 | FlightHubSdkManager.getStreamInstance() → FlightHubSDK.getStream()，移除 session 机制 |
| G. Bean / 参数类字段变化 | 3 个 | TakeoffParams 删 mediaFolderName、LiveRecordItem 字段改名、FlightHubSdkConfig 删 token |
变更类型图例
| 标签 | 说明 |
|---|---|
| 模块化 | 方法名不变，调用对象从 drone/dock/workspace 变为 getXxxModule() |
| 模块化+DRC | 调用路径变化 + 方法名加 drc/Drc 前缀 |
| 模块化+改名 | 调用路径变化 + 方法名有其他变化 |
| 废弃 | KOC2 有，KOC3 删除 |
| 签名变化 | 参数列表变化（如去掉 device_sn） |
| 门面切换 | FlightHubSdkManager → FlightHubSDK |
未变化的模块
| 模块 | 说明 | 注意事项 |
|---|---|---|
LiveModule | 直播流（启停/SEI 订阅） | 无变化，直接使用 |
LiveRecordModule | 直播录像启停 | 接口方法无变化，但 LiveRecordItem Bean 字段大面积改名（见 API 变更详解 变更 10b） |
PullStreamModule | WHEP 拉流 | 无变化 |
CustomSEIModule | 自定义 SEI 编解码 | 无变化 |
Stream | 流管理 | 获取方式改名：getStreamInstance() → getStream() |
HMSModule | 历史 HMS 数据查询 | 无变化 |
DiagnosisManagementModule | 诊断管理 | 无变化（暂未开放） |
MaintenanceManagementModule | 维保管理（报修工单） | 无变化 |
FlightTaskModule | 航线任务管理 | 新增 listenTaskTopoChanged、startRoaming 等，旧方法不变 |
TerraBuildModule | 三维重建 | 新增 15 个方法，旧方法不变 |
LogManagementModule | 日志管理 | 新增 listenDeviceFileUploadProgress，旧方法不变 |
MediaServiceModule | 媒体服务 | 新增 getMediaFileDetailById、uploadGeoMediaFile，旧方法不变 |
SafetyServiceModule | 安全服务 | 新增 listenDroneOfflineMapEnable，旧方法不变 |
PoiModule | POI 环绕 | 新增 listenFlightPoiProgress，enter/exit/updateSpeed/getTask 不变 |
FlightTaskControlModule | 航线任务控制 | 新增 listenWaylineTaskEvent（从 Dock 搬入），pause/resume 不变；删除 listenFlightTaskControlAvailable |