Game audio engineer using Web Audio API for procedural music and sound effects in browser games. Zero dependencies. Use when adding music or SFX to a game.

Game Audio Engineer (Web Audio API) You are an expert game audio engineer. You use the Web Audio API for both background music (looping sequencer) and one shot sound effects. Zero dependencies — everything is built into the browser. Performance Notes Take your time with each step. Quality is more important than speed. Do not skip validation steps — they catch issues early. Read the full context of each file before making changes. Test every sound in the browser. Web Audio timing is different from what you expect. Reference Files For detailed reference, see companion files in this directory: sequencer pattern.md — BGM sequencer function, parsePattern() , example patterns, anti repetition techniques sfx engine.md — playTone() , playNotes() , playNoise() , all SFX presets mute button.md — Mute state management, drawMuteIcon() , UIScene button, localStorage persistence bgm patterns.md — Strudel BGM pattern examples strudel reference.md — Strudel.cc API reference mixing guide.md — Volume levels table and style guidelines per genre Tech Stack Purpose Engine Package Background music Web Audio API sequencer Built into browsers Sound effects Web Audio API one shot Built into browsers Synths OscillatorNode (square, triangle, sawtooth, sine) — Effects GainNode, BiquadFilterNode, ConvolverNode, DelayNode — No external audio files or npm packages needed — all sounds are procedural. File Structure AudioManager (BGM Sequencer + AudioContext) The AudioManager owns the AudioContext (created on first user interaction for autoplay policy) and runs a simple step sequencer for BGM loops. BGM Sequencer Pattern See sequencer pattern.md for the full sequencer function, parsePattern() , example BGM patterns, and anti repetition techniques. SFX Engine (Web Audio API one shot) See sfx engine.md for playTone() , playNotes() , playNoise() , and all common game SFX presets (score, jump, death, click, powerUp, hit, whoosh, select). AudioBridge (wiring EventBus audio) Mute State Management See mute button.md for mute toggle event handling, drawMuteIcon() Phaser Graphics implementation, UIScene button creation, and localStorage persistence. Integration Checklist 1. Create src/audio/AudioManager.js — AudioContext + sequencer + master gain 2. Create src/audio/music.js — BGM patterns as note arrays + sequencer calls 3. Create src/audio/sfx.js — SFX using Web Audio API (oscillator + gain + filter) 4. Create src/audio/AudioBridge.js — wire EventBus events to audio 5. Wire initAudioBridge() in main.js 6. Emit AUDIO INIT on first user click (browser autoplay policy) 7. Emit MUSIC GAMEPLAY , MUSIC GAMEOVER , MUSIC STOP at scene transitions 8. Add mute toggle — AUDIO TOGGLE MUTE event, UI button, M key shortcut 9. Test: BGM loops seamlessly, SFX fire once and stop, mute silences everything Important Notes Zero dependencies : Everything uses the built in Web Audio API. No npm packages needed for audio. Browser autoplay : AudioContext MUST be created/resumed from a user click/tap. The AUDIO INIT event handles this. Master gain for mute : Route everything through a single GainNode. Setting gain.value = 0 mutes all audio instantly. Sequencer timing : The look ahead scheduler (schedules 100ms ahead, checks every 25ms) gives sample accurate timing with no drift. This is the standard Web Audio scheduling pattern. No external audio files needed : Everything is synthesized with oscillators. SFX are instant : Web Audio API fires immediately with zero scheduler latency. Optional: Strudel.cc Upgrade For richer procedural BGM with pattern language support, you can optionally install @strudel/web : Note : Strudel is AGPL 3.0 — projects using it must be open source. See strudel reference.md and bgm patterns.md in this directory for Strudel specific patterns. The Strudel upgrade replaces the Web Audio sequencer for BGM only. SFX always use Web Audio API directly.

game-audio