游戏引擎 / 系统课时
给拾取和受击行为绑定音效
给拾取和受击行为绑定音效
让玩家拾取金币时听到奖励音效,受到伤害时听到受击提示,同时避免连续碰撞造成音效反复播放和声音堆叠。本篇使用 Phaser 4.2.1 的 Sound Manager 与 Arcade Physics,实现可运行的拾取、受击和音效限流示例。
学习目标
- 使用
this.load.audio()加载短音频,并通过 Sound Manager 创建和播放声音实例。 - 将拾取音效与受击音效绑定到真实的 Arcade Physics 重叠事件。
- 使用时间间隔和声音实例状态限制重复播放,并验证浏览器音频解锁行为。
准备并加载短音效
Phaser 的声音资源需要先加载,再创建播放实例。对于频繁触发的短音效,推荐使用较短、开头没有明显静音的文件,避免玩家看到事件发生后才听到反馈。
本例使用两个自行准备的 MP3 文件,放置在项目根目录下的对应位置:
| 文件路径 | 用途 | 建议长度 | 播放音量 |
|---|---|---|---|
assets/audio/coin.mp3 |
金币拾取 | 0.10~0.20 秒 | 0.28 |
assets/audio/hurt.mp3 |
玩家受击 | 0.20~0.40 秒 | 0.45 |
建议使用 44.1 kHz 或 48 kHz 的常见音频采样率,导出普通 MP3 文件。文件长度与音量是本例的调试建议,不是 Phaser 对资源格式的强制限制。正式项目还可以为同一资源提供 OGG 与 MP3 两种格式,由加载器选择浏览器支持的文件。
在 Scene 的 preload() 中通过 this.load.audio(key, url) 加载,在 create() 中通过 this.sound.add(key, config) 创建实例。key 必须保持一致;如果加载使用 coin,创建实例时也必须使用 coin。
volume 的常用范围是 0~1,本例将拾取音量设为 0.28,受击音量设为 0.45,让伤害反馈比金币提示更明显。这些数值还需要根据原始音频响度进行试听调整。
在拾取和受击事件中播放
下面制作一个 760×430 的最小关卡。青绿色方块是玩家,黄色圆形是金币,橙色区域是危险区。方向键控制玩家移动;每枚金币只计分一次,进入危险区则扣除生命。
声音实例在 create() 中各建立一次,而不是每次重叠时重新调用 this.sound.add()。拾取事件负责销毁金币并增加分数,受击事件负责判断无敌时间并扣除生命,声音播放只是事件处理的附加反馈。
将下面代码保存为项目根目录的 index.html。示例适用于 Phaser 4.2.1,依赖前面准备的两个 MP3 文件。
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='UTF-8'>
<meta name='viewport' content='width=device-width, initial-scale=1'>
<title>Phaser 拾取与受击音效</title>
<style>
body { margin: 0; background: #192c39; }
canvas { display: block; margin: 24px auto; }
</style>
<script src='https://cdn.jsdelivr.net/npm/phaser@4.2.1/dist/phaser.min.js'></script>
</head>
<body>
<script>
class LevelScene extends Phaser.Scene {
constructor() {
super('Level');
}
preload() {
this.load.audio('coin', 'assets/audio/coin.mp3');
this.load.audio('hurt', 'assets/audio/hurt.mp3');
}
create() {
this.cameras.main.setBackgroundColor('#eff6f8');
this.score = 0;
this.hp = 3;
this.nextCoinSoundAt = 0;
this.hurtAllowedAt = 0;
// 每种音效保留一个实例,避免重复创建声音对象。
this.coinSound = this.sound.add('coin', { volume: 0.28 });
this.hurtSound = this.sound.add('hurt', { volume: 0.45 });
this.hud = this.add.text(20, 20, '金币 0 生命 3', {
fontSize: '20px', color: '#223647'
});
this.add.text(20, 52, '点击画面激活声音,方向键移动', {
fontSize: '16px', color: '#223647'
});
this.player = this.add.rectangle(85, 215, 32, 32, 0x18a6a1);
this.physics.add.existing(this.player);
this.player.body.setAllowGravity(false);
this.player.body.setCollideWorldBounds(true);
const coins = this.physics.add.staticGroup();
[180, 202, 224, 360].forEach(x => {
coins.add(this.add.circle(x, 215, 11, 0xffc857));
});
const danger = this.add.rectangle(570, 215, 95, 100, 0xe58d51);
this.physics.add.existing(danger, true);
// 先完成拾取和计分,再独立判断是否需要发声。
this.physics.add.overlap(this.player, coins, (_, coin) => {
if (!coin.active) return;
coin.destroy();
this.score++;
this.updateHud();
const now = this.time.now;
if (now >= this.nextCoinSoundAt && !this.coinSound.isPlaying) {
this.coinSound.play();
this.nextCoinSoundAt = now + 100;
}
});
// 持续重叠会多次触发回调,使用无敌窗口阻止重复扣血。
this.physics.add.overlap(this.player, danger, () => {
const now = this.time.now;
if (this.hp === 0 || now < this.hurtAllowedAt) return;
this.hp--;
this.hurtAllowedAt = now + 800;
this.updateHud();
if (!this.hurtSound.isPlaying) {
this.hurtSound.play();
}
});
this.keys = this.input.keyboard.createCursorKeys();
// Scene 被关闭或重新启动时,释放由本场景创建的声音实例。
this.events.once(Phaser.Scenes.Events.SHUTDOWN, () => {
this.coinSound.destroy();
this.hurtSound.destroy();
});
}
updateHud() {
this.hud.setText(`金币 ${this.score} 生命 ${this.hp}`);
}
update() {
const dx = Number(this.keys.right.isDown) - Number(this.keys.left.isDown);
const dy = Number(this.keys.down.isDown) - Number(this.keys.up.isDown);
const length = Math.hypot(dx, dy) || 1;
// 归一化移动方向,避免斜向移动比水平移动更快。
this.player.body.setVelocity(
dx / length * 190,
dy / length * 190
);
}
}
new Phaser.Game({
type: Phaser.AUTO,
width: 760,
height: 430,
physics: { default: 'arcade', arcade: { debug: false } },
scene: LevelScene
});
</script>
</body>
</html>预期结果: 页面出现青绿色玩家、4 枚黄色金币、一个橙色危险区以及金币和生命 HUD。首次点击游戏画面后,方向键可以移动角色。接触金币时金币消失、分数增加,并播放拾取音效;进入危险区时生命减少,并播放受击音效。
代码中的 this.time.now 是场景时钟,单位为毫秒。this.sound.add() 返回可重复使用的声音实例,isPlaying 表示该实例当前是否正在播放。这里没有为每次拾取创建新的音频对象。
限制重复播放和音效堆叠
音效限流要区分两个问题:游戏事件是否应该生效,以及该事件是否需要播放声音。不能因为金币音效正在播放就禁止玩家拾取金币,否则快速拾取会造成漏分。
本例采用两套规则:
| 事件 | 游戏状态规则 | 声音规则 |
|---|---|---|
| 金币拾取 | 销毁当前金币并计分一次 | 至少间隔 100 ms,且当前实例未播放 |
| 玩家受击 | 每 800 ms 最多扣血一次 | 通过受击状态限制触发,实例播放中不叠加 |
金币间隔较近时,玩家可能在同一帧拾取两枚金币。两次拾取都正常计分,但只有一次音效被允许播放。受击则不同:角色持续站在危险区内时,每帧都可能发生重叠检测,必须先检查 hurtAllowedAt,否则即使限制了声音,生命值仍会快速归零。

这里的 100 ms 是金币音效的最小触发间隔,isPlaying 还会阻止上一段声音未结束时再次播放。因此实际音效间隔可能超过 100 ms。对于需要连续叠加的射击、爆炸等声音,可以改用有限数量的声音实例池,而不是无限制地调用 this.sound.play()。
运行验证与常见问题
确认 index.html 与 assets/audio/coin.mp3、assets/audio/hurt.mp3 位于正确位置。在项目根目录打开终端,使用 Python 3 启动本地 HTTP 服务。macOS 和 Linux 通常使用以下命令,Windows 可以将 python3 替换为 py -3。
python3 -m http.server 8000 --bind 127.0.0.1预期输出:
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...保持终端运行,使用浏览器打开 http://127.0.0.1:8000。依次检查以下行为:
- 点击游戏画面,按方向键移动到金币区域。每个金币消失时 HUD 增加 1 分;连续拾取时不会出现多个金币音效严重叠加。
- 进入橙色危险区,生命由 3 变为 2,同时听到一次受击音效。持续站在危险区内时,生命按约 800 ms 的间隔继续减少,而不是每帧扣除。
- 生命到 0 后,继续站在危险区内不会再扣血或触发受击音效。拾取其余金币仍然可以正常增加分数。
- 刷新页面后,在点击画面前不要假设音效已解锁;点击后再进行拾取和受击测试。
如果画面正常但没有声音,优先检查浏览器开发者工具的 Network 和 Console:
- 资源返回 404: 文件路径或文件名不正确。确认 MP3 文件真实存在,且大小写与
preload()中的路径一致。 - 出现 AudioContext 自动播放限制提示: 浏览器尚未获得用户交互。先点击或触摸游戏画面,再触发音效。Phaser 会在首次用户交互时尝试解锁声音。
- 只有部分浏览器无法播放: 检查音频编码格式与浏览器兼容性,必要时同时提供 MP3 和 OGG 文件。
- 音效过响或相互遮盖: 降低实例的
volume,检查音频原始峰值,并确认没有其他场景重复播放同一类声音。 - 切换场景后仍有声音: Sound Manager 属于整个 Game,而不是某一个 Scene。对自己创建的声音实例,在 Scene 关闭时调用
destroy();持续循环播放的音效还需要规划停止时机。
正式接入已有的游戏关卡时,可以保留现有的拾取、生命值和无敌状态代码,只把声音加载、实例创建和受限播放逻辑加入相应事件处理函数。这样可以在不改变计分与伤害规则的前提下增加音效反馈。