AudioWorkletNodeOptions - 用于在构造新的 AudioWorkletNode 时指定的配置选项

AudioWorkletNodeOptions 是 Web Audio API 的字典，用于在构造新的 AudioWorkletNode 进行自定义音频处理时指定配置选项。仅在调用 AudioWorkletNode() 构造函数时使用。在基础 AudioWorkletProcessor 的内部实例化期间，结构化克隆算法被应用于选项对象，并且结果传递到 AudioWorkletProcessor 的构造函数中。

属性

numberOfInputs 可选

初始化 numberOfInputs 属性的值。默认为 1。

numberOfOutputs 可选

初始化 numberOfOutputs 属性的值。默认为 1。

outputChannelCount 可选

一个 array，定义每个输出的通道数。例如，outputChannelCount: [n, m] 指定第一个输出中的通道数为 n，第二个输出中的通道数为 m。数组长度必须匹配 numberOfOutputs。

parameterData 可选

一个对象，该对象包含此节点上的自定义 AudioParam 对象的初始值（在其 parameters 属性中），其中 key 为自定义参数的名称，value 为其初始值。

processorOptions 可选

可用于基础 AudioWorkletProcessor 的自定义初始化的任何其他数据。

使用注意

创建 AudioWorkletNode 时，这些选项会产生各种效果。如果输入数量和输出数量都设置为 0，则将抛出 NotSupportedError，并且节点构建过程将中止。如果 outputChannelCount 数组的长度与 numberOfOutputs 不匹配，则会抛出 IndexSizeError。

如果未指定 outputChannelCount，并且 numberOfInputs 和 numberOfOutputs 均为 1，则 AudioWorkletNode 的初始通道数将设置为 1。这具有以下效果：即根据输入的通道数和 AudioNode 属性 channelCountMode 的当前设置，将输出通道数动态更改为计算的通道数。

否则，如果提供了 outputChannelCount，并且如果 numberOfInputs 和 numberOfOutputs 的值都为 1，则音频工作节点的通道数将设置为 outputChannelCount 的值。否则，将设置输出通道集合中每个通道的通道计数以匹配 outputChannelCount 数组中的相应值。

规范

规范	状态	备注
Web Audio API AudioWorkletNodeOptions 的定义	工作草案	初始定义。

桌面浏览器兼容性

暂无兼容数据