AnalyserNode

AnalyserNode интерфейс который предоставляет частоту (frequency) в реальном времени.  Элемент AudioNode который пропускает аудиопоток неизменным от ввода (input) до вывода (output), но позволяет использовать генерируемые данные, обрабатывать или создавать аудиовизуализацию.

AnalyserNode имеет только один ввод и один вывод. Узел работает даже если вывод не подсоединен.

Without modifying the audio stream, the node allows to get the frequency and time-domain data associated to it, using a FFT.

Количество входов 1
Количество выводов 1 (but may be left unconnected)
Channel count mode "explicit"
Количество коналов 1
Channel interpretation "speakers"

Наследование

Интерфейс унаследован от  следующих родительских интерфейсов:

Constructor

AnalyserNode()
Creates a new instance of an AnalyserNode object.

Properties

Inherits properties from its parent, AudioNode.

AnalyserNode.fftSize
Is an unsigned long value representing the size of the FFT (Fast Fourier Transform) to be used to determine the frequency domain.
AnalyserNode.frequencyBinCount Только для чтения
Is an unsigned long value half that of the FFT size. This generally equates to the number of data values you will have to play with for the visualization.
AnalyserNode.minDecibels
Is a double value representing the minimum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the minimum value for the range of results when using getByteFrequencyData().
AnalyserNode.maxDecibels
Is a double value representing the maximum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the maximum value for the range of results when using getByteFrequencyData().
AnalyserNode.smoothingTimeConstant
Is a double value representing the averaging constant with the last analysis frame — basically, it makes the transition between values over time smoother.

Methods

Inherits methods from its parent, AudioNode.

AnalyserNode.getFloatFrequencyData()
Copies the current frequency data into a Float32Array array passed into it.
AnalyserNode.getByteFrequencyData()
Copies the current frequency data into a Uint8Array (unsigned byte array) passed into it.
AnalyserNode.getFloatTimeDomainData()
Copies the current waveform, or time-domain, data into a Float32Array array passed into it.
AnalyserNode.getByteTimeDomainData()
Copies the current waveform, or time-domain, data into a Uint8Array (unsigned byte array) passed into it.

Examples

Note: See the guide Visualizations with Web Audio API for more information on creating audio visualizations.

Basic usage

The following example shows basic usage of an AudioContext to create an AnalyserNode, then requestAnimationFrame and <canvas> to collect time domain data repeatedly and draw an "oscilloscope style" output of the current audio input. For more complete applied examples/information, check out our Voice-change-O-matic demo (see app.js lines 128–205 for relevant code).

var audioCtx = new(window.AudioContext || window.webkitAudioContext)();
var analyser = audioCtx.createAnalyser();

// ...

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

// Get a canvas defined with ID "oscilloscope"
var canvas = document.getElementById("oscilloscope");
var canvasCtx = canvas.getContext("2d");

// draw an oscilloscope of the current audio source

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

  var sliceWidth = canvas.width * 1.0 / bufferLength;
  var x = 0;

  for (var i = 0; i < bufferLength; i++) {

    var v = dataArray[i] / 128.0;
    var 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();

Specifications

Specification Status Comment
Web Audio API
Определение 'AnalyserNode' в этой спецификации.
Рабочий черновик  

Browser compatibility

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
AnalyserNodeChrome Полная поддержка 14Edge Полная поддержка ДаFirefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
AnalyserNode() constructorChrome Полная поддержка 55Edge ? Firefox Полная поддержка 53IE Нет поддержки НетOpera Полная поддержка 42Safari ? WebView Android Полная поддержка 55Chrome Android Полная поддержка 55Firefox Android Полная поддержка 53Opera Android Полная поддержка 42Safari iOS ? Samsung Internet Android Полная поддержка 6.0
fftSizeChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
frequencyBinCountChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getByteFrequencyDataChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getByteTimeDomainDataChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getFloatFrequencyDataChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getFloatTimeDomainDataChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Нет поддержки НетWebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS ? Samsung Internet Android Полная поддержка Да
maxDecibelsChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
minDecibelsChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
smoothingTimeConstantChrome Полная поддержка 14Edge Полная поддержка 12Firefox Полная поддержка 25IE Нет поддержки НетOpera Полная поддержка 15Safari Полная поддержка 6WebView Android Полная поддержка ДаChrome Android Полная поддержка 18Firefox Android Полная поддержка 26Opera Android Полная поддержка 14Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Совместимость неизвестна  
Совместимость неизвестна

See also