Package com.tagtraum.beatunes

Class InternalPlayer

java.lang.Object

com.tagtraum.beatunes.InternalPlayer

All Implemented Interfaces:

AudioPlayer, PlayListPlayer, ApplicationComponent<BeaTunes>

public class InternalPlayer
extends Object
implements ApplicationComponent<BeaTunes>, PlayListPlayer

Internal playlist player.

Author:

Hendrik Schreiber

Nested Class Summary

Nested classes/interfaces inherited from interface com.tagtraum.audiokern.PlayListPlayer

PlayListPlayer.RepeatMode, PlayListPlayer.ScanMode

Constructor Summary

Constructors

Constructor	Description
InternalPlayer(BeaTunes application)

Method Summary

Modifier and Type	Method	Description
void	addAudioPlayerListener(AudioPlayerListener listener)
void	addPlayListPlayerInterceptor(PlayListPlayerInterceptor interceptor)	Adds a PlayListPlayerInterceptor.
void	addPropertyChangeListener(PropertyChangeListener propertyChangeListener)
void	addPropertyChangeListener(String propertyName, PropertyChangeListener propertyChangeListener)
void	close()	Closes the audio file and associated player resources.
int	currentIndex()	Filtered index of the current song in the played list/component.
void	fastForward()	Plays the file forward at accelerated speed.
protected void	finalize()
BeaTunes	getApplication()	Returns the main application component.
AudioDevice	getAudioDevice()	Current audio device.
JComponent	getComponent()	Main display component for the currently active playlist.
long	getDuration()	Duration of the song in ms.
String	getId()	Unique id for each instance of this object.
PlayListIterator<AudioSong>	getIterator()	Returns the currently used iterator.
Long	getPlayListId()	Persistent identifier of the current playlist, if available.
PlayListPlayer.RepeatMode	getRepeatMode()	The current repeat mode.
ReplayGain.Type	getReplayGainType()	Currently configured type of replay gain.
PlayListPlayer.ScanMode	getScanMode()	The current scan mode.
AudioSong	getSong()	Returns the currently opened song.
long	getTime()	Returns the current time in ms.
float	getVolume()	Returns the volume.
void	init()	Initializes this component and its sub-components.
boolean	isDone()	True, if the song was played to the end.
boolean	isMuted()	Indicates whether the player is muted.
boolean	isPaused()	Indicates whether the song is currently playing.
void	next()	Move to next song.
void	open(AudioSong song)	Opens a song.
void	open(PlayListIterator<AudioSong> iterator)	Sets a song iterator.
void	pause()	Stops playback.
void	play()	Starts playback.
void	playPause()	Starts playback, if song is paused, otherwise pauses playback.
void	previous()	Move to previous song.
void	removeAudioPlayerListener(AudioPlayerListener listener)
void	removePlayListPlayerInterceptor(PlayListPlayerInterceptor interceptor)	Removed a PlayListPlayerInterceptor.
void	removePropertyChangeListener(PropertyChangeListener propertyChangeListener)
void	removePropertyChangeListener(String propertyName, PropertyChangeListener propertyChangeListener)
void	reset()	Positions the player at the beginning of the file.
void	setApplication(BeaTunes application)	Sets the main application component.
void	setAudioDevice(AudioDevice audioDevice)	Sets the desired audio device.
void	setMuted(boolean muted)	Un/mutes this player.
void	setRepeatMode(PlayListPlayer.RepeatMode repeatMode)	Sets the current repeat mode.
void	setReplayGainType(ReplayGain.Type type)	Asks the player to respect the given kind of replay gain.
void	setScanMode(PlayListPlayer.ScanMode scanMode)	Sets a new scan mode.
void	setTime(long time)	Sets the current time in ms.
void	setVolume(float volume)	Changes the volume.
void	shutdown()	Shuts down this component and its sub-components.

Methods inherited from class java.lang.Object

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

Constructor Detail

InternalPlayer

public InternalPlayer(BeaTunes application)

Method Detail

setAudioDevice

public void setAudioDevice(AudioDevice audioDevice)
                    throws IllegalArgumentException

Description copied from interface: AudioPlayer

Sets the desired audio device.

Specified by:

setAudioDevice in interface AudioPlayer

Parameters:

audioDevice - audio device

Throws:

IllegalArgumentException - if the device is not supported

getAudioDevice

public AudioDevice getAudioDevice()

Description copied from interface: AudioPlayer

Current audio device.

Specified by:

getAudioDevice in interface AudioPlayer

Returns:

currently used audio device

setApplication

public void setApplication(BeaTunes application)

