AudioBufferSourceNode: detune 屬性

Baseline 已廣泛支援

此特性已得到良好支援，可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起，所有瀏覽器均已支援此特性。

AudioBufferSourceNode 介面的 detune 屬性是一個 k-rate 的 AudioParam，表示振盪的音準偏移（以音分為單位）。

例如，+100 和 -100 的值將使源音準升高或降低一個半音，而 +1200 和 -1200 則會使其升高或降低一個八度。

值

一個 k-rate 的 AudioParam，其值表示振盪的音準偏移（以音分為單位）。

注意：雖然返回的 AudioParam 是隻讀的，但它所代表的值並非如此。

示例

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();

規範

規範
Web Audio API # dom-audiobuffersourcenode-detune

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2024年7月26日，由 MDN 貢獻者貢獻。

在 GitHub 上檢視此頁面 • 報告此內容的潛在問題