WavePlayer JavaScript library

A simple JavaScript sound player : it's allows to play .wav file in a lot of browsers with a same interface (Chrome, Firefox, IE7+). The original purpose is to fix IE9+ .wav playing with HTML5 audio tag that is not supported.

• For IE9+ browsers : use bgsound tag
• For modern browsers : use HTML5 audio feature (http://www.w3schools.com/tags/ref_av_dom.asp)
• Others : use embed tag

Supports

Tested formats and browsers :

| Format | IE7+ | Firefox | Chrome | Chrome Android | |:--------:|:----:|:-------:|:------:|:--------------:| | WAV | ✓ | ✓ | ✓ | ✓ | | MP3 | ✓ | ✓ | ✓ | ✓ |

Downloads

Installation with Bower is available :

bower install waveplayer

UI usage

You can use the jquery approach which generates a HTML interface :

	<link href="../dist/waveplayer.min.css" type="text/css" rel="stylesheet" />
	<script src="../dist/waveplayer.min.js"></script>
	<script>
		$(document).ready(function() {
			$('.wave-player').wavePlayer();
		});
	</script>
	
	<div class="wave-player" 
		data-src="sound.wav" 
		data-label="Play">
	</div>		

Data attributes

• data-src : File URI to play
• data-label : label to show in player

Programmatically usage

To use the programmatically approach :

var wavePlayer = new WavePlayer();

wavePlayer.play('sound.wav');
wavePlayer.stop();

With preload :

var wavePlayer = new WavePlayer({src : 'sound.wav'});

wavePlayer.play();
wavePlayer.stop();

Also, jQuery is not required.

Methods

constructor(opts)

Make a WavePlayer instance with specific options.

| name | description | type | default | |------|-------------|--------|-----------| | opts | Options map. | object | See below |

Options

| name | description | type | default | |-----------|--------------------------------------------------------------------------------------|---------|--------------| | src | Sound uri to preload. | string | none | | container | Tag container for media tag (bgsound, embed, ...). | node | document.body| | resetPlay | Force playing from start for HTML5 audio when play method is called after stop method. | boolean | true |

.play(uri)

Play the sound in parameter or passed in constructor with option 'src'.

| name | description | type | default | |------|-------------|--------|-----------| | uri | Optional, sound uri to play | string | none |

.stop()

Stop current sound.