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
объект может быть совместно использован среди многократного MediaView
s. Это не будет влиять на проигрыватель непосредственно. В частности настройки свойства представления не будут иметь никакого эффекта на воспроизведение носителей.
Ввести | Свойство и Описание |
---|---|
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; value
must 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()
null
public 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