Changelog#

11.2.0 - 26/01/26#

New Features#

Added support for readOrderingMode (Basic, StartedAware) from the backend Stories responses. When StartedAware is set, rows order stories as NeverOpened → InProgress → Completed while retaining pinned/live/sort ordering. Default remains Basic for backward compatibility when the field is absent.
Added clip preloading APIs for first open to reduce initial load time for Clips collections.

Bug Fixes#

Fixed native video ads in legacy GAM starting paused with a black screen.
Fixed native image ads rendering incorrectly with landscape creatives.
Fixed Like/Mute buttons becoming unresponsive after repeated taps.
Fixed followable icon tap responsiveness on Samsung S25 devices.
Fixed followable category screen theme flicker on first open in dark mode.

11.1.0 - 07/01/26#

Breaking Changes#

Updated StorytellerTileType in onTileTapped callback:
StorytellerTileType.Story.categories changed from List<String> to List<StorytellerCategory> for richer category details
StorytellerTileType.Clip now includes a categories: List<StorytellerCategory> property

New Features#

Added support for showing Banner Ads at the bottom of the Clips Player. See Ads for more information.
Added support for Non-Skippable Ads in both Stories and Clips Players. See Ads for more information.
Added ability to hide Share/Like numbers via Settings Theme configuration
Added support for custom 'Live' chip text across Clips and Stories

Improvements#

Improved gesture zones for the Clip Progress Bar scrubbing experience
Improved Story Action Button widths to follow industry standards
Improved native video Ads duration reporting accuracy
Improved volume handling - device volume 0 is now treated as muted state
Improved theme usage for Clips buttons (primary button, For You/Following empty state button)

Bug Fixes#

Fixed tablet UI misalignment and overlapping issues
Fixed sharing a Clip from Following or navigated category opening black screen with infinite loading
Fixed excludeFromAnalytics returning false when enableStorytellerTracking and enableRemoteViewingStore are set to false
Fixed incorrect Clip displaying when swiping from viewed Clip to not viewed Clip during paging
Fixed captions state becoming inconsistent when changed on Search screen
Fixed Story Ads progress bar remaining in Ad state when navigating back from image Ad
Fixed Ad chip showing incorrectly after navigating back from Ad to Story page
Fixed shareButtonTapped events being incorrectly sent for Stories when enableStorytellerTracking is set to false
Fixed backgrounding the app breaking the reloading functionality for Stories and Clips
Fixed Following category reporting as NULL in analytics
Fixed Clip video Ads continuing to play audio when app is backgrounded
Fixed tablet Story Ads displaying Live Story chip on banner and image Ads
Fixed sound not behaving correctly in mute/vibration mode
Fixed video Ad audio continuing and mute button appearing briefly on image Story page
Fixed dynamic rows not displaying placeholders fully when wrong category/collection IDs are used
Fixed progress bar failing to scrub after network reconnection
Fixed device mute settings not updating mute state after manual toggle
Fixed deeplinks to Sheets opening with error
Fixed quiz questions being skippable without answering when opened from action or open method
Fixed mute state not updating properly when video Story opened via Search
Fixed closing animation missing when Story/Clip Player is opened from Story Action Button
Fixed Player being dismissed when bottom Sheets action is tapped
Fixed Story image Ads breaking page navigation
Fixed progress bar staying at enlarged state if recents opened during scrubbing
Fixed device volume buttons incorrectly muting standard video Ads
Fixed Instructions Screen showing incorrectly on sign out/in
Fixed most answered polls resetting after navigating between pages
Fixed video poll pages not having mute toggle
Fixed mute button briefly appearing and disappearing when skipping pages with standard Ad
Fixed bounce animation missing on single Clip scroll opened from a Card
Fixed Card with invalid collection opening a black Clip Player
Fixed share module for secondary actions not working
Fixed Following Tab empty state Action Button having no text
Fixed deep linking to Clips beyond the first 50 in a collection via URL scheme
Fixed Sheets opened from Ad actions not considering viewport property

11.0.6 - 17/12/25#

Bug Fixes#

Fixed setting the device in silence mode and voluming up doesn't sound Stories

11.0.5 - 15/12/25#

New Features#

Added full support for FireTV and AndroidTV

11.0.4 - 26/11/25#

Bug Fixes#

Fixed Embedded Clips backgrounding the app when reload button is double-tapped in navigated category
Fixed memory leaks
Fixed action buttons not opening Clip Player properly
Fixed tile animations not working after Story and Clip Player is closed in More Screen
Fixed Cards not sorting by taps correctly
Fixed clickable area for image Ads in Native Ad Clips where tapping the title area incorrectly triggered the action button

11.0.3 - 21/11/25#

Bug Fixes#

Fixed action buttons on custom native ads not responding to taps or swipe-up gestures
Fixed external links intermittently failing to open in Android WebView
Prevented the screen from dimming or turning off while watching For You/Following content

11.0.2 - 13/11/25#

Bug Fixes#

Fixed issue where standard video ads would freeze after navigating between custom image ads on Story pages

Improvements#

Moved mute button to right-hand rail in Clips player for improved UI consistency
Updated action button widths to follow industry standards - buttons no longer span full width. Button width type is now configurable via CMS and received from backend, allowing per-action customization

11.0.1 - 29/10/25#

Bug Fixes#

Fix potential crash which could occur when presenting Native Ads

11.0.0 - 22/10/25#

Breaking Changes#

Standardized public API with Storyteller prefix: All public classes now include the Storyteller prefix for consistency. Key renamings include:
UserInput → StorytellerUserInput
UserActivity → StorytellerUserActivity
Category → StorytellerCategory
Error → StorytellerError
Environment → StorytellerEnvironment
DisabledFunctionalFeature → StorytellerDisabledFunctionalFeature
UserAttributes → StorytellerUserAttributes
CustomNativeTemplateIds → StorytellerCustomNativeTemplateIds
TileType → StorytellerTileType
FollowableCategoryCustomScreen → StorytellerFollowableCategoryCustomScreen
eventTrackingOptions can now only be set during SDK initialization by passing a StorytellerEventTrackingOptions object to the initialize method. Runtime modifications are no longer supported. The property remains publicly readable via Storyteller.eventTrackingOptions. To change tracking options, you must reinitialize the SDK. See Privacy and Tracking for more information
Removed deprecated Storyteller.currentUserId method for VPPA compliance
Removed showVoteCount property from EngagementTheme for Polls
Removed show property from TitleTheme
Removed default isScrollable parameter from StorytellerClipsGrid and StorytellerStoriesGrid
Removed all VPPA-related deprecated methods

New Features#

Added support for custom context data in analytics events. Context allows integrators to provide additional analytics attribution data for Storyteller rows, grids, cards, home screens, and embedded clips. For details, see Context.
Added Progress Bar for Clips Player with scrubbing/seeking functionality and analytics events (scrubbedClip, completion type tracking)
Added Stories Captions support with CC button, enabling/disabling events, and global state persistence
Added Configurable Default Mute State with persistent mute preferences
Added Buttons for Cards with display, theming, and analytics support
Added Long Engagement Unit Answers supporting multi-line text display in Polls and Quizzes
Enhanced Following behavior with new public API methods and conditional logic based on followingFrom setting
Added automatic user attribute management for followed categories where Storyteller is handling all following logic, without the need for storing and syncing followed categories app-side. See Following Model for more information
Added Card Viewed/Tapped Ordering for improved card content organization
Added actionLinkId property to analytics events with page/clip actions
Added story/clip context properties to ad analytics events
Added adFormat support for First-Party ads in Stories
Added completionType property to finishedClip and completedLoop events
Added captionsEnabled property to all Story analytics events
Added hasButton property to all Card analytics events
Added native back button support for webview navigation

Bug Fixes#

Fixed analytics event issues including missing properties and incorrect triggers
Fixed openedCategory event not recorded when navigating back from another category
Fixed finishedClip event not sent when switching between For You and Following tabs
Fixed Story page eyebrow and timestamp overlap
Fixed action buttons not being interactable on tablets
Fixed captions not displaying correctly for long text
Fixed Story player dismissing automatically when opened from More screen on Compose
Fixed embedded clips top-level back button not working
Fixed follow state not syncing between Clips page and Followable Category page
Fixed canGoBack always returning false when navigating subcategories on Following tab
Fixed theme not applying to rows/grids on bottom sheet
Fixed numerous For You/Following tab navigation and reload issues
Fixed clip ads sometimes switching shortly after appearing
Fixed various UI issues with Stories, Clips, and Ads players

Improvements#

Improved accessibility support for large font sizes
Enhanced ad preloading for Clips
Improved theme handling and persistence
Updated public interface standardization across iOS and Android platforms

10.13.10 - 02/10/25#

Breaking Changes#

Added new parameter offset to StorytellerClipsDataModel, StorytellerStoriesDataModel, ListConfiguration see StorytellerListViews.md and StorytellerLists.md

Bug Fixes#

Fixed tiles reload behavior
Fixed Clips duplications
Disabled custom params when ad tracking is disabled

10.13.9 - 24/09/25#

Bug Fixes#

Fixed tiles not auto-reloading properly
Fixed audio focus not being requested when unmuting
Fixed incorrect grid display limitations
Fixed text font styling issues in Clip player

10.13.8 - 09/09/25#

Bug Fixes#

Fixed double calling of onDataLoadCompleted callback
Fixed placeholders not hiding when item count is 0
Fixed inApp action not opening properly
Fixed webView opening issues

10.13.7 - 27/08/25#

Bug Fixes#

Fixed an issue with onDataLoadCompleted returning incorrect data count

10.13.6 - 25/08/25#

Bug Fixes#

Fixed crashes when theme is null in Embedded Clips

10.13.5 - 18/08/25#

Improvements#

Improved support for privacy flags

Bug Fixes#

Fixed crashes when swiping through stories

10.13.3 - 14/08/25#

Improvements#

Improved support for privacy flags

10.13.2 - 11/08/25#

Bug Fixes#

Fixed black screen appearing randomly when scrolling fast between Clips
Fixed order of navigation elements for category navigation inside Clips
Fixed Clip looping issue when swiping to next clip during PTR animation
Fixed OpenedClip event issues
Fixed DismissedClip event issues
Fixed OpenedCategory event not being recorded when opening Clips Player via category methods
Fixed DismissedCategory event missing properties when returning using back button
Fixed FinishedClip event issues
Fixed Banner/Native Ad action triggering when fast skipping pages
Fixed mute state issues with device volume changes after muting from category navigation
Fixed collectionClipCount always being 0 for Muted/unmuted events in FY/F collections
Fixed Title and Eyebrow alignment when Mute toggle enabled
Fixed like status/share number not resetting after PTR or Reload if staying on same clip
Fixed duplicate Clip Ad requests for the initial index
Fixed missing adIndex property on ad events
Fixed followable category screen when opening it on tablet landscape
Fixed share/like issues when respective features disabled
Fixed crashes when swiping through stories
Fixed skippedAd and finishedAd events triggered without ad display when skipping clips quickly
Fixed followable category screen appearing on Clip Ads
Fixed Share and Action Buttons shifting downwards when swiping through Stories
Fixed Eyebrow text positioning with different theme settings
Fixed category title ellipsis display on Clip player
Fixed DismissPlayer event timing issues
Fixed crashes when opening StorytellerEmbeddedClipsFragment (XML)

