VideoPlayerView

```
public interface VideoPlayerView
```
Interface implemented by any of the Android SDK video controls. Allow to access to the video control in a generic way, independently of the decoding method used.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DROP_WRONG_TIMESTAMP_PACKETS_ALWAYS` Packets with wrong timestamps will be always dropped
`static int`	`DROP_WRONG_TIMESTAMP_PACKETS_NEVER` Packets with wrong timestamps will be never dropped
`static int`	`DROP_WRONG_TIMESTAMP_PACKETS_ONLY_VOD` Packets with wrong timestamps will be dropped only for VOD streams
`static int`	`ERROR_FORMAT_UNKNOWN` The provided stream doesn't have a known format
`static int`	`ERROR_NETWORK_RESOURCE_DONT_EXIST` Resource (stream URL) doesn't exist
`static int`	`ERROR_NETWORK_SECURITY_ISSUE` Access not allowed to the provided stream URL
`static int`	`ERROR_NETWORK_UNAVAILABLE` Network access is not available
`static int`	`ERROR_RESOURCES_ISSUE` There was an issue while allocating resources for playback
`static int`	`ERROR_SUCCESS` No error
`static int`	`ERROR_TS_SEGMENT_INVALID` The provided stream contains format errors
`static int`	`FULLSCREEN_MODE_KEEP_ASPECT_RATIO` Fullscreen enabled, keeping original aspect ratio
`static int`	`FULLSCREEN_MODE_NONE` Fullscreen disabled
`static int`	`FULLSCREEN_MODE_TOTAL` Fullscreen enabled, filling the full control
`static int`	`HLS_STARTING_ALGORITHM_AKAMAI` Starting algorithm designed by Akamai, optimized to cover the max number of devices with the starting bitrate.
`static int`	`HLS_STARTING_ALGORITHM_APPLE` Starting algorithm implemented in iDevices.
`static int`	`MEDIA_REBUFFERING_MODE_AUTOMATIC` Rebuffering mode automatic
`static int`	`MEDIA_REBUFFERING_MODE_MANUAL` Rebuffering mode manual
`static int`	`MEDIA_VIDEO_QUALITY_AUTO` Video Quality Auto
`static int`	`MEDIA_VIDEO_QUALITY_HIGH` Video Quality High
`static int`	`MEDIA_VIDEO_QUALITY_LOW` Video Quality Low
`static int`	`MEDIA_VIDEO_QUALITY_MEDIUM` Video Quality Medium
`static int`	`NETSESSION_MODE_ALLOWED` NetSession will be used by default but, in case of an error, the player will automatically disable it.
`static int`	`NETSESSION_MODE_DISABLED` NetSession disabled.
`static int`	`NETSESSION_MODE_REQUIRED` NetSession required.
`static java.lang.String`	`VERSION` Deprecated.

Method Summary

Methods
Modifier and Type	Method and Description
`java.lang.String`	`about()` Get the about text.
`void`	`addEventsListener(IPlayerEventsListener listener)` Register a callback to be invoked when any player event happens
`void`	`clearRenderBuffer()` Clears the screen render buffer.
`long`	`getAvgFPS()` For the current playback, get the average FPS (Frames per Second) This method doesn't make sense in the hardware version of the SDK as the hardware decoder doesn't provide this information
`int`	`getBitrateByIndex(int index)` Return the bitrate (bps) for the variant indicated in the index parameter
`int`	`getBitratesCount()` Get the number of available bitrate indexes for the loaded stream
`int`	`getBitratesSwitchesDown()` For multibirate streams, get the number of times the control has switched down
`int`	`getBitratesSwitchesUp()` For multibirate streams, get the number of times the control has switched up
`int`	`getBufferingPercentage()` Get the rebuffering percentage
`long`	`getBytesLoaded()` For the current playback, get the number of bytes loaded
`long`	`getCurrentBitrate()` Get the current bitrate of the video in bps
`java.lang.String`	`getCurrentSegmentUrl()`
`int`	`getDuration()` Get the duration of the video in seconds.
`long`	`getDVRLength()` Get the lenght, in seconds, of the DVR
`double`	`getEncodedFPS()` Get the encoded frames per second for the loaded stream This method is not supported on Hardware and Hardware Advanced decoding modes
`AMPFeed`	`getFeed()` Returns the feed of the loaded stream (in case playback was launched providing a json feed)
`long`	`getFPS()` Get the current FPS (Frames per Second)
`int`	`getFullScreenMode()` Return the fullscreen mode
`int`	`getHeight()` Return the height of this view
`int`	`getIndexByBitrate(int bitrate)` Return the index for the bitrate indicated in the bitrate parameter (bps)
`int`	`getLastErrorCode()` Returns the last error code that happens during the playback
`int`	`getLastHttpErrorCode()` Get error code of the last HTTP request
`int`	`getLastMeasuredBandwidth()` Returns the last measured bandwidth in bytes/sec
`long`	`getLastPTS()` Get the PTS of the last packet read by the decoder
`java.util.Date`	`getLicenseExpirationDate()` Returns the expiration date of the set license
`java.lang.String`	`getLicensePackageName()` Returns the package name for which the set license is valid
`int[]`	`getLocationOnScreen()` Computes the coordinates of this view on the screen
`int`	`getPositionInDVR()` Return the current playback position in the DVR in seconds
`View`	`getProgressBarControl()` Gets the progress bar control that is shown whenever the player is doing a buffering/loading operation
`java.lang.String`	`getProtocol()` Get the protocol of the current loaded stream
`double`	`getRebufferingTime()` Get the total time the player has been rebuffering in seconds
`int`	`getRebuffers()` Get the number of rebuffers occurred
`java.lang.String`	`getServerIp()` Get the Server IP of the current loaded stream
`int`	`getServerPort()` Get the Server port for the current loaded stream
`java.lang.String`	`getStreamsInfo()` Return information about the streams
`java.lang.String`	`getStreamUrl()` Returns the url of the loaded stream
`int`	`getTimePosition()` Return the current playback position in seconds
`java.util.Date`	`getTimePositionAsDate()` Return the current playback position as a local time date
`long`	`getTimePositionMS()` Return the current playback position in milliseconds
`java.lang.String`	`getVersionDescription()` Get extended information about the SDK version
`int`	`getVideoHeight()` Get the height of the video
`int`	`getVideoWidth()` Get the width of the video
`int`	`getWidth()` Return the width of this view
`boolean`	`isAudioOnly()` Return true if the current bitrate is an audio only stream
`java.lang.Boolean`	`isBitrateSupported(int iBitrateIndex)` Method used for knowing if a specific bitrate of the stream that is being played is compatible with the device.
`boolean`	`isError()` Check whether there was an error
`boolean`	`isFinished()` Check whether the current playback has finished
`boolean`	`isFullScreen()` Return true if the player is in fullscreenmode
`boolean`	`isLicenseExpired()` Get information about the status of the SDK license
`boolean`	`isLive()` Return true when playing a live stream
`boolean`	`isMuted()` Returns whether or not the current audio thread is muted
`boolean`	`isPaused()` Check whether control is in pause
`boolean`	`isPlaybackProcessInterrupted()` Return true if playback was interrupted by any of the Android SDK plugins
`boolean`	`isPlaying()` Check whether control is playing
`boolean`	`isResumingAfterActivityResume()` Return true if playback is being automatically restarted after an activity resume.
`boolean`	`isSeeking()` Check whether VideoPlayerView control is doing a seeking operation
`void`	`onDestroy()`
`void`	`onPause()`
`void`	`onResume()`
`void`	`onSegmentProgress(java.lang.String segmentUrl, int segmentOffset)`
`void`	`pause()` Pause playback
`void`	`playAudioUrl(java.lang.String sInUrl)` Play an audio only stream given the stream URL
`void`	`playAudioUrl(java.lang.String sInUrl, int position)` Play an audio only stream given the stream URL, starting at the specified position in seconds
`void`	`playFeedFromJson(java.lang.String sJsonData)` Play a stream given a JSON feed string.
`void`	`playFeedFromUrl(java.lang.String sInUrl)` Play a stream given a feed url.
`void`	`playMutedUrl(java.lang.String sInUrl)` Starts playing the stream in mute
`void`	`playUrl(java.lang.String sInUrl)` Play a stream given the stream URL
`void`	`playUrl(java.lang.String sInUrl, int position)` Play a stream given the stream URL, starting at the specified position in seconds
`void`	`removeEventsListener(IPlayerEventsListener listener)` Deregister a callback that was invoked when any player event happens
`void`	`resume()` Resume playback
`void`	`seek(int iInNewPos, int iInRelPos)` Seek to the specified time position
`void`	`seekToLive()` Seek to the live position.
`void`	`setAdjustTimestamps(boolean adjust)` Enable/disable the adjustment of timestamps in case of misalignment detected
`void`	`setAkamaiAlgorithmValue(int bitrate)` Combined with setHLSStartingAlgorithm(VideoPlayerView.HLS_STARTING_ALGORITHM_AKAMAI) this methods allow setting a custom value for the maximum starting bitrate (default is 300000bps)
`void`	`setAutoResume(boolean enable)` Enable/disable auto resume feature.
`void`	`setAvoidAudioOnlyStreams(boolean bInValue)` When multibitrate, deactivate/activate the use of audio only streams This method doesn't make sense in the hardware version of the SDK as the interpretation of the protocol is done by the hardware decoder.
`void`	`setAvoidIncompatibleVideoProfiles(boolean bInValue)` Enable/disable protection mechanism that avoids the selection of incompatible bitrates.
`void`	`setAvoidIncompatibleVideoResolutions(boolean bInValue)` Enable/disable protection mechanism that avoids the selection of incompatible bitrates.
`void`	`setBackgroundColor(int color)` Sets the background color for the player itself
`void`	`setBitrateToPlay(int bitrateIndex)` Software: In manual switching mode, set the maximum bitrate to be used during the playback.
`void`	`setDebugingActive(java.lang.Boolean value)` Activate/deactivate the debug mode
`void`	`setDebugUrl(java.lang.String value)` When debugging mode is active, each time the player finish playing a stream it sends a report to the url defined using this method.
`void`	`setDefaultAudioConfig(int sample_rate, int channels)` Set default audio configuration parameters.
`void`	`setDisableDynamicAudioFeature(boolean disable)` Disable dynamic audio feature in stream (bitrates with different audio settings: channels, sample rate).
`void`	`setDropFrames(boolean value)` Configure the player to drop frames when needed for improving audio/video sync.
`void`	`setDropWrongTimestampPacketsMode(int mode)` Set how to manage packets that don't include timestamp For not well encoded streams is possible that timestamp values are not correctly set.
`void`	`setEventsListener(IPlayerEventsListener listener)` Deprecated.
`void`	`setForceFormatChange(boolean value)` When set to true, the format change flag is set to true for the initial segment after a seeking operation.
`void`	`setForceOMXdecoding(boolean value)` When set to true, the decoding engine will use the direct OMX approach instead of the newest MediaCodec approach.
`void`	`setFullScreen(boolean fullscreen)` Set fullscreen mode.
`void`	`setFullScreenMode(int mode)` Set fullscreen mode.
`void`	`setHardwareSeekingProtection(boolean value)` When set to true, multiple seeks in a row are blocked by the SDK to protect from a hardware interface crash failure occurring for specific streams Default value: false Note: only for Hardware Advanced decoding mode
`void`	`setHLSStartingAlgorithm(int mode)` Sets the algorithm used for selecting the initial bitrate of the playback
`void`	`setInitialSeekingPosition(int iInNewPos)` Set the video starting position
`void`	`setLicense(java.lang.String license)` Set the Android SDK license.
`void`	`setLogEnabled(boolean value)` Enable/Disable log traces
`void`	`setManualSwitching(boolean bInValue)` Sets the manual switching mode
`void`	`setMaxBitrate(int iMaxBitrate)` Set the maximum bitrate to be played, in bps
`void`	`setMediaAnalyticsConfigUrl(java.lang.String configUrl)` Sets the Media Analytics config url To use Media Analytics the application must enabled the following permissions - android.permission.INTERNET - android.permission.ACCESS_NETWORK_STATE - android.permission.READ_PHONE_STATE - android.permission.ACCESS_WIFI_STATE
`void`	`setMediaAnalyticsData(java.lang.String key, java.lang.String value)` Report Media Analytics custom dimension in the player
`void`	`setMediaAnalyticsViewerDiagnosticsId(java.lang.String viewerId)` Set Media Analytics Diagnostics Viewer Id.
`void`	`setMediaAnalyticsViewerId(java.lang.String viewerId)` Set Media Analytics Viewer Id
`void`	`setNetSessionMode(int mode)` Enable/Disable client side delivery
`void`	`setProgressBarControl(View progressBar)` Sets the progress bar control that should be shown whenever the player is doing a buffering/loading operation
`void`	`setRebufferingMode(int iInMode)` Set the rebuffering mode.
`void`	`setRebufferingSize(int iInRebufferSize)` Set the rebuffering buffer size
`void`	`setSegmentInfoListener(ISegmentInfoListener segInfoListener)`
`void`	`setStartingBitrateIndex(int iIndex)` Set index of the bitrate to be used when playback start
`void`	`setUseBufferingWhenStarting(boolean value)` Enable/Disable the use of an initial buffer used for starting playback If enabled, playback won't start until the initial buffer is full.
`void`	`setUseMultiThread(boolean value)` Enable/disable the use of multi threading decoding
`void`	`setVideoQuality(int iInQuality)` Set the video quality.
`void`	`stop()` Stop playback
`void`	`switchBitrateDown()` Ask the player to switch to the lower bitrate
`void`	`switchBitrateUp()` Ask the player to switch to the upper bitrate

- Field Detail
  - VERSION
```
@Deprecated
static final java.lang.String VERSION
```
    Deprecated.
    
    Version of the Akamai Android SDK video component. This attribute is now deprecated. To obtain the SDK Version, access com.akamai.media.AMPLibrayInfo.VERSION
  - FULLSCREEN_MODE_NONE
```
static final int FULLSCREEN_MODE_NONE
```
    Fullscreen disabled
    
    See Also:
    Constant Field Values
  - FULLSCREEN_MODE_KEEP_ASPECT_RATIO
```
static final int FULLSCREEN_MODE_KEEP_ASPECT_RATIO
```
    Fullscreen enabled, keeping original aspect ratio
    
    See Also:
    Constant Field Values
  - FULLSCREEN_MODE_TOTAL
```
static final int FULLSCREEN_MODE_TOTAL
```
    Fullscreen enabled, filling the full control
    
    See Also:
    Constant Field Values
  - MEDIA_VIDEO_QUALITY_LOW
```
static final int MEDIA_VIDEO_QUALITY_LOW
```
    Video Quality Low
    
    See Also:
    Constant Field Values
  - MEDIA_VIDEO_QUALITY_MEDIUM
```
static final int MEDIA_VIDEO_QUALITY_MEDIUM
```
    Video Quality Medium
    
    See Also:
    Constant Field Values
  - MEDIA_VIDEO_QUALITY_HIGH
```
static final int MEDIA_VIDEO_QUALITY_HIGH
```
    Video Quality High
    
    See Also:
    Constant Field Values
  - MEDIA_VIDEO_QUALITY_AUTO
```
static final int MEDIA_VIDEO_QUALITY_AUTO
```
    Video Quality Auto
    
    See Also:
    Constant Field Values
  - MEDIA_REBUFFERING_MODE_MANUAL
```
static final int MEDIA_REBUFFERING_MODE_MANUAL
```
    Rebuffering mode manual
    
    See Also:
    Constant Field Values
  - MEDIA_REBUFFERING_MODE_AUTOMATIC
```
static final int MEDIA_REBUFFERING_MODE_AUTOMATIC
```
    Rebuffering mode automatic
    
    See Also:
    Constant Field Values
  - HLS_STARTING_ALGORITHM_AKAMAI
```
static final int HLS_STARTING_ALGORITHM_AKAMAI
```
    Starting algorithm designed by Akamai, optimized to cover the max number of devices with the starting bitrate. Chooses the first below 300Kbps that is not an audio only stream. Note that this value is configurable using setAkamaiAlgorithmValue(int bitrate)
    
    See Also:
    Constant Field Values
  - HLS_STARTING_ALGORITHM_APPLE
```
static final int HLS_STARTING_ALGORITHM_APPLE
```
    Starting algorithm implemented in iDevices. Choose as the starting bitrate the first bitrate in the playlist.
    
    See Also:
    Constant Field Values
  - NETSESSION_MODE_DISABLED
```
static final int NETSESSION_MODE_DISABLED
```
    NetSession disabled.
    
    See Also:
    Constant Field Values
  - NETSESSION_MODE_ALLOWED
```
static final int NETSESSION_MODE_ALLOWED
```
    NetSession will be used by default but, in case of an error, the player will automatically disable it.
    
    See Also:
    Constant Field Values
  - NETSESSION_MODE_REQUIRED
```
static final int NETSESSION_MODE_REQUIRED
```
    NetSession required. If the destination URL doesn't support NetSession, the player won't work.
    
    See Also:
    Constant Field Values
  - DROP_WRONG_TIMESTAMP_PACKETS_NEVER
```
static final int DROP_WRONG_TIMESTAMP_PACKETS_NEVER
```
    Packets with wrong timestamps will be never dropped
    
    See Also:
    Constant Field Values
  - DROP_WRONG_TIMESTAMP_PACKETS_ONLY_VOD
```
static final int DROP_WRONG_TIMESTAMP_PACKETS_ONLY_VOD
```
    Packets with wrong timestamps will be dropped only for VOD streams
    
    See Also:
    Constant Field Values
  - DROP_WRONG_TIMESTAMP_PACKETS_ALWAYS
```
static final int DROP_WRONG_TIMESTAMP_PACKETS_ALWAYS
```
    Packets with wrong timestamps will be always dropped
    
    See Also:
    Constant Field Values
  - ERROR_SUCCESS
```
static final int ERROR_SUCCESS
```
    No error
    
    See Also:
    Constant Field Values
  - ERROR_NETWORK_UNAVAILABLE
```
static final int ERROR_NETWORK_UNAVAILABLE
```
    Network access is not available
    
    See Also:
    Constant Field Values
  - ERROR_NETWORK_RESOURCE_DONT_EXIST
```
static final int ERROR_NETWORK_RESOURCE_DONT_EXIST
```
    Resource (stream URL) doesn't exist
    
    See Also:
    Constant Field Values
  - ERROR_NETWORK_SECURITY_ISSUE
```
static final int ERROR_NETWORK_SECURITY_ISSUE
```
    Access not allowed to the provided stream URL
    
    See Also:
    Constant Field Values
  - ERROR_FORMAT_UNKNOWN
```
static final int ERROR_FORMAT_UNKNOWN
```
    The provided stream doesn't have a known format
    
    See Also:
    Constant Field Values
  - ERROR_RESOURCES_ISSUE
```
static final int ERROR_RESOURCES_ISSUE
```
    There was an issue while allocating resources for playback
    
    See Also:
    Constant Field Values
  - ERROR_TS_SEGMENT_INVALID
```
static final int ERROR_TS_SEGMENT_INVALID
```
    The provided stream contains format errors
    
    See Also:
    Constant Field Values
- Method Detail
  - playUrl
```
void playUrl(java.lang.String sInUrl)
```
    Play a stream given the stream URL
    
    Parameters:
    sInUrl - URL of the stream to play
  - playUrl
```
void playUrl(java.lang.String sInUrl,
           int position)
