AudioParamDescriptor

Web Audio API의 AudioParamDescriptor dictionary는 AudioParam 객체에 대한 속성들을 명시합니다.

이 dictionary는 AudioWorkletNode에서 사용자 정의 AudioParam 을 생성하기 위해 사용됩니다. 만약 근본적인 AudioWorkletProcessor가 parameterDescriptors static getter를 가지고 있다면, 이 dictionary에 기반한 반환된 객체들의 배열이 AudioWorkletNode 생성자에 의해 내부적으로 사용되어 이에 맞춰 AudioWorkletNode의 parameters 속성을 채웁니다.

속성

name

AudioParam 의 이름을 나타내는 DOMString. 이 이름 아래에서 AudioParam 은 AudioWorkletNode의 parameters 속성에서 사용 가능하게 될 것이고, 이 이름 아래에서 AudioWorkletProcessor.process 메서드가 이 AudioParam 의 계산된 값을 획득할 것입니다.

automationRate Optional

이 AudioParam 의 자동화율(automation rate)을 나타내는 string인데, "a-rate" 또는 "k-rate"입니다. 기본값은 "a-rate" 입니다.

minValue Optional

AudioParam 의 최소 값을 나타내는 float. 기본값은 -3.4028235e38 입니다.

maxValue Optional

AudioParam 의 최대 값을 나타내는 float. 기본값은 3.4028235e38 입니다.

defaultValue Optional

AudioParam 의 초기 값을 나타내는 float. 기본값은 0 입니다.

예제

아래의 코드는 사용자 정의 AudioWorkletProcessor 에서 정의된 static parameterDescriptors 메서드에 의해 반환되는 이 유형의 descriptor를 보여줍니다 (이 코드는 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'
 }]
 }
...
}

명세서

브라우저 호환성

같이 보기

• Web Audio API
• Web Audio API 사용하기