New Features#

Added adIndex KVP support for Stories and Clips when requesting Ads

Improvements#

Updated FollowableCategory Status request with per-category granularity

10.13.1 - 07/08/25#

Bug Fixes#

Fixed if search is remotely disabled in the CMS, the search button still appears on Clips

10.13.0 - 30/07/25#

Breaking Changes#

Added onTileTapped callback to StorytellerListViewDelegate for enhanced tile interaction tracking, see StorytellerDelegates
Relaxed public openDeepLink method activity requirement from AppCompatActivity to Activity for better compatibility

New Features#

Clips Player is now rewritten fully in Compose for better performance and user experience
Added support for For You/Following tabs for Clip Rows and Grids
Added Mute Toggle functionality for Stories and Clips with comprehensive analytics see Analytics:
Added muted/unmuted events for Stories, Clips, and Ads
Added isMuted property to all Story, Clip, and Ad analytics events
Added Followable Category Limits feature with analytics events, see Analytics:
Added Followable Category Limit Shown event
Added Followable Category Limit Action Tapped event
Added Followable Category Limit Dismissed event
Added Story Eyebrow and Clip Eyebrow support
Added Independent Configuration of Analytics Features, see PrivacyAndTracking
Enhanced Ad Placement Algorithms for Stories and Clips
Added metadata filed to analytic events

Bug Fixes#

Fixed multiple issues related to previous Clip Player implementation based on Android Views
Fixed multiple issues related to For You/Following Tabs navigation and behaviour
Fixed multiple issues related to the Clips playback
Fixed Story/Clips player action buttons to properly listen to theme.buttons.textCase configuration

10.12.1 - 10/07/25#

Breaking Changes#

Updated Kotlin version from 1.7.20 to 1.9.0

10.12.0 - 30/06/25#

New Features#

Added new option to Event Tracking Options called enableRemoteViewingStore for VPPA compliance. See PrivacyAndTracking for details.

Improvements#

Cards are now using Activity instead of AppCompatActivity

Bug Fixes#

Fixed Cards video background freezing when backgrounding and foregrounding
Fixed issue with Storyteller Lists height
Fixed Sheets being dismissed automatically when rotating the device on tablet
Fixed handling of intent:// redirects inside the internal WebView
Fixed crash when opening Clips with Secondary Actions
Fixed CardViewed events not triggering for Cards with image backgrounds
Fixed rare crash in GAM module for Custom Native Ads

10.11.0 - 16/06/25#

Breaking Changes#

Implemented VPPA compliance measures including SHA256 hashing for User IDs for requests and removal of Content Id from ad requests. See PrivacyAndTracking for details.
Deprecated Storyteller.currentUserId method as part of privacy enhancements. See Users for updated user management methods.
Added enableFullVideoAnalytics flag to eventTrackingOptions for granular video analytics control. See Analytics for details.

New Features#

Introduced Cards feature - a new content type that can be displayed alongside Stories and Clips with full theming support, personalization, targeting, and analytics. See Cards for event details.
Added Secondary Actions support for both Stories and Clips, allowing multiple action buttons per content item. See Analytics for additional fields added.
Cards support video playback based on visibility and include comprehensive analytics events (Card Tapped, Card Viewed). See Analytics for event details.
Enhanced analytics with new properties for Secondary Actions and Cards integration. See Analytics for complete event documentation.

Improvements#

Added methods to retrieve count of clips in a collection and number of Stories in categories. See AdditionalMethods for details.
Enhanced Embedded Clips to support their own custom themes. See StorytellerClipsFragment and Themes for details.
Added analytics event for 'Story Instructions Screen Viewed'. See Analytics for details.
Improved poll vote count display with per-poll configuration support
Added support for custom tab titles in For You/Following tabs. Configurable via CMS
Improved VPPA compliance by removing direct user identifiers from various API requests. See PrivacyAndTracking for details.

Bug Fixes#

Fixed live story progress bar jumping issues on single-page stories
Resolved clip playback getting stuck when navigating between categories
Fixed search functionality issues including keyboard behavior and story navigation. See Search for details.
Corrected chip positioning for live clips and ads
Fixed deep linking issues for clips and stories. See DeepLinking for details.
Improved pull-to-refresh behavior across different screens
Fixed tablet-specific layout issues including timestamp positioning
Resolved various analytics event property issues. See Analytics for updated event documentation.

10.9.5 - 29/05/25#

Bug Fixes#

Fixed an issue where external app links were not opened correctly with ST internal WebView
Fixed an issue where edge to edge layouts were not correctly supported on Android 15+

10.9.4 - 24/04/25#

Bug Fixes#

Fixed an issue with onDataLoadCompleted returning incorrect data count
Fixed an issue where disabling theme.tiles.title.show property could cause Round Storyteller Lists to disappear

10.9.3 - 18/04/25#

Bug Fixes#

Fixed an additional issue with opening a deeplink using externalId

10.9.2 - 15/04/25#

Bug Fixes#

fixed open a deeplink with externalId

10.9.1 - 10/04/25#

Improvements#

added collectionClipCount property to Clip Ad analytics events to reflect the total number of Clips in the Collection, see Analytics for more details

Bug Fixes#

updated the Constraint Layout dependencies to avoid NoMethodFoundError crashes

10.9.0 - 6/04/25#

Breaking Changes#

Compose BoM dependency updated to 2024.12.01
The openDeepLink method now requires an AppCompatActivity instead of an Activity. Please update your calls accordingly. See DeepLinking for more details.

New Features#

Introduced Sheets, a new way to display web content within the SDK experience. Sheets can be triggered via action buttons or opened directly. See AdditionalMethods and DeepLinking for details.
Added analytics events for OpenedSheet and DismissedSheet. See Analytics.

Improvements#

Added support for respecting Ad Tracking Preferences in the Storyteller SDK and GAM Module. See PrivacyAndTracking for details.
Ensured the clipIndex property on Clip analytics events correctly reflects the index within the overall Collection when using Paging.
Corrected the calculation and reporting of the durationViewed property in analytics events.
Addressed memory leaks related to Sheets and the Story Pager.

Bug Fixes#

Fixed an issue where the progress bar could disappear on native page ads when tapped quickly.
Fixed a bug preventing muting a story via the volume button if it was previously unmuted.
Resolved an issue where old content briefly flashed after unfollowing a team/category from the clip player and refreshing.
Fixed search results not updating to an empty state when modifying a valid search term to an invalid one.
Corrected behavior where unfollowing items in the "For You" tab did not update the "Following" tab.
Fixed video playback resuming from the stopped point instead of restarting when navigating between video and image pages.
Resolved an issue where the clip player could continue playing audio in the background after pressing the device back button.
Fixed deep links with a correct page ID but incorrect story ID failing to open the player.
Fixed story page elements being removed after viewing native image ads.
Addressed an issue where the first clip ad might appear later than the configured frequency.
Made captions enablement a user-specific setting rather than device-wide.
Fixed crashes related to ConstraintLayout dependencies.
Fixed a crash that could occur on the "More" screen within a clip collection.
Resolved a clip mismatch issue after viewing a "Not Viewed" clip via search.
Fixed users being unable to close Sheets with a swipe gesture over the WebView area.
Corrected status bar icon visibility when Sheets are opened in light mode.
Addressed issues with video page requests not completing in specific environments.
Fixed an issue where tapping the first clip thumbnail opened the wrong clip player if all clips on the initial page were already read (Paging).
Fixed the story player freezing when opening a story while a specific video type (Game Recap) was playing.

10.8.0 - 11/03/25#

Breaking changes#

Adding bottomSheetScreen functionality. StorytellerDelegates section

Note that if you are not using this functionality then simply return the default value for this method in your Delegate implementation.

New Features#

Added Clips Paging functionality to Clips Player to improve performance and user experience
Adding support for deep-links via external ID URLs

Improvements#

Updated collectionClipCount property on Clip analytics events to be the total number of Clips in the Collection
Added clipIndex property to all Ad analytics events and captionsEnabled to all Clips analytics events
Improved ad loading performance and preloading logic
Improved loading behavior for embedded Clips.
Updated behavior for deep links with Clips Paging functionality

Bug Fixes#

Fixed a crash occurring when fast-swiping between Clips.
Fixed an issue where Clip progress was not saved when the app was backgrounded.
Fixed incorrect event logging for deep-linked Clips.
Fixed an issue where multiple search filter menus appeared when tapping quickly.
Fixed an issue with inconsistent font rendering on certain devices.
Fixed an issue where users could not tap to go to the next page if it was a page ad.
Fixed an issue where the first tap after reopening a paused native ad was not responsive.
Fixed playback getting stuck when navigating and skipping too fast.
Fixed a lifecycle bug where sound plays when the app is swiped to the background.
Fixed an issue where a shared quiz link navigates the user to the end of the quiz results instead of the beginning.
Fixed an issue where Stories tiles could not be set to round on Compose screen.
Fixed incorrect event property for clipsViewed event on Clip Close events.
Fixed an issue where dismissing a story with a CTA button does not auto-reload that story.
Fixed an issue where PTR stops working on clips after multiple fast PTR attempts.
Fixed an issue where followable category screens send two identical paging requests.
Fixed an issue where tapping on a clip while swiping to the followable category screen was possible.
Fixed an issue where auto-scroll occurred while the player was open and the app was backgrounded.
Fixed an issue where the store action button was not opening the Play Store.
Fixed playback issues after category navigation.
Fixed issues with search displaying incorrect or incomplete results.
Fixed an issue where playback was stuck when opening a page ad.
Fixed an issue where category navigation opens a black screen with the sound of the previous clip.
Fixed an issue where opening a clip from the followable category screen freezes the page.
Fixed an issue where a grey line appeared on image poll answers.
Fixed an issue where swiping to other embedded clips got stuck with a reload button.
Fixed an issue where sound continued playing after dismissing a clip on the search/category screen.

10.7.6 - 27/02/25#

Bug Fixes#

fixed an issue with crash when rotating Embedded Clips on Samsung tablets

10.7.5 - 31/01/25#

fixed an issue with a wrong position for Clip captions
fixed some issues with Ads which resulted in content being cut on some devices
fixed issue with insets handling on Android 15 for internal WebView

Bug Fixes#

