uk.co.caprica.vlcj.player.condition

Class DefaultCondition<T>

java.lang.Object

uk.co.caprica.vlcj.player.MediaPlayerEventAdapter

uk.co.caprica.vlcj.player.condition.Condition<T>

uk.co.caprica.vlcj.player.condition.DefaultCondition<T>

Type Parameters:

T - optional type of result

All Implemented Interfaces:

MediaPlayerEventListener

Direct Known Subclasses:

LengthChangedCondition, ParsedCondition, PausedCondition, PlayingCondition, PositionReachedCondition, TimeReachedCondition, VideoOutputCreatedCondition

public class DefaultCondition<T>
extends Condition<T>

Default implementation of a media player condition that triggers if the media player reports an error or unexpectedly reaches the end of the media.

This is useful when waiting for a condition that is normally expected (such as waiting until a particular media player state is reached, or a particular play- back time is reached) and the media player unexpectedly reports an error or reports that the end of the media has been reached.

Without this, a condition may wait forever, since after an error or after the media has finished no more events will be received.

It is expected that most but not necessarily all Condition implementations will need this behaviour.

Do not override error(MediaPlayer) or Condition.finished() unless you are sure you know what you are doing. Some use-cases may require that those methods can be overridden, so if you do provide an override you must be careful to invoke the superclass method for correct operation.

Constructor Summary

Constructors

Constructor and Description
DefaultCondition(MediaPlayer mediaPlayer) Create a media player condition.

Method Summary

Modifier and Type	Method and Description
void	error(MediaPlayer mediaPlayer) An error occurred.
void	finished(MediaPlayer mediaPlayer) Media finished playing (i.e.

Methods inherited from class uk.co.caprica.vlcj.player.condition.Condition

await

Methods inherited from class uk.co.caprica.vlcj.player.MediaPlayerEventAdapter

audioDeviceChanged, backward, buffering, chapterChanged, corked, elementaryStreamAdded, elementaryStreamDeleted, elementaryStreamSelected, endOfSubItems, forward, lengthChanged, mediaChanged, mediaDurationChanged, mediaFreed, mediaMetaChanged, mediaParsedChanged, mediaStateChanged, mediaSubItemAdded, mediaSubItemTreeAdded, muted, newMedia, opening, pausableChanged, paused, playing, positionChanged, scrambledChanged, seekableChanged, snapshotTaken, stopped, subItemFinished, subItemPlayed, timeChanged, titleChanged, videoOutput, volumeChanged

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultCondition

public DefaultCondition(MediaPlayer mediaPlayer)

Create a media player condition.

Parameters:

mediaPlayer - media player

Method Detail

error

public void error(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

An error occurred.

Specified by:

error in interface MediaPlayerEventListener

Overrides:

error in class MediaPlayerEventAdapter

Parameters:

mediaPlayer - media player that raised the event

finished

public void finished(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

Media finished playing (i.e. the end was reached without being stopped).

Specified by:

finished in interface MediaPlayerEventListener

Overrides:

finished in class MediaPlayerEventAdapter

Parameters:

mediaPlayer - media player that raised the event