APlayer

java.lang.Object
- com.jcodeing.kmedia.APlayer

Type Parameters:

P - subClass

All Implemented Interfaces:

IPlayer, IPlayerBase, IPlayerBase.Listener

Direct Known Subclasses:

Player
```
public abstract class APlayer
extends java.lang.Object
implements IPlayer, IPlayerBase.Listener
```
Abstract Player

See Also:

Player

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected class APlayer.ComponentListener

protected class APlayer.ComponentReceiver
- Nested classes/interfaces inherited from interface com.jcodeing.kmedia.IPlayer
  IPlayer.Listener

Nested Classes
Modifier and Type	Class and Description
`protected class`	`APlayer.ComponentListener`
`protected class`	`APlayer.ComponentReceiver`

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`abAutoClear`
`protected boolean`	`abEnabled` [A-B] whether enabled
`protected long`	`abEndPosition` [A-B] end position
`protected int`	`abInterval` [A-B] loop interval
`protected int`	`abLoopedCount` [A-B] looped count tag
`protected int`	`abLoopMode` [A-B] Loop Mode -8: infinity loop x(<=0): not loop 1++(>0): specified number loop
`protected long`	`abStartPosition` [A-B] start position
`protected AudioMgrHelper`	`audioMgrHelper`
`protected android.content.IntentFilter`	`componentIntentFilter`
`protected APlayer.ComponentListener`	`componentListener`
`protected APlayer.ComponentReceiver`	`componentReceiver`
`private boolean`	`componentReceiverRegistered`
`protected android.content.Context`	`context`
`private int`	`currentAudioFocusState`
`protected java.lang.String`	`currentMediaId`
`protected int`	`currentPosUnitIndex` current PositionUnit index
`protected boolean`	`enabledAudioFocusManage`
`protected android.os.Handler`	`handler`
`protected IMediaPlayer`	`internalPlayer`
`protected boolean`	`isInAB` Whether the current position in the range of [A-B]
`protected boolean`	`isInPosUnit` Whether the current position in the range of position unit
`protected java.util.concurrent.CopyOnWriteArrayList<IPlayer.Listener>`	`listeners`
`private IMediaQueue`	`mediaQueue`
`protected android.os.Handler`	`methodAgent` Simple Method Agent What Code 1: start(); 31: seekToPositionUnitIndex(currentPosUnitIndex) 311: seekToPositionUnitIndex(currentPosUnitIndex) with posUnitLoopedCount++ 3111: seekToPositionUnitIndex(msg.arg1) 32: seekTo(abStartPosition) 322: seekTo(abStartPosition) with abLoopedCount++
`protected long`	`pendingSeekToMs`
`protected IPositionUnitList`	`posUnitList`
`protected int`	`posUnitLoopedCount` [position unit] looped count tag
`protected boolean`	`posUnitLoopEnabled` [position unit] Loop whether enabled
`protected java.util.ArrayList<java.lang.Integer>`	`posUnitLoopIndexList` specified [position unit] loop List(index)
`protected int`	`posUnitLoopInterval` [position unit] loop interval
`protected int`	`posUnitLoopMode` [position unit] Loop Mode -8: infinity loop x(<=0): not loop 1++(>0): specified number loop
`protected boolean`	`shouldAutoPlayWhenPrepared`
`protected boolean`	`shouldAutoPlayWhenSeekComplete`
`protected java.lang.String`	`TAG`
`private java.lang.Runnable`	`updatePlayProgressAction`
`private boolean`	`updatePlayProgressBaseInterruptConditions`
`protected long`	`updatePlayProgressDelayMs`
`protected android.net.wifi.WifiManager.WifiLock`	`wifiLock`

Fields inherited from interface com.jcodeing.kmedia.IPlayerBase
STATE_BUFFERING, STATE_ENDED, STATE_GOT_SOURCE, STATE_IDLE, STATE_READY

Constructor Summary

Constructors
Constructor and Description

APlayer()
Not param constructor.

APlayer(android.content.Context context)
Default support, base on context of function Module.

