Changelog

1.28.6

• Added creationTimestamp in DownloadStatus which represents the start time of a download.
• Changed the implementation of PlayerView used in scrubbing preview to resolve media3 vs exoplayer2 version issues.
• Bugfix -
  • Fixed subtitles not displaying during audio-only playback.
  • Fixed the loading icon remaining visible when returning from the home screen.

Know issue fixed

Error 5154, related to a key request failure during video playback with SDK version 1.28.4, has been fixed.

1.28.4

• New Features -

  • Video Clipping : VdoInitParams class includes the new setClips() method, allowing playback of a specific video segment. This feature is ideal for previews, demonstrations, or highlighting content, using startTime(in ms), endTime(in ms), and showClipping parameters to define the segment.
  • Cross-Source Streaming : Also VdoInitParams class able to supports playing cross-source video URLs in addition to VdoCipher-based videos. The new configureMediaSource() method enables playback of external DRM videos, non-DRM videos, local media files, and live streaming URLs.

• Build & Version Changes

  • Updated media3 version to 1.4.1 from 1.4.0.

• Breaking Changes -

  • Added a new callback in VdoPlayer.PlaybackEventListener() to expose onTimelineChanged to users. This requires code changes for those using VdoPlayer.PlaybackEventListener().

• Bug Fixes

  • Improved handling of 61xx errors during playback
  • Enhanced handling of consecutive seeks for smoother playback
  • Backup rules can now be added by the user
  • Fixed bug related to null audio focus
  • BottomSheetDialog is set to be narrower and centered in landscape mode.

Note: Ensure that the build configuration for the project is updated to Android Gradle Plugin (AGP) version 8.2.2 or above, and Gradle version 8.4 or above.

1.27.1

• New Features -

  • Scrubbing Preview: Introduced a new feature that allows users to preview video content while scrubbing through it. This feature provides a visual preview of different sections of the video, enhancing navigation and user experience.
  • Multi-language Support: Added support for multiple languages, including player text elements and error messages.
  • Background Playback: Improved user experience with seamless media playback across app navigation and multitasking scenarios. VdoPlaybackMode options include:
    • DEFAULT: Stops playback when the player screen is closed.
    • CONTINUE_PLAYBACK_ON_BACK_PRESS: Continues playback when the app is minimized, stops when fully closed.
    • CONTINUE_PLAYBACK_ON_APP_EXIT: Keeps playback running even after the app is closed.

• Build Changes

  • Update SDK to AGP to 8.2.2, Gradle to 8.4

• API Changes -

  • VdoPlayerSetting.Builder(): Introduced a new API to globally set VdoPlaybackMode and maxBufferMs on application start for consistent playback and download settings.
  • VdoMediaMetadata: Added a new field in VdoInitParams to allow setting the media title, description, and poster.

• Breaking Changes -

  • Added a new callback in VdoPlayer.PlaybackEventListener() to expose player options to users once prepared. This requires code changes for those using VdoPlayer.PlaybackEventListener().
  • Introduced a new callback in PlayerHost.InitializationListener() to handle player view disconnection events when background playback starts.
  • The setBufferingGoalMs() method has been removed from VdoInitParams.Builder(). You can now set this using the setMaxBufferMs() method in VdoPlayerSetting.Builder().

1.26.9

• Bugfixes -
  • Handling action bar with VdoPlayerUIFragment.
  • Added a fix for 1250 during offline playback.

1.26.8

• Upgraded media3 version to 1.3.1.
• Added a new error code 5135 for invalid video parameters.
• Removed unsupported tracks from Downloads.
• Bugfixes -
  • Resolved NullPointerExceptions.

1.26.7

• Bugfixes -
  • Resolved NullPointerException on background threads.
  • Potential reduction of 6122 errors.

1.26.6

• Security updates.

1.26.5

• Updated the implementation of FOREGROUND_SERVICE_DATA_SYNC, requiring permission to be provided on the app side.
• Bugfixes -
  • Fixed a crash occurring when a translucent primaryColor was set for the app theme.
  • Fixed the caption search button visibility issue.
  • Resolved the cast context leak.

Note: Ensure android.permission.FOREGROUND_SERVICE_DATA_SYNC is declared in the manifest for download to work when target SDK version is set as 34 and higher.

1.26.4

• Added Throwable for methods that can throw exceptions.
• Bugfixes -
  • Fixed RemoteServiceException coming while downloading videos.
  • Fixed few NullPointer exceptions.

1.26.3

• Upgraded Play Integrity request from Classic to Standard.
• Bug fixes:
  • Fixed SecurityException with media downloads when targetSdkVersion is set to 34.

1.26.1

• Exception handling when player not ready.
• Bugfixes -
  • Fixed NullPointerExceptions related to data initialization and background process.
  • Added offline data synchronization.

1.26.0

• Added support for token(alternative of otp).
• Updated minSdkVersion to 21 and compileSdk to 34.
• Bugfixes -
  • Fixed caption search visible at multiple places issue.
  • Fixed a NullPointerException and an ANR related to MediaDRM.

1.25.1

