v4.24.0

Changes from v4.23.1

Features

• FEC-12227 | Add ability to give surface aspect ratio for the Ads (kaltura/playkit-android#789)

  Example:

  To set the resize mode,

  playerInitOptions.setAspectRatioResizeMode(PKAspectRatioResizeMode.zoom);

  To update the resize mode,

  player.updateSurfaceAspectRatioResizeMode(PKAspectRatioResizeMode.fit);

  Note

  • Aspect ratio passed for the Content will be applied same for the Ad view. So If Ad has AspectRatio applied then the same will applied for the content playback.
  • Breaking Change: getExoPlayerAspectRatioResizeMode is moved out from ExoPlayerView. Now it is part of PKAspectRatioResizeMode.

• FEC-12367 | Subtitle Features (kaltura/playkit-android#788)

  • Added subtitle font fraction 1.75f.

     new SubtitleStyleSettings("CustomStyle")
               .setTextSizeFraction(SubtitleStyleSettings.SubtitleTextSizeFraction.SUBTITLE_FRACTION_175);

  • Added ttml mimeType support for subtitles.

     PKExternalSubtitle pkExternalSubtitle = new PKExternalSubtitle()
               .setUrl("subtitle_url")
               .setMimeType(PKSubtitleFormat.ttml)
               .setLabel("label")
               .setLanguage("lang");

Bug Fix

• FEC-12477 | Image track URL is incorrect in case first playback URL is redirected (kaltura/playkit-android#790)
  Apps can listen to PlayerEvent.sourceRedirected event. This event contains the redirected URL.

  player?.addListener(this, PlayerEvent.sourceRedirected) { event ->
          log.d("sourceRedirected : ${event.redirectedUrl}")
  }

• FEC-12321 | Offline: checkAssetStatus is not returning correct status for Clear media asset served with DRM license (kaltura/playkit-android#786)

• FEC-12349 | Fixed the validation while updating low latency config (kaltura/playkit-android#787)

• FEC-12367 | Fixed Subtitle Position's alignment issue (kaltura/playkit-android#788)

• FEC-12535 | Trickplay video tracks are being ignored internally at the time of tracks' preparation (kaltura/playkit-android#791)

• FEC-12439 | (Providers) Fixed sending the FINISH event with HIT in case of LiveMedia + Experimental flag true (kaltura/playkit-android-providers#140)

• FEC-12577 | Fix typo for maxAudioBitrate (#163)

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.23.1

Changes from v4.23.0

Bug Fix (Patch for V4.23.0)

• FEC-12439 | (Providers) Fixed sending the FINISH event with HIT in case of LiveMedia + Experimental flag true

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.22.4

Changes from v4.22.3

Bug Fix (Patch for V4.22.0)

• FEC-12321 | Offline: checkAssetStatus is not returning correct status for Clear media asset served with DRM license (#786)

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.23.0

Changes from v4.22.0

Features

• FEC-12094 | Support In-stream Playready DRM license (kaltura/playkit-android#779)

  Sets whether to force use the default DRM license server URL even if the media specifies its
  own DRM license server URL.

  Use the following player settings with Playready media URL if all license key requests will specify their own URL.

  playerInitOptions.setDRMSettings(new DRMSettings(PKDrmParams.Scheme.PlayReadyCENC).setIsForceDefaultLicenseUri(false));
  

• FEC-12063 | Only for HLS content, exposed allowChunklessPreparation on PlayerSettings. Default is true. (kaltura/playkit-android#780)

  playerInitOptions.allowChunklessPreparation(false);
  

• FEC-12253 | Exposed PlayerEvent eventStreamChanged to access SCTE-35 event streams (kaltura/playkit-android#783)

  player.addListener(this, PlayerEvent.eventStreamChanged, event -> {
        // Use `event` object to receive the payload
  });
  

Bug Fixes and Improvements

• FEC-12186 | Overriding the existing cache config if required (#161)

  If config for a partnerId is cached and app initializes the player for the same partnerId but with a different serverUrl then overriding the previous cache with the new config cache.

• FEC-12191 | Fixed clear content with DRM license URL crash for PrefetchManager (#162)

• FEC-12012 | Fixed setPlaybackRate crash if app passes any -ve value (kaltura/playkit-android#773)

• FEC-12123 - Support referenceId for OVP YouTube media type
  Supporting Youtube entryId - if partner is requesting from Kaltura OVP Provider an entry Id with externalSourceType which is YouTube
  type the player will not deny that request, it will populate the PKMediaEntry metadata map with 2 new values:
  externalSourceType = "YouTube"
referenceId = "the youtube media reference id"

  Note

  When you use kaltura player you have to make sure auto play is false since youtube media is not playable on the SDK for now.

• FEC-12107 - fix potential crash if SDK is requested to play Youtube media entry

• FEC-12092- Append "/" to the server URL path if base url does not end with it

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.22.3

Changes from v4.22.0

Bug Fix

• FEC-12191 | Prefetch - Fixed clear content with DRM license URL crash

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.22.2

Changes from v4.22.0

Bug Fix

• FEC-12123 - Support referenceId for OVP YouTube media type
  Supporting Youtube entryId - if partner is requesting from Kaltura OVP Provider an entry Id with externalSourceType which is YouTube
  type the player will not deny that request, it will populate the PKMediaEntry metadata map with 2 new values:
  externalSourceType = "YouTube"
referenceId = "the youtube media reference id"

Note

when you use kaltura player you have to make sure auto play is false since youtube media is not playable on the SDK for now.

• FEC-12107 - fix potential crash if SDK is requested to play Youtube media entry

• FEC-12092- Append "/" to the server URL path if base url does not end with it

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.22.1

Changes from v4.22.0

Note - Please use v4.22.2 instead

v4.22.0

Changes from v4.21.1

Upgrades

• FEC-11987 | ExoPlayer upgrade to v2.17.1 (kaltura/playkit-android#776) (#157)

  Breaking Changes:

  • If application is using custom notification for ExoOfflineProvider then ExoOfflineNotificationHelper's buildNotification has a new parameter notMetRequirements . Code change is here.

  Please check the Prefetch Sample and the respective code to understand the changes on app side changes

  • Player.EventListener is changed to Player.Listener for PlaybackControlsView sample reference

  Critical parts touched during this upgrade

  • Check Dash Thumbnail Images [Kaltura-Player]
  • Check External Thumbnail Images
  • DRM content Playback (Online/Offline)
  • Text/Video/Audio Track Selection
  • HLS content playback
  • Dolby Vision Content playback

Internal Fix

• FEC-12017 | Javadoc Enablement (#158)

Plugin's Version

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

ExoPlayer Version v2.17.1

Samples

v4.21.1

Changes from v4.21.0

Bug Fix

• FEC-11428 | Handle ConcurrentModificationException in message bus (kaltura/playkit-android#775)
• FEC-12011 | Remove warning from logcat (kaltura/playkit-android#774)

Plugin's Version

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

ExoPlayer Version v2.16.1

Samples

v4.19.4

Changes from v4.19.0

Bug Fix

• FEC-11428 | Handle ConcurrentModificationException in message bus in playkit

Plugin's Version

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

ExoPlayer Version v2.15.1

Samples