Constructors
Constructor and Description
`APlayer()` Not param constructor.
`APlayer(android.content.Context context)` Default support, base on context of function Module.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected int`	`abLoopProcessing(int processFrom)`
`protected boolean`	`abProgress(long position)`
`void`	`addListener(IPlayer.Listener listener)`
`protected boolean`	`beforeStart()`
`int`	`calibrateCurrentPositionUnitIndex(long position)` generally not use(player inside Will automatically maintain current [position unit] index calibrate)
`void`	`clearAB()` Clear A-B all tag Tips: setClearAB(false) also don't manual invoke clearAB(), will save all tag.
`void`	`clearVideo()`
`protected boolean`	`configureAudioFocus()`
`boolean`	`fastForwardRewind(long ms)`
`AudioMgrHelper`	`getAudioMgrHelper()`
`protected android.content.IntentFilter`	`getComponentIntentFilter()`
`protected APlayer.ComponentListener`	`getComponentListener()`
`protected APlayer.ComponentReceiver`	`getComponentReceiver()`
`java.lang.String`	`getCurrentMediaId()` Returns current media id (custom or default[string representation of this play uri])
`long`	`getCurrentPosition()`
`int`	`getCurrentPositionUnitIndex()`
`long`	`getDuration()`
`IMediaQueue`	`getMediaQueue()` get a media queue, if not `IPlayer.setMediaQueue(IMediaQueue)`, it return default media queue
`float`	`getPlaybackSpeed()`
`int`	`getPlaybackState()`
`float`	`getVolume()` Returns the volume, with 0 being silence and 1 being unity gain.
`private void`	`giveUpAudioFocus()`
`protected boolean`	`haveSeekToPending()`
`P`	`init(IMediaPlayer mediaPlayer)` Init internal media player
`protected boolean`	`initConfig(IMediaPlayer mediaPlayer)`
`IMediaPlayer`	`internalPlayer()` Get a internal mediaPlayer
`boolean`	`isPlayable()` Playback state != `IPlayerBase.STATE_IDLE` != `IPlayerBase.STATE_GOT_SOURCE` != `IPlayerBase.STATE_BUFFERING`
`boolean`	`isPlaying()`
`protected boolean`	`isPrepared(android.net.Uri uri)`
`protected void`	`onABProgress(long position, long duration, int abState)`
`protected boolean`	`onAudioFocusChange(int focusChange)`
`void`	`onBufferingUpdate(int percent)`
`int`	`onCompletion()`
`boolean`	`onError(int what, int extra, java.lang.Exception e)`
`boolean`	`onInfo(int what, int extra)`
`protected boolean`	`onIntent(android.content.Intent intent)`
`protected void`	`onNotificationRequired(int order)`
`protected boolean`	`onPlayProgress(long position, long duration)`
`protected void`	`onPositionUnitProgress(long position, int posUnitIndex, int posUnitState)`
`void`	`onPrepared()`
`void`	`onSeekComplete()`
`void`	`onStateChanged(int playbackState)` Called when the value returned from `IPlayerBase.getPlaybackState()` changes.
`void`	`onVideoSizeChanged(int width, int height, int unappliedRotationDegrees, float pixelWidthHeightRatio)`
`boolean`	`pause()`
`boolean`	`play()`
`boolean`	`play(IMediaItem mediaItem)`
`boolean`	`play(android.net.Uri uri)`
`boolean`	`playMediaId(java.lang.String mediaId)`
`protected int`	`positionUnitLoopProcessing(int processFrom)`
`protected boolean`	`positionUnitProgress(long position)`
`protected boolean`	`posUnitListAvailable()`
`boolean`	`prepare(IMediaItem mediaItem)`
`protected boolean`	`prepare(IMediaItem mediaItem, boolean shouldAutoPlayWhenPrepared)`
`boolean`	`prepare(android.net.Uri uri)`
`protected boolean`	`prepare(android.net.Uri uri, boolean shouldAutoPlayWhenPrepared)`
`boolean`	`prepareMediaId(java.lang.String mediaId)`
`protected boolean`	`prepareMediaId(java.lang.String mediaId, boolean shouldAutoPlayWhenPrepared)`
`protected void`	`registerComponentReceiver()`
`void`	`release()`
`void`	`removeListener(IPlayer.Listener listener)`
`void`	`reset()`
`protected abstract P`	`returnThis()` Sub Class Override
`boolean`	`seekTo(long ms)` internal call `IPlayer.seekTo(long, int)` Max processing level
`boolean`	`seekTo(long ms, int processingLevel)` Support custom processing level of seekTo
`void`	`seekToPending(long ms)` set a pending seekTo in before start() dispose
`long`	`seekToPositionUnitIndex(int posUnitIndex)` Seeks to specified PositionUnitIndex
`long`	`seekToProgress(int progress, int progressMax)` Seeks to specified progress
`P`	`setAB(long startPos, long endPos)` Set A-B start position and end position with reset ab all tag
`P`	`setAB(long startPos, long endPos, int loopMode, int loopInterval)` Set A-B internal call `IPlayer.setAB(long, long)`, `IPlayer.setABLoop(int, int)` param loopMode,loopInterval can use `C.PARAM_ORIGINAL` keeping the original values param loopMode,loopInterval can use `C.PARAM_UNSET`/`C.PARAM_RESET` unset/reset values
`P`	`setABLoop(int loopMode, int loopInterval)` Set A-B loop param loopMode,loopInterval can use `C.PARAM_ORIGINAL` keeping the original values param loopMode,loopInterval can use `C.PARAM_UNSET`/`C.PARAM_RESET` unset/reset values
`P`	`setClearAB(boolean autoClear)` Set auto clear A-B all tag(when A-B finish) WARNING: If for special reasons cause A-B is not finish, will don't auto clear.
`void`	`setCurrentPositionUnitIndex(int posUnitIndex)` generally not use(player inside Will automatically maintain current [position unit] index)
`P`	`setEnabledAudioFocusManage(boolean enabled)`
`P`	`setEnabledPositionUnitLoop(boolean enabled, int loopMode, int loopInterval)` Set the enabled,loopMode,loopInterval of this position unit loop, with reset position unit looped count tag param loopMode,loopInterval can use `C.PARAM_ORIGINAL` keeping the original values param loopMode,loopInterval can use `C.PARAM_UNSET`/`C.PARAM_RESET` unset/reset values
`P`	`setEnabledWifiLock(boolean enabled)` Set enabled wifi lock, to hold a Wifi lock, which prevents the player from going to sleep while the media is playing.
`void`	`setMediaQueue(IMediaQueue mediaQueue)` set a new media queue for player
`boolean`	`setPlaybackSpeed(float speed)`
`P`	`setPositionUnitList(IPositionUnitList posUnitList)` WARNING: must ensure `IPositionUnitList.getMediaId()` equals `IPlayer.getCurrentMediaId()` can work normally
`protected void`	`setPositionUnitLoop(int loopMode, int loopInterval)`
`P`	`setPositionUnitLoopIndexList(java.util.ArrayList<java.lang.Integer> posUnitLoopIndexList)` WARNING: media source change with specify to loop of [position unit] index list will be reset
`P`	`setUpdatePlayProgressDelayMs(long updatePlayProgressDelayMs)` Sets the updatePlayProgress delay.
`void`	`setVideo(android.view.SurfaceView surfaceView)`
`void`	`setVideo(android.view.TextureView textureView)`
`void`	`setVolume(float volume)` Sets the volume, with 0 being silence and 1 being unity gain.
`P`	`shouldAutoPlayWhenSeekComplete(boolean shouldAutoPlayWhenSeekComplete)` Generally used in front of the seekTo...(.) to ensure that seek complete to auto play immediately after
`void`	`shutdown()` Shut down player (release all resources)
`boolean`	`start()`
`void`	`stop()`
`void`	`supportBaseOnContextOfFunctionModule(android.content.Context context)` Support, base on context of function Module.
`private void`	`tryToGetAudioFocus()`
`protected void`	`unregisterComponentReceiver()`
`protected void`	`updatePlayProgress(int updatePlayProgressCommand)`
`protected boolean`	`updatePlayProgressInterruptConditions()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
 - internalPlayer
