AudioParam.setValueCurveAtTime()
AudioParam
인터페이스의 setValueCurveAtTime()
메서드는 파라미터의 값이 값들의 리스트에 의해 정의되는 커브를 따라 변화하도록 예정합니다.
이 커브는 부동점 값들의 배열에서 정의되는 연속되는 값들 사이의 선형 보간인데, 이는 startTime
에 시작하는 주어진 구간과 특정한 기간에 맞도록 조정됩니다.
구문
js
var paramRef = param.setValueCurveAtTime(values, startTime, duration);
매개변수
values
-
명시된
duration
을 따라AudioParam
이 변화할 값 커브를 나타내는 부동점 number들의 배열. 이 배열에 있는 모든 값은 반드시 유한한 숫자여야 합니다. 만약 값이NaN
,Infinity
,-Infinity
라면,TypeError
예외가 발생합니다. startTime
-
AudioContext
가 처음 생성된 이후 값의 변화가 일어날 시간 (초 단위로 표현됨) 을 나타내는 double. 만약 이 값이AudioContext.currentTime
(en-US)보다 작다면, 이 값은currentTime
으로 맞춰집니다. duration
-
파라미터의
value
가 명시된 커브를 따라 변화하는 총 시간 (초 단위로 표현됨) 을 나타내는 double. 명시된 값들은 이 기간을 따라 동일하게 간격이 맞춰집니다.
반환 값
이 AudioParam
객체에 대한 참조. 이 인터페이스의 몇몇 오래된 브라우저 구현은 undefined
를 반환합니다.
예외
InvalidStateError
DOMException
(en-US)-
values
의 명시된 배열이 원소를 2개보다 적게 가지고 있을 때 발생됩니다. RangeError
DOMException
(en-US)-
명시된
startTime
이 음수 혹은 유한하지 않은 값이거나,duration
이 유한하지 않고 정확히 양수인 수가 아니면 발생됩니다. TypeError
DOMException
(en-US)-
values
배열에 있는 값들 중 한 개 이상의 값이 유한하지 않으면 발생됩니다. 유한하지 않은 값이란NaN
,Infinity
,-Infinity
입니다.
사용 일람
파라미터의 값이 커브를 따라서 종료되었을 때, 파라미터의 값은 values
매개변수에서 명시된 값들의 집합의 마지막 값과 일치하도록 보장됩니다.
참고: Web Audio API의 몇몇 이른 구현은 이것이 사실임을 보장하지 않는데, 이는 예기치 않은 결과를 유발합니다.
예제
이 예제는 하나의 버튼을 가진 미디어 소스를 가지고 있습니다 (소스 코드는 webaudio-examples
repo에서 볼 수 있고, 작동 예제도 볼 수 있습니다). 이 버튼이 눌렸을 때, setValueCurveAtTime()
이 사용되어 gain 값을 waveArray 배열에 포함된 값들 사이에서 변화시킵니다.
js
// 오디오 컨텍스트를 생성합니다
var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();
// 예제를 위한 기본 변수를 설정합니다
var myAudio = document.querySelector("audio");
var pre = document.querySelector("pre");
var myScript = document.querySelector("script");
pre.innerHTML = myScript.innerHTML;
var valueCurve = document.querySelector(".value-curve");
// MediaElementAudioSourceNode를 생성합니다
// HTMLMediaElement를 노드 내로 전달합니다
var source = audioCtx.createMediaElementSource(myAudio);
// gain 노드를 생성하고 gain 값을 0.5로 설정합니다
var gainNode = audioCtx.createGain();
gainNode.gain.value = 0.5;
var currGain = gainNode.gain.value;
// AudioBufferSourceNode를 gainNode에 연결하고
// gainNode를 destination에 연결합니다
source.connect(gainNode);
gainNode.connect(audioCtx.destination);
// onclick이 발생했을 때 무언가를 하기 위해 버튼을 설정합니다
var waveArray = new Float32Array(9);
waveArray[0] = 0.5;
waveArray[1] = 1;
waveArray[2] = 0.5;
waveArray[3] = 0;
waveArray[4] = 0.5;
waveArray[5] = 1;
waveArray[6] = 0.5;
waveArray[7] = 0;
waveArray[8] = 0.5;
valueCurve.onclick = function () {
gainNode.gain.setValueCurveAtTime(waveArray, audioCtx.currentTime, 2);
};
명세서
Specification |
---|
Web Audio API # dom-audioparam-setvaluecurveattime |
브라우저 호환성
BCD tables only load in the browser
Chrome 46 이전 버전은 선형 보간법 대신 최근린 내삽법을 사용합니다.