fixed insets for both normal clips and embedded clips for both xml and compose implementations
fixed issue where Link to open Story without Page Id fails

10.7.4 - 16/01/25#

Bug Fixes#

fixed insets for both normal clips and embedded clips for both xml and compose implementations
fixed issue where Link to open Story without Page Id fails

Improvements#

reloadData() method on StorytellerEmbeddedClips has no effect when embedded clips is on the custom followable category screen
added missing theme handling for gradient when using from infix methods for circular tiles

10.7.3 - 24/12/24#

Bug Fixes#

fixed a bug with SHARE_SUCCESS event not being sent when sharing a Clip

10.7.2 - 20/12/24#

Improvements#

dismissPlayer method now has an optional onCompletion callback that is called when the player is dismissed. Please, see the Additional Methods for more details

10.7.1 - 19/12/24#

New Features#

Enabled displaying the exact number of tiles per row on various screens. Please, see the visibleTiles property in the "Setting categories and collections, applying themes and styles" section of the StorytellerCompose for more details.
Enabled changing the text casing for "Navigating Stories" header on the Instruction screen. Please, see theme.instructions.headingTextCase Themes for more details.
Implemented custom fonts for the Instructions screens headers. Please, see theme.instructions.headingFont Themes for more details.
Added support for chip borders. Please, see the updated section Themes for more details.

Bug Fixes#

Fixed some issues related to working with themes for Row.
Fixed the shareSuccess event not being sent on Android 10.
Fixed a crash on Storyteller rows.
Corrected search visibility in Clips when disabled.
Fixed missing key-value pairs in the request for GAM Ads.
Ensured Clip events are sent correctly when opened from a category or search screen.

10.7.0 - 10/12/24#

Breaking Changes#

Added customScreenForCategory() to StorytellerDelegate for handling custom followable category actions. StorytellerDelegates.md
Added useCustomScreenForCategory() to Storyteller for allowing the developer to conditionally show the custom screen for a specific category or default. StorytellerDelegates.md

Note that if you are not using this feature you can simply return the default return values for these delegate methods.

Bug Fixes#

Fixed issue where pausing required multiple clicks.
Resolved a bug preventing tablet ads from rendering correctly.
Fixed crash occurring in stories.
Addressed issue where old content briefly displayed after following/unfollowing a team.
Fixed bug where the "Following" tab showed user content after logout.
Resolved issue with custom native and client ads not resetting progress correctly.
Fixed incorrect calculation of Poll & Quiz results.
Analytics events:
Fixed nextClip and previousClip event issues.
finishedClip event now includes correct clip information when dismissing a category.
Fixed issue where tapping the left side of the first story closed it.
Resolved crash when clicking on two clips simultaneously.
Removed live chip from the search page.
Fixed "Not found" message incorrectly appearing on the search page.
Actions for followable categories now work correctly.
Fixed top-level back button functionality.
Addressed issue where the refresh button briefly appeared for a loading clip.
Disabled the search button when the search field is empty.
Collection name inputs are now trimmed correctly.
Resolved issue where banner ads occasionally missed the Google "i" icon.
Fixed clip grid on the search page not scrolling to a dismissed clip.
Fixed GAM analytics inside the Storyteller Ads Module.
Fixed KVPs for Banner Ads inside the Storyteller Ads Module.

New Features#

Added resumePlayer() to Storyteller for resuming the player after pausing. AdditionalMethods.md

Improvements#

Live clips now resume from their current live position when viewed again.
Story rows behavior aligned with disabled Read/Unread ordering.
Added fallback to Story ID when a page cannot be found.
Updated captions to include a CC logo with a toggle option.
Set default font sizes for Stories, Clips, and Singletons in the Storyteller Home theme.
Clips now pause automatically on the clip player when an action is triggered.
Improved caching logic for Stories and Clips.

10.6.5 - 22/11/24#

Bug Fixes#

fix deprecated Modifier.animateItemPlacement and replaced with Modifier.animateItem

10.6.4 - 1/11/24#

Bug Fixes#

fix for sound playing on double back click on followable categories

10.6.3 - 25/10/24#

New Features#

add isLive and collectionClipCount fields to analytic events, see Analytics for more details

Bug Fixes#

fixed an issue with Native Ad impressions not being reported in StorytellerGamModule
fixed a crash which could potentially happen when using hardware keyboard in Search screen

10.6.2 - 22/10/24#

New Features#

new signature for StorytellerGamModule.init method, which allows using different Ad Units, see Ads for more details

Bug Fixes#

fixed issue with potential crash when resuming CLips player
fixed issue which could cause ANR when launching the App using cold start

10.6.1 - 10/10/24#

Bug Fixes#

fixed multiple issues with playback stuck on For You / Following
fixed an action button not working for the empty Following screen

10.6.0 - 8/10/24#

Breaking Changes#

Compose Bom dependency updated to 2024.09.03

New Features#

Added For You / Following feature to our embedded clips
Added auto reloading support to our lists

Improvements#

Some of our theme parameters can be configured from CMS
Updated our theme parameters documentation
Fixed standard banner ads not displaying on Tablets
Fixed a crash due to reorder animation issues
Video playback improvements
Video and Image preloading and caching improvements
Added Swipe gesture to dismiss Category screen

Bug Fixes#

fixed a crash which could occur when doing PTR on Embedded Clips
fixed a UI glitch for Native ads
fixed a bug where the Search screen was reloaded after closing the Player
fixed UI glitches on Category screen
fixed dismissedAd being sent for Stories on the Search/Category screen

10.5.1 - 10/09/24#

Improvements#

Ads will restart the video if the last action was play or idle
Introduced new tracking of ads when they are looped/repeated or Action buttons are tapped.
All add type events now include advertiser name

Bug Fixes#

fixed wrong use of googleAdsResponseId in ad tracking
fixed an issue where the incorrect cursor color was used in the search bar
fixed an issue where page ad events are also triggered when swiping down
pageActionType is now included for all types of ads and their analytic events
story ads analytics are correctly referred to as video instead of image
fix incorrectly laid out banner ads

10.5.0 - 3/09/24#

New Features#

added support for Standard ads GAM Google Ads Manager
introduced Storyteller Gam module StorytellerGamModule. It can be used to facilitate the integration of native ads into the Storyteller SDK so that the adverts are injected between the stories and clips. see Ads for more details
added Storyteller.module list during initialization to enable the native ads feature. see StorytellerModule for more details

Improvements#

added support for keyboard navigation for categories in the Clips player
buttons have been added to expand and shrink both the title and category lists
improved the animation of closing the player so it's less noticeable
improved keyboard focus handling within Search
aligned the embedded Clips play button to match the normal Clips play button
improved text input and keyboard responsiveness in search for Samsung devices
improved accessibility descriptions for the Clips player

Bug Fixes#

fixed a bug where it was possible to trigger requests to the API before the SDK was initialized
fixed a bug where navigation was possible to the same category in the category list
fixed a crash that could occur when opening stories from a story list
fixed a stack overflow crash for tablets when changing orientation
fixed broken layout for large titles and category lists on tablets and phones
fixed a bug where the live chip would be shown as read before it's clicked
fixed a bug where No results found would not show when tapping on the search button
fixed an issue where the gradient on an asset had a delay on reload

10.4.1 - 9/08/24#

Bug fixes#

fixed a crash that could occur when rendering a Row or Grid with animations enabled

10.4.0 - 8/08/24#

New Features#

added support for Accessibility adherence according to WCAG 2.1 standards
added support for keyboard navigation in the Stories and Clips player

Improvements#

added talkback announcements when navigating between Stories and Pages
improved all accessibility elements for all elements in Stories
upgraded the HTTP/1 protocol to HTTP/2 for better performance and security
enabled the re-order animations by default in themes please see theme.lists.animateTilesOnReorder Themes for more details
improved the alignment for labels and headings between ios and android
improved accessibility bypass/skip blocks for the Stories and Clips player
added error state when search fails to load
reduced load of dependency graph by deferring some dependencies initialization
improved animations for Stories and Clips
improved preloading of category thumbnails inside Clips

Bug fixes#

fixed analytic discrepancy issues (double clicks being ignored or filtered out)
fixed various mislabeled accessibility elements (action buttons, titles, images, Polls and Quizzes)
fixed preloading of poll videos not cancelling
fixed android back button not interacting correctly
fixed infinite loading or no loading at all in search
fixed a bug for followable categories where you cannot follow or unfollow
fixed a bug where sound is playing in the background
fixed a bug where sound is not playing when you return to the app
fixed a bug where images would not load or preload in wrong order
fixed a crash related to android 8.0.0+ devices
fixed a bug where poll videos would not play after coming back to the app
fixed a bug where Dismissed Reason was missing in Story Closed event
fixed a bug where previous search results were shown after multiple queries
fixed a bug with excessive space between title and categories in the Clips player
fixed a bug where "New" chip on Clip tiles would appear and disappear when opening the Clips player
fixed a bug where Story player would freeze after putting app into background
fixed a bug where sound would not stop playing when going between image and video pages in Stories
fixed a bug where pull-to-refresh on embedded Clips could stop playback
fixed a bug where there would be a flash on search screen during orientation change
fixed a bug where Story row inside search screen would appear after a delay
fixed a bug where search input in dark mode still had light mode style
fixed a bug where followable category screen would miss a "star" icon

10.3.0 - 15/07/24#

New Features#

lists can now reload in an animated fashion, controlled by the animateTilesOnReorder flag in the Theme.
Storyteller Home can now have a fixed UI Style set

Improvements#

standardizing Clips and Stories Player present/dismiss transitions
improved loading sequence when the tiles are appearing on the screen to feel smoother
improving the Accessibility experience of the Player
made clarifications around how the User ID is used within the SDK
organized the docs for the Open Player methods
improved loading time of the lists in Compose
improved Search and Categories screens in Compose

Bug fixes#

fixed issue with the Theme not applied when opening Search
fixed issue with Story Playback mode in Analytics
fixed issue with the title gradient not appearing in square tiles
fixed crashes related to opening Quizzes and Polls
fixed View Model crash when accessing from a detached fragment

10.2.3 - 5/07/24#

Bugfixes#

fixed a crash which could occur when try to open story from deep link, but story is not available

10.2.2 - 3/07/24#

Bugfixes#

fixed a crash which could occur when reloading the row with Quizzes

10.2.1 - 27/06/24#

Improvements#

when an empty String is passed for UserInput in Storyteller.initialize(...) the default user will be used

10.2.0 - 24/06/24#

New Features#

