Integration Guide for Android SDK

Start with Getting Started to add dependencies, obtain a client ID, and initialize the SDK. Then choose the display component and integration features your app needs.

Display Components

Component	Use case	Guide
FwVideoFeedView	Browsable thumbnail carousel or grid	Video Feed
FwStoryBlockView	Inline story-style player	StoryBlock
FwPlayerDeckView	Inline player cards with shopping panels	Player Deck
FireworkSdk.startPlayer	Direct fullscreen playback	Fullscreen Player

See Widgets Overview for comparisons and Compose Support for hosting SDK views in Compose.

Content and Configuration

• Feed Sources: discovery, channels, playlists, playlist groups, SKU filters, and individual content.

• ViewOptions: builders, Kotlin DSL, defaults, and configuration precedence.

• Video Player: playback, sharing, PiP, and player UI.

• Deep Linking: open content from shared URLs.

Commerce and Interactions

• Shopping: product cards, hydration, cart/checkout callbacks, and purchase tracking.

• Livestream: player setup, interaction callbacks, and chat.

• Video CTA and Social Links: handle navigation and configure appearance.

• Analytics: event registration, payloads, and widget attribution.

Reference and Support

• FireworkSdk API

• FAQ & Troubleshooting

• Changelog