AudioParamDescriptor

AudioParamDescriptorWeb 音频 API 中的字典,用于指定 AudioParam 对象的属性。

它用于在 AudioWorkletNode 上创建自定义 AudioParam。如果底层 AudioWorkletProcessor 具有 parameterDescriptors 静态获取器,则返回的基于此字典的对象数组将在内部由 AudioWorkletNode 构造函数使用,以相应地填充其 parameters 属性。

实例属性

名称

表示 AudioParam 名称的字符串。在此名称下,AudioParam 将在节点的 parameters 属性中可用,并且在此名称下,AudioWorkletProcessor.process 方法将获取此 AudioParam 的计算值。

automationRate 可选

表示此 AudioParam 的自动化速率的字符串,可以是 "a-rate""k-rate"。默认为 "a-rate"

minValue 可选

表示 AudioParam 最小值的 float。默认为 -3.4028235e38

maxValue 可选

表示 AudioParam 最大值的 float。默认为 3.4028235e38

defaultValue 可选

表示 AudioParam 初始值的 float。默认为 0

示例

下面的代码片段显示了自定义 AudioWorkletProcessor 中定义的静态 parameterDescriptors 方法返回的此类型描述符(这是 AudioWorkletNode.parameters 中更完整示例的一部分)。

js
// white-noise-processor.js
class WhiteNoiseProcessor extends AudioWorkletProcessor {
  static get parameterDescriptors() {
    return [
      {
        name: "customGain",
        defaultValue: 1,
        minValue: 0,
        maxValue: 1,
        automationRate: "a-rate",
      },
    ];
  }

  // …
}

规范

未找到规范

未找到 api.AudioParamDescriptor 的规范数据。
检查此页面是否存在问题 或向 mdn/browser-compat-data 贡献缺少的 spec_url。还要确保规范包含在 w3c/browser-specs.

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