AudioParamDescriptor
AudioParamDescriptor
是 Web 音频 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 中更完整示例的一部分)。
// 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 表格仅在浏览器中加载