游戏引擎 / 系统课时
处理浏览器音频解锁和静音
处理浏览器音频解锁和静音
游戏首次打开时,即使音频资源已加载完成,浏览器仍可能阻止音乐自动播放。本课使用 Phaser 4.2.1 实现首次交互后启动音乐、全局静音切换与失焦暂停,并验证切换标签页后声音能否正确恢复,同时保留玩家的静音选择。
学习目标
- 区分浏览器音频锁定、全局静音和标签页失焦暂停三种状态。
- 使用 Phaser Sound Manager 实现首次交互启动音乐和静音按钮。
- 检查桌面与移动浏览器在切换标签页后的音频行为。
理解浏览器音频状态
现代浏览器通常限制未经用户交互的有声自动播放。Phaser 的 Sound Manager 会处理音频解锁,但业务代码仍应避免在音频尚未解锁时直接启动背景音乐。
在 Phaser 4.2.1 中,需要区分三个独立的控制维度:
| 控制维度 | API 或属性 | 实际作用 |
|---|---|---|
| 音频解锁 | this.sound.locked |
判断是否仍在等待浏览器允许播放 |
| 解锁通知 | Phaser.Sound.Events.UNLOCKED |
音频系统解锁后触发事件 |
| 全局静音 | this.sound.setMute(true) |
让所有受 Sound Manager 管理的声音静音 |
| 失焦暂停 | this.sound.pauseOnBlur |
控制游戏失去焦点时是否暂停声音 |
音频解锁与静音并不是同一回事。locked 为 false 只代表音频系统已解除播放限制;如果 mute 为 true,即使音乐已经在播放,玩家也听不到声音。
同样,失焦暂停不应该修改玩家主动选择的静音状态。玩家静音后切换到其他标签页,返回游戏时仍应保持静音。

