> 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/feed-sources/single-content-feed.md).

# Single Content Feed

Single Content Feed displays a single specific video or livestream. Users will see only that particular piece of content, making it ideal for featuring specific videos or handling direct video links.

## Overview

This feed type focuses on displaying exactly one video or livestream. It's perfect for scenarios where you want to showcase a specific piece of content without showing related or additional videos.

## Usage

### Required Parameter

* `contentId` - Your encoded video identifier (required, non-empty)

### XML Configuration

```xml
<com.firework.videofeed.FwVideoFeedView
    android:id="@+id/videoFeedView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
```

### Programmatic Configuration

```kotlin
val viewOptions = viewOptions {
    baseOptions {
        feedResource(
            FeedResource.SingleContent(contentId = "encoded_video_id")
        )
    }
    layoutOptions {
        feedLayout(FeedLayout.HORIZONTAL)
    }
}

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

## Use Cases

* **Featured Video** - Highlight a specific video on your homepage
* **Video Details Page** - Dedicated page for a single video
* **Direct Video Links** - Open specific videos from deep links or notifications
* **Content Promotion** - Promote a specific piece of content
* **Livestream Event** - Display a specific live stream
* **Tutorial or Guide** - Show a specific instructional video

## Complete Examples

### Featured Video on Homepage

```kotlin
class HomeActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_home)
        
        val featuredVideoView = findViewById<FwVideoFeedView>(R.id.featuredVideo)
        
        val viewOptions = viewOptions {
            baseOptions {
                feedResource(
                    FeedResource.SingleContent(contentId = "encoded_video_id")
                )
            }
            playerOptions {
                showShareButton(true)
            }
        }
        
        featuredVideoView.init(viewOptions)
    }
}
```

## Using with Fullscreen Player

Single Content Feed is particularly useful with the fullscreen player:

```kotlin
fun launchSpecificVideo(contentId: String) {
    val viewOptions = viewOptions {
        baseOptions {
            feedResource(
                FeedResource.SingleContent(contentId = contentId)
            )
        }
        playerOptions {
            showShareButton(true)
            showFireworkLogo(false)
        }
    }
    
    FireworkSdk.startPlayer(
        activity = this,
        viewOptions = viewOptions
    )
}
```

## Important Notes

* **Encoded Content ID Required** - Content ID must be an encoded value from Firework
* **Empty String Exception** - Providing an empty `contentId` will throw an exception
* **Single Content Only** - Only the specified video/livestream is displayed
* **No Related Videos** - Unlike other feed types, no additional content is shown
* **Works with Videos and Livestreams** - Supports both regular videos and livestream content
* **Content ID Format** - Use the encoded ID provided by Firework CMS

## See Also

* [Feed Sources Overview](/firework-for-developers/android-sdk/integration-guide/feed-sources.md) - All available feed types
* [Share URL Feed](/firework-for-developers/android-sdk/integration-guide/feed-sources/share-url-feed.md) - Handle shared video URLs
* [BaseOption Configuration](/firework-for-developers/android-sdk/integration-guide/configuration/base-options.md) - Detailed configuration
* [FireworkSdk.startPlayer](/firework-for-developers/android-sdk/integration-guide/fullscreen-player.md) - Fullscreen player
* [FwVideoFeedView](/firework-for-developers/android-sdk/integration-guide/configure-video-feed.md) - Video feed widget


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.firework.com/firework-for-developers/android-sdk/integration-guide/feed-sources/single-content-feed.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.