```
protected IMediaPlayer internalPlayer
```
 - pendingSeekToMs
```
protected long pendingSeekToMs
```
 - listeners
```
protected final java.util.concurrent.CopyOnWriteArrayList<IPlayer.Listener> listeners
```
 - shouldAutoPlayWhenPrepared
```
protected boolean shouldAutoPlayWhenPrepared
```
 - shouldAutoPlayWhenSeekComplete
```
protected boolean shouldAutoPlayWhenSeekComplete
```
 - updatePlayProgressAction
```
private final java.lang.Runnable updatePlayProgressAction
```
 - updatePlayProgressDelayMs
```
protected long updatePlayProgressDelayMs
```
 - updatePlayProgressBaseInterruptConditions
```
private boolean updatePlayProgressBaseInterruptConditions
```
 - currentPosUnitIndex
```
protected int currentPosUnitIndex
```
 current PositionUnit index
 - posUnitList
```
protected IPositionUnitList posUnitList
```
 - isInPosUnit
```
protected boolean isInPosUnit
```
 Whether the current position in the range of position unit
 ...[start~PosUnit~end]...
 - posUnitLoopEnabled
```
protected boolean posUnitLoopEnabled
```
 [position unit] Loop whether enabled
 - posUnitLoopMode
```
protected int posUnitLoopMode
```
 [position unit] Loop Mode
 - -8: infinity loop
 - x(<=0): not loop
 - 1++(>0): specified number loop
 - posUnitLoopInterval
```
protected int posUnitLoopInterval
```
 [position unit] loop interval
 - posUnitLoopedCount
```
protected int posUnitLoopedCount
```
 [position unit] looped count tag
 - posUnitLoopIndexList
```
protected java.util.ArrayList<java.lang.Integer> posUnitLoopIndexList
```
 specified [position unit] loop List(index)
 - handler
```
protected final android.os.Handler handler
```
 - methodAgent
```
protected final android.os.Handler methodAgent
```
 Simple Method Agent What Code
 - 1: start();
 - 31: seekToPositionUnitIndex(currentPosUnitIndex)
 - 311: seekToPositionUnitIndex(currentPosUnitIndex) with posUnitLoopedCount++
 - 3111: seekToPositionUnitIndex(msg.arg1)
 - 32: seekTo(abStartPosition)
 - 322: seekTo(abStartPosition) with abLoopedCount++
 - abEnabled
```
protected boolean abEnabled
```
 [A-B] whether enabled
 - abStartPosition
```
protected long abStartPosition
```
 [A-B] start position
 - abEndPosition
```
protected long abEndPosition
```
 [A-B] end position
 - abLoopMode
```
protected int abLoopMode
```
 [A-B] Loop Mode
 - -8: infinity loop
 - x(<=0): not loop
 - 1++(>0): specified number loop
 - abInterval
