安装

bash

npm install @modelcubes/viewer-core
npm install @modelcubes/viewer-ui   # 可选,需要即用 UI 组件时

只做渲染集成时,安装 @modelcubes/viewer-core 一个包即可;要用模型树、工具栏等现成组件时再加装 @modelcubes/viewer-ui(它依赖 viewer-core)。

环境要求

现代前端构建工具:@modelcubes/viewer-core 和 @modelcubes/viewer-ui 以 ES Module 分发,并由 viewer-core 使用 Web Worker 解码几何数据。请使用支持 ESM 和 Worker 打包的工具链,例如 Vite、webpack 5、Rollup 或现代应用框架。
Vite 7 及更早版本:dev 模式下需要在 vite.config 中排除 @modelcubes/viewer-core 的依赖预构建,否则 Worker 可能无法加载。Vite 8+ 无需配置。
ts
```
export default {
  optimizeDeps: {
    exclude: ["@modelcubes/viewer-core"],
  },
};
```
类型声明:包内置 .d.ts,TypeScript 项目无需安装 @types/*;JavaScript 项目也可直接使用。
浏览器:运行环境需支持 WebGL2,详见浏览器要求。

模型数据从哪来

FMB Viewer 渲染 .fmbv 二进制模型格式。.fmbv 文件由你的数据供应方提供——通常是从 CATIA、Creo 等原生 CAD 格式离线转换而来,viewer 自身不做格式转换。文档站提供一个小体积示例模型供上手练习(见快速开始);关于 .fmbv 的更多说明,参见概念 › 模型数据。

框架集成

Vue 3 与纯 JavaScript 的完整示例工程与集成要点,见框架集成。

安装 ​

环境要求 ​

模型数据从哪来 ​

框架集成 ​

安装

环境要求

模型数据从哪来

框架集成