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 上查看此页面 • 报告此内容的潜在问题