bitmovin-player-react-native 0.31.0 → 0.33.0

package/RNBitmovinPlayer.podspec

@@ -20,7 +20,7 @@ Pod::Spec.new do |s|
 
   s.swift_version = "5.10"
   s.dependency "React-Core"
-  s.dependency "BitmovinPlayer", "3.77.0"
+  s.dependency "BitmovinPlayer", "3.78.0"
   s.ios.dependency "GoogleAds-IMA-iOS-SDK", "3.23.0"
   s.tvos.dependency "GoogleAds-IMA-tvOS-SDK", "4.13.0"
 end

package/android/build.gradle

@@ -105,6 +105,6 @@ dependencies {
     // Bitmovin
     implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.33.0'
     implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
-    implementation 'com.bitmovin.player:player:3.91.0+jason'
-    implementation 'com.bitmovin.player:player-media-session:3.91.0+jason'
+    implementation 'com.bitmovin.player:player:3.94.0+jason'
+    implementation 'com.bitmovin.player:player-media-session:3.94.0+jason'
 }

package/android/src/main/java/com/bitmovin/player/reactnative/DebugModule.kt

@@ -0,0 +1,23 @@
+package com.bitmovin.player.reactnative
+
+import com.bitmovin.player.api.DebugConfig
+import com.facebook.react.bridge.*
+import com.facebook.react.module.annotations.ReactModule
+
+private const val MODULE_NAME = "DebugModule"
+
+@ReactModule(name = MODULE_NAME)
+class DebugModule(context: ReactApplicationContext) : BitmovinBaseModule(context) {
+    override fun getName() = MODULE_NAME
+
+    /**
+     * Enable/disable verbose logging for the console logger.
+     * @param enabled Whether to set verbose logging as enabled or disabled.
+     */
+    @ReactMethod
+    fun setDebugLoggingEnabled(enabled: Boolean, promise: Promise) {
+        promise.unit.resolveOnUiThread {
+            DebugConfig.isLoggingEnabled = enabled
+        }
+    }
+}

package/android/src/main/java/com/bitmovin/player/reactnative/NetworkModule.kt

@@ -1,5 +1,6 @@
 package com.bitmovin.player.reactnative
 
+import android.util.Log
 import androidx.concurrent.futures.CallbackToFutureAdapter
 import androidx.concurrent.futures.CallbackToFutureAdapter.Completer
 import com.bitmovin.player.api.network.HttpRequest
@@ -14,6 +15,7 @@ import com.bitmovin.player.reactnative.converter.toJson
 import com.bitmovin.player.reactnative.converter.toNetworkConfig
 import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
+import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.Future
 
 private const val MODULE_NAME = "NetworkModule"
