Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CreateJS/SoundJS
A Javascript library for working with Audio. It provides a consistent API for loading and playing audio on different browsers and devices. Currently supports WebAudio, HTML5 Audio, Cordova / PhoneGap, and a Flash fallback.
https://github.com/CreateJS/SoundJS
Last synced: about 1 month ago
JSON representation
A Javascript library for working with Audio. It provides a consistent API for loading and playing audio on different browsers and devices. Currently supports WebAudio, HTML5 Audio, Cordova / PhoneGap, and a Flash fallback.
- Host: GitHub
- URL: https://github.com/CreateJS/SoundJS
- Owner: CreateJS
- License: mit
- Created: 2011-11-02T04:18:36.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2021-03-27T15:13:45.000Z (over 3 years ago)
- Last Synced: 2024-11-02T08:05:45.857Z (about 1 month ago)
- Language: JavaScript
- Homepage: http://createjs.com/
- Size: 80.3 MB
- Stars: 4,441
- Watchers: 219
- Forks: 834
- Open Issues: 97
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-game-engine-dev - SoundJS - Simple API and powerful features, part of the _CreateJS_ suite. (Libraries / JavaScript)
- awesome-javascript - SoundJS - A Javascript library for working with Audio. It provides a consistent API for loading and playing audio on different browsers and devices. Currently supports WebAudio, HTML5 Audio, Cordova / PhoneGap, and a Flash fallback. - ★ 3486 (Video/Audio)
- awesome-star-libs - CreateJS / SoundJS
- awesome-frontend-libraries - SoundJS
README
# SoundJS
SoundJS is a library to make working with audio on the web easier. It provides a consistent API for playing audio in
different browsers, including using a target plugin model to provide an easy way to provide additional audio plugins
like a Flash fallback (included, but must be used separately from the combined/minified version).
A mechanism has been provided for easily tying in audio preloading to [PreloadJS](http://createjs.com/preloadjs/).
## Example
```javascript
createjs.Sound.on("fileload", handleLoadComplete);
createjs.Sound.alternateExtensions = ["mp3"];
createjs.Sound.registerSound({src:"path/to/sound.ogg", id:"sound"});
function handleLoadComplete(event) {
createjs.Sound.play("sound");
}
```
## License
Built by gskinner.com, and released for free under the MIT license, which means you can use it for almost any purpose
(including commercial projects). We appreciate credit where possible, but it is not a requirement.
## Support and Resources
* Find examples and more information at the [SoundJS web site](http://soundjs.com/)
* Read the [documentation](http://createjs.com/docs/soundjs/)
* Discuss, share projects, and interact with other users on [reddit](http://www.reddit.com/r/createjs/).
* Ask technical questions on [Stack Overflow](http://stackoverflow.com/questions/tagged/soundjs).
* File verified bugs or formal feature requests using Issues on [GitHub](https://github.com/CreateJS/SoundJS/issues).
* Have a look at the included [examples](https://github.com/CreateJS/SoundJS/tree/master/examples) and
[API documentation](http://createjs.com/docs/soundjs/) for more in-depth information.
## Classes
### [Sound](http://createjs.com/Docs/SoundJS/classes/Sound.html)
The core API for playing sounds. Call createjs.Sound.play(sound, ...options), and a sound instance is created that can be
used to control the audio, and dispatches events when it is complete, loops, or is interrupted.
### [SoundInstance](http://createjs.com/Docs/SoundJS/classes/AbstractSoundInstance.html)
A controllable sound object that wraps the actual plugin implementation, providing a consistent API for audio playback,
no matter what happens in the background. Sound instances can be paused, muted, and stopped; and the volume, pan (where
available), and position changed using the simple API.
### [WebAudioPlugin](http://createjs.com/Docs/SoundJS/classes/WebAudioPlugin.html)
The default, built-in plugin, which uses Web Audio APIs to playback sounds. Note that WebAudio will fail to load when
run locally, and the HTML audio plugin will be used instead.
### [HTMLAudioPlugin](http://createjs.com/Docs/SoundJS/classes/HTMLAudioPlugin.html)
The fallback built-in plugin, which manages audio playback via the HTML5 tag. This will be used in instances
where the WebAudio plugin is not available.
### [CordovaAudioPlugin](http://createjs.com/docs/soundjs/classes/CordovaAudioPlugin.html)
An additional plugin which will playback audio in a Cordova app and tools that utilize Cordova such as PhoneGap or Ionic.
You must manually register this plugin. Currently available on github since SoundJS-0.6.1.
### [FlashAudioPlugin](http://createjs.com/Docs/SoundJS/classes/FlashAudioPlugin.html)
An additional plugin which uses a flash shim (and SWFObject) to playback audio using Flash. You must manually set up and
register this plugin.
## [Documentation and examples](http://createjs.com/docs/soundjs/)
Have a look at the included examples and API documentation for more in-depth information.