diff options
| -rw-r--r-- | files/ko/web/api/audioparamdescriptor/index.md | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/files/ko/web/api/audioparamdescriptor/index.md b/files/ko/web/api/audioparamdescriptor/index.md new file mode 100644 index 0000000000..e28be555fe --- /dev/null +++ b/files/ko/web/api/audioparamdescriptor/index.md @@ -0,0 +1,66 @@ +--- +title: AudioParamDescriptor +slug: Web/API/AudioParamDescriptor +tags: + - API + - Audio + - AudioParamDescriptor + - AudioWorkletProcessor + - Dictionary + - Reference + - Web Audio API + - parameterDescriptors +browser-compat: api.AudioParamDescriptor +--- +{{APIRef("Web Audio API")}} + +[Web Audio API](/ko/docs/Web/API/Web_Audio_API)의 **`AudioParamDescriptor`** dictionary는 {{domxref("AudioParam")}} 객체에 대한 속성들을 명시합니다. + +이 dictionary는 {{domxref("AudioWorkletNode")}}에서 사용자 정의 `AudioParam` 을 생성하기 위해 사용됩니다. 만약 근본적인 {{domxref("AudioWorkletProcessor")}}가 {{domxref("AudioWorkletProcessor.parameterDescriptors", "parameterDescriptors")}} static getter를 가지고 있다면, 이 dictionary에 기반한 반환된 객체들의 배열이 `AudioWorkletNode` 생성자에 의해 내부적으로 사용되어 이에 맞춰 AudioWorkletNode의 {{domxref("AudioWorkletNode.parameters", "parameters")}} 속성을 채웁니다. + +## 속성 + +- `name` + - : `AudioParam` 의 이름을 나타내는 {{domxref("DOMString")}}. 이 이름 아래에서 `AudioParam` 은 AudioWorkletNode의 {{domxref("AudioWorkletNode.parameters", "parameters")}} 속성에서 사용 가능하게 될 것이고, 이 이름 아래에서 {{domxref("AudioWorkletProcessor.process")}} 메서드가 이 `AudioParam` 의 계산된 값을 획득할 것입니다. +- `automationRate` {{optional_inline}} + - : 이 `AudioParam` 의 자동화율(automation rate)을 나타내는 string인데, [`"a-rate"`](/ko/docs/Web/API/AudioParam#a-rate) 또는 [`"k-rate"`](/ko/docs/Web/API/AudioParam#k-rate)입니다. 기본값은 `"a-rate"` 입니다. +- `minValue` {{optional_inline}} + - : `AudioParam` 의 최소 값을 나타내는 `float`. 기본값은 `-3.4028235e38` 입니다. +- `maxValue` {{optional_inline}} + - : `AudioParam` 의 최대 값을 나타내는 `float`. 기본값은 `3.4028235e38` 입니다. +- `defaultValue` {{optional_inline}} + - : `AudioParam` 의 초기 값을 나타내는 `float`. 기본값은 `0` 입니다. + +## 예제 + +아래의 코드는 사용자 정의 `AudioWorkletProcessor` 에서 정의된 static {{domxref("AudioWorkletProcessor.parameterDescriptors", "parameterDescriptors")}} 메서드에 의해 반환되는 이 유형의 descriptor를 보여줍니다 (이 코드는 [AudioWorkletNode.parameters](/en-US/docs/Web/API/AudioWorkletNode/parameters#examples) 예제의 일부입니다). + +```js +// white-noise-processor.js +class WhiteNoiseProcessor extends AudioWorkletProcessor { + static get parameterDescriptors () { + return [{ + name: 'customGain', + defaultValue: 1, + minValue: 0, + maxValue: 1, + automationRate: 'a-rate' + }] + } + +... +} +``` + +## 명세서 + +{{Specifications}} + +## 브라우저 호환성 + +{{Compat}} + +## 같이 보기 + +- [Web Audio API](/ko/docs/Web/API/Web_Audio_API) +- [Web Audio API 사용하기](/ko/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) |