Feed Sources

The Firework Android SDK provides multiple types of feed sources (FeedResource) to display different video content in your application. Each feed type serves specific use cases and can be configured through ViewOptions.

Overview

Feed sources determine which videos are displayed in your video widgets. You configure the feed source using the feedResource property in BaseOption.

val viewOptions = viewOptions {
    baseOptions {
        feedResource(FeedResource.Discovery)
    }
}

Available Feed Types

Discovery Feed

Curated content from the Firework platform that learns user preferences over time.

Use Cases: Homepage, explore section, general content discovery

👉 Learn more about Discovery Feed

---

Channel Feed

All videos from a specific channel, either your own content or curated collections.

Use Cases: Brand-specific content, creator channels, category videos

👉 Learn more about Channel Feed

---

Playlist Feed

Videos from a specific playlist within a channel for curated collections.

Use Cases: Featured content, topic-specific playlists, seasonal collections

👉 Learn more about Playlist Feed

---

Hashtag Playlist Feed

Videos from a channel filtered by hashtag expressions for targeted content.

Use Cases: Campaign videos, trend-based feeds, topic-specific content

👉 Learn more about Hashtag Playlist Feed

---

SKU Feed

Videos associated with a single or multiple product SKUs.

Use Cases: Product detail pages, shopping experiences, product videos

👉 Learn more about SKU Feed

---

Channel Video Feed

Videos from a specific channel filtered by video IDs for precise content selection.

Use Cases: Curated video collections, specific video showcases, editorial picks

👉 Learn more about Channel Video Feed

---

Single Content Feed

Display a single specific video or livestream.

Use Cases: Featured video, video details page, direct video links

👉 Learn more about Single Content Feed

---

Dynamic Content Feed

Videos based on dynamic parameters for personalized content targeting.

Use Cases: Personalized content, user segment targeting, A/B testing

👉 Learn more about Dynamic Content Feed

---

Share URL Feed

Content from a Firework share URL with customizable domain.

Use Cases: Deep link handling, social media shares, branded URLs

👉 Learn more about Share URL Feed

---

Quick Comparison

Feed Type	Required Parameters	Personalization	Use Case
Discovery	None	✅ High	General content discovery
Channel	channelId	⚡ Medium	Brand/creator specific
Playlist	channelId, playlistId	❌ None	Curated collections
Hashtag Playlist	channelId, hashtagFilterExpression	❌ None	Filtered content
SKU	channelId, productIds	❌ None	Product videos
Channel Video	channelId, videoIds	❌ None	Specific video selection
Single Content	contentId	❌ None	Specific video
Dynamic Content	channelId, parameters	✅ High	Personalized targeting
Share URL	url	❌ None	Shared links

Configuration

All feed sources are configured through BaseOption in ViewOptions:

val viewOptions = viewOptions {
    baseOptions {
        feedResource(/* Your FeedResource here */)
    }
    // Other configurations...
}

With FwVideoFeedView

val videoFeedView = findViewById<FwVideoFeedView>(R.id.videoFeedView)
videoFeedView.init(viewOptions)

With Fullscreen Player

FireworkSdk.startPlayer(
    activity = this,
    viewOptions = viewOptions
)

With FwStoryBlockView

val storyBlockView = findViewById<FwStoryBlockView>(R.id.storyBlockView)
storyBlockView.init(viewOptions)

Important Notes

• All channel IDs, playlist IDs, and content IDs must be encoded values provided by Firework

• Empty strings will throw an exception during initialization

• Some feed types require specific backend configuration

• Feed resources are serializable and can be passed between activities

See Also

• BaseOption Configuration - Detailed feed resource configuration

• FwVideoFeedView - Video feed widget

• FireworkSdk.startPlayer - Fullscreen player

• ViewOptions Overview - Complete configuration system