モジュール javafx.media

パッケージ javafx.scene.media

クラスAudioEqualizer

java.lang.Object

javafx.scene.media.AudioEqualizer

public final class AudioEqualizer
extends Object

AudioEqualizerクラスは、メディア・プレイヤに音声等化コントロールを提供します。 これには、EqualizerBand要素のObservableListが含まれます。 各AudioEqualizerインスタンスはMediaPlayerに接続され、MediaPlayer.getAudioEqualizerメソッドを使用して取得できます。

導入されたバージョン:

JavaFX 2.0

関連項目:

MediaPlayer、EqualizerBand

プロパティのサマリー

プロパティ

Type	プロパティ	説明
BooleanProperty	enabled	AudioEqualizerを有効または無効にします。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static int	MAX_NUM_BANDS	AudioEqualizerに含めることができるバンドの最大数。

メソッドのサマリー

修飾子と型	メソッド	説明
BooleanProperty	enabledProperty()	AudioEqualizerを有効または無効にします。
ObservableList<EqualizerBand>	getBands()	EqualizerBand要素を含むObservableList。
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を有効または無効にします。 有効化されたプロパティが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()

EqualizerBand要素を含むObservableList。 シーケンスのコンテンツは、EqualizerBand要素を追加または削除することによって変更できます。 要素を追加するときは、新しく追加されたインスタンスが有効でない場合、内部リストへの変更を拒否することができるため、ユーザーはIllegalArgumentExceptionを捕まえる準備が必要です。

有効なEqualizerBandインスタンスの制約は次のとおりです。

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

デフォルトのバンド・セットは次の表に示すとおりで、すべてのバンドがユニティ・ゲイン(0 dB)を持ちます。

AudioEqualizerバンド表

バンド・インデックス	中心周波数(Hz)	帯域幅(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

戻り値:

EqualizerBand要素を含むObservableList。

setEnabled

public final void setEnabled(boolean value)

プロパティenabledの値を設定します。

プロパティの説明:

AudioEqualizerを有効または無効にします。 有効化されたプロパティがfalseに設定されている場合は、AudioEqualizer設定は保持されますが、再生時には考慮されず、すべてのEqualizerBand.gainプロパティをゼロに設定することと同等になります。

デフォルト値:

true

isEnabled

public final boolean isEnabled()

プロパティenabledの値を取得します。

プロパティの説明:

AudioEqualizerを有効または無効にします。 有効化されたプロパティがfalseに設定されている場合は、AudioEqualizer設定は保持されますが、再生時には考慮されず、すべてのEqualizerBand.gainプロパティをゼロに設定することと同等になります。

デフォルト値:

true

enabledProperty

public BooleanProperty enabledProperty()

AudioEqualizerを有効または無効にします。 有効化されたプロパティがfalseに設定されている場合は、AudioEqualizer設定は保持されますが、再生時には考慮されず、すべてのEqualizerBand.gainプロパティをゼロに設定することと同等になります。

デフォルト値:

true

関連項目:

isEnabled()、setEnabled(boolean)