全景 AR 漫游

全景 AR 漫游页：上传一张 2:1 全景图，页面把它切成六个面铺成立方体空间，进入第一人称漫游（拖动旋转、WASD 移动、空格上升、Shift 下降）。

1. 页面信息

• 网页地址：https://9kvr.cn/tour/fly/ar
• 所属模块：全景作品与工具
• 页面用途：打开本页先看到上传区：虚线上传框写着「点击或拖拽上传全景图」与「支持 JPG、PNG、WebP 格式，建议 2:1 比例」，可以直接点击选择文件，也可以把图片拖进上传框。文件通过校验后页面开始处理并展示进度；处理完成后出现「切割预览」，列出生成的六个立方体面缩略图，并提供「开始全景漫游」与「重新上传」两个按钮。进入漫游后画面全屏，底部给出操作提示，左下角有「返回上传」按钮。
• 适用用户：想把全景图放进立方体空间里漫游体验的用户
• 访问条件：公开访问

2. 功能说明

• 上传区：支持点击选择文件与拖拽文件两种方式
• 格式与体积校验：仅接受 JPG、PNG、WebP，文件不能超过 100MB
• 比例校验：必须是 2:1，否则提示「全景图比例不正确 (x.xx:1)，应该是 2:1 的比例」
• 尺寸校验：过小时提示「全景图尺寸过小，建议最小 2048x1024 像素」
• 处理进度文案：正在分析全景图... → 正在应用全景引擎算法... → 正在生成立方体面... → 即将完成...
• 「切割预览」展示生成的各个立方体面缩略图与名称
• 「开始全景漫游」进入第一人称视角，「重新上传」回到上传状态
• 漫游操作提示：拖动鼠标旋转视角；WASD/方向键移动 | 空格上升 | Shift下降
• 漫游中左下角「返回上传」按钮可退回重新换图

3. 业务说明

界面结构

文件校验规则

必须选择图片文件，否则提示「请上传图片文件」或「请选择图片文件」；文件大小不能超过 100MB，超出提示「图片文件不能超过 100MB」；宽高比必须是 2:1，否则提示「全景图比例不正确 (x.xx:1)，应该是 2:1 的比例」；尺寸过小时提示「全景图尺寸过小，建议最小 2048x1024 像素」；文件无法读取时提示「无法读取图片文件」或「读取文件失败」。

处理过程

校验通过后页面在本地完成全景图切面：先「正在分析全景图...」，再「正在应用全景引擎算法...」，接着「正在生成立方体面...」，最后「即将完成...」。完成后提示「全景图切割完成，生成 N 个面」，并展示切割预览。

漫游体验

点击「开始全景漫游」后进入立方体空间的第一人称视角：默认相机视场角 75 度，可拖动鼠标旋转视角，用 WASD 或方向键移动，空格上升、Shift 下降，视角旋转与移动都有平滑过渡。

4. 使用说明

1. 打开本页，点击上传区选择一张全景图，或直接把图片拖进上传框
2. 等待校验与处理完成，观察进度条从「正在分析全景图...」走到「即将完成...」
3. 在「切割预览」中确认各个立方体面生成正确
4. 点击「开始全景漫游」进入第一人称空间
5. 拖动鼠标旋转视角，用 WASD/方向键移动，空格上升、Shift 下降
6. 想换一张图时点左下角「返回上传」或处理后的「重新上传」

5. 规则与限制

• 仅支持 JPG、PNG、WebP 三种图片格式
• 图片文件不能超过 100MB
• 图片宽高比必须是 2:1
• 建议图片尺寸不小于 2048x1024 像素
• 处理过程在本地完成，图片不会上传到服务器
• 上传区与漫游画面互斥显示，未开始漫游前只显示上传区

6. 状态与异常

• 待上传：显示上传区与格式说明
• 处理中：显示阶段文案与进度百分比
• 切割完成：显示「切割预览」与两个操作按钮
• 漫游中：显示三维空间、操作提示与「返回上传」按钮
• 出错：显示带感叹号的错误提示条与「确定」按钮
• 未选择文件：提示「请上传图片文件」或「请选择图片文件」
• 文件超限：提示「图片文件不能超过 100MB」
• 比例不符：提示「全景图比例不正确 (x.xx:1)，应该是 2:1 的比例」
• 尺寸过小：提示「全景图尺寸过小，建议最小 2048x1024 像素」
• 处理异常：提示「处理全景图时发生错误」
• 工具初始化失败：提示「全景切割工具初始化失败，请刷新页面重试」

7. 相关文档

目录导航

• 所属目录索引：/tour/fly
• 下一篇：AR 全景漫游演示

同目录文档（1）

• AR 全景漫游演示

相关主题

• 手机全景转 360°
• 全景拍摄教程

8. 文档信息

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