```
    Play a stream given the stream URL, starting at the specified position in seconds
    
    Parameters:
    sInUrl - URL of the stream to play
    position - Start position in seconds
  - playAudioUrl
```
void playAudioUrl(java.lang.String sInUrl)
```
    Play an audio only stream given the stream URL
    
    Parameters:
    sInUrl - Url of the stream to play
  - playAudioUrl
```
void playAudioUrl(java.lang.String sInUrl,
                int position)
```
    Play an audio only stream given the stream URL, starting at the specified position in seconds
    
    Parameters:
    sInUrl - Url of the stream to play
    position - Start position in seconds
  - playFeedFromUrl
```
void playFeedFromUrl(java.lang.String sInUrl)
```
    Play a stream given a feed url. Feed format supported is JSON type data with the format defined by Akamai Media Player. Example: http://projects.mediadev.edgesuite.net/customers/akamai/mdt-html5-core/premier/1.0.0008/resources/feeds/vod-feed.json
    
    Parameters:
    sInUrl - URL of the feed to play
  - playFeedFromJson
```
void playFeedFromJson(java.lang.String sJsonData)
```
    Play a stream given a JSON feed string. Feed format supported is JSON type data with the format defined by Akamai Media Player. Example: http://projects.mediadev.edgesuite.net/customers/akamai/mdt-html5-core/premier/1.0.0008/resources/feeds/vod-feed.json
    
    Parameters:
    sJsonData - JSON string
  - stop
```
void stop()
```
    Stop playback
  - pause
```
void pause()
```
    Pause playback
  - resume
```
void resume()
```
    Resume playback
  - seek
```
void seek(int iInNewPos,
        @Deprecated
        int iInRelPos)
