SoundJS

SoundJS simplifies the job of working with the HTML5 <audio> tag, which may look and be very useful, but is often an ordeal when working with.

The library exposes a simple API for working with audio files on a live Web page, an API which provides tools for channel management, audio file loading, batch operations, volume control, and various other sound & playback-related features.

SoundJS doesn't do anything special, but merely provides an uniform set of tools for working with sounds on the Web across multiple platforms, devices, and browsers.

It's role is to stabilize audio playback and manipulation operations across the ever-changing browser and standards landscape.

A Flash fallback mechanism for older browsers is packed with SoundJS as a protective measure.

Examples and usage instructions are included with the download package.

What is new in this release:

• New class and inheritance model
• Added getter/setters throughout
• Refactor to utilize PreloadJS classes for internal preloading
• Added Audio Sprite support
• Lots of bug fixes and updates

What is new in version 0.6.0:

• New class and inheritance model
• Added getter/setters throughout
• Refactor to utilize PreloadJS classes for internal preloading
• Added Audio Sprite support
• Lots of bug fixes and updates

What is new in version 0.5.2:

• Fixed a bug with default SoundInstance, it did not have playFailed function that is called by Sound
• fixed a bug that prevented interrupt value from being read in play call if it was passed in an object
• Changed SoundInstance to extend createjs.EventDispatcher rather than mix in
• Alterations to basePath approach that require full src (basePath + src) in create and play calls
• Include basePath in removeSound and removeManifest, which is now required if it was included in loading
• Introduced createjs.Sound.alternateExtensions, which is replacing a delimited list as a means to load alternate file types
• Deprecated "|" approach to alternate files, in favor of class level alternateExtensions approach
• Deprecated registerPlugin in favor of registerPlugins with a single argument
• Deprecated FlashPlugin BASE_PATH in favor swfPath
• Added console logs deprecated calls above are used
• Added willTrigger() method to EventDispatcher

What is new in version 0.5.1:

• Suppressing errors in WebAudioPlugin and HTMLAudioPlugin in old browsers that do not properly support object.defineProperty
• Changes to WebAudioPlugin to allow it to work with lasted working draft of Web Audio API
• WebAudioPlugin changed SoundInstance node order to SourceNode -> PanNode -> GainNode --> context.destination to get around Firefox bug

What is new in version 0.5.0:

• Altered all libraries to use defined object properties instead of object literal notation.
• Namespaced all sub apis to related plugin, ie createjs.WebAudioPlugin.SoundInstance.
• Implemented createjs Utils.
• Implemented "use strict" mode.
• Removed deprecated methods and properties, doc'd as removed.
• Updated WebAudioPlugin to handle new calls and deprecated calls.
• Added enableIOS property to HTMLAudioPlugin,allowing advanced users to enable HTMLAudioPlugin on iOS (not recommended).
• Overloaded play call in Sound and SoundInstance to allow options to be passed in as an object, ie play("music", {loop: -1, volume: 0.5}).
• Changed WebAudioPlugin to test if XHR is available for local files rather than assuming it is not.
• Implement basePath support for local loading and with PreloadJS.
• Updated registerSound and registerManifest to return true if a source has already been loaded.
• Added getter/setter to volume and pan of SoundInstance, to allow tweening.

What is new in version 0.4.1:

• Added removeSound, removeManifest, and removeAllSounds functions to Sound, to enable unloading of sounds.
• Added MobileSafe demo to show launching an "app" inside a touch event, enabling audio playback on mobile devices
• Added playEmptySound() method, which facilitates playback on mobile devices without user interaction
• HTMLAudioPlugin now using tag loop property to provide more reliable looping
• WebAudioPlugin added a look ahead approach to enable smooth looping

What is new in version 0.4.0:

• Added sound registration and manifest registration allowing simple internal preloading, so Sounds can preload and play
• without PreloadJS. This includes callback and EventDispatch as files load.
• Added default behavior to load src when play is called if src has not been registered or preloaded
• Removed global pause/resume
• Removed global setMasterVolume, in place of SoundJS.setVolume(), which is now global volume
• Added global volume/mute methods on plugins, can be used in place of setting properties of all instances and exist
• independent of those same properties on instances
• Added proper global mute, which affects sounds globally, instead of just applying mute to sounds
• Changed mute() to getMute() and setMute() on SoundJS and SoundInstances
• Removed id-based lookup
• Revised plugin approach, and simplified internal APIs
• Added EventDispatcher functionality to SoundJS and SoundInstance
• Added onSuccess callback and success event to SoundInstance to report successful play.
• Official WebAudio support via the new WebAudioPlugin, which is now the default audio handler
• Added create() method on SoundJS, which can be used to create a stopped sound
• Changed setPosition() method on SoundInstance so it is available on stopped instances
• Changed getDuration() method on SoundInstance so it returns the duration of stopped instances, instead of 0
• Changed default values set when SoundJS.play is called so instances retain position, volume, and pan unless explicitly
• changed
• Replaced proxy on Sound with a proxy on createjs namespace, createjs.proxy(method, scope, args*);
• Fixed issue to how delay was handled in SoundInstance so it will not fire if pause() or stop() is called before
• playback begins
• Fixed issues with indexOf that were sometimes preventing stop/mute, etc.
• Fixed issue with initial mute state in FlashPlugin
• Fixed an issue in FlashPlugin that caused getDuration to always return 0
• Fixed an issue in FlashPlugin that would cause a looping sound to loop from the same point it was paused from or set
• position to
• Fixed loop callback in FlashPlugin SoundInstance (previously it would not be called).
• Fixed an issue with FlashPlugin in IE that caused a race condition due to caching, which would stop it from working
• sometimes
• Fixed an issue with FlashPlugin that would cause a paused instance, once resumed, to not fire onComplete callback.
• Fixed an issue in HTMLAudioPlugin that caused it to incorrectly return isSupported as true when it should be false
• Better documentation throughout
• Improved examples

What is new in version 0.3.0:

• Moved all classes into a configurable createjs namespace
• Added better support for missing sounds. SoundJS returns a lightweight instance that won't fail when calls are made on it.
• Added static mute/unmute methods to independently control a global mute property.
• Added support for preloading WAV files
• Fixed flash preload support when in tag mode
• Added lightweight flash instance, which is code only
• Added a debug flag [showOutput] to FlashPlugin, which will log Flash Activity
• Fixed issue with canPlayType throwing runtime in non-supported browsers.

What is new in version 0.2.0:

• This version includes a target plugin model that abstracts audio playback to various plugins, which can be prioritized.
• Other updates include controllable sound instances, which are returned when a sound is played, providing a much easier way to control audio once it has started playback.

What is new in version 0.1:

• First official alpha release of SoundJS.

Requirements:

• JavaScript enabled on client side