Класс AudioEqualizer

java.lang.Object

javafx.scene.media.AudioEqualizer

public final class AudioEqualizer extends Object

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

Since:

JavaFX 2.0

См. также:

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

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

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

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

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

Модификатор и тип	Метод	Описание
`BooleanProperty`	`enabledProperty()`	Включает или отключает `AudioEqualizer`.
`final ObservableList<EqualizerBand>`	`getBands()`	ObservableList, содержащий элементы `EqualizerBand`.
`final boolean`	`isEnabled()`	Возвращает значение свойства `enabled`.
`final 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)
enabledProperty()

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

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

Параметры:

value - значение для свойства enabled

См. также:

isEnabled()
enabledProperty()

isEnabled

public final boolean isEnabled()

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

Описание свойства:

Значение по умолчанию:

true

Возвращает:

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

См. также:

setEnabled(boolean)
enabledProperty()

enabledProperty

public BooleanProperty enabledProperty()

Значение по умолчанию:

true

Возвращает:

свойство enabled

См. также:

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.