storyteller_sdk 11.0.2
storyteller_sdk: ^11.0.2 copied to clipboard
Official Storyteller SDK for Flutter - thin wrapper around native iOS and Android SDKs
Changelog #
11.0.2 17/12/2025 #
Bug fixes #
- Fixed an issue where the customKvps callback was called only once in the GAM adapter
- Fixed a rare issue related to the mute state on Android
11.0.1 04/12/2025 #
Improvements #
- Decreased the minimum required version of the GAM dependency for the GAM module on iOS to 12.2
11.0.0 14/11/2025 #
11.0.0-alpha.2 29/10/2025 #
Bug fixes #
- Fixed issue where adUnit callback was not being invoked on iOS
11.0.0-alpha.1 29/10/2025 #
storyteller_sdk #
SDK Initialization
Storyteller.initialize()with API key authentication and optional external IDStorytellerEventTrackingOptionsfor personalization and ad tracking configuration- SDK state queries:
isInitialized(),version(),currentApiKey()
Widget Components
StorytellerStoriesGridView- Grid layout for stories with category filteringStorytellerStoriesRowView- Horizontal scrolling row of storiesStorytellerClipsGridView- Grid layout for clips with collection supportStorytellerClipsRowView- Horizontal scrolling row of clipsStorytellerEmbeddedClipsView- Embedded clips player with playback controls
Controllers
StorytellerEmbeddedClipsControllerfor programmatic playback controlStorytellerListViewControllerfor list and grid view management
Content Navigation
- Direct content opening:
openStory(),openPage(),openSheet(),openSearch() - Collection support:
openCollection(),openCollectionWithCategory() - External ID support:
openStoryByExternalId(),openClipByExternalId() - Category navigation:
openCategory(),isCategoryFollowed() - Content counts:
getStoriesCount(),getClipsCount()
User Management
- Custom attributes:
setCustomAttribute(),removeCustomAttribute(),customAttributes() - Locale configuration:
setLocale() - Category following:
addFollowedCategory(),removeFollowedCategory(),followedCategories()
Theming System
StorytellerThemewith light/dark mode support- Component-specific themes: instructions, engagement units, polls, quizzes, search
- Per-collection theme support in
openCollection()
Deep Linking
isStorytellerDeeplink()for URL validationopenDeeplink()for navigation handlingisSearchEnabled()query
Player Controls
dismissPlayer()with animation and reason supportresumePlayer()for playback continuation- Player state queries:
isPlayerVisible(),isPresentingContent()
Event Streams
onUserActivityOccurred- All user interaction eventsuserNavigatedToApp- Link tap navigation eventscategoryFollowActionTaken- Category follow/unfollow eventsonPlayerPresented- Player presentation lifecycleonPlayerDismissed- Player dismissal lifecycleonLog- SDK debug logging
storyteller_gam_sdk #
Google Ad Manager Integration
StorytellerGAMModule.setup()for native SDK integration configurationStorytellerGAMModuleConfigurationwith dynamic ad unit callbackStorytellerAdRequestInfoproviding placement, category, and experiment contextStorytellerCustomNativeTemplateIdsfor stories and clips ad templates
Features
- Dynamic ad unit selection per request based on placement/category/experiment
- Custom native template ID mapping for stories and clips
- Platform channel bridge to native GAM SDKs