The exponentialRampToValueAtTime()
method of the AudioParam
Interface schedules a gradual exponential change in the value of the AudioParam
. The change starts at the time specified for the previous event, follows an exponential ramp to the new value given in the value
parameter, and reaches the new value at the time given in the endTime
parameter.
Note: Exponential ramps are considered more useful when changing frequencies or playback rates than linear ramps because of the way the human ear works.
var AudioParam = AudioParam.exponentialRampToValueAtTime(value, endTime)
AudioParam
will ramp to by the given time.A reference to this AudioParam
object. In some browsers older implementations of this interface return void.
In this example, we have a media source with two control buttons (see the audio-param repo for the source code, or view the example live.) When these buttons are pressed, exponentialRampToValueAtTime()
is used to fade the gain value up to 1.0, and down to 0, respectively. This is pretty useful for fade in/fade out effects:
// create audio context var AudioContext = window.AudioContext || window.webkitAudioContext; var audioCtx = new AudioContext(); // set basic variables for example 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'); // Create a MediaElementAudioSourceNode // Feed the HTMLMediaElement into it var source = audioCtx.createMediaElementSource(myAudio); // Create a gain node and set its gain value to 0.5 var gainNode = audioCtx.createGain(); // connect the AudioBufferSourceNode to the gainNode // and the gainNode to the destination gainNode.gain.setValueAtTime(0, audioCtx.currentTime); source.connect(gainNode); gainNode.connect(audioCtx.destination); // set buttons to do something onclick expRampPlus.onclick = function() { gainNode.gain.exponentialRampToValueAtTime(1.0, audioCtx.currentTime + 2); } expRampMinus.onclick = function() { gainNode.gain.exponentialRampToValueAtTime(0.01, audioCtx.currentTime + 2); }
Note: A value of 0.01 was used for the value to ramp down to in the last function rather than 0, as an invalid or illegal string error is thrown if 0 is used — the value needs to be positive.
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'exponentialRampToValueAtTime' in that specification. | Working Draft |
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 14 | Yes | 25 | No | 15 | 6 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | Yes | 14 | Yes | 26 | No | 15 | ? |
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioParam/exponentialRampToValueAtTime