User:Corban/AudioAPI

Defining an Enhanced API for Audio

The HTML5 specification introduces the audio and video media elements, and with them the opportunity to dramatically change the way we integrate media on the web. The current API provides ways to play and get limited information about audio and video, but gives no way to programatically access or create such media. We present a new API for these media elements which allows web developers to read and write raw audio data.

Current Implemention

David Humphrey has developed a proof of concept, experimental build of Firefox which implements the following basic API:

onaudiowritten="callback(event);"

<audio src="song.ogg" onaudiowritten="audioWritten(event);"></audio>

mozFrameBuffer

var samples = [];

function audioWritten(event) {
  samples = event.mozFrameBuffer;
}

mozSpectrum

var spectrum = [];

function audioWritten(event) {
  spectrum = event.mozSpectrum;
}

mozSetup(channels, sampleRate, volume)

var audioOutput = document.getElementById('audio-element');
audioOutput.mozSetup(2, 44100, 1);

mozAudioWrite(length, buffer)

var samples = [0.242, 0.127, 0.0, -0.058, -0.242, ...];
audioOutput.mozAudioWrite(samples.length, samples);

Audio API (DRAFT)

Authors

• David Humphrey
• Corban Brook