- java.lang.Object
-
- javafx.scene.media.MediaPlayer
-
public final class MediaPlayer extends Object
MediaPlayer
クラスは、メディアの再生のコントロールを提供します。Media
およびMediaView
クラスとの組合せで使用し、メディアの再生を表示および制御します。MediaPlayer
にはビジュアル要素が一切含まれないため、MediaView
クラスとともに使用して、存在するすべてのビデオ・トラックを表示する必要があります。MediaPlayer
は、pause()
、play()
、stop()
およびseek()
の各コントロールに加え、すべてのタイプのメディアに適用されるrate
およびautoPlay
プロパティも提供します。 また、オーディオ再生の特性を制御する、balance
、mute
およびvolume
の各プロパティも提供します。 オーディオ品質に対するより詳細な制御は、プレイヤに関連付けられたAudioEqualizer
で実現されます。 オーディオ再生の周波数記述子は、AudioSpectrumListener
を登録することによって監視できます。 再生位置、速度およびバッファリングに関する情報は、それぞれcurrentTime
、currentRate
およびbufferProgressTime
の各プロパティから取得できます。 メディア・マーカー通知は、onMarker
プロパティとして登録されたイベント・ハンドラにより受信されます。期間が有限であるメディアの場合、再生の位置は
0.0
からそのメディアの期間までの任意の時点までに設定できます。MediaPlayer
では、startTime
およびstopTime
プロパティを追加することによってこの定義を詳細化し、実質的に、[startTime,stopTime]
に時間位置が制約された仮想メディア・ソースを定義します。 メディアの再生は、startTime
で開始し、stopTime
まで続行します。 これらの2つのエンドポイントによって定義された間隔はサイクルと呼ばれ、その期間は開始時間と停止時間の差となります。 このサイクルは、特定の回数または無限に繰り返すように設定できます。 メディア再生の合計期間は、サイクルの期間とサイクルが再生される回数によって決まります。 サイクルが停止時間に到達してサイクルが再び再生されると、onRepeat
プロパティに対して登録されたイベント・ハンドラが起動します。 サイクルが停止時間に到達してサイクルが繰り返されない場合、onEndOfMedia
プロパティに対して登録されたイベント・ハンドラが起動します。 現在再生されているサイクルのゼロ相対インデックスがcurrentCount
により維持されます。MediaPlayer
の操作は本質的に非同期です。 プレイヤは、そのステータスがMediaPlayer.Status.READY
に遷移する(実質上、通常はメディアのプリロールが完了したときに発生)までは、コマンドに即時に応答する準備が整っていません。 ただし、プレイヤのステータスがREADY
になる前にプレイヤに対して行われた一部のリクエストは、このステータスに入ったときに有効になります。 これらには、READY
遷移の前の、play()
の起動(途中でpause()
やstop()
が起動されなかった場合)、autoPlay
、balance
、mute
、rate
、startTime
,stopTime
、volume
のいずれかのプロパティの設定などがあります。アプリケーションによってプレイヤのステータス変更が認識されるように、
status
プロパティをモニターでき、また、特定のステータスに入ったときにアクションを実行する必要がある場合は、コールバック関数をonReady
などのプロパティを介して登録できます。 また、error
およびonError
プロパティを使用して、それぞれ、エラーの発生をモニターし、それに対応してアクションが実行されるようにできます。複数の
MediaView
の間で同じMediaPlayer
オブジェクトを共有できます。 このことは、プレイヤ自体には影響しません。 特に、ビューのプロパティ設定は、メディアの再生に一切影響しません。
-
-
プロパティのサマリー
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 static class
MediaPlayer.Status
MediaPlayer
の異なるステータス値を示す列挙。
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static int
INDEFINITE
実質的には無限回の再生サイクルを表す値。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 MediaPlayer(Media media)
特定のメディアのプレイヤを作成します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 DoubleProperty
audioSpectrumIntervalProperty()
秒単位のスペクトルの更新間の間隔。ObjectProperty<AudioSpectrumListener>
audioSpectrumListenerProperty()
オーディオ・スペクトル更新のリスナー。IntegerProperty
audioSpectrumNumBandsProperty()
オーディオ・スペクトルのバンド数。IntegerProperty
audioSpectrumThresholdProperty()
デシベル単位の感度しきい値は、正の整数以外にする必要があります。BooleanProperty
autoPlayProperty()
できるだけすぐに再生を開始するかどうか。DoubleProperty
balanceProperty()
音声出力のバランス(左右の設定)。ReadOnlyObjectProperty<Duration>
bufferProgressTimeProperty()
MediaPlayer
を停止せずにメディアを再生できる量を示す現在のバッファの位置。ReadOnlyIntegerProperty
currentCountProperty()
完了した再生サイクルの数。ReadOnlyDoubleProperty
currentRateProperty()
設定を考慮しない再生の現在の比率。ReadOnlyObjectProperty<Duration>
currentTimeProperty()
現在のメディア再生時間。IntegerProperty
cycleCountProperty()
メディアを再生する回数。ReadOnlyObjectProperty<Duration>
cycleDurationProperty()
void
dispose()
プレイヤに関連付けられたすべてのリソースを解放します。ReadOnlyObjectProperty<MediaException>
errorProperty()
エラーが発生した場合にMediaException
に設定される監視可能プロパティ。AudioEqualizer
getAudioEqualizer()
このプレイヤに関連付けられているAudioEqualizer
を取得します。double
getAudioSpectrumInterval()
オーディオ・スペクトルの通知間隔の値(秒)を取得します。AudioSpectrumListener
getAudioSpectrumListener()
オーディオ・スペクトルのリスナーを取得します。int
getAudioSpectrumNumBands()
オーディオ・スペクトルのバンド数を取得します。int
getAudioSpectrumThreshold()
オーディオ・スペクトルのしきい値(デシベル)を取得します。double
getBalance()
オーディオ・バランスを取得します。Duration
getBufferProgressTime()
bufferProgressTime
値を取得します。int
getCurrentCount()
現在のサイクルのインデックスを取得します。double
getCurrentRate()
現在の再生速度を取得します。Duration
getCurrentTime()
現在のメディア時間を取得します。int
getCycleCount()
サイクル・カウントを取得します。Duration
getCycleDuration()
サイクル期間を秒単位で取得します。MediaException
getError()
error
プロパティの値またはエラーがない場合はnull
を取得します。Media
getMedia()
再生されているMedia
インスタンスを取得します。Runnable
getOnEndOfMedia()
メディア終了のイベント・ハンドラを取得します。Runnable
getOnError()
エラーのイベント・ハンドラを取得します。Runnable
getOnHalted()
MediaPlayer.Status.HALTED
イベント・ハンドラを取得します。EventHandler<MediaMarkerEvent>
getOnMarker()
マーカー・イベント・ハンドラを取得します。Runnable
getOnPaused()
MediaPlayer.Status.PAUSED
イベント・ハンドラを取得します。Runnable
getOnPlaying()
MediaPlayer.Status.PLAYING
イベント・ハンドラを取得します。Runnable
getOnReady()
MediaPlayer.Status.READY
イベント・ハンドラを取得します。Runnable
getOnRepeat()
繰返しイベント・ハンドラを取得します。Runnable
getOnStalled()
MediaPlayer.Status.STALLED
イベント・ハンドラを取得します。Runnable
getOnStopped()
MediaPlayer.Status.STOPPED
イベント・ハンドラを取得します。double
getRate()
再生速度を取得します。Duration
getStartTime()
開始時間を取得します。MediaPlayer.Status
getStatus()
プレイヤの現在のステータスを取得します。Duration
getStopTime()
停止時間を取得します。Duration
getTotalDuration()
すべてのサイクル(繰返し)を含む合計再生継続時間を取得します。double
getVolume()
オーディオ再生音量を取得します。boolean
isAutoPlay()
autoPlay
プロパティ値を取得します。boolean
isMute()
muteProperty()
値を取得します。BooleanProperty
muteProperty()
プレイヤの音声をミュートするかどうか。ObjectProperty<Runnable>
onEndOfMediaProperty()
プレイヤのcurrentTime
がstopTime
に達する場合に起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onErrorProperty()
エラーが発生する場合に起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onHaltedProperty()
ステータスがHALTED
に変更されると起動されるイベント・ハンドラ。ObjectProperty<EventHandler<MediaMarkerEvent>>
onMarkerProperty()
プレイヤのcurrentTime
がメディア・マーカーに達する場合に起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onPausedProperty()
ステータスがPAUSED
に変更されると起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onPlayingProperty()
ステータスがPLAYING
に変更されると起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onReadyProperty()
ステータスがREADY
に変更されると起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onRepeatProperty()
プレイヤのcurrentTime
がstopTime
に達し、繰り返す場合に起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onStalledProperty()
ステータスがSTALLED
に変更されると起動されるイベント・ハンドラ。ObjectProperty<Runnable>
onStoppedProperty()
ステータスがSTOPPED
に変更されると起動されるイベント・ハンドラ。void
pause()
プレイヤを一時停止します。void
play()
メディアの再生を開始します。DoubleProperty
rateProperty()
メディアを再生する速度。void
seek(Duration seekTime)
新しい再生時間についてプレーヤを検索します。void
setAudioSpectrumInterval(double value)
オーディオ・スペクトルの通知間隔の値(秒)を設定します。void
setAudioSpectrumListener(AudioSpectrumListener listener)
オーディオ・スペクトルのリスナーを設定します。void
setAudioSpectrumNumBands(int value)
オーディオ・スペクトルのバンド数を設定します。void
setAudioSpectrumThreshold(int value)
オーディオ・スペクトルのしきい値(デシベル)を設定します。void
setAutoPlay(boolean value)
autoPlay
プロパティ値を設定します。void
setBalance(double value)
オーディオ・バランスを設定します。void
setCycleCount(int value)
サイクル・カウントを設定します。void
setMute(boolean value)
muteProperty()
の値を設定します。void
setOnEndOfMedia(Runnable value)
メディア終了のイベント・ハンドラを設定します。void
setOnError(Runnable value)
エラーが発生した場合に呼び出されるイベント・ハンドラを設定します。void
setOnHalted(Runnable value)
MediaPlayer.Status.HALTED
イベント・ハンドラを設定します。void
setOnMarker(EventHandler<MediaMarkerEvent> onMarker)
マーカー・イベント・ハンドラを設定します。void
setOnPaused(Runnable value)
MediaPlayer.Status.PAUSED
イベント・ハンドラを設定します。void
setOnPlaying(Runnable value)
MediaPlayer.Status.PLAYING
イベント・ハンドラを設定します。void
setOnReady(Runnable value)
MediaPlayer.Status.READY
イベント・ハンドラを設定します。void
setOnRepeat(Runnable value)
繰返しイベント・ハンドラを設定します。void
setOnStalled(Runnable value)
MediaPlayer.Status.STALLED
イベント・ハンドラを設定します。void
setOnStopped(Runnable value)
MediaPlayer.Status.STOPPED
イベント・ハンドラを設定します。void
setRate(double value)
再生速度を指定された値に設定します。void
setStartTime(Duration value)
開始時間を設定します。void
setStopTime(Duration value)
停止時間を設定します。void
setVolume(double value)
オーディオ再生音量を設定します。ObjectProperty<Duration>
startTimeProperty()
メディアが再生を開始するか、または繰り返す場合に再開する時間オフセット。ReadOnlyObjectProperty<MediaPlayer.Status>
statusProperty()
MediaPlayerの現在の状態。void
stop()
メディアの再生を停止します。ObjectProperty<Duration>
stopTimeProperty()
メディアが再生を停止するか、または繰り返す場合に再開する時間オフセット。ReadOnlyObjectProperty<Duration>
totalDurationProperty()
終了するまで再生を許可された場合の再生時間の合計。DoubleProperty
volumeProperty()
メディアを再生するボリューム。
-
-
-
プロパティの詳細
-
error
public ReadOnlyObjectProperty<MediaException> errorProperty
エラーが発生した場合にMediaException
に設定される監視可能プロパティ。- 関連項目:
getError()
-
onError
public ObjectProperty<Runnable> onErrorProperty
エラーが発生する場合に起動されるイベント・ハンドラ。
-
autoPlay
public BooleanProperty autoPlayProperty
できるだけすぐに再生を開始するかどうか。 新しいプレイヤの場合、これはプレイヤがREADY状態に達した時点で発生します。 デフォルト値はfalse
です。
-
rate
public DoubleProperty rateProperty
メディアを再生する速度。 たとえば、1.0
の速度ではメディアは通常の(エンコードされた)再生速度で再生され、2.0
では通常速度の2倍で再生されます。現在サポートされているレートの範囲は[0.0, 8.0]
です。 デフォルト値は1.0
です。- 関連項目:
getRate()
、setRate(double)
-
currentRate
public ReadOnlyDoubleProperty currentRateProperty
設定を考慮しない再生の現在の比率。 たとえば、rate
が1.0に設定され、プレイヤが一時停止または停止している場合、currentRate
はゼロになります。- 関連項目:
getCurrentRate()
-
volume
public DoubleProperty volumeProperty
メディアを再生するボリューム。 有効な値の範囲は[0.0 1.0]
で、ここで0.0
は無音、1.0
はフル音量(デフォルト)です。- 関連項目:
getVolume()
、setVolume(double)
-
balance
public DoubleProperty balanceProperty
音声出力のバランス(左右の設定)。 有効な値の範囲は[-1.0, 1.0]
で、-1.0
は左に振切り、0.0
はセンター、1.0
は右に振切りです。 デフォルト値は、0.0
です。
-
startTime
public ObjectProperty<Duration> startTimeProperty
メディアが再生を開始するか、または繰り返す場合に再開する時間オフセット。 再生が停止すると、現在の時間がこの値にリセットされます。 この値が正である場合、再生位置をメディア内の任意の時間に設定できない場合は、メディアの初回再生時に再生が開始される前の遅延が発生する可能性があります。 これは、たとえばビデオ・ストリーム内のイントラフレーム数のオフセットの参照表が含まれないビデオで発生します。 このような場合、開始時間に到達する直前のイントラフレームの位置までビデオ・フレームがスキップされる必要があります。 デフォルト値はDuration.ZERO
です。制約:
0 ≤ startTime <
stopTime
-
stopTime
public ObjectProperty<Duration> stopTimeProperty
メディアが再生を停止するか、または繰り返す場合に再開する時間オフセット。 デフォルト値は
です。getMedia()
.getDuration()制約:
startTime
< stopTime ≤Media.duration
-
cycleDuration
public ReadOnlyObjectProperty<Duration> cycleDurationProperty
このプレイヤのstartTime
とstopTime
間の時間。 メディアの合計期間については、Media.duration
プロパティを使用します。- 関連項目:
getCycleDuration()
-
totalDuration
public ReadOnlyObjectProperty<Duration> totalDurationProperty
終了するまで再生を許可された場合の再生時間の合計。cycleCount
がINDEFINITE
に設定されている場合、これもINDEFINITEとなります。 メディア期間がUNKNOWNである場合、これも同様にUNKNOWNとなります。 それ以外の場合、合計期間はcycleDurationとcycleCountにより決まります。- 関連項目:
getTotalDuration()
-
currentTime
public ReadOnlyObjectProperty<Duration> currentTimeProperty
現在のメディア再生時間。 このプロパティは読取り専用です。再生を別のストリーム位置に変更するには、seek(javafx.util.Duration)
を使用します。- 関連項目:
getCurrentTime()
-
status
public ReadOnlyObjectProperty<MediaPlayer.Status> statusProperty
MediaPlayerの現在の状態。- 関連項目:
getStatus()
-
bufferProgressTime
public ReadOnlyObjectProperty<Duration> bufferProgressTimeProperty
MediaPlayer
を停止せずにメディアを再生できる量を示す現在のバッファの位置。 これは、ネットワーク接続から読み取る場合などのバッファされるストリームに適用され、ローカル・ファイルなどには適用されません。bufferProgressTime
を超える位置に移動すると、再生の再開が可能になる十分な量のデータがバッファされるまで再生がわずかに一時停止します。- 関連項目:
getBufferProgressTime()
-
cycleCount
public IntegerProperty cycleCountProperty
メディアを再生する回数。 デフォルトではcycleCount
は1
に設定され、これはメディアが1回のみ再生されることを意味します。cycleCount
を1より大きい値に設定すると、メディアは指定された回数または停止されるまで再生されます。INDEFINITE
に設定すると、再生はstop()またはpause()が呼び出されるまで繰り返されます。constraints:
cycleCount ≥ 1
-
currentCount
public ReadOnlyIntegerProperty currentCountProperty
完了した再生サイクルの数。 初回では、値は0となります。 2回目では値は1になり、以降も同様に続きます。 これは各サイクルの終了時のstartTime
に戻る直前、つまりstopTime
またはメディアの終わりに達したときに増分されます。- 関連項目:
getCurrentCount()
-
mute
public BooleanProperty muteProperty
プレイヤの音声をミュートするかどうか。 値true
は、オーディオが再生されていないことを示します。 このプロパティの値はvolume
に影響せず、オーディオがミュートされた後ミュート解除され、volume
プロパティがその間に変更されなかった場合は、オーディオの再生は同じ音量レベルで再開されます。 デフォルト値はfalse
です。- 関連項目:
isMute()
、setMute(boolean)
-
onMarker
public ObjectProperty<EventHandler<MediaMarkerEvent>> onMarkerProperty
プレイヤのcurrentTime
がメディア・マーカーに達する場合に起動されるイベント・ハンドラ。
-
onEndOfMedia
public ObjectProperty<Runnable> onEndOfMediaProperty
プレイヤのcurrentTime
がstopTime
に達する場合に起動されるイベント・ハンドラ。
-
onReady
public ObjectProperty<Runnable> onReadyProperty
ステータスがREADY
に変更されると起動されるイベント・ハンドラ。
-
onPlaying
public ObjectProperty<Runnable> onPlayingProperty
ステータスがPLAYING
に変更されると起動されるイベント・ハンドラ。
-
onPaused
public ObjectProperty<Runnable> onPausedProperty
ステータスがPAUSED
に変更されると起動されるイベント・ハンドラ。
-
onStopped
public ObjectProperty<Runnable> onStoppedProperty
ステータスがSTOPPED
に変更されると起動されるイベント・ハンドラ。
-
onHalted
public ObjectProperty<Runnable> onHaltedProperty
ステータスがHALTED
に変更されると起動されるイベント・ハンドラ。
-
onRepeat
public ObjectProperty<Runnable> onRepeatProperty
プレイヤのcurrentTime
がstopTime
に達し、繰り返す場合に起動されるイベント・ハンドラ。startTime
の位置に戻る前に、コールバックが実行されます。
-
onStalled
public ObjectProperty<Runnable> onStalledProperty
ステータスがSTALLED
に変更されると起動されるイベント・ハンドラ。
-
audioSpectrumNumBands
public IntegerProperty audioSpectrumNumBandsProperty
オーディオ・スペクトルのバンド数。 デフォルト値は128、最小値は2です。 オーディオ信号の周波数範囲は、指定された数の周波数ビンに分割されます。 たとえば、一般的なデジタル音楽信号の周波数範囲は[0.0, 22050]
Hzです。 この場合のスペクトル・バンドの数が10に設定されている場合、このスペクトルの各周波数ビンの幅は2205
Hzとなり、最も低い周波数ビンの下限は0.0
に等しくなります。
-
audioSpectrumInterval
public DoubleProperty audioSpectrumIntervalProperty
秒単位のスペクトルの更新間の間隔。 デフォルト値は0.1
秒です。
-
audioSpectrumThreshold
public IntegerProperty audioSpectrumThresholdProperty
デシベル単位の感度しきい値は、正の整数以外にする必要があります。 指定されたスペクトル・バンド内のピーク周波数について、このしきい値より小さい値は、しきい値の値に設定されます。 デフォルト値は-60 dBです。
-
audioSpectrumListener
public ObjectProperty<AudioSpectrumListener> audioSpectrumListenerProperty
オーディオ・スペクトル更新のリスナー。 リスナーが登録されるとオーディオ・スペクトルの計算が有効化され、リスナーが削除されると計算が無効化されます。 単一のリスナーのみを登録でき、複数のオブザーバが必要となる場合は、イベントを転送する必要があります。たとえば、再生中のオーディオの周波数スペクトルをプロットしたり、ミュージック・ビジュアライザの波形を生成する場合に、
AudioSpectrumListener
が役立つ場合があります。
-
-
フィールドの詳細
-
INDEFINITE
public static final int INDEFINITE
実質的には無限回の再生サイクルを表す値。cycleCount
がこの値に設定されている場合、プレイヤは停止または一時停止されるまでMedia
の再生を繰り返します。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
MediaPlayer
public MediaPlayer(Media media)
特定のメディアのプレイヤを作成します。 これは、Media
オブジェクトをMediaPlayer
と関連付ける唯一の方法です。プレイヤが作成されると、これを変更することはできません。 コンストラクタ内で同期的に発生するエラーにより、例外がスローされます。 非同期で発生するエラーによりerror
プロパティが設定され、その結果任意のonError
コールバックが起動されます。作成されると、プレイヤの
status
がMediaPlayer.Status.UNKNOWN
になります。status
がMediaPlayer.Status.READY
に遷移すると、プレイヤは使用可能な状態になります。 プレイヤの作成からREADY
ステータスに入るまでの時間は、メディアがネットワーク接続を介して読み取られるかローカル・ファイル・システムから読み取られるかなどのことによって異なります。- パラメータ:
media
- 再生するメディア。- 例外:
NullPointerException
- メディアがnull
である場合。MediaException
- コンストラクタ内でなんらかの同期エラーが発生した場合。
-
-
メソッドの詳細
-
getAudioEqualizer
public final AudioEqualizer getAudioEqualizer()
このプレイヤに関連付けられているAudioEqualizer
を取得します。- 戻り値:
AudioEqualizer
またはnull
(プレイヤが破棄された場合)
-
getError
public final MediaException getError()
error
プロパティの値またはエラーがない場合はnull
を取得します。- 戻り値:
MediaException
またはnull
。
-
errorProperty
public ReadOnlyObjectProperty<MediaException> errorProperty()
エラーが発生した場合にMediaException
に設定される監視可能プロパティ。- 関連項目:
getError()
-
setOnError
public final void setOnError(Runnable value)
エラーが発生した場合に呼び出されるイベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnError
public final Runnable getOnError()
エラーのイベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラ。
-
onErrorProperty
public ObjectProperty<Runnable> onErrorProperty()
エラーが発生する場合に起動されるイベント・ハンドラ。
-
setAutoPlay
public final void setAutoPlay(boolean value)
autoPlay
プロパティ値を設定します。- パラメータ:
value
- 自動再生を有効にするかどうか
-
isAutoPlay
public final boolean isAutoPlay()
autoPlay
プロパティ値を取得します。- 戻り値:
- 値。
-
autoPlayProperty
public BooleanProperty autoPlayProperty()
できるだけすぐに再生を開始するかどうか。 新しいプレイヤの場合、これはプレイヤがREADY状態に達した時点で発生します。 デフォルト値はfalse
です。
-
play
public void play()
メディアの再生を開始します。 以前に一時停止されている場合、再生は一時停止位置から再開します。 再生が停止されている場合、startTime
から開始します。 再生が実際に開始されると、status
はMediaPlayer.Status.PLAYING
に設定されます。
-
pause
public void pause()
プレイヤを一時停止します。 プレイヤが実際に一時停止されると、status
はMediaPlayer.Status.PAUSED
に設定されます。
-
stop
public void stop()
メディアの再生を停止します。 この操作により、再生がstartTime
にリセットされ、currentCount
がゼロにリセットされます。 プレイヤが実際に停止されると、status
はMediaPlayer.Status.STOPPED
に設定されます。STOPPED
ステータスからの遷移先はMediaPlayer.Status.PAUSED
およびMediaPlayer.Status.PLAYING
のみであり、それぞれpause()
またはplay()
の起動後に発生します。 停止中は、プレイヤはseek(javafx.util.Duration)
による再生位置変更リクエストには応答しません。
-
setRate
public final void setRate(double value)
再生速度を指定された値に設定します。 この効果は、[0.0, 8.0]
の範囲に固定されます。 このメソッドの起動は、メディアの期間がDuration.INDEFINITE
である場合には効果がありません。- パラメータ:
value
- 再生速度
-
getRate
public final double getRate()
再生速度を取得します。- 戻り値:
- 再生速度
-
rateProperty
public DoubleProperty rateProperty()
メディアを再生する速度。 たとえば、1.0
の速度ではメディアは通常の(エンコードされた)再生速度で再生され、2.0
では通常速度の2倍で再生されます。現在サポートされているレートの範囲は[0.0, 8.0]
です。 デフォルト値は1.0
です。- 関連項目:
getRate()
、setRate(double)
-
getCurrentRate
public final double getCurrentRate()
現在の再生速度を取得します。- 戻り値:
- 現在の速度
-
currentRateProperty
public ReadOnlyDoubleProperty currentRateProperty()
設定を考慮しない再生の現在の比率。 たとえば、rate
が1.0に設定され、プレイヤが一時停止または停止している場合、currentRate
はゼロになります。- 関連項目:
getCurrentRate()
-
setVolume
public final void setVolume(double value)
オーディオ再生音量を設定します。 この効果は、[0.0, 1.0]
の範囲に固定されます。- パラメータ:
value
- 音量
-
getVolume
public final double getVolume()
オーディオ再生音量を取得します。 デフォルト値は1.0
です。- 戻り値:
- オーディオ音量
-
volumeProperty
public DoubleProperty volumeProperty()
メディアを再生するボリューム。 有効な値の範囲は[0.0 1.0]
で、ここで0.0
は無音、1.0
はフル音量(デフォルト)です。- 関連項目:
getVolume()
、setVolume(double)
-
setBalance
public final void setBalance(double value)
オーディオ・バランスを設定します。 この効果は、[-1.0, 1.0]
.の範囲に固定されます。- パラメータ:
value
- バランス
-
getBalance
public final double getBalance()
オーディオ・バランスを取得します。- 戻り値:
- オーディオ・バランス
-
balanceProperty
public DoubleProperty balanceProperty()
音声出力のバランス(左右の設定)。 有効な値の範囲は[-1.0, 1.0]
で、-1.0
は左に振切り、0.0
はセンター、1.0
は右に振切りです。 デフォルト値は、0.0
です。
-
setStartTime
public final void setStartTime(Duration value)
開始時間を設定します。 この効果は、[
の範囲に固定されます。 このメソッドの起動は、メディアの期間がDuration.ZERO
,stopTime
)Duration.INDEFINITE
である場合には効果がありません。- パラメータ:
value
- 開始時間
-
getStartTime
public final Duration getStartTime()
開始時間を取得します。 デフォルト値はDuration.ZERO
です。- 戻り値:
- 開始時間
-
startTimeProperty
public ObjectProperty<Duration> startTimeProperty()
メディアが再生を開始するか、または繰り返す場合に再開する時間オフセット。 再生が停止すると、現在の時間がこの値にリセットされます。 この値が正である場合、再生位置をメディア内の任意の時間に設定できない場合は、メディアの初回再生時に再生が開始される前の遅延が発生する可能性があります。 これは、たとえばビデオ・ストリーム内のイントラフレーム数のオフセットの参照表が含まれないビデオで発生します。 このような場合、開始時間に到達する直前のイントラフレームの位置までビデオ・フレームがスキップされる必要があります。 デフォルト値はDuration.ZERO
です。制約:
0 ≤ startTime <
stopTime
-
setStopTime
public final void setStopTime(Duration value)
停止時間を設定します。 この効果は、(
の範囲に固定されます。 このメソッドの起動は、メディアの期間がstartTime
,Media.duration
]Duration.INDEFINITE
である場合には効果がありません。- パラメータ:
value
- 停止時間
-
getStopTime
public final Duration getStopTime()
停止時間を取得します。 デフォルト値は
です。 メディアの初期化が未完了である場合、getMedia()
.getDuration()
の値がMedia.duration
Duration.UNKNOWN
になる可能性があります。- 戻り値:
- 停止時間
-
stopTimeProperty
public ObjectProperty<Duration> stopTimeProperty()
メディアが再生を停止するか、または繰り返す場合に再開する時間オフセット。 デフォルト値は
です。getMedia()
.getDuration()制約:
startTime
< stopTime ≤Media.duration
-
getCycleDuration
public final Duration getCycleDuration()
サイクル期間を秒単位で取得します。- 戻り値:
- サイクル期間
-
cycleDurationProperty
public ReadOnlyObjectProperty<Duration> cycleDurationProperty()
このプレイヤのstartTime
とstopTime
間の時間。 メディアの合計期間については、Media.duration
プロパティを使用します。- 関連項目:
getCycleDuration()
-
getTotalDuration
public final Duration getTotalDuration()
すべてのサイクル(繰返し)を含む合計再生継続時間を取得します。- 戻り値:
- 合計再生期間
-
totalDurationProperty
public ReadOnlyObjectProperty<Duration> totalDurationProperty()
終了するまで再生を許可された場合の再生時間の合計。cycleCount
がINDEFINITE
に設定されている場合、これもINDEFINITEとなります。 メディア期間がUNKNOWNである場合、これも同様にUNKNOWNとなります。 それ以外の場合、合計期間はcycleDurationとcycleCountにより決まります。- 関連項目:
getTotalDuration()
-
getCurrentTime
public final Duration getCurrentTime()
現在のメディア時間を取得します。- 戻り値:
- 現在のメディア時間
-
currentTimeProperty
public ReadOnlyObjectProperty<Duration> currentTimeProperty()
現在のメディア再生時間。 このプロパティは読取り専用です。再生を別のストリーム位置に変更するには、seek(javafx.util.Duration)
を使用します。- 関連項目:
getCurrentTime()
-
seek
public void seek(Duration seekTime)
新しい再生時間についてプレーヤを検索します。 このメソッドの起動は、プレイヤのステータスがMediaPlayer.Status.STOPPED
である場合、またはメディア期間がDuration.INDEFINITE
である場合には効果がありません。seek()
の動作は次のように制約されます。開始時間および停止時間はそれぞれメディア再生の有効な下限および上限を示しています。MediaPlayerシーク表 seekTime 移動先の位置 null
変更なし Duration.UNKNOWN
変更なし Duration.INDEFINITE
停止時間 seekTime < 開始時間 開始時間 seekTime > 停止時間 停止時間 開始時間 ≤ seekTime ≤ 停止時間 seekTime - パラメータ:
seekTime
- リクエストされた再生時間
-
getStatus
public final MediaPlayer.Status getStatus()
プレイヤの現在のステータスを取得します。- 戻り値:
- 再生ステータス
-
statusProperty
public ReadOnlyObjectProperty<MediaPlayer.Status> statusProperty()
MediaPlayerの現在の状態。- 関連項目:
getStatus()
-
getBufferProgressTime
public final Duration getBufferProgressTime()
bufferProgressTime
値を取得します。- 戻り値:
- バッファ進行時間
-
bufferProgressTimeProperty
public ReadOnlyObjectProperty<Duration> bufferProgressTimeProperty()
MediaPlayer
を停止せずにメディアを再生できる量を示す現在のバッファの位置。 これは、ネットワーク接続から読み取る場合などのバッファされるストリームに適用され、ローカル・ファイルなどには適用されません。bufferProgressTime
を超える位置に移動すると、再生の再開が可能になる十分な量のデータがバッファされるまで再生がわずかに一時停止します。- 関連項目:
getBufferProgressTime()
-
setCycleCount
public final void setCycleCount(int value)
サイクル・カウントを設定します。 この効果は、[1,
に制約されます。 このメソッドの起動は、メディアの期間がInteger.MAX_VALUE
]Duration.INDEFINITE
である場合には効果がありません。- パラメータ:
value
- サイクル・カウント
-
getCycleCount
public final int getCycleCount()
サイクル・カウントを取得します。- 戻り値:
- サイクル・カウント。
-
cycleCountProperty
public IntegerProperty cycleCountProperty()
メディアを再生する回数。 デフォルトではcycleCount
は1
に設定され、これはメディアが1回のみ再生されることを意味します。cycleCount
を1より大きい値に設定すると、メディアは指定された回数または停止されるまで再生されます。INDEFINITE
に設定すると、再生はstop()またはpause()が呼び出されるまで繰り返されます。constraints:
cycleCount ≥ 1
-
getCurrentCount
public final int getCurrentCount()
現在のサイクルのインデックスを取得します。- 戻り値:
- 現在のサイクル・インデックス
-
currentCountProperty
public ReadOnlyIntegerProperty currentCountProperty()
完了した再生サイクルの数。 初回では、値は0となります。 2回目では値は1になり、以降も同様に続きます。 これは各サイクルの終了時のstartTime
に戻る直前、つまりstopTime
またはメディアの終わりに達したときに増分されます。- 関連項目:
getCurrentCount()
-
setMute
public final void setMute(boolean value)
muteProperty()
の値を設定します。- パラメータ:
value
-mute
の設定
-
isMute
public final boolean isMute()
muteProperty()
値を取得します。- 戻り値:
- ミュートの設定
-
muteProperty
public BooleanProperty muteProperty()
プレイヤの音声をミュートするかどうか。 値true
は、オーディオが再生されていないことを示します。 このプロパティの値はvolume
に影響せず、オーディオがミュートされた後ミュート解除され、volume
プロパティがその間に変更されなかった場合は、オーディオの再生は同じ音量レベルで再開されます。 デフォルト値はfalse
です。- 関連項目:
isMute()
、setMute(boolean)
-
setOnMarker
public final void setOnMarker(EventHandler<MediaMarkerEvent> onMarker)
マーカー・イベント・ハンドラを設定します。- パラメータ:
onMarker
- マーカー・イベント・ハンドラ
-
getOnMarker
public final EventHandler<MediaMarkerEvent> getOnMarker()
マーカー・イベント・ハンドラを取得します。- 戻り値:
- マーカー・イベント・ハンドラ。
-
onMarkerProperty
public ObjectProperty<EventHandler<MediaMarkerEvent>> onMarkerProperty()
プレイヤのcurrentTime
がメディア・マーカーに達する場合に起動されるイベント・ハンドラ。
-
setOnEndOfMedia
public final void setOnEndOfMedia(Runnable value)
メディア終了のイベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnEndOfMedia
public final Runnable getOnEndOfMedia()
メディア終了のイベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onEndOfMediaProperty
public ObjectProperty<Runnable> onEndOfMediaProperty()
プレイヤのcurrentTime
がstopTime
に達する場合に起動されるイベント・ハンドラ。
-
setOnReady
public final void setOnReady(Runnable value)
MediaPlayer.Status.READY
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnReady
public final Runnable getOnReady()
MediaPlayer.Status.READY
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onReadyProperty
public ObjectProperty<Runnable> onReadyProperty()
ステータスがREADY
に変更されると起動されるイベント・ハンドラ。
-
setOnPlaying
public final void setOnPlaying(Runnable value)
MediaPlayer.Status.PLAYING
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnPlaying
public final Runnable getOnPlaying()
MediaPlayer.Status.PLAYING
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onPlayingProperty
public ObjectProperty<Runnable> onPlayingProperty()
ステータスがPLAYING
に変更されると起動されるイベント・ハンドラ。
-
setOnPaused
public final void setOnPaused(Runnable value)
MediaPlayer.Status.PAUSED
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnPaused
public final Runnable getOnPaused()
MediaPlayer.Status.PAUSED
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onPausedProperty
public ObjectProperty<Runnable> onPausedProperty()
ステータスがPAUSED
に変更されると起動されるイベント・ハンドラ。
-
setOnStopped
public final void setOnStopped(Runnable value)
MediaPlayer.Status.STOPPED
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnStopped
public final Runnable getOnStopped()
MediaPlayer.Status.STOPPED
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onStoppedProperty
public ObjectProperty<Runnable> onStoppedProperty()
ステータスがSTOPPED
に変更されると起動されるイベント・ハンドラ。
-
setOnHalted
public final void setOnHalted(Runnable value)
MediaPlayer.Status.HALTED
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnHalted
public final Runnable getOnHalted()
MediaPlayer.Status.HALTED
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onHaltedProperty
public ObjectProperty<Runnable> onHaltedProperty()
ステータスがHALTED
に変更されると起動されるイベント・ハンドラ。
-
setOnRepeat
public final void setOnRepeat(Runnable value)
繰返しイベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnRepeat
public final Runnable getOnRepeat()
繰返しイベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onRepeatProperty
public ObjectProperty<Runnable> onRepeatProperty()
プレイヤのcurrentTime
がstopTime
に達し、繰り返す場合に起動されるイベント・ハンドラ。startTime
の位置に戻る前に、コールバックが実行されます。
-
setOnStalled
public final void setOnStalled(Runnable value)
MediaPlayer.Status.STALLED
イベント・ハンドラを設定します。- パラメータ:
value
- イベント・ハンドラまたはnull
。
-
getOnStalled
public final Runnable getOnStalled()
MediaPlayer.Status.STALLED
イベント・ハンドラを取得します。- 戻り値:
- イベント・ハンドラまたは
null
。
-
onStalledProperty
public ObjectProperty<Runnable> onStalledProperty()
ステータスがSTALLED
に変更されると起動されるイベント・ハンドラ。
-
setAudioSpectrumNumBands
public final void setAudioSpectrumNumBands(int value)
オーディオ・スペクトルのバンド数を設定します。- パラメータ:
value
- スペクトル・バンドの数、value
は2以上
-
getAudioSpectrumNumBands
public final int getAudioSpectrumNumBands()
オーディオ・スペクトルのバンド数を取得します。- 戻り値:
- スペクトル・バンドの数
-
audioSpectrumNumBandsProperty
public IntegerProperty audioSpectrumNumBandsProperty()
オーディオ・スペクトルのバンド数。 デフォルト値は128、最小値は2です。 オーディオ信号の周波数範囲は、指定された数の周波数ビンに分割されます。 たとえば、一般的なデジタル音楽信号の周波数範囲は[0.0, 22050]
Hzです。 この場合のスペクトル・バンドの数が10に設定されている場合、このスペクトルの各周波数ビンの幅は2205
Hzとなり、最も低い周波数ビンの下限は0.0
に等しくなります。
-
setAudioSpectrumInterval
public final void setAudioSpectrumInterval(double value)
オーディオ・スペクトルの通知間隔の値(秒)を設定します。- パラメータ:
value
- スペクトル更新間隔を指定する正の値
-
getAudioSpectrumInterval
public final double getAudioSpectrumInterval()
オーディオ・スペクトルの通知間隔の値(秒)を取得します。- 戻り値:
- スペクトル更新間隔
-
audioSpectrumIntervalProperty
public DoubleProperty audioSpectrumIntervalProperty()
秒単位のスペクトルの更新間の間隔。 デフォルト値は0.1
秒です。
-
setAudioSpectrumThreshold
public final void setAudioSpectrumThreshold(int value)
オーディオ・スペクトルのしきい値(デシベル)を設定します。- パラメータ:
value
- スペクトルしきい値(dB)。0
以下にする必要があります。
-
getAudioSpectrumThreshold
public final int getAudioSpectrumThreshold()
オーディオ・スペクトルのしきい値(デシベル)を取得します。- 戻り値:
- スペクトルしきい値(dB)
-
audioSpectrumThresholdProperty
public IntegerProperty audioSpectrumThresholdProperty()
デシベル単位の感度しきい値は、正の整数以外にする必要があります。 指定されたスペクトル・バンド内のピーク周波数について、このしきい値より小さい値は、しきい値の値に設定されます。 デフォルト値は-60 dBです。
-
setAudioSpectrumListener
public final void setAudioSpectrumListener(AudioSpectrumListener listener)
オーディオ・スペクトルのリスナーを設定します。- パラメータ:
listener
- スペクトル・リスナーまたはnull
。
-
getAudioSpectrumListener
public final AudioSpectrumListener getAudioSpectrumListener()
オーディオ・スペクトルのリスナーを取得します。- 戻り値:
- スペクトル・リスナーまたは
null
-
audioSpectrumListenerProperty
public ObjectProperty<AudioSpectrumListener> audioSpectrumListenerProperty()
オーディオ・スペクトル更新のリスナー。 リスナーが登録されるとオーディオ・スペクトルの計算が有効化され、リスナーが削除されると計算が無効化されます。 単一のリスナーのみを登録でき、複数のオブザーバが必要となる場合は、イベントを転送する必要があります。たとえば、再生中のオーディオの周波数スペクトルをプロットしたり、ミュージック・ビジュアライザの波形を生成する場合に、
AudioSpectrumListener
が役立つ場合があります。
-
dispose
public void dispose()
プレイヤに関連付けられたすべてのリソースを解放します。 この関数を呼び出した後にプレイヤを使用しないでください。 このメソッドを実行すると、レイヤーはMediaPlayer.Status.DISPOSED
に移行します。 このメソッドは、現在のプレーヤのステータスに関係なくいつでも呼び出すことができます。- 導入されたバージョン:
- JavaFX 8.0
-
-