AnalyserNode: thuộc tính minDecibels
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Thuộc tính minDecibels của giao diện AnalyserNode là 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().
Giá trị
Một giá trị double, biểu diễn giá trị decibel nhỏ nhất để tỉ lệ hóa dữ liệu phân tích FFT, trong đó 0 dB là âm thanh lớn nhất có thể, -10 dB là một phần mười của mức đó, v.v. Giá trị mặc định là -100 dB.
Khi lấy dữ liệu từ getByteFrequencyData(), mọi tần số có biên độ bằng hoặc thấp hơn minDecibels sẽ được trả về là 0.
Note:
Nếu đặt một giá trị lớn hơn AnalyserNode.maxDecibels, một ngoại lệ INDEX_SIZE_ERR sẽ được ném ra.
Ví dụ
Ví dụ sau minh họa cách dùng cơ bản của AudioContext để tạo AnalyserNode, rồi dùng requestAnimationFrame và <canvas> để liên tục thu thập dữ liệu tần số và vẽ đầu ra kiểu "winamp bar graph" 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.minDecibels = -90;
analyser.maxDecibels = -10;
// …
analyser.fftSize = 256;
const bufferLength = analyser.frequencyBinCount;
console.log(bufferLength);
const dataArray = new Uint8Array(bufferLength);
canvasCtx.clearRect(0, 0, WIDTH, HEIGHT);
function draw() {
drawVisual = requestAnimationFrame(draw);
analyser.getByteFrequencyData(dataArray);
canvasCtx.fillStyle = "rgb(0 0 0)";
canvasCtx.fillRect(0, 0, WIDTH, HEIGHT);
const barWidth = (WIDTH / bufferLength) * 2.5;
let barHeight;
let x = 0;
for (let i = 0; i < bufferLength; i++) {
barHeight = dataArray[i];
canvasCtx.fillStyle = `rgb(${barHeight + 100} 50 50)`;
canvasCtx.fillRect(x, HEIGHT - barHeight / 2, barWidth, barHeight / 2);
x += barWidth + 1;
}
}
draw();
Thông số kỹ thuật
| Specification |
|---|
| Web Audio API # dom-analysernode-mindecibels |