实现首次交互与静音控制
下面创建一个最小可运行的 Phaser 4.2.1 页面。玩家需要点击“开启音乐”才会请求播放,静音按钮可以随时切换,背景音乐使用单个循环播放实例,避免多次点击后叠加播放。
准备一个名为 index.html 的文件,并在同级目录下建立 assets/audio/,放入一段有合法使用权限、浏览器能够解码的 MP3 音频,命名为 music.mp3。本例通过 CDN 加载 Phaser 4.2.1。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Phaser 音频控制</title>
</head>
<body style="margin:0">
<script src="https://cdn.jsdelivr.net/npm/phaser@4.2.1/dist/phaser.min.js"></script>
<script>
class AudioScene extends Phaser.Scene {
constructor() {
super('AudioScene');
}
preload() {
this.load.audio('bgm', 'assets/audio/music.mp3');
}
create() {
// 失去焦点时暂停声音,重新获得焦点时由 Phaser 处理恢复
this.sound.pauseOnBlur = true;
const bgm = this.sound.add('bgm', {
loop: true,
volume: 0.4
});
let wantsMusic = false;
let musicStarted = false;
const status = this.add.text(30, 35, '点击开启音乐', {
fontSize: '24px',
color: '#ffffff'
});
const startButton = this.add.text(30, 110, '开启音乐', {
fontSize: '28px',
color: '#70e0c4'
}).setInteractive({ useHandCursor: true });
const muteButton = this.add.text(30, 180, '静音:关', {
fontSize: '28px',
color: '#ffffff'
}).setInteractive({ useHandCursor: true });
const tryStartMusic = () => {
// 解锁前不播放;已经启动时也不创建重复播放
if (!wantsMusic || musicStarted || this.sound.locked) {
return;
}
if (bgm.play()) {
musicStarted = true;
status.setText('音乐已启动');
} else {
status.setText('播放未成功,请再次点击');
}
};
// 解锁事件可能晚于按钮点击,先注册监听
this.sound.once(Phaser.Sound.Events.UNLOCKED, tryStartMusic);
startButton.on('pointerdown', () => {
wantsMusic = true;
if (this.sound.locked) {
status.setText('等待浏览器解锁音频');
} else {
tryStartMusic();
}
});
muteButton.on('pointerdown', () => {
this.sound.setMute(!this.sound.mute);
muteButton.setText(this.sound.mute ? '静音:开' : '静音:关');
});
}
}
new Phaser.Game({
type: Phaser.AUTO,
width: 640,
height: 360,
backgroundColor: '#18283e',
scene: AudioScene
});
</script>
</body>
</html>预期结果:浏览器显示一个深蓝色游戏画面,包含“开启音乐”和“静音:关”两个可点击文字按钮。初次进入页面不会主动启动背景音乐;点击“开启音乐”后,音频系统解锁时开始循环播放,页面显示“音乐已启动”。再次点击开启按钮不会叠加新的音乐实例。
这个实现刻意保留了 wantsMusic 和 musicStarted 两个状态。前者表示玩家已经明确请求播放,后者表示音乐确实启动成功。当浏览器尚未解锁时,代码等待 UNLOCKED 事件;如果音频已经解锁,则直接尝试播放。
运行并检查交互
将 index.html 与音频资源放好后,在项目根目录启动本地静态服务器。已安装 Python 3 的环境可以使用:
python3 -m http.server 8000预期结果:服务器保持运行,浏览器访问 http://localhost:8000/ 后出现游戏画面。正常加载时应能看到两个按钮;如果音频文件不存在,浏览器开发者工具的 Network 面板会显示对应资源请求失败。
按照下面的顺序逐项验证:
| 测试操作 | 预期行为 |
|---|---|
| 刷新页面,不点击游戏 | 不主动播放有声背景音乐 |
| 首次点击“开启音乐” | 解锁成功后音乐开始播放 |
| 再次点击“开启音乐” | 不出现两个音乐实例叠加 |
| 点击静音按钮 | 显示“静音:开”,声音消失 |
| 再次点击静音按钮 | 显示“静音:关”,恢复可听音量 |
| 音乐播放时切换到其他标签页 | 默认失焦策略下暂停声音 |
| 返回游戏标签页 | 重新获得焦点后尝试恢复此前播放的声音 |
| 静音后切换标签页再返回 | 仍保持静音,不擅自恢复声音 |
静音与暂停的区别需要特别检查:调用 setMute(true) 不代表音乐播放实例已停止。取消静音后,音乐应恢复到正常推进后的播放位置,而不是每次都从开头播放。
pauseOnBlur 控制的是 Phaser Sound Manager 的失焦行为,并不等于暂停整个游戏场景。如果关卡逻辑还需要停止物理更新、计时器或敌人行为,应另行使用场景暂停机制。
排查没有声音与恢复异常
遇到没有声音的情况,先判断音频资源、浏览器锁定与玩家静音状态,不要立即重复调用 play()。
- 打开浏览器开发者工具的 Network 面板,确认
assets/audio/music.mp3返回成功,而不是 404。确认音频格式受到当前浏览器支持。 - 检查
this.sound.locked。如果仍为true,说明音频尚未解锁,应要求玩家再次执行真实的点击或触摸操作。 - 检查
this.sound.mute。如果为true,先确认静音按钮状态与 Sound Manager 一致。 - 检查背景音乐实例的
isPlaying与isPaused。如果实例已停止,取消静音本身不会重新调用play()。 - 如果前几项正常,继续检查浏览器标签页是否被单独静音、系统音量和音频输出设备。
移动设备还需要单独检查 Safari 和 Chrome。部分浏览器在切换应用、锁屏或系统回收音频上下文后,可能不会像桌面浏览器一样立即恢复声音。返回页面时如果音频仍处于受限制状态,应允许用户再次点击播放按钮完成恢复,而不是强行自动启动。
当前示例的静音状态只保留在本次 Phaser 游戏实例中,刷新页面后会回到默认设置。如果正式游戏需要跨刷新保存选择,可在用户操作静音按钮时将布尔值写入 localStorage,并在新游戏实例初始化时读取和恢复;存储访问失败时则使用默认值,不能因此阻止游戏启动。
还要注意,this.sound.setMute() 是全局静音,会同时影响背景音乐与受同一个 Sound Manager 管理的拾取、受击等音效。如果产品需要分别控制音乐和音效,应使用对应声音实例的 setMute() 或音量控制,而不是给每类声音都调用全局静音。
通过以上验证后,游戏就能在首次有效交互后合理启动音频,在玩家要求静音时立即停止出声,并在标签页切换过程中尽量恢复原有播放状态,同时不改变玩家的静音偏好。