Web 音频 API

简介

到目前为止，网页上的音频技术一直比较原始，直到最近还需要通过像 Flash 和 QuickTime 这样的插件来提供音频服务。HTML5中引入的audio元素非常重要，它允许基本的流媒体音频播放。但它的功能不足以处理更复杂的音频应用程序。对于复杂的基于网页的游戏或交互式应用程序，需要另一种解决方案。本规范的目标之一是包括现代游戏音频引擎中的功能，以及现代桌面音频制作应用程序中的一些混音、处理和滤波任务。

这些API设计时考虑了[webaudio-usecases]中广泛的用例。理想情况下，它应该能够支持任何可以合理地用优化的C++引擎通过脚本控制并在浏览器中运行的用例。话虽如此，现代桌面音频软件可以具有非常先进的功能，其中一些功能使用此系统构建可能会很困难甚至不可能。Apple的Logic Audio就是这样一个应用程序，它支持外部MIDI控制器、任意插件音频效果和合成器、高度优化的直接到磁盘的音频文件读/写、紧密集成的时间拉伸等等。尽管如此，所提出的系统将能够支持一大范围的相对复杂的游戏和交互式应用程序，包括音乐类的。而且它可以很好地补充WebGL提供的更高级的图形功能。API的设计使得以后可以添加更高级的功能。

功能

API支持以下主要功能：

• 模块化路由，用于简单或复杂的混音/效果架构。

• 高动态范围，使用32位浮点数进行内部处理。

• 采样精确的计划声音播放，具有低延迟，适用于需要高度节奏精度的音乐应用程序，如鼓机和音序器。这还包括动态创建效果的可能性。

• 自动化音频参数，用于包络、渐入/渐出、粒状效果、滤波器扫频、低频振荡器(LFO)等。

• 灵活处理音频流中的通道，允许它们拆分和合并。

• 处理来自audio或video 媒体元素的音频源。

• 使用MediaStream处理实时音频输入，使用getUserMedia()。

• 与WebRTC集成

  • 使用MediaStreamTrackAudioSourceNode处理从远程对等方接收的音频，并使用[webrtc]。

  • 使用MediaStreamAudioDestinationNode发送生成或处理的音频流到远程对等方，并使用[webrtc]。

• 直接使用脚本进行音频流合成和处理。

• 空间化音频，支持广泛的3D游戏和沉浸式环境：

  • 声像模型：equalpower, HRTF, 直通

  • 距离衰减

  • 声锥

  • 障碍/遮挡

  • 基于源/听者的

• 卷积引擎，用于广泛的线性效果，特别是高质量的房间效果。以下是一些可能的效果示例：

  • 小房间/大房间

  • 大教堂

  • 音乐厅

  • 洞穴

  • 隧道

  • 走廊

  • 森林

  • 露天剧场

  • 通过门口传来的远处房间的声音

  • 极端滤波效果

  • 奇怪的倒放效果

  • 极端梳状滤波效果

• 动态压缩，用于整体控制和改善混音。

• 高效的实时时域和频域分析/音乐可视化支持。

• 高效的双二阶滤波器，用于低通、高通等常见滤波器。

• 波形整形效果，用于失真和其他非线性效果。

• 振荡器。

模块化路由

模块化路由允许不同AudioNode对象之间进行任意连接。每个节点可以有输入和/或输出。源节点没有输入，只有一个输出。目标节点有一个输入，没有输出。其他节点，如滤波器，可以放置在源节点和目标节点之间。当两个对象连接在一起时，开发人员不需要担心低级流格式细节；正确的事情自然会发生。例如，如果将单声道音频流连接到立体声输入，它应该只是适当地混合到左右声道。

在最简单的情况下，单个源可以直接路由到输出。所有路由都在包含单个AudioDestinationNode的AudioContext中进行：

为了说明这种简单的路由，以下是播放单个声音的简单示例：

const context = new AudioContext();
        
        function playSound() {
          const source = context.createBufferSource();
          source.buffer = dogBarkingBuffer;
          source.connect(context.destination);
          source.start(0);
        }

这是一个更复杂的示例，包含三个源和一个卷积混响发送，以及最终输出阶段的动态压缩器：

