> For the complete documentation index, see [llms.txt](https://docs.firework.com/firework-for-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/widgets.md). # Widgets Overview The Firework Android SDK provides four main ways to display video content in your application. Each widget is designed for specific use cases and offers different levels of integration. ## Available Widgets ### 1. FwVideoFeedView `FwVideoFeedView` is an embeddable view that displays a scrollable feed of video thumbnails. When a user taps on a thumbnail, the full video player launches. **Use Cases:** * Display a horizontal, vertical, or grid feed of videos * Embed video content within existing layouts * Show curated content from channels, playlists, or discovery feeds **Key Features:** * XML and programmatic initialization * Multiple layout types (horizontal, vertical, grid) * Feed refresh capability * Customizable appearance via ViewOptions **Layout Examples:** | Grid Layout | Horizontal Layout | Vertical Layout | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![Horizontal](https://688917408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLoGG8m6bokS9YTmS7m%2Fuploads%2Fgit-blob-46f16d5e7b31ab06a1d5a9202acec74816b3fbda%2Fgrid.jpg?alt=media) | ![Vertical](https://688917408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLoGG8m6bokS9YTmS7m%2Fuploads%2Fgit-blob-d358a4d8524d9d6ebdd713c1e385bc537dfd2b19%2Fhorizontal.jpg?alt=media) | ![Grid](https://688917408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLoGG8m6bokS9YTmS7m%2Fuploads%2Fgit-blob-b5dbef371732c5b88b337a76ea8bc4a37bd77b00%2Fvertical.jpg?alt=media) | [Learn more about FwVideoFeedView](/firework-for-developers/android-sdk/integration-guide/configure-video-feed.md) ### 2. FwStoryBlockView `FwStoryBlockView` is an inline video player that embeds directly into your view hierarchy, similar to stories on social platforms. **Use Cases:** * Create story-like video experiences * Embed a single-video player in a layout * Build custom video browsing experiences **Key Features:** * Lifecycle management (init/destroy) * Multiple player modes (FIT\_MODE, FULL\_BLEED\_MODE) * Fullscreen expansion capability * Play/pause control * Feed loading and error listeners **Layout Examples:** ![StoryBlock](https://688917408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLoGG8m6bokS9YTmS7m%2Fuploads%2Fgit-blob-c997786d528e7656f30787e97af8bfcb1cc53dc5%2Fsb.jpg?alt=media) [Learn more about FwStoryBlockView](/firework-for-developers/android-sdk/integration-guide/storyblock.md) ### 3. FireworkSdk.startPlayer `FireworkSdk.startPlayer()` is a method that launches a fullscreen video player as a separate activity. **Use Cases:** * Launch videos from buttons, deep links, or custom UI * Open specific videos by URL or feed configuration * Create custom video entry points **Key Features:** * Direct video playback without embedding UI * Two variants: with specific URL or with feed configuration * Returns PlayerLaunchResult for handling success/failure * Full player customization via ViewOptions **Layout Examples:** ![StoryBlock](https://688917408-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MLoGG8m6bokS9YTmS7m%2Fuploads%2Fgit-blob-74dd8e6af7804c5580486d6f37053d56b53bda53%2Ffs.jpg?alt=media) [Learn more about FireworkSdk.startPlayer](/firework-for-developers/android-sdk/integration-guide/fullscreen-player.md) ### 4. FwPlayerDeckView `FwPlayerDeckView` displays horizontal inline player cards with product panels. Use it when users should play and shop from the feed itself. **Key Features:** * Programmatic `ViewOptions` configuration * Visibility-aware autoplay * Product panels and optional one-tap Add to Cart * Fullscreen launch from an item ```kotlin playerDeckView.init(viewOptions, supportFragmentManager) // When the view is no longer needed: // playerDeckView.destroy() ``` See [Player Deck](/firework-for-developers/android-sdk/integration-guide/01-basic-usage-and-api.md) for sizing, listeners, lifecycle, and supported configurations. ## Comparison Table | Feature | FwVideoFeedView | FwStoryBlockView | FwPlayerDeckView | FireworkSdk.startPlayer | | --------------- | ------------------- | ----------------- | ---------------------- | ----------------------- | | Integration | Embedded view | Embedded view | Embedded view | Separate activity | | Content display | Thumbnails | Inline player | Inline player cards | Fullscreen player | | Configuration | XML + ViewOptions | ViewOptions | ViewOptions | ViewOptions | | Cleanup | Host/view lifecycle | init/destroy | init/destroy | Managed by SDK | | Best for | Discovery | Story experiences | Play and shop in cards | Direct playback | ## Choosing the Right Widget **Choose FwVideoFeedView when:** * You want users to browse and select videos * You need to display multiple videos in a feed * You want flexible layouts (horizontal, vertical, grid) **Choose FwStoryBlockView when:** * You want an immersive, single-video experience * You need fine-grained lifecycle control * You want to build story-like UI patterns **Choose FireworkSdk.startPlayer when:** * You want to launch a video immediately * You're handling deep links or notifications * You have a custom UI for video selection **Choose FwPlayerDeckView when:** * You want inline video playback with shopping panels * You need a horizontal deck rather than a grid of thumbnails * You can provide the sizing and scroll-visibility behavior described in its guide ## Configuration All four display options support configuration through `ViewOptions`, which allows you to customize: * Player behavior and appearance * Feed sources and content * Shopping and livestream features * CTA buttons and interactions See the [Configuration Guide](/firework-for-developers/android-sdk/integration-guide/configuration.md) for detailed ViewOptions documentation. ## Next Steps * Learn about [Feed Sources](/firework-for-developers/android-sdk/integration-guide/feed-sources.md) to understand content types * Explore [ViewOptions Configuration](/firework-for-developers/android-sdk/integration-guide/configuration.md) for customization * Check out [Shopping Integration](/firework-for-developers/android-sdk/integration-guide/shoppable-videos.md) for e-commerce features * Review [Livestream Features](/firework-for-developers/android-sdk/integration-guide/livestream.md) for live content