@nerima-games/mc-audio active
nerima-games vunknown added 2026-08-01 verified 2026-08-01
You need a DOM-free WebAudio engine module for a browser game with SFX cue registry, BGM state machine, and caption events that fire before any audio gate check, including when audio is muted or blocked.
about
mc-audio is a TypeScript package that handles the audio layer for a browser game: it manages a sound cue registry, a BGM state machine, volume category arithmetic, and a caption event stream. The core invariant is that caption events fire before audio gate checks — captions are emitted even when audio is muted, blocked by autoplay policy, or when no backend exists at all. This makes the system correct for deaf and muted players by design.
The package deliberately excludes DOM from its TypeScript lib config, forcing all WebAudio-specific behavior behind an AudioBackendPort interface. This means the entire domain — cue planning, volume math, BGM transitions, caption streams — can be tested with Vitest without jsdom or AudioContext. The WebAudio adapter is a separate concern written last, not first.
Dependencies are restricted to Effect and an internal kernel package, enforced mechanically by a dependency whitelist script. The package is a sink in the architecture: it receives calls from gameplay and UI layers but never imports from the simulation layer. As of the current state, the WebAudio adapter is not yet implemented, the cue roster is provisional, and there is no build/publish pipeline.
related
AudioVibrationKit
UnityA modular Unity toolkit that consolidates audio management and haptic feedback into a single ScriptableObject-based architecture. Provides audio pooling for 2D and 3D sounds, music playback with smooth transitions, and curve-based vibration control using AnimationCurve. Includes Odin Inspector-powered editor tools that auto-generate type-safe enums for sounds, music tracks, and vibration patterns. The vibration system supports preset patterns, constant vibrations, emphasis modes, and custom curve-based playback with real-time updates and cancellation via UniTask. Designed for Android deployment with runtime performance in mind. All audio and haptic configurations are managed through visual editors with real-time preview capabilities.
Bevy Kira Audio
StandaloneA Bevy plugin integrating the Kira audio library as an alternative to bevy_audio. Supports playback of ogg, mp3, flac, and wav formats across native and web builds. Provides granular control over audio instances and channels, including dynamic transitions for volume, panning, playback rate, and looping behavior. Sound playback is organized into channels, each offering independent control over pause, stop, volume, speed, and panning for all sounds within that channel. Audio instances can be configured at start time or controlled individually during playback, with support for smooth transitions using tweens and various easing curves. Includes settings loader functionality for pre-configuring audio sources via ron files. Offers basic spatial audio capabilities that automatically adjust volume and panning based on emitter and receiver positions in 3D space.
campello_audio
Standalone · Engine-agnosticcampello_audio is a C++20 multiplatform audio engine designed for game development. It covers macOS, iOS, Android, Windows, Linux, and WebAssembly using each platform's native audio backend (CoreAudio, AAudio, WASAPI, PulseAudio/ALSA, Web Audio). The API follows a fire-and-forget pattern for simple playback while exposing full voice control, mixing buses, and filter chains when needed. The engine supports WAV, OGG, and MP3 sources, procedural tone generation, streaming for large files, and a RandomSource to avoid repetition artifacts. Up to 8 DSP filters per source or bus are available, including low-pass, high-pass, echo, reverb, compressor, limiter, chorus, flanger, and pitch shift. Filter parameters support timed automation. It is a standalone module within the Campello engine ecosystem but is designed to work independently. Built via CMake with no required external dependencies beyond the target platform SDK.
DALIA Engine
Engine-agnosticDALIA (Dedicated Abstraction Layer for Interactive Audio) is a C++20 audio engine targeting Windows via WASAPI. All internal pools are pre-allocated at startup, eliminating runtime dynamic allocations outside of background-thread asset loading. It handles asynchronous reference-counted asset management and double-buffered OGG/Vorbis streaming via stb_vorbis. Spatialization covers configurable coordinate handedness, multi-listener support with bitmask routing for split-screen co-op, distance probes that decouple attenuation origin from panning origin, and Doppler shifts with per-playback scaling. The mixing system is a directed acyclic graph with 4 hot-swappable DSP slots per bus. The library integrates via CMake FetchContent or git submodule. A standalone sandbox application ships for testing features without writing code. A studio UI tool is in development but excluded from the default build.