This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

AudioParamDescriptor

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

이 dictionary는 AudioWorkletNode에서 사용자 정의 AudioParam 을 생성하기 위해 사용됩니다. 만약 근본적인 AudioWorkletProcessorparameterDescriptors 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 예제의 일부입니다).

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

...
}

명세서

Specification
Web Audio API
# AudioParamDescriptor

브라우저 호환성

같이 보기