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 the
length
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).
- The size of the audio buffer in sample-frames. To determine the
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 APIThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
AudioBuffer() constructor
|
Chrome Full support 55 Full support 55 Notes' The |
Edge
Full support 79 |
Firefox
Full support 53 |
IE
No support No |
Opera Full support 42 Full support 42 Notes' The |
Safari
No support No |
WebView Android Full support 55 Full support 55 Notes' The |
Chrome Android Full support 55 Full support 55 Notes' The |
Firefox Android
Full support 53 |
Opera Android Full support 42 Full support 42 Notes' The |
Safari iOS
No support No |
Samsung Internet Android Full support 6.0 Full support 6.0 Notes' The |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.'
- See implementation notes.
AudioBuffer() by Mozilla Contributors is licensed under CC-BY-SA 2.5.