Module javafx.media

软件包 javafx.scene.media

Class 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

Property Summary

Properties

Type	Property	描述
BooleanProperty	enabled	启用或禁用 AudioEqualizer 。

Field Summary

Fields

Modifier and Type	Field	描述
static int	MAX_NUM_BANDS	AudioEqualizer可能包含的最大频带数。

方法摘要

Modifier and Type	方法	描述
BooleanProperty	enabledProperty()	启用或禁用 AudioEqualizer 。
ObservableList<EqualizerBand>	getBands()	ObservableList包含EqualizerBand元素。
boolean	isEnabled()	获取启用属性的值。
void	setEnabled(boolean value)	设置启用属性的值。

Methods inherited from class java.lang.Object

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

Property Detail

enabled

public BooleanProperty enabledProperty

启用或禁用AudioEqualizer 。 如果启用的属性设置为false ，则在播放期间保留AudioEqualizer设置，但不考虑其设置，这相当于将所有EqualizerBand.gain属性设置为零。

Default value:

true

另请参见：

isEnabled() ， setEnabled(boolean)

字段详细信息

MAX_NUM_BANDS

public static final int MAX_NUM_BANDS

AudioEqualizer可能包含的最大频带数。 在当前的实现中，该值为64 。

另请参见：

Constant Field Values

方法详细信息

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

默认的乐队组如下表所示; 所有频带具有单位增益（0dB）。

AudioEqualizer Band Table Band Index Center Frequency (Hz) Bandwidth (Hz) 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)

设置启用属性的值。

Property description:

启用或禁用AudioEqualizer 。 如果启用的属性设置为false ，则在播放期间保留AudioEqualizer设置，但不考虑设置，这相当于将所有EqualizerBand.gain属性设置为零。

Default value:

true

isEnabled

public final boolean isEnabled()

获取启用属性的值。

Property description:

启用或禁用AudioEqualizer 。 如果启用的属性设置为false ，则在播放期间保留AudioEqualizer设置，但不考虑其中的设置，这相当于将所有EqualizerBand.gain属性设置为零。

Default value:

true

enabledProperty

public BooleanProperty enabledProperty()

启用或禁用AudioEqualizer 。 如果启用的属性设置为false ，则在播放期间保留AudioEqualizer设置，但不考虑其中的设置，这相当于将所有EqualizerBand.gain属性设置为零。

Default value:

true

另请参见：

isEnabled(), setEnabled(boolean)