接入流程

以下流程描述平台服务与 Viewer SDK 的标准协作方式。应用凭证和 accessToken 仅在业务服务端使用；浏览器只接收用于加载模型的查看令牌或短期 SDK 票据。

创建应用
  -> 获取应用凭证与访问令牌
  -> 上传模型文件
  -> 发起模型转换并等待完成
  -> 获取模型查看令牌
  -> Web 页面初始化 Viewer
  -> 使用查看令牌加载模型
  -> 订阅事件并调用业务 API
  -> 页面卸载时销毁 Viewer

前端最小调用链

页面中先准备一个具有明确宽高的容器：

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

再初始化 3D Viewer 并加载由服务端获取的查看令牌：

import { BimEngine } from 'iflow-engine';

const viewer = new BimEngine('viewer');
const off = viewer.on('engine:model-loading-completed', () => {
  console.log('模型已加载');
});

const ok = await viewer.initialize();

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

// 页面或组件卸载时：
// off();
// viewer.destroy();

页面或框架组件卸载时调用 viewer.destroy()，并取消不再使用的事件订阅。

模型上传、转换、令牌签发属于平台服务操作；构件高亮、测量、剖切和事件监听属于浏览器中的 Viewer SDK 操作。