Класс AudioEqualizer

java.lang.Object

javafx.scene.media.AudioEqualizer

public final class AudioEqualizer
extends Object

Класс AudioEqualizer предоставляет управление эквалайзером звука для медиаплеера. Он содержит ObservableList элементов EqualizerBand. Каждый экземпляр AudioEqualizer подключен к MediaPlayer и может быть получен с помощью метода MediaPlayer.getAudioEqualizer.

С момента:: JavaFX 2.0
См. также:: MediaPlayer, EqualizerBand

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`enabled`	Включает или выключает `AudioEqualizer`.

Краткое описание полей

Поля
Модификатор и тип	Поле	Описание
`static int`	`MAX_NUM_BANDS`	Максимальное количество полос, которое может содержать `AudioEqualizer`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`BooleanProperty`	`enabledProperty()`	Включает или выключает `AudioEqualizer`.
`ObservableList<EqualizerBand>`	`getBands()`	`EqualizerBand` содержащий элементы .
`boolean`	`isEnabled()`	Возвращает значение свойства enabled.
`void`	`setEnabled(boolean value)`	Устанавливает значение свойства enabled.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание свойств

enabled

public BooleanProperty enabledProperty

Включает или выключает AudioEqualizer. Если свойство enabled установлено в значение false, настройки AudioEqualizer сохраняются, но не учитываются при воспроизведении, что эквивалентно установке всех свойств EqualizerBand.gain в ноль.

Значение по умолчанию:: true
См. также:: isEnabled(), setEnabled(boolean)

Подробное описание полей

MAX_NUM_BANDS

public static final int MAX_NUM_BANDS

Максимальное количество полос, которое может содержать AudioEqualizer. В текущей реализации это значение равно 64.

См. также:: Постоянные значения полей

Подробное описание методов

getBands

public final ObservableList<EqualizerBand> getBands()

ObservableList, содержащий элементы EqualizerBand. Содержимое последовательности может быть изменено путем добавления или удаления элементов EqualizerBand. При добавлении элементов пользователь должен быть готов перехватить исключения IllegalArgumentException, так как любые изменения во внутреннем списке могут быть отклонены, если новый добавленный экземпляр недействителен.

Ограничения для действительного экземпляра EqualizerBand:

EqualizerBand.centerFrequency > 0
EqualizerBand.bandwidth > 0
EqualizerBand.MIN_GAIN ≤ EqualizerBand.gain ≤ EqualizerBand.MAX_GAIN

Набор полос по умолчанию представлен в следующей таблице; все полосы имеют единичный коэффициент усиления (0 дБ).

Таблица полос AudioEqualizer
Индекс полосы	Центральная частота (Гц)	Полоса пропускания (Гц)
0	32	19
1	64	39
2	125	78
3	250	156
4	500	312
5	1000	625
6	2000	1250
7	4000	2500
8	8000	5000
9	16000	10000

Возвращает:: ObservableList, содержащий элементы EqualizerBand.

setEnabled

public final void setEnabled(boolean value)

Устанавливает значение свойства enabled.

Описание свойства:: Включает или выключает AudioEqualizer. Если свойство enabled установлено в значение false, настройки AudioEqualizer сохраняются, но не учитываются при воспроизведении, что эквивалентно установке всех свойств EqualizerBand.gain в ноль.
Значение по умолчанию:: true

isEnabled

public final boolean isEnabled()

Возвращает значение свойства enabled.

Описание свойства:: Включает или выключает AudioEqualizer. Если свойство enabled установлено в значение false, настройки AudioEqualizer сохраняются, но не учитываются при воспроизведении, что эквивалентно установке всех свойств EqualizerBand.gain в ноль.
Значение по умолчанию:: true

enabledProperty

public BooleanProperty enabledProperty()

Значение по умолчанию:: true
См. также:: isEnabled(), setEnabled(boolean)

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.