Pass the Context, RelativeLayout and MKPlayerConfiguration.

The player itself. It implements the interface MKPlayerApi,LifeCycleEvent and UserActionApi which can be used to control the player. It also implements the interface MKPEventHandler which enables adding and removing of event listeners to this player instance. This class represents only the player logic.

Loads playback content based on source configuration Use this api to load source url with license url or to play from MKP

The method should be called on player when Activity#onCreate is called

The method should be called on player when Activity#onStart() is called

The method should be called on player when Activity#onResume() is called

The method should be called on player when Activity#onPause() is called

The method should be called on player when Activity#onStop() is called

This method should be called when Activity#onDestroy() is called

The playback will enter to the full screen on user action

The playback will leave/exit full screen on user action

This method will return state of the full screen

Starts preloading the content of the currently loaded source. Applicable only for VoD assets and is not explicitly needed to be called as the player will preload for VoD assets by default.

This method will unload the loaded source

Destroys the player and releases all allocated resources.

The player instance must not be used after calling this method.

Returns the current player configuration object of this player instance.

Seeks to the given playback time.

Seeks to the given playback time specified by the parameter time in seconds. For VOD - Must not be greater than the total duration of the video.

To seek/timeshift on a LIVE stream, seekOffset should be either negative or 0.0, calculate seekOffset as in below example:

val SEEKING_OFFSET = 10
//seek back
val seekOffset = mkplayer.getCurrentTime()!! - SEEKING_OFFSET
OR
//seek forward
val seekOffset = mkplayer.getCurrentTime()!! + SEEKING_OFFSET
//check if seekOffset is in seekable range start/end
//based on requirement,
//if seekOffset is out of range for seekForward may goto Live, for seekBackward stay on beginning of buffer.
val seekRange = mkplayer.getSeekableRange()
//check seekOffset is in seekRange i.e. seekOffset in seekRange.start.rangeTo(seekRange.end))
//if seekOffset not in seekRange then can go to 0.0 (i.e.live edge)
mkplayer.seek(seekOffset.minus(seekRange.end))

Note if seekOffset is out of seekable range then position goes to Live.

To seek on a VOD stream, calculate seekOffset as in below example:

val SEEKING_OFFSET = 10
//seek back
val seekOffset = mkplayer.getCurrentTime()!! - SEEKING_OFFSET
OR
//seek forward
val seekOffset = mkplayer.getCurrentTime()!! + SEEKING_OFFSET
mkplayer.seek(seekOffset)

Returns the current playback time in seconds. For VoD streams the returned time ranges between 0 and the duration of the asset. For live streams a Unix timestamp denoting the current playback position is returned.

Returns the total duration in seconds of the current video or INFINITY if it’s a live stream.

Returns mute state

Returns Paused state

Returns Playing state

Returns Stall state

Returns playback mode type

The state of the player should be PREPARED, or PAUSED state to start playing. Play the prepared media item by the player. Playback is started from its current time Successful invoke of this method changes state to PLAYING

The state of the player should be PLAYING Pauses the media item being played Successful invoke of this method changes state to PAUSED

Sets the volume level on the player. Range 0(mute) to 100 including.

This method returns the current volume level set. Range 0(mute) to 100 including.

This method provides an way to mute the volume of the player

This method provides an way to un-mute and set volume level to previous

The method to add event listener for receiving callback

The method to remove event listener , should be used during cleanup.

Sets the selected language as sub title

Queries the available subtitles from the media source

Returns currently used subtitle

Sets the selected audio track

Gets available audios

Returns the currently used audio track.

Returns instance of MKPlayerConfiguration

Returns the MKPSourceConfiguration

Gets available video qualities

Gets available audio qualities

Sets the selected VideoQuality

Sets the selected AudioQuality

Returns the currently set VideoQuality

Returns the currently set AudioQuality

Sets the target buffer level for the chosen buffer type across all media types.

Returns the current and target buffer level for the given buffer type and media type.

Update the previously initialized authToken. Please see MKPBackendConfiguration.

Applicable only for LIVE streams.

Shifts the time to the given offset in seconds from the live edge. Has to be within getMaxTimeShift() (which is a negative value) and 0. Only works in live streams. The offset can be positive and is then interpreted as a UNIX timestamp in seconds. The value has to be within the timeShift window, as specified by getMaxTimeShift().

Applicable only for LIVE streams.

Returns seconds of already buffered video data.

Returns seconds of already buffered audio data.

Returns total number of dropped frames.

Returns the currently playing video frame rate.

Sets upper bitrate boundary for video qualities. All qualities above this threshold will not be selected by the ABR logic. These qualities are still available for manual quality selection. For no limitation set to Integer#MAX_VALUE.

Returns true, if stereo is enabled

If true, stereo mode will be enabled. Applicable to VR content.

Sets the playback speed of the player. Fast forward as well as slow motion is supported. Slow motion is used by values between 0 and 1. Fast forward by values greater than 1. Values less or equal zero are ignored.

Returns the current playback speed of the player. Value 1 is the default playback speed. Values between 0 and 1 refer to slow motion. Values greater than 1 refer to fast forward.

Low latency settings and to query the current low latency

Returns the current latency.

Low latency settings Sets target latency on the player should try to reach and maintain.

Low latency settings and to query the current target latency

Returns the current target latency.

Sets a new MKPScalingMode.

Returns the current ScalingMode.

Returns the time range that is currently valid for seeking. For VoD streams, the returned time ranges between 0..duration of the asset. For Live streams a value relative to the playback start..current live position is returned.

The VideoQuality that is currently being played back or null if no video is currently being played back. The returned quality always represents the actual current video quality, while getCurrentVideoQuality represents what the player is working towards playing (e.g. a new quality can be selected even though it is not being played yet).

The AudioQuality that is currently being played back or null if no audio is currently being played back. The returned quality always represents the actual current audio quality, while getCurrentAudioQuality represents what the player is working towards playing (e.g. a new quality can be selected even though it is not being played yet).

Set a interface internally to handle Picture-In-Picture (PiP) mode. Initially, no interface is set to handle PictureInPicture mode actions.

Puts the view into Picture-In-Picture (PiP) mode. Has no effect if isPictureInPictureAvailable is false or if the view is already in PiP mode.

Pulls the view out of Picture-In-Picture (PiP) mode. Has no effect if isPictureInPictureAvailable is false or if the view is currently not in PiP mode.

When using Picture-in-Picture feature, this method has to be called from Activity.