bb_player 8.57.0

bb_player: ^8.57.0 copied to clipboard

• Android: bumped compileSdk from 34 to 36 (Android 16). Compiling against 34 broke startup when the player was embedded in an app running on Android 15+ (API 35+), where the OS forces edge-to-edge drawing.
• Requires AGP 8.9 or newer. Flutter plugins are built from source by the consuming app, so your app's Android Gradle Plugin compiles this module — and AGP older than 8.9 rejects compileSdk 36 outright. Upgrade AGP before taking this version. The example app now uses AGP 8.9.1 / Gradle 8.11.1 to demonstrate that floor.
• Note: this does not cover the Google Play requirement to target API 36 from 31 August 2026. That applies to your app's targetSdk; library modules have no targetSdk and AGP 8 ignores it for them. Set it in your own app.
• Stops at 36 deliberately — API 37 requires migrating the native SDK from ExoPlayer 2 to Media3, tracked separately.
• Versions 8.55.0 and 8.56.0 were never published to pub.flutter-io.cn; this release goes straight from 8.54.0. The package version tracks the BB native player SDK minor, which is at 8.57.0 on both Maven Central (Android) and CocoaPods (iOS) as of 24 August 2026.

• Release tooling only — pub.flutter-io.cn publishing moved to OIDC trusted publishing and the release tag trigger was fixed. No changes to plugin behaviour, Dart API, or native integration.

• Android: switched BBPlayerView to true Hybrid Composition (initExpensiveAndroidView) instead of Texture Layer Hybrid Composition. Taps on the native control-bar buttons (settings / fullscreen) in the channel detail player were being swallowed under TLHC's synthesised touch dispatch; Hybrid Composition routes touches natively to the embedded views. Also the correct mode for the player's SurfaceView output (required for 10-bit / HDR / secure playback).
• Android: bumped the native player SDK floor to 8.52.+ (was 8.50.+). BB native SDK 8.52 (PR #512) widened the player's host-activity check from AppCompatActivity to FragmentActivity, so the settings / track BottomSheet now shows under Flutter's FlutterFragmentActivity host. On 8.50.x the sheet silently never appeared (tap registered, no panel).

• Switched the package version to follow BB sprint release logic — the minor track now aligns with the BB native SDK (8.50.x for SDK 8.50). The previous v1.0.0 has been superseded; consumers should pin bb_player: ^8.50.0.
• Bumped native SDKs to 8.50.0 (iOS) and 8.50.+ (Android), aligning with the latest Blue Billywig native player kits.
• Reach parity with react-native-bb-player's public API surface:
  • LoadContext parameter on every loadWith* method (contextEntityType / contextEntityId / contextCollectionType / contextCollectionId).
  • loadWithContentIdAndType canonical loader with BBContentType enum (mediaclip/c, mediacliplist/l, project/p/pj).
  • New BBPlayerController methods: setInView, unload, updatePlayout, presentModal, closeModal, endCastSession.
  • New getters: getInView, getAdMediaWidth, getAdMediaHeight, getIsCasting, getCastDeviceName.
  • BBCastButton and BBCastMiniControls widgets (render an empty placeholder when the host activity isn't a FragmentActivity or the Cast SDK isn't linked).
  • Module-level BBModalPlayer API (present / dismiss / addEventListener).
  • addCastSessionListener for global Cast session events.
  • convertPlayoutUrlToMediaclipUrl utility.
• BBShortsViewOptions now accepts a typed BBShortsDisplayFormat (full/list/player), shelfStartSpacing, shelfEndSpacing, and skipShortsAdOnSwipe.
• BBOutstreamView: added real spring physics (damping/stiffness), none / layout animation types, isCollapsed getter, and animateCollapse/animateExpand aliases.
• Example app restructured into per-feature screens mirroring the React Native demo: Simple Player → API Reference → Shorts → Outstream Ads → Modal Player. Deep-link handler (bbplayer://watch/<id>) included.
• Docs split into per-feature guides under doc/guides/.
• Android: bumped to Kotlin 2.3.10 and enabled core-library desugaring (required by BB SDK 8.50+).
• iOS: marked platform-view classes @MainActor for Swift 6 strict concurrency.

Breaking #

• Apps using BBCastButton (or anything that mounts the Cast picker) must use FlutterFragmentActivity as the host activity (not the default FlutterActivity). See example/android/.../MainActivity.kt.

• Initial release
• BBPlayerView widget for video playback
• BBShortsView widget for vertical video (TikTok-style)
• BBOutstreamView widget for animated outstream ad placements
• Full playback controls (play, pause, seek, volume, fullscreen)
• 40+ event callbacks for playback, ads, analytics
• Async state queries (duration, currentTime, clipData, etc.)
• Content loading via clip ID, clip list, project, or JSON URL
• iOS support via BBNativePlayerKit (8.42.0)
• Android support via bbnativeplayersdk (8.42.+)
• Chromecast support on both platforms