v4.7.0

Changes from v4.6.0

Bug Fixes

• FEC-9955 | fix default of autoplay/preload to true

• FEC-2765 | Upgrade ExoPayer 2.11.3 + upgrade android to 29

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.7.0'
• implementation 'com.kaltura.playkit:imaplugin:4.7.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.7.0'
• implementation 'com.kaltura.playkit:vrplugin:4.7.0'
• implementation 'com.kaltura.playkit:googlecast:4.7.0'

v4.6.0

Changes from v4.5.0

New Features

FEM-2753 | Kaltura Player Playlist support

Adding Suppport in Playlist Managment.

There are 4 possible combinations for playlist

1. Basic Player - expects list of PKMeidaEntry List as an input

2. OVPPlayer expects playlistId as an input

3. OVPPlayer expects entryIds List as an input

4. OTTPlayer expects entryIds List as an input

for Full documentation check developer portal

for Samples check this samples

Bug Fixes

FEC-9918 | OfflineManager add NPE for null file give as parameter to getWidevineInitData

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.6.0'
• implementation 'com.kaltura.playkit:imaplugin:4.6.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.6.0'
• implementation 'com.kaltura.playkit:vrplugin:4.6.0'
• implementation 'com.kaltura.playkit:googlecast:4.6.0'
• implementation 'com.kaltura.playkit:fbadsplugin:4.6.0'

v4.5.0

Changes from v4.4.0

Bug Fixes

• FEM-2785 | internally - use single class instead of two (need to use KalturaPlaybackRequestAdapter)

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.5.0'
• implementation 'com.kaltura.playkit:imaplugin:4.5.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.5.0'
• implementation 'com.kaltura.playkit:vrplugin:4.5.0'
• implementation 'com.kaltura.playkit:googlecast:4.5.0'

v4.4.0

Changes from v4.3.1

Bug Fixes

• FEM-2505 | Add FBAds plugin to known plugins list

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.4.0'
• implementation 'com.kaltura.playkit:imaplugin:4.4.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.4.0'
• implementation 'com.kaltura.playkit:vrplugin:4.4.0'
• implementation 'com.kaltura.playkit:googlecast:4.4.0'

v4.3.1

Changes from v4.3.0

Bug Fixes

*FEM-2707 | use Media Format as enum and not as String

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.3.1'
• implementation 'com.kaltura.playkit:imaplugin:4.3.1'
• implementation 'com.kaltura.playkit:youboraplugin:4.3.1'
• implementation 'com.kaltura.playkit:vrplugin:4.3.1'
• implementation 'com.kaltura.playkit:googlecast:4.3.1'

v4.3.0

Changes from v4.2.0

Bug Fixes

• FEM-2700 | Video frame does not appear when user presses 'Play' icon before the tracks available
• FEM-2619 | Add Live indicator on player view controls for live streams
• FEM-2636 | Support Audio Tunnelled playback configuration

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.3.0'
• implementation 'com.kaltura.playkit:imaplugin:4.3.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.3.0'
• implementation 'com.kaltura.playkit:vrplugin:4.3.0'
• implementation 'com.kaltura.playkit:googlecast:4.3.0'

v4.2.0

Changes from v4.1.0

New Features

FEM-2603 | Offline Manager support

Bug Fixes

• FEM-2658 | start position in Long instead on double
• FEM-2622 | Share Connection pool with netkit cont
• FEM-2623 | Youbora Options - add missing support in resolving Bundle
• FEM-2623 | add missing support in resolving Bundle as youbora config

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.2.0'
• implementation 'com.kaltura.playkit:imaplugin:4.2.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.2.0'
• implementation 'com.kaltura.playkit:vrplugin:4.2.0'
• implementation 'com.kaltura.playkit:googlecast:4.2.0'

v4.1.1

Changes from v4.1.0

Bug Fixes

• FEM-2623 | add missing support in resolving Bundle as youbora config

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.1.1'

Note: this patch version based on playkit 4.1.0

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.1.1'
• implementation 'com.kaltura.playkit:imaplugin:4.1.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.1.0'
• implementation 'com.kaltura.playkit:vrplugin:4.1.0'
• implementation 'com.kaltura.playkit:googlecast:4.1.0'

v4.1.0

