├── .gitignore
├── package.json
├── index.js
├── README.md
└── lib
    ├── audio-object.js
    ├── audio-tag-player.js
    └── web-audio-player.js


/.gitignore:
--------------------------------------------------------------------------------
1 | test


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "browser-audio",
 3 |   "version": "1.0.2",
 4 |   "description": "Browser audio player",
 5 |   "main": "index.js",
 6 |   "scripts": {
 7 |     "test": "echo \"Error: no test specified\" && exit 1"
 8 |   },
 9 |   "repository": {
10 |     "type": "git",
11 |     "url": "https://github.com/yyx990803/browser-audio"
12 |   },
13 |   "keywords": [
14 |     "audio",
15 |     "browser"
16 |   ],
17 |   "author": "Evan You",
18 |   "license": "MIT",
19 |   "bugs": {
20 |     "url": "https://github.com/yyx990803/browser-audio/issues"
21 |   },
22 |   "homepage": "https://github.com/yyx990803/browser-audio"
23 | }
24 | 


--------------------------------------------------------------------------------
/index.js:
--------------------------------------------------------------------------------
 1 | var AudioObject = require('./lib/audio-object')
 2 | 
 3 | module.exports = {
 4 | 
 5 |   create: function (url) {
 6 |     return new AudioObject(url)
 7 |   },
 8 | 
 9 |   whenLoaded: function (objects, cb) {
10 |     var loaded = 0
11 |     if (!Array.isArray(objects)) {
12 |       objects = [objects]
13 |     }
14 |     objects.forEach(function (o) {
15 |       if (o.state === 'loaded') {
16 |         check()
17 |       } else {
18 |         o.once('load', check)
19 |       }
20 |     })
21 |     function check () {
22 |       loaded++
23 |       if (loaded === objects.length) {
24 |         cb()
25 |       }
26 |     }
27 |   }
28 | 
29 | }


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Browser Audio
 2 | 
 3 | A simple cross-browser audio player. Uses Web Audio when possible (except in Firefox where HTML5 `<audio>` works better) and falls back to HTML5 `<audio>`. Supports IE10+ and most mobile browsers.
 4 | 
 5 | The file formats supported depend on the underlying Browser implementation, but `.mp3` should work in most situations.
 6 | 
 7 | Note this library is only intended for playing multiple small sound effects, there's no streaming support for large files.
 8 | 
 9 | ## Usage
10 | 
11 | ``` bash
12 | npm install browser-audio
13 | ```
14 | 
15 | ``` js
16 | var audio = require('browser-audio')
17 | var file = audio.create('url-to-file.mp3')
18 | 
19 | file.play() // plays when loaded
20 | // or...
21 | // files are instances of EventEmitter
22 | file.once('load', file.play.bind(file))
23 | 
24 | // other methods/properties:
25 | file.stop()
26 | file.state // 'loading' or 'loaded'
27 | file.duration
28 | file.currentTime
29 | 
30 | // multiple file load helper
31 | var file1 = audio.create('...')
32 | var file2 = audio.create('...')
33 | audio.whenLoaded([file1, file2], function () {
34 |   // all files loaded
35 | })
36 | ```
37 | 
38 | ## License
39 | 
40 | MIT


--------------------------------------------------------------------------------
/lib/audio-object.js:
--------------------------------------------------------------------------------
 1 | var AudioTagPlayer = require('./audio-tag-player')
 2 | var WebAudioPlayer = require('./web-audio-player')
 3 | var Emitter = require('events').EventEmitter
 4 | var AudioContext = window.AudioContext || window.webkitAudioContext
 5 | 
 6 | var player
 7 | if (AudioContext) {
 8 |   try {
 9 |     // Chrome throws error when having too many AudioContexts
10 |     console.log('audio context')
11 |     player = new WebAudioPlayer(AudioContext)
12 |   } catch (e) {
13 |     console.log('error, fallback to audio tag')
14 |     player = new AudioTagPlayer()
15 |   }
16 | } else {
17 |   player = new AudioTagPlayer()
18 | }
19 | 
20 | function noop () {}
21 | 
22 | function AudioObject (url) {
23 |   Emitter.call(this)
24 |   this.url = url
25 |   this.state = 'loading'
26 |   player.load(url, function () {
27 |     this.state = 'loaded'
28 |     this.emit('load')
29 |   }.bind(this))
30 | }
31 | 
32 | var p = AudioObject.prototype = Object.create(Emitter.prototype)
33 | 
34 | p.play = function () {
35 |   if (this.state === 'loaded') {
36 |     player.play(this.url)
37 |   } else {
38 |     this.once('load', this.play.bind(this))
39 |   }
40 | }
41 | 
42 | p.stop = function () {
43 |   player.stop(this.url)
44 | }
45 | 
46 | Object.defineProperty(p, 'duration', {
47 |   enumerable: true,
48 |   get: function () {
49 |     return player.durationOf(this.url)  
50 |   },
51 |   set: noop
52 | })
53 | 
54 | Object.defineProperty(p, 'currentTime', {
55 |   enumerable: true,
56 |   get: function () {
57 |     return player.time(this.url)
58 |   },
59 |   set: noop
60 | })
61 | 
62 | module.exports = AudioObject


--------------------------------------------------------------------------------
/lib/audio-tag-player.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * A player using audio tags
 3 |  */
 4 | 
 5 | function AudioTagPlayer () {
 6 |   this.audios = {}
 7 |   this.loaded = {}
 8 | }
 9 | 
