AudioParamDescriptor
The AudioParamDescriptor
dictionary of the Web Audio API specifies properties for AudioParam
objects.
It is used to create custom AudioParam
s on an AudioWorkletNode
. If the underlying AudioWorkletProcessor
has a parameterDescriptors
static getter, then the returned array of objects based on this dictionary is used internally by AudioWorkletNode
constructor to populate its parameters
property accordingly.
Instance properties
name
-
The string which represents the name of the
AudioParam
. Under this name theAudioParam
will be available in theparameters
property of the node, and under this name theAudioWorkletProcessor.process
method will acquire the calculated values of thisAudioParam
. automationRate
Optional-
Either
"a-rate"
, or"k-rate"
string which represents an automation rate of thisAudioParam
. Defaults to"a-rate"
. minValue
Optional-
A
float
which represents minimum value of theAudioParam
. Defaults to-3.4028235e38
. maxValue
Optional-
A
float
which represents maximum value of theAudioParam
. Defaults to3.4028235e38
. defaultValue
Optional-
A
float
which represents initial value of theAudioParam
. Defaults to0
.
Examples
The code fragment below shows a descriptor of this type being returned by a static parameterDescriptors
method defined in a custom AudioWorkletProcessor
(this is part of the more complete example in 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",
},
];
}
// …
}
Specifications
No specification found
No specification data found for api.AudioParamDescriptor
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Browser compatibility
BCD tables only load in the browser