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'
    }]
  }

...
}

명세서

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.

브라우저 호환성

BCD tables only load in the browser

같이 보기