AudioParam.exponentialRampToValueAtTime()

AudioParam 인터페이스의 exponentialRampToValueAtTime() 메서드는 AudioParam의 값에 점진적인 지수적 변화를 예정합니다. 변화는 이전 이벤트에 명시된 시간에 시작해, 지수적 경사(ramp)를 따라 value 매개변수에 주어진 새로운 값으로 향하고, endTime 매개변수에 주어진 시간에 새로운 값에 도달합니다.

참고: 사람의 귀가 작동하는 방식 때문에, 주파수나 playback rate를 변화시킬 때 지수적 경사는 선형적 경사에 비해 더욱 유용한 것으로 여겨집니다.

구문

js
var AudioParam = AudioParam.exponentialRampToValueAtTime(value, endTime);

매개변수

value

AudioParam 이 주어진 시간까지 변화될 값을 나타내는 부동소수점 수.

endTime

변화가 시작된 이후 값의 변화가 멈출 정확한 시간(단위: 초)을 나타내는 double.

반환

이 AudioParam 객체에 대한 참조. 몇몇 브라우저에서 이 인터페이스의 오래된 구현은 void를 반환합니다.

예제

이 예제에는 두 개의 제어 버튼을 가진 미디어 소스가 있습니다 (소스 코드는 audio-param repo에서 볼 수 있고, 작동 예제도 볼 수 있습니다). 이 버튼이 눌렸을 때, exponentialRampToValueAtTime() 가 사용되어 각각 gain 값을 1.0까지, 그리고 0까지 서서히 사라지게(fade) 합니다. 이 메서드는 페이드 인/페이드 아웃 이펙트에 아주 유용합니다.

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 expRampPlus = document.querySelector(".exp-ramp-plus");
var expRampMinus = document.querySelector(".exp-ramp-minus");

// MediaElementAudioSourceNode를 생성합니다
// HTMLMediaElement를 노드 내로 전달합니다
var source = audioCtx.createMediaElementSource(myAudio);

// gain 노드를 생성하고 gain 값을 0.5로 설정합니다
var gainNode = audioCtx.createGain();

// AudioBufferSourceNode를 gainNode에 연결하고
// gainNode를 destination에 연결합니다
gainNode.gain.setValueAtTime(0, audioCtx.currentTime);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);

// onclick이 발생했을 때 무언가를 하기 위해 버튼을 설정합니다
expRampPlus.onclick = function () {
  gainNode.gain.exponentialRampToValueAtTime(1.0, audioCtx.currentTime + 2);
};

expRampMinus.onclick = function () {
  gainNode.gain.exponentialRampToValueAtTime(0.01, audioCtx.currentTime + 2);
};

참고: 마지막 함수에서 변화시킬 값으로 0이 아니라 0.01의 값이 사용되었는데, 이는 만약 0이 사용된다면 invalid or illegal string 오류가 발생되기 때문입니다 — 이 값은 양수일 필요가 있습니다.

명세서

Specification
Web Audio API
# dom-audioparam-exponentialramptovalueattime

브라우저 호환성

BCD tables only load in the browser

같이 보기