added new liveChip properties to rectangularTile the theme, see Themes for more details
added new fade loading effect for images in rows and grids when transitioning from placeholder to the actual image
added support for linking to a specific clip within the moments tab including correct analytic events surrounding this
exposed the property canGoBack from embedded clips to allow querying about the possibility of going back in the embedded clip collection, see StorytellerClipsFragment for more details
added support for initial Category within the openCollection method, see Additional Methods for more details
added support for initial category for the deep links. Via the query param categoryId you can specify the initial category to open, see DeepLinking for more details
added support for initial category for embedded clips. see StorytellerClipsFragment for more details

Breaking Changes#

renamed theme.player.liveChipImage to theme.player.liveChip.* that contains textColor, image, backgroundGradient, and backgroundColor properties for better customization, see Themes for more details
removed theme.tiles.rectangularTile/circularTile.liveChip.textColor in favor of theme.tiles.rectangularTile/circularTile.liveChip.readTextColor and theme.tiles.rectangularTile/circularTile.liveChip.unreadTextColor, see Themes for more details

Bugfixes#

fixed an issue where backButton was not visible when navigating from a category to home then back to Moments
fixed an issue with multiple filter menus appearing when fast tapping on search filter button
fixed an issue where where action buttons shift incorrectly on Moments screen/tab
fixed various alignment issues & animations & theming issues across the SDK (Followable categories, Moments, etc.)
fixed a bug where the after killing the app and reopening, the theme resets
fixed playback issues while navigating
fixed analytics issues where nextCategory and previousCategory is sent instead of openedCategory and dismissedCategory
fixed bug where stories would close when navigating and trying to show an advert
fixed playback gets stuck when navigating & skipping too fast
fixed a lifecycle bug where sound plays when app is swiped to background
fixed a crash when swiping fast between moments and pressing home immediately afterwards
fixed an issue with search filters on tablets, filters sheet was half visible
fixed an issue with first party ads deep-links were not working
fixed a potential crash with first party ads
fixed stuck playback when opening a page ad
fixed a glitch with embedded clips header shifting on tablet layouts (samsung devices) when opening the share dialog
fixed an issue with square tiles that made title gradient flash when navigating between screens

10.1.5 - 10/06/24#

Bugfixes#

fixed an issue where the round tile title can be cut off in Compose

10.1.4 - 5/06/24#

Bugfixes#

fixed an issue with NPE crash which could happen when dismissing a Clip before video loads in StorytellerClipsFragment

10.1.3 - 5/06/24#

Bugfixes#

fixed an issue with NPE crash which could happen when opening the Stories Player
fixed an issue with ANR which could happen when initializing the SDK
fixed an issue with Stories crashing due to ConcurrentModificationException

10.1.2 - 23/05/24#

Bugfixes#

fixed an issue with Stories crashing due to ConcurrentModificationException

10.1.1 - 17/05/24#

Bugfixes#

fixed an issue with playback not starting for StorytellerClipsFragment
fixed an issue with the StorytellerClipsFragment playback not starting after reloading the container screen

10.1.0 - 16/05/24#

New Features#

added support for First Party Ads
added support for gradients for Circular Tiles, see Themes for more details

Improvements#

improved content preloading for faster playback

Bugfixes#

fixed an issue with the Row blinking on Tablets
fixed an issue with PreviousClip analytics event
fixed an issue where CompletedStory analytics event was not sent for single Paged Stories
fixing an issue with the filters on Search screen
fixing an issue with wrong theme applied when navigating between categories in StorytellerClipsFragment
fixing an issue where the long version of the title was used instead of the short one for the Circular tiles
fixing an issue where multiple Page Ads could be added in the same slot
fixing an issue where sometimes No Results Screen was not shown correctly in Search
fixing an issue where Clips could sent an error to delegate while reloading the content

10.0.3 - 27/05/24#

Bugfixes#

fixed an issue with Stories crashing due to ConcurrentModificationException (backport from 10.1.2)

10.0.2 - 09/05/24#

New Features#

added compose implementation for embedded clips the StorytellerEmbeddedClips composable, see StorytellerClipsFragment for more details

Bugfixes#

fix an issue for stories where the player is dismissed when the user navigates to search from stories
fix an issue where grid columns could be mixed when recycled

10.0.1 - 03/05/24#

Breaking Changes#

reloadData() for embedded clips will take you back one level if not on the top level of the collection. se Reload Data in StorytellerClipsFragment for more details
fixed an issue with tileSpacing where it was applied twice, so make sure to adjust your theme if you were using 2x tileSpacing value

New Features#

introduced setLocale method to the Storyteller.user object to set the user's locale, see User Customization for more details

Bugfixes#

fixing an issue with clips subtitles can disappear when tapping the share button
fixing the missing search-specific analytics parameters for Stories
fixing an issue with the tile shrinking animation when the player is closed
fixing an issue where action buttons were not working on subsequent screens
fixing an issue with action button could crash the app when tapped after opening category details screen
fixing an issue where clips playback could be stuck after opening a story from category details screen
fixing an issue with embedded clips where swiping left to open category details might not work while on the first clip
fixing an issue with embedded clips reloading, back arrow can be still visible when it should not

10.0.0 - 18/04/24#

Breaking Changes#

deprecated xml view params removed in favour of StorytellerListConfiguration, see StorytellerStoriesView or StorytellerClipsView for more details
added an additional method categoryFollowActionTaken to StorytellerDelegate, see StorytellerDelegate for more details
isRefreshing parameter for Composable Lists has been replaced with state.reloadData() method, see StorytellerCompose for more details

New Features#

introduced Followable Categories, enhancing user interaction and engagement by allowing users to follow/unfollow categories. For more details, please see User Customization
StorytellerListViews now make use of ComposableViews which improve performance, see StorytellerStoriesView or StorytellerClipsView for more details
introduced Captions support for Clips
various Performance improvements for Lists scrolling and Tile loading

Bugfixes#

fixing some UI issues when navigating categories inside Clips
fixing issue with scrolling to the top of the list after reloading data
increased rounded corners default Theme value to 8
fixing data reloading and scrolling for Composable Lists
added missing empty state for Search
fixed sound playing before navigation screen opens
fixed issue with previous play card visible when doing PTR on Clips
fixing analytic events and data for Clips, Search, Ads and Stories

9.13.4 - 10/04/24#

Bugfixes#

fixing a bug where Storyteller.dismissPlayer was ignoring animate parameter

9.13.3 - 8/04/24#

Bugfixes#

removed unused flag from manifest

9.13.2 - 2/04/24#

Bugfixes#

added R8 rule for StorytellerHomeFragment to prevent obfuscation

9.13.1 - 2/04/24#

Bugfixes#

aligned the cornerRadius theme property for the Stories action buttons and Onboarding

9.13.0 - 29/03/24#

New Features#

added StorytellerHome support, see StorytellerHome for more details
added better support for configuring privacy and analytics events, see Additional Methods for more details

Bugfixes#

fixed an issue where Clips were started with a small delay
fixed an issue where Stories action buttons were not respecting cornerRadius theme property
fixed an issue in Compose where background was not properly resized for Live/Read/Unread chips

9.12.1 - 27/03/24#

Bugfixes#

fixed an issue where openedReason could be wrong when opening Clips/Stories player via a deep link
fixed an issue where the shareSuccess analytics event was not sent when sharing a Clip
fixing an issue where Storyteller.openStory was not emitting openedStory
fixing a black screen issue when opening not existing Clip collection

9.12.0 - 18/03/24#

Improvements#

added itemTitle and actionText to action analytic events, see Analytics for more details
changed Storyteller.currentUser to be Storyteller.currentUserId
gradient mask increased on the tiles for better readability

Bugfixes#

fixed a bug where the wrong link was used for email sharing
fixed a bug where it was not possible to correctly alignment for Compose tiles
fixed handling of custom live chip in Compose
fixed an issue where it was possible to get onFailure callback when onSuccess was already triggered for Storyteller.initialize
fixed handling of the custom theme images in Compose

9.11.0 - 8/03/24#

Improvements#

added support for handling share on action buttons

9.10.0 - 28/02/24#

Improvements#

analytics improvements: added missing fields, fixed some events

Bugfixes#

fixed a bug with the placement field was set incorrectly for AdRequestInfo
fixed a bug where the search icon was visible when CLip Player loading failed
fixed and improved multiple areas of Analytics
fixed a bug where the image title was visible in Clips player on Ads
fixed a bug where filtering by content type was not working in Search
fixed a bug where the Search button was not working when using keyboard
fixed Compose list views where it was possible to see viewed/not viewed badges on Clips even when they were turned off in the CMS

9.9.2 - 21/02/24#

Bugfixes#

fixed a bug with the SHARE_SUCCESS event not having correct data and sometimes not being sent

9.9.1 - 02/02/24#

Improvements#

improved accessibility support for the player so that it announces player content without saying page 3x times

Bugfixes#

fixed a bug where Clips player was opening slowly after a delay and sometimes not opening at all
fixed a crash which could occur when opening the Clips player at a very edge case scenario

9.9.0 - 31/01/24#

New Features#

added 'Viewed/Not Viewed' status indicators for Clips, improving content tracking for users
removed support for round tiles in xml StorytellerClipListViews, streamlining the design
implemented sortOrder handling for Clips, offering better content organization
if enableReadUnreadOrdering is set to false for stories, New chips are now hidden for both read/unread statuses, ensuring a cleaner UI

Bugfixes#

fixed the order inconsistency between list and embedded Clips, enhancing the user experience
resolved the issue where Clips ordering was incorrect and ensured that Pull-to-Refresh (PTR) maintains the correct order
addressed the issue where the new chip did not disappear if the clip was watched on Search, ensuring consistent UI behavior
fixed the issue where like and share options were removed after reloading on embedded clips, maintaining feature availability
resolved the issue where, after a second PTR, read clips would become unread again, ensuring consistent read status
fixed the issue where the gray background remained static for a few frames for clips, polishing the visual experience

9.8.4 - 11/01/24#

New Features#

Embedded Clips has a new property bottomInset which can be used to set the bottom padding for the Clips Player, please see Inset Management section in StorytellerClipsFragment for more details
Storyteller has a new property isSearchEnabled which can be used to check if the search is enabled for the current tenant, please see Additional Methods for more details
added accessibility support for Embedded Clips, Search, Instructions and Compose

Bugfixes#

fixed an issue with round tiles layout in Compose
fixed an issue with StorytellerListViewDelegate methods are sometimes not triggered
fixed an issue to remember start clip id even if reload reorders clip data in embedded clip

Breaking Changes#

Storyteller Themes are accepting now resource ids for Fonts and Drawables using helper functions, see Themes for more details

9.8.3 - 13/12/23#

New Features#

added support for StorytellerClipsViewControllerDelegate inside StorytellerClipsFragment, please see StorytellerClipsFragment

Improvements#

improved Round tiles in Compose
improved PTR support for StorytellerClipsFragment

Bugfixes#

fixing an issue with not working StorytellerDelegate when the hosting activity is closed
fixing an issue with CompletedStory not being sent when the user is on the last page

