# 背景音乐配置
> 为全景作品设置背景音乐，包含音乐文件、循环播放与音量，以及全局语音入口。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「背景音乐配置」。面板分为「背景音乐」和「全局语音」两个标签：在背景音乐中选择音乐文件并设置循环播放与音量，点击「保存配置」，重新发布作品后音频才会对外播放。注意背景音乐能力已整合进语音讲解的全局语音模块。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 选择、更换或删除背景音乐文件
- 在面板内直接试听所选音乐
- 设置循环播放开关与音量大小
- 提供跳转到语音讲解全局语音模块配置的入口

## 3. 业务说明

### 配置区域

面板分为「背景音乐」和「全局语音」两个标签。背景音乐标签包含音乐文件（选择、删除）、音乐播放器（试听）与播放设置（循环播放、音量控制）；全局语音标签为迁移提示，会引导前往语音讲解模块统一管理背景音乐与语音解说。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 选择音乐文件 | 为作品选择背景音乐文件，已选择后按钮变为「重新选择音乐」 | 按钮，从素材库选择音频 | 非必填 |
| 删除音乐 | 移除已选择的背景音乐 | 按钮，需在弹窗中确认 | 非必填 |
| 音乐播放器 | 在面板内试听所选音乐 | 播放器 | 选择音乐后出现 |
| 循环播放 | 音乐播放结束后是否重新播放 | 开关 | 默认开启 |
| 音量控制 | 设置背景音乐的播放音量 | 滑块，取值 1 到 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/basic.md)
- [语音讲解设置](https://9kvr.cn/site/tour/editor/config/basic/voice.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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