let context;let compressor;let reverb;let source1, source2, source3;let lowpassFilter;let waveShaper;let panner;let dry1, dry2, dry3;let wet1, wet2, wet3;let mainDry;let mainWet;function setupRoutingGraph () {  context = new AudioContext();  // 创建效果节点。  lowpassFilter = context.createBiquadFilter();  waveShaper = context.createWaveShaper();  panner = context.createPanner();  compressor = context.createDynamicsCompressor();  reverb = context.createConvolver();  // 创建主干燥和湿。  mainDry = context.createGain();  mainWet = context.createGain();  // 将最终压缩器连接到最终目的地。  compressor.connect(context.destination);  // 将主干燥和湿连接到压缩器。  mainDry.connect(compressor);  mainWet.connect(compressor);  // 将混响连接到主湿。  reverb.connect(mainWet);  // 创建几个源。  source1 = context.createBufferSource();  source2 = context.createBufferSource();  source3 = context.createOscillator();  source1.buffer = manTalkingBuffer;  source2.buffer = footstepsBuffer;  source3.frequency.value = 440;  // 连接source1  dry1 = context.createGain();  wet1 = context.createGain();  source1.connect(lowpassFilter);  lowpassFilter.connect(dry1);  lowpassFilter.connect(wet1);  dry1.connect(mainDry);  wet1.connect(reverb);  // 连接source2  dry2 = context.createGain();  wet2 = context.createGain();  source2.connect(waveShaper);  waveShaper.connect(dry2);  waveShaper.connect(wet2);  dry2.connect(mainDry);  wet2.connect(reverb);  // 连接source3  dry3 = context.createGain();  wet3 = context.createGain();  source3.connect(panner);  panner.connect(dry3);  panner.connect(wet3);  dry3.connect(mainDry);  wet3.connect(reverb);  // 现在启动源。  source1.start(0);  source2.start(0);  source3.start(0);}

模块化路由还允许将AudioNode的输出路由到控制另一个AudioNode行为的AudioParam参数。在这种情况下，节点的输出可以作为调制信号而不是输入信号。

function setupRoutingGraph() {  const context = new AudioContext();  // 创建提供调制信号的低频振荡器  const lfo = context.createOscillator();  lfo.frequency.value = 1.0;  // 创建要被调制的高频振荡器  const hfo = context.createOscillator();  hfo.frequency.value = 440.0;  // 创建一个增益节点，其增益决定调制信号的幅度  const modulationGain = context.createGain();  modulationGain.gain.value = 50;  // 配置图并启动振荡器  lfo.connect(modulationGain);  modulationGain.connect(hfo.detune);  hfo.connect(context.destination);  hfo.start(0);  lfo.start(0);}

API概述

定义的接口有：

• AudioContext接口，包含一个音频信号图，表示AudioNode之间的连接。

• AudioNode接口，表示音频源、音频输出和中间处理模块。AudioNode可以在AudioContext的上下文中模块化方式动态连接在一起。

• AnalyserNode接口，AudioNode用于音乐可视化器或其他可视化应用。

• AudioBuffer接口，用于处理驻留在内存中的音频资产。这些可以表示一次性声音或较长的音频片段。

• AudioBufferSourceNode接口，AudioNode生成来自AudioBuffer的音频。

• AudioDestinationNode接口，AudioNode子类，表示所有渲染音频的最终目的地。

• AudioParam接口，用于控制AudioNode功能的单个方面，例如音量。

• AudioListener接口，与PannerNode一起工作，实现空间化。

• AudioWorklet接口，表示用于使用脚本直接处理音频的自定义节点工厂。

• AudioWorkletGlobalScope接口，AudioWorkletProcessor处理脚本运行的上下文。

• AudioWorkletNode接口，AudioNode表示在AudioWorkletProcessor中处理的节点。

• AudioWorkletProcessor接口，表示音频工作者内的单个节点实例。

• BiquadFilterNode接口，AudioNode用于常见的低阶滤波器，例如：

  • 低通

  • 高通

  • 带通

  • 低架

  • 高架

  • 峰值

  • 陷波

  • 全通

• ChannelMergerNode接口，AudioNode用于将多个音频流的通道合并为单个音频流。

• ChannelSplitterNode接口，AudioNode用于在路由图中访问音频流的各个通道。

• ConstantSourceNode接口，AudioNode用于生成名义上恒定的输出值，并带有AudioParam，以允许自动化该值。

• ConvolverNode接口，AudioNode用于应用实时线性效果（如音乐厅的声音）。

• DelayNode接口，AudioNode用于施加动态可调的可变延迟。

• DynamicsCompressorNode接口，AudioNode用于动态压缩。

• GainNode接口，AudioNode用于显式增益控制。

• IIRFilterNode接口，AudioNode用于通用IIR滤波器。

• MediaElementAudioSourceNode接口，AudioNode用于作为音频源的audio、video或其他媒体元素。

• MediaStreamAudioSourceNode接口，AudioNode用于来自MediaStream的音频源，如实时音频输入或来自远程对等方的音频。

• MediaStreamTrackAudioSourceNode接口，AudioNode用于来自MediaStreamTrack的音频源。

• MediaStreamAudioDestinationNode接口，AudioNode用于作为MediaStream发送到远程对等方的音频目的地。

• PannerNode接口，AudioNode用于在3D空间中实现音频的空间化/定位。

• PeriodicWave接口，用于通过OscillatorNode指定自定义周期波形。

• OscillatorNode接口，AudioNode用于生成周期波形。

• StereoPannerNode接口，AudioNode用于在立体声流中均匀定位音频输入。

• WaveShaperNode接口，AudioNode用于应用非线性波形整形效果，用于失真和其他更微妙的增暖效果。

Web Audio API中还有几个功能已被弃用但尚未删除，正在等待其替代方案的实施经验：

• ScriptProcessorNode接口，AudioNode用于通过脚本直接生成或处理音频。

• AudioProcessingEvent接口，这是一种与ScriptProcessorNode对象一起使用的事件类型。

1. 音频API

1.1. BaseAudioContext 接口

此接口表示一组AudioNode 对象及其连接。它允许将信号任意路由到AudioDestinationNode。 节点由上下文创建，然后连接在一起。

BaseAudioContext 不能直接实例化，而是由具体接口AudioContext （用于实时渲染）和OfflineAudioContext （用于离线渲染）扩展。

每个BaseAudioContext 都创建了一个内部槽位[[pending promises]]，这是一个最初为空的承诺的有序列表。

每个BaseAudioContext 都有一个唯一的 媒体元素事件任务源。 此外，BaseAudioContext 还有两个私有槽位[[rendering thread state]]和 [[control thread state]]， 它们的值来自AudioContextState， 并且它们最初都设置为"suspended"。

enum AudioContextState {
  "suspended",
  "running",
  "closed"
};

callback DecodeErrorCallback = undefined (DOMException error);

callback DecodeSuccessCallback = undefined (AudioBuffer decodedData);

[Exposed=Window]
interface BaseAudioContext : EventTarget {
  readonly attribute AudioDestinationNode destination;
  readonly attribute float sampleRate;
  readonly attribute double currentTime;
  readonly attribute AudioListener listener;
  readonly attribute AudioContextState state;
  [SameObject, SecureContext]
  readonly attribute AudioWorklet audioWorklet;
  attribute EventHandler onstatechange;

  AnalyserNode createAnalyser ();
  BiquadFilterNode createBiquadFilter ();
  AudioBuffer createBuffer (unsigned long numberOfChannels,
                            unsigned long length,
                            float sampleRate);
  AudioBufferSourceNode createBufferSource ();
  ChannelMergerNode createChannelMerger (optional unsigned long numberOfInputs = 6);
  ChannelSplitterNode createChannelSplitter (
    optional unsigned long numberOfOutputs = 6);
  ConstantSourceNode createConstantSource ();
  ConvolverNode createConvolver ();
  DelayNode createDelay (optional double maxDelayTime = 1.0);
  DynamicsCompressorNode createDynamicsCompressor ();
  GainNode createGain ();
  IIRFilterNode createIIRFilter (sequence<double> feedforward,
                                 sequence<double> feedback);
  OscillatorNode createOscillator ();
  PannerNode createPanner ();
  PeriodicWave createPeriodicWave (sequence<float> real,
                                   sequence<float> imag,
                                   optional PeriodicWaveConstraints constraints = {});
  ScriptProcessorNode createScriptProcessor(
    optional unsigned long bufferSize = 0,
    optional unsigned long numberOfInputChannels = 2,
    optional unsigned long numberOfOutputChannels = 2);
  StereoPannerNode createStereoPanner ();
  WaveShaperNode createWaveShaper ();

  Promise<AudioBuffer> decodeAudioData (
    ArrayBuffer audioData,
    optional DecodeSuccessCallback? successCallback,
    optional DecodeErrorCallback? errorCallback);
};

1.1.1. 属性

MDN

BaseAudioContext/audioWorklet

Firefox76+Safari不支持Chrome66+

---

Opera支持Edge79+

---

Edge（旧版）不支持IE不支持

---

Android版Firefox79+iOS版Safari不支持Android版Chrome66+Android WebView66+Samsung Internet9.0+Opera Mobile支持

audioWorklet, 类型为 AudioWorklet, 只读

允许访问 Worklet 对象，该对象可以通过 [HTML] 和 AudioWorklet 定义的算法导入包含 AudioWorkletProcessor 类定义的脚本。

✔MDN

BaseAudioContext/currentTime

所有现行引擎均支持。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge（旧版）12+IE不支持

---

Android版Firefox25+iOS版Safari6+Android版Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

currentTime, 类型为 double, 只读

这是最近由上下文的渲染图处理的音频块中紧跟最后一个采样帧的采样帧的时间（以秒为单位）。如果 上下文的渲染图尚未处理音频块，则 currentTime 的值为零。

在 currentTime 的时间坐标系中，零值对应于图形处理的第一个音频块中的第一个采样帧。在此系统中，流逝的时间对应于由 BaseAudioContext 生成的音频流的流逝时间， 可能不会与系统中的其他时钟同步。（对于 OfflineAudioContext， 由于流不会被任何设备主动播放，因此甚至没有接近实际时间的可能性。）

Web Audio API 中的所有预定时间都是相对于 currentTime 的值。

当 BaseAudioContext 处于 "running" 状态时， 此属性的值是单调递增的，并由渲染线程按固定增量更新，增量对应于一个 渲染量子。因此，对于正在运行的上下文，currentTime 随着系统处理音频块而稳步增加，并且始终表示下一个要处理的音频块的开始时间。它也是当前状态中任何计划更改可能生效的最早时间。

在控制线程上读取 currentTime 时，必须原子地读取。

✔MDN

BaseAudioContext/destination

所有现行引擎均支持。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge（旧版）12+IE不支持

---

Android版Firefox25+iOS版Safari6+Android版Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

destination, 类型为 AudioDestinationNode, 只读

带有单个输入的 AudioDestinationNode， 表示所有音频的最终目的地。通常这将代表实际的音频硬件。所有 AudioNode 正在渲染音频的节点将直接或间接连接到 destination。

✔MDN

BaseAudioContext/listener

所有现行引擎均支持。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge（旧版）12+IE不支持

---

Android版Firefox25+iOS版Safari6+Android版Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

listener, 类型为 AudioListener, 只读

一个用于 3D 空间化 的 AudioListener。

✔MDN

BaseAudioContext/onstatechange

所有现行引擎均支持。

Firefox40+Safari9+Chrome43+

---

Opera支持Edge79+

---

Edge（旧版）14+IE不支持

---

Android版Firefox40+iOS版Safari9+Android版Chrome支持Android WebView支持Samsung Internet支持Opera Mobile支持

onstatechange, 类型为 EventHandler

用于为 BaseAudioContext 设置事件处理程序属性， 当 AudioContext 的状态发生变化时（即对应的 promise 将已解析时）会分派一个事件。类型为 Event 的事件将被分派给事件处理程序，事件处理程序可以直接查询 AudioContext 的状态。新创建的 AudioContext 将始终以 suspended 状态开始，并且每当状态更改为不同状态时，将触发状态更改事件。在触发 oncomplete 事件之前，将触发此事件。

✔MDN

BaseAudioContext/sampleRate

所有现行引擎均支持。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge（旧版）12+IE不支持

---

Android版Firefox25+iOS版Safari6+Android版Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

sampleRate, 类型为 float, 只读

此 BaseAudioContext 处理音频的采样率（每秒采样帧数）。假定上下文中的所有 AudioNode 以此速率运行。在此假设下，不支持实时处理中的采样率转换器或“变速”处理器。 奈奎斯特频率 是此采样率值的一半。

✔MDN

BaseAudioContext/state

所有现行引擎均支持。

Firefox40+Safari9+Chrome43+

---

Opera支持Edge79+

---

Edge（旧版）14+IE不支持

---

Android版Firefox40+iOS版Safari9+Android版Chrome支持Android WebView支持Samsung Internet支持Opera Mobile支持

state, 类型为 AudioContextState, 只读

描述 BaseAudioContext 的当前状态。 获取此属性会返回 [[control thread state]] 插槽的内容。

1.1.2. 方法

✔MDN

BaseAudioContext/createAnalyser

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createAnalyser()

工厂方法 用于 AnalyserNode。

无参数。

返回类型: AnalyserNode

✔MDN

BaseAudioContext/createBiquadFilter

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createBiquadFilter()

工厂方法 用于 BiquadFilterNode ，代表一个二阶滤波器，它可以配置为几种常见的滤波器类型。

无参数。

返回类型: BiquadFilterNode

✔MDN

BaseAudioContext/createBuffer

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createBuffer(numberOfChannels, length, sampleRate)

创建指定大小的AudioBuffer。缓冲区中的音频数据将被初始化为零（静音）。 如果任何参数为负值、零或超出其标称范围，则必须抛出 NotSupportedError 异常。

BaseAudioContext.createBuffer() 方法的参数。

参数	类型	可为空	可选	描述
numberOfChannels	unsigned long	✘	✘	决定缓冲区将有多少通道。实现必须支持至少32个通道。
length	unsigned long	✘	✘	决定缓冲区的大小，以采样帧为单位。这个值必须至少为1。
sampleRate	float	✘	✘	描述缓冲区中线性PCM音频数据的采样率，以每秒采样帧数为单位。实现必须支持至少8000到96000的采样率范围。

返回类型: AudioBuffer

✔MDN

BaseAudioContext/createBufferSource

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createBufferSource()

工厂方法 用于 AudioBufferSourceNode。

无参数。

返回类型: AudioBufferSourceNode

✔MDN

BaseAudioContext/createChannelMerger

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createChannelMerger(numberOfInputs)

工厂方法用于 ChannelMergerNode 表示一个通道合并器。如果numberOfInputs小于1或大于支持的通道数，则必须抛出IndexSizeError异常。

BaseAudioContext.createChannelMerger(numberOfInputs)方法的参数。

参数	类型	可为空	可选	描述
numberOfInputs	unsigned long	✘	✔	确定输入数量。必须支持最多32个值。如果未指定，则使用6。

返回类型: ChannelMergerNode

✔MDN

BaseAudioContext/createChannelSplitter

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createChannelSplitter(numberOfOutputs)

工厂方法用于 ChannelSplitterNode 表示一个通道分离器。如果numberOfOutputs小于1或大于支持的通道数，则必须抛出IndexSizeError异常。

BaseAudioContext.createChannelSplitter(numberOfOutputs)方法的参数。

参数	类型	可为空	可选	描述
numberOfOutputs	unsigned long	✘	✔	输出数量。必须支持最多32个值。如果未指定，则使用6。

返回类型: ChannelSplitterNode

MDN

BaseAudioContext/createConstantSource

Firefox52+Safari无Chrome56+

---

Opera43+Edge79+

---

Edge (Legacy)无IE无

---

适用于Android的Firefox52+iOS Safari无适用于Android的Chrome56+Android WebView56+Samsung Internet6.0+Opera Mobile43+

createConstantSource()

工厂方法用于 ConstantSourceNode。

无参数。

返回类型: ConstantSourceNode

✔MDN

BaseAudioContext/createConvolver

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createConvolver()

工厂方法用于 ConvolverNode。

无参数。

返回类型: ConvolverNode

✔MDN

BaseAudioContext/createDelay

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createDelay(maxDelayTime)

工厂方法用于 DelayNode。 初始默认延迟时间为0秒。

BaseAudioContext.createDelay(maxDelayTime)方法的参数。

参数	类型	可为空	可选	描述
maxDelayTime	double	✘	✔	指定延迟线允许的最大延迟时间（以秒为单位）。如果指定，则此值必须大于零且小于三分钟，否则必须抛出NotSupportedError异常。如果未指定，则使用1。

返回类型: DelayNode

✔MDN

BaseAudioContext/createDynamicsCompressor

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createDynamicsCompressor()

工厂方法用于 DynamicsCompressorNode。

无参数。

返回类型: DynamicsCompressorNode

MDN

BaseAudioContext/createGain

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createGain()

工厂方法用于 GainNode。

无参数。

返回类型: GainNode

MDN

BaseAudioContext/createIIRFilter

Firefox50+Safari无Chrome49+

---

Opera是Edge79+

---

Edge (Legacy)14+IE无

---

适用于Android的Firefox50+iOS Safari无适用于Android的Chrome49+Android WebView49+Samsung Internet5.0+Opera Mobile是

createIIRFilter(feedforward, feedback)

BaseAudioContext.createIIRFilter()方法的参数。

参数	类型	可为空	可选	描述
feedforward	sequence<double>	✘	✘	一个包含IIR滤波器传递函数的前馈（分子）系数的数组。此数组的最大长度为20。如果所有值为零，必须抛出InvalidStateError异常。如果数组长度为0或大于20，必须抛出NotSupportedError异常。
feedback	sequence<double>	✘	✘	一个包含IIR滤波器传递函数的反馈（分母）系数的数组。此数组的最大长度为20。如果数组的第一个元素为0，必须抛出InvalidStateError异常。如果数组长度为0或大于20，必须抛出NotSupportedError异常。

返回类型: IIRFilterNode

✔MDN

BaseAudioContext/createOscillator

在所有当前的引擎中。

Firefox25+Safari6+Chrome20+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome25+Android WebView37+Samsung Internet1.5+Opera Mobile14+

createOscillator()

工厂方法用于 OscillatorNode。

无参数。

返回类型: OscillatorNode

✔MDN

BaseAudioContext/createPanner

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createPanner()

工厂方法用于 PannerNode。

无参数。

返回类型: PannerNode

✔MDN

BaseAudioContext/createPeriodicWave

在所有当前的引擎中。

Firefox25+Safari8+Chrome59+

---

Opera17+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari8+适用于Android的Chrome59+Android WebView59+Samsung Internet7.0+Opera Mobile18+

createPeriodicWave(real, imag, constraints)

工厂方法用于创建 PeriodicWave。

调用此方法时，执行以下步骤：

1. 如果real和imag的长度不同，则必须抛出IndexSizeError异常。

2. 令o为一个新对象，类型为PeriodicWaveOptions。

3. 分别将传递给此工厂方法的real和imag参数设置为o上的同名属性。

4. 将o上的disableNormalization属性设置为传递给工厂方法的constraints属性的disableNormalization属性的值。

5. 构造一个新的PeriodicWavep，将此工厂方法被调用的BaseAudioContext作为第一个参数传递，并传递o。

6. 返回p。

BaseAudioContext.createPeriodicWave()方法的参数。

参数	类型	可为空	可选	描述
real	sequence<float>	✘	✘	一系列余弦参数。有关更详细的描述，请参阅其real构造函数参数。
imag	sequence<float>	✘	✘	一系列正弦参数。有关更详细的描述，请参阅其imag构造函数参数。
constraints	PeriodicWaveConstraints	✘	✔	如果未给出，则波形被归一化。否则，波形根据constraints给定的值进行归一化。

返回类型: PeriodicWave

createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels)

工厂方法用于创建一个ScriptProcessorNode。此方法已弃用，因为它将被AudioWorkletNode替代。创建一个ScriptProcessorNode以使用脚本进行直接音频处理。如果bufferSize或numberOfInputChannels或numberOfOutputChannels超出有效范围，则必须抛出IndexSizeError异常。

对于numberOfInputChannels和numberOfOutputChannels都为零的情况是无效的。在这种情况下，必须抛出IndexSizeError异常。

BaseAudioContext.createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels)方法的参数。