@@ -25,8 +27,9 @@ class NetworkModule(context: ReactApplicationContext) : BitmovinBaseModule(conte
      * In-memory mapping from `nativeId`s to `NetworkConfig` instances.
      */
     private val networkConfigs: Registry<NetworkConfig> = mutableMapOf()
-    private val preprocessHttpRequestCompleters: MutableMap<String, Completer<HttpRequest>> = mutableMapOf()
-    private val preprocessHttpResponseCompleters: MutableMap<String, Completer<HttpResponse>> = mutableMapOf()
+    private val preprocessHttpRequestCompleters = ConcurrentHashMap<String, Completer<HttpRequest>>()
+    private val preprocessHttpResponseCompleters = ConcurrentHashMap<String, Completer<HttpResponse>>()
+
     override fun getName() = MODULE_NAME
 
     fun getConfig(nativeId: NativeId?): NetworkConfig? = nativeId?.let { networkConfigs[it] }
@@ -94,9 +97,14 @@ class NetworkModule(context: ReactApplicationContext) : BitmovinBaseModule(conte
 
     @ReactMethod
     fun setPreprocessedHttpRequest(requestId: String, request: ReadableMap) {
-        preprocessHttpRequestCompleters[requestId]?.set(request.toHttpRequest())
-        preprocessHttpRequestCompleters.remove(requestId)
+        val completer = preprocessHttpRequestCompleters.remove(requestId)
+        if (completer == null) {
+            Log.e(MODULE_NAME, "Completer is null for requestId: $requestId, this can cause stuck network requests")
+            return
+        }
+        completer.set(request.toHttpRequest())
     }
+
     private fun preprocessHttpResponseFromJS(
         nativeId: NativeId,
         type: HttpRequestType,

package/android/src/main/java/com/bitmovin/player/reactnative/RNPlayerViewManager.kt

@@ -248,7 +248,7 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
             val playbackConfig = playerConfig?.getMap("playbackConfig")
             val isPictureInPictureEnabled = view.config?.pictureInPictureConfig?.isEnabled == true ||
                 playbackConfig?.getBooleanOrNull("isPictureInPictureEnabled") == true
-            view.enableBackgroundPlayback = playbackConfig?.getBoolean("isBackgroundPlaybackEnabled") ?: false
+            view.enableBackgroundPlayback = playbackConfig?.getBooleanOrNull("isBackgroundPlaybackEnabled") == true
 
             val rnStyleConfigWrapper = playerConfig?.toRNStyleConfigWrapperFromPlayerConfig()
             val configuredPlayerViewConfig = view.config?.playerViewConfig ?: PlayerViewConfig()

package/android/src/main/java/com/bitmovin/player/reactnative/RNPlayerViewPackage.kt

@@ -30,6 +30,7 @@ class RNPlayerViewPackage : ReactPackage {
             BitmovinCastManagerModule(reactContext),
             BufferModule(reactContext),
             NetworkModule(reactContext),
+            DebugModule(reactContext),
         )
     }
 

package/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 `ForceReuseVideoCodecReason` enum value.
+ */
+private fun String.toForceReuseVideoCodecReason(): 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,12 @@ fun ReadableMap.toTweaksConfig(): TweaksConfig = TweaksConfig().apply {
     withBoolean("useDrmSessionForClearSources") { useDrmSessionForClearSources = it }
     withBoolean("useFiletypeExtractorFallbackForHls") { useFiletypeExtractorFallbackForHls = it }
     withBoolean("preferSoftwareDecodingForAds") { preferSoftwareDecodingForAds = it }
+    withStringArray("forceReuseVideoCodecReasons") {
+        forceReuseVideoCodecReasons = it
+            .filterNotNull()
+            .mapNotNull(String::toForceReuseVideoCodecReason)
+            .toSet()
+    }
 }
 
 /**

package/android/src/main/java/com/bitmovin/player/reactnative/services/MediaSessionPlaybackService.kt

@@ -4,6 +4,7 @@ import android.content.Intent
 import android.os.Binder
 import android.os.IBinder
 import com.bitmovin.player.api.Player
+import com.bitmovin.player.api.media.session.ControllerInfo
 import com.bitmovin.player.api.media.session.MediaSession
 import com.bitmovin.player.api.media.session.MediaSessionService
 
@@ -29,7 +30,7 @@ class MediaSessionPlaybackService : MediaSessionService() {
     private val binder = ServiceBinder()
     private var mediaSession: MediaSession? = null
 
-    override fun onGetSession(): MediaSession? = null
+    override fun onGetSession(controllerInfo: ControllerInfo) = null
 
     override fun onDestroy() {
         disconnectSession()

package/ios/DebugModule.m

@@ -0,0 +1,7 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_REMAP_MODULE(DebugModule, DebugModule, NSObject)
+
+RCT_EXTERN_METHOD(setDebugLoggingEnabled:(nonnull BOOL)enabled)
+
+@end

package/ios/DebugModule.swift

@@ -0,0 +1,33 @@
+import BitmovinPlayer
+
+@objc(DebugModule)
+public class DebugModule: NSObject, RCTBridgeModule {
+    // swiftlint:disable:next implicitly_unwrapped_optional
+    @objc public var bridge: RCTBridge!
+
+    // swiftlint:disable:next implicitly_unwrapped_optional
+    public static func moduleName() -> String! {
+        "DebugModule"
+    }
+
+    /// Module requires main thread initialization.
+    public static func requiresMainQueueSetup() -> Bool {
+        true
+    }
+
+    // swiftlint:disable:next implicitly_unwrapped_optional
+    public var methodQueue: DispatchQueue! {
+        bridge.uiManager.methodQueue
+    }
+}
+
+extension DebugModule {
+    /// Enable/disable verbose logging for the console logger.
+    /// - Parameter enabled: Whether to set verbose logging as enabled or disabled.
+    @objc(setDebugLoggingEnabled:)
+    func setDebugLoggingEnabled(enabled: Bool) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            DebugConfig.logging.logger?.level = enabled ? .verbose : .warning
+        }
+    }
+}

package/ios/FullscreenHandlerModule.swift

@@ -44,6 +44,7 @@ public class FullscreenHandlerModule: NSObject, RCTBridgeModule {
         fullscreenHandlers.removeValue(forKey: nativeId)
     }
 
+    @MainActor
     @objc(onFullscreenChanged:isFullscreenEnabled:)
     func onFullscreenChanged(_ nativeId: NativeId, isFullscreenEnabled: Bool) -> Any? {
         fullscreenHandlers[nativeId]?.isFullscreen = isFullscreenEnabled
@@ -51,12 +52,14 @@ public class FullscreenHandlerModule: NSObject, RCTBridgeModule {
         return nil
     }
 
+    @MainActor
     @objc(registerHandler:)
     func registerHandler(_ nativeId: NativeId) {
         guard fullscreenHandlers[nativeId] == nil else { return }
         fullscreenHandlers[nativeId] = FullscreenHandlerBridge(nativeId, bridge: bridge)
     }
 
+    @MainActor
     @objc(setIsFullscreenActive:isFullscreen:)
     func setIsFullscreenActive(_ nativeId: NativeId, isFullscreen: Bool) {
         fullscreenHandlers[nativeId]?.isFullscreen = isFullscreen

package/ios/RNPlayerViewManager.swift

@@ -200,6 +200,7 @@ public class RNPlayerViewManager: RCTViewManager {
         bridge.module(for: FullscreenHandlerModule.self) as? FullscreenHandlerModule
     }
 
+    @MainActor
     private func maybeEmitPictureInPictureAvailabilityEvent(for view: RNPlayerView, previousState: Bool) {
         guard let playerView = view.playerView,
               playerView.isPictureInPictureAvailable != previousState else {

package/lib/index.d.mts

@@ -2778,6 +2778,29 @@ declare enum UserInterfaceType {
     Subtitle = "Subtitle"
 }
 
+/**
+ * When switching the video quality, the video decoder's configuration might change
+ * as the player can't always know if the codec supports such configuration change, it destroys and recreates it.
+ * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.
+ *
+ * If a codec is know to support a given configuration change without issues,
+ * the configuration can be added to the `TweaksConfig.forceReuseVideoCodecReasons`
+ * to always reuse the video codec and avoid the black screen.
+ */
+declare 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
@@ -2950,6 +2973,20 @@ 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.
+     *
+     * If a device is know to support video format changes and keep the current decoder without issues,
+     * this set can be filled with multiple `ForceReuseVideoCodecReason` and avoid the black screen.
+     *
+     * Default is `null` i.e not set
+     *
+     * @platform Android
+     */
+    forceReuseVideoCodecReasons?: Array<ForceReuseVideoCodecReason>;
 }
 
 /**
@@ -3996,4 +4033,50 @@ declare class Network extends NativeInstance<NetworkConfig> {
     onPreprocessHttpResponse: (responseId: string, type: HttpRequestType, response: HttpResponse) => void;
 }
 
-export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaControlConfig, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };
+/**
+ * Global debug configuration for all Bitmovin components.
+ */
+declare class DebugConfig {
+    private static _isDebugEnabled;
+    /**
+     * Retrieves the current debug logging state.
+     *
+     * @returns `true` if debug logging is enabled, otherwise `false`.
+     */
+    static get isDebugLoggingEnabled(): boolean;
+    /**
+     * Enables or disables global debug logging for all Bitmovin components.
+     *
+     * Debug logging provides detailed information primarily for debugging purposes,
+     * helping to diagnose problems and trace the flow of execution within the Player.
+     *
+     * ### Warning:
+     * This option **should not be enabled in production** as it may log sensitive or confidential
+     * information to the console.
+     *
+     * ## Platform-Specific Logging Behavior
+     * ---
+     * - **iOS:** logs are printed using `NSLog` at the verbose log level.
+     * - **Android:** logs are printed using `android.util.Log` with the following tags:
+     *   - `BitmovinPlayer`
+     *   - `BitmovinPlayerView`
+     *   - `BitmovinOffline`
+     *   - `BitmovinSource`
+     *   - `BitmovinExoPlayer`
+     *
+     * ## Limitations
+     * ---
+     * **Android**
+     * - This flag **must** be set **before** creating any Bitmovin component to take effect.
+     *
+     * ## Usage Notes
+     * ---
+     * - We recommend setting this flag during your app's initialization phase, such as in the
+     *   application's entry point (e.g. `App.tsx`).
+     *
+     * @defaultValue `false`
+     */
+    static setDebugLoggingEnabled(value: boolean): Promise<void>;
+}
+
+export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaControlConfig, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };

