3D模型预览器
3D 模型预览器:上传本地模型文件即可在浏览器里在线预览与交互,支持 GLTF/GLB、FBX、OBJ、STL、PLY、3MF 六类格式。
1. 页面信息
- 网页地址:https://9kvr.cn/tour/preview/model
- 所属模块:全景作品与工具
- 页面用途:从「工具箱」进入本页。页面顶部是面包屑导航(首页 / 工具箱 / 3D模型预览),下面是标题「3D模型预览器」与副标题「支持多种格式的3D模型在线预览与交互」,再下面是拖拽上传区:可以把模型文件拖进去,也可以点击上传区选择文件。上传成功后页面切换为全屏模型预览器;关闭后重新回到上传界面。
- 适用用户:想在线查看 3D 模型效果的用户
- 访问条件:公开访问
2. 功能说明
- 面包屑导航:首页 / 工具箱 / 3D模型预览
- 标题「3D模型预览器」,副标题「支持多种格式的3D模型在线预览与交互」
- 拖拽上传区:拖入文件时文案变为「松开鼠标上传模型」,点击则打开文件选择
- 上传区提示支持的格式:GLTF、GLB、FBX、OBJ、STL、PLY
- 格式说明卡片:GLTF/GLB(现代标准格式,支持PBR材质和动画)、FBX(Autodesk格式,支持复杂动画)、OBJ(经典格式,通用性强)、STL(3D打印常用格式)、PLY(点云数据格式)、3MF(微软3D制造格式)
- 文件大小上限 100MB,超限会提示「文件大小超过限制,请选择小于100MB的文件」
- 格式不支持时提示「不支持的文件格式:XXX。支持的格式:GLTF、GLB、FBX、OBJ、STL、PLY」
- 上传成功后提示「模型加载中...文件大小:xx.xxMB」并进入预览
- 「强大功能」区块展示高质量渲染、格式支持等能力说明
- 预览器可关闭,关闭后回到上传界面可再传其它模型
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. 使用说明
- 从工具箱进入 3D 模型预览器
- 把模型文件拖进上传区,或点击上传区从本地选择文件
- 确认提示「模型加载中...文件大小:xx.xxMB」,等待模型出现
- 拖动旋转、缩放查看模型细节
- 想换模型时关闭预览器,回到上传区重新上传
5. 规则与限制
- 文件大小不能超过 100MB
- 仅支持 gltf、glb、fbx、obj、stl、ply、3mf 七种扩展名
- 模型文件在浏览器本地加载,不上传服务器
- 扩展名不在白名单时不会进入预览,直接给出格式不支持提示
- 关闭预览器后会清空当前已选文件
6. 状态与异常
- 待上传:展示上传区、格式提示与格式说明卡片
- 拖拽中:上传区高亮并提示「松开鼠标上传模型」
- 加载中:提示「模型加载中...文件大小:xx.xxMB」
- 已加载:展示可交互的模型预览器
- 校验失败:展示错误提示并停留在上传界面
- 文件超过 100MB:提示「文件大小超过限制,请选择小于100MB的文件」
- 格式不支持:提示「不支持的文件格式:{扩展名}。支持的格式:{列表}」
7. 相关文档
目录导航
- 所属目录索引:/tour/preview
- 上一篇:图片裁切工具
- 下一篇:作品暂不允许访问
同目录文档(14)
- 音视频转换工具
- 全景图立方体转换工具
- 全景飞行模拟器(实验)
- 图片裁切工具
- 作品暂不允许访问
- 全景图转视频工具
- 手机全景转 360°
- 3D 模型预览
- 访问限制
- 全景图EXIF修复工具
- 文本转图片
- 360° 全景图在线预览
- 360°全景视频预览
- 音视频格式转换器(桌面版)
相关主题
8. 文档信息
- 事实来源:芊云全景官网页面核验
- 文档构建时间:2026-10-21 00:05:20
- 数据获取/快照时间:不适用(静态产品知识)
- 可信状态:已核验