```
protected int abInterval
```
 [A-B] loop interval
 - abLoopedCount
```
protected int abLoopedCount
```
 [A-B] looped count tag
 - abAutoClear
```
protected boolean abAutoClear
```
 - isInAB
```
protected boolean isInAB
```
 Whether the current position in the range of [A-B]
 ...[start~AB~end]...
 - mediaQueue
```
private IMediaQueue mediaQueue
```
 - currentMediaId
```
protected java.lang.String currentMediaId
```
 - wifiLock
```
protected android.net.wifi.WifiManager.WifiLock wifiLock
```
 - audioMgrHelper
```
protected AudioMgrHelper audioMgrHelper
```
 - currentAudioFocusState
```
private int currentAudioFocusState
```
 - enabledAudioFocusManage
```
protected boolean enabledAudioFocusManage
```
 - componentListener
```
protected APlayer.ComponentListener componentListener
```
 - componentReceiverRegistered
```
private boolean componentReceiverRegistered
```
 - componentIntentFilter
```
protected android.content.IntentFilter componentIntentFilter
```
 - componentReceiver
```
protected APlayer.ComponentReceiver componentReceiver
```
 - TAG
```
protected java.lang.String TAG
```
 - context
```
protected android.content.Context context
```
- Constructor Detail
 - APlayer
```
public APlayer()
```
 Not param constructor.
 Internal will nonsupport, base on context of function Module.
 If you later want to support, base on context of function Module. see below (optional operation)
 
 See Also:
 
 APlayer(Context), supportBaseOnContextOfFunctionModule(Context)
 - APlayer
```
public APlayer(@NonNull
 android.content.Context context)
```
 Default support, base on context of function Module.
 
 See Also:
 
 supportBaseOnContextOfFunctionModule(Context), APlayer()
- Method Detail
 - returnThis
```
protected abstract P returnThis()
```
 Sub Class Override
```
 public class Player extends APlayer<Player> {

 @Override
 protected Player returnThis() {
 return this;
 }
 }
 
```
 - internalPlayer
```
public IMediaPlayer internalPlayer()
```
 Description copied from interface: IPlayer
 Get a internal mediaPlayer
```
 Player run core by internal maintaining mediaPlayer.
 In general is not recommended unless you want to operate some special functions.
 * note that internalPlayer and Player
 * at the same time operating possible when the incompatibilities
 
```
 Specified by:
 
 internalPlayer in interface IPlayer
 - initConfig
```
protected boolean initConfig(IMediaPlayer mediaPlayer)
```
 Returns:
 
 internalPlayer != null
 - init
```
public P init(IMediaPlayer mediaPlayer)
```
 Description copied from interface: IPlayer
 
 Init internal media player
 
 Specified by:
 
 init in interface IPlayer
 - isPrepared
```
protected boolean isPrepared(android.net.Uri uri)
```
 - prepare
```
protected boolean prepare(android.net.Uri uri,
 boolean shouldAutoPlayWhenPrepared)
```
 - prepare
```
protected boolean prepare(IMediaItem mediaItem,
 boolean shouldAutoPlayWhenPrepared)
```
 - prepareMediaId
```
protected boolean prepareMediaId(java.lang.String mediaId,
 boolean shouldAutoPlayWhenPrepared)
```
 - prepare
```
public boolean prepare(android.net.Uri uri)
```
 Specified by:
 
 prepare in interface IPlayer
 - prepare
```
public boolean prepare(IMediaItem mediaItem)
```
 Specified by:
 
 prepare in interface IPlayer
 - prepareMediaId
```
public boolean prepareMediaId(java.lang.String mediaId)
```
 Specified by:
 
 prepareMediaId in interface IPlayer
 - play
```
public boolean play()
```
 Specified by:
 
 play in interface IPlayer
 - play
```
public boolean play(android.net.Uri uri)
```
 Specified by:
 
 play in interface IPlayer
 - play
```
public boolean play(IMediaItem mediaItem)
```
 Specified by:
 
 play in interface IPlayer
 - playMediaId
```
public boolean playMediaId(java.lang.String mediaId)
```
 Specified by:
 
 playMediaId in interface IPlayer
 - shutdown
```
public void shutdown()
```
 Description copied from interface: IPlayer
 
 Shut down player (release all resources)
 
 Specified by:
 
 shutdown in interface IPlayer
 - seekToPending
```
public void seekToPending(long ms)
```
 Description copied from interface: IPlayer
 
 set a pending seekTo in before start() dispose
 
 Specified by:
 
 seekToPending in interface IPlayer
 - haveSeekToPending
```
protected boolean haveSeekToPending()
```
 - seekToProgress
```
public long seekToProgress(int progress,
 int progressMax)
```
 Description copied from interface: IPlayer
 
 Seeks to specified progress
 
 Specified by:
 
 seekToProgress in interface IPlayer
 
 Parameters:
 
 progress - current progress
 
 progressMax - the upper limit of this progress range.
 
 Returns:
 
 seekTo position (>=0), or -1 if seekTo Failure.
 - start