Changes from v4.0.0

Breaking Changes

Upgrades

• Upgrade to ExoPlayer 2.10.3
• FEM-2502 | AndroidX migration

Bug Fixes

• FEM-2569 | Youbora replace token - "entryId" was not replaced

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.1.0'

v4.0.0

Kaltura Player is one of the newly added goodies. In this, we tried to simplify player integration so that client applications will write less boilerplate code on its end.

Gradle Dependency: implementation 'com.kaltura.player:tvplayer:4.0.0'

This dependency has Playkit, Kava Analytics and Phoenix Provider internally so no need to use this on the client app's build.gradle.

Kaltura Player Migration Guide : https://kaltura.github.io/playkit/guide/android/

Our Kaltura Player Test-App can be found here

Prerequisite

Player Initialization

Client application should call a mandatory initialization method calls at the time of application Launch or in the project's Application class file or the SplashActivity.

KalturaPlayer.initializeOTT(this, OTT_PARNTER_ID, OTT_SERVER_URL);
KalturaPlayer.initializeOVP(this, OVP_PARNTER_ID, OVP_SERVER_URL);

OTT Ex.

public static final String OTT_SERVER_URL = "https://rest-us.ott.kaltura.com/v4_5/";
public static final int OTT_PARNTER_ID = 3009;

Note:

Without calling the initialization code on statup KalturaPlayerNotInitializedError error will be fired on the player.loadMedia callback phase.

Warmup

Application can use the warmup connections for its specific CDN servers URLs where the medias are hosted so a connection to the hosts will be opend and ready for use so all handshake process will be saved and media plyback will be faster.

There should be only one URL per host, and the URLs should resolve to a valid pathnames. A good choice might be favicon.ico or crossdomain.xml after the host name.

If application wants to use connection warmer mechanism then this call will be placed at the time of application Launch or in the project's Application class file.

/*
Set the http provider. Valid options are "system" (use the build-in {@linkplain java.net.HttpURLConnection}) 
and "okhttp" (use Square's <a href="https://square.github.io/okhttp/">OkHttp</a> library).
*/ 
PKHttpClientManager.setHttpProvider("okhttp");
PKHttpClientManager.warmUp (
      "https://https://rest-us.ott.kaltura.com/crossdomain.xml",
      "http://cdnapi.kaltura.com/favicon.ico",
      "https://cdnapisec.kaltura.com/favicon.ico",
      "https://cfvod.kaltura.com/favicon.ico"
      );     

Kaltura Player configurations

Media Providers

1. OTT
2. OVP
3. Basic (For those client apps which don't use Kaltura Backend)

Please check the samples for Media Providers here

Application should create PlayerInitOptions.

Initializing OTT/OVP Player

For initialization of OTT Player use OTT_PARTNER_ID and for initialization if OVP player useOVP_PARTNER_ID

Example:

PlayerInitOptions playerInitOptions = new PlayerInitOptions(OTT/OVP PARTNER_ID);

OR

Initializing Basic Player

Example:

PlayerInitOptions playerInitOptions = new PlayerInitOptions();

The playerInitOptions allows the app to set player settings. Following is the example what we had then and what we have now.

In playerInitOptions the default value for player autoplay is true.

In playerInitOptions the default value for player media preload from the BE is true.

Kaltura Player Plugins' Guide

1. IMA Ads Plugin Samples

Gradle Dependency: implementation 'com.kaltura.playkit:imaplugin:4.0.0'

2. Youbora Plugin Samples

Gradle Dependency: implementation 'com.kaltura.playkit:youboraplugin:4.0.0'

3. VR Plugin Samples

Gradle Dependency: implementation 'com.kaltura.playkit:vrplugin:4.0.0'

4. Chromecast Plugin Samples

Gradle Dependency: implementation 'com.kaltura.playkit:googlecast:4.0.0'

Plugin's Version

• implementation 'com.kaltura.player:tvplayer:4.0.0'
• implementation 'com.kaltura.playkit:imaplugin:4.0.0'
• implementation 'com.kaltura.playkit:youboraplugin:4.0.0'
• implementation 'com.kaltura.playkit:vrplugin:4.0.0'
• implementation 'com.kaltura.playkit:googlecast:4.0.0'