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 의 계산된 값을 획득할 것입니다.

automationRateOptional

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

minValueOptional

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

maxValueOptional

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

defaultValueOptional

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

예제

아래의 코드는 사용자 정의AudioWorkletProcessor 에서 정의된 staticparameterDescriptors 메서드에 의해 반환되는 이 유형의 descriptor를 보여줍니다 (이 코드는AudioWorkletNode.parameters 예제의 일부입니다).

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

명세서

브라우저 호환성

같이 보기

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