```
public boolean start()
```
 Specified by:
 
 start in interface IPlayerBase
 - beforeStart
```
protected boolean beforeStart()
```
 - pause
```
public boolean pause()
```
 Specified by:
 
 pause in interface IPlayerBase
 - seekTo
```
public boolean seekTo(long ms,
 int processingLevel)
```
 Description copied from interface: IPlayer
 
 Support custom processing level of seekTo
 Specified by:
 
 seekTo in interface IPlayer
 processingLevel - The greater the level with processing the more things
 
 1: Callback IPlayer.Listener.onPlayProgress(long, long)
 
 2: Call IPlayer.calibrateCurrentPositionUnitIndex(long)
 - seekTo
```
public boolean seekTo(long ms)
```
 Description copied from interface: IPlayer
 
 internal call IPlayer.seekTo(long, int) Max processing level
 
 Specified by:
 
 seekTo in interface IPlayer
 
 Specified by:
 
 seekTo in interface IPlayerBase
 - fastForwardRewind
```
public boolean fastForwardRewind(long ms)
```
 Specified by:
 
 fastForwardRewind in interface IPlayer
 
 Parameters:
 ms - fastForwardMs/RewindMs
 
 +ms: fastForward
 .fastForwardRewind(1000)->fast forward 1 second
 -ms: RewindMs
 .fastForwardRewind(-1000)->rewind 1 second
 - stop
```
public void stop()
```
 Specified by:
 
 stop in interface IPlayerBase
 - reset
```
public void reset()
```
 Specified by:
 
 reset in interface IPlayerBase
 - release
```
public void release()
```
 Specified by:
 
 release in interface IPlayerBase
 - setVideo
```
public void setVideo(android.view.SurfaceView surfaceView)
```
 Specified by:
 
 setVideo in interface IPlayerBase
 - setVideo
```
public void setVideo(android.view.TextureView textureView)
```
 Specified by:
 
 setVideo in interface IPlayerBase
 - clearVideo
```
public void clearVideo()
```
 Specified by:
 
 clearVideo in interface IPlayerBase
 - setVolume
```
public void setVolume(float volume)
```
 Description copied from interface: IPlayerBase
 
 Sets the volume, with 0 being silence and 1 being unity gain.
 
 Specified by:
 
 setVolume in interface IPlayerBase
 - getVolume
```
public float getVolume()
```
 Description copied from interface: IPlayerBase
 
 Returns the volume, with 0 being silence and 1 being unity gain.
 
 Specified by:
 
 getVolume in interface IPlayerBase
 - getCurrentPosition
```
public long getCurrentPosition()
```
 Specified by:
 
 getCurrentPosition in interface IPlayerBase
 - getDuration
```
public long getDuration()
```
 Specified by:
 
 getDuration in interface IPlayerBase
 - isPlaying
```
public boolean isPlaying()
```
 Specified by:
 
 isPlaying in interface IPlayerBase
 - setPlaybackSpeed
```
public boolean setPlaybackSpeed(float speed)
```
 Specified by:
 
 setPlaybackSpeed in interface IPlayerBase
 
 Returns:
 
 Whether support
 - getPlaybackSpeed
```
public float getPlaybackSpeed()
```
 Specified by:
 
 getPlaybackSpeed in interface IPlayerBase
 - getPlaybackState
```
public int getPlaybackState()
```
 Specified by:
 
 getPlaybackState in interface IPlayerBase
 
 Returns:
 One of the STATE constants defined
 
 IPlayerBase.STATE_IDLE
 IPlayerBase.STATE_GOT_SOURCE
 IPlayerBase.STATE_BUFFERING
 IPlayerBase.STATE_READY
 IPlayerBase.STATE_ENDED
 - isPlayable
```
public boolean isPlayable()
```
 Description copied from interface: IPlayerBase
 Playback state
 Specified by:
 
 isPlayable in interface IPlayerBase
 
 Returns:
 
 Whether current state can playback[go player.start()]
 - addListener
```
public void addListener(IPlayer.Listener listener)
```
 Specified by:
 
 addListener in interface IPlayer
 
 Parameters:
 listener - IPlayer.Listener
 
 new PlayerListener( )
 custom implements IPlayer.Listener
 - removeListener
```
public void removeListener(IPlayer.Listener listener)
```
 Specified by:
 
 removeListener in interface IPlayer
 
 Parameters:
 
 listener - param==null -> clear()
 - onPrepared
```
public void onPrepared()
```
 Specified by:
 
 onPrepared in interface IPlayerBase.Listener
 - onBufferingUpdate
```
public void onBufferingUpdate(int percent)
```
 Specified by:
 
 onBufferingUpdate in interface IPlayerBase.Listener
 - shouldAutoPlayWhenSeekComplete
```
public P shouldAutoPlayWhenSeekComplete(boolean shouldAutoPlayWhenSeekComplete)
```
 Description copied from interface: IPlayer
 Generally used in front of the seekTo...(.) to ensure that seek complete to auto play immediately after
