2 * Copyright (C) 2010, Google Inc. All rights reserved.
3 * Copyright (C) 2011 Apple Inc. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY
15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
17 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY
18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
21 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
23 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 WillBeGarbageCollected,
29 Conditional=WEB_AUDIO,
31 ConstructorCallWith=Document,
33 RaisesException=Constructor,
34 ] interface AudioContext : EventTarget {
36 // All rendered audio ultimately connects to destination, which represents the audio hardware.
37 readonly attribute AudioDestinationNode destination;
39 // All scheduled times are relative to this time in seconds.
40 readonly attribute double currentTime;
42 // All AudioNodes in the context run at this sample-rate (sample-frames per second).
43 readonly attribute float sampleRate;
45 // All panning is relative to this listener.
46 readonly attribute AudioListener listener;
48 [RaisesException] AudioBuffer createBuffer(unsigned long numberOfChannels, unsigned long numberOfFrames, float sampleRate);
50 // Asynchronous audio file data decoding.
51 [RaisesException] void decodeAudioData(ArrayBuffer audioData, AudioBufferCallback successCallback, optional AudioBufferCallback errorCallback);
54 AudioBufferSourceNode createBufferSource();
56 [RaisesException] MediaElementAudioSourceNode createMediaElementSource(HTMLMediaElement mediaElement);
58 [RaisesException] MediaStreamAudioSourceNode createMediaStreamSource(MediaStream mediaStream);
59 MediaStreamAudioDestinationNode createMediaStreamDestination();
62 GainNode createGain();
63 [RaisesException] DelayNode createDelay(optional double maxDelayTime);
64 BiquadFilterNode createBiquadFilter();
65 WaveShaperNode createWaveShaper();
66 PannerNode createPanner();
67 ConvolverNode createConvolver();
68 DynamicsCompressorNode createDynamicsCompressor();
69 AnalyserNode createAnalyser();
70 [RaisesException] ScriptProcessorNode createScriptProcessor(optional unsigned long bufferSize, optional unsigned long numberOfInputChannels, optional unsigned long numberOfOutputChannels);
71 OscillatorNode createOscillator();
72 [RaisesException] PeriodicWave createPeriodicWave(Float32Array real, Float32Array imag);
74 // Channel splitting and merging
75 [RaisesException] ChannelSplitterNode createChannelSplitter(optional unsigned long numberOfOutputs);
76 [RaisesException] ChannelMergerNode createChannelMerger(optional unsigned long numberOfInputs);
79 // void prepareOfflineBufferRendering(unsigned long numberOfChannels, unsigned long numberOfFrames, float sampleRate);
80 attribute EventHandler oncomplete;
81 void startRendering();