diff options
author | Cor <83723320+logic-finder@users.noreply.github.com> | 2021-12-28 21:35:53 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-12-28 21:35:53 +0900 |
commit | 313b18c1697faa9bf94c0892e994e39dacdf8dd0 (patch) | |
tree | 4fdd9ccfac3bcc98549542188f69cecaf729ee29 /files/ko | |
parent | 55d6e846ac05ba462dcec2d3ad86c96b98aa4d49 (diff) | |
download | translated-content-313b18c1697faa9bf94c0892e994e39dacdf8dd0.tar.gz translated-content-313b18c1697faa9bf94c0892e994e39dacdf8dd0.tar.bz2 translated-content-313b18c1697faa9bf94c0892e994e39dacdf8dd0.zip |
[ko] Translation done of `AudioParam` document. (#2987)
* change the below document to md and translate it.
AudioParam
* modification
* fix
* modification
Co-authored-by: Yeji Choi <61399588+yechoi42@users.noreply.github.com>
* translation modification
Co-authored-by: Yeji Choi <61399588+yechoi42@users.noreply.github.com>
* translation modification
Co-authored-by: Yeji Choi <61399588+yechoi42@users.noreply.github.com>
* modification
Co-authored-by: Yeji Choi <61399588+yechoi42@users.noreply.github.com>
Diffstat (limited to 'files/ko')
-rw-r--r-- | files/ko/web/api/audioparam/index.md | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/files/ko/web/api/audioparam/index.md b/files/ko/web/api/audioparam/index.md new file mode 100644 index 0000000000..c868222bca --- /dev/null +++ b/files/ko/web/api/audioparam/index.md @@ -0,0 +1,96 @@ +--- +title: AudioParam +slug: Web/API/AudioParam +tags: + - API + - Audio + - AudioParam + - Interface + - Parameter + - Reference + - Web Audio API + - sound +browser-compat: api.AudioParam +--- +{{APIRef("Web Audio API")}} + +Web Audio API의 `AudioParam` 인터페이스는 오디오에 관련된 파라미터를 나타내는데, 보통 ({{ domxref("GainNode.gain") }}과 같은) {{domxref("AudioNode")}}의 파라미터입니다. + +`AudioParam` 은 특정한 값이나 값의 변화로 설정될 수 있고, 특정한 시간에 그리고 특정한 패턴을 따라 일어나도록 예정될 수 있습니다. + +각 `AudioParam` 은 이벤트의 리스트를 가지고 있고, 이는 초기적으로는 비어 있습니다. 이 이벤트의 리스트는 값이 언제 그리고 어떻게 변화할지를 정의합니다. 이 리스트가 비어있지 않을 때, `AudioParam.value` 특성을 사용한 변화는 무시됩니다. 이 이벤트의 리스트는 우리가 임의적인 타임라인 기반의 자동화 커브를 사용해 아주 정밀한 시간에 일어나야만 하는 변화들을 예정할 수 있게 합니다. 사용되는 이 시간은 {{domxref("BaseAudioContext/currentTime", "AudioContext.currentTime")}}에 정의된 것입니다. + +## AudioParam 유형 + +두 종류의 `AudioParam` 이 있는데, 그것은 _a-rate_ 와 _k-rate_ 파라미터입니다. 각 {{domxref("AudioNode")}}는 명세에서 이것의 파라미터들 중 어떤 것이 _a-rate_ 이고 어떤 것이 _k-rate_ 인지 정의합니다. + +### a-rate + +_a-rate_ `AudioParam` 은 오디오 신호의 각 [샘플 프레임](/ko/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API#audio_buffers.3a_frames.2c_samples_and_channels)에 대해 현재의 오디오 파라미터 값을 취합니다. + +### k-rate + +_k-rate_ `AudioParam` 은 처리되는 전체 블럭에 대해 같은 초기 오디오 파라미터 값을 사용합니다. 즉, 128 샘플 프레임입니다. 다른 말로 하자면, 오디오가 노드에 의해 처리되는 동안 같은 값이 오디오에 있는 모든 프레임에 적용됩니다. + +## 속성 + +- {{domxref("AudioParam.defaultValue")}} {{readonlyInline}} + - : `AudioParam` 을 생성하는 특정한 {{domxref("AudioNode")}}에 의해 정의되는 특성의 초기 값을 나타냅니다. +- {{domxref("AudioParam.maxValue")}} {{readonlyInline}} + - : 파라미터의 명목상의 (효과적인) 범위에 대한 최대로 가능한 값을 나타냅니다. +- {{domxref("AudioParam.minValue")}} {{readonlyinline}} + - : 파라미터의 명목상의 (효과적인) 범위에 대한 최소로 가능한 값을 나타냅니다. +- {{domxref("AudioParam.value")}} + - : 현재 시간에 대한 파라미터의 현재 값을 나타냅니다. 초기적으로는 {{domxref("AudioParam.defaultValue", "defaultValue")}}의 값으로 설정됩니다. + +## 메서드 + +- {{domxref("AudioParam.setValueAtTime()")}} + - : 정밀한 시간에서 `AudioParam` 의 값에 즉각적인 변화를 예정합니다. 이 시간은 {{domxref("BaseAudioContext/currentTime", "AudioContext.currentTime")}}과 비교하여 측정됩니다. 새로운 값은 `value` 매개변수에 의해 주어집니다. +- {{domxref("AudioParam.linearRampToValueAtTime()")}} + - : `AudioParam` 의 값에 점진적인 선형적 변화를 예정합니다. 이 변화는 _previous_ 이벤트에 명시된 시간에 시작하고, `value` 매개변수에 주어진 새로운 값까지 선형적인 경사(ramp)를 따라 변경된 후, `endTime` 매개변수에 주어진 시간에서 새로운 값에 도달합니다. +- {{domxref("AudioParam.exponentialRampToValueAtTime()")}} + - : `AudioParam` 의 값에 점진적인 지수적 변화를 예정합니다. 이 변화는 _previous_ 이벤트에 명시된 시간에 시작하고, `value` 매개변수에 주어진 새로운 값까지 지수적인 경사를 따라 변경된 후, `endTime` 매개변수에 주어진 시간에서 새로운 값에 도달합니다. +- {{domxref("AudioParam.setTargetAtTime()")}} + - : `AudioParam` 의 값에 변화의 시작을 예정합니다. 이 변화는 `startTime` 에 명시된 시간에 시작해 `target` 매개변수에 주어진 값을 향해 지수적으로 움직입니다. 이 지수적인 감소(decay) 비율은 `timeConstant` 매개변수에 의해 정의되는데, 이 값은 초 단위로 측정된 시간입니다. +- {{domxref("AudioParam.setValueCurveAtTime()")}} + - : `AudioParam` 의 값들이 주어진 구간에 맞도록 조정된 부동점 숫자들의 배열을 따르게 예정합니다. 수의 구간은 주어진 시작 시간에 시작하고, 주어진 지속 시간에 걸쳐 이어집니다. +- {{domxref("AudioParam.cancelScheduledValues()")}} + - : `AudioParam` 에 예정된 모든 미래의 변화들을 취소합니다. +- {{domxref("AudioParam.cancelAndHoldAtTime()")}} + - : `AudioParam` 에 예정된 모든 미래의 변화들을 취소하나 다른 메서드를 사용해 추가적인 변화가 만들어질 때까지 주어진 시간에서 값을 유지합니다. + +## 예제 + +첫째는 기본적인 예제인데 {{domxref("GainNode")}}가 `gain` 값을 설정하는 것을 보여줍니다. `gain` 은 a-rate AudoParam의 예시인데, 왜냐하면 이 값은 잠재적으로 오디오의 각각의 샘플 프레임에 대해 다르게 설정될 수 있기 때문입니다. + +```js +var AudioContext = window.AudioContext || window.webkitAudioContext; +var audioCtx = new AudioContext(); + +var gainNode = audioCtx.createGain(); +gainNode.gain.value = 0; +``` + +다음 예제는 {{ domxref("DynamicsCompressorNode") }}가 몇 개의 파라미터 값들을 조작하는 것을 보여줍니다. 이 값들은 k-rate AudioParam의 예시인데, 왜냐하면 이것들은 한번에 전체 오디오 블럭에 대해 설정되기 때문입니다. + +```js +var compressor = audioCtx.createDynamicsCompressor(); +compressor.threshold.setValueAtTime(-50, audioCtx.currentTime); +compressor.knee.setValueAtTime(40, audioCtx.currentTime); +compressor.ratio.setValueAtTime(12, audioCtx.currentTime); +compressor.attack.setValueAtTime(0, audioCtx.currentTime); +compressor.release.setValueAtTime(0.25, audioCtx.currentTime); +``` + +## 명세서 + +{{Specifications}} + +## 브라우저 호환성 + +{{Compat}} + +## 같이 보기 + +- [Web Audio API 사용하기](/ko/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) |