```
 *IPlayerBase.start() method with shouldAutoPlayWhenSeekComplete(true)
 *IPlayerBase.pause() with shouldAutoPlayWhenSeekComplete(false)
 
```
 Specified by:
 
 shouldAutoPlayWhenSeekComplete in interface IPlayer
 - onSeekComplete
```
public void onSeekComplete()
```
 Specified by:
 
 onSeekComplete in interface IPlayerBase.Listener
 - onCompletion
```
public int onCompletion()
```
 Specified by:
 
 onCompletion in interface IPlayerBase.Listener
 
 Returns:
 
 CMD (need handle return command) C.CMD_RETURN_FORCED/C.CMD_RETURN_NORMAL
 - onInfo
```
public boolean onInfo(int what,
 int extra)
```
 Specified by:
 
 onInfo in interface IPlayerBase.Listener
 - onError
```
public boolean onError(int what,
 int extra,
 java.lang.Exception e)
```
 Specified by:
 
 onError in interface IPlayerBase.Listener
 - onVideoSizeChanged
```
public void onVideoSizeChanged(int width,
 int height,
 int unappliedRotationDegrees,
 float pixelWidthHeightRatio)
```
 Specified by:
 
 onVideoSizeChanged in interface IPlayerBase.Listener
 - onStateChanged
```
public void onStateChanged(int playbackState)
```
 Description copied from interface: IPlayerBase.Listener
 
 Called when the value returned from IPlayerBase.getPlaybackState() changes.
 
 Specified by:
 
 onStateChanged in interface IPlayerBase.Listener
 - onIntent
```
protected boolean onIntent(android.content.Intent intent)
```
 - onPlayProgress
```
protected boolean onPlayProgress(long position,
 long duration)
```
 - onPositionUnitProgress
```
protected void onPositionUnitProgress(long position,
 int posUnitIndex,
 int posUnitState)
```
 - onABProgress
```
protected void onABProgress(long position,
 long duration,
 int abState)
```
 - onNotificationRequired
```
protected void onNotificationRequired(int order)
```
 - onAudioFocusChange
```
protected boolean onAudioFocusChange(int focusChange)
```
 - setUpdatePlayProgressDelayMs
```
public P setUpdatePlayProgressDelayMs(long updatePlayProgressDelayMs)
```
 Description copied from interface: IPlayer
 Sets the updatePlayProgress delay.
 More accurate to handle progress type work.
 Specified by:
 
 setUpdatePlayProgressDelayMs in interface IPlayer
 
 Parameters:
 
 updatePlayProgressDelayMs - value>=0?value:default[1000 - (position % 1000)]
 - updatePlayProgressInterruptConditions
```
protected boolean updatePlayProgressInterruptConditions()
```
 Returns:
 
 true: interrupt update Play Progress
 - updatePlayProgress
```
protected void updatePlayProgress(int updatePlayProgressCommand)
```
 Parameters:
 updatePlayProgressCommand -
 
 0: interrupt update
 1: go update
 n: go update(no Change base interrupt conditions)
 - setPositionUnitList
```
public P setPositionUnitList(IPositionUnitList posUnitList)
```
 Description copied from interface: IPlayer
 
 WARNING: must ensure IPositionUnitList.getMediaId() equals IPlayer.getCurrentMediaId() can work normally
 
 Specified by:
 
 setPositionUnitList in interface IPlayer
 
 Parameters:
 
 posUnitList - [Position Unit] List
 - posUnitListAvailable
```
protected boolean posUnitListAvailable()
```
 - getCurrentPositionUnitIndex
```
public int getCurrentPositionUnitIndex()
```
 Specified by:
 
 getCurrentPositionUnitIndex in interface IPlayer
 
 Returns:
 
 current position unit index OR -1(unset | waiting state)
 - setCurrentPositionUnitIndex
```
public void setCurrentPositionUnitIndex(int posUnitIndex)
```
 Description copied from interface: IPlayer
 
 generally not use(player inside Will automatically maintain current [position unit] index)
 If you want to calibrate,can call IPlayer.calibrateCurrentPositionUnitIndex(long)
 
 Specified by:
 
 setCurrentPositionUnitIndex in interface IPlayer
 - positionUnitProgress
```
protected boolean positionUnitProgress(long position)
```
 Parameters:
 
 position - current play position
 
 Returns:
 
 whether someone was handled
 - seekToPositionUnitIndex
```
public long seekToPositionUnitIndex(int posUnitIndex)
```
 Description copied from interface: IPlayer
 
 Seeks to specified PositionUnitIndex
 
 Specified by:
 
 seekToPositionUnitIndex in interface IPlayer
 
 Returns:
 
 seekTo position (>=0), or -1 if seekTo Failure.
 - calibrateCurrentPositionUnitIndex
