added in version 26.1.0
belongs to Maven artifact com.android.support:leanback-v17:28.0.0-alpha1

Summary: Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

MediaPlayerAdapter

This package is part of the Android support library which is no longer maintained. The support library has been superseded by AndroidX which is part of Jetpack. We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library class mappings.

public class MediaPlayerAdapter
extends PlayerAdapter

java.lang.Object
↳	android.support.v17.leanback.media.PlayerAdapter
	↳	android.support.v17.leanback.media.MediaPlayerAdapter

---

This implementation extends the PlayerAdapter with a MediaPlayer.

Summary

Public constructors
MediaPlayerAdapter(Context context) Constructor.

Public methods
long	getBufferedPosition() Returns the current buffered position of the media item in milliseconds.
long	getCurrentPosition() Returns the current position of the media item in milliseconds.
long	getDuration() Returns the duration of the media item in milliseconds.
boolean	isPlaying() Returns true if media is currently playing.
boolean	isPrepared()
void	onAttachedToHost(PlaybackGlueHost host) This method is called attached to associated PlaybackGlueHost.
void	onDetachedFromHost() This method is called when current associated PlaybackGlueHost is attached to a different PlaybackGlue or PlaybackGlueHost is destroyed.
void	pause() Pauses the media player.
void	play() Starts the media player.
void	release() Release internal MediaPlayer.
void	reset() Will reset the MediaPlayer and the glue such that a new file can be played.
void	seekTo(long newPosition) Seek to new position.
boolean	setDataSource(Uri uri) Sets the media source of the player witha given URI.
void	setProgressUpdatingEnabled(boolean enabled) Implement this method to enable or disable progress updating.

Protected methods
boolean	onError(int what, int extra) Called to indicate an error.
boolean	onInfo(int what, int extra) Called to indicate an info or a warning.
void	onSeekComplete() Called to indicate the completion of a seek operation.

Inherited methods
From class android.support.v17.leanback.media.PlayerAdapter void fastForward() Optional method. long getBufferedPosition() Returns the current buffered position of the media item in milliseconds. final PlayerAdapter.Callback getCallback() Gets callback for event of PlayerAdapter. long getCurrentPosition() Returns the current position of the media item in milliseconds. long getDuration() Returns the duration of the media item in milliseconds. long getSupportedActions() Return xor combination of values defined in PlaybackBaseControlGlue. boolean isPlaying() Returns true if media is currently playing. boolean isPrepared() void next() Optional method. void onAttachedToHost(PlaybackGlueHost host) This method is called attached to associated PlaybackGlueHost. void onDetachedFromHost() This method is called when current associated PlaybackGlueHost is attached to a different PlaybackGlue or PlaybackGlueHost is destroyed. abstract void pause() Pauses the media player. abstract void play() Starts the media player. void previous() Optional method. void rewind() Optional method. void seekTo(long positionInMs) Seek to new position. final void setCallback(PlayerAdapter.Callback callback) Sets callback for event of PlayerAdapter. void setProgressUpdatingEnabled(boolean enable) Implement this method to enable or disable progress updating. void setRepeatAction(int repeatActionIndex) Optional method. void setShuffleAction(int shuffleActionIndex) Optional method.
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait(long arg0, int arg1) final void wait(long arg0) final void wait()

Public constructors

MediaPlayerAdapter

added in version 26.1.0

MediaPlayerAdapter (Context context)

Constructor.

Parameters
context	Context

Public methods

getBufferedPosition

added in version 26.1.0

long getBufferedPosition ()

Returns the current buffered position of the media item in milliseconds.

Returns
long

getCurrentPosition

added in version 26.1.0

long getCurrentPosition ()

Returns the current position of the media item in milliseconds.

Returns
long

getDuration

added in version 26.1.0

long getDuration ()

Returns the duration of the media item in milliseconds.

Returns
long

isPlaying

added in version 26.1.0

boolean isPlaying ()

Returns true if media is currently playing.

Returns
boolean

isPrepared

added in version 26.1.0

boolean isPrepared ()

