Android SDK release notes (historical, 2025 and earlier)
Historical Experiences SDK release notes for Android, 2025 and earlier. For current releases, use the latest published release notes. For 2026 onward, see Android SDK release notes (historical).
1.16.0 - Android
Date: 2025-12-21
Added
- Added a Swipe To Dismiss feature to the Videos Player.
- Widget Play Enhancement & Click Handler Updates.
- Added text localization (content localization). Supported starting with this version through preferred language APIs (
setPreferredLanguage). See Text localization and setPreferredLanguage. - Accessibility - Announce Item Count for Screen Readers.
- Added a new data source -
Search(free text content search). Supported starting with this version. See Free text context search methods and BlazeDataSourceType: Android. - Added new
playmethods to Widgets. See play(from: BlazeWidgetPlayFrom).
Updated
- When hosting application is using the
BlazeSDK.setExternalUserIdmethod, the SDK will no longer clean the local db (meaning, unread states will be preserved across multiple externals ids on the same device).
Fixed
- Fixed an issue caused black screen when no content is available for the first tab.
Widget Play Enhancement & Click Handler Updates
What's new
Enhanced Play Method with Position Control
Widgets can now play content from specific positions using the BlazeWidgetPlayFrom sealed class.
widget.play() // First item (default)
widget.play(BlazeWidgetPlayFrom.Index(2)) // Specific index
widget.play(BlazeWidgetPlayFrom.ContentId("story-123")) // Specific content IDBlazeWidgetPlayFrom Sealed Class:
sealed class BlazeWidgetPlayFrom {
data class Index(val index: Int) : BlazeWidgetPlayFrom()
data class ContentId(val contentId: String) : BlazeWidgetPlayFrom()
}Supported Widgets:
BlazeStoriesWidget(Native & Compose)BlazeMomentsWidget(Native & Compose)BlazeVideosWidget(Native & Compose)
🔴 Breaking Change: onWidgetItemClickHandler
onWidgetItemClickHandlerThe handler now receives parameters with context about the clicked item.
Parameter Data Class
@Keep
data class BlazeWidgetItemClickParams(
val widgetId: String, // ID of the widget
val contentIndex: Int, // Zero-based index of clicked item
val contentId: String // Unique content ID
)Signature Change
Old:
onWidgetItemClickHandler = {
BlazeWidgetItemClickHandlerState.HANDLED_BY_APP
}New:
onWidgetItemClickHandler = { params ->
// params.widgetId, params.contentIndex, params.contentId
BlazeWidgetItemClickHandlerState.HANDLED_BY_APP
}📖 Migration Guide
If You're NOT Using onWidgetItemClickHandler
onWidgetItemClickHandler✅ No action required - your code works without changes.
If You ARE Using onWidgetItemClickHandler
onWidgetItemClickHandlerSimply add the params parameter to your handler:
// Before
onWidgetItemClickHandler = {
performCustomAction()
BlazeWidgetItemClickHandlerState.HANDLED_BY_APP
}
// After
onWidgetItemClickHandler = { params ->
performCustomAction()
BlazeWidgetItemClickHandlerState.HANDLED_BY_APP
}Optional - Access the new parameters:
onWidgetItemClickHandler = { params ->
Log.d("Widget", "ID: ${params.widgetId}")
Log.d("Widget", "Index: ${params.contentIndex}")
Log.d("Widget", "Content ID: ${params.contentId}")
BlazeWidgetItemClickHandlerState.HANDLED_BY_APP
}📚 API Reference
Play Methods
// All widgets (Native & Compose)
fun play() // First item
fun play(from: BlazeWidgetPlayFrom) // Specific positionHandler
onWidgetItemClickHandler: ((BlazeWidgetItemClickParams) -> BlazeWidgetItemClickHandlerState)? = null1.15.0 - Android
Date: 2025-12-04
Added
- Added a new property
disableAnalyticstoBlazeSDK. See disableAnalytics.
Fixed
- Fixed glitch when changing rotation in MultiAspectRatio mode for Videos Player.
- Fixed black screen instead of preview images for Stories pages.
- Fixed rare video starts from position 0 after clicking the CTA in Videos player.
1.14.1 - Android
Date: 2025-11-26
Added
- Added a new property
isVisibleforCTA Styleunder BlazeStoryPlayerCtaStyle & BlazeMomentsPlayerCtaStyle. - Added a new property
followEntityforBlazeMomentsPlayerStyle. See BlazeMomentsPlayerFollowEntityStyle and IBlazeFollowEntitiesManager. - Added a new property
captionsforBlazeVideosPlayerButtonsStyle. See BlazeVideosPlayerButtonsStyle. - Added a new argument
entryContentIdto all entry point methods. See BlazeSDK. - Added
forceRotationstyling option to BlazeVideosPlayerButtonsStyle. - Added
playbackConfigurationof type BlazeVideosPlaybackConfiguration toinitWidgetof Videos. - Added a new argument
playbackConfigurationto BlazeSDK.playVideos and BlazeSDK.playVideo. - Added new methods setDefaultVideosPlaybackConfiguration & getDefaultVideosPlaybackConfiguration to
BlazeSDK.
1.13.2 - Android
Date: 2025-11-13
Fixed
- Fixed Recommendations issue on Moments Widgets.
1.13.1 - Android
Date: 2025-10-19
Added
- Added a new property
promotedLabelsforForYoucase underBlazeRecommendationsType. See BlazeRecommendationsType: Android. - Added a new BlazeSDK method
appendMomentsToPlayerfor appends moments to the currently playing moments player. See BlazeSDK - appendMomentsToPlayer: Android. - Added the option to modify the url of the playback before playing. See PlaybackModificationHandler.
1.12.0 - Android
Date: 2025-08-18
Added
- Added support for Videos Inline component. See Videos Inline Player - Getting Started. Explore common Inline usage examples at our sample app Videos Inline Module.
- Added Moments tabs (Player Tabs Container). Supported starting with this version. See Moments tabs and Android Player Tabs Container. Explore Tabs usage at our sample app Native & Compose.
- Added KeysPresets enum providing predefined keys for common extra info (metadata) fields with direct string access while still supporting custom keys.
- Added visibilityCondition to BlazePlayerCustomActionButtonParams, enabling buttons to be conditionally shown or hidden based on metadata keys using powerful preset and custom logic (e.g., exists, equals, in, range, and/or/not).
- Added support for accessibility.
Updated
- Updated BlazeMomentsPlayerStyle to include the new BlazeMomentsTabsConfigurations styling.
1.11.6 - Android
Date: 2025-07-23
Added
- Added onReadStatusChanged to
BlazeEntryPointDelegateinterface. - Added an optional
sourceIdto all the Entry Points methods (i.e.,prepareStories,playMoments). See Methods.
📋 Comprehensive Error Documentation
We've published a complete error reference guide covering all public error codes,
including their usage patterns.
View Error Reference →
1.10.3 - Android
Date: 2025-06-24
Updated
- Updated internal analytics logic
1.10.2 - Android
Date: 2025-05-12
Added
- Added BlazeContentExtraInfo. This class has been added to the following class, and can be used to get context of the previous, current and next played items:
Updated
- Changed
millisecondsproperty toseconds(also, changed its expected unit from milliseconds to seconds) at BlazeVideosPlayerCtaStyle.BlazeCTAVisibility.VisibleAfterOverlayHidden.
Breaking changes
- In
BlazeGAMCustomNativeAdsDelegate-customGAMTargetingProperties,publisherProvidedId,networkExtrasdelegate functions are nowsuspendin order to allow async fetching the desired results. The default thread is IO. Feel free to switch them to other threads if required. Notice - those are meant to be "short" async functions so please don't do any heavy calculation in order to avoid causing bad user experience. - In
BlazeIMADelegate-customIMASettings,additionalIMATagQueryParams,overrideAdTagUrldelegate functions are nowsuspend. Same applies for them as in the previous point.
1.9.3 - Android
Date: 2025-05-07
API Changes
- Removed
READ_EXTERNAL_STORAGEandWRITE_EXTERNAL_STORAGEpermissions from theAndroidManifest.xml.
Bug fixes
- Resolved a video widget player issue that occurred in landscape mode on tablets.
1.9.0 - Android
Date: 2025-04-24
API Changes
- Added
adTagtoBlazeImaAdInfo. See BlazeImaAdInfo. - Added
shouldOrderContentByReadStatusto Entry Points functions: - Added
personalizedType: BlazeDataSourcePersonalizedTypetoBlazeDataSourceType.Labels(applicable to stories only). See BlazeDataSourcePersonalizedType. - Added Multi lingual CC support.
Bug fixes
- Fixed an issue where the video player’s shadow overlay was occasionally not displayed.
- Fixed an issue where the like count for Moments was visible when the like button was hidden.
1.8.3 - Android
Date: 2025-04-06
Fixed
- Fixed Videos Player issues for specific use cases.
1.8.2 - Android
Date: 2025-03-30
BlazeMomentsPlayerContainer
BlazeMomentsPlayerContainer- Added
containerView: FrameLayoutas a constructor parameter. See BlazeMomentsPlayerContainer - Removed
fragmentManagerandcontainerViewfrom thestartPlaying()method. - Also refer to the migration guide
IBlazeHostingAppContextManager
IBlazeHostingAppContextManager- Added
hostingAppContextvariable of type IBlazeHostingAppContextManager underBlazeSDK.
BlazeDataSourceType
BlazeDataSourceType- Added
advancedOrderTypetoBlazeDataSourceType.LabelsandBlazeDataSourceType.Ids. See BlazeDataSourceType and BlazeAdvancedOrderType.
BlazeStoryPlayerButtonsStyle
BlazeStoryPlayerButtonsStyle- Added the following methods (See BlazeStoryPlayerButtonsStyle.TopStackButtons):
BlazeMomentsPlayerButtonsStyle
BlazeMomentsPlayerButtonsStyle- Added the following methods (See BlazeMomentsPlayerButtonsStyle.BottomStackButtons):
BlazePlayerSourceDelegate
BlazePlayerSourceDelegate- Added
onTriggerCustomActionButtondelegate function.
Fixed
- Bug fixes in Videos Player.
- Fixed an issue in Stories Player Custom Native ads (only image pages) - black screen after clicking on CTA and returning to the player.
1.7.4 - Android
Date: 2025-03-11
Updated
- Resolved
IllegalArgumentExceptionin the default Moment's bottom stack order.
1.7.3 - Android
Date: 2025-03-06
Updated
- GAM Module
- Updated ads SDK to version
24.0.0-com.google.android.gms:play-services-ads:24.0.0. - Note - because of Google's requirements, this update requires Kotlin version of at least
2.0.0.
- Updated ads SDK to version
1.7.1 - Android
Date: 2025-02-19
Added
- Added a new parameter to all the Entry Point functions -
triggerSource. See BlazeSDK.playStory(), BlazeSDK.playStories(), BlazeSDK.playMoment(), BlazeSDK.playMoments(). BlazeSDK.playVideo() and BlazeSDK.playVideos(). - Added a new parameter BlazeIMAAdRequestInformation to the following IMA delegates functions:
- Custom ordering is now available for the Moment's bottom button stack. For more details, please refer to:
- First-time-slide Customizations:
- Introduced support for First-time-slide custom instructions. Please refer to:
- Added the option to disable the visibility of default instructions. Please refer to: BlazeFirstTimeSlideInstructionStyle
- Added properties to customize CTA width and height. Please refer to: BlazeFirstTimeSlideCTAStyle
1.6.0 - Android
Date: 2025-02-03
Added
- Added customization options for the Videos player. See BlazeVideosPlayerStyle.
- Added a section showing how to update the
BlazeMomentsPlayerContainercontent. See Android Player Container & Compose - Android Player Container.
Fixed
- Fixed an issue with First Time Slide CTA button bottom unwanted shadow.
- Fixed an issue with Widget's badge component unread/read state sometimes wasn't updated correctly.
1.5.1 - Android
Date: 2025-02-02
Added
- Added new player type -
Videos. See Videos Player, Videos Player Customizations, Videos Widgets, and Videos Compose Widgets. - Added Moment & Story players closed captions Support:
- Added new
captionsbutton to BlazeStoryPlayerButtonsStyle. - Added new
captionsbutton to BlazeMomentsPlayerButtonsStyle.
- Added new
- Added new
durationElementproperty to BlazeWidgetItemStyle. See BlazeWidgetItemDurationElementStyle.
Updated
- Updated functions signatures for
BlazeGAMCustomNativeAdsDelegate, See BlazeGAMCustomNativeAdsDelegate & BlazeGamCustomNativeAdRequestInformation .
1.4.3 - Android
Date: 2025-01-29
Updated
- Updated functions signatures for
BlazeGAMCustomNativeAdsDelegate, See BlazeGAMCustomNativeAdsDelegate & BlazeGamCustomNativeAdRequestInformation .
1.3.4 - Android
Date: 2025-01-06
Added
- Added support for apps targeting Android's API
35. If using BlazeMomentsPlayerContainer or BlazeMomentsPlayerContainerCompose it is the app's responsibility to place its parent view within the edges.
Fixed
- Fixed a rare crush when user was on background while visiting BlazeMomentsPlayerContainer or BlazeMomentsPlayerContainerCompose.
Improved
- Optimized Players' UI rendering.
1.3.3 - Android
Date: 2024-12-29
Added
- Added Swipe Up Capability to the CTA (Call-to-Action) in Stories, enabling seamless redirection for users.
- Introduced Eye-Catching Animation on the CTA Button to grab attention and boost user engagement.
- Added a stying option to add an icon to a CTA in a Story. See BlazeStorysPlayerCtaStyle & BlazeStorysPlayerCtaIconStyle .
1.3.2 - Android
Date: 2024-12-17
Updated
- Removed obfuscation for
ErrorReasonandErrorDomain
1.3.1 - Android
Date: 2024-12-05
Fixed
- Fixed a rare crush on Android 11 when
connection_typeanalytics property is being computed. - Fixed a rare ANR while app is starting.
1.3.0 - Android
Date: 2024-11-20
Updated
- Added the
overrideAdTagUrlmethod to theBlazeIMADelegateinterface. For details, visit overrideAdTagUrl. - Added
publisherProvidedIdandnetworkExtrasmethods to theBlazeGAMCustomNativeAdsDelegateinterface. Learn more at networkExtras and publisherProvidedId.
1.2.13 - Android
Date: 2024-11-03
Updated
- Updated
targetSdkandcompileSdkfrom33to34. - Updated the
onTriggerCta'sactionTypetype fromStringtoBlazeCTAActionType. See BlazeCTAActionType.
Fixed
- Fixed a bug where items wasn't fully rendered on Compose Row views.
1.2.7 - Android
Date: 2024-10-08
Fixed
- Fixed the following CustomNative ads indices issue:
- Story has CustomNative ads configured on pages 2, 4 and 6.
- The story last unread page index is 2 (user already watched pages 0 and 1).
- User opens the story, ads will be displayed on pages 5 and 7, instead of 4 and 6.
Improved
- Improved Widgets internal structure and performance.
1.2.2 - Android
Date: 2024-09-25
Fixed
- Fixed a crush when
reloadDatawas called right afterinitWidget.
1.2.1 - Android
Date: 2024-09-08
Added
- Added a new Animated Thumbnails preset, please see BlazeWidgetLayout.Presets.MomentsWidget.Row.verticalAnimatedThumbnailsRectangles, animatedThumbnail, BlazeWidgetItemImageAnimatedThumbnailStyle.
- Banner Ads: The GAM module now includes banner ad functionality. For more details, please refer to:
GAM-module BlazeGAMBannerHandlerEventType BlazeGAMBannerAdsAdData BlazeGAMBannerAdsDelegate
Fixed
- Fixed an issue with Custom Native Ads where indices were wrong in case no default campaign was applied.
- Fixed an issue with player opening animation in case the user's keyboard is open.
Improved
- Improved the seek experience in Moments Player.
1.1.2 - Android
Date: 2024-08-26
Fixed
- Resolved an issue with GAM custom native ads related to horizontal view adjustment.
- Enhanced SDK performance for better stability and responsiveness.
1.0.3 - Android
Date: 2024-08-11
Added
- Added new property
content_extra_infoto the following analytics props classes:story,moment,widget,ad,interaction
- Added "Long Press" behavior to Stories Player - any long press on screen will cause overlay fadeout.
Fixed
- Fixed time indication on Stories Player pages where time is greater than a year.
1.0.0 - Android
Date: 2024-07-29
We are excited to announce the release of SDK version 1.0.0. This major update includes several improvements and changes designed to enhance your experience and ensure consistency across platforms. Please review the migration guide for SDK 1.0.0.
General updates:
- Customization Models: We have renamed various classes and properties in our customization models to provide a more intuitive and consistent naming convention. Also, these changes promise less breaking changes in the future, and almost a full alignment between Android and iOS platforms.
- Constructor Changes: Customization constructors are no longer public. This change prevents potential mistakes by clients regarding default values and preset usage.
- Ads Package Extraction: The IMA and GAM ads packages have been extracted for better modularity, making ads integration truly plug and play.
- Roadmap Features: All new features in our roadmap will be built upon the new architecture, ensuring future enhancements are seamlessly integrated.
- Performance & Stability Improvements: Performance improvements has been made, and will be easier to implement from the SDK side. Also, this version also includes several stability improvements.
0.110.2 - Android
Date: 2024-07-29
Fixed
- Fixed issue with Compose widgets shimmer not showing in some use cases.
0.110.1 - Android
Date: 2024-07-07
Added
- Added
isVisibleproperty to StoryPlayerItemTitleTheme customization. - Added
isVisibleproperty to StoryPlayerItemLastUpdateTheme customization. - Added
isVisibleproperty to StoryPlayerItemChipLiveTheme customization. - Added
isVisibleproperty to StoryPlayerItemChipAdTheme customization. - Added
isVisibleproperty to MomentPlayerItemChipAdTheme customization.
0.109.1 - Android
Date: 2024-06-26
Updated
-
BlazeRecommendationsType has been changed from
enumto sealed class.FOR_YOUcase has been changed to (Note -anyLabelFilterhas been added):
data class ForYou( var anyLabelFilter: List<String> = emptyList() ): BlazeRecommendationsType()TRENDINGcase has been changed to:
data class Trending(): BlazeRecommendationsType()
0.108.0 - Android
Date: 2024-06-24
Updated
- Increased timeout for
BlazeSDK.initto 60 seconds.
0.107.0 - Android
Date: 2024-06-17
Updated
- Changed the position of the
sharebutton to be under themutebutton in the story player.
Removed
- layoutPositioning at StoryPlayerItemCtaTheme has been deprecated with no replacement, and has no effect on the layout as it's no longer relevant.
Fixed
- Fixed a minor bug with the IMA ads position indexes.
0.106.0 - Android
Date: 2024-05-30
Added
- Added BlazeMomentsPlayerContainerCompose.
- Added BlazeMomentPlayerContainerComposeStateHandler.
- When user exits a widget, the widget will be scrolled to the last seen item index. For example, the user taps on the first story in the widget --> swipes up to the 10th story --> exits the player --> the widget will be scrolled to the 10th story.
Improved
- Improved Ads fill rate.
0.105.5 - Android
Date: 2024-05-27
Improved
- Player Improvements
- Enhanced Video Playback Experience: Introduced advancements in our video player to offer a more responsive and seamless viewing experience. Videos now start playing faster, ensuring immediate engagement with the content.
- Advanced Content Prefetching: Improved how our player handles upcoming content, ensuring smoother transitions and reduced loading times. This update provides a more fluid experience when browsing through different videos in a playlist.
- Background Video Processing: Videos are now processed more efficiently in the background, enhancing playback continuity and ensuring that the entire content is readily available without interrupting the viewing experience.
- Improved Application Performance: Made significant improvements in the application's performance and stability, especially in how it handles video operations. These enhancements ensure a smoother and more reliable experience without impacting the overall functionality of the app.
- Progress Bar: Improved the Stories & Moments players seek bar animation.
Added
- Added prepareMoments() to BlazeMomentsPlayerContainer.
- When using widgets without calling
initWidgetcall first, the SDK will throw BlazeException.WidgetNotInitializedException. - When calling BlazeMomentsPlayerContainer.startPlaying() on a background thread, the SDK will throw MainThreadRequiredException.
Removed
- Removed the
shouldPrepareContentparameter from the BlazeMomentsPlayerContainer constructor.
Note: This is a breaking change, so make sure to update code usage.- Call prepareMoments() instead.
- Removed legacy "No internet connection" prompt.
0.104.0 - Android
Date: 2024-05-07
Added
- Added new flag to Stories Widgets
initWidgetmethod to support read read/unread ordering:
Updated
- Updated
shouldOrderMomentsByReadStatusflag name toshouldOrderWidgetByReadStatus. This is a breaking change, so make sure to update code usages.
0.103.0 - Android
Date: 2024-05-01
Added
playmethod has been added to Widgets & Compose Widgets .- onPlayerEventTriggered was added to BlazePlayerSourceDelegate. See BlazePlayerEvent.
- Added BlazeSDK.resumePlayer & BlazeSDK.pausePlayer.
- Added resumePlayer & pausePlayer to PlayerContainer
- Added an optional onWidgetItemClickHandler argument to
initWidgeton Widgets & Compose Widgets. See BlazeWidgetItemClickHandlerState
Updated
- setGoogleCustomNativeAdsHandler & setImaHandler parameters are now nullable. Set parameter as
nullto disable ads.
Improved
- IMA user experience has been significantly improved.
0.102.0 - Android
Date: 2024-04-24
Added
- RANDOM option has been added to OrderType.
- Force layout direction was added BlazeSDK.init() function. See BlazeLayoutDirection.
- Added textStyle & text to BlazeWidgetItemBadge.
- Added silent refresh option to updateDataSource function.
Fixed
- Fixed App restoration crash during a player session.
- Moments Player title margin.
0.101.0 - Android
Date: 2024-04-07
Added
- Added Push Notifications support:
0.100.8 - Android
Date: 2024-04-03
Updated
- Improved lifecycle support for custom navigation.
Fixed
- IMA zoom issue on Stories Player.
0.100.4 - Android
Date: 2024-03-24
Fixed
- Fixed Stories CTA styling issues.
0.100.2 - Android
Date: 2024-03-18
Added
- New capabilities to the MomentsPlayerAppearance:
- playerDisplayMode Property: Options:
fixedRatio_9_16orresizeAspectFillCenterCrop. These settings control how content fills the container space by maintaining a fixed ratio or resizing to fill and center-crop. - CTA Styling and Layout: Allows control over the position of the Call-to-Action (CTA) button and the ability to add an icon to it.
- Seek Bar Style, Position, and Behavior: Customization options for the seek bar, including style variations for playing and pause/seek states, spacing from the bottom of the container, and horizontal spacing.
- canHandleUniversalLink Method: This method processes a universal link string and indicates whether the SDK can handle it. It provides a synchronous way to determine if the SDK can handle a given link before calling
handleUniversalLink
- playerDisplayMode Property: Options:
- New capabilities to the BlazeImaHandler
- provideExtraParams function has been added.
0.90.2 - Android
Date: 2024-03-07
Updated
- Fixed issue with Transitive dependencies encountered with
media3
andandroidx.leanback
0.90.0 - Android
Date: 2024-02-29
Added
- BlazeWidgetItemBadge has been added to BlazeWidgetItemAppearance, providing extra customizations options.
- Style Overrides has been added, enabling clients to create unique UI customization for each Widget item.
perItemStyleOverridesproperty has been added to initWidget method in StoriesWidgetsGridList , StoriesWidgetsRowList , MomentsWidgetsGridList and MomentsWidgetsRowList.updateWidgetsUiandupdateOverrideStylesmethods has been added to StoriesWidgetsGridList , StoriesWidgetsRowList , MomentsWidgetsGridList and MomentsWidgetsRowList.perItemStyleOverridesproperty has been added to WidgetStoriesStateHandler and WidgetMomentsStateHandler .updateWidgetsUiandupdateOverrideStylesmethods has been added to WidgetStoriesStateHandler and WidgetMomentsStateHandler .- Haptic Feedbacks
- Added new haptic feedbacks for interactions.
Updated
- StoryPlayerTheme and MomentsPlayerTheme customization from EntryPoints has been fixed.
0.85.2 - Android
Date: 2024-02-25
Added
- BlazeGradientWidget Documentation has been added.
- New Analytics events:
APP_LAUNCH: Will be triggered when app launches (onCreate state).APP_PAUSE: Will be triggered when app is paused (onPause state).APP_CONTINUE: Will be triggered when app is resumed (onResume state).
Updated
- Prefetching Prefetching logic has been updated.
- onPlayerDidDismiss delegate won't be invoked if user exited the player when
FirstTimeSlideis present (onPlayerDidAppear won't be invoked either until player is present). - Enhanced & optimized Interactions performance.
- Improved shading for Moments Player texts components.
- Enhanced support for graceful app restoration to improve user experience when the app is terminated by the Android OS due to process limitations or system constraints.
- Updated Player activity task handling
- Fixed rare issue with story video page playing after an image page.
- Adjusted Stories Player sound state during "Swipe to Dismiss".
- Fixed CTA width customization in MomentsPlayer.
0.82.39 - Android
Date: 2024-02-06
Added
BlazeDataSourceType.Labelsnow contains alsolabelsPriority. ThelabelsPriorityproperty, when present, determines the order in which content is sorted.- Some examples: [label1, label2], [label1,[or,label2,label3]] , [[and,label1,labe2],label3].
orderType- The existing
orderTypeproperty continues to function as follows:- No
labelsPriorityProvided:- If no
labelsPriorityis provided, the content is sorted based on the requested order. - If the LabelFilterExpression is a single label - the
orderTypedefaults to theorderTypedefined on the label. - If the LabelFilterExpression is a label expression - the default will be ‘RecentlyUpdatedFirst’.
- If no
labelsPrioritystring Provided- If the request includes a
labelsPrioritystring, the content is ordered according to the specified priority. TheorderTypeis then used to sort within the same priority level (i.e., all content corresponding to the same priority), and subsequently, to sort all content without any matching priorities.
- If the request includes a
- No
- The existing
- BlazeSDK.playStories
- BlazeSDK.prepareStories
- Analytics Events:
- Added an event for SDK initialization - "sdk_init".
- Memory management optimizations.
Updated
- BlazeSDK.init method has been modified -
globalDelegateandplayerEntryPointDelegatewere added. - initWidget method has been modified -
orderTypeandmaxItemsFromAPIwere removed, and are now part of thedataSourceinstance. Also, delegates structure has been updated.
Note - this is applicable for all widgets in the SDK. - BlazeMomentsPlayerContainer constructor has been modified -
orderTypeandmaxItemsFromAPIwere removed, and are now part of thedataSourceinstance. Also, delegates structure has been updated. BlazeDataSourceType.Labels- now contains alsolabelsPriority,orderType,maxItemsproperties.orderTypeandmaxItems(previously known asmaxItemsFromAPI) were sent via Widgets'initWidgetmethod, and are now part of theLabelsclass.- Old class & New class
-
data class Labels( var blazeWidgetLabel: IBlazeWidgetLabelExpression ) -
data class Labels( var blazeWidgetLabel: IBlazeWidgetLabelExpression var labelsPriority: List<IBlazeWidgetLabelExpression>? = null, var orderType: OrderType? = null, var maxItems: Int? = null ) BlazeDataSourceType.Ids- now contains alsoorderTypeproperty.orderTypewas sent via Widgets'initWidgetmethod, and now is part of theIdsclass.data class Ids( var ids:List<String>, var orderType: OrderType? = null )- StoriesWidgetsRow (Compose) - fixed property naming typo.
widgetStoriesStateHandle-->widgetStoriesStateHandler - WidgetStoriesStateHandler & WidgetMomentsStateHandler - method has been modified -
orderTypeandmaxItemsFromAPIwere removed, and are now part of thedataSourceTypeinstance.
- StoriesWidgetsRow (Compose) - fixed property naming typo.
- IMA
- A new optional method was added to
BlazeImaHandler- provideCustomImaSdkSettings.
- A new optional method was added to
Removed
- setMaxItemsToFetch method is removed. To achieve the same behavior, please use UpdateDataSource.
Note - this is applicable for all widgets in the SDK.
0.80.0 - Android
Date: 2024-01-24
Added
- MomentPlayerTheme
- Added
headingTextproperty of type MomentPlayerItemTextTheme. - Added
bodyTextproperty of type MomentPlayerItemBodyTextTheme . - Added
bottomComponentsAlignmentproperty of type BottomComponentsAlignment
- Added
- BlazePlayerInContainerDelegate
- Added onTriggerPlayerBodyTextLink method .
- Widgets
- Added
onTriggerPlayerBodyTextLinkprops toMomentsWidgetsRowListinitWidget method . - Added
onTriggerPlayerBodyTextLinkprops toMomentsWidgetsGridListinitWidget method .
- Added
- Compose Widgets
- Added
onTriggerPlayerBodyTextLinkprops to WidgetMomentsStateHandler.
- Added
- Ads
- Added BlazeTrackingPixel an optional new property -
customUserAgent.
- Added BlazeTrackingPixel an optional new property -
Updated
- FirstTimeSlide
- Added
textSizeproperty to allFirstTimeSlidecustomization models:- StoryPlayerFirstTimeSlide
- MomentPlayerFirstTimeSlide
- StoryPlayerFirstTimeSlideInstructions
- MomentsPlayerFirstTimeSlideInstructions
- New scrolling behavior - all screen is scrollable, comparing to only
instructionssection until now.
- Added
CtaTypeModelwas changed to BlazeLinkActionHandleType
Removed
- MomentPlayerTheme
- Removed
titleproperty.
- Removed
0.70.1 - Android
Date: 2024-01-08
Added
- Tablet support
- Fixed Transitive dependency in sdk causing
compileSdkVersionto be 34
Updated
- Improved analytics tracking and handling.
- Improved Story Player progress animation.
BlazeMomentsPlayerContainer- The method
startPlayingis now acceptingcontainerView: FragmentContainerViewinstead ofcontainerView: View.
- The method
0.60.12 - Android
Date: 2023-12-21
This SDK version needscompileSdkVersion to be 34 - Future version is removing this issue.
Added
- IMA Support
- BlazeImaHandlerEventType
- BlazeImaHandler
- BlazeImaAdInfo
- Requesting OS audio focus while user is in playing session (external audios will fade out).
Updated
- Custom Native Ads
- BlazeAdsHandler renamed to BlazeGoogleCustomNativeAdsHandler
- BlazeAdsHandler.EventType renamed to BlazeGoogleCustomNativeAdsHandler.EventType
- BlazeAdModel renamed to BlazeGoogleCustomNativeAdModel
- BlazeAdModel.CtaModel renamed to BlazeGoogleCustomNativeAdModel.CtaModel
- BlazeAdModel.AnalyticsData renamed to BlazeGoogleCustomNativeAdModel.AnalyticsData
BlazeResult- The value in
BlazeResult.Successis now changed to non-optional . - Every public method returning
BlazeResult<Any>was changed toBlazeResult<Unit>
- The value in
- Player Audio
- Default audio state for player is mute, instead of unmute.
- Updated player initial audio state to mute, if device is on 0 volume value.
- Improved Stories Player progress bar animation.
0.50.4 - Android
Date: 2023-12-13
Updated
-
Updated ROW_WIDGET_CIRCLE Preset:
-
blazeWidgetItemStatusIndicator.liveUnreadIndicator
appearance equals 0, instead of 2. -
blazeWidgetItemTitle
margins equals to: Margins(top = 12, bottom = 4, start = 4, end = 4), instead of Margins(top = 8, bottom = 8, start = 4, end = 4).
-
-
StoryPlayerTheme.backgroundColor is also applied to the background of the stories list. This means that the specified background color will be visible during transitions between different stories (Instead of black non-customized background).
-
Fixed edge case where the Skeleton (Shimmering) effect wasn't exactly matched the actual content dimensions.
-
Fixed bad pages creation time display when page title is RTL language and device is LTR.
0.50.1 - Android
Date: 2023-12-07
StoryPlayerItemCtaTheme
StoryPlayerItemCtaThemeAdded
-
Property:
layoutPositioning- Description: Defines the layout positioning style of the CTA (Call to Action).
- Type:
PlayerCtaPositioning - Default Value:
PlayerCtaPositioning.CTA_NEXT_TO_SHARE(if not specified)
-
Enum:
PlayerCtaPositioning- Description: Enumeration to specify the positioning of the CTA button.
- Values:
CTA_NEXT_TO_SHARE: Indicates the CTA is positioned next to the Share button.CTA_BELOW_SHARE: Indicates the CTA is positioned below the Share button.
MomentPlayerGradientFooterTheme
MomentPlayerGradientFooterThemeAdded
- Property:
endPositioning- Description: Defining the end positioning of the footer gradient within a player or item container.
- Type:
PlayerFooterGradientPositioning - Default Value:
PlayerFooterGradientPositioning.BOTTOM_TO_CONTAINER(if not specified)
- Enum:
PlayerCtaPositioning- Description: Enumeration defining the end positioning of a gradient within a player or item container.
- Values:
BOTTOM_TO_PLAYER: Indicates that the gradient's bottom will start from the bottom of the player.BOTTOM_TO_CONTAINER: Indicates the CTA is positioned below the Share button.
StoryPlayerItemLastUpdateTheme
StoryPlayerItemLastUpdateThemeAdded
-
Property:
textCase- Description: Represents the text case of last update text used in StoryPlayerItemLastUpdateTheme.
- Type:
PlayerTextCase- Default Value:
PlayerTextCase.LOWERCASE(if not specified)
- Default Value:
-
Enum:
PlayerTextCase.LOWERCASE- Description: Represents the various text case styles
- Values:
UPPERCASE:All letters are capitalized.LOWERCASE: All letters are in small form.
GlobalDelegates - Breaking changes
GlobalDelegates - Breaking changesModified
- Change in Method:
onEventTriggered- Old Signature:
- `onEventTriggered: ((eventName: String, eventData: BlazeAnalyticsEvent) -> Unit)?
- Parameters:
eventType: Type of the event fromString.eventData: Data of the event fromBlazeAnalyticsEvent.
- New Signature:
onEventTriggered: ((eventData: BlazeAnalyticsEvent) -> Unit)?- Parameter:
eventData: Consolidated event data fromBlazeAnalyticsEvent.
- Old Signature:
Contextual Notes
- This modification simplifies the event triggering mechanism within the SDK.
- The new method signature consolidates the event type and data into a single
BlazeAnalyticsEventparameter, streamlining the interface. - This change may affect all implementations of the
GlobalDelegatesprotocol, requiring updates to conform to the new method signature.
BlazeAnalyticsEvent - Breaking changes
BlazeAnalyticsEvent - Breaking changesOverview
- Significant updates have been made to the
BlazeAnalyticsEventclass. These changes include modifications to properties, methods, and overall structure.
Key Changes
- Properties: Several properties have been added, removed, or modified to better align with the analytics requirements.
- Structural Changes: Adjustments in the overall structure for more efficient data handling and integration with other components.
Detailed Documentation
For a complete and detailed overview of all the changes, enhancements, and their implications, please refer to the updated documentation:
Important Notes
- Due to the extensive nature of these changes, it is recommended to review the documentation thoroughly to understand the impact on existing implementations.
0.40.2 - Android
Date: 2023-11-30
Added
- RTL/LTR support.
Changed
- Minor Compose bug fixes.
- Players analytics events fixes.
0.40.0 - Android
Date: 2023-11-26
Added
- Geo Restrictions - new API with changes to SDK init
Changed
- BlazeMomentsPlayerContainer lifecycle improvements and CTA fixes.
- Fixed gradient handling in Stories Player and Moments Player.
- Fixed Widget's data loading issue while Internet connection is unavailable.
- Fixed Widget's title UI issue in rectangles presets.
- Fixed Theme handling for Dark/Light mode.
0.30.35 - Android
Date: 2023-11-23
Changed
- Fixed Compose rendering issue.
- Update CTA Handling for moments Container.
0.30.31 - Android
Date: 2023-11-21
Changed
- Fixed Compose rendering issue.
0.30.30 - Android
Date: 2023-11-16
Changed
- Compose widgets usage and properties have been updated.
- Widgets
- widgetId is now mandatory, and has to be unique, instead of optional.
- playStory API has been changed.
- Fixed BlazeMomentsPlayerContainer CTA bug not triggered.
0.20.9 - Android
Date: 2023-11-12
Changed
- Improved compose support for multiple cases.
0.20.8 - Android
Date: 2023-11-02
Added
- Ads support.
Changed
- Compose's WidgetStateHandler is deprecated, and is replaced by:
- Improved gradient handling in widgets.
- Improved errors exposure to app developers.
- Updated borders paddings logic.
0.20.4 - Android
Date: 2023-10-31
Changed
- Story player first page auto transition.
- Compose Widget swiping event issue when nested in ModalNavigationDrawer.
- UI theme customization for Widget items and Widget Presets.
- CTA handling for app delegate.
- Share experience in Stories Player.
- playStoryPage will always open the requested page.
Added
- Support for custom image for thumb in moments seek bar.
0.20.0 - Android
Date: 2023-10-19
Added
- Jetpack Compose
- Presets
Changed
- Improved videos caching mechanism.
- Stories Preset object
BlazeStoriesTilesPresetsname was changed toBlazeStoriesPresetThemes. BlazeMomentPresetThemes.MOMENTS_THEMEwas changed toBlazeMomentPresetThemes.ROW_WIDGET_RECTANGLE.- Player bug fixes.
0.1.5 - Android
Date: 2023-10-18
Changed Android
- UI improvements for moments player.
- Fixed Widget image cornerRadius attribute calculation.
- Improved UI theme customization for Widget items.
- Updated Widget's presets.
- Updated Widget's clipping and rendering.
0.1.3 - Android
Date: 2023-10-17
Changed Android
- Addressed Android API 34 security issue.
0.1.2 - Android
Date: 2023-10-16
Changed Android
- Player Improvements.
- Custom Thumbnail type support
Updated 16 days ago