```
public int calibrateCurrentPositionUnitIndex(long position)
```
 Description copied from interface: IPlayer
 
 generally not use(player inside Will automatically maintain current [position unit] index calibrate)
 
 Specified by:
 
 calibrateCurrentPositionUnitIndex in interface IPlayer
 
 Parameters:
 
 position - currentPosition or -1[position < 0 || position > getDuration()] (auto getCurrentPosition())
 
 Returns:
 
 calibrated PositionUnitIndex or -1(not calibrate or calibrate result not present)
 - setPositionUnitLoop
```
protected void setPositionUnitLoop(int loopMode,
 int loopInterval)
```
 - setPositionUnitLoopIndexList
```
public P setPositionUnitLoopIndexList(java.util.ArrayList<java.lang.Integer> posUnitLoopIndexList)
```
 Description copied from interface: IPlayer
 
 WARNING: media source change with specify to loop of [position unit] index list will be reset
 
 Specified by:
 
 setPositionUnitLoopIndexList in interface IPlayer
 
 Parameters:
 
 posUnitLoopIndexList - specify to loop of [position unit] index list
 - setEnabledPositionUnitLoop
```
public P setEnabledPositionUnitLoop(boolean enabled,
 int loopMode,
 int loopInterval)
```
 Description copied from interface: IPlayer
 
 Set the enabled,loopMode,loopInterval of this position unit loop, with reset position unit looped count tag
 *param loopMode,loopInterval can use C.PARAM_ORIGINAL keeping the original values
 *param loopMode,loopInterval can use C.PARAM_UNSET/C.PARAM_RESET unset/reset values
 Specified by:
 
 setEnabledPositionUnitLoop in interface IPlayer
 
 Parameters:
 
 enabled - True [position unit] loop is enabled, false otherwise.
 loopMode - [Position unit] loop mode
 
 -1 disable
 -8 infinity loop
 0++ specified loop
 loopInterval - [Position unit] loop interval
 
 See Also:
 
 IPlayer.setUpdatePlayProgressDelayMs(long)
 - positionUnitLoopProcessing
```
protected int positionUnitLoopProcessing(int processFrom)
```
 Parameters:
 processFrom -
 
 1: from onPositionUnitProgress(..end)
 2: from onCompletion()
 Returns:
 0: disable
 1: enable(processing[infinity/specified loop | loop index list])
 2: enable(finish[specified loop | not loop])
 - setAB
```
public P setAB(long startPos,
 long endPos)
```
 Description copied from interface: IPlayer
 
 Set A-B start position and end position with reset ab all tag
 
 Specified by:
 
 setAB in interface IPlayer
 
 Parameters:
 
 startPos - [A-B] start position (Ms)
 
 endPos - [A-B] end position (Ms)
 
 Returns:
 
 IPlayer !setAB but does not play. You must call play(?) to play.
 
 See Also:
 
 IPlayer.play(), IPlayer.play(Uri)
 - setABLoop
```
public P setABLoop(int loopMode,
 int loopInterval)
```
 Description copied from interface: IPlayer
 
 Set A-B loop
 *param loopMode,loopInterval can use C.PARAM_ORIGINAL keeping the original values
 *param loopMode,loopInterval can use C.PARAM_UNSET/C.PARAM_RESET unset/reset values
 Specified by:
 
 setABLoop in interface IPlayer
 
 Parameters:
 loopMode - [A-B] loop mode
 
 -1 disable
 -8 infinity loop
 0++ specified loop
 loopInterval - [A-B] loop interval (S)
 
 Returns:
 
 IPlayer !setAB but does not play. You must call play(?) to play.
 
 See Also:
 
 IPlayer.play(), IPlayer.play(Uri)
 - setAB
```
public P setAB(long startPos,
 long endPos,
 int loopMode,
 int loopInterval)
```
 Description copied from interface: IPlayer
 
 Set A-B internal call IPlayer.setAB(long, long), IPlayer.setABLoop(int, int)
 *param loopMode,loopInterval can use C.PARAM_ORIGINAL keeping the original values
 *param loopMode,loopInterval can use C.PARAM_UNSET/C.PARAM_RESET unset/reset values
 Specified by:
 
 setAB in interface IPlayer
 
 Parameters:
 
 startPos - [A-B] start position (Ms)
 
 endPos - [A-B] end position (Ms)
 loopMode - [A-B] loop mode
 
 -1 disable
 -8 infinity loop
 0++ specified loop
 loopInterval - [A-B] loop interval (S)
 
 Returns:
 
 IPlayer !setAB but does not play. You must call play(?) to play.
 
 See Also:
 
 IPlayer.play(), IPlayer.play(Uri)
 - setClearAB
```
public P setClearAB(boolean autoClear)
```
 Description copied from interface: IPlayer
 
 Set auto clear A-B all tag(when A-B finish)
 WARNING: If for special reasons cause A-B is not finish, will don't auto clear.
 
 Specified by:
 
 setClearAB in interface IPlayer
 
 See Also:
 
 IPlayer.clearAB()
 - clearAB
