BaseAudioContext
接口在
Web 音频 API
acts as a base definition for online and offline audio-processing graphs, as represented by
AudioContext
and
OfflineAudioContext
分别。
You wouldn't use
BaseAudioContext
directly — you'd use its features via one of these two inheriting interfaces.
A
BaseAudioContext
can be a target of events, therefore it implements the
EventTarget
接口。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/BaseAudioContext" target="_top"><rect x="151" y="1" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="231" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">BaseAudioContext</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
BaseAudioContext.audioWorklet
只读
安全上下文
AudioWorklet
object, which can be used to create and manage
AudioNode
s in which JavaScript code implementing the
AudioWorkletProcessor
interface are run in the background to process audio data.
BaseAudioContext.currentTime
只读
0
.
BaseAudioContext.destination
只读
AudioDestinationNode
representing the final destination of all audio in the context. It can be thought of as the audio-rendering device.
BaseAudioContext.listener
只读
AudioListener
object, used for 3D spatialization.
BaseAudioContext.sampleRate
只读
AudioContext
cannot be changed.
BaseAudioContext.state
只读
AudioContext
.
BaseAudioContext.onstatechange
statechange
has fired. This occurs when the
AudioContext
's state changes, due to the calling of one of the state change methods (
AudioContext.suspend
,
AudioContext.resume
,或
AudioContext.close
).
Also implements methods from the interface
EventTarget
.
BaseAudioContext.createAnalyser()
AnalyserNode
, which can be used to expose audio time and frequency data and for example to create data visualisations.
BaseAudioContext.createBiquadFilter()
BiquadFilterNode
, which represents a second order filter configurable as several different common filter types: high-pass, low-pass, band-pass, etc
BaseAudioContext.createBuffer()
AudioBuffer
object, which can then be populated by data and played via an
AudioBufferSourceNode
.
BaseAudioContext.createBufferSource()
AudioBufferSourceNode
, which can be used to play and manipulate audio data contained within an
AudioBuffer
对象。
AudioBuffer
s are created using
AudioContext.createBuffer
or returned by
AudioContext.decodeAudioData
when it successfully decodes an audio track.
BaseAudioContext.createConstantSource()
ConstantSourceNode
object, which is an audio source that continuously outputs a monaural (one-channel) sound signal whose samples all have the same value.
BaseAudioContext.createChannelMerger()
ChannelMergerNode
, which is used to combine channels from multiple audio streams into a single audio stream.
BaseAudioContext.createChannelSplitter()
ChannelSplitterNode
, which is used to access the individual channels of an audio stream and process them separately.
BaseAudioContext.createConvolver()
ConvolverNode
, which can be used to apply convolution effects to your audio graph, for example a reverberation effect.
BaseAudioContext.createDelay()
DelayNode
, which is used to delay the incoming audio signal by a certain amount. This node is also useful to create feedback loops in a Web Audio API graph.
BaseAudioContext.createDynamicsCompressor()
DynamicsCompressorNode
, which can be used to apply acoustic compression to an audio signal.
BaseAudioContext.createGain()
GainNode
, which can be used to control the overall volume of the audio graph.
BaseAudioContext.createIIRFilter()
IIRFilterNode
, which represents a second order filter configurable as several different common filter types.
BaseAudioContext.createOscillator()
OscillatorNode
, a source representing a periodic waveform. It basically generates a tone.
BaseAudioContext.createPanner()
PannerNode
, which is used to spatialise an incoming audio stream in 3D space.
BaseAudioContext.createPeriodicWave()
PeriodicWave
, used to define a periodic waveform that can be used to determine the output of an
OscillatorNode
.
BaseAudioContext.createScriptProcessor()
ScriptProcessorNode
, which can be used for direct audio processing via JavaScript.
BaseAudioContext.createStereoPanner()
StereoPannerNode
, which can be used to apply stereo panning to an audio source.
BaseAudioContext.createWaveShaper()
WaveShaperNode
, which is used to implement non-linear distortion effects.
BaseAudioContext.decodeAudioData()
ArrayBuffer
. In this case, the ArrayBuffer is usually loaded from an
XMLHttpRequest
's
response
attribute after setting the
responseType
to
arraybuffer
. This method only works on complete files, not fragments of audio files.
Basic audio context declaration:
const audioContext = new AudioContext();
Cross browser variant:
const AudioContext = window.AudioContext || window.webkitAudioContext; const audioContext = new AudioContext(); const oscillatorNode = audioContext.createOscillator(); const gainNode = audioContext.createGain(); const finish = audioContext.destination;
| 规范 | 状态 | 注释 |
|---|---|---|
|
Web 音频 API
The definition of 'BaseAudioContext' in that specification. |
工作草案 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
BaseAudioContext
|
Chrome Yes | Edge ≤18 | Firefox 53 | IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android Yes | Firefox Android 53 |
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android Yes |
audioWorklet
|
Chrome 66 | Edge 79 | Firefox ? | IE 不支持 No | Opera Yes | Safari 不支持 No | WebView Android 66 | Chrome Android 66 | Firefox Android ? | Opera Android Yes | Safari iOS 不支持 No | Samsung Internet Android 9.0 |
createAnalyser
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createBiquadFilter
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createBuffer
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createBufferSource
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createChannelMerger
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createChannelSplitter
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createConstantSource
|
Chrome 56 | Edge ≤79 | Firefox 53 | IE 不支持 No | Opera 43 | Safari 不支持 No | WebView Android 56 | Chrome Android 56 | Firefox Android 53 | Opera Android 43 | Safari iOS 不支持 No | Samsung Internet Android 6.0 |
createConvolver
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createDelay
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createDynamicsCompressor
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createGain
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createIIRFilter
|
Chrome 49 | Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No | Opera Yes | Safari 不支持 No | WebView Android 49 | Chrome Android 49 |
Firefox Android
53
注意事项
|
Opera Android Yes | Safari iOS 不支持 No | Samsung Internet Android 5.0 |
createOscillator
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createPanner
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createPeriodicWave
|
Chrome
59
注意事项
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android
59
注意事项
|
Chrome Android
59
注意事项
|
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android
7.0
注意事项
|
createScriptProcessor
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
createStereoPanner
|
Chrome 42 | Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android Yes | Chrome Android Yes |
Firefox Android
53
注意事项
|
Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android Yes |
createWaveShaper
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
currentTime
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
decodeAudioData
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
destination
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
listener
|
Chrome
10
Prefixed
|
Edge ≤18 | Firefox 53 | IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 | Firefox Android 53 |
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
onstatechange
|
Chrome 43 | Edge ≤79 |
Firefox
53
注意事项
|
IE 不支持 No | Opera Yes |
Safari
9
Prefixed
|
WebView Android Yes | Chrome Android Yes |
Firefox Android
53
注意事项
|
Opera Android Yes |
Safari iOS
9
Prefixed
|
Samsung Internet Android Yes |
sampleRate
|
Chrome
10
Prefixed
|
Edge ≤18 |
Firefox
53
注意事项
|
IE 不支持 No |
Opera
22
|
Safari
6
Prefixed
|
WebView Android Yes | Chrome Android 33 |
Firefox Android
53
注意事项
|
Opera Android
22
|
Safari iOS
6
Prefixed
|
Samsung Internet Android 2.0 |
state
|
Chrome 43 | Edge ≤79 |
Firefox
53
注意事项
|
IE 不支持 No | Opera Yes |
Safari
9
Prefixed
|
WebView Android Yes | Chrome Android Yes |
Firefox Android
53
注意事项
|
Opera Android Yes |
Safari iOS
9
Prefixed
|
Samsung Internet Android Yes |
完整支持
不支持
兼容性未知
实验。期望将来行为有所改变。
见实现注意事项。
要求使用供应商前缀或不同名称。
BaseAudioContext
createAnalyser()
createBiquadFilter()
createBuffer()
createBufferSource()
createChannelMerger()
createChannelSplitter()
createConstantSource()
createConvolver()
createDelay()
createDynamicsCompressor()
createGain()
createIIRFilter()
createOscillator()
createPanner()
createPeriodicWave()
createScriptProcessor()
createStereoPanner()
createWaveShaper()
decodeAudioData()
AnalyserNode
AudioBuffer
AudioBufferSourceNode
AudioContext
AudioContextOptions
AudioDestinationNode
AudioListener
AudioNode
AudioNodeOptions
AudioParam
AudioProcessingEvent
AudioScheduledSourceNode
AudioWorklet
AudioWorkletGlobalScope
AudioWorkletNode
AudioWorkletProcessor
BiquadFilterNode
ChannelMergerNode
ChannelSplitterNode
ConstantSourceNode
ConvolverNode
DelayNode
DynamicsCompressorNode
GainNode
IIRFilterNode
MediaElementAudioSourceNode
MediaStreamAudioDestinationNode
MediaStreamAudioSourceNode
OfflineAudioCompletionEvent
OfflineAudioContext
OscillatorNode
PannerNode
PeriodicWave
StereoPannerNode
WaveShaperNode