房产沙盘配置

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

1. 页面信息

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

2. 功能说明

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

3. 业务说明

配置区域

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

字段说明

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

保存与生效

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

4. 使用说明

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

5. 规则与限制

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

6. 状态与异常

关闭「开启沙盘显示」时沙盘不对外展示
地图沙盘模式下「背景图」标签提示「当前模式暂不支持上传背景图~」
方位未设置时「正北角度」显示「暂未设置」
未上传背景图：保存时提示「请上传导览区域背景图片」
背景图非正方形或不符合要求：提示图片宽高不符合要求
自定义图标尺寸不符：提示「图片宽高不符合要求」

7. 相关文档

8. 文档信息

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