# 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. 使用说明

1. 上传或拖入一张全景图
2. 等待转换为立方体面并查看切割预览
3. 点击“开始全景漫游”
4. 用鼠标与键盘在 3D 空间中漫游

## 5. 规则与限制

- 全景图比例须约为 2:1（允许少量误差），否则报错
- 支持 JPG、PNG、WebP 格式
- 漫游中会禁用页面滚动，拖动与键盘分别控制视角与移动

## 6. 状态与异常

- 未上传显示上传区
- 转换中显示进度与阶段文案
- 切割完成显示六面预览与开始/重新上传按钮
- 漫游中显示操作提示与返回上传
- 比例不正确时提示应为 2:1
- 读取或处理失败时显示错误信息，可确认后清除

## 7. 相关文档

- [AR 全景漫游演示](https://9kvr.cn/site/tour/fly/ar-demo.md)
- [素材播放](https://9kvr.cn/site/tour/media/play.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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