play-audio

Lightweight Wrapper For HTML5 Audio API

play = require('play-audio')

play('song.mp3').autoplay()

• Example 1: Playing An Alert Sound
• Example 2: Music player
• Example 3: alert library

Install

$ npm install play-audio

Browser Compatibility

play(['song.mp3', 'song.ogg']).play()

Displaying Controls

parent = document.querySelector('.my-player')
play(['song.mp3', 'song.ogg'], parent).autoplay.controls()

How to use without NPM?

If your application isn't structured as a CommonJS package, you can download the distribution file;

$ wget https://raw.github.com/azer/play-audio/master/dist/play-audio.js

And include it on your page:

<script src="play-audio.js"></script>
<script>
  playAudio(['song.mp3', 'song.ogg'])
</script>

Changing Source After Initialization

p = play(['song.mp3', 'song.ogg']).autoplay()
p.src()
// => ['song.mp3', 'song.ogg']

p.src(['new.mp3', 'new.ogg']).play()
p.src()
// => ['new.mp3', 'new.ogg']

API

Example:

play('foo.mp3').volume(0.3).controls().loop().on('ended', function(){
  console.log('End of the song reached')
})

Reference:

• play(uri, parentElement)
• .controls
• .currentTime
• .element
• .loop
• .muted
• .on(event, function)
• .pause
• .play
• .preload
• .src(url)
• .volume(number)

Events

• abort
• durationchange
• ended
• error
• pause
• play
• progress
• timeupdate

See complete reference