- All Known Implementing Classes:
AudioListPlayerComponent
,AudioPlayerComponent
,CallbackMediaListPlayerComponent
,CallbackMediaListPlayerComponentBase
,CallbackMediaPlayerComponent
,EmbeddedMediaListPlayerComponent
,EmbeddedMediaPlayerComponent
,LengthChangedWaiter
,MediaPlayerEventAdapter
,MediaPlayerWaiter
,OneShotMediaPlayerEventListener
,PausedWaiter
,PlayingWaiter
,PositionReachedWaiter
,ReadyWaiter
,SnapshotTakenWaiter
,SynchronisedOneShotMediaPlayerEventListener
,TimeReachedWaiter
,VideoOutputCreatedWaiter
Events are not raised on the Swing Event Dispatch thread so if updating user interface components in
response to these events care must be taken to use SwingUtilities.invokeLater(Runnable)
.
Equally, care must be taken not to call back into LibVLC from the event handling thread - if an event handler needs
to call back into LibVLC it should use the MediaPlayer.submit(Runnable)
method to submit a task for
asynchronous execution.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
audioDeviceChanged
(MediaPlayer mediaPlayer, String audioDevice) The audio device changed.void
backward
(MediaPlayer mediaPlayer) Media skipped backward.void
buffering
(MediaPlayer mediaPlayer, float newCache) Buffering media.void
chapterChanged
(MediaPlayer mediaPlayer, int newChapter) The chapter changed.void
corked
(MediaPlayer mediaPlayer, boolean corked) The media player was corked/un-corked.void
elementaryStreamAdded
(MediaPlayer mediaPlayer, TrackType type, int id) An elementary stream was added.void
elementaryStreamDeleted
(MediaPlayer mediaPlayer, TrackType type, int id) An elementary stream was deleted.void
elementaryStreamSelected
(MediaPlayer mediaPlayer, TrackType type, int id) An elementary stream was selected.void
error
(MediaPlayer mediaPlayer) An error occurred.void
finished
(MediaPlayer mediaPlayer) Media finished playing (i.e.void
forward
(MediaPlayer mediaPlayer) Media skipped forward.void
lengthChanged
(MediaPlayer mediaPlayer, long newLength) Media length changed.void
mediaChanged
(MediaPlayer mediaPlayer, MediaRef media) The media changed.void
mediaPlayerReady
(MediaPlayer mediaPlayer) Media player is ready (to enable features like logo and marquee) after the media has started playing.void
muted
(MediaPlayer mediaPlayer, boolean muted) The audio was muted/un-muted.void
opening
(MediaPlayer mediaPlayer) Opening the media.void
pausableChanged
(MediaPlayer mediaPlayer, int newPausable) Media pausable status changed.void
paused
(MediaPlayer mediaPlayer) Media paused.void
playing
(MediaPlayer mediaPlayer) The media started playing.void
positionChanged
(MediaPlayer mediaPlayer, float newPosition) Media play-back position changed.void
scrambledChanged
(MediaPlayer mediaPlayer, int newScrambled) Program scrambled changed.void
seekableChanged
(MediaPlayer mediaPlayer, int newSeekable) Media seekable status changed.void
snapshotTaken
(MediaPlayer mediaPlayer, String filename) A snapshot was taken.void
stopped
(MediaPlayer mediaPlayer) Media stopped.void
timeChanged
(MediaPlayer mediaPlayer, long newTime) Media play-back time changed.void
titleChanged
(MediaPlayer mediaPlayer, int newTitle) Media title changed.void
videoOutput
(MediaPlayer mediaPlayer, int newCount) The number of video outputs changed.void
volumeChanged
(MediaPlayer mediaPlayer, float volume) The volume changed.
-
Method Details
-
mediaChanged
The media changed.- Parameters:
mediaPlayer
- media player that raised the eventmedia
- new media instance
-
opening
Opening the media.- Parameters:
mediaPlayer
- media player that raised the event
-
buffering
Buffering media.- Parameters:
mediaPlayer
- media player that raised the eventnewCache
- percentage complete, ranging from 0.0 to 100.0
-
playing
The media started playing.There is no guarantee that a video output has been created at this point.
- Parameters:
mediaPlayer
- media player that raised the event
-
paused
Media paused.- Parameters:
mediaPlayer
- media player that raised the event
-
stopped
Media stopped.A stopped event may be raised under certain circumstances even if the media player is not playing (e.g. as part of the associated media list player sub-item handling). Client applications must therefore be prepared to handle such a situation.
- Parameters:
mediaPlayer
- media player that raised the event
-
forward
Media skipped forward.- Parameters:
mediaPlayer
- media player that raised the event
-
backward
Media skipped backward.- Parameters:
mediaPlayer
- media player that raised the event
-
finished
Media finished playing (i.e. the end was reached without being stopped).- Parameters:
mediaPlayer
- media player that raised the event
-
timeChanged
Media play-back time changed.- Parameters:
mediaPlayer
- media player that raised the eventnewTime
- new time
-
positionChanged
Media play-back position changed.- Parameters:
mediaPlayer
- media player that raised the eventnewPosition
- percentage between 0.0 and 1.0
-
seekableChanged
Media seekable status changed.- Parameters:
mediaPlayer
- media player that raised the eventnewSeekable
- new seekable status
-
pausableChanged
Media pausable status changed.- Parameters:
mediaPlayer
- media player that raised the eventnewPausable
- new pausable status
-
titleChanged
Media title changed.- Parameters:
mediaPlayer
- media player that raised the eventnewTitle
- new title
-
snapshotTaken
A snapshot was taken.- Parameters:
mediaPlayer
- media player that raised the eventfilename
- name of the file containing the snapshot
-
lengthChanged
Media length changed.- Parameters:
mediaPlayer
- media player that raised the eventnewLength
- new length (number of milliseconds)
-
videoOutput
The number of video outputs changed.- Parameters:
mediaPlayer
- media player that raised the eventnewCount
- new number of video outputs
-
scrambledChanged
Program scrambled changed.- Parameters:
mediaPlayer
- media player that raised the eventnewScrambled
- new scrambled value
-
elementaryStreamAdded
An elementary stream was added.- Parameters:
mediaPlayer
- media player that raised the eventtype
- type of streamid
- identifier of stream
-
elementaryStreamDeleted
An elementary stream was deleted.- Parameters:
mediaPlayer
- media player that raised the eventtype
- type of streamid
- identifier of stream
-
elementaryStreamSelected
An elementary stream was selected.- Parameters:
mediaPlayer
- media player that raised the eventtype
- type of streamid
- identifier of stream
-
corked
The media player was corked/un-corked.Corking/un-corking can occur e.g. when another media player (or some other application) starts/stops playing media.
- Parameters:
mediaPlayer
- media player that raised the eventcorked
-true
if corked; otherwisefalse
-
muted
The audio was muted/un-muted.- Parameters:
mediaPlayer
- media player that raised the eventmuted
-true
if muted; otherwisefalse
-
volumeChanged
The volume changed.- Parameters:
mediaPlayer
- media player that raised the eventvolume
- new volume
-
audioDeviceChanged
The audio device changed.- Parameters:
mediaPlayer
- media player that raised the eventaudioDevice
- new audio device
-
chapterChanged
The chapter changed.- Parameters:
mediaPlayer
- media player that raised the eventnewChapter
- new chapter
-
error
An error occurred.- Parameters:
mediaPlayer
- media player that raised the event
-
mediaPlayerReady
Media player is ready (to enable features like logo and marquee) after the media has started playing.The implementation will fire this event once on receipt of the first native position-changed event with a position value greater than zero.
The event will be fired again if the media is played again after a native stopped or finished event is received.
Waiting for this event may be more reliable than using
playing(MediaPlayer)
orvideoOutput(MediaPlayer, int)
in some cases (logo and marquee already mentioned, also setting audio tracks, sub-title tracks and so on).- Parameters:
mediaPlayer
- media player that raised the event
-