10 | var p = AudioTagPlayer.prototype
11 | 
12 | p.load = function (url, cb) {
13 |   var audio = this.audios[url]
14 |   if (audio) {
15 |     if (cb) {
16 |       if (!this.loaded[url]) {
17 |         audio.addEventListener('loadeddata', cb)
18 |       } else {
19 |         cb()
20 |       }
21 |     }
22 |     return
23 |   }
24 |   audio = this.audios[url] = new Audio()
25 |   audio.src = url
26 |   audio.load()
27 |   var self = this
28 |   audio.addEventListener('loadeddata', function () {
29 |     self.loaded[url] = true
30 |     if (cb) cb()
31 |   })
32 | }
33 | 
34 | p.play = function (url) {
35 |   var loaded = this.loaded[url]
36 |   if (!loaded) {
37 |     console.warn(
38 |       'audio: attempting to play file: ' + url +
39 |       ' which is not loaded yet.'
40 |     )
41 |     return
42 |   }
43 |   var audio = this.audios[url]
44 |   audio.play()
45 | }
46 | 
47 | p.stop = function (url) {
48 |   var loaded = this.loaded[url]
49 |   if (loaded) {
50 |     var audio = this.audios[url]
51 |     audio.pause()
52 |     audio.currentTime = 0
53 |   }
54 | }
55 | 
56 | p.loadAll = function (files, cb) {
57 |   var loaded = 0
58 |   var self = this
59 |   files.forEach(function (file) {
60 |     self.load(file, function () {
61 |       loaded++
62 |       if (loaded >= files.length) {
63 |         cb()
64 |       }
65 |     })
66 |   })
67 | }
68 | 
69 | p.durationOf = function (url) {
70 |   if (this.loaded[url]) {
71 |     return this.audios[url].duration
72 |   }
73 | }
74 | 
75 | p.time = function (url) {
76 |   if (this.loaded[url]) {
77 |     return this.audios[url].currentTime
78 |   }
79 | }
80 | 
81 | module.exports = AudioTagPlayer


--------------------------------------------------------------------------------
/lib/web-audio-player.js:
--------------------------------------------------------------------------------
  1 | /**
  2 | * A player using the Web Audio API
  3 | */
  4 | 
  5 | function WebAudioPlayer (AduioContext) {
  6 |   this.context = new AduioContext()
  7 |   this.pending = {}
  8 |   this.buffers = {}
  9 |   this.sources = {}
 10 |   this.timers = {}
 11 | }
 12 | 
 13 | var p = WebAudioPlayer.prototype
 14 | 
 15 | p.load = function (url, cb) {
 16 |   // check if there's a pending request.
 17 |   // if yes, merge the callback with the existing callback
 18 |   var request = this.pending[url]
 19 |   if (request) {
 20 |     if (cb) {
 21 |       var ocb = request.onload
 22 |       request.onload = function () {
 23 |         ocb()
 24 |         cb()
 25 |       }
 26 |     }
 27 |     return
 28 |   }
 29 |   // check if the buffer is already loaded.
 30 |   var buffer = this.buffers[url]
 31 |   if (buffer) {
 32 |     if (cb) cb()
 33 |     return
 34 |   }
 35 |   request = new XMLHttpRequest()
 36 |   request.open('GET', url, true)
 37 |   request.responseType = 'arraybuffer'
 38 |   // Decode asynchronously
 39 |   var self = this
 40 |   request.onload = function () {
 41 |     self.context.decodeAudioData(
 42 |       request.response,
 43 |       function (buffer) {
 44 |         self.buffers[url] = buffer
 45 |         if (cb) cb()
 46 |       },
 47 |       function (e) {
 48 |         console.warn(
 49 |           'audio: error decoding response for ' + url
 50 |         )
 51 |       }
 52 |     )
 53 |   }
 54 |   request.send()
 55 | }
 56 | 
 57 | p.play = function (url) {
 58 |   var buffer = this.buffers[url]
 59 |   if (!buffer) {
 60 |     console.warn(
 61 |       'audio: attempting to play file: ' + url +
 62 |       ' which is not loaded yet.'
 63 |     )
 64 |     return
 65 |   }
 66 |   var source = this.context.createBufferSource()
 67 |   this.sources[url] = source
 68 |   source.buffer = buffer
 69 |   source.connect(this.context.destination)
 70 |   if (typeof source.noteOn === "function") {
 71 |     source.noteOn(0)
 72 |   } else {
 73 |     source.start()
 74 |   }
 75 |   var timers = this.timers
 76 |   timers[url] = this.context.currentTime
 77 |   source.onended = function () {
 78 |     timers[url] = null
 79 |   }
 80 | }
 81 | 
 82 | p.stop = function (url) {
 83 |   if (this.sources[url]) {
 84 |     this.sources[url].stop(0)
 85 |     this.sources[url] = null
 86 |     this.timers[url] = null
 87 |   }
 88 | }
 89 | 
 90 | p.loadAll = function (files, cb) {
 91 |   var loaded = 0
 92 |   var self = this
 93 |   files.forEach(function (file) {
 94 |     self.load(file, function () {
 95 |       loaded++
 96 |       if (loaded >= files.length) {
 97 |         cb()
 98 |       }
 99 |     })
100 |   })
101 | }
102 | 
103 | p.durationOf = function (url) {
104 |   var buffer = this.buffers[url]
105 |   if (buffer) return buffer.duration
106 | }
107 | 
108 | p.time = function (url) {
109 |   if (this.timers[url] != null) {
110 |     return this.context.currentTime - this.timers[url]
111 |   } else {
112 |     return 0
113 |   }
114 | }
115 | 
116 | module.exports = WebAudioPlayer


--------------------------------------------------------------------------------