BB Native Player Kit
Native iOS / tvOS video player SDK from Blue Billywig. Ships two surfaces in the same CocoaPod / Swift package:
| Surface | When to use it | Status |
|---|---|---|
UIKit SDK (BBNativePlayerKit) | Default. Any iOS / tvOS app, any deployment target supported by the SDK. UIKit UIViewController + delegate-based callbacks. | Primary surface; ships in every release. |
SwiftUI module (BBNativePlayerKit-SwiftUI) | Optional. SwiftUI apps targeting iOS 17+ that want a native SwiftUI View with reactive @Observable state and type-safe options. | Thin wrapper around the UIKit SDK. Same playback engine, no feature divergence; convenience layer only. |
Pick a section
Both sections cover the same product — they just target different app architectures.
👉 UIKit SDK
Start here for most apps. Covers installation via CocoaPods, creating a BBNativePlayerView, implementing the delegate, and enabling Picture-in-Picture / AirPlay.
👉 SwiftUI (optional)
Start here only if your app is SwiftUI-first and you target iOS 17+. Wraps the UIKit SDK in BBNativePlayer, BBPlayerState, and BBNativeShorts views.
API reference
Auto-generated reference for every public type and method in both modules: see the API Reference sidebar. The two modules live in the same Swift package — UIKit code can be mixed with SwiftUI code in the same app without conflict.
Demo apps
- bbnativeplayerkit-demo — UIKit demo
BBNativePlayerKit-SwiftUI-demo/in the SDK repo — SwiftUI demo
Related SDKs
- React Native — for React Native apps
- bbnativeplayersdk-kotlin — Android (Kotlin + Compose)