src-audio-skill

name	src-audio-skill
description	Work on event-driven spatial audio, radio voices, engines, weapons, ambience, and mix state.

claude-of-tanks / src/audio

Purpose

Translate canonical game-bus events and listener state into responsive spatial audio without owning gameplay decisions.

Mental model & key files

audio.js owns Web Audio routing and synthesized/decoded effects; voices.js owns crew-line scheduling and priority.

Patterns to follow / invariants

Initialize only after user gesture, subscribe through the injected bus, cap voices/loops, and stop stale sounds on phase or entity teardown.

Common tasks → first action

Trace the originating bus event, verify payload semantics, then test scheduler timing and live pause/phase behavior. Use audioTiming.selftest.mjs for pure contracts, tools/audio-spatial-killcam-probe.mjs for listener/distance PCM, and tools/audio-probe.mjs for the canonical event and bus matrix.

Gotchas

Camera direction and occupied-tank position form a hybrid listener. Network events may arrive late or duplicated, so presentation must key/dedupe them. Scope is an interior/headset perspective, never a mute. Keep the occupied engine regardless of distance, rank capped remote engines by proximity, and tear all world loops down when leaving battle.