Supported versions
Minor releases land together on every platform; patch versions move independently per platform (a platform-specific fix ships only where it applies).
Android
Section titled “Android”| OGPlayer Android | Media3 / ExoPlayer | Google IMA | Min Android | Kotlin |
|---|---|---|---|---|
| 1.3.0 – 1.6.0 | 1.11.1 | via media3-exoplayer-ima 1.11.1 | 8.0 (API 26); Android TV, Google TV and Fire TV on the same artifacts | 2.1+ |
| 1.2.1 – 1.2.2 | 1.11.1 | via media3-exoplayer-ima 1.11.1 | 8.0 (API 26) | 2.1+ |
| 1.0.x – 1.2.0 | 1.11.0 | via media3-exoplayer-ima 1.11.0 | 8.0 (API 26) | 2.1+ |
Notes: the SDK depends on Media3 as a normal Gradle dependency — your app can force a newer patch release via dependency resolution, and we track Media3 minor releases closely. Media3 requires core-library desugaring in your app module:
android { compileOptions { isCoreLibraryDesugaringEnabled = true }}dependencies { coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")}Android artifacts are served from the OGPlayer Maven repository from 1.6.0 on
(maven("https://maven.ogplayer.tv") { content { includeGroup("tv.ogplayer") } }
in your settings.gradle.kts repositories); 1.0.0 – 1.5.0 resolve from Maven
Central.
FreeWheel’s FWAdManager.aar is customer-supplied — OGPlayer compiles
against AdManager 7.12.x; keep your AAR on that line.
| OGPlayer iOS | Engine | Google IMA | Min iOS | Swift |
|---|---|---|---|---|
| 1.3.0 – 1.6.0 | AVFoundation (system) | 3.18+ (SPM, resolves 3.33.x); tvOS: 4.17+ | iOS 18 (iPhone XS/XR 2018 and newer); tvOS 18 (Apple TV HD and 4K) | 5.9+ |
| 1.0.x – 1.2.x | AVFoundation (system) | 3.18+ (SPM, resolves 3.33.x) | iOS 18 (iPhone XS/XR 2018 and newer) | 5.9+ |
Notes: the playback engine is the system AVFoundation — no bundled engine to
version. The FreeWheel adapter compiles against your licensed
AdManager.framework (6.x tested).
React Native
Section titled “React Native”| ogplayer-react-native | Wraps | React Native | Notes |
|---|---|---|---|
| 1.6.x | Android SDK 1.6.0 · iOS SDK 1.6.0 | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
| 1.5.x | Android SDK 1.5.0 · iOS SDK 1.5.0 | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
| 1.4.x | Android SDK 1.4.1 · iOS SDK 1.4.1 | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
| 1.2.x | Android SDK 1.2.x · iOS SDK 1.2.x | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
| 1.1.x | Android SDK 1.1.x · iOS SDK 1.1.x | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
| 1.0.x | Android SDK 1.0.x · iOS SDK 1.0.x | 0.80+ (New Architecture) | consuming apps need the Android requirements above (minSdk 26, desugaring) and iOS 18+ |
Notes: the wrapper contains no playback code of its own — pod install
fetches the official iOS XCFrameworks and Gradle resolves the Android
artifacts from the OGPlayer Maven repository (1.6.0 on; earlier releases from
Maven Central). Each release’s notes state exactly which
native versions it wraps.
Flutter
Section titled “Flutter”| ogplayer_flutter | Wraps | Flutter | Notes |
|---|---|---|---|
| 1.6.1 | Android SDK 1.6.0 · iOS SDK 1.6.0 | 3.29+ (Dart 3.7+) | consuming apps need the Android requirements above (minSdk 26, compileSdk 36, Kotlin 2.1+, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
| 1.6.0 | Android SDK 1.6.0 · iOS SDK 1.6.0 | Dart 3.13+ (a Flutter release that ships it) | consuming apps need the Android requirements above (minSdk 26, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
| 1.5.x | Android SDK 1.5.0 · iOS SDK 1.5.0 | Dart 3.13+ (a Flutter release that ships it) | consuming apps need the Android requirements above (minSdk 26, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
| 1.4.x | Android SDK 1.4.1 · iOS SDK 1.4.1 | Dart 3.13+ (a Flutter release that ships it) | consuming apps need the Android requirements above (minSdk 26, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
| 1.2.x | Android SDK 1.2.x · iOS SDK 1.2.x | Dart 3.13+ (a Flutter release that ships it) | consuming apps need the Android requirements above (minSdk 26, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
| 1.1.x | Android SDK 1.1.x · iOS SDK 1.1.2+ | Dart 3.13+ (a Flutter release that ships it) | consuming apps need the Android requirements above (minSdk 26, desugaring, a FlutterFragmentActivity host) and iOS 18+ |
Notes: the plugin contains no playback code of its own — Gradle resolves the Android artifacts from the OGPlayer Maven repository (1.6.0 on; earlier releases from Maven Central) and Swift Package Manager resolves the iOS frameworks (the XCFrameworks also travel inside the package for CocoaPods hosts). Each release’s notes state exactly which native versions it wraps.
| OGPlayer Web | Engines | Min browsers | TypeScript types |
|---|---|---|---|
| 1.6.x | hls.js 1.7+, dash.js 5.2 (DASH, loaded on demand) | evergreen Chrome / Edge / Firefox, Safari 16+; ogplayer/tv: Samsung Tizen 5.5+ and LG webOS 5+ (Chromium 68/69) | TS 5.x |
| 1.5.x | hls.js 1.7+ | evergreen Chrome / Edge / Firefox, Safari 16+; ogplayer/tv: Samsung Tizen 5.5+ and LG webOS 5+ (Chromium 68/69) | TS 5.x |
| 1.0.x – 1.4.x | hls.js 1.7+ | evergreen Chrome / Edge / Firefox, Safari 16+ | TS 5.x |
Notes: hls.js ships inside the bundle (or as a normal npm dependency for the
ESM build); Safari uses its native HLS pipeline instead. dash.js ships inside
the package as a separate file that loads only when a DASH item plays —
nothing extra to install, and HLS-only pages never download it. Google IMA
(ima3.js) and FreeWheel (AdManager.js) load at runtime from their vendors’
CDNs, per those vendors’ terms.
Smart TV
Section titled “Smart TV”TV support ships inside the platform SDKs — same artifacts, same version numbers.
| TV platform | Ships in | Minimum |
|---|---|---|
| Android TV, Google TV, Fire TV | OGPlayer Android 1.3.0 and newer (same artifacts) | Android 8.0 (API 26) |
| Apple TV | OGPlayer iOS 1.3.0 and newer (tvOS product of the same package) | tvOS 18 (Apple TV HD and 4K) |
| Samsung Tizen | OGPlayer Web 1.5.0 and newer, ogplayer/tv bundle | Tizen 5.5 (2020 models and newer) |
| LG webOS | OGPlayer Web 1.5.0 and newer, ogplayer/tv bundle | webOS 5 (2020 models and newer) |