沙盒空间查看器
沙盒空间查看器：按作品标识加载房间布局，在三维场景中以第一人称拖动查看，走到门洞自动切换到相邻房间。
1. 页面信息
- 网页地址：https://9kvr.cn/tour/viewer/SandboxViewer
- 所属模块：全景查看器
- 页面用途：通过带作品标识的链接进入本页，页面读取该作品的沙盒配置（房间与建模数据）并渲染成三维场景。初始视角落在第一个房间、接近人眼高度，底部提示「拖动查看，点击移动」。拖动可环视，走到门洞时会自动进入相邻房间并提示房间名。
- 适用用户：查看沙盒 / 立体空间作品布局的用户
- 访问条件：公开访问
2. 功能说明
- 三维场景渲染房间布局
- 第一人称拖动查看：可旋转视角，禁用平移与缩放以保持沉浸感
- 加载作品的房间数据，并把每个房间的建模数据做归一化处理
- 初始位置落在第一个房间，视角高度接近人眼
- 走到门洞时自动切换到相邻房间，并提示进入的房间
- 窗口大小变化时自动适配画布
- 加载时显示「正在加载全景空间...」遮罩，加载完成后显示操作提示
3. 业务说明
界面结构
| 元素 | 取值 / 行为 |
|---|---|
| 三维画布 | 铺满一屏高度，黑色背景 |
| 加载遮罩 | 「正在加载全景空间...」，带加载动画 |
| 操作提示条 | 「拖动查看，点击移动」，位于底部居中 |
| 房间切换提示 | 进入房间时提示房间名称 |
| 加载结果提示 | 成功时提示已加载的房间数量 |
视角限制
查看器刻意关闭了平移与缩放，只保留旋转。目的是让浏览方式接近"站在房间里转头看"，而不是像地图那样拉远拉近。拖动方向被反转，以模拟转头的感觉。
房间之间怎么连
页面持续检测当前所在位置，如果落在某个门洞（传送点）范围内，就自动切换到相邻房间并更新当前房间标识。房间数据会先做一次建模数据归一化，保证不同来源的房间能被一致地渲染。
4. 使用说明
- 以带作品标识的方式进入本页
- 等待房间数据加载，遮罩显示「正在加载全景空间...」
- 在三维场景中拖动环视，了解房间布局
- 走到门洞处，自动进入相邻房间
- 窗口尺寸变化时画布自动适配
5. 规则与限制
- 未提供作品标识时提示未指定并停止加载
- 房间数据需完整有效才会被渲染
- 禁止平移与缩放，仅支持旋转视角
- 初始视角固定在第一个房间，人眼高度附近
- 未指定作品标识时不发起房间数据请求
6. 状态与异常
- 加载中：黑色遮罩展示「正在加载全景空间...」
- 就绪：显示「拖动查看，点击移动」提示条，可环视
- 已加载：提示已加载的房间数量
- 未指定作品标识时提示错误并结束加载
- 加载布局失败时提示加载失败
7. 相关文档
目录导航
- 所属目录索引：/tour/viewer
相关主题
8. 文档信息
- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-21 00:05:20
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验