# 房产沙盘配置
> 为作品添加房产沙盘，支持图片沙盘与地图沙盘两种模式，把各场景点位呈现在一张沙盘/地图上，提供直观的空间导航。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「视角设置」中打开房产沙盘配置。先开启「开启沙盘显示」并选择「图片沙盘」或「地图沙盘」；再到「沙盘」「场景」「背景图」「方位」「重置」标签页里分别完成名称、显示、背景图、点位与方位校准。设置完成后点击「保存配置」。注意沙盘的地图模式不能与地图 VR 同时开启。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启/关闭沙盘显示，并选择图片沙盘或地图沙盘
- 配置沙盘模块名称、默认展开、单独显示
- 上传沙盘背景图（图片沙盘）
- 为沙盘入口、选中/未选中点位自定义图标
- 管理各场景在沙盘上的显示开关与点位
- 校准场景正北方向，并支持重置点位或清空沙盘配置

## 3. 业务说明

### 配置区域

面板依次为「基础设置」（开启沙盘显示、沙盘类型）、「平台适配」，以及根据沙盘类型展开的「图片沙盘配置」或「地图沙盘配置」；下方为「沙盘」「场景」「背景图」「方位」「重置」五个标签页。底部为「关闭配置」「保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启沙盘显示 | 是否在作品中启用沙盘 | 开关 | 默认关闭 |
| 沙盘类型 | 选择沙盘模式；地图沙盘与地图 VR 不能同时开启 | 单选：图片沙盘 / 地图沙盘 | 默认图片沙盘 |
| 显示名称 | 沙盘模块的名称 | 输入框，最多 4 个字 | 默认「沙盘」 |
| 默认展开 | 进入作品时是否默认展开沙盘 | 开关 | 默认关闭 |
| 单独显示 | 开启后沙盘内只显示当前打开的场景图标 | 开关 | 默认关闭 |
| 入口预览图 | 房产皮肤收起时的沙盘入口图标，建议使用透明 PNG；未配置时显示默认立体户型图 | 图片，选择图片/恢复默认 | 默认未配置 |
| 选中图标 | 沙盘选中全景的自定义图标，要求 PNG 格式、60×60px | 图片，选择图标/恢复默认 | 有系统默认图标 |
| 未选中图标 | 沙盘未选中全景的自定义图标，要求 PNG 格式、60×60px | 图片，选择图标/恢复默认 | 有系统默认图标 |
| 开始上传背景 | 上传沙盘背景图，要求正方形、支持透明 PNG（仅图片沙盘） | 按钮 | 图片沙盘时必上传 |
| 场景显示开关 | 关闭后该场景不显示在沙盘上 | 开关，逐场景 | 默认显示 |
| 设置正北方向 / 重新设置 | 为当前素材校准正北角度，单次只能设置一个场景 | 按钮 | — |
| 查看正北视角 | 查看已设置的正北方向视角 | 按钮 | 设置过正北后出现 |
| 重置点位 | 重置沙盘上的热点数据，需重新设置点位 | 按钮 | — |
| 清空沙盘配置 | 清空整套沙盘配置，需确认 | 按钮 | — |

### 保存与生效

点击「保存配置」写入配置；图片沙盘未上传背景图时无法保存，会提示「请上传导览区域背景图片」。方位校准与点位调整只作用于当前场景；保存后需重新发布作品，访问者才能看到沙盘。

## 4. 使用说明

1. 在编辑器左侧点击「视角设置」，打开房产沙盘配置
2. 开启「开启沙盘显示」，选择沙盘类型并完成平台适配
3. 在「沙盘」标签填写显示名称、默认展开、单独显示，并配置入口与点位图标
4. 图片沙盘在「背景图」标签上传背景图；地图沙盘在地图里布局点位
5. 在「场景」标签逐场景开关显示，在「方位」标签校准正北方向
6. 点击「保存配置」，再回到编辑器发布入口重新发布作品

## 5. 规则与限制

- 沙盘的地图类型和地图 VR 不能同时开启
- 图片沙盘必须上传背景图才能保存
- 入口预览图建议使用透明 PNG；点位图标要求 PNG 格式、60×60px
- 方位校准单次只能设置一个场景，设置多个需切换素材后重新设置
- 已开启的场景若切换了沙盘类型，需要手动关闭再打开一次才能初始化到对应区域

## 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
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验