```
    Seek to the specified time position
    
    Parameters:
    iInNewPos - The offset in seconds from the start to seek to.
    [DEPRECATED] - iInRelPos The offset in seconds from the current position to seek to. Use 0 to do an absolute seek
  - seekToLive
```
void seekToLive()
```
    Seek to the live position. Only valid for live streams
  - switchBitrateUp
```
void switchBitrateUp()
                     throws java.lang.Exception
```
    Ask the player to switch to the upper bitrate
    
    Throws:
    
    java.lang.Exception
  - switchBitrateDown
```
void switchBitrateDown()
                       throws java.lang.Exception
```
    Ask the player to switch to the lower bitrate
    
    Throws:
    
    java.lang.Exception
  - setMaxBitrate
```
void setMaxBitrate(int iMaxBitrate)
```
    Set the maximum bitrate to be played, in bps
    
    Parameters:
    iMaxBitrate - Max bitrate to play
  - setBitrateToPlay
```
void setBitrateToPlay(int bitrateIndex)
                      throws java.lang.Exception
```
    Software: In manual switching mode, set the maximum bitrate to be used during the playback. The bitrate to be played will be the one inmediately below or equal than the indicated in the parameter bitrate Hardware & Hardware Advanced: Set a specific bitrate index to be played
    
    Parameters:
    bitrateIndex -
    
    Throws:
    
    java.lang.Exception
  - setStartingBitrateIndex
```
void setStartingBitrateIndex(int iIndex)
```
    Set index of the bitrate to be used when playback start
    
    Parameters:
    index - of the bitrate to be used when playback start
  - getBitratesCount
```
int getBitratesCount()
```
    Get the number of available bitrate indexes for the loaded stream
    
    Returns:
    Number of bitrates
  - getBitrateByIndex
```
int getBitrateByIndex(int index)
```
    Return the bitrate (bps) for the variant indicated in the index parameter
    
    Parameters:
    index - of the bitrate
    
    Returns:
    bitrate of the variant
  - getIndexByBitrate
```
int getIndexByBitrate(int bitrate)
```
    Return the index for the bitrate indicated in the bitrate parameter (bps)
    
    Parameters:
    bitrate -
    
    Returns:
    0 starting index of the bitrate in the list of bitrates.
  - isBitrateSupported
```
java.lang.Boolean isBitrateSupported(int iBitrateIndex)
```
    Method used for knowing if a specific bitrate of the stream that is being played is compatible with the device.
    
    Parameters:
    iBitrateIndex - Zero based index of the bitrate to check.
    
    Returns:
    True if the bitrate is supported, otherwise returns false.
  - isPlaying
```
boolean isPlaying()
```
    Check whether control is playing
    
    Returns:
    true if currently playing, false otherwise
  - isPaused
```
boolean isPaused()
```
    Check whether control is in pause
    
    Returns:
    true if currently in pause, false otherwise
  - isError
```
boolean isError()
```
    Check whether there was an error
    
    Returns:
    true if the control is in error state, false otherwise
  - isFinished
```
boolean isFinished()
```
    Check whether the current playback has finished
    
    Returns:
    true if the playback has finished, false otherwise
  - isSeeking
```
boolean isSeeking()
```
    Check whether VideoPlayerView control is doing a seeking operation
    
    Returns:
    true if currently seeking, false otherwise
  - isAudioOnly
```
boolean isAudioOnly()
```
    Return true if the current bitrate is an audio only stream
    
    Returns:
    true if it is audio only, false otherwise
  - isFullScreen
```
boolean isFullScreen()
```
    Return true if the player is in fullscreenmode
    
    Returns:
    true if the player is in fullscreenmode, false otherwise
  - isLive
```
boolean isLive()
```
    Return true when playing a live stream
    
    Returns:
    true if playing a live stream, false otherwise
  - isPlaybackProcessInterrupted
```
boolean isPlaybackProcessInterrupted()
```
    Return true if playback was interrupted by any of the Android SDK plugins
    
    Returns:
    true if playback is interrupted, false otherwise
  - isResumingAfterActivityResume
```
boolean isResumingAfterActivityResume()
```
    Return true if playback is being automatically restarted after an activity resume. This property is set to false once the event PLAYER_EVENT_TYPE_LOAD_REQUESTED is launched
    
    Returns:
    true if playback is being automatically resumed after an activity resume
  - getTimePosition
```
int getTimePosition()
```
    Return the current playback position in seconds
    
    Returns:
    Current playback position in seconds. -1 in case time position couldn't get
  - getTimePositionMS
```
long getTimePositionMS()
```
    Return the current playback position in milliseconds
    
    Returns:
    Current playback position in milliseconds. -1 in case time position couldn't get
  - getTimePositionAsDate
```
java.util.Date getTimePositionAsDate()
```
    Return the current playback position as a local time date
    
    Returns:
    Current playback position as Date (locale time)
  - getPositionInDVR
```
int getPositionInDVR()
```
    Return the current playback position in the DVR in seconds
    
    Returns:
    Current playback position in the DVR in seconds
  - getDVRLength
```
long getDVRLength()
```
    Get the lenght, in seconds, of the DVR
    
    Returns:
    In case the stream is a live stream, returns the length of the DVR in seconds. Otherwise, returns 0
  - getLastPTS
```
long getLastPTS()
```
    Get the PTS of the last packet read by the decoder
    
    Returns:
    PTS of the last packet read by the decoder
  - setAdjustTimestamps
```
void setAdjustTimestamps(boolean adjust)
```
    Enable/disable the adjustment of timestamps in case of misalignment detected
    
    Parameters:
    adjust. - True, to enable adjustment of timestamps
  - setDisableDynamicAudioFeature
```
void setDisableDynamicAudioFeature(boolean disable)
```
    Disable dynamic audio feature in stream (bitrates with different audio settings: channels, sample rate). Having different audio settings per bitrate is not recommended.
    
    Parameters:
    disable. - True, to disable dynamic audio feature
  - setDropWrongTimestampPacketsMode
```
void setDropWrongTimestampPacketsMode(int mode)
```
    Set how to manage packets that don't include timestamp For not well encoded streams is possible that timestamp values are not correctly set. Using this method you can configure the SDK to drop packets with wrong timestamps
    
    Parameters:
    mode. -
  - onResume
```
void onResume()
```
  - onPause
```
void onPause()
```
  - onDestroy
```
void onDestroy()
```
  - getStreamsInfo
```
java.lang.String getStreamsInfo()
```
    Return information about the streams
    
    Returns:
    String with the streams description
  - getVideoWidth
```
int getVideoWidth()
```
    Get the width of the video
    
    Returns:
    Width of the video in pixels
  - getVideoHeight
```
int getVideoHeight()
```
    Get the height of the video
    
    Returns:
    Height of the video in pixels
  - getDuration
```
int getDuration()
```
    Get the duration of the video in seconds. For a live stream the duration will be 0. This value can be assumed as valid once the player has received the event PLAYER_EVENT_TYPE_START_PLAYING.
    
    Returns:
    Duration of the video in seconds
  - getCurrentBitrate
```
long getCurrentBitrate()
```
    Get the current bitrate of the video in bps
    
    Returns:
    Current bitrate in bps
  - setFullScreenMode
```
void setFullScreenMode(int mode)
```
    Set fullscreen mode.
    
    Parameters:
    mode - Fullscreen mode
  - setFullScreen
```
void setFullScreen(boolean fullscreen)
```
    Set fullscreen mode. Fullscreen mode keeps the aspect ratio
    
    Parameters:
    fullScreen - If true, switch the player to fullsreen mode. Otherwise, set non-fullscreen mode
  - getFullScreenMode
```
int getFullScreenMode()
```
    Return the fullscreen mode
    
    Parameters:
    mode - Current fullscreen mode
  - getBufferingPercentage
```
int getBufferingPercentage()
```
    Get the rebuffering percentage
    
    Returns:
    Percentage of rebuffering
  - setRebufferingMode
```
void setRebufferingMode(int iInMode)
```
    Set the rebuffering mode. By default its value is manual. In automatic mode the buffer size is managed by the player control trying to get the shortest startup time and minimizing the rebuffer times
    
    Parameters:
    iInMode - Rebuffering mode value.
  - setRebufferingSize
```
void setRebufferingSize(int iInRebufferSize)
```
    Set the rebuffering buffer size
    
    Parameters:
    iInRebufferSize - Buffer size in bytes.
  - setEventsListener
```
@Deprecated
void setEventsListener(IPlayerEventsListener listener)
```
    Deprecated.
    
    deprecated As of release 5.30, replaced by addEventsListener(IPlayerEventsListener)
  - addEventsListener
```
void addEventsListener(IPlayerEventsListener listener)
```
    Register a callback to be invoked when any player event happens
    
    Parameters:
    player - The callback that will be run
  - removeEventsListener
```
void removeEventsListener(IPlayerEventsListener listener)
```
    Deregister a callback that was invoked when any player event happens
    
    Parameters:
    player - The callback that will be removed
  - setSegmentInfoListener
```
void setSegmentInfoListener(ISegmentInfoListener segInfoListener)
```
  - getBitratesSwitchesUp
```
int getBitratesSwitchesUp()
```
    For multibirate streams, get the number of times the control has switched up
    
    Returns:
    Bitrate switch up times
  - getBitratesSwitchesDown
```
int getBitratesSwitchesDown()
```
    For multibirate streams, get the number of times the control has switched down
    
    Returns:
    Bitrate switch down times
  - getRebuffers
```
int getRebuffers()
```
    Get the number of rebuffers occurred
    
    Returns:
    Number of rebuffers occurred
  - getRebufferingTime
```
double getRebufferingTime()
```
    Get the total time the player has been rebuffering in seconds
    
    Returns:
    Rebuffering time in seconds
  - getFPS
```
long getFPS()
```
    Get the current FPS (Frames per Second)
    
    Returns:
    FPS
  - getAvgFPS
```
long getAvgFPS()
```
    For the current playback, get the average FPS (Frames per Second) This method doesn't make sense in the hardware version of the SDK as the hardware decoder doesn't provide this information
    
    Returns:
    Average FPS
  - getEncodedFPS
```
double getEncodedFPS()
```
    Get the encoded frames per second for the loaded stream This method is not supported on Hardware and Hardware Advanced decoding modes
    
    Returns:
    Encoded Frames Per Second
  - getProtocol
```
java.lang.String getProtocol()
```
    Get the protocol of the current loaded stream
    
    Returns:
    Protocol
  - getServerIp
```
java.lang.String getServerIp()
```
    Get the Server IP of the current loaded stream
    
    Returns:
    Server IP address
  - getServerPort
```
int getServerPort()
```
    Get the Server port for the current loaded stream
    
    Returns:
    Transport protocol port
  - getLastHttpErrorCode
```
int getLastHttpErrorCode()
```
    Get error code of the last HTTP request
    
    Returns:
    Error code of the last HTTP request
  - getLastMeasuredBandwidth
```
int getLastMeasuredBandwidth()
```
    Returns the last measured bandwidth in bytes/sec
    
    Returns:
    Bandwidth in bytes per second
  - setDropFrames
```
void setDropFrames(boolean value)
```
    Configure the player to drop frames when needed for improving audio/video sync. When the CPU is extremely slow, the frame drop feature is automatically turned off to avoid the player to show a constant black screen. The default value for this property is false This method doesn't make sense in the hardware version of the SDK dropping frames or not is managed internally in the hardware decoder
    
    Parameters:
    value - When true, player will drop frames to sync audio/video
  - setVideoQuality
```
void setVideoQuality(int iInQuality)
```
    Set the video quality. By default its value is "Low" This method doesn't make sense in the hardware version of the SDK as hardware decoder always works with the maximum quality, without possibility of configuration
    
    Parameters:
    iInQuality - Video quality
  - setAvoidAudioOnlyStreams
```
void setAvoidAudioOnlyStreams(boolean bInValue)
```
    When multibitrate, deactivate/activate the use of audio only streams This method doesn't make sense in the hardware version of the SDK as the interpretation of the protocol is done by the hardware decoder. We are not analyzing the stream before passing it to the decoder so we can't know if the stream is an audio only stream.
    
    Parameters:
    bInValue - If true, audio only streams will not be used for mbr streams
  - setUseBufferingWhenStarting
```
void setUseBufferingWhenStarting(boolean value)
```
    Enable/Disable the use of an initial buffer used for starting playback If enabled, playback won't start until the initial buffer is full. The size of the buffer can be defined using the method setRebufferingSize. This method doesn't make sense in the hardware version of the SDK as the buffer size is managed internally by the Android hardware decoders
    
    Parameters:
    value - If true, log initial buffering is enabled.
  - setHLSStartingAlgorithm
```
void setHLSStartingAlgorithm(int mode)
```
    Sets the algorithm used for selecting the initial bitrate of the playback
    
    Parameters:
    mode -
  - setNetSessionMode
```
void setNetSessionMode(int mode)
```
    Enable/Disable client side delivery
    
    Parameters:
    mode - NetSession mode.
  - setLogEnabled
```
void setLogEnabled(boolean value)
```
    Enable/Disable log traces
    
    Parameters:
    value - If true, log traces are enabled.
  - setUseMultiThread
```
void setUseMultiThread(boolean value)
```
    Enable/disable the use of multi threading decoding
    
    Parameters:
    if - true, multithread decoding enabled
  - setManualSwitching
```
void setManualSwitching(boolean bInValue)
```
    Sets the manual switching mode
    
    Parameters:
    bInValue - if true, the control switch to manual mode and the bitrate selection algorithm is not used
  - setAvoidIncompatibleVideoProfiles
```
void setAvoidIncompatibleVideoProfiles(boolean bInValue)
```
    Enable/disable protection mechanism that avoids the selection of incompatible bitrates. When using hardware decoding method avoid the player to select any bitrate whose profile is not compatible with the H.264 hardware decoder.
    
    Parameters:
    bInValue - If true, enable protection that avoids selection of bitrates using H.264 profiles incompatible with the device.
  - setAvoidIncompatibleVideoResolutions
```
void setAvoidIncompatibleVideoResolutions(boolean bInValue)
```
    Enable/disable protection mechanism that avoids the selection of incompatible bitrates. When using hardware decoding method avoid the player to select any bitrate whose video resolution higher than the device screen resolution.
    
    Parameters:
    bInValue - If true, enable protection that avoids selection of bitrates whose profile is higher than the device screen reslution.
  - setAutoResume
```
void setAutoResume(boolean enable)
```
    Enable/disable auto resume feature. Auto resume is evaluated when playback was interrupted, in the loading phase, by a plugin. In case auto-resume is set to true, playbac will start automatically once the plugin that interrupted the loading has finishing its work.
    
    Parameters:
    enable - If true, auto-resume is enabled.
  - getBytesLoaded
```
long getBytesLoaded()
```
    For the current playback, get the number of bytes loaded
    
    Returns:
    Bytes loaded
  - about
```
java.lang.String about()
```
    Get the about text. You have to include this text in the About option of your application
    
    Returns:
    About text
  - setProgressBarControl
```
void setProgressBarControl(View progressBar)
```
    Sets the progress bar control that should be shown whenever the player is doing a buffering/loading operation
    
    Parameters:
    progressBar - Progress Bar control
  - getProgressBarControl
```
View getProgressBarControl()
```
    Gets the progress bar control that is shown whenever the player is doing a buffering/loading operation
    
    Returns:
    Progress bar control. It will be null in case no progress bar control was set
  - setDebugUrl
```
void setDebugUrl(java.lang.String value)
```
    When debugging mode is active, each time the player finish playing a stream it sends a report to the url defined using this method. The url parameter allows three variables: %DEVICEID %TIME %ERRORCODE For example, url: http://debug.android.testing.com/postDebug.php?id=%DEVICEID&time=%TIME&error=%ERRORCODE
    
    Parameters:
    value - Url to send the debugging files
  - setDebugingActive
```
void setDebugingActive(java.lang.Boolean value)
```
    Activate/deactivate the debug mode
    
    Parameters:
    value - When true, the player sends debug files to a remote server after each playback
  - setLicense
```
void setLicense(java.lang.String license)
```
    Set the Android SDK license. Please, be sure you call this method before trying to play any video. Otherwise you will be using the Android SDK in trial mode (playback time limited).
    
    Parameters:
    license. - License should be provided by Akamai.
  - getLicensePackageName
```
java.lang.String getLicensePackageName()
```
    Returns the package name for which the set license is valid
    
    Returns:
    Package name of the license.
  - getLicenseExpirationDate
```
java.util.Date getLicenseExpirationDate()
```
    Returns the expiration date of the set license
    
    Returns:
    Expiration date of the license.
  - isLicenseExpired
```
boolean isLicenseExpired()
```
    Get information about the status of the SDK license
    
    Returns:
    true if the license has expired, false otherwise
  - getVersionDescription
```
java.lang.String getVersionDescription()
```
    Get extended information about the SDK version
    
    Returns:
    SDK Version full description
  - setDefaultAudioConfig
```
void setDefaultAudioConfig(int sample_rate,
                         int channels)
