- 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)
设置启用属性的值。
-
-
-
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)
-
-