AR 全景漫游
上传全景图转为立方体空间，在 3D 场景中用鼠标与键盘漫游。
1. 页面信息
- 网页地址：https://9kvr.cn/tour/fly/ar
- 所属模块：全景飞行与 AR
- 页面用途：一个 3D 全景漫游页。你上传一张 2:1 的全景图，页面会把它转换成立方体六个面的贴图并渲染到一个立方体空间中，进入“全景漫游”后可用鼠标拖动旋转视角、键盘移动、空格上升、Shift 下降，实现走进全景画面的沉浸式体验。
- 适用用户：希望把全景图变成可行走 3D 空间的用户
- 访问条件：公开访问
2. 功能说明
- 上传区：点击或拖拽上传全景图，支持 JPG/PNG/WebP，并校验是否为 2:1 比例
- 全景转立方体：处理过程中显示进度与阶段提示
- 切割预览：展示六个立方体面缩略图，可开始漫游或重新上传
- 第一人称漫游：鼠标拖动旋转视角，键盘方向键/WASD 移动，空格上升、Shift 下降
- 支持自动旋转与视角范围等参数调整
- 支持外部直接加载指定全景
3. 业务说明
使用前提
需要一张标准 2:1 比例的等距柱状全景图，页面会把它转换成立方体空间的六个面来渲染。
操作方式
| 操作 | 效果 |
|---|---|
| 鼠标拖动 | 旋转视角（左右、上下） |
| 方向键 / WASD | 前后左右移动 |
| 空格 / Shift | 上升 / 下降 |
4. 使用说明
- 上传或拖入一张全景图
- 等待转换为立方体面并查看切割预览
- 点击“开始全景漫游”
- 用鼠标与键盘在 3D 空间中漫游
5. 规则与限制
- 全景图比例须约为 2:1（允许少量误差），否则报错
- 支持 JPG、PNG、WebP 格式
- 漫游中会禁用页面滚动，拖动与键盘分别控制视角与移动
6. 状态与异常
- 未上传显示上传区
- 转换中显示进度与阶段文案
- 切割完成显示六面预览与开始/重新上传按钮
- 漫游中显示操作提示与返回上传
- 比例不正确时提示应为 2:1
- 读取或处理失败时显示错误信息，可确认后清除
7. 相关文档
8. 文档信息
- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验