1. SDK版本迁移指南
上云 API 2 说明文档(KOC3)
  • 快速开始
  • 申请许可证
  • 联系我们
  • 软件下载
  • 使用上云 API 2 设备模拟器
  • 鉴权接入指南
  • 部署上云 API 2 应用运行与设备管控底座
    • 部署指南
    • 部署前准备
    • 开始部署
    • 能力扩展
  • 设备上云
    • 设备上云
    • 设备固件版本
  • 集成前端独立组件
    • 集成指南
    • 驾驶舱和设备小窗
    • 驾驶舱模块化配置
    • 设备管理组件
    • 航线组件
    • 直播大屏
    • 飞行记录
    • 集成参考
    • PaasJS 新增特性
  • SDK 文档
    • 基本介绍
      • SDK 简介
      • 功能特性
    • 快速入门
      • 准备工作
      • 使用流程
    • 接口调用
      • 接口调用时序图
    • SDK API 文档
      • 使用 API 文档查阅接口详情
    • SDK版本迁移指南
      • 迁移概述
      • 新增方法详情
      • API 变更详情
      • 迁移操作步骤
    • 功能集合
      • SDK初始化
      • SDK配置
      • DRC链路
      • 飞机状态监听
      • 飞向目标点
      • 飞行参数设置
      • 飞行记录导出
      • POI 环绕飞行
      • 一键起飞
      • 航线任务管理
      • 航线任务控制
      • 航线资产管理
      • 机场状态监听
      • 控制权管理
      • 机场控制
      • 飞行控制
      • AI Box 管理
      • AI 智能告警
      • 机载 AI 控制
      • 机载 AI 算法管理
      • PSDK 控制
      • PSDK 资源管理
      • RTK 标定
      • 安全服务
      • 固件管理
      • 媒体服务
      • 日志管理
      • 三维重建
      • 设备管理
      • 设备保修维护
      • 设备健康管理
      • 设备远程调试
      • 设备在线状态
      • 相机控制
      • 直播录制
      • 直播设备管理
      • 直播视频流
      • 直播同步
      • 中继器控制
      • 自定义 SEI
      • WHEP 自定义拉流
      • 网络测速
      • 地图元素管理
      • 频闪灯配置
  • 使用上云 API 2 AI Plugin
    • 上云 API 2 AI Plugin 使用指南
  • 使用上云 API 2 二次开发 Demo
    • 上云 API 2 二次开发 Demo 部署指南
    • 上云 API 2 二次开发 Demo - 无人机管理平台使用说明
  • 排障指南
    • 前端独立组件排障指南
    • SDK排障指南
  1. SDK版本迁移指南

迁移操作步骤

Drone 搬迁#

相机控制 → getCameraControlModule()#