```
    Set default audio configuration parameters. Values provided will be used whenever the audio decoder is not able to get the real parameters of a stream Doesn't make sense for the Android SDK hardware version
    
    Parameters:
    sample_rate - Audio stream sample rate
    channels - Number of channels of the audio stream
  - setMediaAnalyticsConfigUrl
```
void setMediaAnalyticsConfigUrl(java.lang.String configUrl)
```
    Sets the Media Analytics config url To use Media Analytics the application must enabled the following permissions - android.permission.INTERNET - android.permission.ACCESS_NETWORK_STATE - android.permission.READ_PHONE_STATE - android.permission.ACCESS_WIFI_STATE
    
    Parameters:
    Media - Analytics config url
  - setMediaAnalyticsData
```
void setMediaAnalyticsData(java.lang.String key,
                         java.lang.String value)
```
    Report Media Analytics custom dimension in the player
    
    Parameters:
    key -
    value -
  - setMediaAnalyticsViewerDiagnosticsId
```
void setMediaAnalyticsViewerDiagnosticsId(java.lang.String viewerId)
```
    Set Media Analytics Diagnostics Viewer Id. Needed for Viewer diagnostics
  - setMediaAnalyticsViewerId
```
void setMediaAnalyticsViewerId(java.lang.String viewerId)
```
    Set Media Analytics Viewer Id
  - getStreamUrl
```
java.lang.String getStreamUrl()
```
    Returns the url of the loaded stream
    
    Returns:
    Url of the loaded stream
  - getFeed
```
AMPFeed getFeed()
```
    Returns the feed of the loaded stream (in case playback was launched providing a json feed)
    
    Returns:
    Feed object
  - getLastErrorCode
```
int getLastErrorCode()
```
    Returns the last error code that happens during the playback
    
    Returns:
    Error code
  - getWidth
```
int getWidth()
```
    Return the width of this view
    
    Returns:
    Width of this view
  - getHeight
```
int getHeight()
```
    Return the height of this view
    
    Returns:
    Height of this view
  - getLocationOnScreen
```
int[] getLocationOnScreen()
```
    Computes the coordinates of this view on the screen
    
    Returns:
    Coordinates of this view on the screen
  - clearRenderBuffer
```
void clearRenderBuffer()
```
    Clears the screen render buffer. Only compatible with software decoding.
  - setInitialSeekingPosition
```
void setInitialSeekingPosition(int iInNewPos)
```
    Set the video starting position
    
    Parameters:
    iInNewPos - The offset in seconds from the start to seek to. It can be 0 to do a relative seek
  - onSegmentProgress
```
void onSegmentProgress(java.lang.String segmentUrl,
                     int segmentOffset)
