controls.md

Controls

View source code

Play in background

By default sono will pause and resume all audio when the page is hidden. This feature can be turned off by setting the playInBackground property:

sono.playInBackground = true;

Master volume

// mute master volume
sono.mute();

// un-mute master volume
sono.unMute();

// set master volume to 50%
sono.volume = 0.5;

// get master volume
console.log(sono.volume); // 0.5

// fade out master volume to 0 over 2 seconds
sono.fade(0, 2);

Update individual sounds

// return instance of a sound by id
sono.get('foo');

// play sound by id after a 1 second delay
sono.play('foo', 1);

// pause sound by id
sono.pause('foo');

// stop sound by id
sono.stop('foo');

// destroy a sound (by instance or id)
sono.destroy(sound);
sono.destroy('bar');

Update all sounds

// pause all currently playing
sono.pauseAll();

// resume all currently paused
sono.resumeAll();

// stop all currently playing or paused
sono.stopAll();

// destroy all sounds
sono.destroyAll()

Master effects

import analyser from 'sono/effects/analyser';

const analyse = sono.effects.add(analyser());

Check support

sono.isSupported;
sono.hasWebAudio;

sono.canPlay.ogg;
sono.canPlay.mp3;
sono.canPlay.opus
sono.canPlay.wav;
sono.canPlay.m4a;