API 变更详情
变更 1：Drone 模块化搬迁
Drone 上有 208 个方法。KOC3 中 Drone 只剩 21 个 get*Module() getter，所有业务方法搬到了子模块。Drone 新增的 getter（KOC3）
| getter | 返回类型 | 说 明 |
|---|---|---|
getCameraControlModule() | CameraControlModule | 相机/拍照/录像/云台/热成像/全景 |
getFlightControlModule() | FlightControlModule | 飞行控制（返航/急停/摇杆） |
getPsdkControlModule() | PsdkControlModule | PSDK/喇叭/探照灯/Widget |
getTakeoffModule() | TakeoffModule | 一键起飞 |
getDrcModule() | DrcModule | DRC 链路 |
getDroneOsdModule() | DroneOsdModule | 飞机 OSD 状态监听 |
getDeviceHMSModule() | DeviceHMSModule | HMS 健康管理 |
getDeviceStateModule() | DeviceStateModule | 在线状态 |
getControlAuthModule() | ControlAuthModule | 控制权 |
getFlightSettingsModule() | FlightSettingsModule | 飞行参数设置 |
getTestFlightModule() | TestFlightModule | 试飞 |
getOnboardAiModule() | OnboardAiModule | AI 识别 |
getLiveDeviceModule() | LiveDeviceModule | 直播可用范围/观众数 |
getInFlightWaylineModule() | InFlightWaylineModule | 在飞航线（新增） |
getAIBoxModule() | AIBoxModule | AIBox |
getDeviceDebugModule() | DeviceDebugModule | 设备调试（从 Workspace 下放） |
注意： DeviceManageModule通过workspace.getDeviceManageModule()获取，不在Drone上。
1a. Drone → CameraControlModule（相机控制）
A 类：模块化 + DRC 前缀（动作方法）
KOC2 中相机动作方法直接挂在 Drone上。KOC3 搬到CameraControlModule并统一加drc前缀。
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.takePhoto(payloadIndex, cb) | drone.getCameraControlModule().drcTakePhoto(payloadIndex, cb) | 模块化+DRC |
| 2 | drone.startRecord(payloadIndex, cb) | drone.getCameraControlModule().drcStartRecord(payloadIndex, cb) | 模块化+DRC |
| 3 | drone.stopRecord(payloadIndex, cb) | drone.getCameraControlModule().drcStopRecord(payloadIndex, cb) | 模块化+DRC |
| 4 | drone.zoomAtTarget(params, cb) | drone.getCameraControlModule().drcZoomAtTarget(params, cb) | 模块化+DRC |
| 5 | drone.setFocalLength(params, cb) | drone.getCameraControlModule().drcSetFocalLength(params, cb) | 模块化+DRC |
| 6 | drone.switchCameraMode(params, cb) | drone.getCameraControlModule().drcSwitchCameraMode(params, cb) | 模块化+DRC |
| 7 | drone.switchLiveLens(params, cb) | drone.getCameraControlModule().drcSwitchLiveLens(params, cb) | 模块化+DRC |
| 8 | drone.setPhotoStorageSettings(params, cb) | drone.getCameraControlModule().drcSetPhotoStorageSettings(params, cb) | 模块化+DRC |
| 9 | drone.setVideoStorageSettings(params, cb) | drone.getCameraControlModule().drcSetVideoStorageSettings(params, cb) | 模块化+DRC |
| 10 | drone.setNightSceneMode(params, cb) | drone.getCameraControlModule().drcSetNightSceneMode(params, cb) | 模块化+DRC |
| 11 | drone.resetGimbal(payloadIndex, resetMode, cb) | drone.getCameraControlModule().drcResetGimbal(payloadIndex, resetMode, cb) | 模块化+DRC |
| 12 | drone.startPanorama(params, cb) | drone.getCameraControlModule().drcStartPanorama(params, cb) | 模块化+DRC |
| 13 | drone.stopPanorama(payloadIndex, cb) | drone.getCameraControlModule().drcStopPanorama(payloadIndex, cb) | 模块化+DRC |
| 14 | drone.setThermalGainMode(params, cb) | drone.getCameraControlModule().drcSetThermalGainMode(params, cb) | 模块化+DRC |
B 类：模块化 + DRC 前缀（监听方法）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.listenPanoramaStatus(payloadIndex, cb) | drone.getCameraControlModule().listenDrcPanoramaStatus(payloadIndex, cb) | 模块化+DRC |
| 2 | drone.cancelListenPanoramaStatus(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcPanoramaStatus(payloadIndex, id) | 模块化+DRC |
| 3 | drone.listenCameraModeAvailableRange(payloadIndex, cb) | drone.getCameraControlModule().listenDrcCameraModeAvailableRange(payloadIndex, cb) | 模块化+DRC |
| 4 | drone.cancelListenCameraModeAvailableRange(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcCameraModeAvailableRange(payloadIndex, id) | 模块化+DRC |
| 5 | drone.listenCameraState(payloadIndex, cb) | drone.getCameraControlModule().listenDrcCameraState(payloadIndex, cb) | 模块化+DRC |
| 6 | drone.cancelListenCameraState(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcCameraState(payloadIndex, id) | 模块化+DRC |
| 7 | drone.listenLiveviewWorldRegion(payloadIndex, cb) | drone.getCameraControlModule().listenDrcLiveviewWorldRegion(payloadIndex, cb) | 模块化+DRC |
| 8 | drone.cancelListenLiveviewWorldRegion(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcLiveviewWorldRegion(payloadIndex, id) | 模块化+DRC |
| 9 | drone.listenCameraWideLensState(payloadIndex, cb) | drone.getCameraControlModule().listenDrcCameraWideLensState(payloadIndex, cb) | 模块化+DRC |
| 10 | drone.cancelListenCameraWideLensState(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcCameraWideLensState(payloadIndex, id) | 模块化+DRC |
| 11 | drone.listenCameraZoomLensState(payloadIndex, cb) | drone.getCameraControlModule().listenDrcCameraZoomLensState(payloadIndex, cb) | 模块化+DRC |
| 12 | drone.cancelListenCameraZoomLensState(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcCameraZoomLensState(payloadIndex, id) | 模块化+DRC |
| 13 | drone.listenCameraMeasureTarget(payloadIndex, cb) | drone.getCameraControlModule().listenDrcCameraMeasureTarget(payloadIndex, cb) | 模块化+DRC |
| 14 | drone.cancelListenCameraMeasureTarget(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcCameraMeasureTarget(payloadIndex, id) | 模块化+DRC |
| 15 | drone.listenNightModeSettings(payloadIndex, cb) | drone.getCameraControlModule().listenDrcNightModeSettings(payloadIndex, cb) | 模块化+DRC |
| 16 | drone.cancelListenNightModeSettings(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcNightModeSettings(payloadIndex, id) | 模块化+DRC |
| 17 | drone.listenGimbalState(payloadIndex, cb) | drone.getCameraControlModule().listenDrcGimbalState(payloadIndex, cb) | 模块化+DRC |
| 18 | drone.cancelListenGimbalState(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcGimbalState(payloadIndex, id) | 模块化+DRC |
| 19 | drone.listenLiveVideoInfo(payloadIndex, cb) | drone.getCameraControlModule().listenDrcLiveVideoInfo(payloadIndex, cb) | 模块化+DRC |
| 20 | drone.cancelListenLiveVideoInfo(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcLiveVideoInfo(payloadIndex, id) | 模块化+DRC |
| 21 | drone.listenThermalGainMode(payloadIndex, cb) | drone.getCameraControlModule().listenDrcThermalGainMode(payloadIndex, cb) | 模块化+DRC |
| 22 | drone.cancelListenThermalGainMode(payloadIndex, id) | drone.getCameraControlModule().cancelListenDrcThermalGainMode(payloadIndex, id) | 模块化+DRC |
C 类：模块化搬迁（方法名不变）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.lookAtTarget(params, cb) | drone.getCameraControlModule().lookAtTarget(params, cb) | 模块化 |
1b. Drone → DroneOsdModule（飞机 OSD 监听）
所有 listenAircraft*/cancelListenAircraft*方法搬 到DroneOsdModule，方法名不变。
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.listenAircraftPayloadsOsdInfo(cb) | drone.getDroneOsdModule().listenAircraftPayloadsOsdInfo(cb) | 模块化 |
| 2 | drone.cancelListenAircraftPayloadsOsdInfo(id) | drone.getDroneOsdModule().cancelListenAircraftPayloadsOsdInfo(id) | 模块化 |
| 3–4 | listenAircraftGear / cancelListenAircraftGear | → getDroneOsdModule() | 模块化 |
| 5–6 | listenAircraftHomeDistance / cancelListenAircraftHomeDistance | 同上 | 模块化 |
| 7–8 | listenAircraftPositionState / cancelListenAircraftPositionState | 同上 | 模块化 |
| 9–10 | listenAircraftControlSource / cancelListenAircraftControlSource | 同上 | 模块化 |
| 11–12 | listenAircraftLimitsInfo / cancelListenAircraftLimitsInfo | 同上 | 模块化 |
| 13–14 | listenAircraftBatteryWarningThresholds / cancelListenAircraftBatteryWarningThresholds | 同上 | 模块化 |
| 15–16 | listenAircraftFirmwareStatus / cancelListenAircraftFirmwareStatus | 同上 | 模块化 |
| 17–18 | listenAircraftCurrentRthMode / cancelListenAircraftCurrentRthMode | 同上 | 模块化 |
| 19–20 | listenAircraftTotalFlightInfo / cancelListenAircraftTotalFlightInfo | 同上 | 模块化 |
| 21–22 | listenAircraftActivationTime / cancelListenAircraftActivationTime | 同上 | 模块化 |
| 23–24 | listenAircraftMaintainStatusInfo / cancelListenAircraftMaintainStatusInfo | 同上 | 模块化 |
| 25–26 | listenAircraftNightLightsState / cancelListenAircraftNightLightsState | 同上 | 模块化 |
| 27–28 | listenAircraftObstacleAvoidanceState / cancelListenAircraftObstacleAvoidanceState | 同上 | 模块化 |
| 29–30 | listenAircraftStorageInfo / cancelListenAircraftStorageInfo | 同上 | 模块化 |
| 31–32 | listenAircraftTrackId / cancelListenAircraftTrackId | 同上 | 模块化 |
| 33–34 | listenAircraftComplianceInfo / cancelListenAircraftComplianceInfo | 同上 | 模块化 |
| 35–36 | listenAircraftPayloadsCamerasList / cancelListenAircraftPayloadsCamerasList | 同上 | 模块化 |
| 37–38 | listenAircraftRcLostAction / cancelListenAircraftRcLostAction | 同上 | 模块化 |
| 39–40 | listenAircraftRthInfo / cancelListenAircraftRthInfo | 同上 | 模块化 |
| 41–42 | listenAircraftHomeGeographicalInfo / cancelListenAircraftHomeGeographicalInfo | 同上 | 模块化 |
| 43–44 | listenAircraftBatteryInfo / cancelListenAircraftBatteryInfo | 同上 | 模块化 |
| 45–46 | listenAircraftAttitude / cancelListenAircraftAttitude | 同上 | 模块化 |
| 47–48 | listenAircraftLocation / cancelListenAircraftLocation | 同上 | 模块化 |
| 49–50 | listenAircraftModeCode / cancelListenAircraftModeCode | 同上 | 模块化 |
| 51–52 | listenAircraftWindSpeed / cancelListenAircraftWindSpeed | 同上 | 模块化 |
| 53–54 | listenFlightTasksException / cancelListenFlightTasksException | 同上 | 模块化 |
| 55–56 | listenAircraftControlCode / cancelListenAircraftControlCode | 同上 | 模块化 |
| 57–58 | listenAircraftSpeed / cancelListenAircraftSpeed | 同上 | 模块化 |
| 59–60 | listenAircraftPayloadsCameraLiveviewWorldRegion / cancelListenAircraftPayloadsCameraLiveviewWorldRegion | 同上 | 模块化 |
| 61–62 | listenAircraftPayloadsGimbalAttitude / cancelListenAircraftPayloadsGimbalAttitude | 同上 | 模块化 |
| 63–64 | listenAircraftPayloadsList / cancelListenAircraftPayloadsList | 同上 | 模块化 |
| 65–66 | listenControlRightsCloudControlStatus / cancelListenControlRightsCloudControlStatus | 同上 | 模块化 |
| 67–68 | listenControlRightsDeviceControlStatus / cancelListenControlRightsDeviceControlStatus | 同上 | 模块化 |
| 69–70 | listenFlightTasksMediaFileDisplayAvailable / cancelListenFlightTasksMediaFileDisplayAvailable | 同上 | 模块化 |
| 71–72 | listenHsiInfo / cancelListenHsiInfo | 同上 | 模块化 |
1c. Drone → FlightControlModule（飞行控制）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.returnHome(cb) | drone.getFlightControlModule().returnHome(cb) | 模块化 |
| 2 | drone.returnHomeCancel(cb) | drone.getFlightControlModule().returnHomeCancel(cb) | 模块化 |
| 3 | drone.emergencyStop(cb) | drone.getFlightControlModule().drcEmergencyStop(cb) | 模块化+DRC |
| 4 | drone.sendStickControl(data) | drone.getFlightControlModule().drcSendStickControl(data) | 模块化+DRC |
注意： returnHome/returnHomeCancel不加drc前缀（走 HTTP 通道）；emergencyStop/sendStickControl加drc前缀（走 DRC 通道）。
1d. Drone → PsdkControlModule（PSDK 控制）
A 类：模块化 + DRC 前缀（监听方法）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.listenPsdkDeviceList(cb) | drone.getPsdkControlModule().listenDrcPsdkDeviceList(cb) | 模块化+DRC |
| 2 | drone.cancelListenPsdkDeviceList(id) | drone.getPsdkControlModule().cancelListenDrcPsdkDeviceList(id) | 模块化+DRC |
| 3 | drone.listenPsdkStateSummaryInfo(psdkIndex, cb) | drone.getPsdkControlModule().listenDrcPsdkStateSummaryInfo(psdkIndex, cb) | 模块化+DRC |
| 4 | drone.cancelListenPsdkStateSummaryInfo(psdkIndex, id) | drone.getPsdkControlModule().cancelListenDrcPsdkStateSummaryInfo(psdkIndex, id) | 模块化+DRC |
| 5 | drone.listenPsdkStateSpeakerInfo(psdkIndex, cb) | drone.getPsdkControlModule().listenDrcPsdkStateSpeakerInfo(psdkIndex, cb) | 模块化+DRC |
| 6 | drone.cancelListenPsdkStateSpeakerInfo(psdkIndex, id) | drone.getPsdkControlModule().cancelListenDrcPsdkStateSpeakerInfo(psdkIndex, id) | 模块化+DRC |
| 7 | drone.listenPsdkStateSearchlightInfo(psdkIndex, cb) | drone.getPsdkControlModule().listenDrcPsdkStateSearchlightInfo(psdkIndex, cb) | 模块化+DRC |
| 8 | drone.cancelListenPsdkStateSearchlightInfo(psdkIndex, id) | drone.getPsdkControlModule().cancelListenDrcPsdkStateSearchlightInfo(psdkIndex, id) | 模块化+DRC |
| 9 | drone.listenPsdkSpeakerPlayProgressInfo(psdkIndex, cb) | drone.getPsdkControlModule().listenDrcPsdkSpeakerPlayProgressInfo(psdkIndex, cb) | 模块化+DRC |
| 10 | drone.cancelListenPsdkSpeakerPlayProgressInfo(psdkIndex, id) | drone.getPsdkControlModule().cancelListenDrcPsdkSpeakerPlayProgressInfo(psdkIndex, id) | 模块化+DRC |
| 11 | drone.listenPsdkFloatingWindowTextInfo(psdkIndex, cb) | drone.getPsdkControlModule().listenDrcPsdkFloatingWindowTextInfo(psdkIndex, cb) | 模块化+DRC |
| 12 | drone.cancelListenPsdkFloatingWindowTextInfo(psdkIndex, id) | drone.getPsdkControlModule().cancelListenDrcPsdkFloatingWindowTextInfo(psdkIndex, id) | 模块化+DRC |
B 类：模块化搬迁（动作方法，方法名不变）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.searchlightModeSet(psdkIndex, mode, cb) | drone.getPsdkControlModule().searchlightModeSet(psdkIndex, mode, cb) | 模块化 |
| 2 | drone.searchlightBrightnessSet(psdkIndex, brightness, cb) | drone.getPsdkControlModule().searchlightBrightnessSet(psdkIndex, brightness, cb) | 模块化 |
| 3 | drone.searchlightCalibration(psdkIndex, cb) | drone.getPsdkControlModule().searchlightCalibration(psdkIndex, cb) | 模块化 |
| 4 | drone.searchlightFineTuningSet(psdkIndex, position, value, saved, cb) | drone.getPsdkControlModule().searchlightFineTuningSet(psdkIndex, position, value, saved, cb) | 模块化 |
| 5 | drone.searchlightWideFieldModeSet(psdkIndex, mode, cb) | drone.getPsdkControlModule().searchlightWideFieldModeSet(psdkIndex, mode, cb) | 模块化 |
| 6 | drone.searchlightLightGimbalControlSet(psdkIndex, control, cb) | drone.getPsdkControlModule().searchlightLightGimbalControlSet(psdkIndex, control, cb) | 模块化 |
| 7 | drone.searchlightTypeSet(psdkIndex, type, cb) | drone.getPsdkControlModule().searchlightTypeSet(psdkIndex, type, cb) | 模块化 |
| 8 | drone.speakerAudioPlayStart(psdkIndex, info, cb) | drone.getPsdkControlModule().speakerAudioPlayStart(psdkIndex, info, cb) | 模块化 |
| 9 | drone.speakerTTSPlayStart(psdkIndex, info, cb) | drone.getPsdkControlModule().speakerTTSPlayStart(psdkIndex, info, cb) | 模块化 |
| 10 | drone.speakerReplay(psdkIndex, cb) | drone.getPsdkControlModule().speakerReplay(psdkIndex, cb) | 模块化 |
| 11 | drone.speakerPlayStop(psdkIndex, cb) | drone.getPsdkControlModule().speakerPlayStop(psdkIndex, cb) | 模块化 |
| 12 | drone.speakerPlayVolumeSet(psdkIndex, volume, cb) | drone.getPsdkControlModule().speakerPlayVolumeSet(psdkIndex, volume, cb) | 模块化 |
| 13 | drone.speakerPlayModeSet(psdkIndex, mode, cb) | drone.getPsdkControlModule().speakerPlayModeSet(psdkIndex, mode, cb) | 模块化 |
| 14 | drone.speakerTTSSet(psdkIndex, config, cb) | drone.getPsdkControlModule().speakerTTSSet(psdkIndex, config, cb) | 模块化 |
| 15 | drone.widgetValueSet(psdkIndex, index, value, cb) | drone.getPsdkControlModule().widgetValueSet(psdkIndex, index, value, cb) | 模块化 |
| 16 | drone.widgetInputBoxTextSet(psdkIndex, value, cb) | drone.getPsdkControlModule().widgetInputBoxTextSet(psdkIndex, value, cb) | 模块化 |
1e. Drone → 其他子模块
| 目标模块 | 方法 | 标签 |
|---|---|---|
TakeoffModule | takeoff(params, cb) | 模块化 |
ControlAuthModule | acquireFlightControlAuthority(cb) / releaseFlightControlAuthority(cb) / listenFlightControlAuthority(cb) / cancelListenFlightControlAuthority(id) / acquirePayloadControlAuthority(payloadIndex, cb) / releasePayloadControlAuthority(payloadIndex, cb) / listenPayloadControlAuthority(payloadIndex, cb) / cancelListenPayloadControlAuthority(payloadIndex, id) | 模块化 |
DrcModule | connectDrcLink(cb) / disconnectDrcLink(cb) / listenLinkStatus(cb) / cancelListenLinkStatus(id) | 模块化 |
FlightSettingsModule | setFlightSmartPlanMode(mode, cb) / setOutOfControlAction(action, cb) / setFlightTaskHeight(height, cb) / setRthAltitude(altitude, cb) / setAirTransferEnable(enabled, cb) | 模块化 |
DeviceStateModule | listenDroneOnlineStatus(cb) / cancelListenDroneOnlineStatus(id) | 模块化 |
DeviceManageModule | listenDeviceTopoChanged(cb) / cancelListenDeviceTopoChanged(id) | 模块化 |
LiveDeviceModule | listenLiveAvailableRange(cb) / cancelListenLiveAvailableRange(id) | 模块化 |
1f. Drone → DeviceHMSModule（HMS — Aircraft→Device 改名）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | drone.listenAircraftHMS(cb) | drone.getDeviceHMSModule().listenDeviceHMS(cb) | 模块化+改名 |
| 2 | drone.cancelListenAircraftHMS(id) | drone.getDeviceHMSModule().cancelListenDeviceHMS(id) | 模块化+改名 |
注意： Aircraft→Device改名。Drone 和 Dock 共享同一个DeviceHMSModule。
1g. Drone 上保留的方法（不变）
| 方法 | 说明 |
|---|---|
drone.getLiveStream(params) | 获取直播模块 |
drone.getLiveRecord(params) | 获取录像模块 |
drone.getFlyToPointModule() | 获取 FlyTo 模块 |
drone.getPoiModule() | 获取 POI 模块 |
drone.getFlightTaskControlModule() | 获取航线任务控制模块 |
变更 2：Dock 模块化搬迁
Dock 有 89 个方法。KOC3 只剩 11 个 getter。Dock 新增的 getter（KOC3）
| getter | 返回类型 |
|---|---|
getDockOsdModule() | DockOsdModule |
getDockControlModule() | DockControlModule |
getDeployModule() | DeployModule |
getDeviceStateModule() | DeviceStateModule |
getDeviceHMSModule() | DeviceHMSModule |
getLiveDeviceModule() | LiveDeviceModule |
getRtkCalibrationModule() | RtkCalibrationModule |
getNetworkTestModule() | NetworkTestModule |
getDeviceDebugModule() | DeviceDebugModule |
2a. Dock → DockOsdModule（Dock OSD 监听）
所有 listenDock*/cancelListenDock*方法搬到DockOsdModule，方法名不变。
| # | 方法范围 | 标签 |
|---|---|---|
| 1–2 | listenDockLocation / cancelListenDockLocation | 模块化 |
| 3–4 | listenDroneInDock / cancelListenDroneInDock | 模块化 |
| 5–6 | listenDockCoverState / cancelListenDockCoverState | 模块化 |
| 7–8 | listenDockMediaFileDetail / cancelListenDockMediaFileDetail | 模块化 |
| 9–10 | listenDockWirelessLink / cancelListenDockWirelessLink | 模块化 |
| 11–12 | listenDockJobNumber / cancelListenDockJobNumber | 模块化 |
| 13–14 | listenDockPowerState / cancelListenDockPowerState | 模块化 |
| 15–16 | listenDockStorageState / cancelListenDockStorageState | 模块化 |
| 17–18 | listenDockFirstPowerOnTime / cancelListenDockFirstPowerOnTime | 模块化 |
| 19–20 | listenDockAccumulatedRunningTime / cancelListenDockAccumulatedRunningTime | 模块化 |
| 21–22 | listenDockAlternateLandPoint / cancelListenDockAlternateLandPoint | 模块化 |
| 23–24 | listenDockPositionState / cancelListenDockPositionState | 模块化 |
| 25–26 | listenDockActivationTime / cancelListenDockActivationTime | 模块化 |
| 27–28 | listenDockBatteryStoreMode / cancelListenDockBatteryStoreMode | 模块化 |
| 29–30 | listenDockAlarmState / cancelListenDockAlarmState | 模块化 |
| 31–32 | listenDockDroneBatteryMaintenanceInfo / cancelListenDockDroneBatteryMaintenanceInfo | 模块化 |
| 33–34 | listenDockEmergencyStopState / cancelListenDockEmergencyStopState | 模块化 |
| 35–36 | listenDockSilentMode / cancelListenDockSilentMode | 模块化 |
| 37–38 | listenDockUserExperienceImprovement / cancelListenDockUserExperienceImprovement | 模块化 |
| 39–40 | listenDockDrcState / cancelListenDockDrcState | 模块化 |
| 41–42 | listenDockPutterState / cancelListenDockPutterState | 模块化 |
| 43–44 | listenDockRelativeAlternateLandPoint / cancelListenDockRelativeAlternateLandPoint | 模块化 |
| 45–46 | listenDockSelfConvergeCoordinate / cancelListenDockSelfConvergeCoordinate | 模块化 |
| 47–48 | listenDockFirmwareInfo / cancelListenDockFirmwareInfo | 模块化 |
| 49–50 | listenDockModeCode / cancelListenDockModeCode | 模块化 |
| 51–52 | listenDockSubDevice / cancelListenDockSubDevice | 模块化 |
| 53–54 | listenDockNetworkState / cancelListenDockNetworkState | 模块化 |
| 55–56 | listenDockDroneChargeState / cancelListenDockDroneChargeState | 模块化 |
| 57–58 | listenDockMeteorologicalInfo / cancelListenDockMeteorologicalInfo | 模块化 |
| 59–60 | listenDockBackupBatteryInfo / cancelListenDockBackupBatteryInfo | 模块化 |
| 61–62 | listenDockMaintainStatusInfo / cancelListenDockMaintainStatusInfo | 模块化 |
2b. Dock → DockControlModule（Dock 控制）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | dock.changeDockCameraPosition(liveInfo, cameraPosition, gatewaySn, cb) | dock.getDockControlModule().changeDockCameraPosition(liveInfo, cameraPosition, gatewaySn, cb) | 模块化 |
| 2 | dock.listenDockAirConditionerStatusInfo(cb) | dock.getDockControlModule().listenDockAirConditionerStatusInfo(cb) | 模块化 |
| 3 | dock.cancelListenDockAirConditionerStatusInfo(id) | dock.getDockControlModule().cancelListenDockAirConditionerStatusInfo(id) | 模块化 |
| 4 | dock.listenDockSupplementLightState(cb) | dock.getDockControlModule().listenDockSupplementLightState(cb) | 模块化 |
| 5 | dock.cancelListenDockSupplementLightState(id) | dock.getDockControlModule().cancelListenDockSupplementLightState(id) | 模块化 |
| 6 | dock.setDockSupplementLightState(state, cb) | dock.getDockControlModule().setDockSupplementLightState(state, cb) | 模块化 |
| 7 | dock.setDockChargeState(state, cb) | dock.getDockControlModule().setDockChargeState(state, cb) | 模块化 |
| 8 | dock.setDockCoverState(mode, cb) | dock.getDockControlModule().setDockCoverState(mode, cb) | 模块化 |
| 9 | dock.setDockAirConditionerMode(mode, cb) | dock.getDockControlModule().setDockAirConditionerMode(mode, cb) | 模块化 |
2c. Dock → DeviceHMSModule（HMS — DockHMS→DeviceHMS 改名）
| # | KOC2 | KOC3 | 标签 |
|---|---|---|---|
| 1 | dock.listenDockHMS(cb) | dock.getDeviceHMSModule().listenDeviceHMS(cb) | 模块化+改名 |
| 2 | dock.cancelListenDockHMS(id) | dock.getDeviceHMSModule().cancelListenDeviceHMS(id) | 模块化+改名 |
2d. Dock → 其他子模块
| 目标模块 | 方法 | 标签 |
|---|---|---|
DeviceStateModule | listenDockOnlineStatus(cb) / cancelListenDockOnlineStatus(id) | 模块化 |
DeviceManageModule | listenDeviceTopoChanged(cb) / cancelListenDeviceTopoChanged(id) | 模块化 |
LiveDeviceModule | listenLiveAvailableRange(cb) / cancelListenLiveAvailableRange(id) | 模块化 |
TakeoffModule | listenCommandTaskEvent(cb) / cancelListenCommandTaskEvent(id) | 模块化 |
FlyToPointModule | listenFlyToTaskEvent(cb) / cancelListenFlyToTaskEvent(id) | 模块化 |
FlightTaskControlModule | listenWaylineTaskEvent(cb) / cancelListenWaylineTaskEvent(id) | 模块化 |
PoiModule | listenPoiTaskEvent(cb) / cancelListenPoiTaskEvent(id) | 模块化 |
2e. Dock 上保 留的方法（不变）
| 方法 | 说明 |
|---|---|
dock.getLiveStream(params) | 获取直播模块 |
dock.getLiveRecord(params) | 获取录像模块 |
变更 3：Workspace 模块化搬迁
Workspace 有 64 个方法。KOC3 只剩 18 个 getter。Workspace 新增的 getter（KOC3）
| getter | 返回类型 |
|---|---|
getDeviceManageModule() | DeviceManageModule |
getFirmwareManageModule() | FirmwareManageModule |
getWaylineManageModule() | WaylineManageModule |
getPsdkResourceModule() | PsdkResourceModule |
getAIBoxModule() | AIBoxModule |
getFlashLedModule() | FlashLedModule |
getAIInsideManageModule() | AIInsideManageModule |
getElementModule() | ElementModule |
getAIAlertModule() | AiAlertModule |
getLiveSyncModule() | LiveSyncModule |
移除的 getter： getDeviceDebugModule()（改为通过drone.getDeviceDebugModule()或dock.getDeviceDebugModule()获取）
搬迁规则
| 目标模块 | 方法范围 | 标签 |
|---|---|---|
DeviceManageModule | getDeviceList(cb) / getDeviceDetailInfo(sn, cb) / modifyDeviceName(params, cb) / unbindDevice(sns, cb) / listenWorkspaceDeviceChanged(cb) / cancelListenWorkspaceDeviceChanged(id) / getDockDeviceStatus(params, cb) / getDroneDeviceStatus(params, cb) | 模块化 |
PsdkResourceModule | getPsdkSpeakerResourceList(cb) / createPsdkSpeakerResource(params, cb) / editPsdkSpeakerResource(params, cb) / deletePsdkSpeakerResource(id, cb) / getSTS(cb) / uploadSpeakerAudioFile(filePath, stsInfo, cb) / getPsdkWidgetResources(params, cb) | 模块化 |
FirmwareManageModule | getLatestFirmwareReleaseNote(keys, lang, cb) / invokeFirmwareUpgrade(params, cb) / queryFirmwareUpgradeProgress(sn, cb) / uploadFirmwareFile(filePath, cb) / releaseFirmware(fileId, cb) / unReleaseFirmware(fileId, cb) / deleteFirmware(fileId, cb) / queryFirmwareList(page, pageSize, cb) / queryFirmwareCompatibilityConfig(cb) / checkFirmwareStatus(sns, statuses, cb) / submitFirmwareInfo(info, cb) | 模块化 |
WaylineManageModule | getWaylineList(param, cb) / getWaylineDetail(uuid, cb) / batchDeleteWaylines(uuids, cb) / updateWayline(uuid, name, cb) / submitWaylineInfo(param, cb) / batchDownloadWaylines(param, cb) / duplicateWayline(param, cb) / listenImportWaylineEvent(cb) / cancelListenImportWaylineEvent(id) | 模块化 |
AIBoxModule | fetchAIBoxInfo(sn, cb) / uploadAIBoxFile(filePath, sn, boxSn, cb) / fetchFileDownloadUrl(param, cb) / fetchAppList(param, cb) / fetchAppListProgress(param, cb) / exportFile(param, cb) / exportFileProgress(param, cb) / installApp(param, cb) / installAppProgress(param, cb) / operateApp(param, cb) | 模块化 |
SafetyServiceModule | getUnlockLicenseList(param, cb) / switchUnlockLicense(param, cb) / checkUnlockLicense(param, cb) / submitUnlockLicense(param, cb) / clearDeviceUnlockLicense(sn, cb) / uploadUnlockLicenseFile(filePath, cb) | 模块化 |
LiveDeviceModule | getAudienceCount(group, cb) | 模块化+签名变化 |
注意： listenDeviceTopoChanged/cancelListenDeviceTopoChanged在 KOC2 中位于Drone和Dock（非 Workspace），KOC3 搬到DeviceManageModule，详见变更 1e 和 2d。getAudienceCount签名变化：KOC2 为getAudienceCount(deviceList, group, cb)，KOC3 删除了deviceList参数，改为getAudienceCount(group, cb)。
Workspace 上保留的 getter（不变）
getFlightTaskModule() / getMediaServiceModule() / getTerraBuildModule() / getSafetyServiceModule() / getFlightTaskRecordModule() / getHMSModule() / getLogManagementModule() / getMaintenanceManagementModule() / getDiagnosisManagementModule()变更 4：Available 监听方法废弃
listenXxxAvailable / cancelListenXxxAvailable 方法，用于在调用功能前检查该功能是否可用。KOC3 全部删除。无 1:1 等价替代。KOC3 的设计理念是"直接调用，通过回调错误码判断结果"，不再提供前置可用性查询。 替代建议：(1) 飞行控制类能力可用 ControlAuthModule（drone.getControlAuthModule()）检查控制权获取状态，确保有权限后再调用；(2) 相机类能力直接调用drcTakePhoto()等方法，在回调中判断FlightHubError错误码，按错误码做降级处理。
已删除的 Available 方法
| # | 废弃方法（KOC2） | 所属功能域 |
|---|---|---|
| 1 | listenPanoramaAvailable / cancelListenPanoramaAvailable | 相机/全景 |
| 2 | listenSwitchLiveLensAvailable / cancelListenSwitchLiveLensAvailable | 相机/直播 |
| 3 | listenTakePhotoAvailable / cancelListenTakePhotoAvailable | 相机/拍照 |
| 4 | listenRecordAvailable / cancelListenRecordAvailable | 相机/录像 |
| 5 | listenZoomAtTargetAvailable / cancelListenZoomAtTargetAvailable | 相机/变焦 |
| 6 | listenSetFocalLengthAvailable / cancelListenSetFocalLengthAvailable | 相机/焦距 |
| 7 | listenSwitchCameraModeAvailable / cancelListenSwitchCameraModeAvailable | 相机/模式切换 |
| 8 | listenLookAtTargetAvailable / cancelListenLookAtTargetAvailable | 相机/看向目标 |
| 9 | listenThermalGainModeAvailable / cancelListenThermalGainModeAvailable | 红外/增益模式 |
| 10 | listenThermalGainModeSetAvailable / cancelListenThermalGainModeSetAvailable | 红外/增益设置 |
| 11 | listenFlyToPointAvailable / cancelListenFlyToPointAvailable | 飞行控制/FlyTo |
| 12 | listenFlightTaskControlAvailable / cancelListenFlightTaskControlAvailable | 飞行控制/航线任务 |
| 13 | listenEmergencyStopAvailable / cancelListenEmergencyStopAvailable | 飞行控制/紧急停止 |
| 14 | listenSticksControlAvailable / cancelListenSticksControlAvailable | 飞行控制/摇杆 |
| 15 | listenTakeoffAvailable / cancelListenTakeoffAvailable | 飞行控制/起飞 |
| 16 | listenReturnHomeAvailable / cancelListenReturnHomeAvailable | 飞行控制/返航 |
| 17 | listenReturnHomeCancelAvailable / cancelListenReturnHomeCancelAvailable | 飞行控制/取消返航 |
变更 5：其他废弃方法
| KOC2 方法 | 说明 |
|---|---|
drone.listenAircraftTakeoffProgress(cb) / cancelListenAircraftTakeoffProgress(id) | 删除（KOC3 无对应方法） |
workspace.getFlysafeDatabaseUpgradeCheck(sn, cb) / invokeFlysafeDatabaseUpgrade(sns, cb) | 删除（限飞库升级功能取消） |
注意：KOC2 Workspace上的fetchFileDownloadUrl/fetchAppList/fetchAppListProgress/exportFile/exportFileProgress/installApp/installAppProgress/operateApp等 8 个方法不是废弃，而是迁移到了AIBoxModule（详见变更 3）。参数类型改为 AIBox 专用 param 类。flightTaskRecordModule.getExportFlightRecordsProgress(...)在 KOC3 中仍保留，无需迁移。
变更 6：DeviceDebugModule 拆分 + 签名变化
DeviceDebugModule 通过 workspace.getDeviceDebugModule() 获取。KOC3 中改为通过 drone.getDeviceDebugModule() 或 dock.getDeviceDebugModule() 获取，且网络测试、RTK 标定、中继器控制方法被拆分到 3 个新模块，去掉了 String device_sn 参数。6a. 网络测试 → NetworkTestModule
获取路径： dock.getNetworkTestModule()
| # | KOC2 | KOC3 | 变化 |
|---|---|---|---|
| 1 | deviceDebug.startNetworkTest(sn, cb) | networkTest.startNetworkTest(cb) | 去掉 sn |
| 2 | deviceDebug.stopNetworkTest(sn, cb) | networkTest.stopNetworkTest(cb) | 去掉 sn |
| 3 | deviceDebug.getNetworkTestProgress(sn, cb) | networkTest.getNetworkTestProgress(cb) | 去掉 sn |
| 4 | deviceDebug.subscribeDeviceNetworkSpeedTestProgress(sn, cb) | networkTest.subscribeNetworkTestProgress(cb) | 改名 + 去掉 sn |
| 5 | deviceDebug.unSubscribeDeviceNetworkSpeedTestProgress(id) | networkTest.unsubscribeNetworkTestProgress(id) | 改名 |
6b. RTK 标定 → RtkCalibrationModule
获取路径： dock.getRtkCalibrationModule()/baseStation.getRtkCalibrationModule()/relay.getRtkCalibrationModule()
| # | KOC2 | KOC3 | 变化 |
|---|---|---|---|
| 1 | deviceDebug.subscribeDeviceRtkCalibrationProgress(sn, cb) | rtkCalibration.subscribeCalibrationProgress(cb) | 改名 + 去掉 sn |
| 2 | deviceDebug.unSubscribeDeviceRtkCalibrationProgress(id) | rtkCalibration.unsubscribeCalibrationProgress(id) | 改名 |
| 3 | deviceDebug.deviceRtkCalibrationByManual(sn, params, cb) | rtkCalibration.calibrationByManual(params, cb) | 改名 + 去掉 sn |
| 4 | deviceDebug.deviceRtkCalibrationByNetwork(sn, params, cb) | rtkCalibration.calibrationByNetwork(params, cb) | 改名 + 去掉 sn |
| 5 | deviceDebug.relayRtkCalibrationByManual(sn, params, cb) | rtkCalibration.calibrationByManual(params, cb) | 改名 + 去掉 sn + 与 #3 合并（回调 RelayRtkCalibrationCallback → RtkCalibrationCallback） |
| 6 | deviceDebug.relayRtkCalibrationByNetwork(sn, params, cb) | rtkCalibration.calibrationByNetwork(params, cb) | 改名 + 去掉 sn + 与 #4 合并（回调 RelayRtkCalibrationCallback → RtkCalibrationCallback） |
注意：KOC2 中 device 和 relay 各有 2 个标定方法（共 4 个），KOC3 合并为 2 个（ calibrationByManual/calibrationByNetwork），不再区分 device/relay。回调类型统一为RtkCalibrationCallback。
6c. 中继器控制 → RelayControlModule
获取路径： relay.getRelayControlModule()
| # | KOC2 | KOC3 | 变化 |
|---|---|---|---|
| 1 | deviceDebug.setRelayBroadcastHide(sn, isHide, cb) | relayControl.setRelayBroadcastHide(isHide, cb) | 去掉 sn |
| 2 | deviceDebug.setRelaySSID(sn, name, cb) | relayControl.setRelaySSID(name, cb) | 去掉 sn |
| 3 | deviceDebug.setRelayPassword(sn, pwd, cb) | relayControl.setRelayPassword(pwd, cb) | 去掉 sn |
| 4 | deviceDebug.setRelaySearchMode(sn, mode, cb) | relayControl.setRelaySearchMode(mode, cb) | 去掉 sn |
| 5 | deviceDebug.setRelayOccupiedStatus(sn, status, cb) | relayControl.setRelayOccupiedStatus(status, cb) | 去掉 sn |
| 6 | deviceDebug.relayReboot(sn, cb) | relayControl.relayReboot(cb) | 去掉 sn |
| 7 | deviceDebug.relayDisconnect(sn, cb) | relayControl.relayDisconnect(cb) | 去掉 sn |
6d. DeviceDebugModule 新增方法（KOC3）
| 方法 | 说明 |
|---|---|
startManualBatterySwap(sn, slotId, cb) | 手动换电 |
getManualBatterySwapProgress(sn, cb) | 换电进度 |
setDonglePowerSwitch(sn, state, cb) | Dongle 电源开关 |
setLowPowerSwitch(sn, mode, cb) | 低电 量模式 |
getEsimOperatorSwitchProgress(sn, cb) | eSIM 切换进度 |
变更 7：FlyToPointModule 方法改名
| KOC2 | KOC3 | 标签 |
|---|---|---|
flyToPoint.stop(cb) | flyToPoint.drcStop(cb) | DRC 前缀 |
其他方法（ start、subscribeFlyToPointProgress、updateTargetPoints等）不变。
变更 8：FlightHubSDK 门面补齐与入口变化
门面与内部实现： FlightHubSDK是面向用户的门面类，用户代码应通过它获取所有设备实例和管理能力。FlightHubSdkManager是内部实现类，用户不应直接调用。KOC2 中FlightHubSDK门面不完整，用户部分场景仍需直接使用FlightHubSdkManager；KOC3 补齐门面，统一走FlightHubSDK。
8a. 入口类切换：FlightHubSdkManager → FlightHubSDK
| KOC2 | KOC3 | 说明 |
|---|---|---|
FlightHubSdkManager.initialize(config) | FlightHubSDK.initialize(config) | SDK 初始化 |
FlightHubSdkManager.shutdown() | FlightHubSDK.shutdown() | SDK 关闭 |
FlightHubSdkManager.isInitialized() | FlightHubSDK.isInitialized() | 初始化状态 |
FlightHubSdkManager.getVersion() | FlightHubSDK.getVersion() | 版本号 |
FlightHubSdkManager.getBuildInfo() | FlightHubSDK.getBuildInfo() | 构建信息 |
FlightHubSdkManager.setLogLevel(level) | FlightHubSDK.setLogLevel(level) | 日志级别 |
FlightHubSdkManager.setWebSocketAuthHeaders(headers) | FlightHubSDK.setWebSocketAuthHeaders(headers) | WebSocket 鉴权头 |
FlightHubSdkManager.setHttpHeaders(headers) | FlightHubSDK.setHttpHeaders(headers) | HTTP 鉴权头 |
FlightHubSdkManager.getWebSocketAuthHeaders() | FlightHubSDK.getWebSocketAuthHeaders() | 获取 WebSocket 鉴权头 |
FlightHubSdkManager.getHttpHeaders() | FlightHubSDK.getHttpHeaders() | 获取 HTTP 鉴权头 |
FlightHubSdkManager.getConfig() | FlightHubSDK.getConfig() | 获取配置 |
FlightHubSdkManager.getWorkspaceInstance() | FlightHubSDK.getWorkspaceInstance() | 获取 Workspace 实例 |
FlightHubSdkManager.getDroneInstance(sn) | FlightHubSDK.getDroneInstance(sn) | 获取 Drone 实例 |
FlightHubSdkManager.getDockInstance(sn) | FlightHubSDK.getDockInstance(sn) | 获取 Dock 实例 |
FlightHubSdkManager.getStreamInstance() | FlightHubSDK.getStream() | 获取 Stream 实例（注意方法名变化） |
8b. 移除的 session 机制
| KOC2 | KOC3 | 变化 |
|---|---|---|
FlightHubSdkManager.registerWorkspaceToken(uuid, token) | 删除 | session 注册机制移除 |
FlightHubSdkManager.getSessionInfo(sessionId) | 删除 | session 查询移除 |
FlightHubSdkManager.getWorkspaceInstance(sessionId) | 删除 | 改用 FlightHubSDK.getWorkspaceInstance() |
FlightHubSdkManager.getDroneInstance(sessionId, sn) | 删除 | 改用 FlightHubSDK.getDroneInstance(sn) |
FlightHubSdkManager.getDockInstance(sessionId, sn) | 删除 | 改用 FlightHubSDK.getDockInstance(sn) |
8c. 新增设备类型门面入口
FlightHubSDK 门面上新增以下设备实例获取方法（KOC2 无对应能力）：| KOC3 新增 | 说明 |
|---|---|
FlightHubSDK.getRemoteControllerInstance(sn) | 获取遥控器实例 |
FlightHubSDK.getBaseStationInstance(sn) | 获取基站实例 |
FlightHubSDK.getRelayInstance(sn) | 获取中继器实例 |
变更 9：FlightTaskControlModule 变化
| KOC2 | KOC3 | 变化 |
|---|---|---|
flightTaskControl.listenFlightTaskControlAvailable(cb) | 删除 | Available 方法废弃 |
flightTaskControl.cancelListenFlightTaskControlAvailable(id) | 删除 | Available 方法废弃 |
| — | flightTaskControl.listenWaylineTaskEvent(cb) | 新增（从 Dock 搬入） |
| — | flightTaskControl.cancelListenWaylineTaskEvent(id) | 新增（从 Dock 搬入） |
pause(cb)/resume(cb)/getModule()不变。
变更 10：Bean / 参数类破坏性变化
⚠️ 编译期必挂：以下 Bean 的字段被删除或改名，调用方 getter/setter 会直接编译失败。即使方法搬迁已改完，也必须逐个检查这些 Bean 的使用点。
10a. TakeoffParams — 删除 mediaFolderName
| 字段 | KOC2 | KOC3 | 变化 |
|---|---|---|---|
mediaFolderName | String（默认 ""） | ❌ 删除 | 删除 — getMediaFolderName() / setMediaFolderName() 编译失败 |
cloudToCloudId | ❌ | String（默认 ""） | 新增（云云对接存储桶 ID） |
needVerifyFlightControl | ❌ | int（默认 -1） | 新增（是否需校验飞控权） |
commanderFlightMode | 默认 0 | 默认 -1 | 默认值变化（0→-1，语义"未设置"） |
commanderFlightHeight | 默认 0 | 默认 -1 | 默认值变化 |
rthMode | 默认 0 | 默认 -1 | 默认值变化 |
10b. LiveRecordItem — 字段大面积改名
| KOC2 字段 | KOC3 字段 | 变化 |
|---|---|---|
recordId (String) | bid (String) | 改名 |
status (String) | state (int) | 改名 + 类型变化（String→int，0=成功/1=录制中/2=初始化/3=失败） |
startTs (long) | duration (long) | 改名（不再返回起止时间戳，改为录制时长秒） |
endTs (long) | ❌ | 删除（合并为 duration） |
video (String) | ❌ | 删除 |
camera (String) | camera (String) | 保留（唯一不变字段） |
| ❌ | sn (String) | 新增（设备 SN） |
| ❌ | createdBy (String) | 新增（创建者） |
10c. FlightHubSdkConfig — 删除 token，新增 drtcConfigPath
| 字段 | KOC2 | KOC3 | 变化 |
|---|---|---|---|
token | String（默认 ""） | ❌ 删除 | 删除 — getToken() / setToken() 编译失败。认证方式变更，不再通过 config 注入 token |
drtcConfigPath | ❌ | String（默认 ""） | 新增（DRTC Native SDK 配置文件路径，如 drtc_config_node.json） |
| 其余字段 | — | — | 不变（logLevel / address / port / notificationServerAddress 等） |