> For the complete documentation index, see [llms.txt](https://docs.firework.com/firework-for-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.firework.com/firework-for-developers/android-sdk/changelog.md).

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

### \[6.37.1] - 2026.11.16

#### Changed

* The fullscreen player activities (`PlayerActivity`, `SingleInstancePlayerActivity`, and `SeparateSingleTaskPlayerActivity`) are no longer exported, so other apps can no longer start them. If your app's manifest redeclares one of them with `android:exported="true"`, manifest merging now fails. See [Manifest merger fails for a player activity](https://docs.firework.com/firework-for-developers/android-sdk/faq-and-troubleshooting.md#manifest-merger-fails-for-a-player-activity).

#### Fixed

* Fixed a crash, `IllegalArgumentException: Cannot proceed without EmbedInstanceId!`, when a player activity was started without the launch data the SDK provides, for example by another app or a testing tool.&#x20;

### \[6.37.0] - 2026.11.05

#### Added

* Added support for apps that target Android 16 (API 36). The fullscreen player, StoryBlock fullscreen, and shopping sheets now handle Back through the AndroidX `OnBackPressedDispatcher`, which Android 16 requires. See [Targeting Android 16](https://docs.firework.com/firework-for-developers/android-sdk/faq-and-troubleshooting.md#targeting-android-16-api-36).
* Added [comment giveaways](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/livestream/livestream-chat.md#comment-giveaways) to the V2 livestream player for live broadcasts and replays. Viewers enter by commenting a keyword, and each viewer privately sees whether they won; winners get a **Claim Your Reward** link.
* Added [product viewing signals](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/shoppable-videos/product-cards.md#livestream-product-viewing-signals) ("N people are viewing ...") to the V2 livestream player during live broadcasts. A tap follows your existing product card click handling.
* Added [image overlays](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/livestream.md#image-overlays) placed by the host to live broadcasts, replays, and restreams in the V1 and V2 livestream players.

#### Changed

* Interactive elements in the V2 replay player (polls, questions, giveaways, trivia giveaways, comment giveaways, and links) now follow the livestream's [replay interaction setting](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/livestream.md#replay-interaction-setting) in Firework CMS. When the setting is off or not configured, they are hidden in the replay.
* The SDK now depends on `androidx.activity:activity` 1.6.1 or later, which requires `compileSdk` 33 or higher in your app.
* Player Deck playback is now reported to Firework analytics as Player Deck instead of carousel.

#### Fixed

* Fixed livestreams restreamed through a CDN not appearing in feeds, showing a black screen in the fullscreen player, and failing to autoplay in Player Deck. Viewers now join at the current point of the broadcast, and closed captions are shown when the source video has them.
* Fixed livestreams that use a media asset as their source not appearing before they go live. Their trailer is now shown until the broadcast starts.
* Fixed livestream subtitles and interaction timing stopping after the app returned from the background without entering PiP.
* Fixed interactions active at the start of a replay sometimes not appearing, and a failed chat history request in a replay preventing interactions from loading.
* Fixed pinned messages in restreams and V2 live broadcasts: messages the host pins during a restream are no longer replaced by pinned messages from the recording, and outdated pinned messages no longer reappear after the chat reconnects.
* Fixed a crash on Android 8.1 (API 27) when the fullscreen player made the system bars transparent.

### \[6.36.2] - 2026.10.01

#### Added

* Added [`PlayerDeckOption.cardOption`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/configuration/playerdeck-options.md#cardoption) to theme the Player Deck product panel and expanded product list, for example to match your app's light or dark mode: background, product name, product subtitle, price, discount, original price, "Sold Out", call-to-action and "Tap to Watch" text, the one-tap Add to Cart button, and the product list open/close button. Unset colors keep the current appearance.
* Added [`PlayerDeckOption.borderColor`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/configuration/playerdeck-options.md#bordercolor) to set the color of the outline around each Player Deck item.
* The Player Deck product list open and close buttons now have TalkBack labels ("Show products" and "Hide products") in all supported languages.

#### Changed

* The Player Deck button that opens the product list now has a round background like the close button, and both are the same size as the one-tap Add to Cart button. The close button has a larger touch area.

#### Removed

* Removed `PlayerDeckProductOption` and `ViewOptions.playerDeckProductOption`. They could not be configured; use `PlayerDeckOption.cardOption` instead.

### \[6.36.1] - 2026.09.29

#### Added

* Added [`StoryBlockOption.showProductCard`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/configuration/story-block-options.md#showproductcard) to show or hide product cards in the compact StoryBlock player. When it is not set, StoryBlock follows `PlayerOption.showProductCard`. The fullscreen player opened from StoryBlock continues to follow `PlayerOption.showProductCard`.
* Added [`Shopping.setCtaButtonStatusWithDefaultMessage`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/shoppable-videos/cart-and-checkout.md#sdk-default-messages) to display the SDK's localized "Added to cart" or "Failed to add item to cart" message for the product-detail primary CTA, with an option to close product details while keeping the player open.

#### Changed

* When product cards are hidden through `PlayerOption.showProductCard` or `StoryBlockOption.showProductCard`, the video's call-to-action button displayed above the product cards is now hidden as well.

### \[6.36.0] - 2026.09.24

#### Added

* Added playback speed controls (1x, 1.25x, 1.75x, and 2x) for V2 livestream replays and non-ad V2 videos at least five minutes long, when supported by the selected player.
* Added 10-second skip buttons and left/right double-tap seeking for those videos and replays.

#### Changed

* Replay chat messages and interactive events now stay in sync when viewers seek, including repeated or rapid seeks.

#### Fixed

* Fixed errors when product image data contains a missing variant ID list or null entries, including during livestream product updates.
* Fixed the V2 livestream chat keyboard sometimes failing to open on the first tap of the message input.

### \[6.35.2] - 2026.09.20

#### Added

* Added [`Shopping.setCtaButtonStatus` overloads](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/shoppable-videos/cart-and-checkout.md#cta-button-status) to display app-provided success or error messages for the product-detail primary CTA, with an option to close product details while keeping the player open.

#### Changed

* Improved viewer and like count formatting in the V2 livestream player for consistency with the web experience, including localized viewer labels.

#### Fixed

* Fixed cards occasionally remaining invisible in content-height grid feeds inside scrolling pages.
* Fixed autoplay visibility detection for content-height grid feeds inside scroll containers, including React Native hosts.

### \[6.35.1] - 2026.09.15

#### Added

* Added `BaseOption.maxItemCount` to limit content in Feed View, Player Deck, StoryBlock, and fullscreen player sessions. In `FwVideoFeedView` grid layouts, this also supports expanding to content height when the host uses `wrap_content`.
* Added custom playback artwork through `LayoutOption.playIcon` and `PlayIcon.CustomIcon` for Feed View and Player Deck. Icon size is configured separately through `playIconWidth`.
* Added opt-in one-tap Add to Cart on Player Deck product cards through `PlayerDeckOption.showAddToCart` and `Shopping.setOnDeckAddToCartListener`, with per-request loading, success, and error reporting through `DeckAddToCartRequest.setStatus`.
* Added secondary product-detail CTA styling through `ProductDetailsOptions.shoppingCtaSecondaryButtonOptions`, including background, text, font, loading indicator, and border customization.
* Added support for backend-selected product variants, including separate display items for selected variants, variant-specific product presentation, and preselected options in product details. Apps can inspect the selection through `Product.selectedUnit` and `selectedProductSKU`.
* Added navigation between multiple pinned messages in the V2 livestream chat experience, plus text and background color customization through `ChatOption.pinMessageStyle`.

#### Changed

* Improved product subtitle display across product cards, Player Deck, product lists, and product details, and aligned discount labels and selected-variant pricing across shopping surfaces.
* Product hydration now keeps selected variants and their associated shopping behavior consistent when variants are updated using the same `ProductUnit.id` values.
* Improved feed parsing and impression tracking efficiency.

#### Deprecated

* Deprecated `ProductHydrator.ProductBuilder.removeVariant()` and `clearVariants()`. Use `replaceVariants()` to update the variant list; backend-selected variants needed for display are retained even when omitted from the replacement list.

#### Fixed

* Fixed analytics callbacks being removed by R8 in minified host apps.
* Fixed missing livestream hashtags in analytics callbacks and incorrect business-store identifiers in livestream product events.
* Fixed livestream interaction synchronization when entering before a broadcast starts, and restored interaction delivery in the V1 livestream player.
* Fixed pinned-message history and update handling, duplicate coupon messages, and pinned-message background colors.
* Fixed livestream chat input and keyboard interactions, including delayed message taps dismissing refocused input, and stabilized the username dialog appearance in embedded players.
* Fixed variant-specific product highlighting, sold-out states, and coupon updates after product hydration.
* Fixed livestream replay autoplay not resuming after exiting StoryBlock fullscreen playback.
* Fixed the fullscreen player remaining open with an empty feed on startup.
* Fixed share-label alignment in the option menu and invalid-access-code feedback visibility on affected Samsung devices.

### \[6.34.4] - 2026.08.24

#### Added

* Added call-to-action details to [`VideoInfo`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/analytics.md#events-and-callback-payload) for analytics events and callbacks: `ctaLabel`, `ctaActionUrl`, and `ctaActionType`. The fields are populated for short videos and for livestream trailers, and are `null` when the content has no CTA.

#### Fixed

* Fixed live and Ad badges disappearing in `FwVideoFeedView` when feed items were rebound or a livestream status changed, and stopped Ad badges from being shown over autoplaying previews.
* Fixed a rare crash (`ConcurrentModificationException`) when a livestream feed subscription was created while the hosting widget was being destroyed. Livestreams already in replay no longer re-join the live channel, preventing spurious status downgrades.
* Fixed feed loading failures being reported with a generic message; `onError` now surfaces the actual parse error cause.

### \[6.34.3] - 2026.08.17

#### Added

* Added programmatic [`BaseOption.muteOnLaunch`](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/configuration/base-options.md#initial-mute-state) configuration for `FwVideoFeedView`, `FwPlayerDeckView`, and `FwStoryBlockView`. The component-level value overrides the global `FireworkSdkConfig.muteOnLaunch` setting when provided and falls back to the global setting when omitted. `FwVideoFeedView` item previews remain muted by design.

#### Changed

* Playlist Group fullscreen playback opened from `FwVideoFeedView`, `FwPlayerDeckView`, or `FwStoryBlockView` now inherits the component's current mute state, aligning it with other fullscreen launches.

#### Fixed

* Fixed livestream chat history not loading correctly after a trailer transitions into a live broadcast.
* Fixed Tap-to-Watch icons not rendering in Player Deck when hosted outside an AppCompat Activity, including Flutter PlatformView integrations.
* Fixed livestream playback lifecycle handling in compact `StoryBlock`, preventing hidden or backgrounded livestreams from resuming unexpectedly and keeping playback aligned with component visibility.
* Fixed livestream audio becoming unexpectedly muted during compact `StoryBlock` and fullscreen transitions.
* Fixed livestream replay pausing when entering Picture-in-Picture mode while the host app moves to the background.

### \[6.34.1] - 2026.08.11

#### Added

* Added `FireworkSdk.isInPipStateFlow`, allowing apps to observe Picture-in-Picture state changes through a `StateFlow<Boolean>`.
* Extended purchase tracking with `Shopping.trackPurchase(..., totalDiscounts)`, optional `sku` and `productName` fields on `ProductItem`, and the `ProductItem.fromSku(...)` factory.
* Added `trigger_source` to playback analytics to distinguish user-initiated playback from autoplay and other system-initiated playback.

#### Changed

* Updated the SDK target API level to Android 15 (API level 35).
* Aligned purchase event payloads with the latest analytics schema by using `order_value` and SKU-based `line_items`, and corrected client event and upload timestamps to use UTC.
* Localized PDP option names such as Color, Size, Width, Length, and Variant across supported languages, and aligned product-image carousel behavior when an image-based option changes.
* Improved option menu sizing for large fonts, landscape mode, tablets, and foldable devices.

#### Fixed

* Fixed unreliable load-more behavior in `FwVideoFeedView` and `FwPlayerDeckView` during endless scrolling.
* Fixed livestream guest usernames changing when leaving and re-entering a livestream.
* Fixed livestream chat keyboard flickering or dismissing itself on some ColorOS devices.
* Fixed edge-case player crashes on some Samsung devices during Activity and Fragment recreation.

### \[6.33.2] - 2026.07.10

#### Added

* customization option for modern product card
* Align in-stream product descricption page with other platfroms

### \[6.32.7] - 2026.06.09

#### Added

* Minor enhancement to fix crash on edge cases
* Support configuring font weight for social creator name

### \[6.32.6] - 2026.06.04

* Update hungary langugage translation
* Add onVideoLoaed callback for FwVideoFeedView/FwPlayerDeckView

### \[6.32.4] - 2026.05.25

* Fix crash issue on FwVideoFeed widget on a few edge cases
* Make enhancement for FwPlayerDeck widget

### \[6.32.0] - 2026.05.13

#### New Features

* Optimize the player parameter thresholds
* Optimize the internal view calculation logic in the player during rotation
* Support the **Chat in replay** feature
* Support adjustments to the social link text size
* Support adjusting the width and height of the video player’s product indicator

### \[6.31.7] - 2026.05.05

#### Fixed

* Disable the livestream buffering when transcription is not configured
* Fix an edge case crash when missing resource caused by spilt apk tool

### \[6.31.6] - 2026.04.30

* Minor bug fixes
* Performance enhancement

### \[6.31.4] - 2026.04.21

#### New Features

* Enhancement of the Storyblock lifecycle on the Tablayout
* Performance enhancement

#### Fixed

* Fixed a few edge cases of crash when initialization failed

### \[6.30.7] - 2026.04.07

#### New Features

* Support customized share button position on player view (`PlayerOption.shareButtonPosition`)

### \[6.30.5] - 2026.03.31

#### Breaking Changes

* `LayoutOption.showProductIcon` renamed to `showShoppingBagIcon`
  * Builder method: `.showProductIcon()` → `.showShoppingBagIcon()`

#### New Features

* Shopping Bag Icon Customization (`LayoutOption.shoppingBagIcon`)

  Added `ShoppingBagIcon` sealed class to support custom icon rendering on feed thumbnails. Two modes are available:

  * `ShoppingBagIcon.Default` — uses the built-in shopping bag icon (no behavior change from before).
  * `ShoppingBagIcon.CustomIcon(image, size)` — replaces the icon with a custom `WidgetImage`, with an optional explicit size override.

### \[6.30.4] - 2026.03.27

#### New Features

PlayerOption

* `feedCompleteAction` — Control behavior when all videos finish playing: `LOOP` to restart from the beginning, or `DISMISS` (default) to close the player.
* `isArrowButtonVisible` — Show or hide arrow navigation buttons in the fullscreen player. Default: `true`.
* `ignoreContentRatioMismatch` — Skip aspect ratio adjustment when video content ratio doesn't match the player container. Default: `false`.

StoryBlockOption

* `isArrowButtonVisible` — Show or hide arrow navigation buttons in the StoryBlock inline view. Default: `true`.

LayoutOption

* `showProductIcon` — Display a product icon overlay on feed thumbnails for shoppable videos. Default: `false`.

#### New API

FwVideoFeedView / FwPlayerDeckView

* `setOnClickFeedItemListener` — New feed item click listener with interception support. Return `true` to prevent the SDK from opening the player, or `false` to allow normal behavior.

Deprecated

* `setOnFeedItemClickListener` — Use `setOnClickFeedItemListener` instead.

### \[6.30.1] - 2026.03.05

####

* Feed level Hydration Support
* New to to handle Product Card/Product list Item click Behaviour

### \[6.30.0] - 2026.03.01

#### Added

* Player Deck Item Customization support

### \[6.29.1.1] - 2026.02.17.1

#### Fixed

* Fix an edge case crash when missing resource caused by spilt apk tool

### \[6.29.1] - 2026.02.17

#### Fixed

* Fixed a few edge cases and enhancement on startup

### \[6.29.0] - 2026.02.11

#### Added

* New Way To Handle Short Video CTA
* Player Deck Stand Version Support
* New Data Source -Channel Video Feed
* Social Link Handling on Player Deck

### \[6.28.6] - 2026.02.04

#### Enhancement

* Enhancement on autoplay view for video feeds

### \[6.28.4] - 2026.01.28

#### Enhancement

* Enhancement on leading space on feed padding configuration for carousel

### \[6.28.3] - 2026.01.26

#### Fixed

* Fix closeFullScreenPlayer api not valid on livestream/replay issue.

### \[6.28.2] - 2026.01.22

#### Added

* Video Player: Enabled seek bar for short videos/trailers with duration ≥ 300s.
* Audio Management: Auto-mute PiP player when a primary video is unmuted.

#### Fixed

* Authentication: Enhanced token refresh logic and clarified error messaging.
* UI/UX (Compose): Improved nested scroll handling for horizontal video feeds.
* Playback: Optimized autoplay behavior for video feeds in Compose.

### \[6.27.7] - 2025.12.24

#### Fixed

* Fixed issue that caused the cache to go out of range

### \[6.27.6] - 2025.12.23

#### Added

* Support hiding product card for short videos/trailer
* Support customizing loading indicator color
* Add leading space before the first player in the horizontal carousel
* Add loading indicator when open the full screen player

### \[6.27.4] - 2025.12.16

#### Fixed

* Fix the autoplay in the videofeed stops working when it’s inside a scrollable component

### \[6.27.3] - 2025.12.15

#### Fixed

* Memory issue of storyblock/feedview on edges

### \[6.27.2] - 2025.12.11

#### Added

* Support horizontal livestream player
* Support Terms and Conditions Links for Livestream Questions

#### Fixed

* Memory issue of storyblock/feedview on edges

#### Changed

* New engaged tracking logic

### \[6.26.4] - 2025.12.03

#### Fixed

* Fixed an issue causing choppy scrolling in the Product List panel.
* Fixed an issue where fragment indicator dots disappeared from the Shopping bottom sheet panel.
* Fixed an issue where FwVideoFeedView XML attributes were not taking effect.

### \[6.26.1] - 2025.11.17

#### Added

* Add [FireworkSDK.closeFullScreen()](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/firework-sdk-api#closefullscreenplayer) Api
* Add [FireworkSDK.isSdkInitialized()](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/firework-sdk-api#issdkinitialized) Api
* The thumbnail for FwVideoFeedView will pick the best-fit JPG image depending on the view’s size.

#### Fixed

* Fixed an issue in FwVideoFeedView and FwStoryblockView where some API calls returned incorrect error codes.
* Glide image loader support glide 5+

###

### \[6.25.2] - 2025.10.21

#### Added

* Support short video interactions redesign

#### Fixed

* Fixed an issue when stream from camera app the video will not load issue videos wouldn't loop when entering full-screen mode from FwVideoFeedView.

### \[6.24.2] - 2025.09.26

#### Fixed

* Fixed an issue where videos wouldn't loop when entering full-screen mode from FwVideoFeedView.
* Fixed an issue with the activity launch stack when launching from FwVideoFeedView.

### \[6.24.1] - 2025.09.17

#### Added

* Added configuration to support immersive play mode

#### Fixed

* Resolved issue where video playback progress failed to update properly when multiple widgets were present on the same page
* Fixed chat box text rendering issue where characters were incorrectly displaying from left to right instead of following proper text direction
* Fixed inability to enter PIN when accessing password-protected Video Content

### \[6.24.0] - 2025.09.04

#### Added

* Added interaction support for restream events
* Introduced access code feature for livestreams and short videos

#### Fixed

* Fixed video feed freeze issue that occurred during autoplay when scrolling, where videos would briefly get stuck

### \[6.23.1] - 2025.08.11

#### Added

* Support AI-Copilot message
* Support multiple winners in giveaway and trivia giveaway
* Support customize chat style

#### Changed

* Hide chat drop down /chat view depends on configuration
* Add more configuration option on product card

### \[6.22.3] - 2025.07.18

#### Added

* Support coupon code on livestream
* Support trivia giveaway on livestream
* Support Romanian language

#### Changed

* Optimize auto collapse logic in poll & question

### \[6.21.0] - 2025.06.05

#### Added

* Support for Swedish language
* Support for Indonesian language
* Carousel slider displayed below pinned products during livestreams
* Custom callback for clicking Giveaway Terms & Conditions links

#### Changed

* Optimized Hungarian translations

### \[6.20.0] - 2025.05.22

#### Added

* Support pinned and product order in the product list
* Add Video Engaged Event to Host App Callback

### \[6.19.0] - 2025.05.06

#### Added

* Introduced a new player design for livestream display in the header section
* Added support for enabling like count visibility on the business portal
* Improved the completion page experience when a livestream ends
* Implemented interaction behavior intercept callback functionality

#### Fixed

* Resolved an issue where giveaway results weren't displayed upon re-entering the livestream
* Addressed several minor bugs to improve overall stability

### \[6.18.1] - 2025.03.27

#### Added

* Customize the video feed item aspect ratio
* Support enable replay configure on livestream
* Support hiding products in livestream and replay
* Support history chat messages when entering the livestream

#### Changed

* Support multi-pin(Poll/Questions + Products) and Move Poll/Question entry to the top of livestream

#### Fixed

* Open the custom short video product API to all customers
* Fix text overlap

### \[6.17.0] - 2025.02.13

#### Added

* Support link interaction in livestream
* Support private messages for replay
* Support multi-pin(Giveaway + Products)

#### Changed

* Optimize the loading feed and ads logic to avoid re-fetching data when it has cache data.

#### Fixed

* Display countdown timer based on business portal configuration

### \[6.16.6] - 2025.01.21

#### Fixed

* Fixed the Ui flickers issue for poll view.

### \[6.16.5] - 2025.01.09

#### Fixed

* Fixed the issue of first livestream on the feed, which should not show a left arrow.

### \[6.16.4] - 2024.12.23

#### Fixed

* Fixed the issue of UI misalignment for the "Question" component on short videos.
* Fixed the issue where the Video does not appear when slowly scrolling the Storyblock component within a Jetpack Compose list component.

### \[6.16.3] - 2024.12.19

#### Fixed

* Crash issue on lagacy data for custom call-to-action

### \[6.16.2] - 2024.12.18

#### Added

* Horizontal Short Video Support (MS-330)
* Minor bugs fixes

### \[6.16.0] - 2024.11.21

#### Added

* New livestream play design (MS-210)
* Add setLivestreamPlayerVersion in FireworkSdk to switch player design version (MS-766)
* Open/close subtitle when there is only one subtitle (MS-775)

#### Fixed

* High-Level Bug Fixes for short video and livestream

### \[6.15.3] - 2024.11.15

#### Fixed

* Data tracking issue on livestream or replay event
* Fix crash issue when customizing share url on Flutter SDK

### \[6.15.2] - 2024.11.03

* Support customizing the share URL (MS-473)
* Support secondary CTA in in-stream PDP (MS-614)
* Add Turkish language support (MS-626)

#### Fixed

* Make Ui Element compatible with Jetpack Compose (MS-742)

### \[6.14.5] - 2024.10.22

#### Fixed

* Fix autoplay status in storyblock

### \[6.14.4] - 2024.10.16

#### Added

* Add Video analytics event callback (MS-699)

#### Fixed

* Fix Vast tracking event issue (MS-699)

### \[6.14.3] - 2024.10.02

#### Added

* Add autoplay status to short video event callbacks (MS-561)
* Support configure the background color/font color for closed captions (MS-616)

#### Changed

* Swap the position of the volume and cc icon on short video player (MS-608)
* Update accessbility service of short video (MS-610)

### \[6.14.2] - 2024.09.27

#### Added

* Support Hungary language (MS-559)

#### Fixed

* Submit button text is not in alignment with button (MS-599)

### \[6.14.1] - 2024.09.12

#### Added

* Support add/remove/replace product variants (MS-542)
* Support hide more button in player (MS-587)

#### Fixed

* Announcements are not visible in Digital Showrooms replay (MS-483)
* Duplicate messages are displayed while scrolling the progress bar in replay (MS-566)

### \[6.14.0] - 2024.08.26

#### Added

* \[Ads] Support VAST XML passed in as widget param (MS-239)
* Support autoplay setting for story block (MS-382)
* Support customizing the full screen setting for story block (MS-384)
* Support hiding ad badge for story block (MS-398)
* Support hiding player caption (MS-404)

#### Fixed

* Deal with player style inconsistencies with other platform (MS-465)
* Fix the remind me in countdown timer to camel-case (MS-207)

### \[6.13.1] - 2024.08.08

#### Changed

* Change behavior of audio route when there is already a player existing (MS-363)

#### Fixed

* Add new products to the top of the list, not the bottom on livestream (MS-350)
* Trailer video cannot auto play in full-screen player and compact story block (MS-371)
* Keep product impression/click event reporting consistent with iOS/Web (MS-428, MS-402, MS-400)

### \[6.13.0] - 2024.07.16

#### Added

* Hide/Show comments on livestream when moderator delete/restore it on biz portal (MS-11)
* Expand comments list in livestream by default (MS-6)
* Show product card and overlay CTA on compact story block (MS-7)
* Make the announcements scroll on their own during the live stream. (MS-3)
* Reduce the default modal of shopping overlay size by 50% (MS-21)
* Add OnImpression event to PlayerLifecycleAnalyticsEvent (MS-85)
* Show forward and backward arrow on full-screen player (MS-14)
* Support customizing pip icon in full-screen player (MS-18)
* Support configuring video overlay CTA to oval style (MS-20)
* Support configuring action button(Share/Cancel button) style (MS-23)
* Support ar-SA, ar-AE, es-MX, es-CO languages (MS-34)

#### Changed

* Optimize translation in multiple languages (MS-34)

#### Fixed

* Fix Chat message and poll card overlapping in replay (MS-41)
* Fix UserSentChatMessage callback invoked on wrong time (MS-42)
* Change md5 to SHA256 Hash Algorithm to avoid "weak hash Algorithm" issue (MS-193)
* Show mini-size icon by default when play or pause the video in full-screen player(MS-8)
* Fix CTA buttons are not translated in Thai (MS-33)
* Fix PDP page cannot collapse In compact story block view (MS-128)

### \[6.12.2] - 2024.06.06

#### Added

* Poll interactions result to Livestream replays (ASDK-2602)
* Accessibility prompts to the Livestream countdown timer (ASDK-2536)
* Support Thai language (ASDK-2697)
* Add videoType and liveStreamStatus for setOnFeedItemClickListener (ASDK-2695)

#### Removed

* IMA ads support (ASDK-2674)

#### Fixed

* Fix SDK will crashed on initialization when there is no meta-data configured (ASDK-2700)
* The crash which was caused by unhandled interaction type of GiveAway (ASDK-2677)
* Fix subtitle language translation (ASDK-2681)
* Fix subtitle list is showing in ALL-CAPS when opened in storyblock mode (ASDK-2634)
* A rare issue in which if the Internet connection was lost before opening the player, the Livestream would not start correctly (ASDK-2282)
* Fix prompts are not shown for title and start time in storyblock collapsed mode (ASDK-2676)
* Fix the countdown timer has heading "Live in" talkback announces "Heading" instead of "Live In" (ASDK-2675)

### \[6.11.0] - 2024.05.01

#### Added

* PlayUid param to data tracking events (ASDK-2511)
* German, Vietnamese, and Italian translations
* Livestream's "Host will be right back" feature (ASDK-1220)
* Bring back the email field to the Question interactions (ASDK-2544)
* Tracking level SDK config (ASDK-2557)
* Send VideoFinishedEvent when video is closed, swiped or its playback ended (ASDK-2600)
* Add `VideoType` parameter to `VideoInfo`, deprecate `VideoInfo.isAd` (ASDK-2601)

#### Changed

* Replace FwJson Serialization core module with FwGson (ASDK-2440)
* Change the `LivestreamAnalyticEvent` livestreamId parameter to VideoInfo which has more information (ASDK-2572)
* Make `OnProductCardClickListener.onProductCardClick` return `Boolean` which indicates if host app handles external navigation (ASDK-2577)

#### Fixed

* Product cards spacing in RTL mode (ASDK-2516)
* Setting custom image for close button (ASDK-2171)
* Arabic, Spanish, Polish, Japanese, Portuguese, and Russian translations
* The Question interactions' Answer field hint and position in RTL mode (ASDK-2578)
* Replay getting paused in PIP (ASDK-2597)
* The bug in which the Live chat emojis was visible behind interactions (ASDK-2360)
* The UI issue in which the feed in Horizontal mode in RTL had wrong spacing for the first item (ASDK-2517)
* Divide by zero crash in the autoplay player (ASDK-2607)
* Fix the chat message Username in RTL mode (ASDK-2615)
* Pinned chat message in RTL mode (ASDK-2615)

### \[6.10.2] - 2024.04.03

#### Fixed

* A bug forced to us by [the Google IMA SDK v3.32.0](https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side/history) which was [causing SingleTask Activity to be launched in their own affinities](https://groups.google.com/g/ima-sdk/c/PfAnye3Hhww/m/08N6YyFsBAAJ) (ASDK-2521)

### \[6.10.1] - 2024.03.28

#### Fixed

* Unmuting muted active livestream when user goes from PIP to fullscreen (ASDK-2512)

### \[6.10.0] - 2024.03.26

#### Added

* Add custom product card view, configuration, and `ProductCardsOptions` public API: `Default` | `Custom` (ASDK-2146)
* CTA types "SEE\_MORE" & TALK\_TO\_AN\_EXPERT
* Currency codes "VED" & "SLE"
* Livestream Provider "TWITTER"
* Possibility to make the Logo non-clickable by defining `isClickable` param in `PlayerOption` → `LogoConfig` (ASDK-2389)
* The `PipEnterError.NoPlayingPlayer` error type to PIP which indicates the player is paused (ASDK-2414)
* Tracking Livestream CountDown widget impression and "Remind Me" click (ASDK-2388)
* `ProductHydrator.isInStock()` method (ASDK-2420)
* Send `commerce:product_detail_impression` tracking event when the product detail page is shown (ASDK-2400)
* The new "Digital Showroom" feature including the gateway access code (ASDK-1742 & ASDK-1743)
* Add channelId parameter to the tracking events for the ChannelHashtag feed resource type (ASDK-2474)

#### Changed

* The `FwStoryBlockView.init`'s `showLivestreamCountDown` option is moved to `PlayerOption` as `LivestreamCountDownConfig` and now supports Light/Dark theme and applies to both fullscreen player and StoryBlock (ASDK-2385)
* Base URL to `firework.com`
* Changed behaviour of product availability in Livestream Replay. The product availability is based on the last state of the product in the Livestream (ASDK-2420)
* Kotlin version updated to 1.8.x (ASDK-2439)
* Pass `videoId` instead of `livestreamId` for analytics events related to `Livestream` (ASDK-2455)
* Pass `videoId` instead of `livestreamId` in `FeedItem` parameter of `FeedItemClickListener.onItemClick`callback (ASDK-2461)
* Call product hydration every time products are updated in the Livestream (ASDK-2463)
* Fix sending of `presentation` and `player_layout`properties in data tracking (ASDK-2433)
* Send `livestream:start_active_watch` for livestream replay (ASDK-2450)

#### Deprecated

* The `FireworkSdkConfig`'s `checksumRequired` option. (ASDK-2378)

#### Removed

* Livestream Provider "MUX"
* Livestream Replay's "Recorded" badge (ASDK-2387)

#### Fixed

* A potential bug in PicassoImageLoader which was throwing exception when the image path was empty
* A bug which `enterPip` API was returning `PipEnterError.DisabledByClient` when there was no active player (ASDK-2414)
* A bug that the PIP chevron button was not showing when StoryBlock Livestream was going back from PIP mode to fullscreen (ASDK-2352)
* The `FwVideoFeedView` memory leak caused by the `ViewImpressionsTracker` (ASDK-2319)
* Fix logic of sending `engagement:interactable_engaged_view` tracking event
* Fix `ConcurentModificationException` inside `FeedWebSocketService` (ASDK-2504)

#### Security

* A runtime crash caused by IMA library on Android 14 (ASDK-2439)

### \[6.9.3] - 2024.02.16

#### Fixed

* A regression which if player was paused, the `enterPip` API was returning inactive player error (ASDK-2412)

### \[6.9.2] - 2024.02.07

#### Fixed

* The bug that was causing a crash when the initial run was with bad/no internet connection (ASDK-2384)

### \[6.9.1] - 2024.01.26

#### Changed

* Add VideoInfo param to `onCartClick` callback (ASDK-2365)
* Add VideoInfo param to `onProductHydration` callback (ASDK-2366)

#### Fixed

* `LivestreamKeyMoment` not implementing Serializable (ASDK-2375)
* The Livestream Replay item performance issue, which was limiting the number of StoryBlocks in one page

### \[6.9.0] - 2024.01.18

#### Added

* Product key moments feature to Livestream replay (ASDK-2132)
* Logo on the Player feature and `PlayerOption` → `LogoConfig` public API: `NoLogo`|`Logo.AggregatorLogo(channelId)`|`Logo.CreatorLogo(channelId)` (ASDK-2134)
* The Livestream Count Down feature for the trailer (ASDK-2174)
* `ImageLoader` config including `CircleTransformation` (ASDK-2202)
* New CTA Action Types including: `BOOK_A_TEST_DRIVE`, `ENROLL_NOW`, `INVEST_NOW`, `RSVP`, `SEE_FULL_RECIPE`, `SHOP_RECIPE`, `VIEW_RECIPE` (ASDK-2234)
* Show the seek bar in StoryBlock and hide it when there is not much room to show it (ASDK-2244)
* The light player feature for autoplay (ASDK-2153)

#### Changed

* Respect safe area when showing custom product card (ASDK-2231)
* Expose product unit details in product card details (ASDK-2239)
* WebSocket implementation to stop channels closing each other (ASDK-2245, ASDK-2278)
* Handling invalid IVS playback URL issue and adding public API: `LivestreamError` → `InvalidPlaybackUrl` (ASDK-2273)
* Enable announcement feature in StoryBlock (#2940)
* Avoiding the 10-second blank screen which was happening when the MultiHost (low latency) Livestream was being played by the SingleHost (high latency) Livestream player (ASDK-2321)
* Video info to `Shopping` callbacks including: `onCtaButtonClick`, `onProductLinkClickListener`, and `onProductCardClickListener` (ASDK-2327)
* Expose `feedId` (a.k.a feed Embed Instance ID) for `FwStoryBlockView`, `FwLifecycleAwareStoryBlockView`, and `FwVideoFeedView` to identify an analytic event per widget and Storyblock (ASDK-2322)
* Enhanced multiple data tracking wrong or missing events

#### Deprecated

* `FireworkImageLoader` module and the host app can use `GlideImageLoader` or `PicassoImageLoader` instead (ASDK-2329)
* `FwLifecycleAwareStoryBlockView` and `FwLifecycleAwareVideoFeedView` cause they didn't do their purpose and now the host app has control over the lifecycle and can decide when to initialize and destroy the StoryBlock (ASDK-2354)

#### Fixed

* The StoryBlock Live tap to enter when the user already entered and just returns (ASDK-2189)
* Player does not honor RTL setting for the videos when Arabic language is selected (ASDK-1919)
* Showing N/A instead of original price when it is not available (ASDK-1891)
* "powered by" icon in RTL mode (ASDK-2204)
* Pausing the StoryBlock when is scrolled out of screen (ASDK-2136)
* OutOfMemory error loading stream (ASDK-2198)
* The subtitle menu in RTL mode (ASDK-1916)
* Random StoryBlock crash on destroy (ASDK-2214)
* Subtitle setting did not persist in the case when captions were turned off in system settings (ASDK-1915)
* An issue with the player not resuming onResume
* The app crashes while leaving the player (ASDK-2232)
* Duplicate items after refresh (ASDK-2247)
* The wrong product image is shown on the pinned product (ASDK-2248)
* The StoryBlock does not repeat a feed with a single element (ASDK-2249)
* The issue in username flow which renders showing "Happy Banana" on the chat input (ASDK-2245)
* the Close button wrong behavior when the video is playing in a loop (ASDK-2267)
* App crashes when a product with deep link is opened via Shop Now CTA (ASDK-2266)
* Multiple bugs related to wrong states caused by late SDK/Views initialization and introducing FireworkInitError → AlreadyInitializedError (ASDK-2242)
* Crashing the SDK when the Livestream element is missing in the feed to update (ASDK-2274)
* The issue that was preventing single-element feed from loading (ASDK-2270)
* The CTA loader in 'shop now" is not timing out after 10 seconds (ASDK-2286)
* The issue in product talkback which was not losing focus when PDP was opened (ASDK-1779)
* Product title hydration on PDP page (ASDK-2136)
* Livestream player showing the trailer in Player when the Livestream is started in StoryBlock (ASDK-2093)
* Storyblock continues to play in the background (ASDK-2297)
* Duplicates in the video feed view when clicking on the last item (ASDK-2310)
* The `KeyboardUtils` destroy before init crash (#2939)
* The “Tap to enter livestream” button is shown in the fullscreen player when the user switches to another screen and then comes back (ASDK-2293)

### \[6.8.1] - 2023.11.06

#### Fixed

* App crashes when video in the feed is not in view and PIP is playing (ASDK-2208)

### \[6.8.0] - 2023.11.01

#### Added

* Multiple pinned products in the Livestream replay (ASDK-2126)
* New log system, allowing host app to implement the `FwLogAppender` to receive SDK logs (ASDK-1644)
* Updating Livestream interactions including Polls and Questions during live (ASDK-2118)
* Add Livestream "Tap to enter" button to the compact StoryBlock and make it adjustable to the view size (ASDK-2143)

#### Fixed

* Video in collapsed mode does not pause when the kebab menu is opened after closing the fullscreen player (ASDK-2060)
* Switching trailer to live in pip (ASDK-2111)
* Crash when feed is destroyed before init (ASDK-2137)
* Setting errorListener is not working if called before `feedView.init()` (ASDK-2138)
* `FwFeedView` loading state was not sent to `FeedViewStateListener` (ASDK-2139)
* When an answered question is launched again, UI does not hide the unanswered question (ASDK-2042)
* No response when clicking the video again after closing pip (ASDK-2135)
* Fix multiple cases of memory leaks in `FwStoryBlockView`, Player, and DI (ASDK-2165)
* Player switches to the next video when returning from PIP in RTL mode (ASDK-2001)
* Two half videos are shown in PIP when video PIP window is resized in RTL mode (ASDK-2172)
* Fix "Add to cart" Arabic translation

### \[6.6.0]

* New Product card design in the short video
* Presenting a new PDP page
* Introducing a new content source for single video ID

### \[6.3.1]

* Custom VAST attributes
* Universal Link Support
* Add toast for showing AddToCartError.Timeout.message
* Support product hydration with these two options:
  * productUnit.url
  * productUnit.image.url
* Support Subtitles UI
* RMN Measurements and Tracking
* Add Poll to Livestream
* Adding questions to Livestream
* Realtime subtitles
* Adding Poll in Short Videos
* Adding Questions in Short Videos

### \[6.2.0]

* Ability to Mute Ads
* Added Mute button in the top-left corner
* ChatUX Changes
* Collapsed and Expand Modes for the Chat
* Lighter gradient in the background
* Missed messages button
* Messages fading out on the top of chat
* Drawable Gradient
* Ability to set drawable background gradient under the caption
* Manually Uploaded Posters
* Images coming from the back-end are automatically placed on the video thumbnail
* Customer Update Bug Fixes and Data Fixes
* Hashtag Playlist
* filter by hashtags
* High-Level Bug Fixes for StoryBlock and PIP
