CKTIS / JavaScript
AnalyserNode — spectre audio et forme d’onde
AnalyserNode expose le spectre de fréquences et des échantillons de forme d’onde sans modifier le son qui le traverse.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const analyser = new AnalyserNode(context, { fftSize: 2048, smoothingTimeConstant: 0.8 });AnalyserNode analyse l’audio sans le modifier. Il s’agit de la Web Audio API, et non d’ECMAScript ; Node 24 ne garantit pas la prise en charge par les navigateurs. Vérifiez la disponibilité des constructeurs utilisés.
AnalyserNode.fftSize définit la taille de la FFT : une puissance de deux comprise entre 32 et 32768, avec 2048 par défaut. Une taille plus grande améliore la résolution fréquentielle, au prix d’une fenêtre plus longue. La propriété en lecture seule AnalyserNode.frequencyBinCount vaut fftSize / 2. Si la taille obtenue après la conversion Web IDL en unsigned long n’est pas valide, une exception IndexSizeError est levée. La conversion peut tronquer la partie fractionnaire et donner une taille valide : par exemple, 32.5 devient 32.
AnalyserNode.smoothingTimeConstant lisse le spectre : plage de 0 à 1, valeur par défaut 0.8 ; 0 désactive le lissage. Elle ne lisse pas la forme d’onde. Une valeur finie hors de la plage de 0 à 1 déclenche IndexSizeError. En revanche, une valeur non finie comme NaN déclenche TypeError lors de la conversion Web IDL, avant la vérification de la plage.
AnalyserNode.getByteFrequencyData(array) remplit un Uint8Array de valeurs de 0 à 255, mises à l’échelle à l’aide de minDecibels et maxDecibels, et non en hertz. AnalyserNode.getByteTimeDomainData(array) écrit les échantillons de forme d’onde : le silence correspond à 128. Les tailles des tableaux sont respectivement frequencyBinCount et fftSize ; les tableaux plus courts tronquent les données, tandis que les éléments en excès restent inchangés.
Exemples
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);Résultat
32 16 32
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.