参数	类型	可为空	可选	描述
bufferSize	unsigned long	✘	✔	bufferSize参数决定了缓冲区大小，以采样帧为单位。如果未传入此参数，或者值为0，则实现将为给定环境选择最佳的缓冲区大小，并且在节点的整个生命周期内保持为2的幂次。如果作者明确指定了缓冲区大小，则该值必须是以下值之一：256、512、1024、2048、4096、8192、16384。此值控制onaudioprocess事件的调度频率以及每次调用需要处理的采样帧数量。较低的bufferSize值将导致较低（更好）的延迟。较高的值则有必要避免音频中断和音频故障。建议作者不要指定此缓冲区大小，而是允许实现选择一个好的缓冲区大小，以平衡延迟和音频质量。如果此参数的值不是上述允许的2的幂次之一，必须抛出IndexSizeError异常。
numberOfInputChannels	unsigned long	✘	✔	此参数决定此节点输入的通道数量。默认值为2。必须支持多达32个值。如果不支持通道数量，必须抛出NotSupportedError。
numberOfOutputChannels	unsigned long	✘	✔	此参数决定此节点输出的通道数量。默认值为2。必须支持多达32个值。如果不支持通道数量，必须抛出NotSupportedError。

返回类型: ScriptProcessorNode

MDN

BaseAudioContext/createStereoPanner

Firefox37+Safari无Chrome42+

---

Opera无Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox37+iOS Safari无适用于Android的Chrome是Android WebView是Samsung Internet是Opera Mobile无

createStereoPanner()

工厂方法用于 StereoPannerNode。

无参数。

返回类型: StereoPannerNode

✔MDN

BaseAudioContext/createWaveShaper

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createWaveShaper()

工厂方法用于 WaveShaperNode， 表示一种非线性失真。

无参数。

返回类型: WaveShaperNode

✔MDN

BaseAudioContext/decodeAudioData

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

适用于Android的Firefox25+iOS Safari6+适用于Android的Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

decodeAudioData(audioData, successCallback, errorCallback)

异步解码包含在ArrayBuffer中的音频文件数据。例如，可以从XMLHttpRequest的response属性中加载ArrayBuffer，前提是将responseType设置为"arraybuffer"。音频文件数据可以是audio元素支持的任何格式。传递给decodeAudioData()的缓冲区通过嗅探来确定其内容类型，如[mimesniff]中所述。

虽然与此函数交互的主要方法是通过其promise返回值，但为了兼容旧代码，仍提供了回调参数。

当调用decodeAudioData时，必须在控制线程上执行以下步骤：

1. 如果this的相关全局对象的关联的文档不是完全激活的，则返回一个被拒绝的promise，原因是"InvalidStateError"DOMException。

2. 创建一个新的Promise，命名为promise。

3. 如果在IsDetachedBuffer（在[ECMASCRIPT]中描述）上，audioData为false，则执行以下步骤：

   1. 将promise附加到[[pending promises]]。

   2. 分离该audioDataArrayBuffer。此操作在[ECMASCRIPT]中有描述。如果此操作引发异常，跳至步骤3。

   3. 将解码操作排入队列，在另一个线程上执行。

4. 否则，执行以下错误步骤：

   1. 创建一个error，类型为DataCloneError。

   2. 用error拒绝promise，并从[[pending promises]]中移除它。

   3. 将一个媒体元素任务排入队列，以调用errorCallback并传入error。

5. 返回promise。

当将解码操作排入队列以在另一个线程上执行时，以下步骤必须在不是控制线程或渲染线程的线程上执行，称为解码线程。

注意：多个解码线程可以并行运行以处理多个decodeAudioData调用。

1. 令can decode为布尔标志，初始设置为true。

2. 尝试使用MIME Sniffing §6.2 匹配音频或视频类型模式来确定audioData的MIME类型。如果音频或视频类型模式匹配算法返回undefined，则将can decode设置为false。

3. 如果can decode为true，尝试将编码的audioData解码为线性PCM。如果失败，将can decode设置为false。

4. 如果can decode为false，将一个媒体元素任务排入队列，执行以下步骤：

   1. 创建一个error，类型为DOMException，名称为EncodingError。

      2. 用error拒绝promise，并从[[pending promises]]中移除它。

   2. 如果errorCallback存在，则调用errorCallback并传入error。

5. 否则：

   1. 获取结果，表示解码后的线性PCM音频数据，并将其重新采样为BaseAudioContext的采样率（如果与audioData的采样率不同）。

   2. 将一个媒体元素任务排入队列，执行以下步骤：

      1. 将结果保存在buffer中，该buffer是一个AudioBuffer，包含最终结果（可能已执行采样率转换）。

      2. 用buffer解决promise。

      3. 如果successCallback存在，则调用successCallback并传入buffer。

BaseAudioContext.decodeAudioData()方法的参数。

参数	类型	可为空	可选	描述
audioData	ArrayBuffer	✘	✘	包含压缩音频数据的ArrayBuffer。
successCallback	DecodeSuccessCallback?	✔	✔	解码完成时调用的回调函数。此回调函数的唯一参数是表示解码后PCM音频数据的AudioBuffer。
errorCallback	DecodeErrorCallback?	✔	✔	解码音频文件出错时调用的回调函数。

返回类型: Promise<AudioBuffer>

1.1.3. 回调 DecodeSuccessCallback() 参数

decodedData， 类型为 AudioBuffer

包含解码后音频数据的 AudioBuffer。

1.1.4. 回调 DecodeErrorCallback() 参数

error， 类型为 DOMException

解码时发生的错误。

1.1.5. 生命周期

一旦创建，AudioContext 将继续播放声音，直到没有声音可播放，或者页面消失。

1.1.6. 缺乏自省或序列化原语

Web Audio API 对音频源调度采取了一种发出后即忘的方式。也就是说，源节点在AudioContext的生命周期内为每个音符创建，并且从未明确地从图中移除。这与序列化API不兼容，因为没有可以序列化的稳定节点集合。

此外，拥有一个自省API将允许内容脚本观察垃圾回收。

1.1.7. 与 BaseAudioContext 子类相关的系统资源

子类 AudioContext 和 OfflineAudioContext 应被视为昂贵的对象。创建这些对象可能涉及创建高优先级线程，或使用低延迟的系统音频流，这两者都会影响能耗。通常不需要在一个文档中创建多个 AudioContext。

构建或恢复BaseAudioContext子类涉及为该上下文获取系统资源。对于AudioContext，这还需要创建一个系统音频流。这些操作将在上下文开始从其关联的音频图生成输出时返回。

此外，用户代理可以有一个实现定义的最大AudioContext数量，超过此数量后，尝试创建新的AudioContext将失败，抛出 NotSupportedError。

suspend和close允许作者释放系统资源，包括线程、进程和音频流。暂停BaseAudioContext允许实现释放其部分资源，并允许稍后通过调用resume继续操作。关闭AudioContext允许实现释放其所有资源，之后将无法再次使用或恢复。

注意：例如，这可能涉及等待音频回调定期触发，或等待硬件准备好进行处理。

1.2. AudioContext 接口

此接口表示一个音频图，其 AudioDestinationNode 被路由到一个实时输出设备，该设备生成一个针对用户的信号。在大多数 使用情况下，每个文档只使用一个 AudioContext。

enum AudioContextLatencyCategory {
    "balanced",
    "interactive",
    "playback"
};

[Exposed=Window]
interface AudioContext : BaseAudioContext {
  constructor (optional AudioContextOptions contextOptions = {});
  readonly attribute double baseLatency;
  readonly attribute double outputLatency;
  AudioTimestamp getOutputTimestamp ();
  Promise<undefined> resume ();
  Promise<undefined> suspend ();
  Promise<undefined> close ();
  MediaElementAudioSourceNode createMediaElementSource (HTMLMediaElement mediaElement);
  MediaStreamAudioSourceNode createMediaStreamSource (MediaStream mediaStream);
  MediaStreamTrackAudioSourceNode createMediaStreamTrackSource (
    MediaStreamTrack mediaStreamTrack);
  MediaStreamAudioDestinationNode createMediaStreamDestination ();
};

一个 AudioContext 被认为是 允许启动 的，前提是用户代理允许上下文状态从 "suspended" 转换为 "running"。 用户代理可能会禁止此初始转换， 并且仅在 AudioContext 的 相关全局对象具有 粘性激活 时允许它。

AudioContext 有一个内部槽：

[[suspended by user]]

一个表示上下文是否由用户代码暂停的布尔标志。 初始值为 false。

1.2.1. 构造函数

MDN

AudioContext/AudioContext

Firefox25+Safari无Chrome35+

---

Opera22+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari无Chrome for Android35+Android WebView37+Samsung Internet3.0+Opera Mobile22+

AudioContext(contextOptions)

如果 当前设置对象的 责任文档 不是 完全活动的，则抛出 InvalidStateError 并中止这些步骤。

在创建一个 AudioContext 时，执行以下步骤：

1. 将 [[control thread state]] 设置为 suspended 在 AudioContext 上。

2. 将 [[rendering thread state]] 设置为 suspended 在 AudioContext 上。

3. 令 [[pending resume promises]] 成为这个 AudioContext 的一个槽， 它是一个最初为空的有序承诺列表。

4. 如果给定了 contextOptions，则应用这些选项：

   1. 根据 contextOptions.latencyHint， 设置此 AudioContext 的内部延迟， 如 latencyHint 中描述的那样。

   2. 如果 contextOptions.sampleRate 被指定， 则将此 sampleRate 设置为 此 AudioContext 的值。 否则，使用默认输出设备的采样率。如果选择的采样率与输出设备的采样率不同，则此 AudioContext 必须重新采样 音频输出以匹配输出设备的采样率。

      注意： 如果需要重新采样，则 AudioContext 的延迟可能会受到影响，可能会影响很大。

5. 如果上下文 允许启动，发送一个 控制消息 以开始处理。

6. 返回此 AudioContext 对象。

发送一个 控制消息 以开始处理的意思是 执行以下步骤：

1. 尝试 获取系统资源。 如果失败，中止以下步骤。

2. 将 [[rendering thread state]] 设置为 running 在 AudioContext 上。

3. 排队一个媒体元素任务以执行以下步骤：

   1. 将 state 属性设置为 AudioContext 的 running。

   2. 排队一个媒体元素任务 以 触发一个事件，名称为 statechange 在 AudioContext 上。

注意： 遗憾的是，无法以编程方式通知 作者创建 AudioContext 失败。 如果用户代理有访问日志记录机制（如开发者工具控制台）的权限， 建议记录一条信息性消息。

AudioContext.constructor(contextOptions) 方法的参数。

参数	类型	可为空	可选	描述
contextOptions	AudioContextOptions	✘	✔	用户指定的选项，用于控制 AudioContext 的构造方式。

1.2.2. 属性

MDN

AudioContext/baseLatency

Firefox70+Safari无Chrome58+

---

Opera45+Edge79+

---

Edge (Legacy)无IE无

---

Firefox for Android无iOS Safari无Chrome for Android58+Android WebView58+Samsung Internet7.0+Opera Mobile43+

baseLatency， 类型为 double，只读

这表示由 AudioContext 将音频从 AudioDestinationNode 传递到音频子系统时产生的处理延迟秒数。它不包括由于 AudioDestinationNode 和音频硬件之间的任何其他处理引起的任何额外延迟，尤其不包括音频图本身产生的任何延迟。

例如，如果音频上下文以 44.1 kHz 运行，且 AudioDestinationNode 内部实现双缓冲，并且可以处理和输出每个 渲染量子 的音频，那么处理延迟大约为 \((2\cdot128)/44100 = 5.805 \mathrm{ ms}\)。

⚠MDN

AudioContext/outputLatency

仅在一个当前引擎中。

Firefox70+Safari无Chrome无

---

Opera无Edge无

---

Edge (Legacy)无IE无

---

Firefox for Android无iOS Safari无Chrome for Android无Android WebView无Samsung Internet无Opera Mobile无

