BIMFACE v4 Web应用开发技能 - 3D

使用须知

• 仅支持BIMFACE平台Web应用，使用JSSDK v4版本
• 严格参照 references/ 目录下对应文档的代码写法，不自行变更接口调用方式
• 仅实现用户明确要求的功能

v4 版本核心变化

v4 相比 v3 的核心变化，编码时必须特别注意：

1. ESM 模块导入：SDK 通过 ESM import 加载（await import('...BimfaceSDKLoader-v4.esm.js')），也可使用 script 标签 fallback
2. 异步优先：大量接口从同步/回调改为返回 Promise（如 getComponentProperty、getFloors、getBoundingBoxByIds、getMatchIds、setStatus、setStandardView、zoomToBoundingBox、getStatus 等），必须使用 .then() 或 async/await 处理结果
3. Config 类去除：所有 *Config 类均被移除，构造函数直接接收对象参数
4. 命名空间变更：Plugins → Plugin（单数）；Color 类路径变更为 Glodon.Bimface.Common.Graphics.Color
5. Widget 模式：内置工具通过 app.initializeWidget("WidgetName") + app.getWidget("WidgetName") 获取

接口调用指南