9.8.2 - 1/12/23#

Bugfixes#

fixing an issue with Compose round tile titles

9.8.1 - 24/11/23#

Bugfixes#

fixing read/unread Stories order in Player
the top bar in Clip Player is now fixed
fixing default height constraints for Compose rows
fixing deep link handling for Stores/Clips when ids that are passed are wrong

Breaking Changes#

Storyteller Themes are accepting now resource ids for Fonts and Drawables only, see Themes for more details

9.8.0 - 9/11/23#

New Features#

rewritten StorytellerListViews fully in Jetpack Compose, please see StorytellerCompose for more details
Clip collections are not looping on StorytellerClipsFragment anymore (user cannot advance from last to first Clip), please see StorytellerClipsFragment

Breaking Changes#

Compose versions of StorytellerListViews do not use controllers anymore, please see StorytellerCompose for more details
updated Compose BoM dependencies to 2023.10.01

9.7.7 - 29/11/23#

Bugfixes#

fixing a crash which could occur when dismissing Clips player

9.7.6 - 14/11/23#

Bugfixes#

fixing a crash which could occur when opening Clips or Stories player

9.7.5 - 9/11/23#

Bugfixes#

fixing a crash which could occur when using PTR on the Embedded Clips

9.7.4 - 8/11/23#

Bugfixes#

fixing an issue with displayLimit when same category is used in multiple places
fixing an issue with wrong count format of Clip Likes inside the player
fixing an issue with Stories/Clips Player close animation

New Features#

added support for reloadData() and PTR for StorytellerClipsFragment, please see StorytellerClipsFragment for more details

9.7.3 - 18/10/23#

Bugfixes#

fixing a crash which could occur when navigating to the Embedded Clips via a deep link

9.7.2 - 16/10/23#

New Features#

Storyteller now supports Android 14
upgraded Android Gradle Plugin from 8.0.2 to 8.1.1

9.7.1 - 9/10/23#

Bugfixes#

fixing an action button issue for Clips

New Features#

added top level back button handling for Embedded Clips, please see StorytellerClipsFragment for more details

9.7.0 - 29/09/23#

Bugfixes#

fixing an issue with the Clip Player header image
fixing an issue where th instructions screen was not shown when changing the orientation
fixing memory leaks in Story Player

New Features#

added openCategory method, please see Additional Methods for more details
added openStoryByExternalId and openClipByExternalId methods, please see Additional Methods for more details
added pageTitle parameter to analytic events, please see Analytics for more details
added fixed order rows mode for Stories which can be set up via the CMS
added pinned stories support for Stories which can be set up via the CMS

9.6.0 - 18/09/23#

Improvements#

updated top and bottom shade gradient for Clips
more/less button displayed below the categories list for Clips
improved sorting of Stories lists

Bugfixes#

fixing a bug where the Story close animation had a low quality
fixing memory leaks in the Clips/Stories player

9.5.0 - 30/08/23#

New Features#

added support for Page Ads which appear between Pages

Breaking Changes#

changed signature of ad delegate from getAdsForList to getAd, please see Ads for more details
changed classes inside StorytellerAdRequestInfo, StoryInfo and ClipInfo are now single class IntemInfo, please see Ads for more details

Improvements#

added adPlacement to analytics, please see Analytics for more details

Important#

Please note that the Storyteller SDK is now distributed via CloudRepo. Please see GettingStarted for more details. MyGet repository is not working anymore
The only change required is to add the following maven repository to your project's build.gradle file and MyGet can be removed:

 maven { url 'https://storyteller.mycloudrepo.io/public/repositories/storyteller-sdk' }

9.4.0 - 15/08/23#

New Features#

added support for Clips Category Navigation to the Clips Player

9.3.1 - 1/08/23#

Improvements#

improved performance of loading Story tile images

9.3.0 - 24/07/23#

Breaking Changes#

Composable views are part of the main SDK. Please refer to the StorytellerCompose documentation for more details.
instead of setting params on Android views (which are now marked as deprecated), StorytellerListViewConfiguration object was introduced. Please see StorytellerClipsView and StorytellerStoriesView for more details.
Composable views are now also using StorytellerListViewConfiguration object. Please refer to the StorytellerCompose documentation for more details.
some class names related to Ads were changed:

Old class	New class
`ClientAd`	`StorytellerAd`
`TrackingPixelClientAd`	`StorytellerAdTrackingPixel`
`ClientAction`	`StorytellerAdAction`

Improvements#

better scroll position handling for the Row views
improvements for Composable view performance

9.2.2 - 4/07/23#

Improvements#

added better support for Video and Image pages between Quiz pages

9.2.1 - 19/06/23#

Bug fixes#

fixed an issue with sharing Clips

9.2.0 - 13/06/23#

New Features#

added support for embedding the Clips Player as a fragment, see StorytellerClipsFragment

Improvements#

changed underlying image loading library to Coil to improve image loading performance
improved open/close transition animations
removed StoryCategory and ClipCategory classes in favour of Category class

Bug fixes#

fixed a problem with init spikes in the storyteller initialisation process
fixed a problem with a previous story thumbnail being visible when navigating stories quickly
fixed a problem with updating the read status of stories
fixed a problem with closing the instructions screen by tapping anywhere on the screen

9.1.7 - 6/06/23#

Bugfixes#

fixed a crash which could appear when inflating the views
fixed a return animation issue from the tiles

9.1.6 - 23/05/23#

Bugfixes#

fixed a bug where ads are not cleared when the Player is dismissed

9.1.5 - 18/05/23#

New Features#

Storyteller.user.setCustomAttribute now accepts only String values, see User Customization

Bugfixes#

fixed a bug where the Page action could be triggered by a swipe up even if it had no action set

9.1.4 - 16/05/23#

New Features#

Ad indicator added to the Clips player

9.1.3 - 11/05/23#

New Features#

adType param added to UserActivity, see Analytics
changed definition of ClipsAdRequestInfo, see Ads

9.1.2 - 04/05/23#

Bugfixes#

fixed a bug with dependency injection that might affect unit tests

9.1.1 - 02/05/23#

Bugfixes#

fixed a bug with proguard rules for AGP 8.0

9.1.0 - 01/05/23#

New Features#

live clips are here.
added Live indicator to the Clips tile and the Clips player
implemented during live stream behaviour
implemented before/after live stream behaviour

Bugfixes#

fixed pager scrolling glitch on clips when having two clips
fixed gray button appearing on Quiz summary when share button is turned off in theme
fixed a potential crash which could occur when sending Storyteller to the background

9.0.1 - 17/04/23#

Improvements:

added support for Stories ordering by category

Bugfixes:

fixing an issue with unit tests
fixing an issue with the Clips title image not appearing
fixing a crash which could occur when navigating the Stories inside a grid
fixing a a crash which could occur when navigating to a previous story

9.0.0 - 6/04/23#

Improvements:

added support for Ads between Clips
performance improvements for Clips Player
added support for setting custom attributes for Storyteller requests
improved image preloading performance for Story and Clip tiles
removed deprecated tileBecameVisible, getAdsForList methods

Bugfixes:

fixing a bug where the Story tiles were not loaded immediately when scrolling StorytellerListView
fixing a bug where StorytellerListView was not scrolled to the beginning after reloading the data

Breaking Changes:

removed support for category on Clips and collection for Stories
changed getAdsForList callback to better support Clips and Story Ads, see Ads
introduced a better class hierarchy for the StorytellerListView classes:

StorytellerListView
├── StorytellerStoriesView
│   ├── StorytellerStoriesRowView
│   └── StorytellerStoriesGridView
└── StorytellerClipsView
    ├── StorytellerClipsRowView
    └── StorytellerClipsGridView

for more information please check the StorytellerListView documentation.

8.5.11 - 12/12/23#

Bug Fixes:

fixing an issue with not working StorytellerDelegate when the hosting activity is closed

8.5.9 - 3/04/23#

Bug Fixes:

fixing a rare crash which could occur when the player is recreated

8.5.8 - 27/03/23#

Improvements:

introduced different thumbnail sizes for better story and clip previews

8.5.7 - 14/03/23#

Bug Fixes:

fixed a bug where a Video analytic event was not sent on time

8.5.6 - 2/03/23#

Bug Fixes:

fixed a bug with gestures which could appear when moving the app to the background and pressing on a Story.
fixed a bug where the video would not start after opening a Story from a deep link
fixed a crash that could occur when there is a large number of tiles in the StorytellerListView

8.5.5 - 20/02/23#

Bug Fixes:

fixed a bug that was causing the onboarding process to appear every time the application was initialized
fixed a bug where the ads created by the GAM were not properly animating upon closing

8.5.4 - 15/02/23#

Bug Fixes:

fixed a bug where category parameters were not being set for Story, Clip and Ad analytics events
fixed a bug that was causing the ad chip to not be displayed for Client ads

8.5.3 - 10/02/23#

Bug Fixes:

fixed a bug with setting an empty user id (null) during Storyteller initialization
fixed a bug with a video playing under the instructions screen
fixed a bug with the Stories player layout
fixed a bug with the opening transition

8.5.2 - 2/02/23#

Bug Fixes:

fixed a bug with wrong openedReason set for Clips analytics

8.5.1 - 30/01/23#

Bug Fixes:

fixed a crash which could occur on Android versions lower than 10

Improvements:

improvements to the close transition handling

8.5.0 - 19/01/23#

Breaking changes:

SDK Repackaging was done to organise the code better. Please update Storyteller imports.

Old class	New class
`com.storyteller.domain.StorytellerListViewCellType`	`com.storyteller.domain.entities.StorytellerListViewCellType`
`com.storyteller.services.Error`	`com.storyteller.domain.entities.Error`
`com.storyteller.domain.AdResponse`	`com.storyteller.domain.entities.ads.AdResponse`
`com.storyteller.domain.ClientStory`	`com.storyteller.domain.entities.ads.ClientStory`
`com.storyteller.domain.ListDescriptor`	`com.storyteller.domain.entities.ads.ListDescriptor`
`com.storyteller.domain.UserActivity`	`com.storyteller.domain.entities.UserActivity`
`com.storyteller.domain.UserActivityData`	`com.storyteller.domain.entities.UserActivityData`
`com.storyteller.domain.UserInput`	`com.storyteller.domain.entities.UserInput`
`com.storyteller.domain.ClientAd`	`com.storyteller.domain.entity.ads.ClientAd`

Bug Fixes:

fixed a bug with onPlayerDismissed callback
fixed a bug with onDataLoadComplete callback
fixed a bug with Video from previous story playing in background
fixed bugs with some parameters not set for the analytic events

Improvements:

added topInset and bottomInset to grids - - please see Themes for more details
added better support for open/close transitions using activityReentered method

8.4.0 - 16/12/22#

