SuperAPI AI 工具集

phaser-audio

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:在 Phaser 4 游戏中正确加载与播放音频,规避常见音频缺陷。

主要能力:默认使用 Web Audio,AudioContext 不可用时回退 HTML5 Audio;加载音频时同时提供 mp3 与 ogg 两种格式;用 this.sound.add() 获取可控引用(循环、暂停、恢复、调音量、监听事件),用 this.sound.play() 播放一次性音效;通过 SoundConfig 设置 loop、volume、rate、detune、seek、delay;用音频精灵合并多个短音效减少请求;支持全局与单个音量、静音切换;处理移动端自动播放锁定与 AudioContext 挂起恢复;用补间实现场景间音乐淡入淡出;场景关闭时停止音频。

使用方式:在 preload() 中用 this.load.audio(key, [mp3, ogg]) 加载;背景音乐用 add() 后 play(),音效直接 sound.play();高频音效可预建实例池轮询;音频精灵用 this.load.audioSprite() 加载、this.sound.playAudioSprite() 播放;移动端用 this.sound.locked 判断并监听 Phaser.Sound.Events.UNLOCKED;标签页恢复时检查 context.state 并调用 resume();场景 shutdown() 中停止本场景音频。

适用场景:网页游戏、移动端 H5 游戏的背景音乐与音效管理。

限制:移动端音频解锁由浏览器强制,无法绕过;AudioContext 挂起后不会自动恢复,需手动处理;强制 HTML5 Audio 会失去多轨、变速与空间定位能力;具体 API 细节以官方文档为准。