iOS SDK release notes (historical, 2025 and earlier)
Historical Experiences SDK release notes for iOS, 2025 and earlier. For current releases, use the latest published release notes. For 2026 onward, see iOS SDK release notes (historical).
1.16.0 - iOS
Date: 2025-12-21
Added
- 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: iOS. - Added new
playmethods to Widgets. See play(from: BlazeWidgetPlayFrom).
Fixed
- Fixed Moments Tabs layout broken on iPad with sidebar in landscape mode.
- Universal links for stories without a page ID fail to open.
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 enum.
widget.play() // First item (default)
widget.play(from: .index(2)) // Specific index
widget.play(from: .contentId("story-123")) // Specific content IDBlazeWidgetPlayFrom Enum:
public enum BlazeWidgetPlayFrom {
case index(Int) // Play from specific index
case contentId(String) // Play from specific content ID
}Supported Widgets:
BlazeStoriesWidgetView(UIKit & SwiftUI)BlazeMomentsWidgetView(UIKit & SwiftUI)BlazeVideosWidgetView(UIKit & SwiftUI)
🔴 Breaking Change: onWidgetItemClickHandler
onWidgetItemClickHandlerThe handler now receives parameters with context about the clicked item.
Parameter Struct
public struct BlazeWidgetItemClickParams {
public let widgetId: String // ID of the widget
public let contentIndex: Int // Zero-based index of clicked item
public let contentId: String // Unique content ID
}Signature Change
Old:
widget.onWidgetItemClickHandler = {
return .handledByApp
}New:
widget.onWidgetItemClickHandler = { params in
// params.widgetId, params.contentIndex, params.contentId
return .handledByApp
}📖 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
widget.onWidgetItemClickHandler = {
performCustomAction()
return .handledByApp
}
// After
widget.onWidgetItemClickHandler = { params in
performCustomAction()
return .handledByApp
}Optional - Access the new parameters:
widget.onWidgetItemClickHandler = { params in
print("Widget: \(params.widgetId)")
print("Index: \(params.contentIndex)")
print("Content ID: \(params.contentId)")
return .handledByApp
}📚 API Reference
Play Method
// All widgets (UIKit & SwiftUI)
public func play(from: BlazeWidgetPlayFrom = .index(0))Handler
public var onWidgetItemClickHandler: ((BlazeWidgetItemClickParams) -> BlazeWidgetItemClickHandlerState)?1.15.1 - iOS
Date: 2025-12-04
Added
- Added a new property
disableAnalyticstoBlazeSDK. See disableAnalytics.
Fixed
- Fixed potential conflicts with a custom operator within the Blaze SDK.
1.14.2 - iOS
Date: 2025-11-11
Updated
- Bump the min iOS version for the SDK to iOS 15
Added
- Added a new property
isVisibleforCTA Styleunder BlazeStoryPlayerCtaStyle & BlazeMomentsPlayerCtaStyle. - Added a new property
captionsforBlazeVideosPlayerButtonsStyle. See BlazeVideosPlayerButtonsStyle. - Added a new property
forceRotationforBlazeVideosPlayerButtonsStyle. See BlazeVideosPlayerButtonsStyle. - Added a new argument
entryContentIdto all entry point methods. See BlazeSDK. - Added swipe to dismiss for the Video player.
- Added additional configuration capabilities for the Video Player; BlazeVideosPlaybackConfiguration available through Videos Widget & Blaze.shared.
- Added new methods setDefaultVideosPlaybackConfiguration & getDefaultVideosPlaybackConfiguration to
BlazeSDK. - Added a new property
followEntityforBlazeMomentsPlayerStyle. See Follow Entities
1.13.1 - iOS
Date: 2025-10-19
Added
- Added a new property
promotedLabelsforForYoucase underBlazeRecommendationsType. See BlazeRecommendationsType: iOS. - Added a new BlazeSDK method
appendMomentsToPlayerfor appends moments to the currently playing moments player. See BlazeSDK - appendMomentsToPlayer: iOS. - Added Moments tabs (Player Tabs Container). Supported starting with this version. See Moments tabs and iOS - Player Tabs Container.
- Added the option to modify the url of the playback before playing. See PlaybackModificationHandler
Updated
- Updated BlazeMomentsPlayerStyle to include the new BlazeMomentsTabsConfigurations styling.
Fixed
- Closing the Moments/Stories player from a presenting sheet closes the sheet as well - Fixed
1.12.0 - iOS
Date: 2025-08-28
Added
- Added support for Videos Inline component. See Videos Inline Player.
- Added BlazeSwiftUIVideosInlinePlayerView, enabling the videos inline player experience for SwiftUI apps.
- 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.
1.11.4 - iOS
Date: 2025-07-23
Added
- Added onReadStatusChanged to
BlazeEntryPointDelegateprotocol. - 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 - iOS
Date: 2025-06-18
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:
- Added
fontVerticalPaddingto BlazeMomentsPlayerBodyTextStyle object.- Use this property when your font does not reserve enough vertical space internally.
Important changes
- In
BlazeGAMCustomNativeAdsDelegate-customGAMTargetingProperties,publisherProvidedId,networkExtrasdelegate functions are nowasyncin order to allow async fetching the desired results. The default thread is background thread. 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.4 - iOS
Date: 2025-05-07
Added
- Added helper methods for passing an array of BlazeWidgetLabel to Combine multiple label expressions.
Changed
- Updated Google Ads SDK dependency range from 10.x-<12 to 12.x-<13 due to breaking changes introduced by Google in version 12.x.
If your app declares the Google Ads SDK directly (e.g., with an exact or ranged version), you’ll need to update it to a supported 12.x version and handle any breaking changes.
If you don’t declare the Google Ads SDK directly, no action is required.
Bug fixes
- Fixed SwiftUI grid widgets sizing issues on device rotations
1.9.2 - iOS
Date: 2025-04-24
Added
- Added
adTagtoBlazeImaAdInfo. See BlazeImaAdInfo. - Added
shouldOrderContentByReadStatusto Entry Points functions: - Added
personalizedType: BlazeDataSourcePersonalizedTypetoBlazeDataSourceType.labels(applicable to stories only).
See BlazeDataSourceType & BlazeDataSourcePersonalizedType. - Added Multi lingual CC support.
1.8.0 - iOS
Date: 2025-03-31
Added
- Added
hostingAppContextvariable of type BlazeHostingAppContextManagerProtocol underBlaze.shared. - Added
advancedOrderTypetoBlazeDataSourceType.labelsandBlazeDataSourceType.ids. See BlazeDataSourceType and BlazeAdvancedOrderType. - Added the option for setting custom action buttons for the Stories and Moments players.
- References:
- Added the following methods and properties to BlazeStoryPlayerButtonsStyle
- Added the following methods and properties to BlazeMomentsPlayerButtonsStyle
- References:
1.7.2 - iOS
Date: 2025-03-05
Added
- Added a new parameter to all the Entry Point functions -
triggerSource. See Blaze.shared.playStory(), Blaze.shared.playStories(), Blaze.shared.playMoment(), Blaze.shared.playMoments(). Blaze.shared.playVideo() and Blaze.shared.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.7.0 - iOS
Date: 2025-02-25
Added
- Added a new parameter to all the Entry Point functions -
triggerSource. See Blaze.shared.playStory(), Blaze.shared.playStories(), Blaze.shared.playMoment(), Blaze.shared.playMoments(). Blaze.shared.playVideo() and Blaze.shared.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.2 - iOS
Date: 2025-02-11
Added
- Added customization options for the Videos player. See BlazeVideosPlayerStyle.
- Added a new method for updating the BlazeMomentsPlayerContainer content. See Player Container.
Fixed
- Fixed an issue that Widgets do not show a player when stacked above at least 2 Modals
1.6.1 - iOS
Date: 2025-01-08
Added
- Added new player type -
Videos. See Videos Player, Videos Widgets, and Videos SwiftUI Widgets. - Added Moment & Story players closed captions Support:
- Added new
captionsbutton to BlazeStoryPlayerButtonsStyle - Added new
captionsbutton to BlazeMomentsPlayerButtonsStyle
- Added new
Updated
- Updated functions signatures for
BlazeGAMCustomNativeAdsDelegate, See BlazeGAMCustomNativeAdsDelegate & BlazeGamCustomNativeAdRequestInformation .
1.5.3 - iOS
Date: 2025-01-02
Fixed
- Resolved an issue where, in certain cases, the share button in the Moments Player wasn't clickable.
1.5.2 - iOS
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.
1.5.1 - iOS
Date: 2024-12-16
Fixed
- Resolved an issue where, in certain cases, the video in the Moments Player scaled incorrectly, causing it to lose its aspect ratio.
1.4.1 - iOS
Date: 2024-11-20
Updated
- Added the
overrideAdTagUrlmethod to theBlazeIMADelegateinterface. For details, visit overrideAdTagUrl. - Added
publisherProvidedIdandnetworkExtrasmethods to theBlazeGAMCustomNativeAdsDelegateinterface. Learn more at networkExtras and publisherProvidedId.
Fixed
- Fixed IMA screen Background color to be hard-coded Black.
1.3.1 - iOS
Date: 2024-11-12
Updated
- Changed BlazeGAM and BlazeIMA pods to generate static frameworks.
1.3.0 - iOS
Date: 2024-10-22
Fixed
- Fixed CTA image and text clashing in RTL.
- Fixed some cases where moments container playback overlapped with a playback opened from a push notification.
- Fixed Moment's Like button size.
- Fixed Animated Thumbnails not resuming to play after a widget refresh.
Updated
- Replaced the
actionTypeStringfound inonTriggerCtawithBlazeCTAActionType. See BlazeCTAActionType.
1.2.5 - iOS
Date: 2024-10-08
Improved
- Video player optimizations for a smoother transition between playbacks.
Fixed
- Fixed the following CustomNative ads indices issue:
- Story has CustomNative ads configured on pages 2, 4 and 6.
- The story's last unread page index is 2 (the 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.
- Moment description displayed inconsistently before and after expansion.
1.2.1 - iOS
Date: 2024-09-17
Fixed
- Fixed compilation errors when using Swift.Foundation.Int.formatted(:).
1.2.0 - iOS
Date: 2024-09-08
Added
- Added a new Animated Thumbnails preset; please see BlazeWidgetLayout.Presets.MomentsWidget.Row.verticalAnimatedThumbnailsRectangles, animatedThumbnail, BlazeWidgetItemImageAnimatedThumbnailStyle.
- Added Banner Ads in stories player.
Renamed
Ads
BlazeGAMDelegatehas been renamed to BlazeGAMCustomNativeAdsDelegate.BlazeCustomAdDatahas been renamed to BlazeCustomNativeAdData.BlazeGAMDefaultAdsConfighas been renamed to BlazeGAMCustomNativeAdsDefaultConfig.- Renamed
BlazeGAM.shared.enableCustomNativeAds(defaultAdsConfig:delegate:)toenableCustomNativeAds(defaultCustomNativeAdsConfig:delegate:)Please refer to the GAM Module docs.
1.1.1 - iOS
Date: 2024-08-29
Fixed
- Fixed podspec for IMA and GAM modules
1.1.0 - iOS
Date: 2024-08-26
Fixed
- Fixed an issue where the ad continues to run during a long press on the screen in custom native ads.
- Fixed a bug where, in some cases, the story player overlay components were removed when entering the background.
Changed
- Moments seek bar default color has been updated according to the design kit.
- Renamed the property for widgets from
adjustSizeAutomaticallytoisEmbededInScrollViewto better clarify the purpose of this property.
Breaking Change: This update may require changes in your code. The automatic fix suggestion is to replace all instances ofadjustSizeAutomaticallywithisEmbededInScrollView.
1.0.4 - iOS
Date: 2024-08-13
Added
- Added new property
content_extra_infoto the following analytics props classes:
story,moment,widget,ad,interaction
Fixed
- Fixed time indication on Stories Player pages where time is greater than a year.
- Fixed Moments player content cropped on iPhone SE.
1.0.0 - iOS
Date: 2024-07-30
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.
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 have been made and will be easier to implement from the SDK side. Also, this version includes several stability improvements.
0.19.1 - iOS
Date: 2024-07-09
Added
- Added
isVisibleproperty to BlazeStoryText customization. - Added
isVisibleproperty to BlazeStoryLastUpdateText customization. - Added
isVisibleproperty to BlazeStoryChip customization. - Added
isVisibleproperty to BlazeMomentChip customization.
0.18.1 - iOS
Date: 2024-06-26
Updated
- Enhanced Recommendation Filtering: Updated BlazeRecommendationsType enum to include an
anyLabelFilterparameter forforYouandtrendingcases. This parameter is an array of strings that allows for more specific content filtering based on user relevance and preferences. The update ensures that the recommendation system provides users more targeted and relevant content.
0.17.0 - iOS
Date: 2024-06-16
Updated
- Changed the position of the
sharebutton to be under themutebutton in the story player.
Deprecated
- Deprecated
CTAPositioningenum cases:ctaNextToShareandctaBellowSharewith no replacement as they are no longer relevant.
Fixed
- Fixed a small bug with the IMA ads position indexes.
0.16.4 - iOS
Date: 2024-06-03
Added
- Added BlazeSwiftUIMomentsContainerView to support Moments Container in swiftUI.
Updated
- Improved Ads fill rate logic.
0.15.2 - iOS
Date: 2024-05-29
Added
- Added moments title alignment support for force RTL configuration.
0.15.1 - iOS
Date: 2024-05-19
Updated
- Updated
invalidDataSourceTypeProvidederror value fromBlazeDataSourceTypetoString.
Note: This is a breaking change, so make sure to update code usage.
Added
- Added prepareMoments to BlazeMomentsPlayerContainer.
Removed
- Removed the
shouldPrepareContentparameter from theBlazeMomentsPlayerContainerinit method.
Note: This is a breaking change, so make sure to update code usage.- Call
prepareMoments()instead.
- Call
0.14.0 - iOS
Date: 2024-05-08
Updated
- Updated
shouldOrderMomentsByReadStatusflag name toshouldOrderWidgetByReadStatus.
Note: This is a breaking change, so make sure to update code usage.- See more in the Widgets section.
- For SwiftUI widgets, you can modify this flag through the BlazeSwiftUIWidgetConfiguration
Removed
- Removed the
shouldOrderMomentsByReadStatusparameter from theBlazeSwiftUIMomentsWidgetViewModelinit method.
0.13.0 - iOS
Date: 2024-05-06
Added
play()method has been added to Widgets & SwiftUI Widgets .- onPlayerEventTriggered was added to BlazePlayerSourceDelegate. See BlazePlayerEvent
- Added resumeCurrentPlayer & pauseCurrentPlayer to the BlazeSDK shared instance.
- Added resumePlayer & pausePlayer to BlazeMomentsPlayerContainer
- Added an optional onWidgetItemClickHandler property to Widgets & SwiftUI Widgets.
0.12.0 - iOS
Date: 2024-04-24
Added
- Random option has been added to OrderType.
- Added textStyle & text to BlazeWidgetItemBadge
0.11.1 - iOS
Date: 2024-04-07
Added
- Added Push Notifications handling support:
0.10.3 - iOS
Date: 2024-03-27
Added
- Update Blaze SDK to include privacy manifest files.
0.10.1 - iOS
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(_ link: completion:).
- playerDisplayMode Property: Options:
- Added an example to the sample app demonstrating how to apply additional parameters to the VAST tag, such as consent parameters.
Fixed
- Fixed a bug when swapping between external user IDs.
0.9.0 - iOS
Date: 2024-03-03
Added
- BlazeWidgetItemBadge Struct
- Represents the configuration for the badge of a widget item.
- BlazeBadgeBorderStyle Struct
- Represents the border style configuration for a badge.
- Added to the BlazeWidgetView, BlazeSwiftUIStoriesWidgetViewModel, and BlazeSwiftUIMomentsWidgetViewModel:
- perItemStyleOverrides Property
- A dictionary property that maps
BlazeWidgetItemCustomMappinginstances toBlazeWidgetItemStyleOverrides. This mapping enables the application of custom style overrides to individual items within the widget based on specified criteria or attributes.
- A dictionary property that maps
- updateWidgetsUI Method
- Updates the user interface of the widget(s) managed by this class. This method is responsible for applying any pending changes to the widgets' appearances, including style overrides, or layout adjustments.
- updateOverrideStyle Method
- Updates the style override for a single item within the widget based on a custom mapping and optionally refreshes the widget's UI to reflect the change.
- This method allows for dynamic customization of an item's appearance by applying a new style override or removing an existing one. If
nilis passed as the style, any existing override for the specified item will be removed.
- updateOverrideStyles Method
- Updates style overrides for multiple items within the widget based on custom mappings and optionally refreshes the widget's UI to reflect these changes.
- This method supports bulk updates to style multiple items, allowing efficient customization of the widget's appearance. Similar to
updateOverrideStyle, passingnilas a style for an item removes the existing override for that item.
- perItemStyleOverrides Property
- BlazeWidgetItemCustomMapping Struct
BlazeWidgetItemCustomMappingis a structure designed to facilitate custom key-value mappings for Blaze widget items. It enables the association of specific data points with a widget item, allowing for flexible data representation within the widget.
- BlazeWidgetItemStyleOverrides Struct
BlazeWidgetItemStyleOverridesis a structure used to define custom style overrides for a specific item within a Blaze widget. It allows customization of various visual aspects of an item.
- Haptic Feedbacks
- Added new haptic feedbacks for interactions.
Fixed
- Fixed a small UI bug when reloading data with skeletons.
- Resolved a bug where the SDK ignored a specific appearance passed in the playStory method and always used the global appearance.
0.8.5 - iOS
Date: 2024-02-21
Added
- Added new analytics events:
- app_launch - When the app is opened.
- app_pause - When the app is sent to the background.
- app_continue - When the app resumes from background to foreground.
- Added a new optional delegate parameter in BlazeSDK.initialize method.
Updated
- The prefetching policy has been updated.
- Enhanced & optimized Interactions performance.
Fixed
- Fix edge cases of prefetch requests failing.
0.8.2 - iOS
Date: 2024-02-01
Added
- Blaze Class Methods
- Added playStories(dataSourceType:appearance:completion:) method to play stories for a specific dataSourceType.
- Added prepareStories(dataSourceType:completion:) method to prepare and load stories for a specific dataSourceType.
- Analytics Events:
- Added an event for SDK initialization.:
- New Functionality for BlazeDataSourceType:
- labelsPriority: This new functionality within the labels case of BlazeDataSourceType allows specifying the priority of labels, enabling content to be sorted based on the defined priority order.
Updated
- BlazeDataSourceType Enum
- The labels case now includes labelsPriority: [BlazeWidgetLabel]? = nil, orderType: BlazeOrderType? = nil, and maxItems: Int? = nil parameters. These enhancements provide more detailed control over the content request, including prioritization of labels, ordering of content, and limiting the number of items to retrieve.
- The ids case has been updated to allow specifying an orderType: BlazeOrderType? = nil, offering more flexibility in managing data sources identified by string identifiers.
Fixed
- Bug Fixes:
- Addressed an issue in BlazeWidgetDelegate where the deprecated onTriggerCTA method was incorrectly required to be implemented.
- Fixed a similar issue in BlazePlayerContainerDelegate with the mandatory implementation of the deprecated onTriggerCTA method.
- Resolved a playback issue in BlazeMomentsPlayerContainer where content would not play if shouldPrepareContent was set to false.
- Fixed a fetching issue in BlazeMomentsPlayerContainer where content was fetched twice when shouldPrepareContent was true and the play method was called along with the container's initialization.
- Fixed Grid and Container sizeLimit issue.
Deprecated
- Deprecated Properties:
- Deprecated standalone sizeLimit and orderType properties in favor of incorporating them as associated values within the dataSourceType cases. This change aims to simplify and streamline the configuration process for BlazeWidgets and BlazeMomentsPlayerContainer.
0.7.0 - iOS
Date: 2024-01-24
Added
- BlazeMomentsAppearance
- Added
headingTextproperty of type BlazeMomentsHeadingText. - Added
bodyTextproperty of type BlazeMomentsBodyText . - Added
bottomComponentsAlignmentproperty of type BlazeBottomComponentsAlignment
- Added
- BlazePlayerSourceDelegate:
BlazePlayerSourceDelegate is a protocol that defines the delegate methods for various player source interactions within the Blaze framework. It facilitates handling events related to data loading, player visibility, and actions within the player, customized for different player types and sources. This protocol is a crucial component for managing player-related events in a robust and flexible manner.- Added onTriggerPlayerBodyTextLink method .
- Ads
- Added BlazeTrackingPixel an optional new property -
customUserAgent.
- Added BlazeTrackingPixel an optional new property -
Updated
- FirstTimeSlide
- New scrolling behavior - all screen is scrollable, comparing to only
instructionssection until now.
- New scrolling behavior - all screen is scrollable, comparing to only
Removed
- BlazeMomentsAppearance
- Removed
titleproperty. You can use the new headingText and/or bodyText properties instead.
- Removed
Deprecated
-
BlazeWidgetDelegate
- onWidgetDataLoadStarted - Use BlazePlayerSourceDelegate.onDataLoadStarted instead
- onWidgetDataLoadComplete - Use BlazePlayerSourceDelegate.onDataLoadComplete instead
- onWidgetPlayerDismissed - Use BlazePlayerSourceDelegate.onPlayerDidDismiss instead
- onTriggerCTA - Use BlazePlayerSourceDelegate.onTriggerCTA instead
-
BlazePlayerContainerDelegate
- onDataLoadStarted - Use BlazePlayerSourceDelegate.onDataLoadStarted instead
- onDataLoadComplete - Use BlazePlayerSourceDelegate.onDataLoadComplete instead
- onContainedPlayerDismissed - Use BlazePlayerSourceDelegate.onPlayerDidDismiss instead
- onTriggerCTA - Use BlazePlayerSourceDelegate.onTriggerCTA instead
-
Global Delegate Methods - BlazeSDKDelegate
- onStoryPlayerDidAppear - Use BlazePlayerSourceDelegate.onPlayerDidAppear instead
- onStoryPlayerDismissed -Use BlazePlayerSourceDelegate.onPlayerDidDismiss instead
- onMomentsPlayerDidAppear - Use BlazePlayerSourceDelegate.onPlayerDidAppear instead
- onMomentsPlayerDismissed - Use BlazePlayerSourceDelegate.onPlayerDidDismiss instead
Note: BlazeWidgetDelegate, BlazePlayerContainerDelegate, and BlazePlayerEntryPointDelegate conform to BlazePlayerSourceDelegate.
0.6.8 - iOS
Date: 2024-01-11
Updated
- BlazeWidgetLayout and Widget Preset Adjustments for Image Aspect Ratios:
Now, if the image's ratio matches the item's ratio, the image will automatically try to fill the item, allowing for a true .aspectFill experience when only the aspect ratio is provided.
This enhancement ensures a more accurate and visually appealing display of images in accordance with their specified content modes. - Fix possible UI glitch in Player's First Scroll:
A minor UI glitch that occurred during the first scroll of the player has been identified and rectified. This fix ensures a smoother and more seamless user experience during the initial interaction with the player.
0.6.6 - iOS
Date: 2024-01-08
Added
- iPad support
- iPhone Player Behavior:
Portrait Mode Only: The player within the application on iPhone is optimized exclusively for portrait orientation. This design choice ensures a focused and user-friendly viewing experience in line with the common usage habits on iPhones. The landscape mode is intentionally disabled for the player to preserve the interface's visual and functional integrity. - iPad Player Behavior:
Full Orientation Flexibility: The player on the iPad fully supports orientation changes, accommodating both portrait and landscape modes. This flexibility enhances the viewing experience on the iPad, adapting to the versatile ways in which these devices are used. When the orientation is changed, the player seamlessly adjusts, continuing playback from the same position without any disruption. This feature ensures that whether the user switches from portrait to landscape orientation or vice versa, their viewing experience remains continuous and uninterrupted.
- iPhone Player Behavior:
Updated
- Improved analytics tracking and handling.
- Default Button Alignment Changed to Center: The alignment of the default player buttons has been updated to .center. This change enhances the visual appeal and consistency of the player's interface by centrally positioning the buttons, thereby offering a more intuitive and streamlined user experience.
- Removal of Default Button Insets on Fill: Previously, default insets were applied to the player buttons when using .fill alignment. These insets restricted the button images from fully extending to the edges of the button container. We have now removed these default insets. As a result, when .fill alignment is used, the button images can now expand to occupy the entire button container.
0.6.1 - iOS
Date: 2023-12-28
Added
- IMA Support
- BlazeImaHandlerEventType
- BlazeIMAHandlerProtocol
- BlazeIMAHandlerDelegate
- BlazeImaAdInfo
Updated
- Custom Native Ads
- BlazeAdsHandler renamed to BlazeGoogleCustomNativeAdsHandler
- BlazeAdsHandler.EventType renamed to BlazeGoogleCustomNativeAdsHandler.EventType
- BlazeAdModel renamed to BlazeGoogleCustomNativeAdModel
- Fix story title alignment on large fonts.
- Fix the player's initial sound state when the device is on 0 volume value.
- Removed error when widget loads without any items.
- 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.
- Optimized Video Caching Strategy: Implemented smarter video caching techniques. This change not only conserves device storage but also ensures that videos are ready to play with minimal delay, even in subsequent sessions.
- 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.
0.5.4 - iOS
Date: 2023-12-13
Changed
- Removed the corner radius from the story player.
General SDK Bug Fixes
- Share Button Bug Fixes
- Enhanced overall performance and stability.
- Conducted a series of bug fixes across the entire SDK.
Important Notes
- These updates, including design changes, feature enhancements, and bug fixes, are implemented in a manner that should not require any adaptation from the developers. All changes are backward compatible and designed to enhance the user experience without altering existing workflows or integrations.
0.5.1 - iOS
Date: 2023-12-07
BlazeStoryCtaStyle
BlazeStoryCtaStyleAdded
-
Property:
layoutPositioning- Description: Defines the layout positioning style of the CTA (Call to Action).
- Type:
CTAPositioning - Default Value:
.ctaNextToShare(if not specified)
-
Enum:
CTAPositioning- Description: Enumeration to specify the positioning of the CTA button.
- Values:
ctaNextToShare: Indicates the CTA is positioned next to the Share button.ctaBellowShare: Indicates the CTA is positioned below the Share button.
BlazeMomentsAppearance Gradient Structures - Breaking changes
BlazeMomentsAppearance Gradient Structures - Breaking changesModified
- Properties in BlazeMomentsAppearance
- Change: Updated types of
headerGradientandfooterGradientproperties. - Old Types:
BlazeMomentsGradient - New Types:
headerGradient:BlazeMomentsHeaderGradientfooterGradient:BlazeMomentsFooterGradient
- Change: Updated types of
Removed
- Structure:
BlazeMomentsGradient- Description: This struct represented the gradient configuration for moments view. It is now replaced by two specific structures for header and footer.
Added
-
Structure:
BlazeMomentsHeaderGradient- Description: Represents the gradient configuration for the moments view header.
- Properties:
isVisible: BoolstartColor: UIColorendColor: UIColor
- Initializer: Same as in the old
BlazeMomentsGradientstruct. - Extension Function:
static func headerGradient() -> BlazeMomentsHeaderGradient
-
Structure:
BlazeMomentsFooterGradient- Description: Represents the gradient configuration for the moments view footer.
- Properties:
isVisible: BoolstartColor: UIColorendColor: UIColorendPositioning: EndPositioning
- New Property:
endPositioning- Description: Defines the end positioning of the gradient.
- Type:
EndPositioningenum
- Initializer: Extended to include
endPositioning. - Enum:
EndPositioning- Values:
bottomToContainer: Gradient's bottom starts from the bottom of the container.bottomToPlayer: Gradient's bottom starts from the bottom of the player.
- Values:
BlazeStoryAppearance structure - Breaking changes
BlazeStoryAppearance structure - Breaking changesModified
- Property in BlazeStoryAppearance
- Change: Updated the type of
lastUpdateproperty. - Old Type:
BlazeStoryText - New Type:
BlazeStoryLastUpdateText
- Change: Updated the type of
Added
-
Structure:
BlazeStoryLastUpdateText- Description: Represents the style and appearance of last update text used in a story player.
- Properties:
font: UIFonttextColor: UIColortextCase: BlazeTextCase
- Default Value:
.lowercasefortextCase
-
Enum:
BlazeTextCase- Description: Represents the various text case styles.
- Values:
uppercase: All letters are capitalized.lowercase: All letters are in small form.
BlazeSDKDelegate - Breaking changes
BlazeSDKDelegate - Breaking changesModified
- Change in Method:
onEventTriggered- Old Signature:
func onEventTriggered(eventType: BlazeAnalytics.EventType, eventData: BlazeAnalytics.EventData)- Parameters:
eventType: Type of the event fromBlazeAnalytics.EventType.eventData: Data of the event fromBlazeAnalytics.EventData.
- New Signature:
func onEventTriggered(eventData: BlazeAnalytics)- Parameter:
eventData: Consolidated event data fromBlazeAnalytics.
- 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
BlazeAnalyticsparameter, streamlining the interface. - This change may affect all implementations of the
BlazeSDKDelegateprotocol, requiring updates to conform to the new method signature.
BlazeAnalytics Struct - Breaking changes
BlazeAnalytics Struct - Breaking changesOverview
- Significant updates have been made to the
BlazeAnalyticsstruct. 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.
Renaming of Enums, Structs, and Protocols - Breaking changes
Overview
- As part of the ongoing improvements and standardization in the SDK, several enums, structs, and protocols have been renamed. These changes are intended to bring more clarity and consistency to the SDK's naming conventions.
Renamed Components
Enums
-
Old Name:
CachePolicyLevel- New Name:
BlazeCachePolicyLevel - Impact: Update references to this enum throughout your codebase to use the new name.
- New Name:
-
Old Name:
ProgressType- New Name:
BlazeProgressType - Impact: Update references to this enum throughout your codebase to use the new name.
- New Name:
-
Old Name:
OrderType- New Name:
BlazeOrderType - Impact: Update references to this enum throughout your codebase to use the new name.
- New Name:
Struct
- Old Name:
CTAAction- New Name:
BlazeCTAAction - Impact: Update references to this struct throughout your codebase to use the new name.
- New Name:
Protocol
- Old Name:
WidgetDelegate- New Name:
BlazeWidgetDelegate - Impact: Update references to this protocol throughout your codebase to use the new name.
- New Name:
Important Notes
- These renamings are part of a broader effort to standardize naming across the SDK.
- It's crucial to update your code to reflect these changes to ensure compatibility with the latest version of the SDK.
- No functional changes have been made to these components, only their names have been updated.
0.4.3 - iOS
Date: 2023-11-30
Added
- RTL/LTR support.
Changed
- Analytics events trigger fixes.
- Updated analytics player triggers values
0.4.0 - iOS
Date: 2023-11-27
Added
- Geo Restrictions Support.
- Set Geo Restriction on the SDK initialize method
- Update Geo Restriction method.
0.3.9 - iOS
Date: 2023-11-22
Changed
- Updated React Native support
0.3.7 - iOS
Date: 2023-11-21
Added
- Added onWidgetItemClicked delegate to the WidgetDelegate protocol.
- Added Equitability conformance for all SwiftUI involving components.
Changed
- All properties within the analytics struct are now publicly accessible.
0.3.2 - iOS
Date: 2023-11-08
Added
- Ads support
- Added adsConfigType to widgets
- Added adsConfigType to SwiftUI widgets
- Added adsConfigType to Player Container
0.3.0 - iOS
Date: 2023-10-31
Changed iOS
- Changed the completion block in the SDK init method to be a result block instead of Error block.
- This changes the init method Please update code usage
- playStory with a pageId will always open the requested page.
- Improved UI customization for Widget items.
0.2.1 - iOS
Date: 2023-10-25
Changed
- Update delegate handler for swift UI Widgets SwiftUI - Delegate
0.2.0 - iOS
Date: 2023-10-24
Added
0.1.3 - iOS
Date: 2023-10-16
Changed iOS
- Player Improvements.
- Custom Thumbnail type support
Updated 16 days ago
