The AudioBuffer
constructor of the Web Audio API creates a new AudioBuffer
object.
Syntax
var audioBuffer = new AudioBuffer(options);
Parameters
Inherits parameters from the AudioNodeOptions
dictionary.
options
- Options are as follows:
length
: The size of the audio buffer in sample-frames. To determine thelength
to use for a specific number of seconds of audio, usenumSeconds * sampleRate
.numberOfChannels
: The number of channels for the buffer. The default is 1, and all user agents are required to support at least 32 channels.sampleRate
: The sample rate in Hz for the buffer. The default is the sample rate of thecontext
used in constructing this object. User agents are required to support sample rates from 8,000 Hz to 96,000 Hz (but are allowed to go farther outside this range).
Deprecated parameters
context
- A reference to an
AudioContext
. This parameter was removed from the spec.
Return value
A new AudioBuffer
object instance.
Exceptions
NotSupportedError
- One or more of the options are negative or otherwise has an invalid value (such as
numberOfChannels
being higher than supported, or asampleRate
outside the nominal range). RangeError
- There isn't enough memory available to allocate the buffer.
Specifications
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'AudioBuffer' in that specification. |
Working Draft | Initial definition. |
Browser Compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
AudioBuffer() constructor | Chrome
Full support
55
| Edge Full support ≤79 | Firefox Full support 53 | IE No support No | Opera
Full support
42
| Safari ? | WebView Android
Full support
55
| Chrome Android
Full support
55
| Firefox Android Full support 53 | Opera Android
Full support
42
| Safari iOS ? | Samsung Internet Android
Full support
6.0
|
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.