com.devbrackets.android.exomedia.core.audio

Class NativeAudioPlayer

java.lang.Object

com.devbrackets.android.exomedia.core.audio.NativeAudioPlayer

All Implemented Interfaces:

AudioPlayerApi

public class NativeAudioPlayer
extends java.lang.Object
implements AudioPlayerApi

A simple MediaPlayer implementation that extends the one provided by the system to add integration with the ListenerMux and to mitigate state errors.

NOTE: The listenerMux shouldn't be null when any method utilizing it is called, however there are some cases on Amazon devices where they incorrectly call these methods when setting up the MediaPlayer (when in IDLE state)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	NativeAudioPlayer.InternalListeners

Field Summary

Fields

Modifier and Type	Field and Description
protected android.content.Context	context
protected int	currentBufferPercent
protected NativeAudioPlayer.InternalListeners	internalListeners
protected ListenerMux	listenerMux
protected android.media.MediaPlayer	mediaPlayer
protected long	requestedSeek
protected float	volumeLeft
protected float	volumeRight

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
int	getAudioSessionId()
java.util.Map<ExoMedia.RendererType,TrackGroupArray>	getAvailableTracks() Retrieves a list of available tracks to select from.
int	getBufferedPercent()
long	getCurrentPosition()
long	getDuration()
float	getPlaybackSpeed()
int	getSelectedTrackIndex(ExoMedia.RendererType type, int groupIndex)
float	getVolumeLeft()
float	getVolumeRight()
WindowInfo	getWindowInfo()
boolean	isPlaying()
void	onMediaPrepared()
void	pause()
void	prepareAsync() Prepares the media specified with AudioPlayerApi.setDataSource(Uri) or AudioPlayerApi.setDataSource(Uri, MediaSource) in an asynchronous manner
void	release() Releases the resources associated with this media player
void	reset()
boolean	restart() Prepares the media previously specified for playback.
void	seekTo(long milliseconds)
void	setAudioStreamType(int streamType) Sets the audio stream type for this MediaPlayer.
void	setDataSource(android.net.Uri uri)
void	setDataSource(android.net.Uri uri, MediaSource mediaSource)
void	setDrmCallback(MediaDrmCallback drmCallback) Sets the MediaDrmCallback to use when handling DRM for media.
void	setListenerMux(ListenerMux listenerMux)
boolean	setPlaybackSpeed(float speed) Sets the playback speed for this MediaPlayer.
void	setRepeatMode(int repeatMode)
void	setTrack(ExoMedia.RendererType trackType, int trackIndex)
void	setTrack(ExoMedia.RendererType type, int groupIndex, int trackIndex)
void	setVolume(float left, float right)
void	setWakeMode(android.content.Context context, int mode)
void	start()
void	stopPlayback()
boolean	trackSelectionAvailable()

Methods inherited from class java.lang.Object

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

Field Detail

context

protected final android.content.Context context

mediaPlayer

protected final android.media.MediaPlayer mediaPlayer

internalListeners

protected NativeAudioPlayer.InternalListeners internalListeners

listenerMux

protected ListenerMux listenerMux

requestedSeek

protected long requestedSeek

currentBufferPercent

protected int currentBufferPercent

volumeLeft

protected float volumeLeft

volumeRight

protected float volumeRight

Constructor Detail

NativeAudioPlayer

public NativeAudioPlayer(android.content.Context context)

Method Detail

setDataSource

public void setDataSource(android.net.Uri uri)

Specified by:

setDataSource in interface AudioPlayerApi

setDataSource

public void setDataSource(android.net.Uri uri,
                          MediaSource mediaSource)

Specified by:

setDataSource in interface AudioPlayerApi

setDrmCallback

public void setDrmCallback(MediaDrmCallback drmCallback)

Description copied from interface: AudioPlayerApi

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 +

Specified by:

setDrmCallback in interface AudioPlayerApi

Parameters:

drmCallback - The callback to use when handling DRM media

prepareAsync

public void prepareAsync()

Description copied from interface: AudioPlayerApi

Prepares the media specified with AudioPlayerApi.setDataSource(Uri) or AudioPlayerApi.setDataSource(Uri, MediaSource) in an asynchronous manner

Specified by:

prepareAsync in interface AudioPlayerApi

reset

public void reset()

