Merge pull request #509 from bitmovin/feat/initialBandwidthEstimateOv…

…erride

Feat/initial bandwidth estimate override

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [Unreleased]
+
+### Added
+
+- Android: `AdaptationConfig.initialBandwidthEstimateOverride` to override the selection of the optimal media tracks before actual bandwidth data is available
+
 ## [0.28.0] - 2024-08-07
 
 ### Added

android/src/main/java/com/bitmovin/player/reactnative/converter/JsonConverter.kt

@@ -144,6 +144,7 @@ private fun String.toTimelineReferencePoint(): TimelineReferencePoint? = when (t
  */
 private fun ReadableMap.toAdaptationConfig(): AdaptationConfig = AdaptationConfig().apply {
     withInt("maxSelectableBitrate") { maxSelectableVideoBitrate = it }
+    withInt("initialBandwidthEstimateOverride") { initialBandwidthEstimateOverride = it.toLong(); }
 }
 
 /**

src/adaptationConfig.ts

@@ -7,4 +7,12 @@ export interface AdaptationConfig {
    * Can be set to `undefined` for no limitation.
    */
   maxSelectableBitrate?: number;
+
+  /**
+   * The initial bandwidth estimate in bits per second the player uses to select the optimal media tracks before actual bandwidth data is available. Overriding this value should only be done in specific cases and will most of the time not result in better selection logic.
+   *
+   * @platform Android
+   * @see https://cdn.bitmovin.com/player/android/3/docs/player-core/com.bitmovin.player.api.media/-adaptation-config/initial-bandwidth-estimate-override.html
+   */
+  initialBandwidthEstimateOverride?: number;
 }