```
  - getCurrentSegmentUrl
```
java.lang.String getCurrentSegmentUrl()
```
  - setForceFormatChange
```
void setForceFormatChange(boolean value)
```
    When set to true, the format change flag is set to true for the initial segment after a seeking operation. This reduces the "ghosting" effect seen on different devices when the stream keyframe interval is not aligned with the size of the segments. NOTE: only Android devices from 4.0.0 to 4.0.4 are affected, except if setForceOMXdecoding() is set to true. Default value: false Note: only for Hardware Advanced decoding mode
    
    Parameters:
    value - True to force format change flag after every seeking operation
  - setHardwareSeekingProtection
```
void setHardwareSeekingProtection(boolean value)
```
    When set to true, multiple seeks in a row are blocked by the SDK to protect from a hardware interface crash failure occurring for specific streams Default value: false Note: only for Hardware Advanced decoding mode
    
    Parameters:
    value - True to enable protection
  - setAkamaiAlgorithmValue
```
void setAkamaiAlgorithmValue(int bitrate)
```
    Combined with setHLSStartingAlgorithm(VideoPlayerView.HLS_STARTING_ALGORITHM_AKAMAI) this methods allow setting a custom value for the maximum starting bitrate (default is 300000bps)
    
    Parameters:
    bitrate - in bps
  - setForceOMXdecoding
```
void setForceOMXdecoding(boolean value)
```
    When set to true, the decoding engine will use the direct OMX approach instead of the newest MediaCodec approach. Useful for old Android 4.x devices not correctly supporting MediaCodec Default value: false Note: only for Hardware Advanced decoding mode Note: not compatible with audio-only streams (playAudioUrl)
    
    Parameters:
    value - True to force OMX approach
  - setBackgroundColor
```
void setBackgroundColor(int color)
```
    Sets the background color for the player itself
    
    Parameters:
    color - Color to set
  - playMutedUrl
```
void playMutedUrl(java.lang.String sInUrl)
```
    Starts playing the stream in mute
  - isMuted
```
boolean isMuted()
```
    Returns whether or not the current audio thread is muted

Interface VideoPlayerView

Field Summary

Method Summary

Field Detail

VERSION

FULLSCREEN_MODE_NONE

FULLSCREEN_MODE_KEEP_ASPECT_RATIO

FULLSCREEN_MODE_TOTAL

MEDIA_VIDEO_QUALITY_LOW

MEDIA_VIDEO_QUALITY_MEDIUM

MEDIA_VIDEO_QUALITY_HIGH

MEDIA_VIDEO_QUALITY_AUTO

MEDIA_REBUFFERING_MODE_MANUAL

MEDIA_REBUFFERING_MODE_AUTOMATIC

HLS_STARTING_ALGORITHM_AKAMAI

HLS_STARTING_ALGORITHM_APPLE

NETSESSION_MODE_DISABLED

NETSESSION_MODE_ALLOWED

NETSESSION_MODE_REQUIRED

DROP_WRONG_TIMESTAMP_PACKETS_NEVER

DROP_WRONG_TIMESTAMP_PACKETS_ONLY_VOD

DROP_WRONG_TIMESTAMP_PACKETS_ALWAYS

ERROR_SUCCESS

ERROR_NETWORK_UNAVAILABLE

ERROR_NETWORK_RESOURCE_DONT_EXIST

ERROR_NETWORK_SECURITY_ISSUE

ERROR_FORMAT_UNKNOWN

ERROR_RESOURCES_ISSUE

ERROR_TS_SEGMENT_INVALID

Method Detail

playUrl

playUrl

playAudioUrl

playAudioUrl

playFeedFromUrl

playFeedFromJson

stop

pause

resume

seek

seekToLive

switchBitrateUp

switchBitrateDown

setMaxBitrate

setBitrateToPlay

setStartingBitrateIndex

getBitratesCount

getBitrateByIndex

getIndexByBitrate

isBitrateSupported

isPlaying

isPaused

isError

isFinished

isSeeking

isAudioOnly

isFullScreen

isLive

isPlaybackProcessInterrupted

isResumingAfterActivityResume

getTimePosition

getTimePositionMS

getTimePositionAsDate

getPositionInDVR

getDVRLength

getLastPTS

setAdjustTimestamps

setDisableDynamicAudioFeature

setDropWrongTimestampPacketsMode

onResume

onPause

onDestroy

getStreamsInfo

getVideoWidth

getVideoHeight

getDuration

getCurrentBitrate

setFullScreenMode

setFullScreen

getFullScreenMode