SfxChannel class

SfxChannel — Sound Effects Manager (pooled)

Handles ultra-snappy SFX playback with simple grouping and throttling. Adds pooled playback for instant retrigger/overlap across assets, device files, or URLs while preserving the channel's audio context.

Key Features

• Sound groups (e.g., click, hover, hit) with randomized pick
• Cooldown per group to prevent spam
• Low-latency playback mode (best for short clips)
• Pooling (opt-in, enabled by default): instant retrigger of same file
• Persistent volume and active state via AudioStorage

Usage

// Bootstrap once
SfxChannel.initialize(AudioStorage.instance, audioContext);
SfxChannel.instance.enablePooling(enabled: true, poolSizePerSound: 4);

// Register sounds
SfxChannel.instance.registerGroup('click', [
  'assets/sfx/click1.wav',
  'assets/sfx/click2.wav',
]);

// Play randomized click (pooled)
await SfxChannel.instance.playGroup('click');

// Play a specific sfx (pooled; asset/file/url supported)
await SfxChannel.instance.playSfx('assets/sfx/button_tap.wav');

Notes

• Uses the channel’s current source builder via resolveSource(path), so changeSource((p) => DeviceFileSource(p)) works seamlessly.
• For long or streamed audio, use a non-lowLatency channel instead.

─────────────────────────────────────────────────────────────────────────────