Android MediaPlayer

Method Name	Valid Sates	Invalid States	Comments
attachAuxEffect	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Error}	This method must be called after setDataSource. Calling it does not change the object state.
getAudioSessionId	any	{}	This method can be called in any state and calling it does not change the object state.
getCurrentPosition	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getDuration	{Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getVideoHeight	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
getVideoWidth	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
isPlaying	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
pause	{Started, Paused, PlaybackCompleted}	{Idle, Initialized, Prepared, Stopped, Error}	Successful invoke of this method in a valid state transfers the object to the Paused state. Calling this method in an invalid state transfers the object to the Error state.
prepare	{Initialized, Stopped}	{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Prepared state. Calling this method in an invalid state throws an IllegalStateException.
prepareAsync	{Initialized, Stopped}	{Idle, Prepared, Started, Paused, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Preparing state. Calling this method in an invalid state throws an IllegalStateException.
release	any	{}	After release(), the object is no longer available.
reset	{Idle, Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	{}	After reset(), the object is like being just created.
seekTo	{Prepared, Started, Paused, PlaybackCompleted}	{Idle, Initialized, Stopped, Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
setAudioSessionId	{Idle}	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	This method must be called in idle state as the audio session ID must be known before calling setDataSource. Calling it does not change the object state.
setAudioStreamType	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method does not change the state. In order for the target audio stream type to become effective, this method must be called before prepare() or prepareAsync().
setAuxEffectSendLevel	any	{}	Calling this method does not change the object state.
setDataSource	{Idle}	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, Error}	Successful invoke of this method in a valid state transfers the object to the Initialized state. Calling this method in an invalid state throws an IllegalStateException.
setDisplay	any	{}	This method can be called in any state and calling it does not change the object state.
setSurface	any	{}	This method can be called in any state and calling it does not change the object state.
setVideoScalingMode	{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted}	{Idle, Error}	Successful invoke of this method does not change the state.
setLooping	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method in a valid state does not change the state. Calling this method in an invalid state transfers the object to the Error state.
isLooping	any	{}	This method can be called in any state and calling it does not change the object state.
setOnBufferingUpdateListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnCompletionListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnErrorListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnPreparedListener	any	{}	This method can be called in any state and calling it does not change the object state.
setOnSeekCompleteListener	any	{}	This method can be called in any state and calling it does not change the object state.
setScreenOnWhilePlaying	any	{}	This method can be called in any state and calling it does not change the object state.
setVolume	{Idle, Initialized, Stopped, Prepared, Started, Paused, PlaybackCompleted}	{Error}	Successful invoke of this method does not change the state.
setWakeMode	any	{}	This method can be called in any state and calling it does not change the object state.
start	{Prepared, Started, Paused, PlaybackCompleted}	{Idle, Initialized, Stopped, Error}	Successful invoke of this method in a valid state transfers the object to the Started state. Calling this method in an invalid state transfers the object to the Error state.
stop	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method in a valid state transfers the object to the Stopped state. Calling this method in an invalid state transfers the object to the Error state.
getTrackInfo	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
addTimedTextSource	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
selectTrack	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.
deselectTrack	{Prepared, Started, Stopped, Paused, PlaybackCompleted}	{Idle, Initialized, Error}	Successful invoke of this method does not change the state.

Public Methods
void	addTimedTextSource( Context context,  Uri uri,  String mimeType) Adds an external timed text source file (Uri).
void	addTimedTextSource( String path,  String mimeType) Adds an external timed text source file.
void	addTimedTextSource( FileDescriptor fd, long offset, long length,  String mimeType) Adds an external timed text file (FileDescriptor).
void	addTimedTextSource( FileDescriptor fd,  String mimeType) Adds an external timed text source file (FileDescriptor).
void	attachAuxEffect(int effectId) Attaches an auxiliary effect to the player.
static  MediaPlayer	create( Context context,  Uri uri,  SurfaceHolder holder) Convenience method to create a MediaPlayer for a given Uri.
static  MediaPlayer	create( Context context, int resid) Convenience method to create a MediaPlayer for a given resource id.
static  MediaPlayer	create( Context context,  Uri uri) Convenience method to create a MediaPlayer for a given Uri.
void	deselectTrack(int index) Deselect a track.
int	getAudioSessionId() Returns the audio session ID.
int	getCurrentPosition() Gets the current playback position.
int	getDuration() Gets the duration of the file.
TrackInfo[]	getTrackInfo() Returns an array of track information.
int	getVideoHeight() Returns the height of the video.
int	getVideoWidth() Returns the width of the video.
boolean	isLooping() Checks whether the MediaPlayer is looping or non-looping.
boolean	isPlaying() Checks whether the MediaPlayer is playing.
void	pause() Pauses playback.
void	prepare() Prepares the player for playback, synchronously.
void	prepareAsync() Prepares the player for playback, asynchronously.
void	release() Releases resources associated with this MediaPlayer object.
void	reset() Resets the MediaPlayer to its uninitialized state.
void	seekTo(int msec) Seeks to specified time position.
void	selectTrack(int index) Selects a track.
void	setAudioSessionId(int sessionId) Sets the audio session ID.
void	setAudioStreamType(int streamtype) Sets the audio stream type for this MediaPlayer.
void	setAuxEffectSendLevel(float level) Sets the send level of the player to the attached auxiliary effect .
void	setDataSource( String path) Sets the data source (file-path or http/rtsp URL) to use.
void	setDataSource( Context context,  Uri uri,  Map< String,  String> headers) Sets the data source as a content Uri.
void	setDataSource( Context context,  Uri uri) Sets the data source as a content Uri.
void	setDataSource( FileDescriptor fd, long offset, long length) Sets the data source (FileDescriptor) to use.
void	setDataSource( FileDescriptor fd) Sets the data source (FileDescriptor) to use.
void	setDisplay( SurfaceHolder sh) Sets the  SurfaceHolder to use for displaying the video portion of the media.
void	setLooping(boolean looping) Sets the player to be looping or non-looping.
void	setNextMediaPlayer( MediaPlayer next) Set the MediaPlayer to start when this MediaPlayer finishes playback (i.e.
void	setOnBufferingUpdateListener( MediaPlayer.OnBufferingUpdateListener listener) Register a callback to be invoked when the status of a network stream's buffer has changed.
void	setOnCompletionListener( MediaPlayer.OnCompletionListener listener) Register a callback to be invoked when the end of a media source has been reached during playback.
void	setOnErrorListener( MediaPlayer.OnErrorListener listener) Register a callback to be invoked when an error has happened during an asynchronous operation.
void	setOnInfoListener( MediaPlayer.OnInfoListener listener) Register a callback to be invoked when an info/warning is available.
void	setOnPreparedListener( MediaPlayer.OnPreparedListener listener) Register a callback to be invoked when the media source is ready for playback.
void	setOnSeekCompleteListener( MediaPlayer.OnSeekCompleteListener listener) Register a callback to be invoked when a seek operation has been completed.
void	setOnTimedTextListener( MediaPlayer.OnTimedTextListener listener) Register a callback to be invoked when a timed text is available for display.
void	setOnVideoSizeChangedListener( MediaPlayer.OnVideoSizeChangedListener listener) Register a callback to be invoked when the video size is known or updated.
void	setScreenOnWhilePlaying(boolean screenOn) Control whether we should use the attached SurfaceHolder to keep the screen on while video playback is occurring.
void	setSurface( Surface surface) Sets the  Surface to be used as the sink for the video portion of the media.
void	setVideoScalingMode(int mode) Sets video scaling mode.
void	setVolume(float leftVolume, float rightVolume) Sets the volume on this player.
void	setWakeMode( Context context, int mode) Set the low-level power management behavior for this MediaPlayer.
void	start() Starts or resumes playback.
void	stop() Stops playback after playback has been stopped or paused.