# 沙盒空间查看器
> 按作品标识浏览沙盒作品的房间布局，可拖动查看并穿过门洞切换房间。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/viewer/SandboxViewer
- 所属模块：全景查看器
- 页面用途：通过作品标识加载某个作品的沙盒配置（房间与建模数据），在 3D 场景中渲染房间布局，以第一人称视角拖动查看，走到门洞时会自动切换到相邻房间。是立体空间/室内全景的探索式查看器。
- 适用用户：查看沙盒/立体空间作品布局的用户
- 访问条件：公开访问

## 2. 功能说明

- 3D 场景渲染房间布局
- 第一人称拖动查看（禁用平移与缩放，仅旋转视角）
- 加载作品的房间数据并按房间标准建模数据归一化
- 初始位置落在第一个房间，视角为接近人眼的高度
- 走到门洞时自动切换到相邻房间并给出提示
- 窗口大小变化时自适应画布

## 3. 业务说明

### 使用场景

用于探索式查看由多个房间组成的立体空间作品，用户像走房间一样穿过门洞在相邻房间之间移动。

## 4. 使用说明

1. 以带作品标识的方式进入本页
2. 页面加载房间数据并渲染布局
3. 拖动查看房间，走到门洞切换到相邻房间

## 5. 规则与限制

- 未提供作品标识时提示未指定并停止加载
- 房间数据需完整有效才会加载

## 6. 状态与异常

- 加载中显示“正在加载全景空间...”遮罩
- 加载完成显示“拖动查看，点击移动”提示
- 未指定作品标识时提示错误
- 加载布局失败时提示加载失败

## 7. 相关文档

- [芊云编辑器](https://9kvr.cn/site/tour/editor/index.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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