outputLatency， 类型为 double，只读

音频输出延迟的秒数估计，即用户代理请求主机系统播放缓冲区的时间与缓冲区中的第一个样本实际上由音频输出设备处理的时间之间的间隔。对于产生声学信号的设备（例如扬声器或耳机），后者时间是指样本的声音发出时间。

outputLatency 属性值取决于平台和连接的硬件音频输出设备。只要连接的音频输出设备保持不变，此 outputLatency 属性值在上下文的生命周期内不会改变。如果更改音频输出设备，则 outputLatency 属性值将相应更新。

1.2.3. 方法

✔MDN

AudioContext/close

在所有当前引擎中。

Firefox40+Safari9+Chrome42+

---

Opera是Edge79+

---

Edge (Legacy)14+IE无

---

Firefox for Android40+iOS Safari9+Chrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile是

close()

关闭 AudioContext， 释放所使用的系统资源。这不会自动释放所有 AudioContext 创建的对象，但会暂停 currentTime 的进程， 并停止处理音频数据。

调用 close 时，执行以下步骤：

1. 如果 this 的 相关全局对象 的 关联文档 不是 完全活跃，则返回 拒绝的 promise，并带有 InvalidStateError DOMException。

2. 让 promise 成为一个新的 Promise。

3. 如果 [[control thread state]] 在 AudioContext 上被设置为 closed，则拒绝 promise，并使用 InvalidStateError， 中止这些步骤，并返回 promise。

4. 将 [[control thread state]] 在 AudioContext 上设置为 closed。

5. 排队控制消息 以关闭 AudioContext。

6. 返回 promise。

运行控制消息 control message 以关闭 AudioContext 意味着在 渲染线程 上运行这些步骤：

1. 尝试 释放系统资源。

2. 将 [[rendering thread state]] 设置为 suspended。

   这将停止渲染。

3. 如果该 控制消息 是由于文档卸载而被运行的，则中止该算法。

   在这种情况下，无需通知控制线程。

4. 排队一个媒体元素任务 以执行以下步骤：

   1. 解析 promise。

   2. 如果 state 属性不是 closed：

      1. 将 state 属性设置为 closed。

      2. 排队一个媒体元素任务 以 触发事件 名为 statechange 的 在 AudioContext 上。

当 AudioContext 被关闭时，任何 MediaStream 和 HTMLMediaElement 将不再输出。这就是说，这些将不再产生输出到扬声器或其他输出设备。为了更灵活的行为，考虑使用 HTMLMediaElement.captureStream()。

注意： 当一个 AudioContext 已被关闭时，实现可以选择积极地释放比暂停时更多的资源。

无参数。

返回类型： Promise<undefined>

✔MDN

AudioContext/createMediaElementSource

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createMediaElementSource(mediaElement)

创建一个 MediaElementAudioSourceNode， 给定一个 HTMLMediaElement。 调用此方法的结果是 HTMLMediaElement 的音频将被重新路由到 AudioContext 的处理图中。

AudioContext.createMediaElementSource() 方法的参数。

参数	类型	可为空	可选	描述
mediaElement	HTMLMediaElement	✘	✘	将被重新路由的媒体元素。

返回类型： MediaElementAudioSourceNode

✔MDN

AudioContext/createMediaStreamDestination

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)无IE无

---

Firefox for Android25+iOS Safari是Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createMediaStreamDestination()

创建一个 MediaStreamAudioDestinationNode。

无参数。

返回类型： MediaStreamAudioDestinationNode

✔MDN

AudioContext/createMediaStreamSource

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IE无

---

Firefox for Android25+iOS Safari是Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

createMediaStreamSource(mediaStream)

创建一个 MediaStreamAudioSourceNode。

AudioContext.createMediaStreamSource() 方法的参数。

参数	类型	可为空	可选	描述
mediaStream	MediaStream	✘	✘	将作为源的媒体流。

返回类型： MediaStreamAudioSourceNode

⚠MDN

AudioContext/createMediaStreamTrackSource

在少于两个当前引擎中。

Firefox68+Safari无Chrome无

---

Opera无Edge无

---

Edge (Legacy)无IE无

---

Firefox for Android68+iOS Safari无Chrome for Android无Android WebView无Samsung Internet无Opera Mobile无

createMediaStreamTrackSource(mediaStreamTrack)

创建一个 MediaStreamTrackAudioSourceNode。

AudioContext.createMediaStreamTrackSource() 方法的参数。

参数	类型	可为空	可选	描述
mediaStreamTrack	MediaStreamTrack	✘	✘	将作为源的 MediaStreamTrack。其 kind 属性值必须等于 "audio"，否则必须抛出 InvalidStateError 异常。

返回类型： MediaStreamTrackAudioSourceNode

MDN

AudioContext/getOutputTimestamp

Firefox70+Safari无Chrome57+

---

Opera44+Edge79+

---

Edge (Legacy)无IE无

---

Firefox for Android无iOS Safari无Chrome for Android57+Android WebView57+Samsung Internet7.0+Opera Mobile43+

getOutputTimestamp()

返回一个新的 AudioTimestamp 实例， 其中包含两个与上下文相关的音频流位置值：contextTime 成员包含由音频输出设备当前渲染的采样帧的时间（即输出音频流位置），单位与上下文的 currentTime 相同； performanceTime 成员包含估计的时间，这个时间表示与存储的 contextTime 值对应的采样帧由音频输出设备渲染的时刻，单位与 performance.now()（在 [hr-time-3] 中描述）相同。

如果上下文的渲染图尚未处理音频块，则 getOutputTimestamp 调用会返回一个 AudioTimestamp 实例，其中两个成员都包含零。

在上下文的渲染图开始处理音频块之后，它的 currentTime 属性值总是超过从 contextTime 中获取的值 getOutputTimestamp 调用。

从 getOutputTimestamp 方法返回的值可以用于获取稍后的上下文时间值的性能时间估计：

function outputPerformanceTime(contextTime) {
  const timestamp = context.getOutputTimestamp();
  const elapsedTime = contextTime - timestamp.contextTime;
  return timestamp.performanceTime + elapsedTime * 1000;
}

在上面的例子中，估计的准确性取决于参数值与当前输出音频流位置的接近程度：给定的 contextTime 越接近 timestamp.contextTime，所获得估计的准确性越高。

注意： 上下文的 currentTime 值与从 contextTime 中获取的值之间的差异 getOutputTimestamp 方法调用 不能被认为是可靠的输出延迟估计， 因为 currentTime 可能在不均匀的时间间隔内递增，所以应使用 outputLatency 属性代替。

无参数。

返回类型： AudioTimestamp

✔MDN

AudioContext/resume

在所有当前引擎中。

Firefox40+Safari9+Chrome41+

---

Opera是Edge79+

---

Edge (Legacy)14+IE无

---

Firefox for Android是iOS Safari9+Chrome for Android41+Android WebView41+Samsung Internet4.0+Opera Mobile是

resume()

恢复 AudioContext 的 currentTime 进程，当它已被暂停时。

调用 resume 时， 执行以下步骤：

1. 如果 this 的 相关全局对象 的 关联文档 不是 完全活跃，则返回 拒绝的 promise，并带有 InvalidStateError DOMException。

2. 让 promise 成为一个新的 Promise。

3. 如果 [[control thread state]] 在 AudioContext 上被设置为 closed，则拒绝 promise，并使用 InvalidStateError， 中止这些步骤， 并返回 promise。

4. 将 [[suspended by user]] 设置为 false。

5. 如果上下文不 允许启动，则将 promise 添加到 [[pending promises]] 和 [[pending resume promises]] 中， 并中止这些步骤，返回 promise。

6. 将 [[control thread state]] 设置为 running。

7. 排队控制消息 以恢复 AudioContext。

8. 返回 promise。

运行控制消息 control message 以恢复 AudioContext 意味着在 渲染线程 上运行这些步骤：

1. 尝试 获取系统资源。

2. 将 [[rendering thread state]] 设置为 running。

3. 启动 渲染音频图。

4. 如果失败， 排队一个媒体元素任务 以执行以下步骤：

   1. 按顺序拒绝所有来自 [[pending resume promises]] 的 promise， 然后清空 [[pending resume promises]]。

   2. 此外，从 [[pending promises]] 中移除这些 promise。

5. 排队一个媒体元素任务 以执行以下步骤：

   1. 按顺序解析所有来自 [[pending resume promises]] 的 promise。

   2. 清空 [[pending resume promises]]。 另外，从 [[pending promises]] 中移除这些 promise。

   3. 解析 promise。

   4. 如果 state 属性不为 running：

      1. 将 state 属性设置为 running。

      2. 排队一个媒体元素任务 以 触发事件 名为 statechange 的 在 AudioContext 上。

无参数。

返回类型： Promise<undefined>

✔MDN

AudioContext/suspend

在所有当前引擎中。

Firefox40+Safari9+Chrome43+

---

Opera是Edge79+

---

Edge (Legacy)14+IE无

---

Firefox for Android40+iOS Safari9+Chrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile是

suspend()