Description copied from interface: ApplicationComponent

Sets the main application component.

Specified by:

setApplication in interface ApplicationComponent<BeaTunes>

Parameters:

application - main application component

getApplication

public BeaTunes getApplication()

Description copied from interface: ApplicationComponent

Returns the main application component.

Specified by:

getApplication in interface ApplicationComponent<BeaTunes>

Returns:

application object

getId

public String getId()

Description copied from interface: ApplicationComponent

Unique id for each instance of this object.

Specified by:

getId in interface ApplicationComponent<BeaTunes>

Returns:

id

init

public void init()

Description copied from interface: ApplicationComponent

Initializes this component and its sub-components.

Specified by:

init in interface ApplicationComponent<BeaTunes>

shutdown

public void shutdown()
              throws ShutdownVetoException

Description copied from interface: ApplicationComponent

Shuts down this component and its sub-components.

Specified by:

shutdown in interface ApplicationComponent<BeaTunes>

Throws:

ShutdownVetoException - if this component wants to veto the shutdown. This exception is not guaranteed to be honored, i.e. a calling component may simply ignore it

getIterator

public PlayListIterator<AudioSong> getIterator()

Description copied from interface: PlayListPlayer

Returns the currently used iterator.

Specified by:

getIterator in interface PlayListPlayer

Returns:

iterator

open

public void open(PlayListIterator<AudioSong> iterator)
          throws IOException

Sets a song iterator.

Specified by:

open in interface PlayListPlayer

Parameters:

iterator - iterator

Throws:

IOException - if the first song (obtained through ListIterator.next()) cannot be opened

See Also:

AudioPlayer.open(AudioSong)

open

public void open(AudioSong song)
          throws IOException

Description copied from interface: AudioPlayer

Opens a song.
Calling this method with null as argument has the same effect as calling AudioPlayer.close().

Specified by:

open in interface AudioPlayer

Parameters:

song - song

Throws:

IOException - if the song cannot be opened

getPlayListId

public Long getPlayListId()

Description copied from interface: PlayListPlayer

Persistent identifier of the current playlist, if available.

Specified by:

getPlayListId in interface PlayListPlayer

Returns:

id or null, if not available.

getComponent

public JComponent getComponent()

Description copied from interface: PlayListPlayer

Main display component for the currently active playlist.

Specified by:

getComponent in interface PlayListPlayer

Returns:

main display component for the currently active playlist

currentIndex

public int currentIndex()

Description copied from interface: PlayListPlayer

Filtered index of the current song in the played list/component. This index may change dynamically, as the view of the list is filtered or sorted.

Specified by:

currentIndex in interface PlayListPlayer

Returns:

index

setRepeatMode

public void setRepeatMode(PlayListPlayer.RepeatMode repeatMode)

Description copied from interface: PlayListPlayer

Sets the current repeat mode.

Specified by:

setRepeatMode in interface PlayListPlayer

Parameters:

repeatMode - mode

getRepeatMode

public PlayListPlayer.RepeatMode getRepeatMode()

Description copied from interface: PlayListPlayer

The current repeat mode.

Specified by:

getRepeatMode in interface PlayListPlayer

Returns:

current repeat mode

setScanMode

public void setScanMode(PlayListPlayer.ScanMode scanMode)

Description copied from interface: PlayListPlayer

Sets a new scan mode.

Specified by:

setScanMode in interface PlayListPlayer

Parameters:

scanMode - scan mode

getScanMode

public PlayListPlayer.ScanMode getScanMode()

Description copied from interface: PlayListPlayer

The current scan mode.

Specified by:

getScanMode in interface PlayListPlayer

Returns:

current scan mode

addPlayListPlayerInterceptor

public void addPlayListPlayerInterceptor(PlayListPlayerInterceptor interceptor)

Description copied from interface: PlayListPlayer

Adds a PlayListPlayerInterceptor.

Specified by:

addPlayListPlayerInterceptor in interface PlayListPlayer

Parameters:

interceptor - interceptor

removePlayListPlayerInterceptor

public void removePlayListPlayerInterceptor(PlayListPlayerInterceptor interceptor)

Description copied from interface: PlayListPlayer

Removed a PlayListPlayerInterceptor.

Specified by:

removePlayListPlayerInterceptor in interface PlayListPlayer

Parameters:

interceptor - interceptor

getSong

public AudioSong getSong()

Description copied from interface: AudioPlayer

Returns the currently opened song.

Specified by:

getSong in interface AudioPlayer

Returns:

currently opened song

isPaused

public boolean isPaused()

Description copied from interface: AudioPlayer

Indicates whether the song is currently playing.

