Glendale Engine
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e9700196/glendale-engine。
技能介绍
要解决什么
在页面里落地一个三维引擎,并不等于把脚本标签塞进 HTML。引擎脚本、wasm、HDR 天空盒和模型文件都托管在 v.glendale.top,而这台服务器没有返回任何 CORS 响应头,浏览器跨域加载 JS / wasm / HDR 会被直接拦下;引擎只认 http 地址的模型路径,磁盘上的 root.glt 传进去不生效;BIM 模型漏填轻量化 token 时,模型照常渲染但相机被锁死,左键旋转、滚轮缩放、右键平移全部失效,看起来像“加载成功”却点不动场景。这个技能把这些边角情况写成一条固定的落地路径。
技能如何工作
引擎使用在线 UMD 包,<script> 引入后挂载到全局 GlendaleEngine,技能包本体只有约 20KB,不含本地引擎副本。配套的 scripts/proxy_server.py 把 /static/* 转发到远端并补齐 CORS 头,浏览器看到的是同源请求;同时 /local/* 把本地文件以 http URL 形式交给引擎,自动识别 Windows 盘符、支持 Range 分段加载和 3D 模型 MIME 类型。
初始化时有三处必须踩准:sitePath 设为 /static/,让引擎从代理侧取 worker 与第三方库;使用 HDR 天空盒要设 mappingMode: 3 且保留 .hdrc 后缀;加载 BIM 模型必须传 secretKey,这是模型轻量化授权 token。GlendaleEngine(options) 返回 Promise,resolve 出的 api 对象按模块组织——api.Model 管加载、剖切、爆炸、楼层弹出与骨骼动画,api.Camera 管视角定位与截图,api.Feature 管构件拾取与着色,另有 Label、Measurement、Effect、Edit、Cad、Plugin、Public 覆盖标签、测量、特效、CAD 图纸与导航小地图等能力。模型入口按格式选择:3D Tiles / GLT 走 Model.add,GLB 与 FBX 走 Model.addGlb。assets/template/ 下提供了一份可直接运行的 HTML 与 main.js 模板。
适用边界
- 倾斜摄影(tileset.json / OSGB)是整片模型,没有构件 ID,不能用
Feature.getByEvent拾取构件,剖切能力也只对 BIM 生效。 - GIS 场景需
openEarth: true,此时坐标系切换为经纬度加高程,相机行为与普通场景不同,部分功能受限。 - 同一个场景内模型 tag 必须唯一,加载多个模型时需命名区分;构件 id 通常是
tag^featureId,拼接字符串时注意分隔符。 - 模型加载要走 callback 或
readyPromise,不要在Model.add之后立即执行依赖模型就绪的操作,所有返回值的方法都是 async。 - 页面必须通过 http/https 访问,
file://会触发模块的跨域限制。 - 在线 UMD 引擎用全局变量,本地
glendale.v1.js用 ES Module 默认导出,两种导入语法不能混用。
使用场景
- 在 Web 项目中集成三维引擎,初始化场景并加载显示模型。
- 加载 BIM 模型后,实现构件拾取与着色,查询构件属性。
- 加载倾斜摄影 tileset.json 后进行整体定位、视角切换与截图。
- GIS 场景开启 openEarth 后展示三维地形与模型。
适合人员
- 前端工程师,要把三维引擎集成到现有 Web 项目并渲染模型。
- WebGL 工程师,想加载 BIM 模型并实现构件拾取与交互操作。
- BIM 工程师,需要在线浏览模型并查看构件属性。
- GIS 工程师,需要集成三维模型并与地理场景叠加展示。