react-native-theoplayer 2.11.0 → 2.12.1

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.12.1] - 23-09-14
+
+### Fixed
+
+- Fixed an issue on Android where the player SDK dependency could resolve to version 6.+.
+- Fixed an issue on iOS where the player integration dependencies could resolve to version 6.+.
+
+## [2.12.0] - 23-09-04
+
+### Added
+
+- Added an `AnalyticsDescription` property to `SourceDescription` to configure additional source-specific properties for analytics connectors.
+- Added support for sideloaded webVTT and SRT texttracks on iOS.
+- Added Audio Focus for Android, pausing play-out on audio focus loss and resuming play-out once focus has been regained.
+- Added Audio Focus and Audio Becoming Noisy manager for Android.
+
+### Fixed
+
+- Fixed an issue on Android that would cause the player not to reset when setting an empty source.
+- Fixed an issue where a text track cue was not properly removed from the cue list on a TextTrackEventType.REMOVE_CUE event.
+- Fixed an issue on tvOS that allowed the user to pause a CSAI ad using the apple remote control.
+- Fixed an issue on iOS where the cue event listeners were not cleanup up when destroying the player instance, resulting in memory build-up.
+
 ## [2.11.0] - 23-08-10
 
 ### Added

package/README.md

@@ -9,9 +9,9 @@ This projects falls under the license as defined in https://github.com/THEOplaye
 ## Table of Contents
 
 1. [Overview](#overview)
-1. [How to use these guides](#how-to-use-these-guides)
-1. [Prerequisites](#prerequisites)
-2. [Getting Started](#getting-started)
+2. [How to use these guides](#how-to-use-these-guides)
+3. [Prerequisites](#prerequisites)
+4. [Getting Started](#getting-started)
 
 ## Overview
 
@@ -58,9 +58,11 @@ functionality. Currently, the following connectors are available:
 | Package name                                                                                                              | Purpose                                              | Registry                                                                                                                                                      |
 |---------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | [`@theoplayer/react-native-analytics-adobe`](https://github.com/THEOplayer/react-native-theoplayer-analytics)             | Adobe analytics connector                            | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-adobe)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-adobe)       |
+| [`@theoplayer/react-native-analytics-agama`](https://github.com/THEOplayer/react-native-theoplayer-analytics)             | Agama analytics connector                            | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-agama)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-agama)       |
 | [`@theoplayer/react-native-analytics-comscore`](https://github.com/THEOplayer/react-native-theoplayer-analytics)          | Comscore analytics connector                         | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-comscore)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-comscore) |
 | [`@theoplayer/react-native-analytics-conviva`](https://github.com/THEOplayer/react-native-theoplayer-analytics)           | Conviva analytics connector                          | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-conviva)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-conviva)   |
 | [`@theoplayer/react-native-analytics-nielsen`](https://github.com/THEOplayer/react-native-theoplayer-analytics)           | Nielsen analytics connector                          | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-nielsen)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-nielsen)   |
+| [`@theoplayer/react-native-analytics-youbora`](https://github.com/THEOplayer/react-native-theoplayer-analytics)           | Youbora analytics connector                          | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-youbora)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-youbora)   |
 | [`@theoplayer/react-native-drm`](https://github.com/THEOplayer/react-native-theoplayer-drm)                               | Content protection (DRM) connectors                  | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-drm)](https://www.npmjs.com/package/@theoplayer/react-native-drm)                               |
 | [`@theoplayer/react-native-ui`](https://github.com/THEOplayer/react-native-theoplayer-ui)                                 | React Native user interface                          | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-ui)](https://www.npmjs.com/package/@theoplayer/react-native-ui)                                 |
 | [`@theoplayer/react-native-connector-template`](https://github.com/THEOplayer/react-native-theoplayer-connector-template) | A template for `react-native-theoplayer` connectors. | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-connector-template)](https://www.npmjs.com/package/@theoplayer/react-native-connector-template) |
@@ -83,6 +85,7 @@ and discussed in the next section. Finally, an overview of features, limitations
 - Knowledge Base
   - [Adaptive Bitrate (ABR)](./doc/abr.md)
   - [Advertisements](./doc/ads.md)
+  - [Audio Control Management](./doc/audio-control.md)
   - [Background playback and notifications](./doc/background.md)
   - [Casting with Chromecast and Airplay](./doc/cast.md)
   - [Custom iOS framework](./doc/custom-ios-framework.md)

package/android/build.gradle

@@ -105,8 +105,8 @@ dependencies {
   implementation "com.theoplayer.theoplayer-sdk-android:ads-wrapper:4.8.0"
   implementation "androidx.appcompat:appcompat:1.4.+"
 
-  // The minimum supported version is 5.0.1
-  def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[5.0.1,)')
+  // The minimum supported version is 5.10.0
+  def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[5.10,6.0)')
 
 //  def theoplayer_mediasession_version = safeExtGet('THEOplayer_mediasession', theoplayer_sdk_version)
   def theoplayer_mediasession_version = "5.2.0-local"

package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt

@@ -27,6 +27,8 @@ import com.theoplayer.android.api.event.EventListener
 import com.theoplayer.android.api.event.player.*
 import com.theoplayer.android.api.player.Player
 import com.theoplayer.android.connector.mediasession.MediaSessionConnector
+import com.theoplayer.audio.AudioBecomingNoisyManager
+import com.theoplayer.audio.AudioFocusManager
 import com.theoplayer.audio.BackgroundAudioConfig
 import com.theoplayer.media.MediaPlaybackService
 import java.util.concurrent.atomic.AtomicBoolean
@@ -49,6 +51,11 @@ class ReactTHEOplayerContext private constructor(
   private var isBound = AtomicBoolean()
   private var binder: MediaPlaybackService.MediaPlaybackBinder? = null
   private var mediaSessionConnector: MediaSessionConnector? = null
+  private var audioBecomingNoisyManager = AudioBecomingNoisyManager(reactContext) {
+    // Audio is about to become 'noisy' due to a change in audio outputs: pause the player
+    player.pause()
+  }
+  private var audioFocusManager: AudioFocusManager? = null
 
   var backgroundAudioConfig: BackgroundAudioConfig = BackgroundAudioConfig(enabled = false)
     set(value) {
@@ -207,6 +214,8 @@ class ReactTHEOplayerContext private constructor(
     addIntegrations(playerConfig)
     addListeners()
 
+    audioFocusManager = AudioFocusManager(reactContext, player)
+
     if (!BuildConfig.USE_PLAYBACK_SERVICE || !isBackgroundAudioEnabled) {
       initDefaultMediaSession()
     }
@@ -282,11 +291,14 @@ class ReactTHEOplayerContext private constructor(
     }
     binder?.updateNotification(PlaybackStateCompat.STATE_PLAYING)
     applyAllowedMediaControls()
+    audioBecomingNoisyManager.setEnabled(true)
+    audioFocusManager?.retrieveAudioFocus()
   }
 
   private val onPause = EventListener<PauseEvent> {
     binder?.updateNotification(PlaybackStateCompat.STATE_PAUSED)
     applyAllowedMediaControls()
+    audioBecomingNoisyManager.setEnabled(false)
   }
 
   private fun addListeners() {
@@ -334,6 +346,7 @@ class ReactTHEOplayerContext private constructor(
   fun onHostResume() {
     mediaSessionConnector?.setActive(true)
     playerView.onResume()
+    audioFocusManager?.retrieveAudioFocus()
   }
 
   fun destroy() {
@@ -346,6 +359,7 @@ class ReactTHEOplayerContext private constructor(
       // Unbind client from background service so it can stop
       unbindMediaPlaybackService()
     }
+    audioFocusManager?.abandonAudioFocus()
     mediaSessionConnector?.destroy()
     playerView.onDestroy()
   }

package/android/src/main/java/com/theoplayer/ReactTHEOplayerView.kt

@@ -130,9 +130,7 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
     try {
       val sourceDescription = SourceAdapter().parseSourceFromJS(source)
       adsApi.setSource(sourceDescription)
-      if (sourceDescription != null) {
-        player?.source = sourceDescription
-      }
+      player?.source = sourceDescription
     } catch (exception: THEOplayerException) {
       Log.e(TAG, exception.message ?: "")
       eventEmitter.emitError(exception)

package/android/src/main/java/com/theoplayer/audio/AudioFocusManager.kt

@@ -0,0 +1,145 @@
+package com.theoplayer.audio
+
+import android.app.UiModeManager
+import android.content.Context
+import android.content.res.Configuration
+import android.media.AudioManager
+import android.util.Log
+import androidx.media.AudioAttributesCompat
+import androidx.media.AudioFocusRequestCompat
+import androidx.media.AudioManagerCompat
+import com.theoplayer.BuildConfig
+import com.theoplayer.android.api.player.Player
+
+private const val TAG = "AudioFocusManager"
+
+/**
+ * Manages audio focus for the application, ensuring proper handling of audio focus changes
+ * to control media playback behavior.
+ *
+ * @param context The context used to access system services.
+ * @param player The media player instance associated with this audio focus manager. It can be
+ *               provided optionally to control playback behavior.
+ */
+class AudioFocusManager(
+  context: Context,
+  private val player: Player? = null
+) : AudioManager.OnAudioFocusChangeListener {
+
+  private val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as? AudioManager
+  private val uiModeManager = context.getSystemService(Context.UI_MODE_SERVICE) as? UiModeManager
+  private var resumeOnFocusGain = false
+  private val focusLock = Any()
+
+  private val audioFocusRequest = AudioFocusRequestCompat.Builder(AudioManagerCompat.AUDIOFOCUS_GAIN)
+    .setAudioAttributes(
+      AudioAttributesCompat.Builder()
+        // Usage value to use when the usage is media, such as music, or movie soundtracks.
+        .setUsage(AudioAttributesCompat.USAGE_MEDIA)
+        // Content type value to use when the content type is a soundtrack, typically accompanying
+        // a movie or TV program.
+        .setContentType(AudioAttributesCompat.CONTENT_TYPE_MOVIE)
+        .build()
+    )
+    .setOnAudioFocusChangeListener(this)
+    .setWillPauseWhenDucked(true)
+    .build()
+
+  /**
+   * Called on the listener to notify it the audio focus for this listener has been changed.
+   */
+  override fun onAudioFocusChange(focusChange: Int) {
+    if (uiModeManager?.currentModeType == Configuration.UI_MODE_TYPE_TELEVISION) {
+      // Ignore changes in audioFocus for Connected TVs.
+      return
+    }
+    if (BuildConfig.DEBUG) {
+      Log.d(TAG, "onAudioFocusChange: ${fromAudioFocusChange(focusChange)}")
+    }
+    when (focusChange) {
+      // Used to indicate a gain of audio focus, or a request of audio focus, of unknown duration.
+      AudioManager.AUDIOFOCUS_GAIN -> {
+        if (resumeOnFocusGain) {
+          synchronized(focusLock) {
+            // Reset resume flag
+            resumeOnFocusGain = false
+          }
+          player?.play()
+        }
+      }
+
+      // Used to indicate a loss of audio focus of unknown duration.
+      AudioManager.AUDIOFOCUS_LOSS -> {
+        synchronized (focusLock) {
+          // This is not a transient loss, we shouldn't automatically resume for now
+          resumeOnFocusGain = false;
+        }
+      }
+
+      // Used to indicate a transient loss of audio focus.
+      AudioManager.AUDIOFOCUS_LOSS_TRANSIENT,
+
+      // Used to indicate a transient loss of audio focus where the loser of the audio focus can
+      // lower its output volume if it wants to continue playing (also referred to as "ducking"),
+      // as the new focus owner doesn't require others to be silent.
+      AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> {
+        synchronized (focusLock) {
+          // We should only resume if playback was interrupted
+          resumeOnFocusGain = !(player?.isPaused ?: true)
+        }
+        player?.pause()
+      }
+    }
+  }
+
+  private fun fromAudioFocusChange(focusChange: Int?): String {
+    return when (focusChange) {
+      AudioManager.AUDIOFOCUS_GAIN -> "AUDIOFOCUS_GAIN"
+      AudioManager.AUDIOFOCUS_GAIN_TRANSIENT -> "AUDIOFOCUS_GAIN_TRANSIENT"
+      AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE -> "AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE"
+      AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK -> "AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK"
+      AudioManager.AUDIOFOCUS_LOSS -> "AUDIOFOCUS_LOSS"
+      AudioManager.AUDIOFOCUS_LOSS_TRANSIENT -> "AUDIOFOCUS_LOSS_TRANSIENT"
+      AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> "AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK"
+      else -> "AUDIOFOCUS_NONE"
+    }
+  }
+
+  private fun fromAudioFocusRequest(focusRequest: Int?): String {
+    return when(focusRequest) {
+      AudioManager.AUDIOFOCUS_REQUEST_GRANTED -> "AUDIOFOCUS_REQUEST_GRANTED"
+      AudioManager.AUDIOFOCUS_REQUEST_DELAYED -> "AUDIOFOCUS_REQUEST_DELAYED"
+      else -> "AUDIOFOCUS_REQUEST_FAILED"
+    }
+  }
+
+  /**
+   * Send a request to obtain the audio focus
+   *
+   * @return True if audio focus is granted, false otherwise.
+   */
+  fun retrieveAudioFocus(): Boolean {
+    val result = audioManager?.let {
+      AudioManagerCompat.requestAudioFocus(it, audioFocusRequest)
+    }
+    if (BuildConfig.DEBUG) {
+      Log.d(TAG, "retrieveAudioFocus: ${fromAudioFocusRequest(result)}")
+    }
+    return result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED
+  }
+
+  /**
+   * Abandon audio focus. Causes the previous focus owner, if any, to receive focus.
+   */
+  fun abandonAudioFocus() {
+    synchronized (focusLock) {
+      resumeOnFocusGain = false
+    }
+    val result = audioManager?.let {
+      AudioManagerCompat.abandonAudioFocusRequest(it, audioFocusRequest)
+    }
+    if (BuildConfig.DEBUG) {
+      Log.d(TAG, "abandonAudioFocus: ${fromAudioFocusRequest(result)}")
+    }
+  }
+}

package/android/src/main/java/com/theoplayer/drm/ContentProtectionModule.kt

@@ -111,7 +111,7 @@ class ContentProtectionModule(private val context: ReactApplicationContext) :
     }
     emit(
       EVENT_BUILD_INTEGRATION, payload,
-      onResult = hashMapOf(),
+      onResult = hashMapOf(EVENT_BUILD_PROCESSED to { /*NoOp*/ }),
       onError = {}
     )
   }

package/ios/THEOplayerRCTBridge.m

@@ -3,7 +3,6 @@
 //  Theoplayer
 //
 //  Created by William van Haevre on 14/01/2022.
-//  Copyright © 2022 Facebook. All rights reserved.
 //
 
 #import <React/RCTViewManager.h>

package/ios/THEOplayerRCTNetworkUtils.swift

@@ -2,8 +2,6 @@
 //  THEOplayerRCTNetworkUtils.swift
 //  Theoplayer
 //
-//  Created by William van Haevre on 14/11/2022.
-//
 
 import Foundation
 

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -6,6 +6,10 @@ import Foundation
 import UIKit
 import THEOplayerSDK
 
+#if canImport(THEOplayerConnectorSideloadedSubtitle)
+import THEOplayerConnectorSideloadedSubtitle
+#endif
+
 let ERROR_MESSAGE_PLAYER_ABR_UNSUPPORTED_FEATURE: String = "Setting an ABRconfig is not supported on iOS/tvOS."
 let ERROR_MESSAGE_PLAYER_QUALITY_UNSUPPORTED_FEATURE: String = "Setting a target video quality is not supported on iOS/tvOS."
 let ERROR_MESSAGE_PLAYER_FULLSCREEN_UNSUPPORTED_FEATURE: String = "Fullscreen presentationmode should be implemented on the RN level for iOS/tvOS."
@@ -56,8 +60,7 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
             if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
                let srcDescription = THEOplayerRCTSourceDescriptionBuilder.buildSourceDescription(src) {
                 if let player = theView.player {
-                    if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Setting new source on TheoPlayer") }
-                    player.source = srcDescription
+                    self.setNewSourceDescription(player: player, srcDescription: srcDescription)
                 }
             } else {
                 if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Failed to update THEOplayer source.") }
@@ -65,6 +68,15 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
         }
     }
     
+    private func setNewSourceDescription(player: THEOplayer, srcDescription: SourceDescription) {
+        if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Setting new source on TheoPlayer") }
+#if canImport(THEOplayerConnectorSideloadedSubtitle)
+        player.setSourceWithSubtitles(source: srcDescription)
+#else
+        player.source = srcDescription
+#endif
+    }
+    
     @objc(setABRConfig:abrConfig:)
     func setABRConfig(_ node: NSNumber, setABRConfig: NSDictionary) -> Void {
         if DEBUG_PLAYER_API { print(ERROR_MESSAGE_PLAYER_ABR_UNSUPPORTED_FEATURE) }

package/ios/THEOplayerRCTPrintUtils.swift

@@ -2,9 +2,6 @@
 //  Printing.swift
 //  THEOliveSDK
 //
-//  Created by William van Haevre on 21/06/2021.
-//
-
 import Foundation
 
 class PrintUtils {

package/ios/THEOplayerRCTSourceDescriptionBuilder.swift

@@ -375,6 +375,8 @@ class THEOplayerRCTSourceDescriptionBuilder {
 
         if format == "webvtt" {
             return THEOplayerSDK.TextTrackFormat.WebVTT
+        } else if format == "srt" {
+            return THEOplayerSDK.TextTrackFormat.SRT
         } else {
             return THEOplayerSDK.TextTrackFormat.none
         }

package/ios/THEOplayerRCTTextTrackEventHandler.swift

@@ -79,16 +79,19 @@ class THEOplayerRCTTextTrackEventHandler {
                     "type" : TrackListEventType.REMOVE_TRACK.rawValue
                 ])
                 // stop listening for cue events on this track
-                if let addCueListener = welf.addCueListeners[textTrack.uid],
-                   let removeCueListener = welf.removeCueListeners[textTrack.uid],
-                   let enterCueListener = welf.enterCueListeners[textTrack.uid],
-                   let exitCueListener = welf.exitCueListeners[textTrack.uid] {
+                if let addCueListener = welf.addCueListeners.removeValue(forKey: textTrack.uid) {
                     textTrack.removeEventListener(type: TextTrackEventTypes.ADD_CUE, listener: addCueListener)
                     if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] AddCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let removeCueListener = welf.removeCueListeners.removeValue(forKey: textTrack.uid) {
                     textTrack.removeEventListener(type: TextTrackEventTypes.REMOVE_CUE, listener: removeCueListener)
                     if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] RemoveCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let enterCueListener = welf.enterCueListeners.removeValue(forKey: textTrack.uid) {
                     textTrack.removeEventListener(type: TextTrackEventTypes.ENTER_CUE, listener: enterCueListener)
                     if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] EnterCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let exitCueListener = welf.exitCueListeners.removeValue(forKey: textTrack.uid) {
                     textTrack.removeEventListener(type: TextTrackEventTypes.EXIT_CUE, listener: exitCueListener)
                     if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] ExitCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
                 }
@@ -134,6 +137,31 @@ class THEOplayerRCTTextTrackEventHandler {
             player.textTracks.removeEventListener(type: TextTrackListEventTypes.CHANGE, listener: changeTrackListener)
             if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] ChangeTrack listener dettached from THEOplayer textTrack list") }
         }
+        
+        // ADD_CUE, REMOVE_CUE, ENTER_CUE, EXIT_CUE
+        let textTrackCount = player.textTracks.count
+        if textTrackCount > 0 {
+            for i in 0..<textTrackCount {
+                let textTrack = player.textTracks[i]
+                // stop listening for cue events on this track
+                if let addCueListener = self.addCueListeners.removeValue(forKey: textTrack.uid) {
+                    textTrack.removeEventListener(type: TextTrackEventTypes.ADD_CUE, listener: addCueListener)
+                    if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] AddCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let removeCueListener = self.removeCueListeners.removeValue(forKey: textTrack.uid) {
+                    textTrack.removeEventListener(type: TextTrackEventTypes.REMOVE_CUE, listener: removeCueListener)
+                    if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] RemoveCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let enterCueListener = self.enterCueListeners.removeValue(forKey: textTrack.uid) {
+                    textTrack.removeEventListener(type: TextTrackEventTypes.ENTER_CUE, listener: enterCueListener)
+                    if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] EnterCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+                if let exitCueListener = self.exitCueListeners.removeValue(forKey: textTrack.uid) {
+                    textTrack.removeEventListener(type: TextTrackEventTypes.EXIT_CUE, listener: exitCueListener)
+                    if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] ExitCue listener removed from THEOplayer textTrack with uid \(textTrack.uid)") }
+                }
+            }
+        }
     }
     
     // MARK: - dynamic textTrack Listeners

package/ios/THEOplayerRCTViewManager.swift

@@ -2,9 +2,6 @@
 //  THEOplayerRCTViewManager.swift
 //  Theoplayer
 //
-//  Created by William van Haevre on 14/01/2022.
-//  Copyright © 2022 Facebook. All rights reserved.
-//
 
 import Foundation
 import UIKit

package/ios/ads/THEOplayerRCTAdsAPI.swift

@@ -2,10 +2,6 @@
 //  THEOplayerRCTAdsAPI.swift
 //  Theoplayer
 //
-//  Created by William van Haevre on 09/09/2022.
-//  Copyright © 2022 Facebook. All rights reserved.
-//
-
 import Foundation
 import UIKit
 #if canImport(THEOplayerGoogleIMAIntegration)

package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift

@@ -72,100 +72,113 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
     
     func updateRemoteCommands() {
         let commandCenter = MPRemoteCommandCenter.shared()
+        
+        // update the enabled state to have correct visual representation in the lockscreen
         commandCenter.playCommand.isEnabled = !self.inAd && self.backgroundaudioConfig.enabled
         commandCenter.pauseCommand.isEnabled = !self.inAd && self.backgroundaudioConfig.enabled
         commandCenter.togglePlayPauseCommand.isEnabled = !self.inAd && self.backgroundaudioConfig.enabled
         commandCenter.stopCommand.isEnabled = !self.inAd && self.backgroundaudioConfig.enabled
-        commandCenter.changePlaybackPositionCommand.isEnabled = !isLive && !self.inAd && self.backgroundaudioConfig.enabled
-        commandCenter.skipForwardCommand.isEnabled = !isLive && !self.inAd && self.backgroundaudioConfig.enabled
-        commandCenter.skipBackwardCommand.isEnabled = !isLive && !self.inAd && self.backgroundaudioConfig.enabled
+        commandCenter.changePlaybackPositionCommand.isEnabled = !self.isLive && !self.inAd && self.backgroundaudioConfig.enabled
+        commandCenter.skipForwardCommand.isEnabled = !self.isLive && !self.inAd && self.backgroundaudioConfig.enabled
+        commandCenter.skipBackwardCommand.isEnabled = !self.isLive && !self.inAd && self.backgroundaudioConfig.enabled
+        
         if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands updated for \(self.isLive ? "LIVE" : "VOD") (\(self.inAd ? "AD IS PLAYING" : "NO AD PLAYING"), \(self.backgroundaudioConfig.enabled ? "BGAUDIO ENABLED" : "BGAUDIO DISABLED") ).") }
     }
     
     @objc private func onPlayCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
         if let player = self.player,
+           !self.inAd,
            player.paused {
             player.play()
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onPauseCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
         if let player = self.player,
+           !self.inAd,
            !player.paused {
             player.pause()
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onTogglePlayPauseCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player {
+        if let player = self.player,
+           !self.inAd {
             if player.paused {
                 player.play()
             } else {
                 player.pause()
             }
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onStopCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player {
+        if let player = self.player,
+           !self.inAd {
             if !player.paused {
                 player.pause()
             }
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Stop command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Stop command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Stop command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Stop command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onScrubCommand(_ event: MPChangePlaybackPositionCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player {
+        if let player = self.player,
+           !self.isLive,
+           !self.inAd {
             player.setCurrentTime(event.positionTime)
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Scrub command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Scrub command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Scrub command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Scrub command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onSkipForwardCommand(_ event: MPSkipIntervalCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player {
+        if let player = self.player,
+           !self.isLive,
+           !self.inAd {
             player.requestCurrentTime(completionHandler: { time, error in
                 if let currentTime = time {
                     player.setCurrentTime(currentTime + event.interval)
                 }
             })
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip forward command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip forward command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip forward command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip forward command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     @objc private func onSkipBackwardCommand(_ event: MPSkipIntervalCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player {
+        if let player = self.player ,
+           !self.isLive,
+           !self.inAd {
             player.requestCurrentTime(completionHandler: { time, error in
                 if let currentTime = time {
                     player.setCurrentTime(currentTime - event.interval)
                 }
             })
-            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip backward command triggered.") }
-            return .success
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip backward command handled.") }
+        } else {
+            if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip backward command not handled.") }
         }
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Skip backward command Failed.") }
-        return .commandFailed
+        return .success
     }
     
     private func attachListeners() {
@@ -193,11 +206,13 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
         // ADBREAK_BEGIN
         self.adBreakBeginListener = player.ads.addEventListener(type: AdsEventTypes.AD_BREAK_BEGIN) { [weak self] event in
             self?.inAd = true
+            self?.updateRemoteCommands()
         }
         
         // ADBREAK_END
         self.adBreakEndListener = player.ads.addEventListener(type: AdsEventTypes.AD_BREAK_END) { [weak self] event in
             self?.inAd = false
+            self?.updateRemoteCommands()
         }
         
 #endif

package/ios/casting/THEOplayerRCTCastAPI.swift

@@ -2,9 +2,6 @@
 //  THEOplayerRCTAdsAPI.swift
 //  Theoplayer
 //
-//  Created by William van Haevre on 09/09/2022.
-//  Copyright © 2022 Facebook. All rights reserved.
-//
 
 import Foundation
 

package/ios/contentprotection/THEOplayerRCTContentProtectionAPI.swift

@@ -2,9 +2,6 @@
 //  THEOplayerRCTContentProtectionAPI.swift
 //  Theoplayer
 //
-//  Created by William van Haevre on 09/09/2022.
-//  Copyright © 2022 Facebook. All rights reserved.
-//
 
 import Foundation
 import UIKit