Spec-Zone.ru › Web APIs

BiquadFilterNode

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

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

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Интерфейс BiquadFilterNode представляет собой простой фильтр низкого порядка и создается с помощью метода BaseAudioContext/createBiquadFilter. Он является AudioNode, который может представлять различные виды фильтров, устройств управления тоном и графических эквалайзеров. У BiquadFilterNode всегда ровно один вход и один выход.

EventTarget 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 Описание frequency Q gain
lowpass Стандартный резонансный фильтр нижних частот второго порядка с крутизной спада 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

См. также

  • Использование 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API