Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AnalyserNode — spettro audio e forma d’onda

AnalyserNode rende disponibili lo spettro delle frequenze e i campioni della forma d’onda senza modificare l’audio che lo attraversa.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });

AnalyserNode analizza l’audio senza modificarlo. Fa parte della Web Audio API, non di ECMAScript; Node 24 non dimostra il supporto nei browser. Verifica la disponibilità dei costruttori utilizzati.

AnalyserNode.fftSize imposta la dimensione della FFT: una potenza di due da 32 a 32768 inclusi, con valore predefinito 2048. Dimensioni maggiori migliorano la risoluzione in frequenza, ma richiedono una finestra più lunga. La proprietà di sola lettura AnalyserNode.frequencyBinCount è pari a fftSize / 2. Se la dimensione non è valida dopo la conversione Web IDL in unsigned long, viene generato IndexSizeError. La conversione può troncare la parte frazionaria e produrre una dimensione valida: per esempio, 32.5 diventa 32.

AnalyserNode.smoothingTimeConstant attenua le variazioni dello spettro: intervallo 0–1, valore predefinito 0.8; 0 disattiva l’attenuazione. Non attenua la forma d’onda. Un valore finito al di fuori dell’intervallo 0–1 genera IndexSizeError, mentre un valore non finito come NaN genera TypeError durante la conversione Web IDL, prima del controllo dell’intervallo.

AnalyserNode.getByteFrequencyData(array) riempie un Uint8Array con valori da 0 a 255, scalati usando minDecibels e maxDecibels, non espressi in hertz. AnalyserNode.getByteTimeDomainData(array) scrive i campioni della forma d’onda: il silenzio corrisponde a 128. Le dimensioni dei buffer sono rispettivamente frequencyBinCount e fftSize; i buffer più corti troncano i dati, mentre gli elementi in eccesso restano invariati.

Esempi

const context = new OfflineAudioContext(1, 128, 48000);
const analyser = new AnalyserNode(context, {
  fftSize: 32,
  smoothingTimeConstant: 0
});
const frequency = new Uint8Array(analyser.frequencyBinCount);
const waveform = new Uint8Array(analyser.fftSize);
analyser.getByteFrequencyData(frequency);
analyser.getByteTimeDomainData(waveform);
console.log(analyser.fftSize, frequency.length, waveform.length);

Risultato

32 16 32

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti