True Native Playback
Uses AVPlayer on iOS and ExoPlayer on Android — no WebView. Get the best performance and full platform integration.
Full Ad Support
VAST, VPAID, Google IMA, pre/mid/post-roll — all configured through your BB playout. Track every ad lifecycle event.
Expo & Bare RN
Works with both Expo (SDK 51+) and bare React Native (0.73+). Config plugin handles native setup automatically.
TypeScript-First
Comprehensive types for every component, method, event, and data model. Full IntelliSense support out of the box.
Old & New Architecture
Supports both Old Architecture (NativeModules) and New Architecture (TurboModules/Fabric) with automatic detection.
Shorts & Outstream
Vertical video player with swipe navigation (TikTok-style) and standalone outstream ad player with collapse/expand.
Quick Start
Install the package, add a single component, and you have a fully-featured video player.
npm install @bluebillywig/react-native-bb-player
import { BBPlayerView } from '@bluebillywig/react-native-bb-player';
export function MyPlayer() {
return (
<BBPlayerView
jsonUrl="https://demo.bbvms.com/p/default/c/4701337.json"
options={{ autoPlay: true }}
style={{ flex: 1 }}
onDidTriggerPlay={() => console.log('Playing')}
/>
);
}
Works Everywhere
Supports the full React Native ecosystem — bare projects, Expo, old and new architecture.
AVPlayer
ExoPlayer
Old & New Arch
Config Plugin