# 实景导航配置
> 为作品添加地图导航与路线规划，包含地图模块、场景位置和视频导航线路配置，用于提升浏览体验。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「视角设置」中打开实景导航配置。面板内含「地图设置」「场景设置」「导览配置」三个标签：地图设置负责开关与参数，场景设置负责各场景坐标，导览配置用于创建视频导航线路。当前该功能处于内部测试阶段，实际可用范围以编辑器内的提示为准。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 配置地图模块的显示、卫星地图、缩放聚合等参数
- 为各场景定位坐标并显示在地图上
- 创建基于视频的导航线路，配置起始/终止场景、节点标记与持续时长

## 3. 业务说明

### 配置区域

面板顶部说明「实景导航功能可为您的全景作品添加地图导航和路线规划，提升用户的浏览体验, 目前正在内部测试中,暂不支持配置和使用!」。标签页为「地图设置」「场景设置」「导览配置」。底部为「关闭页面」「保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启显示 | 是否在地图上展示导航点位 | 开关 | 默认关闭 |
| 卫星地图 | 显示卫星地图状态 | 只读：已开启 / 已关闭 | — |
| 地图等级 | 当前地图缩放级别 | 只读展示 | 默认 12 |
| 地图中心 | 当前地图中心坐标 | 只读展示 | 有系统默认中心 |
| 缩放聚合 | 开启后相近点位自动聚合显示 | 开关 | 默认关闭 |
| 聚合间距 | 调整聚合判定的间距 | 滑块，1 到 200 | 默认 40 |
| 起始场景 | 导航线路的起点场景 | 选择器，必选 | 必填 |
| 终止场景 | 导航线路的终点场景 | 选择器，必选 | 必填 |
| 视频类型 | 导航视频的来源方式 | 单选：上传视频 / 视频截取（暂不可用） | 默认上传视频 |
| 导航视频 | 导航线路使用的视频文件 | 上传视频 | 必填 |
| 前方视角 | 把当前视角设为视频播放的正前方 | 按钮：设置当前视角为正前方 | 必填 |
| 节点标记 | 在视频时间点上关联到某个场景的标记 | 选择场景并添加标记 | 必填 |
| 持续时长 | 用来计算视频导航的播放速度，建议设置为实际播放时长 | 数字，1 到 300 | 默认 20 |
| 关闭配置/保存配置 | 关闭或保存当前配置 | 按钮 | — |

### 保存与生效

点击「保存配置」提示「保存成功」并写入配置；重新发布作品后对访问者生效。保存时若已开启地图显示的场景未取到坐标，会提示「地图位置信息获取失败, 请重新开启地图显示后再试」。导览线路需先上传视频并添加节点标记才能创建。

## 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/view.md)
- [地图 VR 配置](https://9kvr.cn/site/tour/editor/config/view/mapVr.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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