Класс 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 |
getBands() |
ObservableList, содержащий элементы EqualizerBand. |
final boolean |
isEnabled() |
Возвращает значение свойства enabled. |
final void |
setEnabled |
Устанавливает значение свойства enabled. |
Подробное описание свойств
enabled
public BooleanProperty enabledProperty
Включает или выключает
AudioEqualizer. Если свойство enabled установлено в false, настройки AudioEqualizer сохраняются, но не учитываются во время воспроизведения, что эквивалентно установке всех свойств EqualizerBand.gain в ноль.- Значение по умолчанию:
true- См. также:
Подробное описание полей
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 дБ).
| Индекс полосы | Центральная частота (Гц) | Ширина полосы (Гц) |
|---|---|---|
| 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
public final boolean isEnabled()
Возвращает значение свойства
enabled.- Описание свойства:
- Включает или выключает
AudioEqualizer. Если свойство enabled установлено вfalse, настройкиAudioEqualizerсохраняются, но не учитываются во время воспроизведения, что эквивалентно установке всех свойствEqualizerBand.gainв ноль. - Значение по умолчанию:
true- Возвращает:
- значение свойства
enabled - См. также:
enabledProperty
public BooleanProperty enabledProperty()
Включает или выключает
AudioEqualizer. Если свойство enabled установлено в false, настройки AudioEqualizer сохраняются, но не учитываются во время воспроизведения, что эквивалентно установке всех свойств EqualizerBand.gain в ноль.- Значение по умолчанию:
true- Возвращает:
- свойство enabled
- См. также:
© 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.