Bug Fixes:

fixed a bug with the loading spinner on Clips
fixed rare bug with Story transitions
fixed a bug that causes Quiz Pages to be answered when tapping back
fixed an animation bug with Story tiles

Improvements:

improvements to the prefetching of Clips' playcard image
implemented a more efficient UserActivity reporting system
corrected the use case of thumbnails and playcards
implemented single ExoPlayer to improve video playback

8.3.4 - 21/12/22#

Bug Fixes:

fixed a bug with dismissPlayer on Clips

8.3.3 - 21/12/22#

Bug Fixes:

added Clip Collection and Clip Categories event data for all Clip analytic events

8.3.2 - 21/12/22#

Bug Fixes:

Skipped Ad events are now recorded when tapping on an ad and swiping left on an ad

Improvements:

added Current Category to the event data for Story and Ad analytic events

8.3.1 - 15/12/22#

Improvements:

added support for multiple font weights
replaced SHARE_TAPPED event with SHARE_BUTTON_TAPPED for event consistency between Stories and Clips

8.3.0 - 06/12/22#

Bug Fixes:

fixed bug when a user taps outside a Story border on Quizzes
fixed default value for answeredMessageTextColor
fixed bug with presenting rounded corners on Stories
fixed bug with tracking pixels

Improvements:

added additional properties to ad events to help identify individual ads
improvements to the positioning of Action buttons
modified the getAdsForList callback to provide more ad information
adjusted the timestamp property so timescales are updated for each new Page

8.2.9 - 29/11/22#

Bug Fixes:

implemented a solution for a shared animation bug on Android 5 to Android 9 when targeting singleInstance activity

Improvements:

stability improvements

8.2.8 - 25/11/22#

Bug Fixes:

fixed bug with Live Chip properties
fixed bug with onCurrentVideoPlayerChanged event
fixed bug that could cause a NullPointerException
fixed bug that could cause a Story to not be marked as read when quickly switching Pages

8.2.7 - 22/11/22#

Bug Fixes:

fixed bug with Stories not opening in Single Story mode when using deep links
fixed bug with user activity reports with Stories launched via deep link
fixed bug that causes delegates to be disconnected in certain instances
fixed bug with opening Clips whilst reloading data

8.2.6 - 15/11/22#

Bug Fixes:

fixed rare crash when opening player

8.2.5 - 11/11/22#

Bug Fixes:

fixed bug with Story playback when tapping quickly through Stories
fixed bug that could cause rare adapter crash
fixed bug with video playback when changing user

Deprecations and Changes:

ads are now requested after every Story to align ad call logic with iOS SDK

8.2.4 - 04/11/22#

Bug Fixes:

fixed bug that could cause the same Story to play after ad insertion
fixed bug that could cause rare crash after opening webpage links
exposed classes needed to support React Native

8.2.3 - 01/11/22#

Bug Fixes:

fixed bug that could cause crash when changing Page whilst the player is being closed
fixed bug that could cause tracking events to be started incorrectly

Improvements:

reduced memory footprint to improve playback
stopped empty or failed items appearing in StorytellerHomeView on rare occasions
implemented improved retry policy

Deprecations and Changes:

removed all open methods from StorytellerListViews to just leave static methods

8.2.2 - 25/10/22#

Bug Fixes:

fixed rare crash when opening player

Improvements:

improved logging

8.2.1 - 21/10/22#

New Features:

implemented preloading for Stories and Clips
added support for selective Story caching for Story rows

Bug Fixes:

fixed bug with the opening animations of Trivia Quizzes
fixed bug with fetching ads after using airplane mode
fixed bug with video playback getting stuck
fixed bug with view model that could cause Story crashes

Improvements:

improved analytics handling
improvements in handling of DeepLinkManager
improvements in data use cases

8.2.0 - 11/10/22#

New Features:

added support for Clips and Collections

Bug Fixes:

fixed bug that delays dismissing of an opened Story
fixed inconsistencies with theme.engagementUnits.poll.answeredMessageTextColor
fixed bug with theme.player.liveChipImage and theme.primitives.cornerRadius on Poll answers and Story Action buttons
fixed bug that could cause Story to freeze when tapping fast
fixed bugs with fresh tenants swiping up on an ad and closing ads
fixed swipe down animation bug
fixed bug with preview transitions on tablets
fixed bug that could cause user to move to a Story row instead of a Story when closing web

Improvements:

added refresh button to Story videos
new and improved mechanism for batch ad handing, audio manager focus handling, events and callbacks
improved handling of media sharing
new and improved mechanisms for analytics and opening Story/Page IDs
performance improvements for Stories and Clips loading times
adding theme theme.tiles.rectangularTile.unreadIndicator.textSize
making all tile themes respect UiStyle for all tile types
open/close shared transition handling improvements

8.1.15 - 26/10/22#

Bug Fixes:

fixed a bug where it wasn't possible to select files inside the Action Web View

New Features:

added support for External Action Links

8.1.14 - 17/10/22#

New Features:

added the ability to open a clip or collection directly using the openCollection method

8.1.13 - 21/09/22#

Bug Fixes:

fixed option to save Story assets from a Story not displaying correctly

8.1.12 - 01/09/22#

Bug Fixes:

fixed Story sharing issue between iOS and Android
fixed Quiz sharing issues

8.1.11 - 24/08/22#

Bug Fixes:

fixed occasional crash when closing player
fixed reload button visibility not working

Improvements:

renamed Storyteller.isPresentingStory to Storyteller.isPlayerVisible

UI Changes:

improving the Story Player UI on tablet

8.1.10 - 19/08/22#

Bug Fixes:

fixed issue of duplicate apps when share sheet opens
fixed issue where a Page with a Poll plays audio from the previous Page after sharing
fixed issue of Poll sharing only working if the Poll has been answered and shared from another Android device
fixed issue of video playback not playing on Video Poll after watching a Video Page
fixed issue where the SHARE_SUCCESS event was not sent

Improvements:

improving the Story Player UI
improving the share sheet

UI Changes:

navigation buttons added back into Stories
status bar visible in Stories

8.1.9 - 12/08/22#

Bug Fixes:

fixed an issue where the share button could be cropped on smaller devices
fixed issue of grid being cropped on navigation to more Stories
fixed an issue where a placeholder could be briefly visible after close animation is finished

Improvements:

improved audio focus handling on Android API < 26 (Oreo)

New Features:

added contentLength parameter for analytics events - please see Analytics for more details

UI Changes:

general UI refinements for Story Tiles and Story Player
ensured all grid tiles have corner radii

8.1.8 - 11/08/22#

Bug Fixes:

fixing some minor issues with the tile layouts

Improvements:

improving the audio focus handling when the Story Player is open

8.1.7 - 05/08/22#

Improvements:

update client ads getAdsForList public api
improve polls UI

8.1.6 - 02/08/22#

New Features:

add support for circular tile border theming
add support for circular tile custom live chip theming

8.1.5 - 02/08/22#

Bug Fixes:

fix a crash caused by triggering web action button
improve story player UI
fix row/grid displayLimit not working for placeholders

8.1.4 - 27/07/22#

Bug Fixes:

fix row/grid placeholders styling for light/dark modes

Improvements:

improve light/dark mode theme compatibility

8.1.3 - 25/07/22#

New Features:

add support for multiple row/grids with the same categories

8.1.2 - 25/07/22#

Bug Fixes:

fix bug where sometimes no Stories could be shown when categories are set

Improvements:

improve performance or rows/grids inside recycler views

8.1.1 - 22/07/22#

Bug Fixes:

fixing a rare crash which could occur when tapping on a web action button
fixing an issue where the share button for Polls was misaligned

UI Changes:

improving the layout of the round Story tile items

Deprecations and Changes:

removing topInset and bottomInset from grids

8.1.0 - 13/07/22#

Improvements:

improving the video playback experience

8.0.3 - 11/07/22#

Bug Fixes:

fix bug where live chip was incorrect for read/unread story tiles
fix inconsistent round tile sizes for varying lines of title text
fix title text alignment in round tiles

8.0.2 - 28/06/22#

Bug Fixes:

fixing an issue where it was possible for a progress indicator to stay on a Poll page
fixing an issue where the live chip was not aligned correctly on a tile
fixing an issue with lists.grid.columns in theme

8.0.1 - 24/06/22#

Bug Fixes:

fixing an issue with R8 and the SDK package name
fixing an issue where it was possible for video playback to not start when viewing a video Page
fixing an issue where it was possible for Stories not not be marked as Read
fixing an issue where it was possible for video playback to start in the background
fixing an issue where it was possible for video playback to freeze unexpectedly
fixing an issue where it was possible for the instructions screen to layout incorrectly
fixing an issue where it was possible for the share button to not be clickable in certain scenarios

Improvements:

improving the performance of the Story Player

New Features:

adding the ability to enable/disable Storyteller event tracking via the SDK method enableEventTracking() and disableEventTracking - please see Additional Methods for more information
adding action buttons instead of swipe ups for Stories
adding displayLimit parameter to StorytellerListView - please see Configuring a StorytellerListView

UI Changes:

improving the UI for Polls and Quizzes

Deprecations and Changes:

renamed callbacks in StorytellerListViewDelegate - please see Implementing StorytellerListViewDelegate Callbacks

7.1.0 - 29/04/22#

Bug Fixes:

fixing an issue with the instructions screen UI

New Features:

adding support for Live Stories
adding additional attributes to support Live Stories theming - please see Custom Themes for details

UI Changes:

improving UI/UX experience in Story Player

7.0.3 - 12/04/22#

Bug Fixes:

fixing a dependency clash with Koin library

7.0.2 - 0/04/22#

Bug Fixes:

fixing an issue with ReactNative

7.0.1 - 04/04/22#

Bug Fixes:

fixing an issues with quizzes and theme colors
fixing an issue where the UiTheme had obfuscated name

7.0.0 - 01/04/22#

Bug Fixes:

fixing an issue where is was possible foe the new indicators to appear on placeholders
improving the category caching for faster load times
fixing a crash which could occur on initialization
fixing an issue where it was possible for the global delegate not to register
fixing an issue where it was possible for the share button to disappear after swiping up on a Story

Improvements:

making it easier to define a custom theme - please see Themes for details

New Features:

adding support for Trivia Quizzes

6.2.0 - 25/02/22#

Improvements:

improved support for multiple StoryListViews inside a RecyclerView

6.1.4 - 14/03/22#

Bug Fixes:

fixing an issue with the navigation for the video pages on Android 12

6.1.3 - 08/03/22#

Bug Fixes:

fixing a crash which could occur on the open/close story animation
fixing an issue with the primaryTextColor
fixing a crash which could occur when opening the web link

6.1.2 - 23/02/22#

Bug Fixes:

fixing obfuscation issues

6.1.1 - 23/02/22#

