# 指南针配置
> 为场景配置指南针的方向显示与动画外观，可自定义图片图层与位置大小，并设置全景主方向。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「指南针配置」。开启配置并选择简易模式或高级模式，设置显示位置与大小、放大倍数与图片图层；再旋转全景确定主方向（北方）并点击「设置完成」。全部设置好后点击「保存配置」，指南针需在全局控制中开启指南针显示才会生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启指南针配置，并在简易模式与高级模式之间切换
- 设置指南针在屏幕上的位置（上/下/左/右/中）与大小
- 设置指南针被点击后的放大倍数
- 简易模式选择一张指南针图片，高级模式使用背景层与两个主体层组合动画
- 旋转全景确定主方向并保存

## 3. 业务说明

### 配置区域

面板由四个区域组成：基础配置（开启配置、简易模式）、位置与大小（位置、指南针大小、放大倍数）、图片配置（按简易或高级模式选择图片）、方向设置（开始设置 / 重新设置、设置完成）。配置按场景各自保存。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启配置 | 是否启用本场景的指南针配置 | 开关 | 默认关闭 |
| 简易模式 | 简易模式只需一张指南针图片；关闭则进入高级多图层模式 | 开关 | 默认开启 |
| 位置 | 指南针在屏幕上的显示位置 | 单选：上 / 下 / 左 / 右 / 中 | 默认居中 |
| 指南针大小 | 指南针图层图片的像素大小，不建议超过 200px | 数字输入 | 默认 150 |
| 放大倍数 | 指南针被点击后的放大或缩小倍数 | 步进器，取值 0.1 到 10 | 默认 2 |
| 指南针图片 | 简易模式下选择的一张 PNG 指南针图片 | 上传，仅支持 PNG | 简易模式使用 |
| 背景图层 | 高级模式下的静态背景层，系统默认为透明图 | 上传，仅支持 PNG | 高级模式使用 |
| 主体层1 | 高级模式下沿指南针方位逆时针旋转的图层 | 上传，仅支持 PNG | 高级模式使用 |
| 主体层2 | 高级模式下沿指南针方位顺时针旋转的图层 | 上传，仅支持 PNG | 高级模式使用 |
| 方向设置 | 旋转全景确定主方向（北方）并保存 | 按钮：开始设置 / 重新设置 / 设置完成 | 未确认 |

### 保存与生效

点击底部「保存配置」，提示「保存成功,场景发布后生效」。指南针配置按场景保存；需在全局控制中开启指南针显示后才会生效。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「指南针配置」
2. 开启「开启配置」，按需切换「简易模式」
3. 在「位置与大小」设置位置、大小与放大倍数
4. 在「图片配置」选择指南针图片；高级模式下分别设置背景图层、主体层1、主体层2
5. 在「方向设置」点击「开始设置」，旋转全景确定北方后点击「设置完成」
6. 点击「保存配置」，并确认已在全局控制中开启指南针显示，再重新发布作品

## 5. 规则与限制

- 需在全局控制中开启指南针显示，本页配置才生效
- 指南针图层图片仅支持 PNG 格式
- 指南针大小默认为 150px，不建议超过 200px，否则移动端显示可能出现异常
- 简易模式只需一张图片；高级模式由背景层、主体层1（逆时针）、主体层2（顺时针）组合成动画

## 6. 状态与异常

- 未设置方向时显示「尚未设置方向」
- 已设置方向后显示「当前方向」并可重新设置
- 正在设置方向时显示「正在设置方向…」与「设置完成」
- 选择了非 PNG 图片：提示「请选择一张 PNG 素材」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [基础设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/basic.md)
- [播放器设置（全局控制）](https://9kvr.cn/site/tour/editor/config/basic/switch.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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