1.20.3 - Android

Breaking changes

Widget remote identifier

Renamed widgetRemoteId to widgetRemoteIdentifier on widget init / reload paths (and related models). Update call sites to the new name. Use widgetRemoteIdentifier so content creators can configure widgets in Experiences CMS. See CMS-configured widgets and Widget initialization.

For you cold start labels

Renamed the Recommendations For you parameter from promotedLabels to coldStartLabels. Update any For you data source that still passes promotedLabels. See Implicit personalization.

Added

GAM Next-Gen module

The SDK now supports Google GMA Next-Gen SDK for Google Ad Manager banner and custom native ads, through the new com.blaze:gam-next-gen module. If you use the legacy GAM module today, migrate to GAM Next-Gen so you stay on the supported Google ads stack. See GAM Next-Gen module and the migration guide.

• What you get: the same Experiences BlazeGAM API (banner and custom native), on GMA Next-Gen
• What to change: Ad Manager app ID in the Manifest, Gradle artifact (com.blaze:gam → com.blaze:gam-next-gen), com.blaze.gam.nextgen imports, and Google ad object types if you use them directly
• Important: you can't run legacy Google Mobile Ads and GMA Next-Gen in the same app; don't keep both Blaze GAM modules

Item click thumbnail

Added BlazeWidgetItemClickParams now includes contentThumbnailUrl, the URL of the clicked item's main thumbnail (Stories, Moments, and Videos widgets). See BlazeWidgetItemClickHandlerState.

Closed captions style

BlazeCaptionsStyle for customizing closed captions in the player.

Moments likes count threshold

Added shouldPreserveLikesCountBelowThreshold on BlazeMomentsPlayerButtonsStyle.

CTA border customization

Added borderColor and borderWidth on Moments, Stories, and Videos CTA styles. See BlazeMomentsPlayerCtaStyle, BlazeStoryPlayerCtaStyle, and BlazeVideosPlayerCtaStyle.

Stories pre-roll ads

Added ads.enablePreroll on BlazeStoriesPlaybackConfiguration. When enabled, the fixed-position ad on the first page plays as a pre-roll instead of being skipped. Default is false.

Moments tabs Chrome

Added isTabTitleVisibleWhenSingleTab and activeTabIndicator on BlazePlayerTabsStyle.

Share extra info

Added extraInfo on BlazeShareParams. See BlazePlayerSourceDelegate.

Custom action button metadata

Added sdkMetadata on BlazePlayerCustomActionButtonParams .

Compose Data Source

composite to enable multiple data sources in a single call. See BlazeDataSourceType.Composite: Android

Videos player overlay auto-hide time

overlayVisibilityThreshold on BlazeVideosPlayerStyle sets how long (in milliseconds) the player controls overlay stays visible before it auto-hides. Non-positive values (zero or negative) fall back to the default. Presets keep the current default of 3000 ms.

Live streaming

The Videos player and widgets now support live video streams alongside on-demand videos. A live stream is a video that carries stream metadata, so it plays through the standard Videos player and widgets: there is no separate live player.

• BlazeVideosFilterParams (contentTypes, streamStates) controls which content types and stream states a widget or player shows. Create it with BlazeVideosFilterParams.base(), adjust the properties, and pass it to initWidget on the Videos widgets and to BlazeSDK.playVideos / BlazeSDK.prepareVideos.
• BlazeVideoContentType (VIDEO / STREAM) and BlazeLiveStreamStatus (LIVE / UPCOMING / ENDED) identify the content type and the stream lifecycle.
• Order streams with BlazeOrderType (RECENTLY_STARTED_FIRST / RECENTLY_STARTED_LAST) and BlazeAdvancedOrderType (LiveFirst).
• Style the live/upcoming/ended chip and start time on widget items with BlazeWidgetItemStatusIndicatorStyle and BlazeWidgetItemEventTimeElementStyle.

See Live streaming.

Changed

Videos multi-aspect ratio default

Default of BlazeVideosPlaybackConfiguration.multiAspectRatio changed from false to true.

Removed

Remote config data source

Removed BlazeDataSourceType.RemoteConfig. Use widgetRemoteIdentifier when you initialize the widget so content creators can configure widgets in Experiences CMS. See CMS-configured widgets.

Improved

• Widget loading performance

Fixed

Closed captions (Material 3)

Crash on CC button tap with some Material 3 versions.

Search (shared Moment)

Search unavailable when viewing a Moment from a shared link.

Search (RTL)

Search did not respect RTL / forced layout direction.