升级 SGS Map SDK 至 2.5.0
Some checks failed
CI / verify (push) Has been cancelled

This commit is contained in:
lyf
2026-07-16 09:43:52 +08:00
parent 6db0b71562
commit 72885b7f54
23 changed files with 1274 additions and 61 deletions

View File

@@ -1,8 +1,10 @@
# SGS Map SDK 交付包
> **版本**V2.4.0
> **本项目同步版本**V2.5.0
> **定位**:深圳自然博物馆统一三维高精地图导航服务平台 H5 SDK
> 发布源的 README 标题仍保留 V2.4.0CHANGELOG 最高仍为 2.4.1;本项目以 `package.json`、`dist` 产物自报版本、SHA-256 和 2.5 Engine 迁移报告为发布依据,不把这份旧标题视为 2.5.0 验证记录。
欢迎接入 SGS Map SDK本 SDK 将复杂的 WebGL 三维渲染、GLB 模型管线与 NavMesh 物理寻路引擎封装在服务端基座中业务端H5 / 大屏 / 小程序)只需通过几行代码即可极速唤起 3D 地图。
## 📁 目录结构
@@ -35,11 +37,11 @@ sgs-map-sdk-release/
1. **`sdkUrl`(渲染基座地址)**
- 释义:独立渲染基座的 URL 路径SDK 会自动在您的页面中创建一个不可见的 iframe 或 Web-View 连接到这里。
- **请联系地图管理平台管理员获取最新的正式/测试域名**,例如:`https://map.museum.com/h5-sdk`
- **请联系地图管理平台管理员获取最新的正式/测试域名**,例如:`https://map.museum.com/engine/index.html`
2. **`targetOrigin`(安全通信域)**
- 释义:这是指**地图渲染基座的来源域名**(即 `sdkUrl` 的 Origin。为了安全SDK 只接收来自该域名 iframe 的消息。
- 配置要求:请传入您的地图基座部署域名,例如:`https://map.museum.com`。如果不传SDK 会自动从 `sdkUrl` 参数推导。注意:**不要**填成业务页面的域名(业务页面的域名是交给 h5-sdk 做白名单校验的)
- 配置要求:请传入独立 SDK Engine 的部署域名,例如:`https://map.museum.com`。如果不传SDK 会自动从 `sdkUrl` 参数推导。注意:**不要**填成业务页面的域名。
## 📦 独立渲染基座部署与版本关系