全局搜索 drone.takePhoto(,改为 drone.getCameraControlModule().drcTakePhoto(
全局搜索 drone.startRecord(,改为 drone.getCameraControlModule().drcStartRecord(
全局搜索 drone.stopRecord(,改为 drone.getCameraControlModule().drcStopRecord(
全局搜索 drone.zoomAtTarget(,改为 drone.getCameraControlModule().drcZoomAtTarget(
全局搜索 drone.setFocalLength(,改为 drone.getCameraControlModule().drcSetFocalLength(
全局搜索 drone.switchCameraMode(,改为 drone.getCameraControlModule().drcSwitchCameraMode(
全局搜索 drone.switchLiveLens(,改为 drone.getCameraControlModule().drcSwitchLiveLens(
全局搜索 drone.setPhotoStorageSettings(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.setVideoStorageSettings(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.setNightSceneMode(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.resetGimbal(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.startPanorama(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.stopPanorama(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.setThermalGainMode(,加 getCameraControlModule() 并加 drc 前缀
全局搜索 drone.listenCameraState(,改为 drone.getCameraControlModule().listenDrcCameraState(
全局搜索 drone.listenGimbalState(,改为 drone.getCameraControlModule().listenDrcGimbalState(
全局搜索 drone.listenLiveVideoInfo(,改为 drone.getCameraControlModule().listenDrcLiveVideoInfo(
全局搜索 drone.listenThermalGainMode(,改为 drone.getCameraControlModule().listenDrcThermalGainMode(
全局搜索 drone.listenPanoramaStatus(,改为 drone.getCameraControlModule().listenDrcPanoramaStatus(
全局搜索 drone.lookAtTarget(,改为 drone.getCameraControlModule().lookAtTarget((注意:不加 drc 前缀)

飞行控制 → getFlightControlModule()#

全局搜索 drone.emergencyStop(,改为 drone.getFlightControlModule().drcEmergencyStop(
全局搜索 drone.sendStickControl(,改为 drone.getFlightControlModule().drcSendStickControl(
全局搜索 drone.returnHome(,改为 drone.getFlightControlModule().returnHome((不加 drc 前缀)
全局搜索 drone.returnHomeCancel(,改为 drone.getFlightControlModule().returnHomeCancel(

DRC 链路 → getDrcModule()#

全局搜索 drone.connectDrcLink(,改为 drone.getDrcModule().connectDrcLink(
全局搜索 drone.disconnectDrcLink(,改为 drone.getDrcModule().disconnectDrcLink(
全局搜索 drone.listenLinkStatus(,改为 drone.getDrcModule().listenLinkStatus(

飞机 OSD → getDroneOsdModule()#

全局搜索 drone.listenAircraftLocation(,改为 drone.getDroneOsdModule().listenAircraftLocation(
全局搜索 drone.listenAircraftAttitude(,改为 drone.getDroneOsdModule().listenAircraftAttitude(
全局搜索 drone.listenAircraftBatteryInfo(,改为 drone.getDroneOsdModule().listenAircraftBatteryInfo(
全局搜索 drone.listenAircraftModeCode(,改为 drone.getDroneOsdModule().listenAircraftModeCode(
全局搜索 drone.listenAircraftPayloadsOsdInfo(,改为 drone.getDroneOsdModule().listenAircraftPayloadsOsdInfo(
全局搜索所有其他 drone.listenAircraft*((非 HMS),加 getDroneOsdModule()
全局搜索 drone.listenHsiInfo(,改为 drone.getDroneOsdModule().listenHsiInfo(
全局搜索 drone.listenFlightTasksException(,改为 drone.getDroneOsdModule().listenFlightTasksException(

HMS → getDeviceHMSModule()(注意改名)#

全局搜索 drone.listenAircraftHMS(,改为 drone.getDeviceHMSModule().listenDeviceHMS(
全局搜索 drone.cancelListenAircraftHMS(,改为 drone.getDeviceHMSModule().cancelListenDeviceHMS(

控制权 → getControlAuthModule()#

全局搜索 drone.acquireFlightControlAuthority(,加 getControlAuthModule()
全局搜索 drone.releaseFlightControlAuthority(,加 getControlAuthModule()
全局搜索 drone.acquirePayloadControlAuthority(,加 getControlAuthModule()
全局搜索 drone.listenFlightControlAuthority(,加 getControlAuthModule()

一键起飞 → getTakeoffModule()#

全局搜索 drone.takeoff(,改为 drone.getTakeoffModule().takeoff(

飞行参数 → getFlightSettingsModule()#

全局搜索 drone.setFlightSmartPlanMode(,加 getFlightSettingsModule()
全局搜索 drone.setOutOfControlAction(,加 getFlightSettingsModule()
全局搜索 drone.setFlightTaskHeight(,加 getFlightSettingsModule()
全局搜索 drone.setRthAltitude(,加 getFlightSettingsModule()
全局搜索 drone.setAirTransferEnable(,加 getFlightSettingsModule()

PSDK 控制 → getPsdkControlModule()#

全局搜索 drone.speaker*(,加 getPsdkControlModule()
全局搜索 drone.searchlight*(,加 getPsdkControlModule()
全局搜索 drone.widget*(,加 getPsdkControlModule()
全局搜索 drone.listenPsdk*(,加 getPsdkControlModule() 并在 listen 后加 Drc(如 listenDrcPsdkDeviceList)

在线状态 → getDeviceStateModule()#

全局搜索 drone.listenDroneOnlineStatus(,加 getDeviceStateModule()

直播可用范围 → getLiveDeviceModule()#

全局搜索 drone.listenLiveAvailableRange(,加 getLiveDeviceModule()

设备拓扑 → DeviceManageModule(非 Drone)#

全局搜索 drone.listenDeviceTopoChanged(,改为 FlightHubSDK.getWorkspaceInstance().getDeviceManageModule().listenDeviceTopoChanged(

Dock 搬迁#

机场 OSD → getDockOsdModule()#

全局搜索 dock.listenDock*((排除 HMS、AirConditionerStatusInfo、SupplementLightState、OnlineStatus),加 getDockOsdModule()
确认所有 dock.cancelListenDock* 也对应修改

机场控制 → getDockControlModule()#

全局搜索 dock.changeDockCameraPosition(,加 getDockControlModule()
全局搜索 dock.setDockSupplementLightState(,加 getDockControlModule()
全局搜索 dock.setDockChargeState(,加 getDockControlModule()
全局搜索 dock.setDockCoverState(,加 getDockControlModule()
全局搜索 dock.setDockAirConditionerMode(,加 getDockControlModule()
全局搜索 dock.listenDockAirConditionerStatusInfo(,加 getDockControlModule()
全局搜索 dock.listenDockSupplementLightState(,加 getDockControlModule()

HMS → getDeviceHMSModule()(注意改名)#

全局搜索 dock.listenDockHMS(,改为 dock.getDeviceHMSModule().listenDeviceHMS(
全局搜索 dock.cancelListenDockHMS(,改为 dock.getDeviceHMSModule().cancelListenDeviceHMS(

在线状态 → getDeviceStateModule()#

全局搜索 dock.listenDockOnlineStatus(,加 getDeviceStateModule()

直播可用范围 → getLiveDeviceModule()#

全局搜索 dock.listenLiveAvailableRange(,加 getLiveDeviceModule()

任务事件搬迁#

全局搜索 dock.listenCommandTaskEvent(,加 getTakeoffModule()(通过 drone.getTakeoffModule())
全局搜索 dock.listenFlyToTaskEvent(,加 getFlyToPointModule()(通过 drone.getFlyToPointModule())
全局搜索 dock.listenWaylineTaskEvent(,加 getFlightTaskControlModule()
全局搜索 dock.listenPoiTaskEvent(,加 getPoiModule()(通过 drone.getPoiModule())

设备拓扑 → DeviceManageModule(非 Dock)#

全局搜索 dock.listenDeviceTopoChanged(,改为 FlightHubSDK.getWorkspaceInstance().getDeviceManageModule().listenDeviceTopoChanged(

Workspace 搬迁#

全局搜索 workspace.getDeviceList(,加 getDeviceManageModule()
全局搜索 workspace.getDeviceDetailInfo(,加 getDeviceManageModule()
全局搜索 workspace.modifyDeviceName(,加 getDeviceManageModule()
全局搜索 workspace.unbindDevice(,加 getDeviceManageModule()
全局搜索 workspace.listenWorkspaceDeviceChanged(,加 getDeviceManageModule()
全局搜索 workspace.getDockDeviceStatus(,加 getDeviceManageModule()
全局搜索 workspace.getDroneDeviceStatus(,加 getDeviceManageModule()
全局搜索 workspace.getPsdkSpeakerResourceList(,加 getPsdkResourceModule()
全局搜索 workspace.uploadSpeakerAudioFile(,加 getPsdkResourceModule()
全局搜索 workspace.getPsdkWidgetResources(,加 getPsdkResourceModule()
全局搜索 workspace.getLatestFirmwareReleaseNote(,加 getFirmwareManageModule()
全局搜索 workspace.invokeFirmwareUpgrade(,加 getFirmwareManageModule()
全局搜索 workspace.queryFirmwareList(,加 getFirmwareManageModule()
全局搜索 workspace.uploadFirmwareFile(,加 getFirmwareManageModule()
全局搜索 workspace.releaseFirmware(,加 getFirmwareManageModule()
全局搜索 workspace.getWaylineList(,加 getWaylineManageModule()
全局搜索 workspace.submitWaylineInfo(,加 getWaylineManageModule()
全局搜索 workspace.batchDeleteWaylines(,加 getWaylineManageModule()
全局搜索 workspace.duplicateWayline(,加 getWaylineManageModule()
全局搜索 workspace.fetchAIBoxInfo(,加 getAIBoxModule()
全局搜索 workspace.uploadAIBoxFile(,加 getAIBoxModule()
全局搜索 workspace.fetchFileDownloadUrl(,加 getAIBoxModule()
全局搜索 workspace.fetchAppList(,加 getAIBoxModule()
全局搜索 workspace.installApp(,加 getAIBoxModule()
全局搜索 workspace.operateApp(,加 getAIBoxModule()
全局搜索 workspace.getUnlockLicenseList(,加 getSafetyServiceModule()
全局搜索 workspace.getAudienceCount(,加 getLiveDeviceModule()(并删除 deviceList 参数)
全局搜索 workspace.getDeviceDebugModule(,改为 drone.getDeviceDebugModule() 或 dock.getDeviceDebugModule()

Available 方法删除#

全局搜索 listenTakePhotoAvailable,删除调用
全局搜索 listenRecordAvailable,删除调用
全局搜索 listenPanoramaAvailable,删除调用
全局搜索 listenFlyToPointAvailable,删除调用
全局搜索 listenEmergencyStopAvailable,删除调用
全局搜索 listenTakeoffAvailable,删除调用
全局搜索 listenReturnHomeAvailable,删除调用
全局搜索 listenFlightTaskControlAvailable,删除调用
全局搜索 listenSwitchLiveLensAvailable,删除调用
全局搜索 listenSticksControlAvailable,删除调用
全局搜索所有其他 listenXxxAvailable,删除调用

DeviceDebugModule 拆分#

全局搜索 deviceDebug.startNetworkTest(,改为 dock.getNetworkTestModule().startNetworkTest( 并去掉 sn 参数
全局搜索 deviceDebug.stopNetworkTest(,改为 networkTest.stopNetworkTest( 并去掉 sn
全局搜索 deviceDebug.getNetworkTestProgress(,改为 networkTest.getNetworkTestProgress( 并去掉 sn
全局搜索 deviceDebug.subscribeDeviceNetworkSpeedTestProgress(,改为 networkTest.subscribeNetworkTestProgress( 并去掉 sn
全局搜索 deviceDebug.deviceRtkCalibrationByManual(,改为 dock.getRtkCalibrationModule().calibrationByManual( 并去掉 sn
全局搜索 deviceDebug.deviceRtkCalibrationByNetwork(,改为 rtkCalibration.calibrationByNetwork( 并去掉 sn
全局搜索 deviceDebug.relayRtkCalibrationByManual(,改为 rtkCalibration.calibrationByManual( 并去掉 sn(device/relay 合并)
全局搜索 deviceDebug.relayRtkCalibrationByNetwork(,改为 rtkCalibration.calibrationByNetwork( 并去掉 sn(device/relay 合并)
全局搜索 deviceDebug.setRelay*(,改为 relay.getRelayControlModule().setRelay*( 并去掉 sn
全局搜索 deviceDebug.relayReboot(,改为 relay.getRelayControlModule().relayReboot( 并去掉 sn
全局搜索 deviceDebug.relayDisconnect(,改为 relay.getRelayControlModule().relayDisconnect( 并去掉 sn

FlyToPointModule#

全局搜索 flyToPoint.stop(,改为 flyToPoint.drcStop(

Bean / 参数类字段变化#

全局搜索 getMediaFolderName / setMediaFolderName,删除调用(TakeoffParams 已删除此字段)
全局搜索 getRecordId(LiveRecordItem 上下文),改为 getBid()
全局搜索 getStatus(LiveRecordItem 上下文),改为 getState(),并注意类型由 String → int
全局搜索 getStartTs / getEndTs(LiveRecordItem 上下文),改为 getDuration()
全局搜索 getVideo(LiveRecordItem 上下文),删除调用(字段已删除)
全局搜索 config.setToken( / config.getToken(,删除调用(FlightHubSdkConfig.token 已删除)

FlightHubSDK 门面补齐#

全局搜索 FlightHubSdkManager.,替换为 FlightHubSDK.(门面类统一入口)
全局搜索 registerWorkspaceToken,删除调用(session 机制移除)
全局搜索 getSessionInfo,删除调用(session 机制移除)
全局搜索 getWorkspaceInstance(sessionId,改为 FlightHubSDK.getWorkspaceInstance()(无参)
全局搜索 getDroneInstance(sessionId,,改为 FlightHubSDK.getDroneInstance(sn)(只传 sn)
全局搜索 getDockInstance(sessionId,,改为 FlightHubSDK.getDockInstance(sn)(只传 sn)
全局搜索 getStreamInstance(),改为 FlightHubSDK.getStream()(注意方法名变化)

最终验证#

全量编译,确认无 FlightHubSdkManager. 形式的直接调用残留
全量编译,确认无 drone.xxx( 形式的直接调用残留(除 getLiveStream / getLiveRecord / get*Module 外)
全量编译,确认无 dock.xxx( 形式的直接调用残留(除 getLiveStream / getLiveRecord / get*Module 外)
全量编译,确认无 workspace.xxx( 形式的直接调用残留(除 get*Module 外)
上一页
API 变更详情
下一页
SDK初始化
Built with