# 3D 模型在线预览
> 在线预览 3D 模型文件的工具页，支持 GLTF/GLB/FBX/OBJ/STL/PLY/3MF 等格式，可从工具箱入口进入。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/preview/model
- 所属模块：全景工具箱与预览
- 页面用途：把本地 3D 模型文件拖拽或点击上传后即可在线查看并交互。模型在浏览器本地加载，不上传服务器；支持拖拽旋转、滚轮缩放。为获得最佳体验推荐使用 GLTF/GLB 格式。
- 适用用户：需要在线查看 3D 模型的用户
- 访问条件：公开访问

## 2. 功能说明

- 拖拽或点击上传 3D 模型文件
- 支持 GLTF、GLB、FBX、OBJ、STL、PLY、3MF 等格式
- 上传前校验文件大小与格式
- 在线查看：拖拽旋转、滚轮缩放、关闭预览
- 模型在浏览器本地加载（本地对象 URL），不上传服务器

## 3. 业务说明

### 适用场景

无需安装软件，把 3D 模型拖入页面即可在线查看与交互，适合快速检查模型或给他人预览模型效果。

### 本地预览

模型在浏览器本地加载（通过本地对象 URL），文件不会上传到服务器，关闭预览后释放本地地址。

### 格式与大小

支持 GLTF/GLB/FBX/OBJ/STL/PLY/3MF 等格式，推荐 GLTF/GLB 以获得最佳体验；单文件不超过 100MB。

## 4. 使用说明

1. 从全景工具箱进入本页
2. 拖拽或点击上传 3D 模型文件
3. 模型加载完成后拖拽旋转、滚轮缩放查看
4. 关闭预览回到上传界面

## 5. 规则与限制

- 支持格式：GLTF、GLB、FBX、OBJ、STL、PLY、3MF
- 单文件不超过 100MB
- 模型在浏览器本地加载，不上传服务器
- 待产品确认：页面宣传文案（如兼容性 95%、60FPS、平均加载 3 秒）为营销表述，非实测指标
- 待产品确认：底层实际支持的 3MF 未出现在页面展示的格式列表中，是否正式支持待产品确认

## 6. 状态与异常

- 未上传：展示上传区、格式说明与功能特性
- 已加载：展示 3D 模型查看器
- 文件超过 100MB 时提示“文件大小超过限制，请选择小于100MB的文件”
- 格式不支持时提示支持的格式列表

## 7. 相关文档

- [全景工具箱](https://9kvr.cn/site/tour/workbench/box.md)
- [发布 3D 模型](https://9kvr.cn/site/tour/send/send-model.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验