https://github.com/waud/waud
Web Audio Library
https://github.com/waud/waud
audio-sprites base64 haxelib html5-audio npm-package web-audio web-audio-library
Last synced: about 1 year ago
JSON representation
Web Audio Library
- Host: GitHub
- URL: https://github.com/waud/waud
- Owner: waud
- License: mit
- Created: 2015-12-10T21:11:47.000Z (over 10 years ago)
- Default Branch: dev
- Last Pushed: 2019-10-10T08:08:02.000Z (over 6 years ago)
- Last Synced: 2025-04-13T07:49:05.279Z (about 1 year ago)
- Topics: audio-sprites, base64, haxelib, html5-audio, npm-package, web-audio, web-audio-library
- Language: Haxe
- Homepage: http://www.waudjs.com
- Size: 27.5 MB
- Stars: 638
- Watchers: 14
- Forks: 38
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 
Web Audio Library with HTML5 audio fallback.
[](https://travis-ci.org/waud/waud)
[](https://www.npmjs.com/package/waud.js)
[](https://codeclimate.com/github/waud/waud)
[](https://codeclimate.com/github/waud/waud/issues)
[](https://www.patreon.com/adireddy)
Waud is a simple and powerful web audio library that allows you to go beyond HTML5's `` tag and easily take advantage of [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API). It abstracts Web Audio API making it consistent and reliable across multiple platforms and browsers. It also falls back to HTML5 Audio on non-modern browsers where Web Audio API is not supported.
### Features
- Base64 Pack
- Audio Sprites
- iOS Audio Unlock1
- Auto Mute2
- Simple API
- Zero Dependencies
1 Automatically unlocks audio on iOS devices on first touch.
2 Automatically mutes audio when the window is not in focus (switching tab, minimising window, etc).
### Installation
Available via npm, cdn and haxelib (for haxe users).
- NPM: [https://www.npmjs.com/package/waud.js](https://www.npmjs.com/package/waud.js)
- CDN: [https://cdnjs.com/libraries/waud.js](https://cdnjs.com/libraries/waud.js)
- Haxelib: [http://lib.haxe.org/p/waud](http://lib.haxe.org/p/waud)
[](https://www.npmjs.com/package/waud.js/)
### [API Documentation](http://waud.github.io/api/)
### Example
Example:
```js
var snd = new WaudSound("assets/loop.mp3", { autoplay: false, loop: true, volume: 0.5, onload: playBgSound });
```
### Base64 Data URI
Waud supports base64 decoding across all browsers including IE 9 and I recommend using this over audio sprites.
Use [waudbase64](https://github.com/waud/waudbase64) to generate base64 encoded JSON file.
`npm install -g waudbase64`
```js
var base64pack = new WaudBase64Pack("assets/sounds.json", _onLoad);
function _onLoad(snds) {
snds.get("assets/beep.mp3").play();
}
```
Waud also supports passing data URI string to `WaudSound`.
```js
//Note that the data URI used below is a sample string and not a valid sound
var base64Snd = new WaudSound("data:audio/mpeg;base64,//uQxAAAAAAAAAAAAASW5mbwAAAA8AAABEAABwpgADBwsLDxISF");
```
### Audio Sprite
Use [waudsprite](https://github.com/waud/waudsprite) to generate audio sprite.
`npm install -g waudsprite`
```js
var audSprite = new WaudSound("assets/sprite.json");
audSprite.play("glass");
```
### Live Audio Stream
[Waud Radio](http://www.waudjs.com/radio)
Waud supports live audio streams, but make sure to disable web audio as live streams can only be played through HTML5 Audio.
```js
var snd = new WaudSound("http://ice-sov.musicradio.com/SmoothUKMP3", { autoplay:true, webaudio:false });
````
### Browser Support
Tested on all major browsers.
| 
| 
| 
| 
| 
| 
|
|:--:|:--:|:--:|:--:|:--:|:--:|
| Latest ✓ | Latest ✓ | Latest ✓ | Latest ✓ | 9-11 ✓ | Latest ✓ |
Browser & Device Testing provided by:
[](https://www.browserstack.com)
### Issues
Found any bug? Please create a new [issue](https://github.com/waud/waud/issues/new).
### Demo
- [JavaScript](http://waud.github.io/sample/js.html)
- [Haxe](http://waud.github.io/sample/)
- [Base64](http://waud.github.io/sample/base64.html)
### Usage
```js
// Initialize Waud. Make sure to call this before loading sounds.
Waud.init();
// To automatically unlock audio on iOS devices by playing a blank sound.
// The parameter is a callback function that can be used to start playing sounds like background music.
Waud.enableTouchUnlock(touchUnlock);
// Use if you want to mute audio when the window is not in focus like switching tabs, minimising window,
// etc in desktop and pressing home button, getting a call, etc on devices.
Waud.autoMute();
// Load and play looping background sound with autoPlay and loop set to true.
// Note that this will not play automatically on iOS devices without touching the screen.
var bgSnd = new WaudSound("loop.mp3", {
"autoplay": true,
"loop": true
});
// Touch unlock callback for iOS devices to start playing bgSnd if it's not already playing
function touchUnlock() {
if (!bgSnd.isPlaying()) bgSnd.play();
}
```
### Sample Rate
- It is recommended to use same **sample rate** for all the audio files. Playing different **sample rate** files can cause issues on some devices.
- By default, **Waud** uses **44100** sample rate. If your audio files have a different sample rate then specify it using [**`Waud.preferredSampleRate`**](http://waud.github.io/api/classes/Waud.html#property_preferredSampleRate) property.
### Licensing Information
This content is released under the [MIT](http://opensource.org/licenses/MIT) License.
### Contributor Code of Conduct ###
[Code of Conduct](https://github.com/CoralineAda/contributor_covenant) is adapted from [Contributor Covenant, version 1.4](http://contributor-covenant.org/version/1/4)