Skip to main content

reset

reset(options?: SoundResetOptions): void;

Reset the sound manager to its initial state. Optionally, provide SoundResetOptions to customize which aspects to reset.

By default ({}), all properties are reset to defaults. Use keep* properties to selectively preserve certain values:

// Reset everything to defaults
soundManager.reset();

// Keep volume and panning, reset everything else
soundManager.reset({ keepVolumes: true, keepPanning: true });

Example

await soundManager.loadSounds([{ id: 'bells-melody', url: 'bells-melody.mp3' }]);

soundManager.play('bells-melody', { loop: true, volume: 0.3, pan: -0.8, playbackRate: 1.5 });

// Later: reset everything
soundManager.reset();
// The sound manager is back to its initial state
Volume0.7
Pan0
Playback Rate1
Try it: Adjust volume, pan, and rate while playing. Click resetSound(id) to reset all properties to defaults. Use resetSound(id, { keepVolumes: true }) to selectively keep certain settings.