BiquadFilterNode.frequency

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

La propriété frequency de l'interface BiquadFilterNode est un AudioParam de type k-rate : un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage courant, exprimée en hertz (Hz).

Sa valeur par défaut est de 350 avec une portée nominale de 10 à la fréquence de Nyquist, qui est la moitié de la fréquence d'échantillonnage.

Syntaxe

js
var contexteAudio = new AudioContext();
var filtreBiquad = contexteAudio.createBiquadFilter();
filtreBiquad.frequency.value = 3000;

Note : Bien que le AudioParam renvoyé soit en lecture seule, la valeur qu'il représente ne l'est pas.

Valeur

Un AudioParam.

Exemple

L'exemple suivant montre l'utilisation basique d'un AudioContext pour créer un filtre Biquad. Pour un exemple complet, consultez notre démo voice-change-o-matic (et son code source).

js
var contexteAudio = new (window.AudioContext || window.webkitAudioContext)();

// mise en place des différents noeuds audio que nous utiliserons par la suite
var analyseur = contexteAudio.createAnalyser();
var distortion = contexteAudio.createWaveShaper();
var noeudGain = contexteAudio.createGain();
var filtreBiquad = contexteAudio.createBiquadFilter();
var convolution = contexteAudio.createConvolver();

// connecte les noeuds ensemble

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyseur);
analyseur.connect(distortion);
distortion.connect(filtreBiquad);
biquadFilter.connect(convolution);
convolution.connect(noeudGain);
noeudGain.connect(contexteAudio.destination);

// manipule le filtre Biquad

filtreBiquad.type = "lowshelf";
filtreBiquad.frequency.value = 1000;
filtreBiquad.gain.value = 25;

Spécifications

Specification
Web Audio API
# dom-biquadfilternode-frequency

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi