# 3D 物体环视编辑器
> 可视化调整 3D 模型的光源、相机、缩放与位置并保存，供作品播放时使用。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/media/model-edit
- 所属模块：素材与模型
- 页面用途：面向 3D 物体环视（多帧序列图）或 3D 模型场景的可视化编辑页。通过面板实时调整环境光/点光源、相机位置、模型缩放与偏移，配置保存后供作品播放时使用；也支持通过链接参数直接编辑传入的模型。
- 适用用户：需要调整 3D 模型/环视效果的作者
- 访问条件：公开访问

## 2. 功能说明

- 光源设置：背景色、光源类型（环境光/点光源）、光源颜色与点光源位置
- 相机设置：相机位置 X/Y/Z
- 大小设置：模型缩放 X/Y/Z
- 位置设置：模型偏移 X/Y/Z
- 保存配置与“重新配置”
- 环视序列帧：拖动滑杆切换帧（针对序列图类型）
- 背景音乐播放与暂停
- 加载动画与微信小程序分享

## 3. 业务说明

### 两类编辑对象

| 类型 | 编辑内容 |
| --- | --- |
| 3D 模型 | 光源、相机、缩放、偏移与背景音乐 |
| 环视序列帧 | 额外提供滑杆拖动切换帧 |

## 4. 使用说明

1. 进入页面按链接参数加载作品场景配置或外部模型
2. 通过底部按钮切换光源、相机、大小、位置等面板
3. 拖动滑杆实时预览调整效果
4. 点“保存配置”写入；或点“重新配置”按提示重开编辑器

## 5. 规则与限制

- 相机、缩放、偏移等参数均有取值范围
- 缩放值应用时会按比例换算
- 环视序列图与其他模型类型走不同的渲染方式

## 6. 状态与异常

- 加载中显示加载动画
- 无模型时按类型分支初始化
- 点“重新配置”时提示关闭编辑器后重新打开
- 加载失败沿用外层错误处理

## 7. 相关文档

- [移动端发布全景素材](https://9kvr.cn/site/tour/media/mobile-material.md)
- [发布模型素材](https://9kvr.cn/site/tour/send/send-model-media.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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