Module uk.co.caprica.vlcj

Package uk.co.caprica.vlcj.waiter.mediaplayer

Class MediaPlayerWaiter<R>

java.lang.Object

uk.co.caprica.vlcj.waiter.Waiter<MediaPlayer,R>

uk.co.caprica.vlcj.waiter.mediaplayer.MediaPlayerWaiter<R>

Type Parameters:

R - type of result that may be returned when the desired condition arises

All Implemented Interfaces:

MediaPlayerEventListener

Direct Known Subclasses:

LengthChangedWaiter, PausedWaiter, PlayingWaiter, PositionReachedWaiter, ReadyWaiter, SnapshotTakenWaiter, TimeReachedWaiter, VideoOutputCreatedWaiter

public abstract class MediaPlayerWaiter<R>
extends Waiter<MediaPlayer,R>
implements MediaPlayerEventListener

Base implementation for a conditional waiter for media player events.

Method Summary

Modifier and Type	Method	Description
void	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.

Methods inherited from class uk.co.caprica.vlcj.waiter.Waiter

await

Methods inherited from class java.lang.Object

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

Method Details

mediaChanged

public void mediaChanged(MediaPlayer mediaPlayer,
 MediaRef media)

Description copied from interface: MediaPlayerEventListener

The media changed.

Specified by:

mediaChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

media - new media instance

opening

public void opening(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

Opening the media.

Specified by:

opening in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

buffering

public void buffering(MediaPlayer mediaPlayer,
 float newCache)

Description copied from interface: MediaPlayerEventListener

Buffering media.

Specified by:

buffering in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newCache - percentage complete, ranging from 0.0 to 100.0

playing

public void playing(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

The media started playing.

There is no guarantee that a video output has been created at this point.

Specified by:

playing in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

paused

public void paused(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

Media paused.

Specified by:

paused in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

stopped

public void stopped(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

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.

Specified by:

stopped in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

forward

public void forward(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

Media skipped forward.

Specified by:

forward in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

backward

public void backward(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

Media skipped backward.

Specified by:

backward in interface MediaPlayerEventListener

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

Parameters:

mediaPlayer - media player that raised the event

timeChanged

public void timeChanged(MediaPlayer mediaPlayer,
 long newTime)

Description copied from interface: MediaPlayerEventListener

Media play-back time changed.

Specified by:

timeChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newTime - new time

positionChanged

public void positionChanged(MediaPlayer mediaPlayer,
 float newPosition)

Description copied from interface: MediaPlayerEventListener

Media play-back position changed.

Specified by:

positionChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newPosition - percentage between 0.0 and 1.0

seekableChanged

public void seekableChanged(MediaPlayer mediaPlayer,
 int newSeekable)

Description copied from interface: MediaPlayerEventListener

Media seekable status changed.

Specified by:

seekableChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newSeekable - new seekable status

pausableChanged

public void pausableChanged(MediaPlayer mediaPlayer,
 int newPausable)

Description copied from interface: MediaPlayerEventListener

Media pausable status changed.

Specified by:

pausableChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newPausable - new pausable status

titleChanged

public void titleChanged(MediaPlayer mediaPlayer,
 int newTitle)

Description copied from interface: MediaPlayerEventListener

Media title changed.

Specified by:

titleChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newTitle - new title

snapshotTaken

public void snapshotTaken(MediaPlayer mediaPlayer,
 String filename)

Description copied from interface: MediaPlayerEventListener

A snapshot was taken.

Specified by:

snapshotTaken in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

filename - name of the file containing the snapshot

lengthChanged

public void lengthChanged(MediaPlayer mediaPlayer,
 long newLength)

Description copied from interface: MediaPlayerEventListener

Media length changed.

Specified by:

lengthChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newLength - new length (number of milliseconds)

videoOutput

public void videoOutput(MediaPlayer mediaPlayer,
 int newCount)

Description copied from interface: MediaPlayerEventListener

The number of video outputs changed.

Specified by:

videoOutput in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newCount - new number of video outputs

scrambledChanged

public void scrambledChanged(MediaPlayer mediaPlayer,
 int newScrambled)

Description copied from interface: MediaPlayerEventListener

Program scrambled changed.

Specified by:

scrambledChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newScrambled - new scrambled value

elementaryStreamAdded

public void elementaryStreamAdded(MediaPlayer mediaPlayer,
 TrackType type,
 int id)

Description copied from interface: MediaPlayerEventListener

An elementary stream was added.

Specified by:

elementaryStreamAdded in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

type - type of stream

id - identifier of stream

elementaryStreamDeleted

public void elementaryStreamDeleted(MediaPlayer mediaPlayer,
 TrackType type,
 int id)

Description copied from interface: MediaPlayerEventListener

An elementary stream was deleted.

Specified by:

elementaryStreamDeleted in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

type - type of stream

id - identifier of stream

elementaryStreamSelected

public void elementaryStreamSelected(MediaPlayer mediaPlayer,
 TrackType type,
 int id)

Description copied from interface: MediaPlayerEventListener

An elementary stream was selected.

Specified by:

elementaryStreamSelected in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

type - type of stream

id - identifier of stream

corked

public void corked(MediaPlayer mediaPlayer,
 boolean corked)

Description copied from interface: MediaPlayerEventListener

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.

Specified by:

corked in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

corked - true if corked; otherwise false

muted

public void muted(MediaPlayer mediaPlayer,
 boolean muted)

Description copied from interface: MediaPlayerEventListener

The audio was muted/un-muted.

Specified by:

muted in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

muted - true if muted; otherwise false

volumeChanged

public void volumeChanged(MediaPlayer mediaPlayer,
 float volume)

Description copied from interface: MediaPlayerEventListener

The volume changed.

Specified by:

volumeChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

volume - new volume

audioDeviceChanged

public void audioDeviceChanged(MediaPlayer mediaPlayer,
 String audioDevice)

Description copied from interface: MediaPlayerEventListener

The audio device changed.

Specified by:

audioDeviceChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

audioDevice - new audio device

chapterChanged

public void chapterChanged(MediaPlayer mediaPlayer,
 int newChapter)

Description copied from interface: MediaPlayerEventListener

The chapter changed.

Specified by:

chapterChanged in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

newChapter - new chapter

error

public void error(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

An error occurred.

Specified by:

error in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event

mediaPlayerReady

public void mediaPlayerReady(MediaPlayer mediaPlayer)

Description copied from interface: MediaPlayerEventListener

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 MediaPlayerEventListener.playing(MediaPlayer) or MediaPlayerEventListener.videoOutput(MediaPlayer, int) in some cases (logo and marquee already mentioned, also setting audio tracks, sub-title tracks and so on).

Specified by:

mediaPlayerReady in interface MediaPlayerEventListener

Parameters:

mediaPlayer - media player that raised the event