3D模型预览器

3D 模型预览器:上传本地模型文件即可在浏览器里在线预览与交互,支持 GLTF/GLB、FBX、OBJ、STL、PLY、3MF 六类格式。

1. 页面信息

2. 功能说明

3. 业务说明

界面结构

控件 / 入口 类型 取值来源 限制 / 说明
拖拽或点击上传3D模型 上传区 用户选择的本地模型文件 拖拽时文案变为「松开鼠标上传模型」;点击打开文件选择
支持 GLTF、GLB、FBX、OBJ、STL、PLY 等格式 格式提示 固定文案 实际可上传格式还包含 3MF
GLTF/GLB · FBX · OBJ · STL · PLY · 3MF 格式说明卡片 固定文案 每张卡片含格式名与一句话说明
文件大小校验 校验 用户选择的文件 上限 100MB,超限提示「文件大小超过限制,请选择小于100MB的文件」
扩展名校验 校验 文件扩展名 不在白名单内时提示「不支持的文件格式:XXX。支持的格式:...」
模型预览器 三维视图 上传的模型文件 按扩展名选择对应的模型加载方式,加载完成后可交互查看
关闭预览 预览器操作 固定行为 关闭后回到上传界面并清空已选文件
加载提示 消息提示 当前文件大小 上传成功后提示「模型加载中...文件大小:xx.xxMB」

支持的格式

可上传的扩展名为 gltf、glb、fbx、obj、stl、ply、3mf;页面格式提示文字列出 GLTF、GLB、FBX、OBJ、STL、PLY 六种,格式说明卡片额外介绍了 3MF(微软3D制造格式)。GLB 与 GLTF 走同一套加载方式。

处理流程

选择文件后先校验大小与扩展名,通过后创建本地预览地址并提示加载信息,随后进入模型预览器。整个过程在浏览器本地完成,模型文件不会被上传到服务器。

4. 使用说明

  1. 从工具箱进入 3D 模型预览器
  2. 把模型文件拖进上传区,或点击上传区从本地选择文件
  3. 确认提示「模型加载中...文件大小:xx.xxMB」,等待模型出现
  4. 拖动旋转、缩放查看模型细节
  5. 想换模型时关闭预览器,回到上传区重新上传

5. 规则与限制

6. 状态与异常

7. 相关文档

目录导航

同目录文档(14)

相关主题

8. 文档信息