|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class MediaPlayer
extends java.lang.Object
MediaPlayer class обеспечивает средства управления для того, чтобы они играли носители. Это используется в комбинации с Media и MediaView классы дисплея и воспроизведения носителей управления. MediaPlayer не содержит визуальных элементов, так должен использоваться с MediaView class, чтобы просмотреть любой видеотрек, который может присутствовать. 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. Интервал, определенный этими двумя конечными точками, называют циклом с продолжительностью, являющейся различием остановки, и запустите времена. Этот цикл может быть установлен повторить определенное или неопределенное число раз. Полная продолжительность воспроизведения носителей является тогда продуктом длительности цикла и числа раз, цикл играется. Если время остановки цикла достигается, и цикл должен играться снова, обработчик событий, зарегистрированный в onRepeat свойство вызывается. Если время остановки достигается, и цикл не должен быть повторен, то обработчик событий, зарегистрированный в onEndOfMedia свойство вызывается. Нулевой родственник индексирует, из которых теперь играется цикл, сохраняется currentCount.
Работа a MediaPlayer является по сути асинхронным. Проигрыватель не готовится квазисразу ответить на команды, пока его состояние не перешло к MediaPlayer.Status.READY, который в действительности обычно происходит, когда предварительный рулон носителей завершается. С некоторыми просьбами обращаются к проигрывателю до его состояния быть READY однако вступит в силу, когда то состояние вводится. Они включают вызов play() без прошедшего вызова pause() или stop() перед READY переход, так же как устанавливающий любой из autoPlay, balance, mute, rate, startTime, stopTime, и volume свойства.
status свойство может контролироваться, чтобы подать заявку, знающую об изменениях состояния проигрывателя, и функции обратного вызова могут быть зарегистрированы через свойства такой как onReady если меры должны быть предприняты, когда определенное состояние вводится. Есть также error и onError свойства, которые соответственно позволяют контролировать, когда ошибка происходит и предпринятие указанных мер в ответе к тому.
То же самое MediaPlayer объект может быть совместно использован среди многократного MediaViews. Это не будет влиять на проигрыватель непосредственно. В частности настройки свойства представления не будут иметь никакого эффекта на воспроизведение носителей.
| Ввести | Свойство и Описание |
|---|---|
DoubleProperty |
audioSpectrumInterval
В секундах интервал между спектром обновляет.
|
ObjectProperty<AudioSpectrumListener> |
audioSpectrumListener
Слушатель для аудио обновлений спектра.
|
IntegerProperty |
audioSpectrumNumBands
Число полос в аудио спектре.
|
IntegerProperty |
audioSpectrumThreshold
Порог чувствительности в децибелах; должно быть неположительным.
|
BooleanProperty |
автоматическое воспроизведение
Должна ли игра запуститься как можно скорее.
|
DoubleProperty |
баланс
Баланс, или лево-правильная установка, аудиовыхода.
|
ReadOnlyObjectProperty<Duration> |
bufferProgressTime
Текущая буферная позиция, указывающая, насколько носители могут играться, не останавливаясь
MediaPlayer. |
ReadOnlyIntegerProperty |
currentCount
Число завершенных циклов воспроизведения.
|
ReadOnlyDoubleProperty |
currentRate
Действующий курс воспроизведения независимо от настроек.
|
ReadOnlyObjectProperty<Duration> |
currentTime
Текущие носители воспроизводят время.
|
IntegerProperty |
cycleCount
Число раз носители будет играться.
|
ReadOnlyObjectProperty<Duration> |
cycleDuration
|
ReadOnlyObjectProperty<MediaException> |
ошибка
Заметный набор свойств к a
MediaException если ошибка происходит. |
BooleanProperty |
бесшумный
Отключается ли аудио проигрывателя звук.
|
ObjectProperty<java.lang.Runnable> |
onEndOfMedia
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает stopTime и не повторяется. |
ObjectProperty<java.lang.Runnable> |
onError
Обработчик событий, вызванный, когда ошибка происходит.
|
ObjectProperty<java.lang.Runnable> |
onHalted
Обработчик событий, вызванный, когда состояние изменяется на
HALTED. |
ObjectProperty<EventHandler<MediaMarkerEvent>> |
onMarker
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает маркера носителей. |
ObjectProperty<java.lang.Runnable> |
onPaused
Обработчик событий, вызванный, когда состояние изменяется на
PAUSED. |
ObjectProperty<java.lang.Runnable> |
onPlaying
Обработчик событий, вызванный, когда состояние изменяется на
PLAYING. |
ObjectProperty<java.lang.Runnable> |
onReady
Обработчик событий, вызванный, когда состояние изменяется на
READY. |
ObjectProperty<java.lang.Runnable> |
onRepeat
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает stopTime и будет повторяться. |
ObjectProperty<java.lang.Runnable> |
onStalled
Обработчик событий, вызванный, когда состояние изменяется на
STALLED. |
ObjectProperty<java.lang.Runnable> |
onStopped
Обработчик событий, вызванный, когда состояние изменяется на
STOPPED. |
DoubleProperty |
уровень
Уровень, на котором должны играться носители.
|
ObjectProperty<Duration> |
startTime
Смещение времени, где носители должны начать играть, или перезапустить от, повторяясь.
|
ReadOnlyObjectProperty<MediaPlayer.Status> |
состояние
Текущее состояние MediaPlayer.
|
ObjectProperty<Duration> |
stopTime
Смещение времени, где носители должны прекратить играть или перезапуск, повторяясь.
|
ReadOnlyObjectProperty<Duration> |
totalDuration
Общая сумма времени игры если позволено играть пока не закончено.
|
DoubleProperty |
объем
Объем, в котором должны играться носители.
|
| Модификатор и Тип | Класс и Описание |
|---|---|
static class |
MediaPlayer. Состояние
Перечисление, описывающее различные значения состояния a
MediaPlayer. |
| Модификатор и Тип | Поле и Описание |
|---|---|
static int |
НЕОПРЕДЕЛЕННЫЙ
Значение, представляющее эффективно бесконечное число циклов воспроизведения.
|
| Конструктор и Описание |
|---|
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()
|
ReadOnlyObjectProperty<MediaException> |
errorProperty()
Заметный набор свойств к a
MediaException если ошибка происходит. |
AudioEqualizer |
getAudioEqualizer()
Получите
AudioEqualizer связанный с этим проигрывателем. |
double |
getAudioSpectrumInterval()
Получает значение аудио интервала уведомления о спектре в секундах.
|
AudioSpectrumListener |
getAudioSpectrumListener()
Получает слушателя аудио спектра.
|
int |
getAudioSpectrumNumBands()
Получает число полос в аудио спектре.
|
int |
getAudioSpectrumThreshold()
Получает аудио порог спектра в децибелах.
|
double |
getBalance()
Получает аудио баланс.
|
Продолжительность |
getBufferProgressTime()
Получает
bufferProgressTime значение. |
int |
getCurrentCount()
Получает индексирование текущего цикла.
|
double |
getCurrentRate()
Получает текущую скорость воспроизведения.
|
Продолжительность |
getCurrentTime()
Получает текущее время носителей.
|
int |
getCycleCount()
Получает количество цикла.
|
Продолжительность |
getCycleDuration()
Получает длительность цикла в секундах.
|
MediaException |
getError()
Получите значение
error свойство или null если нет никакой ошибки. |
Носители |
getMedia()
Получает
Media играемый экземпляр. |
java.lang.Runnable |
getOnEndOfMedia()
Получает конец обработчика медиа-события.
|
java.lang.Runnable |
getOnError()
Получает обработчик событий для ошибок.
|
java.lang.Runnable |
getOnHalted()
Получает
MediaPlayer.Status.HALTED обработчик событий. |
EventHandler<MediaMarkerEvent> |
getOnMarker()
Получает обработчик событий маркера.
|
java.lang.Runnable |
getOnPaused()
Получает
MediaPlayer.Status.PAUSED обработчик событий. |
java.lang.Runnable |
getOnPlaying()
Получает
MediaPlayer.Status.PLAYING обработчик событий. |
java.lang.Runnable |
getOnReady()
Получает
MediaPlayer.Status.READY обработчик событий. |
java.lang.Runnable |
getOnRepeat()
Получает повторный обработчик событий.
|
java.lang.Runnable |
getOnStalled()
Получает
MediaPlayer.Status.STALLED обработчик событий. |
java.lang.Runnable |
getOnStopped()
Получает
MediaPlayer.Status.STOPPED обработчик событий. |
double |
getRate()
Получает скорость воспроизведения.
|
Продолжительность |
getStartTime()
Получает время запуска.
|
MediaPlayer. Состояние |
getStatus()
Получает текущее состояние проигрывателя.
|
Продолжительность |
getStopTime()
Получает время запуска.
|
Продолжительность |
getTotalDuration()
Получает полную продолжительность воспроизведения включая все циклы (повторения).
|
double |
getVolume()
Получает объем воспроизведения аудио.
|
boolean |
isAutoPlay()
Получает
autoPlay значение свойства. |
boolean |
isMute()
Получает
muteProperty() значение. |
BooleanProperty |
muteProperty()
Отключается ли аудио проигрывателя звук.
|
ObjectProperty<java.lang.Runnable> |
onEndOfMediaProperty()
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает stopTime и не повторяется. |
ObjectProperty<java.lang.Runnable> |
onErrorProperty()
Обработчик событий, вызванный, когда ошибка происходит.
|
ObjectProperty<java.lang.Runnable> |
onHaltedProperty()
Обработчик событий, вызванный, когда состояние изменяется на
HALTED. |
ObjectProperty<EventHandler<MediaMarkerEvent>> |
onMarkerProperty()
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает маркера носителей. |
ObjectProperty<java.lang.Runnable> |
onPausedProperty()
Обработчик событий, вызванный, когда состояние изменяется на
PAUSED. |
ObjectProperty<java.lang.Runnable> |
onPlayingProperty()
Обработчик событий, вызванный, когда состояние изменяется на
PLAYING. |
ObjectProperty<java.lang.Runnable> |
onReadyProperty()
Обработчик событий, вызванный, когда состояние изменяется на
READY. |
ObjectProperty<java.lang.Runnable> |
onRepeatProperty()
Обработчик событий, вызванный, когда проигрыватель
currentTime достигает stopTime и будет повторяться. |
ObjectProperty<java.lang.Runnable> |
onStalledProperty()
Обработчик событий, вызванный, когда состояние изменяется на
STALLED. |
ObjectProperty<java.lang.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(java.lang.Runnable value)
Устанавливает конец обработчика медиа-события.
|
void |
setOnError(java.lang.Runnable value)
Устанавливает обработчик событий, который вызовут, когда ошибка происходит.
|
void |
setOnHalted(java.lang.Runnable value)
Наборы
MediaPlayer.Status.HALTED обработчик событий. |
void |
setOnMarker(EventHandler<MediaMarkerEvent> onMarker)
Устанавливает обработчик событий маркера.
|
void |
setOnPaused(java.lang.Runnable value)
Наборы
MediaPlayer.Status.PAUSED обработчик событий. |
void |
setOnPlaying(java.lang.Runnable value)
Наборы
MediaPlayer.Status.PLAYING обработчик событий. |
void |
setOnReady(java.lang.Runnable value)
Наборы
MediaPlayer.Status.READY обработчик событий. |
void |
setOnRepeat(java.lang.Runnable value)
Устанавливает повторный обработчик событий.
|
void |
setOnStalled(java.lang.Runnable value)
Наборы
MediaPlayer.Status.STALLED обработчик событий. |
void |
setOnStopped(java.lang.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()
Объем, в котором должны играться носители.
|
MediaException если ошибка происходит.getError()getOnError(), setOnError(Runnable)isAutoPlay(), setAutoPlay(boolean)1.0 играет носители на его нормальной (закодированной) скорости воспроизведения, 2.0 воспроизводит при дважды нормальном темпе, и т.д. В настоящий момент поддерживаемый диапазон уровней [0.0, 8.0].getRate(), setRate(double)rate устанавливается в 1.0, и проигрыватель приостанавливается или останавливается, тогда currentRate будет нуль.getCurrentRate()[0.0 1.0] где 0.0 неслышимо и 1.0 полный объем, который является значением по умолчанию.getVolume(), setVolume(double)[-1.0, 1.0] с -1.0 будучи полным оставленный, 0.0 центр, и 1.0 полное право.getBalance(), setBalance(double)Ограничения: 0 ≤ startTime < stopTime
getStartTime(), setStartTime(Duration)Ограничения: startTime < stopTime ≤ Media.duration
getStopTime(), setStopTime(Duration)startTime и stopTime из этого проигрывателя. Поскольку полная продолжительность Носителей использует Media.duration свойство.getCycleDuration()cycleCount устанавливается в INDEFINITE тогда это также будет НЕОПРЕДЕЛЕННО. Если продолжительность Носителей будет НЕИЗВЕСТНА, то это аналогично будет НЕИЗВЕСТНО. Иначе, полная продолжительность будет продуктом cycleDuration и cycleCount.getTotalDuration()seek(javafx.util.Duration) изменить воспроизведение на различную потоковую позицию.getCurrentTime()getStatus()MediaPlayer. Это применимо к буферизованным потокам, таким как те, которые читают из сетевых соединений как отклонено например к локальным файлам. Поиск на позицию вне bufferProgressTime мог бы заставить небольшую паузу в воспроизведении до объема данных, достаточного разрешать, чтобы возобновление воспроизведения было буферизовано.
getBufferProgressTime()cycleCount устанавливается в 1 однажды будет только играться значение носителей. Установка cycleCount к значению, больше чем 1, заставит носители играть данное число раз или пока не остановлено. Если установлено в INDEFINITE, воспроизведение повторится до остановки (), или паузу () вызывают. ограничения: cycleCount ≥ 1
getCycleCount(), setCycleCount(int)startTime, то есть, когда stopTime или конец носителей был достигнут.getCurrentCount()true указывает, что аудио не производится. Значение этого свойства не имеет никакого эффекта на volume, то есть, если аудио отключается звук, и затем воспроизведение аудио нес отключенным звуком возобновится на том же самом слышимом уровне, обеспеченном, конечно, что volume свойство не было изменено тем временем.isMute(), setMute(boolean)currentTime достигает маркера носителей.getOnMarker(), setOnMarker(EventHandler)currentTime достигает stopTime и не повторяется.getOnEndOfMedia(), setOnEndOfMedia(Runnable)READY.getOnReady(), setOnReady(Runnable)PLAYING.getOnPlaying(), setOnPlaying(Runnable)PAUSED.getOnPaused(), setOnPaused(Runnable)STOPPED.getOnStopped(), setOnStopped(Runnable)HALTED.getOnHalted(), setOnHalted(Runnable)currentTime достигает stopTime и будет повторяться. Этот обратный вызов делается до поиска назад на startTime.getOnRepeat(), setOnRepeat(Runnable)STALLED.getOnStalled(), setOnStalled(Runnable)[0.0, 22050] Гц. Если бы номер диапазонов был в этом случае определен к 10, то width каждого мусорного ведра частоты в спектре был бы 2205 Гц с нижней границей самого низкого мусорного ведра частоты, равного 0.0.0.1 секунды. AudioSpectrumListener может быть полезным например, чтобы графически изобразить спектра частоты играемого аудио или генерировать формы волны для музыки visualizer.
public static final int INDEFINITE
cycleCount устанавливается в это значение, проигрыватель воспроизведет Media пока не остановлено или приостановлено.public MediaPlayer(Media media)
Media объект с a MediaPlayer: как только проигрыватель создается, это не может быть изменено. Ошибки, которые происходят синхронно в пределах конструктора, заставят исключения быть брошенными. Ошибки, которые происходят асинхронно, вызовут error свойство, которое будет установлено и следовательно любой onError обратный вызов, который будет вызван. Когда создающийся, status из проигрывателя будет MediaPlayer.Status.UNKNOWN. Однажды status перешел к MediaPlayer.Status.READY проигрыватель будет в применимом условии. Количество времени между созданием проигрывателя и его вводом READY состояние может измениться зависящий, например, на том, перечитываются ли носители по сетевому соединению или от локальной файловой системы.
media - Носители, чтобы играть.java.lang.NullPointerException - если носители null.MediaException - если какие-либо синхронные ошибки происходят в пределах конструктора.public final AudioEqualizer getAudioEqualizer()
AudioEqualizer связанный с этим проигрывателем.AudioEqualizer.public final MediaException getError()
error свойство или null если нет никакой ошибки.MediaException или null.public ReadOnlyObjectProperty<MediaException> errorProperty()
MediaException если ошибка происходит.getError()public final void setOnError(java.lang.Runnable value)
value - обработчик событий или null.public final java.lang.Runnable getOnError()
public ObjectProperty<java.lang.Runnable> onErrorProperty()
getOnError(), setOnError(Runnable)public final void setAutoPlay(boolean value)
autoPlay значение свойства.value - включить ли автовоспроизведениюpublic final boolean isAutoPlay()
autoPlay значение свойства.public BooleanProperty autoPlayProperty()
isAutoPlay(), setAutoPlay(boolean)public void play()
startTime. Когда игра фактически запускается status будет установлен в MediaPlayer.Status.PLAYING.public void pause()
status будет установлен в MediaPlayer.Status.PAUSED.public void stop()
startTime, и сбросы currentCount обнулять. Как только проигрыватель фактически останавливается, status будет установлен в MediaPlayer.Status.STOPPED. Единственные переходы из STOPPED состояние к MediaPlayer.Status.PAUSED и MediaPlayer.Status.PLAYING которые происходят после вызова pause() или play(), соответственно. В то время как остановлено, проигрыватель не будет отвечать на изменения позиции воспроизведения, которые требуют seek(javafx.util.Duration).public final void setRate(double value)
[0.0, 8.0].value - скорость воспроизведенияpublic final double getRate()
public DoubleProperty rateProperty()
1.0 играет носители на его нормальной (закодированной) скорости воспроизведения, 2.0 воспроизводит при дважды нормальном темпе, и т.д. В настоящий момент поддерживаемый диапазон уровней [0.0, 8.0].getRate(), setRate(double)public final double getCurrentRate()
public ReadOnlyDoubleProperty currentRateProperty()
rate устанавливается в 1.0, и проигрыватель приостанавливается или останавливается, тогда currentRate будет нуль.getCurrentRate()public final void setVolume(double value)
[0.0, 1.0].value - объемpublic final double getVolume()
1.0.public DoubleProperty volumeProperty()
[0.0 1.0] где 0.0 неслышимо и 1.0 полный объем, который является значением по умолчанию.getVolume(), setVolume(double)public final void setBalance(double value)
[-1.0, 1.0].value - балансpublic final double getBalance()
public DoubleProperty balanceProperty()
[-1.0, 1.0] с -1.0 будучи полным оставленный, 0.0 центр, и 1.0 полное право.getBalance(), setBalance(double)public final void setStartTime(Duration value)
[Duration.ZERO, stopTime).value - время запускаpublic final Duration getStartTime()
Duration.ZERO.public ObjectProperty<Duration> startTimeProperty()
Ограничения: 0 ≤ startTime < stopTime
getStartTime(), setStartTime(Duration)public final void setStopTime(Duration value)
(startTime, Media.duration].value - the start timepublic final Duration getStopTime()
getMedia().getDuration(). Note that Media.duration may have the value Duration.UNKNOWN if media initialization is not complete.public ObjectProperty<Duration> stopTimeProperty()
Constraints: startTime < stopTime ≤ Media.duration
getStopTime(), setStopTime(Duration)public final Duration getCycleDuration()
public ReadOnlyObjectProperty<Duration> cycleDurationProperty()
startTime and stopTime of this player. For the total duration of the Media use the Media.duration property.getCycleDuration()public final Duration getTotalDuration()
public ReadOnlyObjectProperty<Duration> totalDurationProperty()
cycleCount is set to INDEFINITE then this will also be INDEFINITE. If the Media duration is UNKNOWN, then this will likewise be UNKNOWN. Otherwise, total duration will be the product of cycleDuration and cycleCount.getTotalDuration()public final Duration getCurrentTime()
public ReadOnlyObjectProperty<Duration> currentTimeProperty()
seek(javafx.util.Duration) to change playback to a different stream position.getCurrentTime()public void seek(Duration seekTime)
MediaPlayer.Status.STOPPED. The behavior of seek() is constrained as follows where start time and stop time indicate the effective lower and upper bounds, respectively, of media playback:
| seekTime | seek position |
|---|---|
null | no change |
Duration.UNKNOWN | no change |
Duration.INDEFINITE | stop time |
| seekTime < start time | start time |
| seekTime > stop time | stop time |
| start time ≤ seekTime ≤ stop time | seekTime |
seekTime - the requested playback timepublic final MediaPlayer.Status getStatus()
public ReadOnlyObjectProperty<MediaPlayer.Status> statusProperty()
getStatus()public final Duration getBufferProgressTime()
bufferProgressTime value.public ReadOnlyObjectProperty<Duration> bufferProgressTimeProperty()
MediaPlayer. This is applicable to buffered streams such as those reading from network connections as opposed for example to local files. Seeking to a position beyond bufferProgressTime might cause a slight pause in playback until an amount of data sufficient to permit playback resumption has been buffered.
getBufferProgressTime()public final void setCycleCount(int value)
[1,Integer.MAX_VALUE].value - the cycle countpublic final int getCycleCount()
public IntegerProperty cycleCountProperty()
cycleCount is set to 1 meaning the media will only be played once. Setting cycleCount to a value greater than 1 will cause the media to play the given number of times or until stopped. If set to INDEFINITE, playback will repeat until stop() or pause() is called. constraints: cycleCount ≥ 1
getCycleCount(), setCycleCount(int)public final int getCurrentCount()
public ReadOnlyIntegerProperty currentCountProperty()
startTime, i.e., when stopTime or the end of media has been reached.getCurrentCount()public final void setMute(boolean value)
muteProperty().value - the mute settingpublic final boolean isMute()
muteProperty() value.public BooleanProperty muteProperty()
true indicates that audio is not being produced. The value of this property has no effect on volume, i.e., if the audio is muted and then un-muted, audio playback will resume at the same audible level provided of course that the volume property has not been modified meanwhile.isMute(), setMute(boolean)public final void setOnMarker(EventHandler<MediaMarkerEvent> onMarker)
onMarker - the marker event handler.public final EventHandler<MediaMarkerEvent> getOnMarker()
public ObjectProperty<EventHandler<MediaMarkerEvent>> onMarkerProperty()
currentTime reaches a media marker.getOnMarker(), setOnMarker(EventHandler)public final void setOnEndOfMedia(java.lang.Runnable value)
value - the event handler or null.public final java.lang.Runnable getOnEndOfMedia()
null.public ObjectProperty<java.lang.Runnable> onEndOfMediaProperty()
currentTime reaches stopTime and is not repeating.getOnEndOfMedia(), setOnEndOfMedia(Runnable)public final void setOnReady(java.lang.Runnable value)
MediaPlayer.Status.READY event handler.value - the event handler or null.public final java.lang.Runnable getOnReady()
MediaPlayer.Status.READY event handler.null.public ObjectProperty<java.lang.Runnable> onReadyProperty()
READY.getOnReady(), setOnReady(Runnable)public final void setOnPlaying(java.lang.Runnable value)
MediaPlayer.Status.PLAYING event handler.value - the event handler or null.public final java.lang.Runnable getOnPlaying()
MediaPlayer.Status.PLAYING event handler.null.public ObjectProperty<java.lang.Runnable> onPlayingProperty()
PLAYING.getOnPlaying(), setOnPlaying(Runnable)public final void setOnPaused(java.lang.Runnable value)
MediaPlayer.Status.PAUSED event handler.value - the event handler or null.public final java.lang.Runnable getOnPaused()
MediaPlayer.Status.PAUSED event handler.null.public ObjectProperty<java.lang.Runnable> onPausedProperty()
PAUSED.getOnPaused(), setOnPaused(Runnable)public final void setOnStopped(java.lang.Runnable value)
MediaPlayer.Status.STOPPED event handler.value - the event handler or null.public final java.lang.Runnable getOnStopped()
MediaPlayer.Status.STOPPED event handler.null.public ObjectProperty<java.lang.Runnable> onStoppedProperty()
STOPPED.getOnStopped(), setOnStopped(Runnable)public final void setOnHalted(java.lang.Runnable value)
MediaPlayer.Status.HALTED event handler.value - the event handler or null.public final java.lang.Runnable getOnHalted()
MediaPlayer.Status.HALTED event handler.null.public ObjectProperty<java.lang.Runnable> onHaltedProperty()
HALTED.getOnHalted(), setOnHalted(Runnable)public final void setOnRepeat(java.lang.Runnable value)
value - the event handler or null.public final java.lang.Runnable getOnRepeat()
null.public ObjectProperty<java.lang.Runnable> onRepeatProperty()
currentTime reaches stopTime and will be repeating. This callback is made prior to seeking back to startTime.getOnRepeat(), setOnRepeat(Runnable)public final void setOnStalled(java.lang.Runnable value)
MediaPlayer.Status.STALLED event handler.value - the event handler or null.public final java.lang.Runnable getOnStalled()
MediaPlayer.Status.STALLED event handler.null.public ObjectProperty<java.lang.Runnable> onStalledProperty()
STALLED.getOnStalled(), setOnStalled(Runnable)public final void setAudioSpectrumNumBands(int value)
value - the number of spectral bands; valuemust be ≥ 2public final int getAudioSpectrumNumBands()
public IntegerProperty audioSpectrumNumBandsProperty()
[0.0, 22050] Hz. If the number of spectral bands were in this case set to 10, the width of each frequency bin in the spectrum would be 2205 Hz with the lower bound of the lowest frequency bin equal to 0.0.public final void setAudioSpectrumInterval(double value)
value - a positive value specifying the spectral update intervalpublic final double getAudioSpectrumInterval()
public DoubleProperty audioSpectrumIntervalProperty()
0.1 seconds.public final void setAudioSpectrumThreshold(int value)
value - the spectral threshold in dB; must be ≤ 0.public final int getAudioSpectrumThreshold()
public IntegerProperty audioSpectrumThresholdProperty()
public final void setAudioSpectrumListener(AudioSpectrumListener listener)
listener - the spectral listener or null.public final AudioSpectrumListener getAudioSpectrumListener()
nullpublic ObjectProperty<AudioSpectrumListener> audioSpectrumListenerProperty()
An AudioSpectrumListener may be useful for example to plot the frequency spectrum of the audio being played or to generate waveforms for a music visualizer.
Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved. Use is subject to .