# 自定义弹窗设置
> 在全景加载完成后直接展示一张自定义弹窗图片，可设置横幅或卡片样式、展示位置与显示平台。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「自定义弹窗设置」。先开启弹窗内容展示并选择支持的平台，再选择弹窗类型与位置，最后上传符合尺寸要求的弹窗素材。点击「保存配置」，重新发布作品后弹窗在全景加载完成后对访问者展示。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启或关闭自定义弹窗，并选择支持的显示平台
- 选择弹窗类型：横幅或卡片
- 按类型选择弹窗位置：顶部／底部或居中
- 上传弹窗素材，并按类型自动校验图片比例
- 弹窗内容会在全景加载完成后直接展示

## 3. 业务说明

### 配置区域

面板分为「基础设置」与「弹窗素材」两个区域。基础设置包含开启开关、显示平台、弹窗类型、弹窗位置；弹窗素材区根据所选类型提示对应的尺寸要求并上传图片。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启弹窗内容展示 | 是否在全景加载完成后展示自定义弹窗 | 开关 | 默认关闭，必填 |
| 显示平台 | 弹窗在哪些平台展示 | 平台选择（全平台／手机网页／电脑网页／微信小程序等） | 默认全平台 |
| 弹窗类型 | 弹窗的样式 | 单选：横幅、卡片 | 默认横幅，必填 |
| 弹窗位置 | 弹窗展示的位置 | 单选：横幅可选顶部／底部，卡片为居中 | 默认顶部，必填 |
| 弹窗素材 | 弹窗中展示的图片 | 图片上传（横幅要求小于 500kb 且比例为 6:1 的长方形；卡片要求小于 500kb 且比例为 1:1 的正方形） | 开启展示时必填 |

### 保存与生效

点击「保存配置」提示「保存成功，场景发布后生效」。开启弹窗展示但未选择素材时，保存按钮不可用。关闭弹窗后保存会一并清空素材。重新发布作品后弹窗对访问者生效。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「自定义弹窗设置」
2. 在「基础设置」中开启弹窗内容展示并选择显示平台
3. 选择弹窗类型与弹窗位置
4. 在「弹窗素材」中上传符合尺寸要求的图片
5. 点击「保存配置」，再回到编辑器发布入口重新发布作品

## 5. 规则与限制

- 横幅素材要求小于 500kb 且宽高比例为 6:1，卡片素材要求小于 500kb 且宽高比例为 1:1
- 切换弹窗类型会清空已选素材与位置，需要重新选择
- 关闭弹窗展示后保存会清空已上传素材

## 6. 状态与异常

- 未选择素材且已开启展示：保存按钮不可用
- 切换类型时自动调整默认位置：卡片默认居中，横幅默认顶部
- 素材比例不符合要求时提示并需重新选择
- 素材宽高比例不合要求，请重新选择

## 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/announcement.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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