Module uk.co.caprica.vlcj
Package uk.co.caprica.vlcj.player.base

Interface MediaPlayerEventListener

All Known Implementing Classes:
AudioListPlayerComponent, AudioPlayerComponent, CallbackMediaListPlayerComponent, CallbackMediaListPlayerComponentBase, CallbackMediaPlayerComponent, EmbeddedMediaListPlayerComponent, EmbeddedMediaPlayerComponent, LengthChangedWaiter, MediaPlayerEventAdapter, MediaPlayerWaiter, OneShotMediaPlayerEventListener, PausedWaiter, PlayingWaiter, PositionReachedWaiter, ReadyWaiter, SnapshotTakenWaiter, SynchronisedOneShotMediaPlayerEventListener, TimeReachedWaiter, VideoOutputCreatedWaiter
public interface MediaPlayerEventListener
Specification for a component that is interested in receiving event notifications from the media player.

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 Details

    • mediaChanged

      void mediaChanged(MediaPlayer mediaPlayer, MediaRef media)
      The media changed.
      Parameters:
      mediaPlayer - media player that raised the event
      media - new media instance

    • opening

      void opening(MediaPlayer mediaPlayer)
      Opening the media.
      Parameters:
      mediaPlayer - media player that raised the event

    • buffering

      void buffering(MediaPlayer mediaPlayer, float newCache)
      Buffering media.
      Parameters:
      mediaPlayer - media player that raised the event
      newCache - percentage complete, ranging from 0.0 to 100.0

    • playing

      void playing(MediaPlayer mediaPlayer)
      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

      void paused(MediaPlayer mediaPlayer)
      Media paused.
      Parameters:
      mediaPlayer - media player that raised the event

    • stopped

      void stopped(MediaPlayer mediaPlayer)
      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

      void forward(MediaPlayer mediaPlayer)
      Media skipped forward.
      Parameters:
      mediaPlayer - media player that raised the event

    • backward

      void backward(MediaPlayer mediaPlayer)
      Media skipped backward.
      Parameters:
      mediaPlayer - media player that raised the event

    • finished

      void finished(MediaPlayer mediaPlayer)
      Media finished playing (i.e. the end was reached without being stopped).
      Parameters:
      mediaPlayer - media player that raised the event

    • timeChanged

      void timeChanged(MediaPlayer mediaPlayer, long newTime)
      Media play-back time changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newTime - new time

    • positionChanged

      void positionChanged(MediaPlayer mediaPlayer, float newPosition)
      Media play-back position changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newPosition - percentage between 0.0 and 1.0

    • seekableChanged

      void seekableChanged(MediaPlayer mediaPlayer, int newSeekable)
      Media seekable status changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newSeekable - new seekable status

    • pausableChanged

      void pausableChanged(MediaPlayer mediaPlayer, int newPausable)
      Media pausable status changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newPausable - new pausable status

    • titleChanged

      void titleChanged(MediaPlayer mediaPlayer, int newTitle)
      Media title changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newTitle - new title

    • snapshotTaken

      void snapshotTaken(MediaPlayer mediaPlayer, String filename)
      A snapshot was taken.
      Parameters:
      mediaPlayer - media player that raised the event
      filename - name of the file containing the snapshot

    • lengthChanged

      void lengthChanged(MediaPlayer mediaPlayer, long newLength)
      Media length changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newLength - new length (number of milliseconds)

    • videoOutput

      void videoOutput(MediaPlayer mediaPlayer, int newCount)
      The number of video outputs changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newCount - new number of video outputs

    • scrambledChanged

      void scrambledChanged(MediaPlayer mediaPlayer, int newScrambled)
      Program scrambled changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newScrambled - new scrambled value

    • elementaryStreamAdded

      void elementaryStreamAdded(MediaPlayer mediaPlayer, TrackType type, int id)
      An elementary stream was added.
      Parameters:
      mediaPlayer - media player that raised the event
      type - type of stream
      id - identifier of stream

    • elementaryStreamDeleted

      void elementaryStreamDeleted(MediaPlayer mediaPlayer, TrackType type, int id)
      An elementary stream was deleted.
      Parameters:
      mediaPlayer - media player that raised the event
      type - type of stream
      id - identifier of stream

    • elementaryStreamSelected

      void elementaryStreamSelected(MediaPlayer mediaPlayer, TrackType type, int id)
      An elementary stream was selected.
      Parameters:
      mediaPlayer - media player that raised the event
      type - type of stream
      id - identifier of stream

    • corked

      void corked(MediaPlayer mediaPlayer, boolean 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 event
      corked - true if corked; otherwise false

    • muted

      void muted(MediaPlayer mediaPlayer, boolean muted)
      The audio was muted/un-muted.
      Parameters:
      mediaPlayer - media player that raised the event
      muted - true if muted; otherwise false

    • volumeChanged

      void volumeChanged(MediaPlayer mediaPlayer, float volume)
      The volume changed.
      Parameters:
      mediaPlayer - media player that raised the event
      volume - new volume

    • audioDeviceChanged

      void audioDeviceChanged(MediaPlayer mediaPlayer, String audioDevice)
      The audio device changed.
      Parameters:
      mediaPlayer - media player that raised the event
      audioDevice - new audio device

    • chapterChanged

      void chapterChanged(MediaPlayer mediaPlayer, int newChapter)
      The chapter changed.
      Parameters:
      mediaPlayer - media player that raised the event
      newChapter - new chapter

    • error

      void error(MediaPlayer mediaPlayer)
      An error occurred.
      Parameters:
      mediaPlayer - media player that raised the event

    • mediaPlayerReady

      void mediaPlayerReady(MediaPlayer mediaPlayer)
      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) or videoOutput(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