飞行记录
目录
一、引入 SDK 资源
[服务器地址] 替换为您的前端服务地址）。运行时依赖库（WPMZ/PPE 等 WASM）已打包进 SDK，实例化时自动注入，无需手动引入：重要变化：新版 FlyDataReplay不再依赖paas.js，改为 SDK 自建 Cesium 地图（internal模式）。旧版参数hostUrl已废弃，可直接删除。
二、DOM 骨架与必备样式
FlyDataReplay 内部组件通过 Vue <teleport> 投递到固定选择器，完整 DOM 骨架与样式必须提供，ID 与类名不可改。三、初始化
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
taskId | string | ✓ | 飞行任务 ID（UUID 格式） |
api.baseUrl | string | ✓ | 后端服务地址，例如 http://[服务器地址]:30812/gateway |
api.auth | IAuth | ✓ | HTTP 鉴权配置 |
map | object | ✗ | 地图配置（替代旧版 hostUrl + FH2 依赖），见下 |
runtimeDepsBasePath | string | ✗ | 运行时依赖库（WPMZ/PPE 等 WASM）资源目录，默认取 SDK 脚本所在目录 |
features | object | ✗ | 功能开关，控制各按钮和轨道的初始激活状态 |
sidebarItems | array | ✗ | 自定义侧边栏面板 |
renderTaskInfo | function | ✗ | 自定义任务信息区域 |
theme | object | ✗ | 主题配色，可在 mount 后通过 setTheme() 热切换 |
hostUrl | — | — | 已废弃，传入无效，删除即可 |
| 字段 | 类型 | 说明 |
|---|---|---|
mode | 'internal' | 'external' | 默认 internal（SDK 自建 Cesium） |
container | string | HTMLElement | internal 模式地图容器，推荐传 '#map-app-global' |
env.cesiumBaseUrl | string | Cesium 资源目录 URL |
env.terrainKey | string | 地形鉴权 key，通常传空串 |
env.featureGateway | array | 特性开关网关，一般传 [] |
notifyWsUrl | string | 推送中心 WebSocket 地址，doodle 插件据此实时更新地图 |
topo | object | 拓扑设备连线配置，不传则不加载拓扑插件 |
| 字段 | 类型 | 说明 |
|---|---|---|
snList | string[] | 初始显示的设备 SN 列表 |
pollMs | number | 轮询间隔（ms），不传或 0 则不轮询 |
showFullTopo | boolean | true 点击展开整条拓扑，false（默认）仅显示当前设备 |
四、功能开关
优先级：
features > localStorage 缓存 > 代码默认值。五、自定义侧边栏面板
六、自定义任务信息区域
七、事件监听与错误码
| 事件名 | 参数 | 说明 |
|---|---|---|
back | 无 | 点击播放器返回按钮 |
wayline-preview | { waylineId: string, waylineName: string } | 点击跳转航线 |
device-selected | { deviceSn: string } | 拓扑设备 marker 被点击选中（需配置 map.topo） |
error | { code: number, message: string, data?: any } | SDK 内部错误 |
| 错误码 | 名称 | 说明 |
|---|---|---|
5000 | API_ERROR | API 请求失败（网络错误/5xx） |
5001 | API_AUTH_ERROR | API 鉴权失败（token 过期或无效） |
6000 | PARSE_ERROR | 航线数据解析失败（KMZ 格式异常） |
6002 | MAP_INIT_ERROR | 地图初始化失败 |
八、拓扑设备连线
map.topo 后，可在地图上叠加设备拓扑连线，并在运行时动态切换：九、主题定制
FlyDataTheme）| 字段 | 默认值 | 说明 |
|---|---|---|
primaryColor | #1890ff | 主色（按钮/链接/激活态） |
primaryHoverColor | #40a9ff | 主色 hover 态 |
primaryFocusColor | #096dd9 | 主色按下/聚焦态 |
bgBasic | #232323 | 基础背景色（主背景） |
bgSub | #282828 | 次级背景色（面板/侧栏） |
bgModal | #1c1c1c | 弹窗内容背景 |
bgHighlight | #101010 | 输入框/高亮区背景 |
controlBg | #2a2a2a | 控件背景色 |
controlHoverBg | #333333 | 控件 hover 背景色 |
borderColor | #4f4f4f | 边框色 |
listActiveBg | rgba(24,144,255,.2) | 列表项 active 背景 |
listHoverBg | rgba(64,169,255,.15) | 列表项 hover 背景 |
| 主题名 | 主色 | 背景 |
|---|---|---|
default | #1890ff（蓝） | #232323 |
ocean | #00b4d8（青） | #0a1929 |
violet | #9f67ff（紫） | #1a1528 |
forest | #34d399（绿） | #0e1a16 |
mount() 后随时调用）十、销毁与重建
不能同页面挂多个实例。地图实例（Cesium）是全局单例，多实例会互相覆盖状态。切换任务请使用单实例 + destroy()后重建的模式。
十一、设备兼容性说明
📌 飞行记录组件针对不同的大疆机场型号在功能表现上存在差异
| 设备型号 | 兼容性说明 |
|---|---|
| 大疆机场1 | 若设备为大疆机场1，组件仅支持展示飞行轨迹和任务详情信息，不支持时间轴等其他功能 |
| 大疆机场2 | 若设备固件版本 >= v14.01.04.07，则支持组件所有功能，否则仅支持展示飞行轨迹和任务详情信息，不支持时间轴等其他功能 |
| 大疆机场3 | 所有固件版本均支持组件所有功能 |
1.
2.
3.