BiquadFilterNode: свойство gain

Базовая Широко доступная

Это функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.

Свойство gain интерфейса BiquadFilterNode является параметром a-rate AudioParam — числом с плавающей точкой, представляющим коэффициент усиления, используемый в текущем алгоритме фильтрации.

При положительном значении оно представляет реальный коэффициент усиления, при отрицательном — затухание.

Выражается в дБ, имеет значение по умолчанию 0, и может принимать значения в номинальном диапазоне от -40 до 40.

Значение

Объект AudioParam.

Примечание: Хотя возвращаемое значение AudioParam является только для чтения, само значение не является постоянным.

Примеры

Следующий пример демонстрирует базовое использование AudioContext для создания узла фильтра Biquad. Для более полных примеров/информации ознакомьтесь с нашим демо Voice-change-O-matic (см. строки 108–193 в app.js для соответствующего кода).

const audioCtx = new AudioContext();

//set up the different audio nodes we will use for the app
const analyser = audioCtx.createAnalyser();
const distortion = audioCtx.createWaveShaper();
const gainNode = audioCtx.createGain();
const biquadFilter = audioCtx.createBiquadFilter();
const convolver = audioCtx.createConvolver();

// connect the nodes together

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyser);
analyser.connect(distortion);
distortion.connect(biquadFilter);
biquadFilter.connect(convolver);
convolver.connect(gainNode);
gainNode.connect(audioCtx.destination);

// Manipulate the Biquad filter

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

Спецификации

Спецификация
Web Audio API # dom-biquadfilternode-gain

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`gain`	14	12	25	15	6	18	25	14	6	1.0	4.4.3

См. также

Использование Web Audio API

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode/gain