61 lines
4.3 KiB
Markdown
61 lines
4.3 KiB
Markdown
# SGS Map SDK Changelog
|
||
|
||
## [2.3.0] - 2026-06-23
|
||
|
||
### 🚀 新特性 (New Features)
|
||
- **Manifest Capabilities 扩展**：新增 9 个 v2.3 标准能力字段（`mapLoading`, `floorSwitching`, `poiQuery`, `spaceQuery`, `navigablePlaces`, `crossFloorRoute`, `accessibleRoute`, `highlight`, `diagnostics`），前端可按需判断后端支持的功能。
|
||
- **诊断接口 (Diagnostics API)**：新增地图级和楼层级诊断接口，实时检查数据完整性和就绪状态：
|
||
- `sdk.getDiagnostics()` - 获取地图整体诊断信息（包含所有楼层摘要和汇总统计）
|
||
- `sdk.getFloorDiagnostics(floorId)` - 获取单个楼层的详细诊断信息
|
||
- 诊断信息包含：模型就绪状态、POI数量、空间面数量、讲解点数量、可导航目的地数量、路网节点/边数量、路径规划就绪状态、警告列表
|
||
- **统一状态枚举**：诊断接口状态统一为 `OK` / `WARN` / `ERROR`，提供清晰的健康状态指示
|
||
|
||
### 🐞 修复与强化 (Fixes & Improvements)
|
||
- **修复阻断问题**：Manifest 正常流程补齐 v2.3 capabilities 字段设置，修复所有新增字段返回 null 的问题
|
||
- **楼层级统计准确性修复**：修复楼层诊断中 `guideStopCount` 缺少 `floorId` 过滤，现在正确按楼层统计而非全馆统计
|
||
- **地图级 summary 完善**：补齐地图级诊断 summary 的 4 个统计项（`modelReadyFloorCount`, `poiCount`, `spaceCount`, `guideStopCount`），现在包含完整的 8 个统计维度
|
||
- **H5 Bridge 消息处理**：新增 `GET_DIAGNOSTICS` 和 `GET_FLOOR_DIAGNOSTICS` 消息处理，完整支持诊断功能
|
||
|
||
### 📝 类型定义更新
|
||
- 新增 `SgsMapDiagnostics` 接口（地图级诊断响应）
|
||
- 新增 `SgsFloorDiagnostics` 接口（楼层级诊断响应）
|
||
- 新增 `SgsFloorDiagnosticsSummary` 接口（楼层诊断摘要）
|
||
- 扩展 `SgsSdkManifest.capabilities` 类型定义，包含所有 v2.3 标准字段
|
||
|
||
### 🔧 后端接口新增
|
||
- `GET /app-api/gis/sdk/maps/{mapId}/diagnostics` - 地图级诊断
|
||
- `GET /app-api/gis/sdk/floors/{floorId}/diagnostics` - 楼层级诊断
|
||
|
||
---
|
||
|
||
## [2.2.0] - 2026-06-19
|
||
|
||
### 🚀 新特性 (New Features)
|
||
- **性能监控与埋点治理**：新增底层加载耗时记录（如 `sdkCreatedAt`, `iframeDomReadyMs`, `engineReadyMs`, `manifestLoadMs`, `modelDownloadAndParseMs`），提供完整的控制台性能概览面板。
|
||
- **Demo 全面重构**：Kiosk Demo 与 Mobile Demo 引入非阻塞型 Loading 遮罩层，提升了白屏阶段的 UI 可交互体验。
|
||
|
||
### 🐞 修复与强化 (Fixes & Improvements)
|
||
- **SDK 发布管线加固**：构建体系重构，每次 Build 将自动清空并同步覆盖 `public/sdk/` 与发版包中的产物，修正了 Source Map 的内部指向错误，彻底杜绝了旧类型定义的残留。
|
||
- 深度清理所有旧版硬编码版本号注释，统一向 v2.2.0 API 规范拉齐。
|
||
- 对齐了前后端 SDK Payload 返回值 VO 定义。
|
||
|
||
## [2.0.0] - 2026-06-12
|
||
|
||
### 🚀 新特性 (New Features)
|
||
- **双域双向通信架构**：采用不可见 iframe 挂载基座，通过安全沙箱和 `postMessage` 握手进行通信，从源头上解决 WebGL Context 内存泄漏和生命周期挂起问题。
|
||
- **动态点位系统 (Markers API)**：新增 `addMarker` / `removeMarker` / `clearMarkers` 接口，支持锚定三维节点（防模型漂移）和绝对坐标系定位。
|
||
- **异步寻路确权系统**：`planRoute` 和 `changeFloor` 升级为基于 `requestId` 的 Promise 异步确权模式，支持 Timeout 拦截机制。
|
||
- **高精模型与坐标系重构**：全面接入米级统一坐标系（废弃 CAD 毫米系），支持多楼层分层物理拆分加载。
|
||
|
||
### 🐞 修复与强化 (Fixes & Improvements)
|
||
- `HELLLO` 与 `ENGINE_READY` 双向握手协议对齐。
|
||
- `targetOrigin` 自动推导增强，严格拦截非法的跨域源消息，免疫跨站攻击。
|
||
- SDK Iframe 生命周期的 `onerror` 捕捉增强，能正确派发 `loadError` 事件。
|
||
- 补齐了丢失的 `floorChanged` 运行时事件透传。
|
||
- 完善 `package.json` 工程化暴露，同时提供 IIFE 与 ESM 产物，开启源码映射（SourceMap）。
|
||
- `addMarker` 接口强制引入强类型定义 `MarkerConfig`。
|
||
|
||
### 🗑️ 废弃与移除 (Deprecations)
|
||
- 彻底移除半成品接口 `startNavigateAnim` / `stopNavigateAnim`。
|
||
- 彻底移除废弃接口 `addBusinessMarker` / `removeBusinessMarker`，统一收编为 `addMarker`。
|