```
public void clearAB()
```
 Description copied from interface: IPlayer
 
 Clear A-B all tag
 Tips: setClearAB(false) also don't manual invoke clearAB(), will save all tag. invoke again play(?) continue play A-B for specified ab tag.
 
 Specified by:
 
 clearAB in interface IPlayer
 
 See Also:
 
 IPlayer.setClearAB(boolean)
 - abProgress
```
protected boolean abProgress(long position)
```
 Parameters:
 
 position - current play position
 
 Returns:
 
 whether someone was handled
 - abLoopProcessing
```
protected int abLoopProcessing(int processFrom)
```
 Parameters:
 processFrom -
 
 1: from onABProgress(..end)
 2: from onCompletion()
 Returns:
 0: disable
 1: enable(processing[infinity/specified loop])
 2: enable(finish[specified loop | not loop])
 - setMediaQueue
```
public void setMediaQueue(IMediaQueue mediaQueue)
```
 Description copied from interface: IPlayer
 
 set a new media queue for player
 
 Specified by:
 
 setMediaQueue in interface IPlayer
 
 Parameters:
 
 mediaQueue - IMediaQueue
 - getMediaQueue
```
public IMediaQueue getMediaQueue()
```
 Description copied from interface: IPlayer
 
 get a media queue, if not IPlayer.setMediaQueue(IMediaQueue), it return default media queue
 
 Specified by:
 
 getMediaQueue in interface IPlayer
 
 Returns:
 
 IMediaQueue
 - getCurrentMediaId
```
public java.lang.String getCurrentMediaId()
```
 Description copied from interface: IPlayer
 
 Returns current media id (custom or default[string representation of this play uri])
 
 Specified by:
 
 getCurrentMediaId in interface IPlayer
 - setEnabledWifiLock
```
public P setEnabledWifiLock(boolean enabled)
```
 Description copied from interface: IPlayer
 Set enabled wifi lock, to hold a Wifi lock, which prevents the player from going to sleep while the media is playing.
 RequiresPermission(Manifest.permission.WAKE_LOCK)
 AndroidManifest.xml add below
```
 
 <uses-permission android:name="android.permission.WAKE_LOCK"/>
 
```
 Specified by:
 
 setEnabledWifiLock in interface IPlayer
 - setEnabledAudioFocusManage
```
public P setEnabledAudioFocusManage(boolean enabled)
```
 Specified by:
 
 setEnabledAudioFocusManage in interface IPlayer
 - getAudioMgrHelper
```
public AudioMgrHelper getAudioMgrHelper()
```
 Specified by:
 
 getAudioMgrHelper in interface IPlayer
 - tryToGetAudioFocus
```
private void tryToGetAudioFocus()
```
 - giveUpAudioFocus
```
private void giveUpAudioFocus()
```
 - configureAudioFocus
```
protected boolean configureAudioFocus()
```
 Returns:
 
 forced to pause
 - getComponentListener
```
protected APlayer.ComponentListener getComponentListener()
```
 - registerComponentReceiver
```
protected void registerComponentReceiver()
```
 - unregisterComponentReceiver
```
protected void unregisterComponentReceiver()
```
 - getComponentIntentFilter
```
protected android.content.IntentFilter getComponentIntentFilter()
```
 - getComponentReceiver
```
protected APlayer.ComponentReceiver getComponentReceiver()
```
 - supportBaseOnContextOfFunctionModule
```
public void supportBaseOnContextOfFunctionModule(@NonNull
 android.content.Context context)
```
 Support, base on context of function Module.
 Parameters:
 
 context - Use for internal register/unregisterReceiver, getSystemService, ...

Class APlayer<P extends APlayer>

Nested Class Summary

Nested classes/interfaces inherited from interface com.jcodeing.kmedia.IPlayer

Field Summary

Fields inherited from interface com.jcodeing.kmedia.IPlayerBase

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

internalPlayer

pendingSeekToMs

listeners

shouldAutoPlayWhenPrepared

shouldAutoPlayWhenSeekComplete

updatePlayProgressAction

updatePlayProgressDelayMs

updatePlayProgressBaseInterruptConditions

currentPosUnitIndex

posUnitList

isInPosUnit

posUnitLoopEnabled

posUnitLoopMode

posUnitLoopInterval

posUnitLoopedCount

posUnitLoopIndexList

handler

methodAgent

abEnabled

abStartPosition

abEndPosition

abLoopMode

abInterval

abLoopedCount

abAutoClear

isInAB

mediaQueue

currentMediaId

wifiLock

audioMgrHelper

currentAudioFocusState

enabledAudioFocusManage

componentListener

componentReceiverRegistered

componentIntentFilter

componentReceiver

TAG

context

Constructor Detail

APlayer

APlayer

Method Detail

returnThis

internalPlayer

initConfig

init

isPrepared

prepare

prepare

prepareMediaId

prepare

prepare

prepareMediaId

play

play

play

playMediaId

shutdown

seekToPending

haveSeekToPending

seekToProgress

start

beforeStart

pause

seekTo

seekTo

fastForwardRewind

stop

reset

release

setVideo