Android Changelog
Each version entry in this changelog lists all updates, improvements, and maintenance releases for the JWX Android SDK 4.
These notes help you track technical changes, performance enhancements, and stability updates across releases.
For information about new features, deprecations, updates that may affect workflows or integrations, and historical release notes, see our Android release notes.
4.27.0
September 11, 2026
New Features
- Added a public caption-styling API
CaptionsConfig) to configure caption font, size, text color, background and window colors, edge style, and placement. - Added
positiontoCaptionsConfigto configure caption box width, horizontal position, alignment, and vertical placement. - Added
FullscreenExitReasonso apps can identify how fullscreen was exited. - Added a process-scoped
MediaDrmCallbackregistration hook for offline DRM license requests. - Added APIs to retrieve the remaining duration of an offline DRM license and refresh renewable licenses without re-downloading media.
- Upgraded AndroidX Media3 (ExoPlayer) from version 1.10.0 to 1.10.1.
- Improved offline DRM license handling so licenses are released when downloads are removed or replaced and custom
MediaDrmCallbackimplementations are used for offline downloads.
Bug Fixes
- Fixed an issue where captions appeared too small in letterboxed portrait layouts.
- Fixed offline downloads crashing on Android 14 and later by declaring the download service with the
dataSyncforeground-service type. Apps using offline downloads and targeting API level 34 or later must declareandroid.permission.FOREGROUND_SERVICEandandroid.permission.FOREGROUND_SERVICE_DATA_SYNC. - Fixed offline downloads not resuming after a requirements wait, process restart, or reboot when supported by the Android version.
- Fixed a crash that could occur when selecting captions shortly after connecting to Chromecast.
- Fixed a potential crash when fullscreen was requested after the player had been destroyed.
- Fixed missing pause and resume ad events after a viewer selected Learn more during a Google DAI ad.
- Fixed an issue where exiting fullscreen during a VAST ad did not restore the windowed player layout.
- Fixed an issue where seeking across a mid-roll cue point while paused requested the ad but did not start playback.
- Fixed an issue where the lock-screen scrubber continued to advance while playback was paused.
- Improved handling of Picture-in-Picture and media-button broadcast receivers.
- Added missing consumer rules for optional dependencies that could cause minified host-app builds to fail.
4.26.0
July 15, 2026
New Features
- Added
PlaylistItem.liveSyncDurationto configure the target live offset, defining how far behind the live edge playback should remain. - Upgraded AndroidX Media3 (ExoPlayer) to version 1.10.0.
- Modernized media source creation and side-loaded caption handling by adopting
DefaultMediaSourceFactory. - Upgraded the Google IMA SDK to version 3.39.0 and added timeout protection for ad requests.
- Updated the headless player to use the modernized playback stack.
- Maintained support for WebVTT, SRT, TTML, and CEA captions following the media source migration.
Bug Fixes
- Fixed an issue where
startTimewas reapplied whenever a playlist item repeated. Repeated items now restart from the beginning. - Fixed an issue where the player UI remained visible when the system automatically entered Picture-in-Picture mode.
- Fixed an issue preventing content from automatically entering Picture-in-Picture mode when an app was backgrounded on Android 12 and later.
- Fixed a crash that could occur when skipping a playlist item during a DAI ad.
- Fixed an issue where captions became unavailable after connecting to a Chromecast device.
- Fixed an issue where captions could not be disabled during a casting session.
4.25.2
June 10, 2026
New Feature
- Added support for the IAB VAST
<Extension type="skippable">element, allowing third-party VAST ads to be marked as skippable.
Bug Fixes
- Fixed an issue where background audio notifications did not refresh after calling
setPlaylistItemMetadata. - Fixed an issue where
setCurrentCaptionsupdated the captions menu selection, yet the rendered captions remained on the previous track. - Fixed an issue where the first
getVisualQualitycall after media load returnedmode="initial"instead of"auto".
4.25.1
May 15, 2026
Bug Fixes
- Fixed an issue where captions could not be disabled during a Chromecast session.
- Fixed missing DAI pause/resume interaction pings when users tap "Learn more".
- Empty VMAP ad tags are now correctly handled as valid (no more false errors), keeping ad metrics accurate.
4.25.0
April 21, 2026
New Features
- Added the
setPlaylistItemMetadataAPI to update the current playlist item’s title, description, and poster image without reloading the player. - Added support for retrieving buffering data from live streams.
Bug Fixes
- Fixed an issue where the VAST progress bar could freeze after an ad error.
- Fixed an issue where live audio streams could fail to play.
- Fixed an issue where captions appeared oversized when the player view exceeded the rendered video area.
- Fixed a crash that could occur when a VOD playlist advanced ro the next media item while the app was in the background on Android 12+.
- Fixed an issue where preroll ads and video content could play simultaneously when tapping replay.
- Fixed an issue where JWS ad tag macros (such as
__page-url__,__timestamp__) were not replaced in IMA ad requests. - Fixed a crash that could occur when interacting with player controls during teardown.
4.24.2
March 1, 2026
- Fixed an issue where preroll ads would incorrectly replay after seeking.
4.24.1
February 25, 2026
- Updated the live stream UI to correctly reflect the paused state.
- Fixed a race condition where IMA preroll ads could fail when playlist items loaded asynchronously.
- Fixed Chromecast captions not displaying during casting and not restoring after disconnecting
- Fixed a potential crash caused by a null reference when making ad API calls.
4.24.0
December 29, 2025
Upgrading to this version requires setting the compiling and target SDK versions when adding the SDK to your app.
New Features
- Upgraded Google IMA SDK to version 3.37.0. You must enable core library desugaring when adding Google IMA client dependencies.
- Improved support for embedded captions in HLS streams when casting to Chromecast.
Bug Fixes
- Fixed a Picture-in-Picture (PiP) crash that could occur when PiP was triggered multiple times in quick succession.
4.23.0
December 2, 2025
- Corrected Live UI behavior in DVR live streams so the indicator accurately reflects the viewer’s current position.
4.22.0
November 12, 2025
- Upgraded OM SDK to version 1.6.0.
Updated 2 days ago
