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

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
frequency

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi