com.devbrackets.android.exomedia.core.exoplayer

Class ExoMediaPlayer

java.lang.Object

com.devbrackets.android.exomedia.core.exoplayer.ExoMediaPlayer

All Implemented Interfaces:

com.google.android.exoplayer2.ExoPlayer.EventListener

public class ExoMediaPlayer
extends java.lang.Object
implements com.google.android.exoplayer2.ExoPlayer.EventListener

Constructor Summary

Constructors

Constructor and Description
ExoMediaPlayer(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
void	addListener(ExoPlayerListener listener)
void	blockingClearSurface()
void	forcePrepare()
protected com.google.android.exoplayer2.drm.DrmSessionManager<com.google.android.exoplayer2.drm.FrameworkMediaCrypto>	generateDrmSessionManager() Generates the DrmSessionManager to use with the RendererProvider.
int	getAudioSessionId()
java.util.Map<ExoMedia.RendererType,com.google.android.exoplayer2.source.TrackGroupArray>	getAvailableTracks() Retrieves a list of available tracks
int	getBufferedPercentage()
long	getCurrentPosition()
long	getDuration()
protected int	getExoPlayerTrackType(ExoMedia.RendererType type)
int	getPlaybackState()
boolean	getPlayWhenReady()
int	getSelectedTrackIndex(ExoMedia.RendererType type)
android.view.Surface	getSurface()
void	onLoadingChanged(boolean isLoading)
void	onPlaybackParametersChanged(com.google.android.exoplayer2.PlaybackParameters playbackParameters)
void	onPlayerError(com.google.android.exoplayer2.ExoPlaybackException exception)
void	onPlayerStateChanged(boolean playWhenReady, int state)
void	onPositionDiscontinuity()
void	onTimelineChanged(com.google.android.exoplayer2.Timeline timeline, java.lang.Object manifest)
void	onTracksChanged(com.google.android.exoplayer2.source.TrackGroupArray trackGroups, com.google.android.exoplayer2.trackselection.TrackSelectionArray trackSelections)
void	prepare()
void	release()
void	removeListener(ExoPlayerListener listener)
boolean	restart() Seeks to the beginning of the media, and plays it.
void	seekTo(long positionMs)
protected void	sendMessage(int renderType, int messageType, java.lang.Object message)
protected void	sendMessage(int renderType, int messageType, java.lang.Object message, boolean blocking)
void	setBufferUpdateListener(OnBufferUpdateListener listener)
void	setCaptionListener(CaptionListener listener)
void	setDrmCallback(com.google.android.exoplayer2.drm.MediaDrmCallback drmCallback) Sets the MediaDrmCallback to use when handling DRM for media.
void	setInternalErrorListener(InternalErrorListener listener)
void	setMediaSource(com.google.android.exoplayer2.source.MediaSource source)
void	setMetadataListener(MetadataListener listener)
boolean	setPlaybackSpeed(float speed)
void	setPlayWhenReady(boolean playWhenReady)
void	setSelectedTrack(ExoMedia.RendererType type, int index)
void	setSurface(android.view.Surface surface)
void	setUri(android.net.Uri uri)
void	setVolume(float volume)
void	setWakeMode(android.content.Context context, int mode) This function has the MediaPlayer access the low-level power manager service to control the device's power usage while playing is occurring.
protected void	stayAwake(boolean awake) Used with playback state changes to correctly acquire and release the wakelock if the user has enabled it with setWakeMode(Context, int).
void	stop()

Methods inherited from class java.lang.Object

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

Constructor Detail

ExoMediaPlayer

public ExoMediaPlayer(@NonNull
                      android.content.Context context)

Method Detail

onTimelineChanged

public void onTimelineChanged(com.google.android.exoplayer2.Timeline timeline,
                              java.lang.Object manifest)

Specified by:

onTimelineChanged in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onTracksChanged

public void onTracksChanged(com.google.android.exoplayer2.source.TrackGroupArray trackGroups,
                            com.google.android.exoplayer2.trackselection.TrackSelectionArray trackSelections)

Specified by:

onTracksChanged in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onLoadingChanged

public void onLoadingChanged(boolean isLoading)

Specified by:

onLoadingChanged in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onPositionDiscontinuity

public void onPositionDiscontinuity()

Specified by:

onPositionDiscontinuity in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onPlaybackParametersChanged

public void onPlaybackParametersChanged(com.google.android.exoplayer2.PlaybackParameters playbackParameters)

Specified by:

onPlaybackParametersChanged in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onPlayerStateChanged

public void onPlayerStateChanged(boolean playWhenReady,
                                 int state)

Specified by:

onPlayerStateChanged in interface com.google.android.exoplayer2.ExoPlayer.EventListener

onPlayerError

public void onPlayerError(com.google.android.exoplayer2.ExoPlaybackException exception)

Specified by:

onPlayerError in interface com.google.android.exoplayer2.ExoPlayer.EventListener

setDrmCallback

public void setDrmCallback(@Nullable
                           com.google.android.exoplayer2.drm.MediaDrmCallback drmCallback)

Sets the MediaDrmCallback to use when handling DRM for media. This should be called before specifying the videos uri or path
NOTE: DRM is only supported on API 18 +

Parameters:

drmCallback - The callback to use when handling DRM media

setUri

public void setUri(@Nullable
                   android.net.Uri uri)

setMediaSource

public void setMediaSource(@Nullable
                           com.google.android.exoplayer2.source.MediaSource source)

addListener

public void addListener(ExoPlayerListener listener)

removeListener

public void removeListener(ExoPlayerListener listener)

setBufferUpdateListener

public void setBufferUpdateListener(@Nullable
                                    OnBufferUpdateListener listener)

setInternalErrorListener

public void setInternalErrorListener(@Nullable
                                     InternalErrorListener listener)

setCaptionListener

public void setCaptionListener(@Nullable
                               CaptionListener listener)

setMetadataListener

public void setMetadataListener(@Nullable
                                MetadataListener listener)

setSurface

public void setSurface(@Nullable
                       android.view.Surface surface)

getSurface

@Nullable
public android.view.Surface getSurface()

blockingClearSurface

public void blockingClearSurface()

getAvailableTracks

@Nullable
public java.util.Map<ExoMedia.RendererType,com.google.android.exoplayer2.source.TrackGroupArray> getAvailableTracks()

Retrieves a list of available tracks

Returns:

A list of available tracks associated with each type

getSelectedTrackIndex

public int getSelectedTrackIndex(@NonNull
                                 ExoMedia.RendererType type)

setSelectedTrack

public void setSelectedTrack(@NonNull
                             ExoMedia.RendererType type,
                             int index)

setVolume

public void setVolume(float volume)

forcePrepare

public void forcePrepare()

prepare

public void prepare()

stop

public void stop()

setPlayWhenReady

public void setPlayWhenReady(boolean playWhenReady)

seekTo

public void seekTo(long positionMs)

restart

public boolean restart()

Seeks to the beginning of the media, and plays it. This method will not succeed if playback state is not ExoPlayer.STATE_IDLE or ExoPlayer.STATE_ENDED.

Returns:

true if the media was successfully restarted, otherwise false

release

public void release()

getPlaybackState

public int getPlaybackState()

getAudioSessionId

public int getAudioSessionId()

setPlaybackSpeed

public boolean setPlaybackSpeed(float speed)

getCurrentPosition

public long getCurrentPosition()

getDuration

public long getDuration()

getBufferedPercentage

public int getBufferedPercentage()

getPlayWhenReady

public boolean getPlayWhenReady()

setWakeMode

public void setWakeMode(android.content.Context context,
                        int mode)

This function has the MediaPlayer access the low-level power manager service to control the device's power usage while playing is occurring. The parameter is a combination of PowerManager wake flags. Use of this method requires Manifest.permission.WAKE_LOCK permission. By default, no attempt is made to keep the device awake during playback.

Parameters:

context - the Context to use

mode - the power/wake mode to set

See Also:

PowerManager

getExoPlayerTrackType

protected int getExoPlayerTrackType(@NonNull
                                    ExoMedia.RendererType type)

sendMessage

protected void sendMessage(int renderType,
                           int messageType,
                           java.lang.Object message)

sendMessage

protected void sendMessage(int renderType,
                           int messageType,
                           java.lang.Object message,
                           boolean blocking)

stayAwake

protected void stayAwake(boolean awake)

Used with playback state changes to correctly acquire and release the wakelock if the user has enabled it with setWakeMode(Context, int). If the wakeLock is null then no action will be performed.

Parameters:

awake - True if the wakelock should be acquired

generateDrmSessionManager

@Nullable
protected com.google.android.exoplayer2.drm.DrmSessionManager<com.google.android.exoplayer2.drm.FrameworkMediaCrypto> generateDrmSessionManager()

Generates the DrmSessionManager to use with the RendererProvider. This will return null on API's <

Returns:

The DrmSessionManager to use or null