修复 SGS SDK 导览数据源与模型加载
升级 SDK API 数据契约,补齐 guideStops、业务 POI、诊断与路线数据接口。 修复 SDK 模式下 POI/模型/楼层混用静态数据的问题,并为 ThreeMap 模型加载增加短退避重试。
This commit is contained in:
@@ -1,5 +1,20 @@
|
||||
# SGS Map SDK Changelog
|
||||
|
||||
## [2.4.0] - 2026-06-27
|
||||
|
||||
### 🚀 新特性 (New Features)
|
||||
- **业务 POI 接口与扩展机制**:新增 `getBusinessPois` 获取商户级业务 POI,新增 `queryPois` 支持按地图、楼层、分组、类型、关键词进行组合查询,实现与底层空间基础设施数据解耦。
|
||||
- **特色动线查询与展示**:新增 `getFeaturedRoutes` / `getFeaturedRoute` 接口获取馆方精选路线,新增 `showFlowline` / `clearFlowline` 接口提供跨层全局鸟瞰特色动线展示功能。
|
||||
- **独立 H5 渲染引擎包 (SDK Engine)**:新增 `sdk-engine/` 独立打包构建目录,支持静态编译输出至静态 `engine/` 目录。底座不依赖 Next.js 前端路由及 hydration 状态限制,由宿主系统通过 iframe 挂载 `../engine/index.html` 独立运行。
|
||||
- **配置与数据解耦**:底座数据服务入口由 `server` 查询参数动态指定,静态部署后可通过 `?server=http://localhost:3001` 指向任意数据服务地址,彻底解耦。
|
||||
|
||||
### 🐞 修复与强化 (Fixes & Improvements)
|
||||
- **解耦 Next.js 依赖**:底座引擎完全脱离 Next.js / Zustand 等大体积依赖,精简为极速加载的原生单页应用(Vite + React)。
|
||||
- **优化发包构建管线**:重新梳理 `package.json` scripts,将 SDK Bridge 与 SDK Engine 打包构建命令在命令行端进行解耦和串联(`npm run build:sdk`),优化了 `scripts/copy-sdk.js` 拷贝管线,避免嵌套与死循环构建。
|
||||
- **演示 Demo 改造**:修改 SDK 官方 Demo 的 `app.js` 使其默认消费静态 `../engine/index.html` 渲染底座,并开启 `server` 参数透传及 `targetOrigin: '*'` 确权广播,实现宿主与静态底座零配置无缝通信。
|
||||
|
||||
---
|
||||
|
||||
## [2.3.0] - 2026-06-23
|
||||
|
||||
### 🚀 新特性 (New Features)
|
||||
|
||||
Reference in New Issue
Block a user