此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

AnalyserNode:getByteTimeDomainData() 方法

基线
广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

AnalyserNode 接口的 getByteTimeDomainData() 方法把当前波形(时域)数据复制到传入的 Uint8Array(无符号字节数组)中。

如果数组的元素个数少于 AnalyserNode.fftSize,多出的数据会被丢弃。如果元素多于所需,多出的数组元素会被忽略。

语法

js
getByteTimeDomainData(array)

参数

array

时域数据将复制到的 Uint8Array。如果数组的元素个数少于 AnalyserNode.fftSize,多出的数据会被丢弃。如果元素多于所需,多出的数组元素会被忽略。

返回值

无(undefined)。

示例

下面的示例展示了如何使用 AudioContext 创建 AnalyserNode,再借助 requestAnimationFrame 和 <canvas> 反复采集时域数据,并绘制当前音频输入的“示波器风格”输出。如需更完整的应用示例或信息,请查看我们的变声器演示(相关代码见 app.js 第 108–193 行)。

js
const audioCtx = new AudioContext();
const analyser = audioCtx.createAnalyser();

// …

analyser.fftSize = 2048;
const bufferLength = analyser.fftSize;
const dataArray = new Uint8Array(bufferLength);
analyser.getByteTimeDomainData(dataArray);

// 绘制当前音频源的示波器
function draw() {
  drawVisual = requestAnimationFrame(draw);
  analyser.getByteTimeDomainData(dataArray);

  canvasCtx.fillStyle = "rgb(200 200 200)";
  canvasCtx.fillRect(0, 0, WIDTH, HEIGHT);

  canvasCtx.lineWidth = 2;
  canvasCtx.strokeStyle = "rgb(0 0 0)";

  const sliceWidth = (WIDTH * 1.0) / bufferLength;
  let x = 0;

  canvasCtx.beginPath();
  for (let i = 0; i < bufferLength; i++) {
    const v = dataArray[i] / 128.0;
    const y = (v * HEIGHT) / 2;

    if (i === 0) {
      canvasCtx.moveTo(x, y);
    } else {
      canvasCtx.lineTo(x, y);
    }

    x += sliceWidth;
  }

  canvasCtx.lineTo(WIDTH, HEIGHT / 2);
  canvasCtx.stroke();
}

draw();

规范

规范
Web Audio API
# dom-analysernode-getbytetimedomaindata

浏览器兼容性

参见