Returns
boolean	True if MediaPlayer OnPreparedListener is invoked and got a SurfaceHolder if PlaybackGlueHost provides SurfaceHolder.

onAttachedToHost

added in version 26.1.0

void onAttachedToHost (PlaybackGlueHost host)

This method is called attached to associated PlaybackGlueHost.

onDetachedFromHost

added in version 26.1.0

void onDetachedFromHost ()

This method is called when current associated PlaybackGlueHost is attached to a different PlaybackGlue or PlaybackGlueHost is destroyed. Subclass may override. A typical implementation will release resources (e.g. MediaPlayer or connection to playback service) in this method.

pause

added in version 26.1.0

void pause ()

Pauses the media player.

play

added in version 26.1.0

void play ()

Starts the media player.

release

added in version 26.1.0

void release ()

Release internal MediaPlayer. Should not use the object after call release().

reset

added in version 26.1.0

void reset ()

Will reset the MediaPlayer and the glue such that a new file can be played. You are not required to call this method before playing the first file. However you have to call it before playing a second one.

seekTo

added in version 26.1.0

void seekTo (long newPosition)

Seek to new position.

Parameters
newPosition	long: New position in milliseconds.

setDataSource

added in version 26.1.0

boolean setDataSource (Uri uri)

Sets the media source of the player witha given URI.

Parameters
uri	Uri

Returns
boolean	Returns true if uri represents a new media; false otherwise.

See also:

• setDataSource(String)

setProgressUpdatingEnabled

added in version 26.1.0

void setProgressUpdatingEnabled (boolean enabled)

Implement this method to enable or disable progress updating.

Parameters
enabled	boolean: True to enable progress updating, false otherwise.

Protected methods

onError

added in version 26.1.0

boolean onError (int what, 
                int extra)

Called to indicate an error.

Parameters
what	int: the type of error that has occurred: MEDIA_ERROR_UNKNOWN MEDIA_ERROR_SERVER_DIED
extra	int: an extra code, specific to the error. Typically implementation dependent. MEDIA_ERROR_IO MEDIA_ERROR_MALFORMED MEDIA_ERROR_UNSUPPORTED MEDIA_ERROR_TIMED_OUT MEDIA_ERROR_SYSTEM (-2147483648) - low-level system error.

Returns
boolean	True if the method handled the error, false if it didn't. Returning false, will cause the onPlayCompleted(PlayerAdapter) being called.

onInfo

added in version 26.1.0

boolean onInfo (int what, 
                int extra)

Called to indicate an info or a warning.

Parameters
what	int: the type of info or warning. MEDIA_INFO_UNKNOWN MEDIA_INFO_VIDEO_TRACK_LAGGING MEDIA_INFO_VIDEO_RENDERING_START MEDIA_INFO_BUFFERING_START MEDIA_INFO_BUFFERING_END MEDIA_INFO_NETWORK_BANDWIDTH (703) - bandwidth information is available (as extra kbps) MEDIA_INFO_BAD_INTERLEAVING MEDIA_INFO_NOT_SEEKABLE MEDIA_INFO_METADATA_UPDATE MEDIA_INFO_UNSUPPORTED_SUBTITLE MEDIA_INFO_SUBTITLE_TIMED_OUT
extra	int: an extra code, specific to the info. Typically implementation dependent.

Returns
boolean	True if the method handled the info, false if it didn't. Returning false, will cause the info to be discarded.

onSeekComplete

added in version 26.1.0

void onSeekComplete ()

Called to indicate the completion of a seek operation.

• Interfaces

  • SurfaceHolderGlueHost

• Classes

  • MediaControllerAdapter
  • MediaControllerGlue
  • MediaPlayerAdapter
  • PlaybackBannerControlGlue
  • PlaybackBaseControlGlue
  • PlaybackControlGlue
  • PlaybackGlue
  • PlaybackGlue.PlayerCallback
  • PlaybackGlueHost
  • PlaybackGlueHost.HostCallback
  • PlaybackGlueHost.PlayerCallback
  • PlaybackTransportControlGlue
  • PlayerAdapter
  • PlayerAdapter.Callback