Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AnalyserNode: spettro FFT e forma d’onda in byte

Imposta la finestra FFT e la media temporale dello spettro, poi dimensiona due array di byte distinti per lo spettro e la forma d’onda.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const analyser = context.createAnalyser();
analyser.fftSize = windowSize;
analyser.smoothingTimeConstant = smoothing;
const spectrum = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(spectrum);
analyser.getByteTimeDomainData(waveform);

AnalyserNode analizza un segnale senza modificare l’audio che lo attraversa. Fa parte della Web Audio API, non di ECMAScript 2024; verifica che sia disponibile nell’ambiente di esecuzione di destinazione.

fftSize è il numero di campioni nella finestra della trasformata rapida di Fourier (FFT). Il valore predefinito è 2048; sono ammesse le potenze di due da 32 a 32768 inclusi. Il setter converte prima il valore assegnato nel tipo unsigned long secondo le regole di Web IDL. Se il valore ottenuto non è una dimensione ammessa, il setter genera una DOMException denominata IndexSizeError. Ad esempio, l’assegnazione di 256.5 riesce perché il valore viene convertito in 256. A frequenza di campionamento fissa, una finestra più ampia copre un intervallo di tempo maggiore e riduce la distanza tra i bin di frequenza. La proprietà di sola lettura frequencyBinCount vale sempre fftSize / 2.

smoothingTimeConstant assegna un peso alla magnitudine già mediata di ogni bin nella precedente analisi. L’intervallo va da 0 a 1 inclusi e il valore predefinito è 0.8; un valore finito fuori intervallo genera IndexSizeError. Con 0 l’analisi precedente non influisce sul risultato; con 1 i nuovi dati non influiscono sullo spettro mediato. È un peso adimensionale, non una durata in secondi. Non attenua le variazioni della forma d’onda.

getByteFrequencyData(array) scrive i livelli dei bin in un Uint8Array, convertendo i decibel in valori da 0 a 255: i livelli pari o inferiori a minDecibels danno 0, quelli pari o superiori a maxDecibels danno 255. Usa frequencyBinCount elementi. getByteTimeDomainData(array) scrive i campioni consecutivi della forma d’onda da 0 a 255; 128 indica ampiezza zero. Usa fftSize elementi per la forma d’onda completa. Entrambi i metodi restituiscono undefined e sovrascrivono l’array passato: se è troppo corto si perdono dati, mentre gli elementi in eccesso rimangono invariati. Riutilizza gli array tra le letture e adattane le dimensioni dopo aver modificato fftSize.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>AnalyserNode: silence</title>
<pre id="output"></pre>
<script>
(async () => {
  const context = new OfflineAudioContext(1, 512, 48000);
  const analyser = context.createAnalyser();
  analyser.fftSize = 256;
  analyser.smoothingTimeConstant = 0;
  analyser.connect(context.destination);

  const spectrum = new Uint8Array(analyser.frequencyBinCount).fill(42);
  const waveform = new Uint8Array(analyser.fftSize).fill(42);
  await context.startRendering();
  analyser.getByteFrequencyData(spectrum);
  analyser.getByteTimeDomainData(waveform);

  const lines = [
    `spectrum: ${spectrum.length} bins; all 0: ${spectrum.every(value => value === 0)}`,
    `waveform: ${waveform.length} samples; all 128: ${waveform.every(value => value === 128)}`
  ];
  document.getElementById('output').textContent = lines.join('\n');
  for (const line of lines) console.log(line);
})();
</script>

Risultato

spectrum: 128 bins; all 0: true
waveform: 256 samples; all 128: true

Salva l’esempio come file HTML e aprilo in un browser che supporti Web Audio e il rendering offline basato su promesse. L’esempio analizza il silenzio senza accedere al microfono né riprodurre audio. Il risultato atteso è di 128 bin a `0` e 256 campioni a `128`, al posto dei valori iniziali `42`.

Lezioni correlate

  • JavaScript · Lezione 34 · Avanzato · Versione: 4

Fonti