AudioParamDescriptor
Das AudioParamDescriptor Wörterbuch der Web Audio API spezifiziert Eigenschaften für AudioParam-Objekte.
Es wird verwendet, um benutzerdefinierte AudioParams auf einem AudioWorkletNode zu erstellen. Wenn der zugrunde liegende AudioWorkletProcessor einen statischen Getter parameterDescriptors hat, dann wird das zurückgegebene Array von Objekten basierend auf diesem Wörterbuch intern vom AudioWorkletNode-Konstruktor verwendet, um die parameters-Eigenschaft entsprechend zu befüllen.
Instanz-Eigenschaften
name-
Der String, der den Namen des
AudioParamdarstellt. Unter diesem Namen wird dasAudioParamin derparameters-Eigenschaft des Knotens verfügbar sein, und unter diesem Namen wird dieAudioWorkletProcessor.process-Methode die berechneten Werte diesesAudioParamerwerben. automationRateOptional-
Entweder
"a-rate"oder"k-rate"String, der eine Automatisierungsrate diesesAudioParamdarstellt. Standardwert ist"a-rate". minValueOptional-
Ein
float, der den Mindestwert desAudioParamdarstellt. Standardwert ist-3.4028235e38. maxValueOptional-
Ein
float, der den Höchstwert desAudioParamdarstellt. Standardwert ist3.4028235e38. defaultValueOptional-
Ein
float, der den Anfangswert desAudioParamdarstellt. Standardwert ist0.
Beispiele
Das untenstehende Codefragment zeigt einen Deskriptor dieses Typs, der von einer statischen parameterDescriptors-Methode zurückgegeben wird, die in einem benutzerdefinierten AudioWorkletProcessor definiert ist (dies ist Teil des ausführlicheren Beispiels in 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",
},
];
}
// …
}
Spezifikationen
| Specification |
|---|
| Web Audio API # AudioParamDescriptor |