Specified by:

reset in interface AudioPlayerApi

getVolumeLeft

public float getVolumeLeft()

Specified by:

getVolumeLeft in interface AudioPlayerApi

getVolumeRight

public float getVolumeRight()

Specified by:

getVolumeRight in interface AudioPlayerApi

setVolume

public void setVolume(float left,
                      float right)

Specified by:

setVolume in interface AudioPlayerApi

seekTo

public void seekTo(long milliseconds)

Specified by:

seekTo in interface AudioPlayerApi

isPlaying

public boolean isPlaying()

Specified by:

isPlaying in interface AudioPlayerApi

start

public void start()

Specified by:

start in interface AudioPlayerApi

pause

public void pause()

Specified by:

pause in interface AudioPlayerApi

stopPlayback

public void stopPlayback()

Specified by:

stopPlayback in interface AudioPlayerApi

restart

public boolean restart()

Description copied from interface: AudioPlayerApi

Prepares the media previously specified for playback. This should only be called after the playback has completed to restart playback from the beginning.

Specified by:

restart in interface AudioPlayerApi

Returns:

true if the media was successfully restarted

getDuration

public long getDuration()

Specified by:

getDuration in interface AudioPlayerApi

getCurrentPosition

public long getCurrentPosition()

Specified by:

getCurrentPosition in interface AudioPlayerApi

getBufferedPercent

public int getBufferedPercent()

Specified by:

getBufferedPercent in interface AudioPlayerApi

getWindowInfo

public WindowInfo getWindowInfo()

Specified by:

getWindowInfo in interface AudioPlayerApi

release

public void release()

Description copied from interface: AudioPlayerApi

Releases the resources associated with this media player

Specified by:

release in interface AudioPlayerApi

getAudioSessionId

public int getAudioSessionId()

Specified by:

getAudioSessionId in interface AudioPlayerApi

setPlaybackSpeed

public boolean setPlaybackSpeed(float speed)

Description copied from interface: AudioPlayerApi

Sets the playback speed for this MediaPlayer.

Specified by:

setPlaybackSpeed in interface AudioPlayerApi

Parameters:

speed - The speed to play the media back at

Returns:

True if the speed was set

getPlaybackSpeed

public float getPlaybackSpeed()

Specified by:

getPlaybackSpeed in interface AudioPlayerApi

setAudioStreamType

public void setAudioStreamType(int streamType)

Description copied from interface: AudioPlayerApi

Sets the audio stream type for this MediaPlayer. See AudioManager for a list of stream types. Must call this method before prepare() or prepareAsync() in order for the target stream type to become effective thereafter.

Specified by:

setAudioStreamType in interface AudioPlayerApi

Parameters:

streamType - The audio stream type

See Also:

AudioManager

setWakeMode

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

Specified by:

setWakeMode in interface AudioPlayerApi

trackSelectionAvailable

public boolean trackSelectionAvailable()

Specified by:

trackSelectionAvailable in interface AudioPlayerApi

setTrack

public void setTrack(ExoMedia.RendererType trackType,
                     int trackIndex)

Specified by:

setTrack in interface AudioPlayerApi

setTrack

public void setTrack(ExoMedia.RendererType type,
                     int groupIndex,
                     int trackIndex)

Specified by:

setTrack in interface AudioPlayerApi

getSelectedTrackIndex

public int getSelectedTrackIndex(ExoMedia.RendererType type,
                                 int groupIndex)

Specified by:

getSelectedTrackIndex in interface AudioPlayerApi

getAvailableTracks

public java.util.Map<ExoMedia.RendererType,TrackGroupArray> getAvailableTracks()

Description copied from interface: AudioPlayerApi

Retrieves a list of available tracks to select from. Typically AudioPlayerApi.trackSelectionAvailable() should be called before this.

Specified by:

getAvailableTracks in interface AudioPlayerApi

Returns:

A list of available tracks associated with each track type

setListenerMux

public void setListenerMux(ListenerMux listenerMux)

Specified by:

setListenerMux in interface AudioPlayerApi

onMediaPrepared

public void onMediaPrepared()

Specified by:

onMediaPrepared in interface AudioPlayerApi

setRepeatMode

public void setRepeatMode(int repeatMode)

Specified by:

setRepeatMode in interface AudioPlayerApi