暂停 AudioContext 的 currentTime 的进度， 允许已经处理的当前上下文处理块播放到目标，然后允许系统释放对音频硬件的占用。当应用程序知道在一段时间内不需要 AudioContext 时，这通常是有用的，并希望暂时释放与 AudioContext 相关的系统资源。当帧缓冲区为空（已交给硬件）时，承诺会被解决，或者如果上下文已经 suspended，则立即解决（无其他效果）。如果上下文已关闭，承诺会被拒绝。

调用 suspend 时，执行以下步骤：

1. 如果 this 的 相关全局对象 的 关联文档 不是 完全活跃，则返回 拒绝的 promise，并带有 InvalidStateError DOMException。

2. 让 promise 成为一个新的 Promise。

3. 如果 [[control thread state]] 在 AudioContext 上被设置为 closed，则拒绝 promise，并使用 InvalidStateError， 中止这些步骤， 并返回 promise。

4. 将 promise 添加到 [[pending promises]] 中。

5. 将 [[suspended by user]] 设置为 true。

6. 将 [[control thread state]] 在 AudioContext 设置为 suspended。

7. 排队控制消息 以暂停 AudioContext。

8. 返回 promise。

运行控制消息 control message 以暂停 AudioContext 意味着在 渲染线程 上运行这些步骤：

1. 尝试 释放系统资源。

2. 将 [[rendering thread state]] 在 AudioContext 设置为 suspended。

3. 排队一个媒体元素任务 以执行以下步骤：

   1. 解析 promise。

   2. 如果 state 属性不是 suspended：

      1. 将 state 属性设置为 suspended。

      2. 排队一个媒体元素任务 以 触发事件 名为 statechange 的 在 AudioContext 上。

当 AudioContext 被暂停时，MediaStream 将不再输出； 也就是说，数据将由于媒体流的实时特性而丢失。HTMLMediaElement 也将类似地忽略其输出，直到系统恢复。AudioWorkletNode 和 ScriptProcessorNode 将停止调用其处理程序，直到上下文恢复。对于 AnalyserNode 窗口函数，数据被视为连续流 - 即 resume()/suspend() 不会导致 在 AnalyserNode 数据流中出现静音。 特别是，当 AudioContext 被暂停时，重复调用 AnalyserNode 函数必须返回相同的数据。

无参数。

返回类型： Promise<undefined>

1.2.4. AudioContextOptions

The AudioContextOptions 字典用于指定用户指定的 AudioContext 的选项。

dictionary AudioContextOptions {
  (AudioContextLatencyCategory or double) latencyHint = "interactive";
  float sampleRate;
};

1.2.4.1. Dictionary AudioContextOptions 成员

MDN

AudioContextOptions/latencyHint

Firefox61+Safari无Chrome60+

---

Opera?Edge79+

---

Edge (Legacy)无IE无

---

Firefox for Android61+iOS Safari无Chrome for Android60+Android WebView60+Samsung Internet8.0+Opera Mobile?

latencyHint, 类型为 (AudioContextLatencyCategory 或 double)，默认为 "interactive"

标识播放类型，这会影响音频输出延迟与功耗之间的权衡。

latencyHint 的首选值来自 AudioContextLatencyCategory。 但是，也可以指定一个 double 值来表示延迟秒数，以便更细致地控制延迟与功耗之间的平衡。浏览器可自行解释该值并应用适当的延迟。实际使用的延迟由 AudioContext 的 baseLatency 属性给出。

MDN

AudioContextOptions/sampleRate

Firefox61+Safari无Chrome74+

---

Opera无Edge79+

---

Edge (Legacy)无IE无

---

Firefox for Android61+iOS Safari无Chrome for Android74+Android WebView74+Samsung Internet11.0+Opera Mobile无

sampleRate, 类型为 float

为将要创建的 AudioContext 设置 sampleRate 值。支持的值与 AudioBuffer 的采样率相同。 如果指定的采样率不受支持，NotSupportedError 异常必须被抛出。

如果未指定 sampleRate， 则使用该 AudioContext 输出设备的首选采样率。

1.2.5. AudioTimestamp

dictionary AudioTimestamp {
double contextTime;
DOMHighResTimeStamp performanceTime;
};

1.2.5.1. 字典 AudioTimestamp 成员

contextTime, 类型为 double

表示 BaseAudioContext 的 currentTime 的时间坐标系中的一个点。

performanceTime, 类型为 DOMHighResTimeStamp

表示 Performance 接口实现的时间坐标系中的一个点（详见 [hr-time-3]）。

1.3. OfflineAudioContext 接口

OfflineAudioContext 是一种特殊类型的 BaseAudioContext ，用于（可能）比实时更快地渲染/混音。它不会渲染到音频硬件，而是尽可能快地渲染，并将渲染结果作为 AudioBuffer 的形式返回。

[Exposed=Window]
interface OfflineAudioContext : BaseAudioContext {
  constructor(OfflineAudioContextOptions contextOptions);
  constructor(unsigned long numberOfChannels, unsigned long length, float sampleRate);
  Promise<AudioBuffer> startRendering();
  Promise<undefined> resume();
  Promise<undefined> suspend(double suspendTime);
  readonly attribute unsigned long length;
  attribute EventHandler oncomplete;
};

1.3.1. 构造函数

MDN

OfflineAudioContext/OfflineAudioContext

Firefox53+SafariNoneChrome35+

---

Opera22+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android53+iOS SafariNoneChrome for Android35+Android WebView4.4.3+Samsung Internet3.0+Opera Mobile22+

OfflineAudioContext(contextOptions)

如果 当前设置对象的 负责的文档 不是 完全激活的，则抛出 InvalidStateError 并中止这些步骤。

令 c 为一个新的 OfflineAudioContext 对象。 将 c 初始化如下：

1. 将 c 的 [[控制线程状态]] 设置为 "suspended"。

2. 将 c 的 [[渲染线程状态]] 设置为 "suspended"。

3. 构造一个 AudioDestinationNode ，其 channelCount 设置为 contextOptions.numberOfChannels。

OfflineAudioContext.constructor(contextOptions) 方法的参数。

参数	类型	可为空	可选	描述
contextOptions				构建此上下文所需的初始参数。

OfflineAudioContext(numberOfChannels, length, sampleRate)

OfflineAudioContext 可以使用与 AudioContext.createBuffer 相同的参数构造。如果任何参数为负、为零或超出其标称范围，必须抛出 NotSupportedError 异常。

OfflineAudioContext 的构造如下：

new OfflineAudioContext({
numberOfChannels: numberOfChannels,
length: length,
sampleRate: sampleRate
})

如同调用了上述代码。

OfflineAudioContext.constructor(numberOfChannels, length, sampleRate) 方法的参数。

参数	类型	可为空	可选	描述
numberOfChannels	unsigned long	✘	✘	确定缓冲区将具有的通道数量。请参阅 createBuffer() ，了解支持的通道数量。
length	unsigned long	✘	✘	确定缓冲区的大小，以采样帧为单位。
sampleRate	float	✘	✘	描述缓冲区中线性 PCM 音频数据的采样率，以每秒采样帧数表示。请参阅 createBuffer() ，了解有效的采样率。

1.3.2. 属性

MDN

OfflineAudioContext/length

FirefoxYesSafariNoneChrome51+

---

Opera38+Edge79+

---

Edge (Legacy)14+IENone

---

Firefox for AndroidYesiOS SafariNoneChrome for Android51+Android WebView51+Samsung Internet5.0+Opera Mobile41+

length, 类型为 unsigned long，只读

缓冲区的大小，以采样帧为单位。此值与构造函数中的 length 参数相同。

✔MDN

OfflineAudioContext/oncomplete

在所有当前引擎中。

Firefox25+Safari6+Chrome25+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android25+iOS Safari?Chrome for Android25+Android WebView37+Samsung Internet1.5+Opera Mobile14+

oncomplete, 类型为 EventHandler

类型为 OfflineAudioCompletionEvent 的事件处理程序。 它是 OfflineAudioContext 上触发的最后一个事件。

1.3.3. 方法

✔MDN

OfflineAudioContext/startRendering

在所有当前引擎中。

Firefox25+Safari6+Chrome25+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android25+iOS Safari?Chrome for Android25+Android WebView37+Samsung Internet1.5+Opera Mobile14+

startRendering()

根据当前连接和已安排的更改，开始渲染音频。

虽然获取渲染音频数据的主要方法是通过其 promise 返回值，但该实例还会为遗留原因触发名为 complete 的事件。

让 [[rendering started]] 成为此 OfflineAudioContext 的一个内部槽。 将此槽初始化为 false。

当调用 startRendering 时，以下步骤必须在 控制线程 上执行：

1. 如果 此对象 的 相关全局对象 的 关联文档 不是 完全活跃，则返回 一个被拒绝的 promise 并附上 "InvalidStateError" DOMException。
2. 如果 [[rendering started]] 槽在 OfflineAudioContext 上为 true，则返回一个被拒绝的 promise，并附上 InvalidStateError，并中止这些步骤。
3. 将 [[rendering started]] 槽设置为 true。
4. 令 promise 为一个新的 promise。
5. 创建一个新的 AudioBuffer，其通道数、长度和采样率分别等于传递给此实例构造函数中 contextOptions 参数的 numberOfChannels、length 和 sampleRate 值。 将此缓冲区分配给 OfflineAudioContext 中的内部槽 [[rendered buffer]]。
6. 如果在前述 AudioBuffer 构造函数调用期间抛出了异常，则使用此异常拒绝 promise。
7. 否则，如果缓冲区成功构造，则 开始离线渲染。
8. 将 promise 添加到 [[pending promises]] 中。
9. 返回 promise。

