Expose TweaksConfig.forceReuseVideoCodecReasons from Android

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Added
+
+- exposed `TweaksConfig.forceReuseVideoCodecReasons`
+
 ### Changed
 
 - Update Bitmovin's native Android SDK version to `3.92.0`

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

@@ -6,6 +6,7 @@ import com.bitmovin.analytics.api.CustomData
 import com.bitmovin.analytics.api.DefaultMetadata
 import com.bitmovin.analytics.api.SourceMetadata
 import com.bitmovin.player.api.DeviceDescription.DeviceName
+import com.bitmovin.player.api.ForceReuseVideoCodecReason
 import com.bitmovin.player.api.PlaybackConfig
 import com.bitmovin.player.api.PlayerConfig
 import com.bitmovin.player.api.TweaksConfig
@@ -167,6 +168,16 @@ fun ReadableMap.toStyleConfig(): StyleConfig = StyleConfig().apply {
     withString("scalingMode") { scalingMode = ScalingMode.valueOf(it) }
 }
 
+/**
+ * Converts any JS string into an `AdSourceType` enum value.
+ */
+private fun String.forceReuseVideoCodecReason(): ForceReuseVideoCodecReason? = when (this) {
+    "ColorInfoMismatch" -> ForceReuseVideoCodecReason.ColorInfoMismatch
+    "MaxInputSizeExceeded" -> ForceReuseVideoCodecReason.MaxInputSizeExceeded
+    "MaxResolutionExceeded" -> ForceReuseVideoCodecReason.MaxResolutionExceeded
+    else -> null
+}
+
 /**
  * Converts any JS object into a `TweaksConfig` object.
  */
@@ -189,6 +200,16 @@ fun ReadableMap.toTweaksConfig(): TweaksConfig = TweaksConfig().apply {
     withBoolean("useDrmSessionForClearSources") { useDrmSessionForClearSources = it }
     withBoolean("useFiletypeExtractorFallbackForHls") { useFiletypeExtractorFallbackForHls = it }
     withBoolean("preferSoftwareDecodingForAds") { preferSoftwareDecodingForAds = it }
+    withStringArray("forceReuseVideoCodecReasons") {
+        val mutableSet = mutableSetOf<ForceReuseVideoCodecReason>()
+        for (item in it) {
+            val reason = item?.forceReuseVideoCodecReason()
+            if (reason != null) {
+                mutableSet.add(reason)
+            }
+        }
+        forceReuseVideoCodecReasons = mutableSet
+    }
 }
 
 /**

src/tweaksConfig.ts

@@ -1,3 +1,21 @@
+/**
+ * The different reasons when the video codec should be reused.
+ */
+export enum ForceReuseVideoCodecReason {
+  /**
+   * The new video quality color information is not compatible.
+   */
+  ColorInfoMismatch = 'ColorInfoMismatch',
+  /**
+   * The new video quality exceed the decoder's configured maximum sample size.
+   */
+  MaxInputSizeExceeded = 'MaxInputSizeExceeded',
+  /**
+   * The new video quality exceed the decoder's configured maximum resolution.
+   */
+  MaxResolutionExceeded = 'MaxResolutionExceeded',
+}
+
 /**
  * This configuration is used as an incubator for experimental features. Tweaks are not officially
  * supported and are not guaranteed to be stable, i.e. their naming, functionality and API can
@@ -170,4 +188,14 @@ export interface TweaksConfig {
    * @platform iOS
    */
   updatesNowPlayingInfoCenter?: boolean;
+
+  /**
+   * When switching between video formats (eg: adapting between video qualities) the codec might be recreated due to several reasons.
+   * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.
+   *
+   * Default is `null` i.e not set
+   *
+   * @platform Android
+   */
+  forceReuseVideoCodecReasons?: Array<ForceReuseVideoCodecReason>;
 }