Specified by:

isPaused in interface AudioPlayer

Returns:

false if the song is playing

fastForward

public void fastForward()

Description copied from interface: AudioPlayer

Plays the file forward at accelerated speed.

Specified by:

fastForward in interface AudioPlayer

reset

public void reset()

Description copied from interface: AudioPlayer

Positions the player at the beginning of the file. Equivalent to calling AudioPlayer.setTime(long) with 0 as argument.

Specified by:

reset in interface AudioPlayer

See Also:

AudioPlayer.setTime(long)

getTime

public long getTime()

Description copied from interface: AudioPlayer

Returns the current time in ms.

Specified by:

getTime in interface AudioPlayer

Returns:

current time in ms

setTime

public void setTime(long time)
             throws IllegalArgumentException

Description copied from interface: AudioPlayer

Sets the current time in ms.

Specified by:

setTime in interface AudioPlayer

Parameters:

time - time in ms

Throws:

IllegalArgumentException - if the time is not valid because it is either less than 0 or greater than duration

See Also:

AudioPlayer.reset(), AudioPlayer.getDuration()

getDuration

public long getDuration()

Description copied from interface: AudioPlayer

Duration of the song in ms.

Specified by:

getDuration in interface AudioPlayer

Returns:

the overall duration of the song in ms.

isDone

public boolean isDone()

Description copied from interface: AudioPlayer

True, if the song was played to the end.

Specified by:

isDone in interface AudioPlayer

Returns:

true if the song was played to the end.

getVolume

public float getVolume()

Description copied from interface: AudioPlayer

Returns the volume.

Specified by:

getVolume in interface AudioPlayer

Returns:

value between -1 and 1, negative values equating to silence

setVolume

public void setVolume(float volume)
               throws IllegalArgumentException

Description copied from interface: AudioPlayer

Changes the volume.

Specified by:

setVolume in interface AudioPlayer

Parameters:

volume - value between -1 and 1, negative values equating to silence. A volume value outside the valid range will lead to an IllegalArgumentException

Throws:

IllegalArgumentException - if the value is outside the valid range

setMuted

public void setMuted(boolean muted)

Description copied from interface: AudioPlayer

Un/mutes this player.

Specified by:

setMuted in interface AudioPlayer

Parameters:

muted - muted

isMuted

public boolean isMuted()

Description copied from interface: AudioPlayer

Indicates whether the player is muted.

Specified by:

isMuted in interface AudioPlayer

Returns:

true to false

setReplayGainType

public void setReplayGainType(ReplayGain.Type type)

Description copied from interface: AudioPlayer

Asks the player to respect the given kind of replay gain. Some players may ignore this property.

Specified by:

setReplayGainType in interface AudioPlayer

Parameters:

type - type

getReplayGainType

public ReplayGain.Type getReplayGainType()

Description copied from interface: AudioPlayer

Currently configured type of replay gain.

Specified by:

getReplayGainType in interface AudioPlayer

Returns:

replay gain type

next

public void next()

Description copied from interface: PlayListPlayer

Move to next song. If playback was active, keep on playing.

Specified by:

next in interface PlayListPlayer

previous

public void previous()

Description copied from interface: PlayListPlayer

Move to previous song. If playback was active, keep on playing.

Specified by:

previous in interface PlayListPlayer

play

public void play()

Description copied from interface: AudioPlayer

Starts playback.

Specified by:

play in interface AudioPlayer

pause

public void pause()

Description copied from interface: AudioPlayer

Stops playback.

Specified by:

pause in interface AudioPlayer

playPause

public void playPause()

Description copied from interface: AudioPlayer

Starts playback, if song is paused, otherwise pauses playback.

Specified by:

playPause in interface AudioPlayer

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener propertyChangeListener)

Specified by:

addPropertyChangeListener in interface AudioPlayer

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener propertyChangeListener)

Specified by:

removePropertyChangeListener in interface AudioPlayer

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener propertyChangeListener)

Specified by:

addPropertyChangeListener in interface AudioPlayer

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener propertyChangeListener)

Specified by:

removePropertyChangeListener in interface AudioPlayer

addAudioPlayerListener

public void addAudioPlayerListener(AudioPlayerListener listener)

Specified by:

addAudioPlayerListener in interface AudioPlayer

removeAudioPlayerListener

public void removeAudioPlayerListener(AudioPlayerListener listener)

Specified by:

removeAudioPlayerListener in interface AudioPlayer

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

close

public void close()

Description copied from interface: AudioPlayer

Closes the audio file and associated player resources.

Specified by:

close in interface AudioPlayer