package/lib/index.d.ts

@@ -2778,6 +2778,29 @@ declare enum UserInterfaceType {
     Subtitle = "Subtitle"
 }
 
+/**
+ * When switching the video quality, the video decoder's configuration might change
+ * as the player can't always know if the codec supports such configuration change, it destroys and recreates it.
+ * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.
+ *
+ * If a codec is know to support a given configuration change without issues,
+ * the configuration can be added to the `TweaksConfig.forceReuseVideoCodecReasons`
+ * to always reuse the video codec and avoid the black screen.
+ */
+declare 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
@@ -2950,6 +2973,20 @@ 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.
+     *
+     * If a device is know to support video format changes and keep the current decoder without issues,
+     * this set can be filled with multiple `ForceReuseVideoCodecReason` and avoid the black screen.
+     *
+     * Default is `null` i.e not set
+     *
+     * @platform Android
+     */
+    forceReuseVideoCodecReasons?: Array<ForceReuseVideoCodecReason>;
 }
 
 /**
@@ -3996,4 +4033,50 @@ declare class Network extends NativeInstance<NetworkConfig> {
     onPreprocessHttpResponse: (responseId: string, type: HttpRequestType, response: HttpResponse) => void;
 }
 
-export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaControlConfig, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };
+/**
+ * Global debug configuration for all Bitmovin components.
+ */
+declare class DebugConfig {
+    private static _isDebugEnabled;
+    /**
+     * Retrieves the current debug logging state.
+     *
+     * @returns `true` if debug logging is enabled, otherwise `false`.
+     */
+    static get isDebugLoggingEnabled(): boolean;
+    /**
+     * Enables or disables global debug logging for all Bitmovin components.
+     *
+     * Debug logging provides detailed information primarily for debugging purposes,
+     * helping to diagnose problems and trace the flow of execution within the Player.
+     *
+     * ### Warning:
+     * This option **should not be enabled in production** as it may log sensitive or confidential
+     * information to the console.
+     *
+     * ## Platform-Specific Logging Behavior
+     * ---
+     * - **iOS:** logs are printed using `NSLog` at the verbose log level.
+     * - **Android:** logs are printed using `android.util.Log` with the following tags:
+     *   - `BitmovinPlayer`
+     *   - `BitmovinPlayerView`
+     *   - `BitmovinOffline`
+     *   - `BitmovinSource`
+     *   - `BitmovinExoPlayer`
+     *
+     * ## Limitations
+     * ---
+     * **Android**
+     * - This flag **must** be set **before** creating any Bitmovin component to take effect.
+     *
+     * ## Usage Notes
+     * ---
+     * - We recommend setting this flag during your app's initialization phase, such as in the
+     *   application's entry point (e.g. `App.tsx`).
+     *
+     * @defaultValue `false`
+     */
+    static setDebugLoggingEnabled(value: boolean): Promise<void>;
+}
+
+export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaControlConfig, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };

package/lib/index.js

@@ -44,7 +44,9 @@ __export(src_exports, {
   BufferType: () => BufferType,
   CustomMessageHandler: () => CustomMessageHandler,
   CustomUi: () => CustomUi,
+  DebugConfig: () => DebugConfig,
   Drm: () => Drm,
+  ForceReuseVideoCodecReason: () => ForceReuseVideoCodecReason,
   HttpRequestType: () => HttpRequestType,
   LoadingState: () => LoadingState,
   MediaType: () => MediaType,
@@ -1713,6 +1715,66 @@ var BitmovinCastManager = {
     return BitmovinCastManagerModule.sendMessage(message, messageNamespace);
   }
 };
+
+// src/tweaksConfig.ts
+var ForceReuseVideoCodecReason = /* @__PURE__ */ ((ForceReuseVideoCodecReason2) => {
+  ForceReuseVideoCodecReason2["ColorInfoMismatch"] = "ColorInfoMismatch";
+  ForceReuseVideoCodecReason2["MaxInputSizeExceeded"] = "MaxInputSizeExceeded";
+  ForceReuseVideoCodecReason2["MaxResolutionExceeded"] = "MaxResolutionExceeded";
+  return ForceReuseVideoCodecReason2;
+})(ForceReuseVideoCodecReason || {});
+
+// src/debug.ts
+var import_react_native16 = require("react-native");
+var DebugModule = import_react_native16.NativeModules.DebugModule;
+var _DebugConfig = class _DebugConfig {
+  /**
+   * Retrieves the current debug logging state.
+   *
+   * @returns `true` if debug logging is enabled, otherwise `false`.
+   */
+  static get isDebugLoggingEnabled() {
+    return _DebugConfig._isDebugEnabled;
+  }
+  /**
+   * Enables or disables global debug logging for all Bitmovin components.
+   *
+   * Debug logging provides detailed information primarily for debugging purposes,
+   * helping to diagnose problems and trace the flow of execution within the Player.
+   *
+   * ### Warning:
+   * This option **should not be enabled in production** as it may log sensitive or confidential
+   * information to the console.
+   *
+   * ## Platform-Specific Logging Behavior
+   * ---
+   * - **iOS:** logs are printed using `NSLog` at the verbose log level.
+   * - **Android:** logs are printed using `android.util.Log` with the following tags:
+   *   - `BitmovinPlayer`
+   *   - `BitmovinPlayerView`
+   *   - `BitmovinOffline`
+   *   - `BitmovinSource`
+   *   - `BitmovinExoPlayer`
+   *
+   * ## Limitations
+   * ---
+   * **Android**
+   * - This flag **must** be set **before** creating any Bitmovin component to take effect.
+   *
+   * ## Usage Notes
+   * ---
+   * - We recommend setting this flag during your app's initialization phase, such as in the
+   *   application's entry point (e.g. `App.tsx`).
+   *
+   * @defaultValue `false`
+   */
+  static async setDebugLoggingEnabled(value) {
+    _DebugConfig._isDebugEnabled = value;
+    await DebugModule.setDebugLoggingEnabled(value);
+  }
+};
+__publicField(_DebugConfig, "_isDebugEnabled", false);
+var DebugConfig = _DebugConfig;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdQuartile,
@@ -1724,7 +1786,9 @@ var BitmovinCastManager = {
   BufferType,
   CustomMessageHandler,
   CustomUi,
+  DebugConfig,
   Drm,
+  ForceReuseVideoCodecReason,
   HttpRequestType,
   LoadingState,
   MediaType,

package/lib/index.mjs

@@ -1659,6 +1659,66 @@ var BitmovinCastManager = {
     return BitmovinCastManagerModule.sendMessage(message, messageNamespace);
   }
 };
+
+// src/tweaksConfig.ts
+var ForceReuseVideoCodecReason = /* @__PURE__ */ ((ForceReuseVideoCodecReason2) => {
+  ForceReuseVideoCodecReason2["ColorInfoMismatch"] = "ColorInfoMismatch";
+  ForceReuseVideoCodecReason2["MaxInputSizeExceeded"] = "MaxInputSizeExceeded";
+  ForceReuseVideoCodecReason2["MaxResolutionExceeded"] = "MaxResolutionExceeded";
+  return ForceReuseVideoCodecReason2;
+})(ForceReuseVideoCodecReason || {});
+
+// src/debug.ts
+import { NativeModules as NativeModules13 } from "react-native";
+var DebugModule = NativeModules13.DebugModule;
+var _DebugConfig = class _DebugConfig {
+  /**
+   * Retrieves the current debug logging state.
+   *
+   * @returns `true` if debug logging is enabled, otherwise `false`.
+   */
+  static get isDebugLoggingEnabled() {
+    return _DebugConfig._isDebugEnabled;
+  }
+  /**
+   * Enables or disables global debug logging for all Bitmovin components.
+   *
+   * Debug logging provides detailed information primarily for debugging purposes,
+   * helping to diagnose problems and trace the flow of execution within the Player.
+   *
+   * ### Warning:
+   * This option **should not be enabled in production** as it may log sensitive or confidential
+   * information to the console.
+   *
+   * ## Platform-Specific Logging Behavior
+   * ---
+   * - **iOS:** logs are printed using `NSLog` at the verbose log level.
+   * - **Android:** logs are printed using `android.util.Log` with the following tags:
+   *   - `BitmovinPlayer`
+   *   - `BitmovinPlayerView`
+   *   - `BitmovinOffline`
+   *   - `BitmovinSource`
+   *   - `BitmovinExoPlayer`
+   *
+   * ## Limitations
+   * ---
+   * **Android**
+   * - This flag **must** be set **before** creating any Bitmovin component to take effect.
+   *
+   * ## Usage Notes
+   * ---
+   * - We recommend setting this flag during your app's initialization phase, such as in the
+   *   application's entry point (e.g. `App.tsx`).
+   *
+   * @defaultValue `false`
+   */
+  static async setDebugLoggingEnabled(value) {
+    _DebugConfig._isDebugEnabled = value;
+    await DebugModule.setDebugLoggingEnabled(value);
+  }
+};
+__publicField(_DebugConfig, "_isDebugEnabled", false);
+var DebugConfig = _DebugConfig;
 export {
   AdQuartile,
   AdSourceType,
@@ -1669,7 +1729,9 @@ export {
   BufferType,
   CustomMessageHandler,
   CustomUi,
+  DebugConfig,
   Drm,
+  ForceReuseVideoCodecReason,
   HttpRequestType,
   LoadingState,
   MediaType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitmovin-player-react-native",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "Official React Native bindings for Bitmovin's mobile Player SDKs.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",

package/src/debug.ts

@@ -0,0 +1,56 @@
+import { NativeModules } from 'react-native';
+
+const DebugModule = NativeModules.DebugModule;
+
+/**
+ * Global debug configuration for all Bitmovin components.
+ */
+export class DebugConfig {
+  private static _isDebugEnabled = false;
+
+  /**
+   * Retrieves the current debug logging state.
+   *
+   * @returns `true` if debug logging is enabled, otherwise `false`.
+   */
+  static get isDebugLoggingEnabled(): boolean {
+    return DebugConfig._isDebugEnabled;
+  }
+
+  /**
+   * Enables or disables global debug logging for all Bitmovin components.
+   *
+   * Debug logging provides detailed information primarily for debugging purposes,
+   * helping to diagnose problems and trace the flow of execution within the Player.
+   *
+   * ### Warning:
+   * This option **should not be enabled in production** as it may log sensitive or confidential
+   * information to the console.
+   *
+   * ## Platform-Specific Logging Behavior
+   * ---
+   * - **iOS:** logs are printed using `NSLog` at the verbose log level.
+   * - **Android:** logs are printed using `android.util.Log` with the following tags:
+   *   - `BitmovinPlayer`
+   *   - `BitmovinPlayerView`
+   *   - `BitmovinOffline`
+   *   - `BitmovinSource`
+   *   - `BitmovinExoPlayer`
+   *
+   * ## Limitations
+   * ---
+   * **Android**
+   * - This flag **must** be set **before** creating any Bitmovin component to take effect.
+   *
+   * ## Usage Notes
+   * ---
+   * - We recommend setting this flag during your app's initialization phase, such as in the
+   *   application's entry point (e.g. `App.tsx`).
+   *
+   * @defaultValue `false`
+   */
+  static async setDebugLoggingEnabled(value: boolean): Promise<void> {
+    DebugConfig._isDebugEnabled = value;
+    await DebugModule.setDebugLoggingEnabled(value);
+  }
+}

package/src/index.ts

@@ -25,3 +25,4 @@ export * from './liveConfig';
 export * from './bufferApi';
 export * from './network';
 export * from './mediaControlConfig';
+export * from './debug';

package/src/tweaksConfig.ts

@@ -1,3 +1,27 @@
+/**
+ * When switching the video quality, the video decoder's configuration might change
+ * as the player can't always know if the codec supports such configuration change, it destroys and recreates it.
+ * This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.
+ *
+ * If a codec is know to support a given configuration change without issues,
+ * the configuration can be added to the `TweaksConfig.forceReuseVideoCodecReasons`
+ * to always reuse the video codec and avoid the black screen.
+ */
+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 +194,19 @@ 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.
+   *
+   * If a device is know to support video format changes and keep the current decoder without issues,
+   * this set can be filled with multiple `ForceReuseVideoCodecReason` and avoid the black screen.
+   *
+   * Default is `null` i.e not set
+   *
+   * @platform Android
+   */
+  forceReuseVideoCodecReasons?: Array<ForceReuseVideoCodecReason>;
 }