Bug Fixes:

fixing an issue with the reloading of the stories list
fixing an issue with the story tiles flickering when reloading

Improvements:

improving the story tile resizing

Deprecations and Changes:

pagesViewedCount is public again

6.1.0 - 16/02/22#

Bug Fixes:

fixing an issue with navigation which could occur when ads are enabled
fixing an issue with poll vote calculations
fixing a bug where the story list tiles were not updated properly on older Android versions
fixing an issue with the colors from the theme not being applied properly for StorytellerListViews

Deprecations and Changes:

uiStyle parameter moved to StorytellerListView (see here for more details Configuring a StorytellerListView

6.0.2 - 07/02/22#

Bug Fixes:

fixing obfuscation issues

6.0.1 - 03/03/22#

Bug Fixes:

fixing an issue which could occur when opening a story when in the landscape orientation
fixing a crash which could occur on the open/close story animation

Improvements:

improving the poll UI
improving the UI on the devices with notch

6.0.0 - 17/01/22#

Improvements:

Improving the scaling behavior of story tiles
Improvements and bugfixes in how themes are handled

New Features:

Added StorytellerGridView
Adding the ability to override the theme on a per list basis

Deprecations and Changes:

Public API breaking changes:
package com.storyteller.ui.row renamed to com.storyteller.ui.list
StorytellerRowViewDelegate renamed to StorytellerListViewDelegate
StorytellerDelegate's getAdsForRow renamed to getAdsForList
StorytellerRowView's insetRight and insetLeft renamed correspondingly to insetStart and insetEnd
Theme class' property row renamed to list
RowViewTheme class renamed to ListViewTheme
StorytellerRowViewCellType renamed to StorytellerListViewCellType
StorytellerRowViewStyle renamed to StorytellerListViewStyle
OpenedReason's enum value STORY_ROW_TAPPED renamed to STORY_LIST_TAP, tracking string story_row_tapped renamed to story_list_tapped
StoryPlaybackMode's enum value ROW renamed to LIST, tracking string: row renamed to list

5.0.8 - 08/02/22#

Bug Fixes:

fix for race conditions in case of rapid onPause/onResume scenarios

5.0.7 - 31/01/22#

Bug Fixes:

fixing a potential issue which could occur when running unit tests with Storyteller

5.0.6 - 25/01/22#

Bug Fixes:

fixing dependency issues

5.0.5 - 03/01/22#

Bug Fixes:

fixing a concurrency issue

5.0.4 - 15/12/21#

Bug Fixes:

fixing a crash which could occur when skipping through the pages fast

5.0.3 - 14/12/22#

Bug Fixes:

fixing a crash which could occur when invoking Storyteller.initialize multiple times

5.0.2 - 02/12/21#

Bug Fixes:

fixing a bug with the user activity data parsing

Deprecations and Changes:

removing all jcenter() dependencies

5.0.1 - 24/11/21#

Bug Fixes:

fixing a UI glitch where the initial story page could be shown when switching between the pages
fixing a crash which could happen when using delegates, configureSwipeUpWebView(...) is now mandatory to override
fixing a bug which could occur when using Storyteller ads

5.0.0 - 18/11/21#

Improvements:

improving sending of analytics events

New Features:

adding support for categories
adding support for opening the story player in single story mode without the StorytellerRowView - please see AdditionalMethods for details
adding additional param storyPlaybackMode to analytics events - please see Analytics for details

Deprecations and Changes:

splitting StorytellerListViewDelegate into two separate delegates - please see StorytellerDelegate and StorytellerListViewDelegate for details
removing the cellScale parameter from the StorytellerRowView in favour of auto adapting to the parent's view height
removing callbacks from the reloadData() method

4.5.11 - 03/11/21#

Bug Fixes:

fixing a crash which could occur when sharing the story on Android 12

4.5.10 - 02/11/21#

New Features:

adding additional method configureSwipeUpWebView(webview: Webview, url : String?, favicon: Bitmap?) to allow additional configuration of the WebView - please see StorytellerListViewDelegate

4.5.9 - 20/10/21#

Bug Fixes:

fixing a crash which could occur when opening the story and scrolling the row in a container

4.5.8 - 13/10/21#

Bug Fixes:

fixing a problem with ads and navigation
fixing a UI issue with the rounded corners on tablets

4.5.7 - 30/09/21#

Bug Fixes:

fixing a potential clash with resource names
fixing a crash which could occur when using a malformed swipe up url

4.5.6 - 24/09/21#

Bug Fixes:

fixing Windows build issue originating in the kotlinModule compilation artifact containing characters disallowed in windows filesystem

4.5.5 - 13/09/21#

Bug Fixes:

fixing a bug where the swipe up to in_app links was not working

New Features:

adding additional method openDeepLink(String,Boolean,(Error) -> Unit) to make Storyteller SDK integration easier - please see AdditionalMethods and Deep Linking
adding secondaryColor property to themes - please see Themes for details

4.5.4 - 31/08/21#

Bug Fixes:

fixing a bug where the story could not be closed if the delegate was not set
fixing a bug where the poll percentages could show invalid values when the orientation is changed
fixing a rare crash which could occur when opening poll stories

Improvements:

deep linking documentation update - please see Deep Linking

4.5.3 - 11/08/21#

Bug Fixes:

fixing a packaging issue

4.5.2 - 11/08/21#

Bug Fixes:

fixing a bug where the poll answers could be cut on some devices

New Features:

adding additional method isStorytellerDeepLink(String) to make Storyteller SDK integration easier - please see AdditionalMethods

4.5.1 - 06/08/21#

Bug Fixes:

fixing a tablet bug where the story player could be frozen when changing orientation

4.5.0 - 05/08/21#

Improvements:

minor performance improvements

4.4.2 - 03/08/21#

Bug Fixes:

fixing a bug where the COMPLETED_STORY event could be triggered too early

Improvements:

improving the story tile loading states

4.4.1 - 28/07/21#

Improvements:

improve in app swipe up handling

New Features:

add animated parameter for openPage and openStory public methods

4.4.0 - 21/07/21#

Bug Fixes:

fixing a bug which could occur when updating the story with new pages
fixing a UI issue with the instructions screen which could appear on some smaller tablets
fixing a bug where the story could be opened multiple times

Improvements:

resources can be used to set the theme properties - please see Themes for details

4.3.3 - 06/07/21#

Bug Fixes:

fixing a crash which could occur during the preload of images

4.3.2 - 02/07/21#

Bug Fixes:

added another fix for crash caused by connection timeouts
fixing a bug where the swipe ups were sometimes not working

4.3.1 - 02/07/1#

Bug Fixes:

added a fix for crash caused by connection timeouts

4.3.0 - 01/07/21#

Bug Fixes:

fixing a crash which could occur when using custom ads
fixing a bug where the poll answers could start flickering

Improvements:

improving the page loading states

4.2.0 - 10/06/21#

Improvements:

internalizing the Exoplayer 2.14.0 to remove any version conflicts with the client applications

New Features:

adding support for themes - please see Themes for details
adding additional methods to make Storyteller SDK integration easier - please see AdditionalMethods

4.1.3 - 14/04/21#

Bug Fixes:

fixed a bug where the poll video could be played after changing the page
fixed a crash which could occur when changing the orientation on tablets

Improvements:

improved poll UI and animations

4.1.2 - 02/04/21#

Bug Fixes:

fixed an issue with tile animation being clipped

UI Changes:

extended the page duration when a user selects poll answer
improved poll UI and animations

4.1.1 - 24/03/21#

Bug Fixes:

fixing a bug where the navigation on poll pages could stop working

Improvements:

improving the network request format

4.1.0 - 19/03/21#

Bug Fixes:

fixing a crash which could occur when sending analytics
fixing a bug where the instructions modal button could appear too low on tablets
fixing a bug where the story player could be closed when navigating through the stories which were read

Improvements:

improving the poll UI

4.0.5 - 01/03/21#

Bug Fixes:

fixing a crash which could occur when opening a story

Improvements:

improving the animation when swiping between stories for Android 11 devices

4.0.4 - 15/02/21#

Bug Fixes:

fixing a crash which could occur when opening a story from a deep link

4.0.3 - 11/02/21#

Improvements:

improving the preloading of videos on poll pages
improving sharing to different apps

4.0.2 - 04/02/21#

Bug Fixes:

fixing a crash which could occur when closing the story view
fixing a bug where changing the rowScale property on the Storyteller Row had no effect

4.0.1 - 01/12/21#

Bug Fixes:

fixing some visual bugs which could occur on the poll pages
fixing a crash which could occur when closing the story view

New Features:

adding support for video backgrounds on poll pages

4.0.0 - 25/01/21#

Bug Fixes:

fixing a bug where it was possible for swipe ups to stop working
fixing a crash which could occur when saving analytics data

Improvements:

performance improvements for video and image pages

New Features:

adding support for poll pages
adding support for multiple instances of the Story Row in a single app

Deprecations and Changes:

changing the method signatures of openStory, openPage and reloadData

3.17.5 - 15/12/20#

Bug Fixes:

fixing a bug where the in-app browser address bar could be white in night mode

3.17.4 - 10/12/20#

Bug Fixes:

fixing a bug where the read stories could be shown when tapping on unread story
fixing a bug where the profile image was not shown for ads
fixing a bug where the swipe up UI could be shown even if it was disabled
fixing a bug with the onboarding screen margins

3.17.2 - 10/12/20#

Bug Fixes:

fixed a bug where an incorrect border color is applied to a story row item after it became read upon closing the story viewer

3.17.1 - 30/11/20#

Bug Fixes:

fixing a crash which could occur when preloading videos for stories

3.17.0 - 27/11/20#

Bug Fixes:

fixing a bug which could cause video playback to resume when a user was swiping to change stories
fixing a crash which could occur when preloading videos for ads
fixing a crash for some customers which could occur during swiping on Android 11

3.16.4 - 18/11/20#

Bug Fixes:

fixing a bug where the blank page was opened instead of a story

3.16.3 - 18/11/20#

Bug Fixes:

fixing potential null pointer exceptions
fixing a bug where the Play Store was not opened, when swiping up on a page with redirect
fixing a bug where the resumedAdPage event was triggered too often
fixing a bug where the read status of a story was not saved

3.16.2 - 06/11/20#

Bug Fixes:

fixing a bug introduced in 3.16.0 where it was possible for incorrect tracking pixels to be called for integrating app ads

Improvements:

improving video preloading with the new version of Exoplayer

Deprecations and Changes:

not sending extra parameters to tracking pixels supplied via integrating app ads

3.16.1 - 02/11/20#

Bug Fixes:

fixing a crash which could occur when swiping to interact with the Story View

3.16.0 - 30/10/20#

Bug Fixes:

fixing a crash which could occur when watching stories and changing from an image page to a video page
fixing the alignment of the dismiss icon within the story view relative to the story title
fixing a bug where if the system dark mode was changed when the story view was opened, the current story would persist behind other stories
fixing a bug where the new tag could not be removed from the story row tiles in certain circumstances

Improvements:

improving the performance of the story view when quickly transitioning between pages

New Features:

adding video playback events - please see Analytics for details

3.15.5 - 06/11/20#

Bug Fixes:

fixing a bug introduced in 3.15.3 where it was possible for incorrect tracking pixels to be called for integrating app ads

3.15.4 - 04/11/20#

Bug Fixes:

fixing a crash which could occur when swiping to interact with the Story View

3.15.3 - 02/11/20#

Bug Fixes:

fixing a crash which could occur when swiping to interact with the Story View

3.15.2 - 29/10/20#

Bug Fixes:

fixing a crash which could occur when swiping to interact with the Story View
upgrading Exoplayer dependency to version 2.11.3

3.15.1 - 22/10/20#

Improvements:

improving the smartphone onboarding layout
improving the animation when story is opened
improving the preloading of videos

Deprecations and Changes:

adjusting the initialize method errors - see Getting Started for more details

3.15.0 - 16/10/20#

Bug Fixes:

fixing a bug where rounded corners were not displayed correctly in the story view
fixing a bug on Android 8 where it was possible to see the story image as a background in the story view

Improvements:

improving the preloading of stories in the story view
improving the video cache
improving the animation when a story is dismissed and returned to the row view
improving the sensitivity of the swipe up gesture

3.14.1 - 09/10/20#

Bug Fixes:

fixing a bug where the instructions modal could be dismissed if the app was sent to the background when it was visible
fixing a bug where it was possible for tiles in the row to render incorrectly in certain situations

Improvements:

improving the error handling around the initialize flow to reduce the likelihood of any errors when this method is called

3.14.0 - 02/10/20#

Bug Fixes:

fixing a bug where it was possible for a user to be presented with a black screen with no loading indicator when opening the story view and on a slow connection
fixing a bug where it was possible for a loading indicator not to be presented when viewing an image page in certain circumstances over a slow/unreliable network

Improvements:

improving the handling of retries when assets in the story view fail to load

Deprecations and Changes:

adjusting the behavior of the instructions modal on tablets so that it appears over the story view rather than over the place in the app where it was presented from
cancelling requests to preload content for the story view if the user is on a slow network connection in order to maximize the chance they are able to view the content they have on screen

3.13.1 - 29/09/20#

Bug Fixes:

fixing a bug where it was possible for tiles to appear blank in the story carousel
removing a memory leak from within the SDK
fixing a bug where if the rowScale for a row was changed while the row was being rendered, the story tiles could appear at the wrong size
fixing a bug which could cause the SDK to crash in certain circumstances
fixing a bug where it was possible to get stuck in the story view when skipping through a large number of stories and pages
fixing a bug where it was possible for the story view to get stuck whilst dismissing

Improvements:

improving the behavior of the SDK with respect to transitions when a non-translucent status bar is used for the activity where the row view is displayed
improving the animation when a story is dismissed and returned to the row view

3.13.0 - 18/09/20#

Bug Fixes:

fixing a memory leak within the SDK

Improvements:

further improvements to the transitions between tiles in the story row and the story view

New Features:

adding full and intentional tablet support to the SDK

3.12.0 - 04/09/20#

Improvements:

improving email sharing by including the story title in any email sharing copy
improving the reliability of directing users to the Play Store from a swipe up action

Deprecations and Changes:

exposing Story Categories on the getAdsForRow callback - please see the Ads documentation for more details

3.11.0 - 24/08/20#

Bug Fixes:

fixing a bug where it was possible for an incorrect value to be passed for openedReason when a page completed
fixing a bug where it was possible for completedStory events not to fire when a user completed a story
fixing a bug where it was possible for an incorrect value to be passed to dismissedReason when a user completed the final page of the final story

Improvements:

improving the open animation when a user taps a tile in the Story View

New Features:

adding support for swiping up to a location within the integrating app or to the App Store from within Client Supplied Ads - see Ads for more details

Deprecations and Changes:

adjusting the initialization flow of the SDK - see Getting Started for more details

3.10.1 - 07/08/20#

Bug Fixes:

fixing a bug where stories were not marked as read until reloadData was called
fixing a bug where it was possible for a story to be marked as unread when a page was removed from the story
fixing a crash which could occur when retrieving or persisting encrypted data
fixing a bug where it was possible for the Story View to open in landscape mode

New Features:

adding a method to the StorytellerListViewDelegate called tileBecameVisible to allow the integrating app to be notified when a tile is visible on screen

3.9.0 - 31/07/20#

Bug Fixes:

fixing a bug where text was misaligned when using square tiles
fixing a bug where it was possible to swipe twice on the final story and end up on a blank screen

Improvements:

UI improvements to the Instructions Screen
improving the reliability of the activity tracking

Deprecations and Changes:

adjusting the StorytellerListViewDelegate getAdsForRow callback to allow it to accept null values for StorytellerAd

3.8.3 - 27/07/20#

New Features:

adding dismissStoryView method to StorytellerRowView to allow dismissing of any currently open Story View

3.8.0 - 15/07/20#

Improvements:

ensuring the user's device doesn't sleep when watching stories
improving the experience when sharing via email

UI Changes:

increasing the size of the tap target for the Swipe Up UI

3.7.4 - 14/07/20#

Bug Fixes:

fixing a bug where it was possible for a blank screen to be displayed when pushing the device back button on the instructions screen
fixing a bug where it was possible for the story view to render at the size of a story tile
fixing a bug where it was possible for userSwipedUpToApp to be triggered when navigating back to the Story View from the deeplink destination

3.7.3 - 10/07/20#

Improvements:

improving the performance of getAdsForRow so that it doesn't wait for the ads to be ready before opening the Story View

3.7.2 - 08/07/20#

Bug Fixes:

fixing a crash when opening the Story View on Android 8
fixing a bug where it was challenging to swipe up on stories
fixing a bug where the dismiss animation from the stories row did not happen in some situations
fixing a bug where it was possible for tracking pixels to be called multiple times in certain scenarios

3.7.1 - 07/07/20#

Bug Fixes:

fixing a bug where if the StorytellerRowView was within a RecyclerView it was possible for there to be unexpected behavior when the view was recycled

Improvements:

improving the performance of setUserDetails

3.7.0 - 06/07/20#

Bug Fixes:

fixing a bug where the adId parameter was not present in certain scenarios for ad analytics events

Improvements:

ensuring that FinishedAd also fires at the same time as PreviousAd
UI improvements and bug fixes

New Features:

adding the advertiserName parameter to ad analytics events

Deprecations and Changes:

rewriting the transition from the Story Row to the Story View

3.6.0 - 01/07/20#

Bug Fixes:

fixing a bug where it was possible for Story events to fire for Ads
fixing a bug where it was possible for the SDK to crash when rendering certain client supplied ads
fixing a bug where it was possible for the SDK to crash when adding or removing pages to already published stories

Improvements:

improving fault tolerance around network timeouts
identifying and fixing 2 memory leaks within the SDK

Deprecations and Changes:

exposing a new FinishedAd event which rolls up the DismissedAd, SkippedAd and ViewedAdPageComplete events so it's easier to tell when an ad is not being presented to the user

3.5.2 - 20/06/20#

adding the ability to supply custom tracking pixels as part of the getAdsForRow request
improving the interaction between the SDK and the status bar
fixing a UI bug where the gradients in the loading tiles would not render correctly
fixing a crash on Android 8

3.5.0 - 24/06/20#

Bug Fixes:

fixing a bug where it was possible for the close button and native back button to work if the Story View was triggered from landscape mode
fixing a crash which could occur when swiping to particular stories
fixing a bug where the Story View did not exit when a user finished watching all of their unread stories
fixing a bug where single page stories were not being marked as read correctly
fixing a crash which could occur when closing the Story View

Improvements:

improved the loading performance of ads

UI Changes:

UI improvements and bugfixes

3.4.0 - 17/06/20#

Bug Fixes:

fixing a crash which occurred when opening the Story View on Android 8

New Features:

UI improvements and bugfixes

UI Changes:

adding support for swiping up to the App Store or to a location within the integrating app from a page or an ad - see StorytellerRowViewDelegate for more details

3.3.0 - 11/06/20#

Bug Fixes:

fixing some bugs in the page navigation behavior around which pages are opened when stories are read/unread
fixing a bug where it was possible for durationViewed to be 0.0 in situations where the user had viewed content

Improvements:

improving the transitions when tapping a tile in the story row to open the Story View and when pulling down to dismiss the Story View
improvements to preloading of stories to make swiping and tapping through the Story View feel much smoother
encrypting user access tokens for the Storyteller API at rest
ensuring openedReason is included on OpenedAd events
ensuring openedReason is included on OpenedPage events
ensuring that DismissedAd events report the durationViewed and pagesViewedCount properties

New Features:

adding a ShareSuccess event to the SDK
adding the ability to supply ads to the SDK via the getAdsForRow callback on the StorytellerRowViewDelegate
adding new events for tracking user progress through ads - see Analytics for specifics

Deprecations and Changes:

when calling openPage or openStory, the onFailure callback will be called if the ID passed to openPage or openStory doesn't match a valid story or page
removing the onSuccess callback from openPage and openStory. If you would like to handle this case then please implement the onUserActivityOccurred callback and listen for openedStory or openedPage events with an openedReason of deeplink

3.2.0 - 03/06/20#

Bug Fixes:

fixing a bug where the openedReason analytics property could have an incorrect value when the user swiped between stories

Improvements:

improving the rendering performance of the StoryRowView when using the square layout

3.1.0 - 28/05/20#

Bug Fixes:

fixing issue where UserActivityData class did not have publicly visible members

New Features:

adding support for first-party ads loaded from the Storyteller CMS
emitting events related to ads playback via the onUserActivityOccurred callback
adding the ability to disable the story icon in the story view on a per-tenant basis
adding the ability to include a timestamp in the story view on a per-tenant basis
adding the ability to share a link configured in the CMS for each page (rather than the page's media) and the ability to configure this on a per-tenant basis

3.0.0 - 20/05/20#

New Features:

(beta) adding onUserActivityOccurred callback to StorytellerRowViewDelegate so the containing app can receive notifications when users take actions within the SDK

Deprecations and Changes:

removing onChannelsDataLoadStarted, onChannelsDataLoadComplete and onChannelDismissed callbacks from StorytellerRowViewDelegate
adding onStoriesDataLoadStarted, onStoriesDataLoadComplete, and onStoryDismissed callbacks to StorytellerRowViewDelegate
renaming public method openChannel to openStory
moving the store of read/unread pages from the server to the client