# 场景特效
> 为场景叠加下雨、下雪、星星、花瓣等动态粒子特效，并可自定义上传特效元素；默认只作用于当前场景。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：想让场景更有氛围时使用。先在场景列表选中目标场景，进入「场景设置 → 场景特效」，先在选择特效步骤点选一种特效（含「关闭特效」），再进入配置特效步骤调整数值参数与开关，点击「保存配置」写入作品，重新发布后对访问者生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 内置多种粒子特效：下雨、两种下雪、白色星星、金色星星、红色爱心、蓝色泡泡、粉色花瓣
- 预设元素特效：蒲公英、绿叶、枫叶
- 支持自定义上传图片作为特效元素
- 数值参数可调：特效数量、运动速度、元素大小、抖动程度、扩散范围、风向强度
- 功能开关：运动方向（向上/向下）、应用所有场景
- 支持「重置为默认配置」一键还原
- 第一项为「关闭特效」，可移除当前场景已配置的特效

## 3. 业务说明

### 配置区域

面板分两步：第一步「选择特效」，以卡片网格呈现全部特效，选中后卡片显示「已选中/已关闭」，自定义特效会多出「配置」按钮用于上传元素图片；第二步「配置特效」，分为「数值参数」「功能开关」两个区域，底部提供「重置为默认配置」。底部操作栏在选择步骤为「返回/下一步」，在配置步骤为「上一步/保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 特效 | 选择要使用的粒子特效 | 单选卡片：关闭特效 / 下雨特效 / 下雪特效 / 下雪特效2 / 白色星星 / 金色星星 / 红色爱心 / 蓝色泡泡 / 粉色花瓣 / 蒲公英 / 绿叶 / 枫叶 / 自定义 | 默认未选中 |
| 特效数量 | 控制粒子的数量 | 滑杆 100-6000 | 默认 1000 |
| 运动速度 | 控制粒子运动快慢 | 滑杆 -2-10 | 读取当前特效配置，未确认 |
| 元素大小 | 控制粒子显示大小 | 滑杆 0.5-10 | 读取当前特效配置，未确认 |
| 抖动程度 | 控制粒子左右抖动幅度 | 滑杆 1-100 | 读取当前特效配置，未确认 |
| 扩散范围 | 控制粒子横向扩散范围 | 滑杆 -1000-1000 | 读取当前特效配置，未确认 |
| 风向强度 | 控制粒子受风偏移强度 | 滑杆 -100-100 | 读取当前特效配置，未确认 |
| 运动方向 | 开启后元素向上运行，关闭则向下运动 | 开关 | 默认关闭 |
| 应用所有场景 | 开启后特效将应用到项目中的所有场景 | 开关 | 默认关闭 |

### 保存与生效

配置只作用于当前场景，需点击「保存配置」写入作品。开启「应用所有场景」保存时会提示「若其他场景已单独设置过特效，此操作将覆盖之前的设置」，确认后应用到全部场景。重新发布作品后对访问者生效。

## 4. 使用说明

1. 在场景列表选中目标场景
2. 选择「场景特效」配置
3. 在「选择特效」步骤点选一种特效
4. 进入「配置特效」步骤调整参数并在预览确认
5. 保存后重新发布

## 5. 规则与限制

- 默认只作用于当前场景，切换场景后需各自设置
- 开启「应用所有场景」会覆盖其他场景已单独设置的特效，保存前需确认
- 选择「关闭特效」会移除当前场景的特效配置
- 自定义特效可上传图片作为粒子元素

## 6. 状态与异常

- 未选择特效：无法进入下一步，提示「请先选择一个特效」
- 已选中：卡片显示「已选中」，自定义特效显示「配置」入口
- 已关闭：选择第一项「关闭特效」后该场景特效被移除
- 未选择特效就点击下一步：提示「请先选择一个特效」

## 7. 相关文档

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

## 8. 文档信息

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