Audia

Audia reimplements and extends the HTML5 Audio object using the Web Audio API.

Benefits

• Future-proof

• Fails gracefully

• Consistent API with HTML5 Audio which you probably already know

• Fixes bugs in some Audio implementations

• Implementation of Audio is weak across the board. Even in the best browers

• this is future-proof. you get Audio which is the best you can get for now, then later down the road you get web audio api

• and seriously, you'll need a wrapper for WAI anyway

A complete write-up on this project can be found on the Lost Decade Games blog.

API Documentation

Everything is identical to the HTML5 Audio spec. Anything not working as it should? File an issue! :)

In fact in many cases Audia is BETTER than the browser's native Audio implementation, even if it doesn't also support Web Audio API.

Global Audia object

TODO: Provide thin wrappers around the base code.

• Audia (global object)

• version: String The version of Audia being run. (Example: "0.1.0")

• canPlayType: you can pass in mp3, ogg (helpers since normally it wants audio/ogg audio/mp3)

Gimme some sugar baby

Audia also has the below API. If any of the below functionality is not supported by the client, Audia will fail silently.

Audia instances

Example: var sound = new Audia();

Properties

Each Audia instance has the following properties:

• currentTime: Number The playback point of the sound (in seconds).
• duration: Number The length of the current sound buffer in seconds. (Read-only)
• loop: Boolean If set to true, the audio will play again when it reaches the end of playback. (default: false)
• muted: Boolean True if the sound has been muted, otherwise false.
• paused: Boolean True if the sound is paused, false if it's playing. (Read-only)
• src: String The URL of a sound file to load.
• volume: Number The volume of the playback where 0 is muted and 1 is normal volume. (arbitrary maximum = 10), (default: 1)
• onended: Function Gets called when playback reaches the end of the buffer.
• onload: Function Gets called when a sound file (requested by setting src) is done loading.

* The italicized properties are only available if the client supports Web Audio API (otherwise they fail silently).

Methods

• play: Begins playback of the sound buffer. Arguments: currentTime (optional) Sets the currentTime property before playing.
• pause: Pauses sound playback (retaining currentTime).
• stop: Stops sound playback (resetting currentTime to 0). // TODO: it's actually .muted (Boolean)
• mute: Silences playback of the sound buffer.
• unmute: Restores audible playback of the sound buffer.

Examples

Create a sound object and play an mp3

var sound = new Audia();
sound.src = "onslaught.mp3";
sound.play();

Create sounds with some sugar

var backgroundMusic = new Audia("joshua_morse.mp3");
var battleMusic = new Audia({
	src: "a_recurring_conflict.mp3",
	loop: true
});

Move the playback pointer to 30 seconds into the sound buffer

sound.currentTime = 30;

Calculate the percentage of song that's played

var percentage = (sound.currentTime / sound.duration) * 100;

Stop it if it's playing

if (sound.playing) {
	sound.stop();
}

Play it when it loads

sound.onload = function () {
	doSomething();
};
sound.src = "new_song.mp3";