若要 开始离线渲染，以下步骤必须在为此目的创建的 渲染线程 上进行。

1. 根据当前连接和已安排的更改，开始将 length 采样帧的音频渲染到 [[rendered buffer]] 中。
2. 对于每个 渲染量子，检查并在必要时 暂停 渲染。
3. 如果暂停的上下文被恢复，继续渲染缓冲区。
4. 渲染完成后， 队列一个媒体元素任务 以执行以下步骤：
   1. 使用 [[rendered buffer]] 解析由 startRendering() 创建的 promise。
   2. 队列一个媒体元素任务 以 触发一个事件，名为 complete，使用一个实例 OfflineAudioCompletionEvent，其 renderedBuffer 属性设置为 [[rendered buffer]]。

无参数。

返回类型： Promise<AudioBuffer>

⚠MDN

OfflineAudioContext/resume

仅在一个当前引擎中。

FirefoxNoneSafariNoneChrome49+

---

Opera36+Edge79+

---

Edge (Legacy)18IENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android49+Android WebView49+Samsung Internet5.0+Opera Mobile36+

resume()

恢复 OfflineAudioContext 的 currentTime 的时间进程，当它已暂停时。

当调用 resume 时，执行以下步骤：

1. 如果 此对象 的 相关全局对象 的 关联文档 不是 完全活跃，则返回 一个被拒绝的 promise 并附上 "InvalidStateError" DOMException。

2. 令 promise 为一个新的 Promise。

3. 当以下任一条件为真时，中止这些步骤并使用 InvalidStateError 拒绝 promise：

   • OfflineAudioContext 的 [[control thread state]] 为 closed。

   • OfflineAudioContext 的 [[rendering started]] 槽为 false。

4. 将 [[control thread state]] 标志设置为 running。

5. 队列一个控制消息 以恢复 OfflineAudioContext。

6. 返回 promise。

在 OfflineAudioContext 中运行 控制消息 以恢复 OfflineAudioContext 的操作意味着在 渲染线程 上执行这些步骤：

1. 将 [[rendering thread state]] 设置为 running。

2. 开始 渲染音频图。

3. 在出现故障的情况下， 队列一个媒体元素任务 以拒绝 promise 并中止剩余步骤。

4. 队列一个媒体元素任务 以执行以下步骤：

   1. 解析 promise。

   2. 如果 OfflineAudioContext 的 state 属性尚未设置为 "running"：

      1. 将 OfflineAudioContext 的 state 属性设置为 "running"。

      2. 队列一个媒体元素任务 以 触发一个事件，名为 statechange，并指向 OfflineAudioContext。

无参数。

返回类型： Promise<undefined>

⚠MDN

OfflineAudioContext/suspend

仅在一个当前引擎中。

FirefoxNoneSafariNoneChrome49+

---

Opera36+Edge79+

---

Edge (Legacy)18IENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android49+Android WebView49+Samsung Internet5.0+Opera Mobile36+

suspend(suspendTime)

计划在指定时间暂停音频上下文的时间进程，并返回一个 promise。在 OfflineAudioContext 上同步操作音频图时，这通常非常有用。

请注意，暂停的最大精度为 渲染量子 的大小，指定的暂停时间 将四舍五入到最接近的 渲染量子 边界。因此，不允许在同一量化帧中安排多个暂停。此外，应在上下文未运行时安排，以确保 精确暂停。

OfflineAudioContext.suspend() 方法的参数。

参数	类型	可为 null	可选	描述
suspendTime	double	✘	✘	在指定的时间安排暂停渲染，该时间将量化并四舍五入到 渲染量子 大小。如果量化的帧号 为负或 小于或等于当前时间或 大于或等于总渲染持续时间或 在同一时间被另一个暂停安排， 则 promise 将因 InvalidStateError 而被拒绝。

返回类型： Promise<undefined>

1.3.4. OfflineAudioContextOptions

此部分指定用于构建 OfflineAudioContext 的选项。

dictionary OfflineAudioContextOptions {
  unsigned long numberOfChannels = 1;
  required unsigned long length;
  required float sampleRate;
};

1.3.4.1. 字典 OfflineAudioContextOptions 成员

length, 类型为 unsigned long

渲染的 AudioBuffer 的长度，以采样帧为单位。

numberOfChannels, 类型为 unsigned long，默认值为 1

此 OfflineAudioContext 的通道数。

sampleRate, 类型为 float

此 OfflineAudioContext 的采样率。

1.3.5. OfflineAudioCompletionEvent 接口

这是一个 Event 对象，出于兼容性原因被分派给 OfflineAudioContext。

[Exposed=Window]
interface OfflineAudioCompletionEvent : Event {
  constructor (DOMString type, OfflineAudioCompletionEventInit eventInitDict);
  readonly attribute AudioBuffer renderedBuffer;
};

1.3.5.1. 属性

✔MDN

OfflineAudioCompletionEvent/renderedBuffer

在所有当前的引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (传统版)12+IE无

---

Android 版 Firefox25+iOS Safari是Android 版 Chrome18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

renderedBuffer, 类型为 AudioBuffer，只读

一个包含渲染音频数据的 AudioBuffer。

1.3.5.2. OfflineAudioCompletionEventInit

dictionary OfflineAudioCompletionEventInit : EventInit {
  required AudioBuffer renderedBuffer;
};

1.3.5.2.1. 字典 OfflineAudioCompletionEventInit 成员

renderedBuffer, 类型为 AudioBuffer

赋值给事件的 renderedBuffer 属性的值。

1.4. AudioBuffer 接口

此接口表示一个内存常驻的音频资源。它可以包含一个或多个通道，每个通道都表现为32位浮点 线性PCM值，标称范围为\([-1,1]\)，但数值并不限于此范围。通常，PCM数据的长度预期会相对较短（通常少于一分钟）。对于更长的声音，如音乐原声带，应该使用流式传输和 audio 元素以及 MediaElementAudioSourceNode。

AudioBuffer 可能会被一个或多个 AudioContext 使用，并且可以在 OfflineAudioContext 和 AudioContext 之间共享。

AudioBuffer 有四个内部槽：

[[number of channels]]

此 AudioBuffer 的音频通道数量，为无符号长整型。

[[length]]

此 AudioBuffer 每个通道的长度，为无符号长整型。

[[sample rate]]

此 AudioBuffer 的采样率，以Hz为单位，为浮点数。

[[internal data]]

保存音频样本数据的数据块。

[Exposed=Window]
interface AudioBuffer {
  constructor (AudioBufferOptions options);
  readonly attribute float sampleRate;
  readonly attribute unsigned long length;
  readonly attribute double duration;
  readonly attribute unsigned long numberOfChannels;
  Float32Array getChannelData (unsigned long channel);
  undefined copyFromChannel (Float32Array destination,
                             unsigned long channelNumber,
                             optional unsigned long bufferOffset = 0);
  undefined copyToChannel (Float32Array source,
                           unsigned long channelNumber,
                           optional unsigned long bufferOffset = 0);
};

1.4.1. 构造函数

AudioBuffer(options)

1. 如果 options 中的任何值超出其标称范围，则抛出 NotSupportedError 异常并中止以下步骤。

2. 让 b 成为一个新的 AudioBuffer 对象。

3. 分别将构造函数中传入的 numberOfChannels、 length、 sampleRate 属性的值分别赋值给内部槽 [[number of channels]]、 [[length]]、 [[sample rate]]。

4. 将此 AudioBuffer 的内部槽 [[internal data]] 设置为调用 CreateByteDataBlock 的结果 ([[length]] * [[number of channels]])。

   注意： 这会将底层存储初始化为零。

5. 返回 b。

AudioBuffer.constructor() 方法的参数。

参数	类型	可空	可选	描述
options	AudioBufferOptions	✘	✘	一个 AudioBufferOptions， 用于确定此 AudioBuffer 的属性。

1.4.2. 属性

✔MDN

AudioBuffer/duration

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (旧版)12+IENone

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

duration, 类型为 double，只读

PCM 音频数据的持续时间，以秒为单位。

通过将 [[length]] 除以 [[sample rate]] 计算得出 AudioBuffer 的值。

✔MDN

AudioBuffer/length

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (旧版)12+IENone

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

length, 类型为 unsigned long，只读

PCM 音频数据的长度，以样本帧为单位。必须返回 [[length]] 的值。

✔MDN

AudioBuffer/numberOfChannels

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (旧版)12+IENone

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

numberOfChannels, 类型为 unsigned long，只读

离散音频通道的数量。必须返回 [[number of channels]] 的值。

✔MDN

AudioBuffer/sampleRate

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (旧版)12+IENone

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

sampleRate, 类型为 float，只读

PCM 音频数据的采样率，以每秒样本数表示。必须返回 [[sample rate]] 的值。

1.4.3. 方法

MDN

AudioBuffer/copyFromChannel

Firefox25+SafariNoneChrome43+

