react-native-theoplayer 10.3.0 → 10.4.0

package/CHANGELOG.md

@@ -5,11 +5,26 @@ 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).
 
+## [10.4.0] - 25-11-13
+
+### Fixed
+
+- Fixed an issue on Android, where the app could crash when a `THEOads` error event was dispatched.
+- Fixed an issue on Web, where the contents of the `reason` property of the THEOads `intenttofallback` event did not conform to its declared `PlayerError` type.
+
+### Added
+
+- Pass `streamActivityMonitorId` property for `THEOAdDescription` on iOS and Android.
+
+### Changed
+
+- Upgraded example app to React-Native v0.82.
+
 ## [10.3.0] - 25-10-27
 
 ### Fixed
 
-- Fixed an issue on web, where adbreak related AdEvents did no longer contain the adBreak info.
+- Fixed an issue on Web, where adbreak related AdEvents did no longer contain the adBreak info.
 
 ### Changed
 
@@ -30,6 +45,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [10.2.0] - 25-10-20
 
+### Added
+
+- React Native THEOplayer now supports [React Compiler](https://react.dev/learn/react-compiler).
+  - For Expo users: refer to the [Expo docs](https://docs.expo.dev/guides/react-compiler/) to set up React Compiler in your app.
+
 ### Fixed
 
 - Fixed an issue on iOS where the player crashed when it was destroyed while in fullscreen.
@@ -40,6 +60,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Added `THEOplayer.theoLive` and deprecated `THEOplayer.theolive`, to be consistent with the THEOplayer SDKs for other platforms.
 
+### Changed
+
+- Moved the `hlsDateRange` property from `SourceConfiguration` to its correct location in `TypedSource`.
+
 ## [10.1.0] - 25-10-06
 
 ### Added

package/README.md

@@ -73,8 +73,8 @@ please reach out to us for support.
 <tbody>
 <tr>
 <td><strong>Streaming</strong></td>
-<td colspan="2">MPEG-DASH (fmp4, CMAF), HLS (TS, CMAF), Progressive MP4, MP3</td>
-<td>HLS (TS, CMAF), Progressive MP4, MP3</td>
+<td colspan="2">MPEG-DASH (fmp4, CMAF), HLS (TS, CMAF), Progressive MP4, MP3, M4A</td>
+<td>HLS (TS, CMAF), Progressive MP4, MP3, M4A</td>
 </tr>
 <tr>
 <td><strong>Content Protection</strong></td>

package/android/build.gradle

@@ -152,7 +152,7 @@ dependencies {
     }
 
     //noinspection GradleDynamicVersion
-    implementation("com.facebook.react:react-native:+")
+    implementation("com.facebook.react:react-android:+")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutinesVersion")
     implementation("androidx.appcompat:appcompat:$appcompatVersion")
     implementation("androidx.core:core-ktx:$corektxVersion")

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

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

@@ -31,6 +31,7 @@ import com.theoplayer.android.api.millicast.MillicastIntegrationFactory
 import com.theoplayer.android.api.player.Player
 import com.theoplayer.android.api.player.RenderingTarget
 import com.theoplayer.android.connector.mediasession.MediaSessionConnector
+import com.theoplayer.android.connector.mediasession.MediaSessionListener
 import com.theoplayer.audio.AudioBecomingNoisyManager
 import com.theoplayer.audio.AudioFocusManager
 import com.theoplayer.audio.BackgroundAudioConfig
@@ -50,6 +51,11 @@ private const val ALLOWED_PLAYBACK_ACTIONS = (
     PlaybackStateCompat.ACTION_REWIND or
     PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED)
 
+private const val ALLOWED_PLAY_PAUSE_ACTIONS = (
+  PlaybackStateCompat.ACTION_PLAY_PAUSE or
+    PlaybackStateCompat.ACTION_PLAY or
+    PlaybackStateCompat.ACTION_PAUSE)
+
 class ReactTHEOplayerContext private constructor(
   private val reactContext: ThemedReactContext,
   private val configAdapter: PlayerConfigAdapter
@@ -82,14 +88,13 @@ class ReactTHEOplayerContext private constructor(
     get() = playerView.player
 
   private val uiModeManager by lazy {
-      reactContext.getSystemService(Context.UI_MODE_SERVICE) as? UiModeManager
+    reactContext.getSystemService(Context.UI_MODE_SERVICE) as? UiModeManager
   }
 
   var daiIntegration: GoogleDaiIntegration? = null
   var imaIntegration: GoogleImaIntegration? = null
   private var theoAdsIntegration: TheoAdsIntegration? = null
   var castIntegration: CastIntegration? = null
-  @Suppress("UnstableApiUsage")
   var wasPlayingOnHostPause: Boolean = false
   private var isHostPaused: Boolean = false
   private var millicastIntegration: MillicastIntegration? = null
@@ -131,6 +136,19 @@ class ReactTHEOplayerContext private constructor(
     }
   }
 
+  private val mediaSessionListener = object : MediaSessionListener() {
+    override fun onStop() {
+      binder?.stopForegroundService()
+    }
+
+    override fun onPlay() {
+      // Optionally seek to live, if configured.
+      if (mediaSessionConfig.seekToLiveOnResume && player.duration.isInfinite()) {
+        player.currentTime = Double.POSITIVE_INFINITY
+      }
+    }
+  }
+
   private fun applyBackgroundPlaybackConfig(
     config: BackgroundAudioConfig,
     prevConfig: BackgroundAudioConfig?
@@ -167,10 +185,12 @@ class ReactTHEOplayerContext private constructor(
     val isLive = player.duration.isInfinite()
     val isInAd = player.ads.isPlaying
     mediaSessionConnector?.enabledPlaybackActions = when {
-      isInAd || isLive && !isTV -> 0
-      isLive && isTV -> ALLOWED_PLAYBACK_ACTIONS xor
-        PlaybackStateCompat.ACTION_FAST_FORWARD xor
-        PlaybackStateCompat.ACTION_REWIND
+      // Allow trick-play for live events if configured
+      isLive && mediaSessionConfig.allowLivePlayPause -> ALLOWED_PLAY_PAUSE_ACTIONS
+      isLive && !mediaSessionConfig.allowLivePlayPause -> 0
+      // Do not allow playback actions during ad play-out
+      isInAd -> 0
+
       else -> ALLOWED_PLAYBACK_ACTIONS
     }
   }
@@ -263,9 +283,13 @@ class ReactTHEOplayerContext private constructor(
     }
   }
 
-  private fun applyMediaSessionConfig(connector: MediaSessionConnector?, config: MediaSessionConfig) {
+  private fun applyMediaSessionConfig(
+    connector: MediaSessionConnector?,
+    config: MediaSessionConfig
+  ) {
     connector?.apply {
       debug = BuildConfig.LOG_MEDIASESSION_EVENTS
+      removeListener(mediaSessionListener)
 
       player = this@ReactTHEOplayerContext.player
 
@@ -279,10 +303,15 @@ class ReactTHEOplayerContext private constructor(
       // Pass metadata from source description
       setMediaSessionMetadata(player?.source)
 
+      // Do not let MediaButtons restart the player when media session is not active.
+      // https://developer.android.com/media/legacy/media-buttons#restarting-inactive-mediasessions
+      this.mediaSession.setMediaButtonReceiver(null)
+
       // Install a queue navigator, but only if we want to handle skip buttons.
       if (mediaSessionConfig.convertSkipToSeek) {
         queueNavigator = MediaQueueNavigator(mediaSessionConfig)
       }
+      addListener(mediaSessionListener)
     }
   }
 
@@ -339,8 +368,8 @@ class ReactTHEOplayerContext private constructor(
       if (BuildConfig.EXTENSION_MILLICAST) {
         millicastIntegration = MillicastIntegrationFactory.createMillicastIntegration()
           .also {
-          playerView.player.addIntegration(it)
-        }
+            playerView.player.addIntegration(it)
+          }
       }
     } catch (e: Exception) {
       Log.w(TAG, "Failed to configure Millicast integration ${e.message}")

package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt

@@ -13,11 +13,9 @@ import android.util.Log
 import androidx.core.app.ServiceCompat
 import androidx.core.content.ContextCompat
 import androidx.media.session.MediaButtonReceiver
-import com.theoplayer.BuildConfig
 import com.theoplayer.ReactTHEOplayerContext
 import com.theoplayer.android.api.player.Player
 import com.theoplayer.android.connector.mediasession.MediaSessionConnector
-import com.theoplayer.android.connector.mediasession.MediaSessionListener
 
 private const val STOP_SERVICE_IF_APP_REMOVED = true
 
@@ -39,7 +37,7 @@ class MediaPlaybackService : Service() {
 
   private lateinit var mediaSessionConnector: MediaSessionConnector
   private val mediaSession: MediaSessionCompat
-    get() =  mediaSessionConnector.mediaSession
+    get() = mediaSessionConnector.mediaSession
 
   inner class MediaPlaybackBinder : Binder() {
     private val service: MediaPlaybackService
@@ -119,7 +117,6 @@ class MediaPlaybackService : Service() {
 
   override fun onDestroy() {
     super.onDestroy()
-    removeListeners()
     mediaSessionConnector.destroy()
     playerContext = null
   }
@@ -147,16 +144,7 @@ class MediaPlaybackService : Service() {
     }
 
     // Create a MediaSessionConnector.
-    mediaSessionConnector = MediaSessionConnector(mediaSession).apply {
-      debug = BuildConfig.LOG_MEDIASESSION_EVENTS
-
-      // Set mediaSession active
-      setActive(BuildConfig.EXTENSION_MEDIASESSION)
-
-      // Do not let MediaButtons restart the player when media session is not active.
-      // https://developer.android.com/media/legacy/media-buttons#restarting-inactive-mediasessions
-      mediaSession.setMediaButtonReceiver(null)
-    }
+    mediaSessionConnector = MediaSessionConnector(mediaSession)
   }
 
   private fun stopForegroundService() {
@@ -165,28 +153,10 @@ class MediaPlaybackService : Service() {
   }
 
   private fun connectPlayerContext(playerContext: ReactTHEOplayerContext) {
-    if (this.playerContext != null) {
-      removeListeners()
-    }
     this.playerContext = playerContext
-    addListeners()
     updateNotification()
   }
 
-  private val mediaSessionListener = object : MediaSessionListener() {
-    override fun onStop() {
-      stopForegroundService()
-    }
-  }
-
-  private fun addListeners() {
-    mediaSessionConnector.addListener(mediaSessionListener)
-  }
-
-  private fun removeListeners() {
-    mediaSessionConnector.removeListener(mediaSessionListener)
-  }
-
   private fun updateNotification() {
     val player = player
     when {
@@ -204,9 +174,17 @@ class MediaPlaybackService : Service() {
       PlaybackStateCompat.STATE_PAUSED -> {
         // Fetch large icon asynchronously
         fetchImageFromMetadata(player?.source) { largeIcon ->
-          notificationManager.notify(NOTIFICATION_ID, notificationBuilder.build(playbackState, largeIcon, mediaSessionConfig.mediaSessionEnabled))
+          notificationManager.notify(
+            NOTIFICATION_ID,
+            notificationBuilder.build(
+              playbackState,
+              largeIcon,
+              mediaSessionConfig.mediaSessionEnabled
+            )
+          )
         }
       }
+
       PlaybackStateCompat.STATE_PLAYING -> {
         // When a service runs in the foreground, it must display a notification, ideally
         // with one or more transport controls. The notification should also include useful
@@ -220,6 +198,7 @@ class MediaPlaybackService : Service() {
           startForegroundWithPlaybackState(playbackState, largeIcon)
         }
       }
+
       PlaybackStateCompat.STATE_STOPPED -> {
         // Remove this service from foreground state, allowing it to be killed if more memory is
         // needed. This does not stop the service from running (for that you use stopSelf()
@@ -227,13 +206,17 @@ class MediaPlaybackService : Service() {
         // Also remove the notification.
         ServiceCompat.stopForeground(this, ServiceCompat.STOP_FOREGROUND_REMOVE)
       }
+
       else -> {
         // Ignore
       }
     }
   }
 
-  private fun startForegroundWithPlaybackState(@PlaybackStateCompat.State playbackState: Int, largeIcon: Bitmap? = null) {
+  private fun startForegroundWithPlaybackState(
+    @PlaybackStateCompat.State playbackState: Int,
+    largeIcon: Bitmap? = null
+  ) {
     try {
       ServiceCompat.startForeground(
         this,

package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt

@@ -20,4 +20,14 @@ data class MediaSessionConfig (
    * Whether "skip track" events should be handled the same as "fast-forward/rewind".
    */
   var convertSkipToSeek: Boolean = false,
+
+  /**
+   * Whether to allow play/pause of live assets.
+   */
+  var allowLivePlayPause: Boolean = false,
+
+  /**
+   * Whether to seek to live when resuming a live stream.
+   */
+  var seekToLiveOnResume: Boolean = false,
 )

package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt

@@ -7,6 +7,8 @@ object MediaSessionConfigAdapter {
   private const val PROP_SKIP_FORWARD_INTERVAL = "skipForwardInterval"
   private const val PROP_SKIP_BACKWARD_INTERVAL = "skipBackwardInterval"
   private const val PROP_CONVERT_SKIP = "convertSkipToSeek"
+  private const val PROP_ALLOW_LIVE_PLAY_PAUSE = "allowLivePlayPause"
+  private const val PROP_SEEK_TO_LIVE_RESUME = "seekToLiveOnResume"
 
   fun fromProps(props: ReadableMap?): MediaSessionConfig {
     return MediaSessionConfig().apply {
@@ -22,6 +24,12 @@ object MediaSessionConfigAdapter {
       if (props?.hasKey(PROP_CONVERT_SKIP) == true) {
         convertSkipToSeek = props.getBoolean(PROP_CONVERT_SKIP)
       }
+      if (props?.hasKey(PROP_ALLOW_LIVE_PLAY_PAUSE) == true) {
+        allowLivePlayPause = props.getBoolean(PROP_ALLOW_LIVE_PLAY_PAUSE)
+      }
+      if (props?.hasKey(PROP_SEEK_TO_LIVE_RESUME) == true) {
+        seekToLiveOnResume = props.getBoolean(PROP_SEEK_TO_LIVE_RESUME)
+      }
     }
   }
 }

package/android/src/main/java/com/theoplayer/source/SourceAdapter.kt

@@ -69,6 +69,7 @@ private const val PROP_USE_ID3 = "useId3"
 private const val PROP_RETRIEVE_POD_ID_URI = "retrievePodIdURI"
 private const val PROP_INITIALIZATION_DELAY = "initializationDelay"
 private const val PROP_SSE_ENDPOINT = "sseEndpoint"
+private const val PROP_STREAM_ACTIVITY_MONITOR_ID = "streamActivityMonitorId"
 private const val PROP_LATENCY_CONFIGURATION = "latencyConfiguration"
 
 private const val ERROR_IMA_NOT_ENABLED = "Google IMA support not enabled."
@@ -272,6 +273,7 @@ class SourceAdapter {
           fileName.endsWith(".m3u8") -> return SourceType.HLSX
           fileName.endsWith(".mp4") -> return SourceType.MP4
           fileName.endsWith(".mp3") -> return SourceType.MP3
+          fileName.endsWith(".m4a") -> return SourceType.M4A
         }
       }
     }
@@ -334,6 +336,7 @@ class SourceAdapter {
       retrievePodIdURI = jsonAdDescription.optString(PROP_RETRIEVE_POD_ID_URI).takeIf { it.isNotEmpty() },
       initializationDelay = jsonAdDescription.optDouble(PROP_INITIALIZATION_DELAY).takeIf { it.isFinite() },
       sseEndpoint = jsonAdDescription.optString(PROP_SSE_ENDPOINT).takeIf { it.isNotEmpty() },
+      streamActivityMonitorId = jsonAdDescription.optString(PROP_STREAM_ACTIVITY_MONITOR_ID).takeIf { it.isNotEmpty() },
     )
   }
 

package/android/src/main/java/com/theoplayer/theoads/THEOadsEventAdapter.kt

@@ -5,7 +5,6 @@ import com.facebook.react.bridge.WritableMap
 import com.theoplayer.android.api.ads.theoads.TheoAdsIntegration
 import com.theoplayer.android.api.ads.theoads.event.InterstitialErrorEvent
 import com.theoplayer.android.api.ads.theoads.event.InterstitialEvent
-import com.theoplayer.android.api.ads.theoads.event.TheoAdsErrorEvent
 import com.theoplayer.android.api.ads.theoads.event.TheoAdsEvent
 import com.theoplayer.android.api.ads.theoads.event.TheoAdsEventTypes
 import com.theoplayer.android.api.event.EventListener
@@ -19,8 +18,7 @@ private val FORWARDED_EVENTS = listOf(
   TheoAdsEventTypes.INTERSTITIAL_BEGIN,
   TheoAdsEventTypes.INTERSTITIAL_END,
   TheoAdsEventTypes.INTERSTITIAL_UPDATE,
-  TheoAdsEventTypes.INTERSTITIAL_ERROR,
-  TheoAdsEventTypes.THEOADS_ERROR
+  TheoAdsEventTypes.INTERSTITIAL_ERROR
 )
 
 class THEOadsEventAdapter(private val api: TheoAdsIntegration, private val emitter: Emitter) {
@@ -44,9 +42,6 @@ class THEOadsEventAdapter(private val api: TheoAdsIntegration, private val emitt
       (event as? InterstitialEvent)?.let {
         putMap(EVENT_PROP_INTERSTITIAL, THEOadsAdapter.fromInterstitial(event.interstitial))
       }
-      (event as? TheoAdsErrorEvent)?.let {
-        putString(EVENT_PROP_MESSAGE, event.message)
-      }
       (event as? InterstitialErrorEvent)?.let {
         putString(EVENT_PROP_MESSAGE, event.message)
       }

package/ios/THEOplayerRCTMainEventHandler.swift

@@ -277,7 +277,6 @@ public class THEOplayerRCTMainEventHandler {
                let welf = self,
                let forwardedLoadedMetadataEvent = self?.onNativeLoadedMetadata {
               let metadata = THEOplayerRCTTrackMetadataAggregator.aggregateTrackMetadata(player: wplayer, metadataTracksInfo: welf.loadedMetadataAndChapterTracksInfo)
-                print(metadata)
                 forwardedLoadedMetadataEvent(metadata)
             }
         }

package/ios/THEOplayerRCTSourceDescriptionBuilder.swift

@@ -22,6 +22,7 @@ let SD_PROP_INTEGRATION_PARAMETERS: String = "integrationParameters"
 let SD_PROP_AVAILABILITY_TYPE: String = "availabilityType"
 let SD_PROP_AUTH_TOKEN: String = "authToken"
 let SD_PROP_STREAM_ACTIVITY_MONITOR_ID: String = "streamActivityMonitorID"
+let SD_PROP_STREAM_ACTIVITY_MONITOR_ID_THEOADS: String = "streamActivityMonitorId"
 let SD_PROP_AD_TAG_PARAMETERS: String = "adTagParameters"
 let SD_PROP_APIKEY: String = "apiKey"
 let SD_PROP_VIDEOID: String = "videoID"
@@ -66,10 +67,12 @@ let SD_PROP_CMCD: String = "cmcd"
 let EXTENSION_HLS: String = ".m3u8"
 let EXTENSION_MP4: String = ".mp4"
 let EXTENSION_MP3: String = ".mp3"
+let EXTENSION_M4A: String = ".m4a"
 
 let MIMETYPE_HLS = "application/x-mpegurl"
 let MIMETYPE_MP4 = "video/mp4"
 let MIMETYPE_MP3 = "audio/mpeg"
+let MIMETYPE_M4A = "audio/mp4"
 
 let DRM_INTEGRATION_ID_EZDRM = "ezdrm"
 let DRM_INTEGRATION_ID_KEYOS = "keyos"
@@ -419,6 +422,8 @@ class THEOplayerRCTSourceDescriptionBuilder {
             return MIMETYPE_MP4
         } else if src.suffix(4) == EXTENSION_MP3 {
             return MIMETYPE_MP3
+        } else if src.suffix(4) == EXTENSION_M4A {
+            return MIMETYPE_M4A
         }
         return MIMETYPE_HLS
     }

package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift

@@ -81,28 +81,34 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
     func updateRemoteCommands() {
         let commandCenter = MPRemoteCommandCenter.shared()
         
+        let skipControlsEnabled = self.hasSource && !self.inAd && !self.isLive
+        let playPauseControlsEnabled = self.hasSource && !self.inAd && (!self.isLive || mediaControlConfig.allowLivePlayPause)
+        
         // update the enabled state to have correct visual representation in the lockscreen
-        commandCenter.pauseCommand.isEnabled =  self.hasSource && !self.inAd
-        commandCenter.playCommand.isEnabled = self.hasSource && !self.inAd
-        commandCenter.togglePlayPauseCommand.isEnabled =  self.hasSource && !self.inAd
-        commandCenter.stopCommand.isEnabled =  self.hasSource && !self.inAd
-        commandCenter.changePlaybackPositionCommand.isEnabled =  self.hasSource && !self.isLive && !self.inAd
-        commandCenter.skipForwardCommand.isEnabled =  self.hasSource && !self.isLive && !self.inAd
-        commandCenter.skipBackwardCommand.isEnabled =  self.hasSource && !self.isLive && !self.inAd
-        commandCenter.nextTrackCommand.isEnabled = !self.isLive && !self.inAd
-        commandCenter.previousTrackCommand.isEnabled = !self.isLive && !self.inAd
+        commandCenter.pauseCommand.isEnabled =  playPauseControlsEnabled
+        commandCenter.playCommand.isEnabled = playPauseControlsEnabled
+        commandCenter.togglePlayPauseCommand.isEnabled =  playPauseControlsEnabled
+        commandCenter.stopCommand.isEnabled =  playPauseControlsEnabled
+        commandCenter.changePlaybackPositionCommand.isEnabled =  skipControlsEnabled
+        commandCenter.skipForwardCommand.isEnabled =  skipControlsEnabled
+        commandCenter.skipBackwardCommand.isEnabled =  skipControlsEnabled
+        commandCenter.nextTrackCommand.isEnabled = skipControlsEnabled
+        commandCenter.previousTrackCommand.isEnabled = skipControlsEnabled
         
         // set configured skip forward/backward intervals
         commandCenter.skipForwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipForwardInterval)]
         commandCenter.skipBackwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipBackwardInterval)]
         
-        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands updated for \(self.isLive ? "LIVE" : "VOD") (\(self.inAd ? "AD IS PLAYING" : "NO AD PLAYING")).") }
+        if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands updated for \(self.isLive ? "LIVE" : "VOD") (ALLOWLIVEPLAYPAUSE: \(mediaControlConfig.allowLivePlayPause)) (\(self.inAd ? "AD IS PLAYING" : "NO AD PLAYING")).") }
     }
     
     @objc private func onPlayCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
         if let player = self.player,
-           !self.inAd,
-           player.paused {
+           !self.inAd {
+            if self.isLive && self.mediaControlConfig.seekToLiveOnResume {
+                if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Seek to live.") }
+                player.currentTime = .infinity
+            }
             player.play()
             if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command handled.") }
         } else {
@@ -113,8 +119,7 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
     
     @objc private func onPauseCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
         if let player = self.player,
-           !self.inAd,
-           !player.paused {
+           !self.inAd {
             player.pause()
             if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command handled.") }
         } else {
@@ -127,8 +132,14 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
         if let player = self.player,
            !self.inAd {
             if player.paused {
+                if self.isLive && self.mediaControlConfig.seekToLiveOnResume {
+                    if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Seek to live.") }
+                    player.currentTime = .infinity
+                }
+                if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to playing.") }
                 player.play()
             } else {
+                if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to paused.") }
                 player.pause()
             }
             if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command handled.") }
@@ -176,7 +187,7 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
     }
     
     @objc private func onSkipBackwardCommand(_ event: MPSkipIntervalCommandEvent) -> MPRemoteCommandHandlerStatus {
-        if let player = self.player ,
+        if let player = self.player,
            !self.isLive,
            !self.inAd {
             player.currentTime = player.currentTime - event.interval

package/ios/backgroundAudio/THEOplayerRCTView+MediaControlConfig.swift

@@ -7,6 +7,8 @@ struct MediaControlConfig {
     var skipForwardInterval: Int = 15
     var skipBackwardInterval: Int = 15
     var convertSkipToSeek: Bool = false
+    var allowLivePlayPause: Bool = true
+    var seekToLiveOnResume: Bool = false
 }
 
 extension THEOplayerRCTView {
@@ -22,6 +24,12 @@ extension THEOplayerRCTView {
             if let convertSkipToSeek = mediaControlConfig["convertSkipToSeek"] as? Bool {
                 self.mediaControlConfig.convertSkipToSeek = convertSkipToSeek
             }
+            if let allowLivePlayPause = mediaControlConfig["allowLivePlayPause"] as? Bool {
+                self.mediaControlConfig.allowLivePlayPause = allowLivePlayPause
+            }
+            if let seekToLiveOnResume = mediaControlConfig["seekToLiveOnResume"] as? Bool {
+                self.mediaControlConfig.seekToLiveOnResume = seekToLiveOnResume
+            }
         }
     }
 }

package/ios/theoAds/THEOplayerRCTSourceDescriptionBuilder+TheoAds.swift

@@ -47,6 +47,7 @@ extension THEOplayerRCTSourceDescriptionBuilder {
         }
         let adTagParameters = adsData[SD_PROP_AD_TAG_PARAMETERS] as? [String:String]
         let useId3 = adsData[SD_PROP_USE_ID3] as? Bool
+        let streamActivityMonitorId = adsData[SD_PROP_STREAM_ACTIVITY_MONITOR_ID_THEOADS] as? String
         let retrievePodIdURI = adsData[SD_PROP_RETRIEVE_POD_ID_URI] as? String
         let initializationDelay = adsData[SD_PROP_INITIALIZATION_DELAY] as? Double
         
@@ -58,6 +59,7 @@ extension THEOplayerRCTSourceDescriptionBuilder {
                                  overrideAdSrc: overrideAdSrc,
                                  adTagParameters: adTagParameters,
                                  useId3: useId3,
+                                 streamActivityMonitorId: streamActivityMonitorId,
                                  sseEndpoint: sseEndpoint,
                                  retrievePodIdURI: retrievePodIdURI,
                                  initializationDelay: initializationDelay)

package/lib/commonjs/api/source/SourceDescription.js.map

@@ -1 +1 @@
-{"version":3,"names":["SourceIntegrationId","exports"],"sourceRoot":"../../../../src","sources":["api/source/SourceDescription.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAUA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,0BAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAA,OAAnBA,mBAAmB;AAAA;AAI/B;AACA;AACA;AACA;AACA;AACA;AAgEA;AACA;AACA;AACA;AACA;AACA;AAmDA;AACA;AACA;AACA;AACA;AACA;AACA;AA2FA;AACA;AACA;AACA;AACA;AACA;AAkEA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["SourceIntegrationId","exports"],"sourceRoot":"../../../../src","sources":["api/source/SourceDescription.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAUA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,0BAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAA,OAAnBA,mBAAmB;AAAA;AAI/B;AACA;AACA;AACA;AACA;AACA;AAyDA;AACA;AACA;AACA;AACA;AACA;AAmDA;AACA;AACA;AACA;AACA;AACA;AACA;AA2FA;AACA;AACA;AACA;AACA;AACA;AAyEA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/internal/THEOplayerView.js

@@ -207,7 +207,10 @@ class THEOplayerView extends _react.PureComponent {
     this._facade.dispatchEvent((0, _NativeTheoLiveEvent.fromNativeTheoLiveEvent)(event));
   };
   _onTHEOadsEvent = event => {
-    this._facade.dispatchEvent((0, _NativeTheoAdsEvent.fromNativeTheoAdsEvent)(this.nativeHandle, event));
+    const theoAdsEvent = (0, _NativeTheoAdsEvent.fromNativeTheoAdsEvent)(this.nativeHandle, event);
+    if (theoAdsEvent !== undefined) {
+      this._facade.dispatchEvent(theoAdsEvent);
+    }
   };
   _onCastEvent = event => {
     switch (event.nativeEvent.type) {