This repo holds the Firework Android SDK example applications.
List of example apps:
- View Options
- Feed Integration
- Feed Resources
- Single-Host Livestream
- Multi-Host Livestream
- Shopping
- Share Link
- Picture In Picture
- Jetpack Compose
- Story Block
- In-app Language
Read more about the integration here https://docs.firework.tv/
This example app demonstrates all possible view options that can be used for the FwVideoFeedView
initialization.
The view options can be set in 3 different methods:
- Using
FwVideoFeedView
's attributes in the XML layout file - Using
ViewOptions
Builders at runtime - Using
viewOptions
Kotlin DSL methods at runtime
Customized View Options | Player screen |
---|---|
This example app demonstrates the following scenarios of FwVideoFeedView
integration: The app
shows how to integrate
FwVideoFeedView
in activity, fragment, recycler view, and remove/add FwVideoFeedView
from the
container on the runtime.
FwVideoFeedView
integrated in activityFwVideoFeedView
integrated in fragmentFwVideoFeedView
integrated in recycler viewFwVideoFeedView
add/removed from the container on the runtime.
FwVideoFeedView in Activity | FwVideoFeedView in recycler view |
---|---|
In this example app, the FwVideoFeedView
is initialized with different feedResources: Discovery, Playlist, Channel, Dynamic Content, Channel
Hashtags.
Discovery Feed | Player screen |
---|---|
Channel Feed | Player screen |
---|---|
Playlist Feed | Player screen |
---|---|
Dynamic Feed | Player screen |
---|---|
Channel Hashtags Feed | Player screen |
---|---|
Sku Feed | Player screen |
---|---|
Single Content Feed | Player screen |
---|---|
In this example app, the FwVideoFeedView
is initialized for showing single-host Livestreams.
You need a feed resource with a Single Host Livestream item.
Single-Host Livestream example app
Livestream Feed | Livestream Player | Livestream Features |
---|---|---|
In this example app, the FwVideoFeedView
is initialized for showing multi-host Livestreams.
You need a feed resource with a Multiple Host Livestream item.
Multi-Host Livestream example app
Livestream Feed | Livestream Player | Livestream Features |
---|---|---|
In this example app, the FwVideoFeedView
is initialized and integrated with the shopping features of the SDK.
The app has two screens which demonstrate how to setup shopping for "Shopping cart mode" and "Shop now mode".
Video with products | Product details page |
---|---|
Shopping cart mode | Shop now mode |
---|---|
This example app demonstrates the share link functionality. It contains two activities:
MainActivity
- allows to lunch player and share the videoShareLinkActivity
- handles the deep link and opens the shared video.
Also, this example demonstrates how to replace the base URL of the shared video with a custom one.
Note: Starting in Android 12 (API level 31), a generic web intent resolves to an activity in your app only if your app is approved for the specific domain contained in that web intent. If your app isn't approved for the domain, the web intent resolves to the user's default browser app instead.
In this example app, the FwVideoFeedView
is initialized with the picture-in-picture feature enabled.
The user can switch to the PiP mode if the device supports and this feature is not disabled for the app by
- Leaving the app while the player is playing
- Pressing the down chevron on the player
- When the app calls the related public API
Picture-in-picture example app
PiP Feed | Player screen in PiP mode |
---|---|
In this example app, the FwVideoFeedView
is initialized for showing a discovery feed using Jetpack Compose.
Discovery Feed | Player screen |
---|---|
This example app demonstrates the usage of StoryBlock component. This component allows to embed pager player directly in the host app's view hierarchy.
Story block | Fullscreen Story Block |
---|---|
This example app demonstrates how the host app can change the SDK language. The SDK Views follow the host app context language so any changes to the host app language will be applied to SDK, too.
Language Selector | Supported Languages |
---|---|