# 场景封面设置
> 在场景加载前显示自定义封面，包含移动端与 PC 端背景图、背景颜色、模糊与平铺效果以及封面视频。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「场景封面设置」。面板分为「普通封面」和「插件封面」：普通封面用于设置加载前的显示画面，兼容移动端与 PC 端；插件封面用于接入第三方封面插件。设置完成后点击「保存数据」，重新发布作品后生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启场景封面，使访问者在场景加载前看到自定义画面
- 分别设置移动端与 PC 端背景图
- 设置背景颜色、背景模糊值与是否平铺
- 为封面配置视频，并设置自动进入或点击进入
- 接入封面插件，扩展封面玩法

## 3. 业务说明

### 配置区域

面板顶部为「普通封面 / 插件封面」标签。普通封面包含基础设置（开启场景封面、平台配置）、颜色设置（背景颜色）、移动端封面、PC 端封面、显示效果（背景模糊值、是否平铺）、视频配置（视频文件、打开方式设置、自动打开时间）。插件封面包含封面插件选择、当前使用插件与插件配置。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启场景封面 | 启用后将在场景加载前显示自定义封面 | 开关 | 默认开启 |
| 背景颜色 | 背景图高度不足时用来填充背景 | 颜色选择 | 默认 #614FFA |
| 移动端背景图 | 移动端的封面背景图 | 上传，要求 9:16、不超过 500kb | 开启封面时必选 |
| PC端背景图 | PC 端的封面背景图 | 上传，要求 1:1、不超过 500kb，不传不显示 | 非必填 |
| 背景模糊值 | 对背景图进行模糊显示，提高显示效果 | 步进器，取值不小于 0 | 默认 0 |
| 是否平铺 | 控制背景图的展现方式 | 单选：平铺 / 不平铺 | 默认不平铺 |
| 视频文件 | 封面上方先播放的视频 | 上传，默认静音自动播放 | 非必填 |
| 打开方式设置 | 封面视频的进入方式 | 单选：自动进入 / 点击进入 | 默认自动进入 |
| 自动打开时间 | 自动进入时封面视频的展示时长 | 步进器，选择自动进入后出现 | 默认 3 |
| 封面插件 | 接入一个第三方封面插件 | 插件选择弹窗 | 非必填 |

### 保存与生效

点击底部「保存数据」，提示「保存成功,场景发布后生效」。开启场景封面后，移动端背景图必须选择；普通封面关闭且移除所有媒体后可清空配置。封面内容在重新发布作品后对访问者生效。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「场景封面设置」
2. 在「普通封面」开启「开启场景封面」，选择支持的平台
3. 上传移动端背景图（必选）与 PC 端背景图（可选），设置背景颜色
4. 按需设置背景模糊值与是否平铺
5. 如需封面视频，选择视频文件并设置打开方式与自动打开时间
6. 如需使用插件封面，切换到「插件封面」标签选择插件并配置
7. 点击「保存数据」，再回到编辑器发布入口重新发布作品

## 5. 规则与限制

- 开启场景封面后，移动端背景图片必须选择
- 移动端背景图要求宽高为 9:16、大小不超过 500kb
- PC 端背景图要求宽高为 1:1、大小不超过 500kb，不传则不显示
- 封面视频默认静音自动播放
- 封面位只允许使用一个插件，切换插件会替换当前插件

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

## 8. 文档信息

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