AnalyserNode

Bộ khởi tạo

AnalyserNode()

Tạo một thể hiện mới của đối tượng AnalyserNode.

Thuộc tính thể hiện

Kế thừa các thuộc tính từ lớp cha AudioNode.

AnalyserNode.fftSize

Một giá trị unsigned long biểu diễn kích thước của FFT (Fast Fourier Transform) dùng để xác định miền tần số.

AnalyserNode.frequencyBinCount Read only

Một giá trị unsigned long bằng một nửa kích thước FFT. Về cơ bản, đây là số lượng giá trị dữ liệu mà bạn có thể dùng cho phần hiển thị trực quan.

AnalyserNode.minDecibels

Một giá trị double biểu diễn giá trị công suất nhỏ nhất trong khoảng tỉ lệ cho dữ liệu phân tích FFT, để chuyển sang giá trị byte không dấu. Nói cách khác, thuộc tính này xác định giá trị nhỏ nhất của dải kết quả khi dùng getByteFrequencyData().

AnalyserNode.maxDecibels

Một giá trị double biểu diễn giá trị công suất lớn nhất trong khoảng tỉ lệ cho dữ liệu phân tích FFT, để chuyển sang giá trị byte không dấu. Nói cách khác, thuộc tính này xác định giá trị lớn nhất của dải kết quả khi dùng getByteFrequencyData().

AnalyserNode.smoothingTimeConstant

Một giá trị double biểu diễn hằng số trung bình với khung phân tích gần nhất. Nói cách khác, nó giúp các thay đổi giá trị theo thời gian trở nên mượt hơn.

Phương thức thể hiện

Kế thừa các phương thức từ lớp cha AudioNode.

AnalyserNode.getFloatFrequencyData()

Sao chép dữ liệu tần số hiện tại vào một mảng Float32Array được truyền vào.

AnalyserNode.getByteFrequencyData()

Sao chép dữ liệu tần số hiện tại vào một mảng Uint8Array (mảng byte không dấu) được truyền vào.

AnalyserNode.getFloatTimeDomainData()

Sao chép dạng sóng hiện tại, hay dữ liệu miền thời gian, vào một mảng Float32Array được truyền vào.

AnalyserNode.getByteTimeDomainData()

Sao chép dạng sóng hiện tại, hay dữ liệu miền thời gian, vào một mảng Uint8Array (mảng byte không dấu) được truyền vào.

Ví dụ

Dùng cơ bản

Ví dụ sau minh họa cách dùng cơ bản của AudioContext để tạo một AnalyserNode, sau đó dùng requestAnimationFrame và <canvas> để liên tục thu thập dữ liệu miền thời gian và vẽ đầu ra kiểu "dao động ký" của đầu vào âm thanh hiện tại. Để xem các ví dụ và thông tin áp dụng đầy đủ hơn, hãy xem bản demo Voice-change-O-matic của chúng tôi (xem app.js dòng 108-193 để biết đoạn mã liên quan).

const audioCtx = new AudioContext();

// …

const analyser = audioCtx.createAnalyser();
analyser.fftSize = 2048;

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

// Kết nối nguồn cần được phân tích
source.connect(analyser);

// Lấy canvas đã được định nghĩa với ID "oscilloscope"
const canvas = document.getElementById("oscilloscope");
const canvasCtx = canvas.getContext("2d");

// vẽ một dao động ký của nguồn âm thanh hiện tại

function draw() {
  requestAnimationFrame(draw);

  analyser.getByteTimeDomainData(dataArray);

  canvasCtx.fillStyle = "rgb(200 200 200)";
  canvasCtx.fillRect(0, 0, canvas.width, canvas.height);

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

  canvasCtx.beginPath();

  const sliceWidth = (canvas.width * 1.0) / bufferLength;
  let x = 0;

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

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

    x += sliceWidth;
  }

  canvasCtx.lineTo(canvas.width, canvas.height / 2);
  canvasCtx.stroke();
}

draw();

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• Dùng Web Audio API