Share URL Feed

Share URL Feed displays content from a Firework share URL with a customizable domain. This feed type is perfect for handling deep links, social media shares, and branded URLs.

Overview

Share URL Feed allows you to open Firework video content using URLs with your custom domain. The SDK reads specific query parameters from the URL to identify and display the correct content. This enables seamless sharing and deep linking experiences with your branded URLs.

URL Structure

https://[your-custom-domain]?fw_video=[video_id]&fw_channel=[channel_id]&fw_playlist=[playlist_id]

URL Components

Component	Description	Required
Domain	Your custom domain (e.g., androidfamily.com)	Optional*
fw_video	Video content ID	✅ Required
fw_channel	Channel ID	❌ Optional
fw_playlist	Playlist ID	❌ Optional

Note: The domain part is completely customizable by your app. The SDK only reads the query parameters (fw_video, fw_channel, fw_playlist).

Usage

Required Parameter

• url - Share URL with query parameters (required, non-empty)

Programmatic Configuration

val shareUrl = "https://androidfamily.com?fw_video=o9qYB9&fw_channel=fw_livestream&fw_playlist=oAKXNk"

val viewOptions = viewOptions {
    baseOptions {
        feedResource(
            FeedResource.ShareUrl(url = shareUrl)
        )
    }
    playerOptions {
        showShareButton(true)
    }
}

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

Use Cases

• Deep Link Handling - Open videos from app deep links

• Social Media Shares - Handle URLs shared on social platforms

• External Referrals - Links from emails, SMS, or other apps

• Custom Branded URLs - Use your own domain for video shares

• QR Code Integration - Generate QR codes with video URLs

• Marketing Campaigns - Track campaign-specific video links

Complete Examples

Deep Link Activity

class DeepLinkActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // Get share URL from intent
        val shareUrl = intent.data?.toString()
        
        if (shareUrl != null && isFireworkShareUrl(shareUrl)) {
            launchVideoFromShareUrl(shareUrl)
        } else {
            // Handle invalid URL
            finish()
        }
    }
    
    private fun isFireworkShareUrl(url: String): Boolean {
        val uri = Uri.parse(url)
        return uri.getQueryParameter("fw_video") != null
    }
    
    private fun launchVideoFromShareUrl(shareUrl: String) {
        val viewOptions = viewOptions {
            baseOptions {
                feedResource(
                    FeedResource.ShareUrl(url = shareUrl)
                )
            }
            playerOptions {
                showShareButton(true)
                showFireworkLogo(false)
            }
        }
        
        // Launch fullscreen player
        FireworkSdk.startPlayer(
            activity = this,
            viewOptions = viewOptions
        )
        
        finish()
    }
}

Share URL Builder

class ShareUrlBuilder {
    companion object {
        private const val BASE_DOMAIN = "https://androidfamily.com"
        
        fun buildShareUrl(
            videoId: String,
            channelId: String? = null,
            playlistId: String? = null
        ): String {
            val params = mutableListOf("fw_video=$videoId")
            
            channelId?.let { params.add("fw_channel=$it") }
            playlistId?.let { params.add("fw_playlist=$it") }
            
            return "$BASE_DOMAIN?${params.joinToString("&")}"
        }
    }
}

// Usage
val shareUrl = ShareUrlBuilder.buildShareUrl(
    videoId = "o9qYB9",
    channelId = "fw_livestream",
    playlistId = "oAKXNk"
)

URL Validation

object FireworkShareUrlValidator {
    fun isValid(url: String): Boolean {
        return try {
            val uri = Uri.parse(url)
            // fw_video is required
            val videoId = uri.getQueryParameter("fw_video")
            !videoId.isNullOrEmpty()
        } catch (e: Exception) {
            false
        }
    }
    
    fun extractVideoId(url: String): String? {
        return try {
            Uri.parse(url).getQueryParameter("fw_video")
        } catch (e: Exception) {
            null
        }
    }
    
    fun extractChannelId(url: String): String? {
        return try {
            Uri.parse(url).getQueryParameter("fw_channel")
        } catch (e: Exception) {
            null
        }
    }
    
    fun extractPlaylistId(url: String): String? {
        return try {
            Uri.parse(url).getQueryParameter("fw_playlist")
        } catch (e: Exception) {
            null
        }
    }
}

URL Examples

Minimum Required (Video Only)

https://androidfamily.com?fw_video=o9qYB9

With Channel

https://androidfamily.com?fw_video=o9qYB9&fw_channel=fw_livestream

Complete (Video + Channel + Playlist)

https://androidfamily.com?fw_video=o9qYB9&fw_channel=fw_livestream&fw_playlist=oAKXNk

Custom Domain Examples

https://yourbrand.com?fw_video=abc123
https://videos.myapp.com?fw_video=xyz789&fw_channel=main_channel
https://share.example.com?fw_video=def456&fw_channel=featured&fw_playlist=highlights

Important Notes

• Custom Domain - Use any domain you control for branding

• Required Parameter - fw_video query parameter is mandatory

• Optional Parameters - fw_channel and fw_playlist are optional

• Empty String Exception - Empty URL will throw an exception

• URL Validation - Validate URL structure before using

• Deep Link Setup - Configure Android App Links for seamless experience

• HTTPS Recommended - Use HTTPS for security

Android App Links Setup

For seamless deep linking, set up Android App Links:

1. Add intent filter in AndroidManifest.xml (see example above)

2. Configure assetlinks.json on your web server

3. Enable autoVerify in intent filter

Refer to Android App Links documentation for detailed setup.

See Also

• Feed Sources Overview - All available feed types

• Single Content Feed - Display specific videos

• BaseOption Configuration - Detailed configuration

• FireworkSdk.startPlayer - Fullscreen player

• Video Deep Linking - Deep link configuration