BiquadFilterNode
Базовая линия Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузера. Она доступна во всех браузерах с апреля 2021 года.
Интерфейс BiquadFilterNode представляет собой простой фильтр низкого порядка и создается с помощью метода BaseAudioContext/createBiquadFilter. Он является AudioNode, который может представлять различные виды фильтров, устройств управления тоном и графических эквалайзеров. У BiquadFilterNode всегда ровно один вход и один выход.
| Количество входов | 1 |
|---|---|
| Количество выходов | 1 |
| Режим количества каналов | "max" |
| Количество каналов |
2 (не используется в режиме по умолчанию) |
| Интерпретация каналов | "speakers" |
Конструктор
BiquadFilterNode()-
Создает новый экземпляр объекта
BiquadFilterNode.
Свойства экземпляра
Наследует свойства от родительского класса AudioNode.
Примечание: Хотя возвращаемые объекты AudioParam являются только для чтения, значения, которые они представляют, — нет.
-
BiquadFilterNode.frequencyТолько для чтения -
Параметр a-rate
AudioParam, двойное значение, представляющее частоту в текущем алгоритме фильтрации, измеренную в герцах (Гц). -
BiquadFilterNode.detuneТолько для чтения -
Параметр a-rate
AudioParam, представляющий собой девиацию частоты в цента́х. -
BiquadFilterNode.QТолько для чтения -
Параметр a-rate
AudioParam, двойное значение, представляющее собой коэффициент качества (Q-фактор). -
BiquadFilterNode.gainТолько для чтения -
Параметр a-rate
AudioParam, двойное значение, представляющее собой усиление, используемое в текущем алгоритме фильтрации. BiquadFilterNode.type-
Строковое значение, определяющее тип алгоритма фильтрации, реализуемого узлом.
Значение различных параметров в зависимости от типа фильтра (девиация имеет одинаковое значение, поэтому не указана ниже) typeОписание frequencyQgainlowpassСтандартный резонансный фильтр нижних частот второго порядка с крутизной спада 12 дБ/октаву. Частоты ниже частоты среза проходят; частоты выше нее затухают. Частота среза. Указывает, насколько пикообразной является частота около частоты среза. Чем больше значение, тем больше пик. Не используется highpassСтандартный резонансный фильтр верхних частот второго порядка с крутизной спада 12 дБ/октаву. Частоты ниже частоты среза затухают; частоты выше нее проходят. Частота среза. Указывает, насколько пикообразной является частота около частоты среза. Чем больше значение, тем больше пик. Не используется bandpassСтандартный полосовой фильтр второго порядка. Частоты вне заданного диапазона затухают; частоты внутри него проходят. Центр диапазона частот. Определяет ширину полосы частот. Чем больше значение, тем уже полоса частот. Не используется lowshelfСтандартный фильтр нижних полос второго порядка. Частоты ниже частоты получают усиление или затухание; частоты выше нее остаются неизменными. Верхняя граница частот, которые получают усиление или затухание. Не используется Усиление, в дБ, которое должно быть применено; если отрицательно, это будет затухание. highshelfСтандартный фильтр верхних полос второго порядка. Частоты выше частоты получают усиление или затухание; частоты ниже нее остаются неизменными. Нижняя граница частот, которые получают усиление или затухание. Не используется Усиление, в дБ, которое должно быть применено; если отрицательно, это будет затухание. peakingЧастоты внутри диапазона получают усиление или затухание; частоты вне его остаются неизменными. Середина диапазона частот, которая получает усиление или затухание. Определяет ширину полосы частот. Чем больше значение, тем уже полоса частот. Усиление, в дБ, которое должно быть применено; если отрицательно, это будет затухание. notchСтандартный режекторный фильтр (notch), также называемый фильтром полосы подавления или режекции. Это противоположность полосовому фильтру: частоты вне заданного диапазона проходят; частоты внутри него затухают. Центр диапазона частот. Определяет ширину полосы частот. Чем больше значение, тем уже полоса частот. Не используется allpassСтандартный всепропускной фильтр второго порядка. Он пропускает все частоты, но изменяет фазовые соотношения между различными частотами. Частота с максимальной групповой задержкой, то есть частота, где происходит центральный переход фазы. Определяет резкость перехода на средней частоте. Чем больше этот параметр, тем резче и шире переход. Не используется
Методы экземпляра
Наследует методы от родительского класса AudioNode.
BiquadFilterNode.getFrequencyResponse()-
Этот метод на основе текущих настроек параметров фильтра рассчитывает частотную характеристику для частот, указанных в предоставленном массиве частот.
Пример
См. AudioContext.createBiquadFilter для примера кода, показывающего, как использовать AudioContext для создания узла фильтра Biquad.
Спецификации
| Спецификация |
|---|
| Web Audio API # BiquadFilterNode |
Совместимость с браузерами
| Стационарные компьютеры | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome для Android | Firefox для Android | Opera для Android | Safari в iOS | Samsung Internet | WebView для Android | |
BiquadFilterNode |
55 | 79 | 53 | 42 | 14.1 | 55 | 53 | 42 | 14.5 | 6.0 | 55 |
Q |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
BiquadFilterNode |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
detune |
25 | 12 | 25 | 15 | 7 | 25 | 25 | 14 | 7 | 1.5 | ≤37 |
frequency |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
gain |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
getFrequencyResponse |
17 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
type |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
См. также
© 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