# 行走漫游
> 为场景生成并发布空间模型，让访问者可以在场景内行走漫游，并可设置地面点样式和漫游路线。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当作品需要第一人称行走体验时使用。先在场景列表选中相关场景，进入「场景设置 → 行走漫游」，在「模型生成」标签批量生成并发布空间模型，在「场景漫游」标签确认总开关状态并调整地面点样式，在「漫游路线」标签建立场景之间的行走路线。行走漫游总开关位于「播放器设置 → 高级功能」，本页只展示状态并引导前往开启。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 按场景生成空间模型，只有通过质量门禁的场景才启用空间转场，未通过的继续使用普通全景路线
- 素材列表展示每个场景的模型状态（制作中/可发布/失败降级）、版本、资源与行走能力
- 支持批量生成、刷新、对齐、发布与重新发布模型
- 展示作品级对齐状态：进度、失败原因与参与场景数
- 场景漫游标签展示总开关状态、漫游状态与就绪门禁
- 地面点样式设置：点样式、颜色、大小、透明度、悬停效果、显示场景名称
- 漫游路线标签可基于两张有效全景建立场景间的平滑切换路线

## 3. 业务说明

### 配置区域

面板顶部为三个标签：「模型生成」「场景漫游」「漫游路线」。模型生成标签包含功能说明、总闸与重新发布提示、进度统计、对齐状态和素材列表；场景漫游标签包含行走漫游总开关、漫游状态和地面点样式；漫游路线标签内嵌路线编辑器。底部按钮随标签切换为「批量生成/刷新/对齐/发布」「保存配置」「保存路线」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 搜索素材 | 按文件名筛选素材列表 | 输入框 | 非必填 |
| 点样式 | 设置漫游地面点的形状 | 单选：圆点 | 默认圆点 |
| 颜色 | 设置地面点颜色 | 取色器 | 默认紫色（实际取值未确认） |
| 大小 | 设置地面点大小档位 | 单选：小 / 中 / 大 | 默认中 |
| 透明度 | 设置地面点透明度 | 滑杆 0-100 | 默认 80 |
| 悬停效果 | 设置地面点是否开启悬停效果 | 开关 | 默认开启 |
| 显示场景名称 | 设置地面点是否显示场景名称 | 开关 | 默认开启 |
| 行走漫游总开关 | 控制播放端是否进入行走模式 | 状态展示（在「播放器设置 → 高级功能」管理） | 本页只读，不在本页设置 |

### 保存与生效

模型生成标签的批量生成、对齐、发布直接作用于作品的行走模型；发布只上传行走模型相关数据，不改变已发布的全景内容。场景漫游标签的地面点样式点击「保存配置」后随作品配置保存，重新发布后在播放端生效。漫游路线点击「保存路线」后生效。总闸关闭时，发布也不会在线上进入行走模式，需先在「播放器设置 → 高级功能」开启。

## 4. 使用说明

1. 在场景列表选中目标场景
2. 选择「行走漫游」配置
3. 在「模型生成」标签生成并发布空间模型
4. 在「场景漫游」标签确认总开关并调整地面点样式
5. 在「漫游路线」标签建立场景之间的路线
6. 保存后重新发布

## 5. 规则与限制

- 只有通过质量门禁的场景才启用空间转场，其余场景继续使用普通全景路线
- 行走漫游总开关位于「播放器设置 → 高级功能」，本页不能直接开启
- 总闸关闭时，即使发布了模型，播放时也不会进入行走模式
- 模型在发布之后被重新生成过，需要重新发布才会生效
- 未就绪场景不会阻塞已就绪场景，但会如实列出未参与漫游的场景

## 6. 状态与异常

- 制作中：模型正在生成，可刷新查看进度
- 可发布：模型已就绪，可发布；含降级可用的场景会单独标注
- 失败降级：可查看失败原因并重试
- 未对齐：需要先完成空间对齐才能继续
- 模型生成失败：可在素材卡片查看原因并重试
- 未就绪或未对齐时：发布按钮不可用

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [场景设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/scene.md)
- [辅助标尺](https://9kvr.cn/site/tour/editor/config/scene/auxiliaryTool.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验