SDK 安装与环境要求

安装

npm install iflow-engine

import { BimEngine } from 'iflow-engine';

SDK 构建产物会注入必要样式，通常不需要额外引入 CSS。

容器要求

Viewer 容器必须存在且具备明确宽高：

<div id="viewer" style="width: 100%; height: 100vh;"></div>

不要在 display: none 的容器中初始化。页面切换、弹窗关闭或框架组件卸载时必须调用实例的 destroy()。

浏览器与资源要求

• 使用支持 WebGL 的现代桌面或移动浏览器。
• 3D 模型资源、贴图和服务端接口必须满足浏览器 CORS 与鉴权要求。
• 3D Viewer 部署时确保 Draco 解码资源可访问。
• GIS Viewer 额外要求 /cesium/ 下的 Workers、Assets、ThirdParty、Widgets 静态资源可访问。

最小初始化

const viewer = new BimEngine('viewer', { locale: 'zh-CN', theme: 'dark' });

if (await viewer.initialize()) {
  await viewer.loadModelByViewToken('YOUR_VIEW_TOKEN');
}