SwiftUI Channels SDK (iOS): Get Started

The SwiftUI Channels SDK lets you embed a fully branded video streaming experience inside an iOS app built with SwiftUI.

1.0 | What is it?

The SwiftUI Channels SDK lets you embed a complete Blue Billywig Channel — with swim lanes, carousels, search, and detail pages — directly in an iOS app built with SwiftUI. It uses the native player under the hood, so users get hardware-accelerated playback with full Chromecast support.

If you are already using the Native Player SDK for standalone video playback, the Channels SDK builds on top of it. Both can be used together: the player for individual videos and the Channels SDK for curated content experiences.

2.0 | Features

• Branded video portal with custom colors, fonts, and logo
• Multiple layout options: swim lanes, grids, carousels, and featured headers
• Built-in search across all content
• Detail pages with related videos
• Native playback on iOS
• Chromecast support
• Full ad support (VAST, VPAID, Google IMA)
• Deep linking to specific videos or pages
• Analytics and event tracking
• JWT authentication for restricted content

3.0 | Getting started

The Channels SDK is distributed as a private Swift package via Swift Package Manager. A GitHub Personal Access Token (PAT) with repo scope from Blue Billywig is required to install it.

Here is a minimal example to get a channel up and running:

import SwiftUI
import BBChannelSwiftUI
import BBNativePlayerKit_SwiftUI

struct ContentView: View {
    @StateObject private var viewModel = BBChannelWithPlayerViewModel()

    var body: some View {
        BBChannelWithPlayerView(
            channelUrl: "https://yourpublication.bbvms.com/ch/1234.json",
            viewModel: viewModel,
            callbacks: BBChannelCallbacks(
                onReady: { print("Channel loaded") }
            )
        )
    }
}

For full setup instructions, system requirements, and configuration options, visit the SwiftUI Getting Started guide.

4.0 | System requirements

• iOS 16+
• Xcode 15+
• Swift 5.9+

5.0 | Also available for Android and React Native

The Channels SDK is also available for other platforms:

• Jetpack Compose (Android): via Maven. Compose guide
• React Native: via npm. React Native guide

All three SDKs share the same feature set and connect to the same channel configuration.