---

Opera30+Edge79+

---

Edge (旧版)13+IENone

---

Firefox for Android25+iOS SafariNoneChrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile30+

copyFromChannel(destination, channelNumber, bufferOffset)

copyFromChannel() 方法将指定通道的样本从 AudioBuffer 复制到 destination 数组中。

设 buffer 为 AudioBuffer 具有 \(N_b\) 帧，设 \(N_f\) 为 destination 数组中的元素数量，\(k\) 是 bufferOffset 的值。 然后，从 buffer 复制到 destination 的帧数为 \(\max(0, \min(N_b - k, N_f))\)。如果此值小于 \(N_f\)，则 destination 的其余元素将不被修改。

AudioBuffer.copyFromChannel() 方法的参数。

参数	类型	可空	可选	描述
destination	Float32Array	✘	✘	通道数据将被复制到的数组。
channelNumber	unsigned long	✘	✘	要复制数据的通道的索引。如果 channelNumber 大于或等于 AudioBuffer 的通道数量，则 必须抛出 IndexSizeError 异常。
bufferOffset	unsigned long	✘	✔	一个可选的偏移量，默认为 0。从此偏移量开始，从 AudioBuffer 复制数据到 destination。

返回类型： undefined

MDN

AudioBuffer/copyToChannel

Firefox25+SafariNoneChrome43+

---

Opera30+Edge79+

---

Edge (旧版)13+IENone

---

Firefox for Android25+iOS SafariNoneChrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile30+

copyToChannel(source, channelNumber, bufferOffset)

copyToChannel() 方法将样本从 source 数组复制到 AudioBuffer 的指定通道。

如果 UnknownError 被抛出，则表示无法将 source 复制到缓冲区。

设 buffer 为 AudioBuffer 具有 \(N_b\) 帧，设 \(N_f\) 为 source 数组中的元素数量，\(k\) 是 bufferOffset 的值。 然后，从 source 复制到 buffer 的帧数为 \(\max(0, \min(N_b - k, N_f))\)。如果此值小于 \(N_f\)，则 buffer 的其余元素将不被修改。

AudioBuffer.copyToChannel() 方法的参数。

参数	类型	可空	可选	描述
source	Float32Array	✘	✘	通道数据将被复制到的数组。
channelNumber	unsigned long	✘	✘	要复制数据的通道的索引。如果 channelNumber 大于或等于 AudioBuffer 的通道数量，则 必须抛出 IndexSizeError 异常。
bufferOffset	unsigned long	✘	✔	一个可选的偏移量，默认为 0。从此偏移量开始，从 source 复制数据到 AudioBuffer。

返回类型： undefined

MDN

AudioBuffer/getChannelData

在所有当前引擎中。

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (旧版)12+IENone

---

Firefox for Android25+iOS Safari6+Chrome for Android18+Android WebView37+Samsung Internet1.0+Opera Mobile14+

getChannelData(channel)

根据 获取内容 中描述的规则，从 [[internal data]] 中获取字节，并在新的 Float32Array 中返回。

如果 UnknownError 被抛出，则表示无法创建 [[internal data]] 或新的 Float32Array。

AudioBuffer.getChannelData() 方法的参数。

参数	类型	可空	可选	描述
channel	unsigned long	✘	✘	此参数是一个索引，表示要获取数据的特定通道。索引值为 0 表示第一个通道。此索引值必须小于 [[number of channels]]，否则必须抛出 IndexSizeError 异常。

返回类型： Float32Array

注意： copyToChannel() 和 copyFromChannel() 方法可以通过传递一个 Float32Array 视图来填充数组的一部分。 当从 AudioBuffer 的通道中读取数据并且数据可以分块处理时， 应优先使用 copyFromChannel() 而不是调用 getChannelData() 并访问生成的数组，因为它可能避免不必要的内存分配和复制。

当某些 API 实现需要 AudioBuffer 的内容时，会调用内部操作 获取 AudioBuffer 的内容。 此操作将不可变的通道数据返回给调用者。

在以下情况下，会调用 获取 AudioBuffer 的内容 操作：

• 当调用 AudioBufferSourceNode.start 时，会 获取 节点的 buffer 的内容。如果操作失败，则不会播放任何内容。

• 当 buffer 设置为 AudioBufferSourceNode 并且 AudioBufferSourceNode.start 之前已被调用，则 setter 获取 AudioBuffer 的内容。如果操作失败，则不会播放任何内容。

• 当 ConvolverNode 的 buffer 设置为 AudioBuffer 时， 它会 获取 AudioBuffer 的内容。

• 当 AudioProcessingEvent 的分派完成时，它 获取 其 outputBuffer 的内容。

注意： 这意味着在 获取 AudioBuffer 的内容 后，copyToChannel() 不能用于更改正在由 AudioNode 使用的 AudioBuffer 的内容， 因为 AudioNode 将继续使用之前获取的数据。

1.4.4. AudioBufferOptions

这指定了构造 AudioBuffer 时要使用的选项。length 和 sampleRate 成员是必需的。

dictionary AudioBufferOptions {
  unsigned long numberOfChannels = 1;
  required unsigned long length;
  required float sampleRate;
};

1.4.4.1. 字典 AudioBufferOptions 成员

此字典成员的允许值受到约束。请参阅 createBuffer()。

length, 类型为 unsigned long

缓冲区的长度，以样本帧为单位。请参阅 length 获取约束条件。

numberOfChannels, 类型为 unsigned long，默认为 1

缓冲区的通道数。请参阅 numberOfChannels 获取约束条件。

sampleRate, 类型为 float

缓冲区的采样率，以 Hz 为单位。请参阅 sampleRate 获取约束条件。

1.5. AudioNode 接口

AudioNode 是 AudioContext 的构建块。 该接口表示音频源、音频目标和中间处理模块。可以将这些模块连接在一起，以形成用于将音频渲染到音频硬件的 处理图。 每个节点可以具有 输入 和/或 输出。源节点 没有输入，只有一个输出。 大多数处理节点（如滤波器）将有一个输入和一个输出。每种类型的 AudioNode 在其处理或合成音频的细节上有所不同。 但是一般来说，AudioNode 将处理其输入（如果有的话），并为其输出生成音频（如果有的话）。

每个输出都有一个或多个通道。通道的确切数量取决于特定 AudioNode 的细节。

一个输出可以连接到一个或多个 AudioNode 的输入，因此支持扇出。 一个输入最初没有连接，但可以从一个或多个 AudioNode 输出连接，因此支持扇入。 当调用 connect() 方法将 AudioNode 的输出连接到另一个 AudioNode 的输入时，我们称其为对该输入的 连接。

每个 AudioNode 的 输入 在任何给定时间都有特定数量的通道。此数量可能会根据对该输入的 连接 而发生变化。如果输入没有连接，则它有一个静音的通道。

对于每个 输入，AudioNode 对该输入的所有连接进行混合。 有关规范要求和详细信息，请参阅 § 4 通道上混和下混。

输入的处理和 AudioNode 的内部操作与 AudioContext 时间连续进行，无论节点是否连接输出，也无论这些输出是否最终到达 AudioContext 的 AudioDestinationNode。

[Exposed=Window]
interface AudioNode : EventTarget {
  AudioNode connect (AudioNode destinationNode,
                     optional unsigned long output = 0,
                     optional unsigned long input = 0);
  undefined connect (AudioParam destinationParam, optional unsigned long output = 0);
  undefined disconnect ();
  undefined disconnect (unsigned long output);
  undefined disconnect (AudioNode destinationNode);
  undefined disconnect (AudioNode destinationNode, unsigned long output);
  undefined disconnect (AudioNode destinationNode,
                        unsigned long output,
                        unsigned long input);
  undefined disconnect (AudioParam destinationParam);
  undefined disconnect (AudioParam destinationParam, unsigned long output);
  readonly attribute BaseAudioContext context;
  readonly attribute unsigned long numberOfInputs;
  readonly attribute unsigned long numberOfOutputs;
  attribute unsigned long channelCount;
  attribute ChannelCountMode channelCountMode;
  attribute ChannelInterpretation channelInterpretation;
};

1.5.1. AudioNode 创建

AudioNode 可以通过两种方式创建： 使用该特定接口的构造函数，或者使用 BaseAudioContext 或 AudioContext 上的工厂方法。

作为 AudioNode 构造函数的第一个参数传递的 BaseAudioContext 被称为要创建的 AudioNode 的 关联 BaseAudioContext。同样地，当使用工厂方法时，关联的 BaseAudioContext 是调用此工厂方法的 BaseAudioContext。

工厂方法的 关联接口 是从该方法返回的对象的接口。 接口的 关联选项对象 是可以传递给此接口构造函数的选项对象。

AudioNode 是 EventTarget，如 [DOM] 中所述。这意味着可以向 AudioNode 分派事件，就像其他 EventTarget 接受事件的方式一样。

enum ChannelCountMode {
  "max",
  "clamped-max",
  "explicit"
};

ChannelCountMode 结合节点的 channelCount 和 channelInterpretation 值，用于确定控制如何将输入混合到节点的 计算的通道数。计算的通道数如下所示。 有关如何进行混合的更多信息，请参阅 § 4 通道上混和下混。