PaasJS 新增特性

一、组件概览

组件	KOC2	KOC3
航线编辑（`WaylineEditor`）	✅ 支持	✅ 支持，新增拼接、拓扑连线、碰撞返回事件
航线预览（`WaylineView`）	❌ 不支持	✅ 新增
设备管理（`UranusDeviceManagerApp`）	✅ 支持，整包 `init()`	✅ 支持，架构升级为模块化挂载
驾驶舱（`FH2.loadCockpit`）	✅ 支持	✅ 支持，新增模块显隐配置、自定义按钮、主题 token
飞行记录（`FlyDataReplay`）	✅ 支持，依赖 paas.js	✅ 支持，不再依赖 paas.js，新增多项功能
直播大屏（`DJILivePlayer`）	❌ 不支持	✅ 新增
设备小窗（`FH2.loadDeviceWindow`）	❌ 不支持	✅ 新增

差异点	KOC2	KOC3
航线拼接	❌	✅ `WaylineEditor.concatWayline()` 静态方法，合并多条航线为一条
设备拓扑连线	❌	✅ 构造时传 `map.topo`，地图上渲染设备连线关系
碰撞航线返回事件	❌ 只有 `wayline-back`	✅ 新增 `collision-back`（碰撞航线只触发此事件，不触发 `wayline-back`）
限制可创建航线类型	❌	✅ `enabledWaylineTypes` 参数，控制创建弹窗中可选的航线类型

KOC2 无此组件。KOC3 新增 WaylineView SDK，用于只读预览一组航线。

差异点	KOC2	KOC3
初始化方式	`init()` 整包挂载到一个容器	`setupDeviceManager()` 全局初始化 + `mountXxx()` 按需挂载各模块
可用模块	设备列表	设备列表 + 设备运维 + 告警信息 + 设备定损与反馈 + 维保看板 + 行业无忧 + 固件管理
模块卸载	❌	✅ `handle.unmount()`，选项卡切换时按需卸载
自留地插槽	❌	✅ `slots` 参数，在指定位置注入 ISV 自定义 UI
设备运维新能力	❌	✅ 换电指令、RTK 校准、SIM 信息查询、电池存储模式、节能模式
SDK 路径	`device-manager-sdk/`	`device-manager-sdk-v2/`

注意： KOC2 的 init() 方法在 KOC3 中已不推荐使用，新接入请直接使用 setupDeviceManager。

差异点	KOC2	KOC3
模块显隐配置	❌	✅ `cockpitConfig` 参数，控制 5 个顶层模块的显示/隐藏及子功能开关
运行时更新配置	❌	✅ `FH2.setCockpitConfig()` 驾驶舱挂载后随时推送新配置
ISV 自定义按钮	❌	✅ 可注入到顶栏右侧和主视频区 footer 工具栏
ISV 航线库跳转	❌ 点击航线入口无法跳转	✅ `cockpitConfig.waylinePlanUrl` 配置后点击即跳转
摄像头验密跳转	❌	✅ `cockpitConfig.cameraAuthVerifyUrl` 配置 ISV 自有验密页
主题定制	❌ 仅支持 CSS 变量覆盖	✅ 新增 token 体系（约 90 个 snake_case token），内置 `default`/`tech-blue` 两套预设
运行时切换主题	❌	✅ `FH2.setCockpitTheme()` / `FH2.setCockpitPreset()` / `FH2.resetCockpitTheme()`
设备列表模块	—	⚠️ KOC3 阶段默认隐藏，待后续版本放开

差异点	KOC2	KOC3
依赖 paas.js	✅ 必须先加载 paas.js	❌ 不再依赖 paas.js，SDK 自建 Cesium 地图
地图配置方式	依赖 `FH2.loadMap`	通过构造参数 `map` 传入
自定义侧边栏面板	❌	✅ `sidebarItems` 参数，在播放器侧边栏注入自定义图标按钮和面板
自定义任务信息区域	❌	✅ `renderTaskInfo` 参数，覆盖顶部任务信息展示
设备拓扑连线	❌	✅ 构造时传 `map.topo` 启用

迁移提示： KOC2 的飞行记录组件代码在 KOC3 中需要修改：去掉 hostUrl，改为传 map 配置。

KOC2 无此组件。KOC3 新增 DJILivePlayer，完全独立，不依赖 paas.js。

KOC2 无此组件。KOC3 新增 FH2.loadDeviceWindow，拉起设备直播小窗浮层。

功能	说明
设备小窗浮层	地图底图 + 设备位置标记 + 直播小窗
任务栏	`setTask()` 设置任务状态与标签
HMS 告警入口	`setHmsUrl()` 设置跳转链接
驾驶舱入口	`setCockpitUrl()` 设置跳转链接
在线天气	`setOnlineWeather()` 推送天气数据
动态增删设备	`FH2.updateDeviceWindow()` 全量替换，内部自动 diff

以下变更在 KOC3 中会导致原有 KOC2 代码不可用，升级时需要修改：

组件	变更内容	处理方式
飞行记录	不再依赖 paas.js	去掉 `hostUrl`，改为传 `map` 配置
设备管理	`init()` 不再推荐	改用 `setupDeviceManager()` + `mountDeviceList()`
设备管理	SDK 路径变更	`device-manager-sdk/` → `device-manager-sdk-v2/`
航线编辑	碰撞航线只触发 `collision-back`	同时监听 `wayline-back` 和 `collision-back`