• Added an API, DownloadStatus.isExpired(Context), to check if downloaded media has expired.
• Displaying error code 6187 when attempting to play an expired downloaded file.
• Bugfixes -
  • Fixed a NullPointerException related to onDrmSessionAcquired.
  • Addressed an "Application Not Responding" (ANR) error.
  • Resolved a crash in the Bottom Sheet: occurred when pressing the home button while the Bottom Sheet was open.

1.24.1

• Bugfixes -
  • Fixed auto resume not working properly for offline downloads.
  • Fixed waiting text coming on player after video load.
  • Fixed additional status bar space coming in Flutter.

1.24.0

• Removed support for safetynet. Use Play integrity instead.
• Upgraded minSdkVersion to 19.
• Bugfixes -
  • Fixed download failing due to download being requested in the background.
  • Fixed NullPointerException related to onDrmSessionAcquired.
  • Exception Handling

1.23.5

• Added play integrity support for media download.

1.23.4

• Bugfix - Added PlatformSchedulerService for media3

1.23.3

• Adding cross platform resume.

1.23.2

• Bug fix - Conflict of media3 PlayerView with exoplayer.

1.23.1

• Bugfix - Fixed the Exoplayer version mismatch error (Error 1203) coming while loading a player in release apk.

1.23.0

• Updated DownloadStatus object to include displayable title and description provided while downloading a video.
• Added default player controls in case an error occurs while loading controls
• Bug Fixes -
  • Fixed an issue where the download query filter by status was not functioning correctly.
  • Resolved the problem of native controls not being displayed for certain videos.

1.22.5

• Error message upon transitioning from idle to playing state has been eliminated.

1.22.4

• Migrated to AndroidX Media3 from ExoPlayer.
• Displaying video tracks according to device capabilities.

1.22.3

• Showing media title with download progress notification.
• Bug fix - NoSuchMethodError for WindowInsets.getDisplayCutout().

1.22.2

• Bug fixes -
  • Removed usage of non-sdk API onApplyWindowInsets.
  • Handling NullPointerException with DlServiceSpec.fromJSONString().

1.22.0

• Added option to get description from DownloadStatus.
• Resolved the problem where the player UI control's transparent background was not visible.
• Resolved the problem where the video was started from beginning after an error occurs.
• Incorporated 5114 as retryable error code.

1.21.2

• Backport version with exoplayer dependency v2.19.1
• Latest changes and fixes picked from version 1.22.5 excluding Media3.

1.21.1

• Instead of invoking pack-up, we now pause the player to avoid reloading of the player.
• Bug fixes -
  • Fixed download notification causing crash when started in background.
  • Fixed NullPointer exception when updating speed

1.21.0

• Added support for windowLayoutInDisplayCutoutMode with inbuilt player UI.
• Improved feedback of double tap to skip forward and backward.
• Implemented fullscreen behavior with video in portrait and landscape mode.
• Fullscreen Changes for Player UI:
  • Fixed auto rotate lock while going into fullscreen mode.
  • Implemented fullscreen behavior based on aspect ratio:
    • Vertical videos will go fullscreen in portrait mode.
    • Horizontal videos will go fullscreen in landscape mode.
    • Added APIs enterFullScreen and exitFullScreen to enter or exit fullscreen in VdoPlayerUIFragment.
    • Added FullScreenActionListener to monitor when video enters or exits fullscreen. The listener can be set using the method setFullscreenActionListener of VdoPlayerUIFragment.
• Added API to expose playerOption.
• Added support for handling fullscreen for custom back press implementation
• The import path for VdoParamsGenerator has been modified.

Note: If the enterFullScreen or exitFullScreen method is called from onConfigurationChanged, the video goes into fullscreen but the orientation needs to be handled manually.

1.19.7

• Added support for play integrity.
• Fixed concurrency issue with offline download.

1.19.6

• Added support to conserve player config across session.
• Reduce watermark text size proportionately for a smaller screen.
• Bug fixes -
  • Releasing media session when player stops.
  • Showing "Tap to retry" only when error message is retry-able with the built-in player ui.
  • Going to PiP closes the bottom sheet and dialogs with the built-in player ui.

1.19.4

• Upgraded exoplayer dependency to 2.18.5
• Added view overlay for fullscreen and picture in picture.
• Bug fixes

1.19.2

• Bug fix - Incorrect MediaInfo.duration with DownloadStatus.

1.19.1

• Changed exoplayer data source configurations.

1.19.0

• VdoPlayerUIFragment now has an option to disable default controls.
• Pinch to zoom is now supported with VdoPlayerUIFragment default controls.
• The player resize mode can now be modified.
• Added support for downloading media without audio.
• Upgraded exoplayer dependency to 2.18.2
• Bug fixes.

1.18.2

• Minor Improvements

1.18.1

• Added support for Chromecast.

1.17.0

• Added support for picture in picture mode.
• Added callback for persistent OTP with save offline.
• Updated CompileSdkVersion from API level 31 to 33.
• Updated TargetSdkVersion from API level 30 to 32.
• Vdocipher cast module moved into core module. Cast module dependency no longer needs to be specified separately.
• Removed jcenter due to deprecation.
• Fixed memory leaks.

