Developers / Android SDK / Changelog

Changelog

8.1.11 - 24/08/22

Bug Fixes:

fixed occasional crash when closing player
fixed reload button visiblity not working correctly on clips player for tablet
fixed tablet clips playback issue

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
fixing some minor issues with the tile layouts

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/clips 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 (see here for more details 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 - please see StorytellerRowView for details
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 StorytellerRowViewDelegate into two separate delegates - please see StorytellerDelegate and StorytellerRowViewDelegate 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 StorytellerRowViewDelegate

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 - see StorytellerRowView for more details

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 StorytellerRowViewDelegate 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 StorytellerRowViewDelegate getAdsForRow callback to allow it to accept null values for ClientAd

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

Additional Methods Forward Arrow