Web/API/AudioBufferSourceNode/detune

From Get docs


The detune property of the AudioBufferSourceNode interface is a k-rate AudioParam representing detuning of oscillation in cents.

For example, values of +100 and -100 detune the source up or down by one semitone, while +1200 and -1200 detune it up or down by one octave.

Syntax

var source = audioCtx.createBufferSource();
source.detune.value = 100; // value in cents

Note: Though the AudioParam returned is read-only, the value it represents is not.


Value

A k-rate AudioParam whose value indicates the detuning of oscillation in cents.

Example

const audioCtx = new AudioContext();

const channelCount = 2;
const frameCount = audioCtx.sampleRate * 2.0; // 2 seconds

const myArrayBuffer = audioCtx.createBuffer(channelCount, frameCount, audioCtx.sampleRate);

for (let channel = 0; channel < channelCount; channel++) {
  const nowBuffering = myArrayBuffer.getChannelData(channel);
  for (let i = 0; i < frameCount; i++) {
    nowBuffering[i] = Math.random() * 2 - 1;
  }
}

const source = audioCtx.createBufferSource();
source.buffer = myArrayBuffer;
source.connect(audioCtx.destination);
source.detune.value = 100; // value in cents
source.start();

Specifications

Specification Status Comment
Web Audio APIThe definition of 'detune' in that specification. Working Draft  

Browser compatibility

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
detune Chrome

Full support 44

Edge

Full support 13

Firefox

Full support 40

IE

No support No

Opera

Full support 31

Safari

No support No

WebView Android

Full support 44

Chrome Android

Full support 44

Firefox Android

Full support 40

Opera Android

Full support 32

Safari iOS

?

Samsung Internet Android

Full support 4.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown


See also