@bluebillywig/react-native-bb-player 8.45.20 → 8.45.22

package/README.md

@@ -377,6 +377,34 @@ export function ChromecastPlayer() {
 
 > **Note:** Chromecast functionality is available on both iOS and Android platforms.
 
+## Example App
+
+The included example app (`example/`) demonstrates all SDK features. It's available on TestFlight (iOS) and as an APK download on each [GitHub release](https://github.com/bluebillywig/react-native-bb-player/releases).
+
+### Screens
+
+| Screen | Description |
+|--------|-------------|
+| **Simple Player** | Minimal player for performance testing |
+| **API Reference** | Interactive demo of all player methods: play, pause, seek, volume, fullscreen |
+| **Shorts** | Vertical video with swipe navigation, supports full and shelf display modes |
+| **Outstream Ads** | Standalone ad player with collapse/expand for article placements |
+| **Modal Player** | Native full-screen modal overlay with swipe-to-close (iOS) |
+
+### Running Locally
+
+```bash
+# Install dependencies
+npm ci && cd example && npm ci
+
+# iOS
+cd ios && pod install && cd ..
+npx react-native run-ios
+
+# Android
+npx react-native run-android
+```
+
 ## API Reference
 
 ### Component Props

package/ios/BBShortsView.swift

@@ -40,6 +40,7 @@ private enum LogLevel {
  */
 class BBShortsView: UIView, BBNativeShortsViewDelegate {
   private var shortsView: BBNativeShortsView?
+  private var navController: UINavigationController?
   private var hasSetup: Bool = false
 
   // MARK: - Props (set from React Native)
@@ -136,15 +137,38 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
       return
     }
 
+    // Wrap in a UINavigationController so the native SDK can present
+    // shelf-mode modals (openShortsPlayerAsModal uses navigationController?.present).
+    // The native SDK adds BBNativeShortsViewController as a child of the VC we pass.
+    // That child then uses its navigationController to present modals.
+    let containerVC = UIViewController()
+    containerVC.view.backgroundColor = .clear
+    let nav = UINavigationController(rootViewController: containerVC)
+    nav.isNavigationBarHidden = true
+    nav.view.frame = bounds
+    nav.view.backgroundColor = .clear
+    viewController.addChild(nav)
+    addSubview(nav.view)
+    nav.view.translatesAutoresizingMaskIntoConstraints = false
+    NSLayoutConstraint.activate([
+      nav.view.topAnchor.constraint(equalTo: topAnchor),
+      nav.view.leadingAnchor.constraint(equalTo: leadingAnchor),
+      nav.view.trailingAnchor.constraint(equalTo: trailingAnchor),
+      nav.view.bottomAnchor.constraint(equalTo: bottomAnchor),
+    ])
+    nav.didMove(toParent: viewController)
+    self.navController = nav
+
     // Convert options to Swift dictionary
     var optionsDict: [String: Any]? = nil
     if let dict = options as? [String: Any], !dict.isEmpty {
       optionsDict = dict
     }
 
-    // Create the shorts view using the factory method
+    // Create the shorts view using the container VC inside the nav controller
+    // so the native SDK's shelf tap can present modals via navigationController
     shortsView = BBNativeShorts.createShortsView(
-      uiViewController: viewController,
+      uiViewController: containerVC,
       frame: bounds,
       jsonUrl: jsonUrl,
       options: optionsDict
@@ -158,14 +182,15 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
 
     shorts.delegate = self
 
-    // Add to view hierarchy with autolayout
-    addSubview(shorts)
+    // Add shorts view inside the container VC's view so it sits within the
+    // navigation controller hierarchy (required for shelf modal presentation)
+    containerVC.view.addSubview(shorts)
     shorts.translatesAutoresizingMaskIntoConstraints = false
     NSLayoutConstraint.activate([
-      shorts.topAnchor.constraint(equalTo: topAnchor),
-      shorts.leadingAnchor.constraint(equalTo: leadingAnchor),
-      shorts.trailingAnchor.constraint(equalTo: trailingAnchor),
-      shorts.bottomAnchor.constraint(equalTo: bottomAnchor)
+      shorts.topAnchor.constraint(equalTo: containerVC.view.topAnchor),
+      shorts.leadingAnchor.constraint(equalTo: containerVC.view.leadingAnchor),
+      shorts.trailingAnchor.constraint(equalTo: containerVC.view.trailingAnchor),
+      shorts.bottomAnchor.constraint(equalTo: containerVC.view.bottomAnchor)
     ])
 
     log("BBShortsView.setupShorts() completed")
@@ -176,6 +201,10 @@ class BBShortsView: UIView, BBNativeShortsViewDelegate {
     shortsView?.destroy()
     shortsView?.removeFromSuperview()
     shortsView = nil
+    navController?.willMove(toParent: nil)
+    navController?.view.removeFromSuperview()
+    navController?.removeFromParent()
+    navController = nil
     hasSetup = false
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluebillywig/react-native-bb-player",
-  "version": "8.45.20",
+  "version": "8.45.22",
   "description": "Blue Billywig Native Video Player for React Native - iOS AVPlayer and Android ExoPlayer integration",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",