1.16.0

• Fixed audio issues with offline playback.

• Changed signature of OptionsDownloader. Context is now required for the instantiation of OptionDownloader.

   OptionsDownloader optionsDownloader = new OptionsDownloader(context); //Pass context here.

• Fixed VdoDlService memory leak.

1.15.1

• Code optimisation and refactoring

1.15.0

• Bug fixes related to HLS playback

• First call to onBackPressed() is handled by VdoPlayerUIFragment to manage player orientation and state then subsequent calls are passed to attached activity.

• Option to disable initital handling of onBackPressed() in VdoPlayerUIFragment by setting app:handleBackPress="false". This can be used to handle all back press action in activity.

  <fragment
       android:name="com.vdocipher.aegis.ui.view.VdoPlayerUIFragment"
       ....
       app:handleBackPress="false" //by default it's true
   />

1.14.2

• Added support for TV applications in VdoPlayerUIFragment

1.14.1

• Fixed issue with caption selection
• Increased gesture area for double tap in VdoPlayerUIFragment
• Added migrations for database changes across SDK

1.14.0

• Player UI enhancements
• Fixed issue with clear storage option in VdoPlayerUIFragment

1.13.1

• Player UI enhancements
• Multiple download issue fixed
• Upgraded exoplayer dependency to 2.18.1
• Bug fixes

1.13.0

• New VdoPlayerUIFragment with built-in player controls
  • Option to enable or disable player controls
  • Media can be saved and streamed locally
• Bug fixes

1.12.1

• Adaptive playback bug fix

1.12.0

• Upgraded exoplayer dependency to 2.18.0
• Added caption support for offline playback
• Added option in VdoInitParams to resume video from last playback position
• Added callback to provide an event to resume from saved seek position
• Bug fixes

1.11.0

• Upgraded exoplayer dependency to 2.17.1
• Implemented offline downloads using exoplayer
  • Added feature to download content in external storage
  • Use VdoDownloadManager.getInstance(@NonNull Context context, @Nullable String downloadLocation) with DownloadRequest.Builder(@NonNull DownloadSelections selections) and vdoDownloadManager.enqueueV2(@NonNull DownloadRequest downloadRequest) to use new download implementation
• Provided option for customising download notification helper
• Added feature to search using selected caption
• Added feature to set default caption
• Enhanced watermark feature
• Bug Fixes

Note - - If video download is paused and download location is changed, the half downloaded content needs to be removed manually from device storage and download should be restarted. - In case of re-downloading a video, existing file is removed and downloaded again with new selected tracks

1.10.1

• Fix Track class equals() and hashCode()
• Bug fixes

1.10.0

• Update minSdkVersion to 18. Apps depending on this version will need to set a minSdkVersion of 18 or above
• Fix PlaybackEventListener#onBufferUpdate callback not being called
• Move VdoInitParams, PlayerHost and related classes to top level classes
• Class name changes are:
  • VdoPlayer.PlayerHost --> PlayerHost
  • VdoPlayer.InitializationListener --> PlayerHost.InitializationListener
  • VdoPlayer.PlayerHostNotReadyException --> PlayerHost.PlayerHostNotReadyException
  • VdoPlayer.VdoInitParams --> VdoInitParams

1.9.0

• Upgrade exoplayer dependency to 2.14.2
• Restore track selections on player restore
• Bug fixes

1.8.1

• Option to block devices with ABD debugging on
• Bug fixes

1.7.3

• Upgrade exoplayer dependency to 2.12.3
• Regular security and bug fix updates

1.7.2

• Upgrade exoplayer dependency to 2.11.8
• Add api to get device's analytics ID on vdocipher logs for error handling
• Bug fixes.

1.7.1

• Add option in VdoInitParams to turn off playback analytics collection.
• Disable auto backup of downloaded offline video index.
• Add error code for the case when a requested offline video is not found on the device.
• Bug fixes.

1.6.0

• SafetyNet Implementation for security enhancements

1.5.0

• Offline Download Video Watermark addition

1.4.0

• Bug fixes
• Added Cast plugin dependencies

1.3.1

• Further classify generic errors so they are easier to debug.
• Bug fixes

1.2.0

• Implemented Watermark Skip Behaviour
• Bug fixes

1.1.0

• Some generic error codes have been replaced with more informative specific ones.
• Bug fixes.

1.0.1

• New sdk available for Google Cast support; integration instructions and demo provided in sample app on github
• Added support to specify resume time and autoplay behavior in VdoInitParams
• Added support-library based player fragment
• Improved offline playback compatibility
• Bug fixes.

1.0.0-beta5

• Fixed delayed query results for offline downloads.
• Fixed unreliable deletion for offline downloads.
• Updated to new gradle dependency configurations.
• Bug fixes.

1.0.0-beta4

• Added api to specify start and end time for playback in VdoInitParams.
• Additional error information, when applicable, is available in DownloadStatus#reasonDescription, which can be parsed as a json to obtain details.
• Bug fixes.

1.0.0-beta1

• Added api to easily set and query adaptive mode.
• Finer permission denial error codes and messages.
• Bug fixes.