react-native-theoplayer 10.4.0 → 10.5.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.5.0] - 25-11-24
+
+### Fixed
+
+- Fixed an issue on iOS where the scrim of an IMA ad was in a wrong position due to incorrect `safeAreaInsets`.
+
+### Added
+
+- Added `stopOnBackground` property to `BackgroundAudioConfiguration` to control whether playback should stop when the app goes to the background.
+- Added `millicastSrc` to `TheoLiveEndpoint` for Web and Android.
+- Added support for configuring query parameters that are common to multiple key system configurations. The parameters defined in `contentProtection.queryParameters` will be merged with any query parameters that are explicitly defined on a key system configuration, whereby the latter takes precedence.
+
+### Changed
+
+- Updated the active quality info extraction on iOS to use the activeQualityChange event data instead of player API.
+
 ## [10.4.0] - 25-11-13
 
 ### Fixed
@@ -15,6 +31,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Added
 
 - Pass `streamActivityMonitorId` property for `THEOAdDescription` on iOS and Android.
+- Added `allowLivePlayPause` and `seekToLiveOnResume` properties to `PlayerConfiguration.mediaControl` to control pausing and resuming behavior on live streams from the lockscreen controls.
 
 ### Changed
 
@@ -138,11 +155,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Deprecated the `BaseSource.integration` property in favor of `TypedSource.type`.
 
-## Added
+### Added
 
 - Added support for `THEOlive` events.
 
-## Fixed
+### Fixed
 
 - Fixed an issue on Android where, depending on the project structure, the Maven repository list would be incorrect.
 

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

@@ -458,6 +458,12 @@ class ReactTHEOplayerContext private constructor(
       // The player pauses and goes to the background, we can abandon audio focus.
       audioFocusManager?.abandonAudioFocus()
     }
+
+    // Optionally fully stop play-out, unless PiP mode is active.
+    if (backgroundAudioConfig.stopOnBackground
+      && reactContext.currentActivity?.isInPictureInPictureMode != true) {
+      player.stop()
+    }
   }
 
   /**

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

@@ -7,4 +7,11 @@ data class BackgroundAudioConfig(
    * @defaultValue `false`
    */
   val enabled: Boolean,
+
+  /**
+   * Set whether the player should stop play-out when the app goes to background.
+   *
+   * @defaultValue `false`
+   */
+  val stopOnBackground: Boolean = false
 )

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

@@ -4,12 +4,21 @@ import com.facebook.react.bridge.ReadableMap
 
 object BackgroundAudioConfigAdapter {
   private const val PROP_ENABLED = "enabled"
+  private const val PROP_STOP_ON_BACKGROUND = "stopOnBackground"
 
   private const val DEFAULT_ENABLED = false
+  private const val DEFAULT_STOP_ON_BACKGROUND = false
 
   fun fromProps(props: ReadableMap?): BackgroundAudioConfig {
-    val enabled =
-      if (props?.hasKey(PROP_ENABLED) == true) props.getBoolean(PROP_ENABLED) else DEFAULT_ENABLED
-    return BackgroundAudioConfig(enabled)
+    val enabled = props?.hasKey(PROP_ENABLED)?.let {
+      props.getBoolean(PROP_ENABLED)
+    } ?: DEFAULT_ENABLED
+    val destroy = props?.hasKey(PROP_STOP_ON_BACKGROUND)?.let {
+      props.getBoolean(PROP_STOP_ON_BACKGROUND)
+    } ?: DEFAULT_STOP_ON_BACKGROUND
+    return BackgroundAudioConfig(
+      enabled = enabled,
+      stopOnBackground = destroy
+    )
   }
 }

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

@@ -104,6 +104,7 @@ object ContentProtectionAdapter {
       if (jsonConfig.has(PROP_INTEGRATION_PARAMETERS)) {
         integrationParameters(fromJSONObjectToMap(jsonConfig.getJSONObject(PROP_INTEGRATION_PARAMETERS)))
       }
+      queryParameters(fromJSONObjectToMap(jsonConfig.optJSONObject(PROP_QUERY_PARAMETERS)))
     }.build()
   }
 

package/android/src/main/java/com/theoplayer/presentation/PresentationManager.kt

@@ -319,14 +319,18 @@ class PresentationManager(
     currentPresentationModeChangeContext = context
     eventEmitter.emitPresentationModeChange(presentationMode, prevPresentationMode, context)
 
-    // Resume playing when going to PiP and player was playing
+    // Resume play-out when going to PiP and player was playing
     if (presentationMode == PresentationMode.PICTURE_IN_PICTURE && viewCtx.wasPlayingOnHostPause) {
       viewCtx.player.play()
     }
 
-    // Apply background audio config when closing PiP window
-    if (context?.pip == PresentationModeChangePipContext.CLOSED && !viewCtx.backgroundAudioConfig.enabled) {
-      viewCtx.player.pause()
+    // When closing PiP window
+    if (context?.pip == PresentationModeChangePipContext.CLOSED) {
+      // Pause if background audio is not enabled
+      if (!viewCtx.backgroundAudioConfig.enabled) viewCtx.player.pause()
+
+      // Optionally fully stop play-out
+      if (viewCtx.backgroundAudioConfig.stopOnBackground) viewCtx.player.stop()
     }
   }
 }

package/android/src/main/java/com/theoplayer/theolive/EndpointAdapter.kt

@@ -4,9 +4,15 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
 import com.theoplayer.android.api.theolive.ContentProtectionConfiguration
 import com.theoplayer.android.api.theolive.Endpoint
+import com.theoplayer.android.api.theolive.EndpointMillicastSource
 import com.theoplayer.android.api.theolive.FairPlayConfiguration
 import com.theoplayer.android.api.theolive.KeySystemConfiguration
 
+private const val PROP_MILLICAST_SRC = "millicastSrc"
+private const val PROP_MILLICAST_NAME = "name"
+private const val PROP_MILLICAST_ACCOUNTID = "accountId"
+private const val PROP_MILLICAST_SUBSCRIBER_TOKEN ="subscriberToken"
+private const val PROP_MILLICAST_DIRECTOR_URL = "directorUrl"
 private const val PROP_HESP_SRC = "hespSrc"
 private const val PROP_HLS_SRC = "hlsSrc"
 private const val PROP_AD_SRC = "adSrc"
@@ -24,8 +30,18 @@ private const val PROP_CERTIFICATE_URL = "certificateUrl"
 
 object EndpointAdapter {
 
+  fun fromEndPointMillicastSource(millicastSource: EndpointMillicastSource): WritableMap {
+    return Arguments.createMap().apply {
+      putString(PROP_MILLICAST_NAME , millicastSource.name)
+      putString(PROP_MILLICAST_ACCOUNTID, millicastSource.accountId)
+      millicastSource.directorUrl?.let { putString(PROP_MILLICAST_DIRECTOR_URL, it) }
+      millicastSource.subscriberToken?.let { putString(PROP_MILLICAST_SUBSCRIBER_TOKEN, it) }
+    }
+  }
+
   fun fromEndpoint(endPoint: Endpoint): WritableMap {
     return Arguments.createMap().apply {
+      endPoint.millicastSrc?.let { putMap(PROP_MILLICAST_SRC, fromEndPointMillicastSource(it)) }
       endPoint.hespSrc?.let { putString(PROP_HESP_SRC, it) }
       endPoint.hlsSrc?.let { putString(PROP_HLS_SRC, it) }
       endPoint.adSrc?.let { putString(PROP_AD_SRC, it) }

package/ios/THEOplayerRCTDebug.swift

@@ -15,7 +15,7 @@ let DEBUG_THEOPLAYER_INTERACTION = DEBUG && false
 // Debug flag to monitor contentProtection integration handling
 let DEBUG_CONTENT_PROTECTION_API = DEBUG && false
 
-// Debug flag to monitor all updates made  on bridged properties
+// Debug flag to monitor all updates made on bridged properties
 let DEBUG_VIEW = DEBUG && false
 
 // Debug flag to monitor correct SourceDescription buildup

package/ios/THEOplayerRCTMediaTrackEventHandler.swift

@@ -235,26 +235,39 @@ class THEOplayerRCTMediaTrackEventHandler {
            let player = self.player,
            let track = self.activeTrack(tracks: player.videoTracks) {
             if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received ACTIVE_QUALITY_CHANGED event for videoTrack") }
-            let identifier = String(track.activeQualityBandwidth)
-            let label = self.labelFromBandWidth(track.activeQualityBandwidth)
+            let activeQuality = event.quality
+            let identifier = String(activeQuality.bandwidth)
+            let label = self.labelFromBandWidth(activeQuality.bandwidth)
+    
+            var width = player.videoWidth
+            var height = player.videoHeight
+            if let activeVideoQuality = activeQuality as? VideoQuality {
+                width = activeVideoQuality.width
+                height = activeVideoQuality.height
+            }
+            
+            var quality: [String:Any] = [
+                "bandwidth": activeQuality.bandwidth,
+                "codecs": "",
+                "id": identifier,
+                "uid": identifier,
+                "name": label,
+                "label": label,
+                "available": true,
+                "width": width,
+                "height": height,
+                //"frameRate": 0, // not available on iOS SDK
+                //"firstFrame": 0 // not available on iOS SDK
+            ]
+            if let averageBandwidth = activeQuality.averageBandwidth {
+                quality["averageBandwidth"] = averageBandwidth
+            }
+            
             forwardedMediaTrackEvent([
                 "trackUid" : track.uid,
                 "type" : MediaTrackEventType.ACTIVE_QUALITY_CHANGED.rawValue,
                 "trackType": MediaTrackType.VIDEO.rawValue,
-                "qualities": [
-                    "bandwidth": track.activeQualityBandwidth,
-                    "codecs": "",
-                    "id": identifier,
-                    "uid": identifier,
-                    "name": label,
-                    "label": label,
-                    "available": true,
-                    "width": player.videoWidth,
-                    "height": player.videoHeight,
-                    //"frameRate": 0, // not available on iOS SDK
-                    //"firstFrame": 0 // not available on iOS SDK
-                        
-                ]
+                "qualities": [quality]
             ])
         }
     }
@@ -264,23 +277,29 @@ class THEOplayerRCTMediaTrackEventHandler {
            let player = self.player,
            let track = self.activeTrack(tracks: player.audioTracks) {
             if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received ACTIVE_QUALITY_CHANGED event for audioTrack") }
-            let identifier = String(track.activeQualityBandwidth)
-            let label = self.labelFromBandWidth(track.activeQualityBandwidth)
+            let activeQuality = event.quality
+            let identifier = String(activeQuality.bandwidth)
+            let label = self.labelFromBandWidth(activeQuality.bandwidth)
+            
+            var quality: [String:Any] = [
+                "bandwidth": activeQuality.bandwidth,
+                "codecs": "",
+                "id": identifier,
+                "uid": identifier,
+                "name": label,
+                "label": label,
+                "available": true,
+                //"audioSamplingRate": 0 // not available on iOS SDK
+            ]
+            if let averageBandwidth = activeQuality.averageBandwidth {
+                quality["averageBandwidth"] = averageBandwidth
+            }
             
             forwardedMediaTrackEvent([
                 "trackUid" : track.uid,
                 "type" : MediaTrackEventType.ACTIVE_QUALITY_CHANGED.rawValue,
                 "trackType": MediaTrackType.AUDIO.rawValue,
-                "qualities": [
-                    "bandwidth": track.activeQualityBandwidth,
-                    "codecs": "",
-                    "id": identifier,
-                    "uid": identifier,
-                    "name": label,
-                    "label": label,
-                    "available": true,
-                    //"audioSamplingRate": 0 // not available on iOS SDK
-                ]
+                "qualities": [quality]
             ])
         }
     }

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -268,6 +268,7 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
     private func parseBackgroundAudioConfig(configDict: NSDictionary) -> BackgroundAudioConfig {
         var backgroundAudio = BackgroundAudioConfig()
         backgroundAudio.enabled = configDict["enabled"] as? Bool ?? false
+        backgroundAudio.stopOnBackground = configDict["stopOnBackground"] as? Bool ?? false
         backgroundAudio.shouldResumeAfterInterruption = configDict["shouldResumeAfterInterruption"] as? Bool ?? false
         if let audioSessionModeString = configDict["audioSessionMode"] as? String {
             backgroundAudio.audioSessionMode = THEOplayerRCTTypeUtils.audioSessionModeFromString(audioSessionModeString)

package/ios/THEOplayerRCTSourceDescriptionBuilder.swift

@@ -63,6 +63,7 @@ let SD_PROP_RETRIEVE_POD_ID_URI: String = "retrievePodIdURI"
 let SD_PROP_INITIALIZATION_DELAY: String = "initializationDelay"
 let SD_PROP_HLS_DATE_RANGE: String = "hlsDateRange"
 let SD_PROP_CMCD: String = "cmcd"
+let SD_PROP_QUERY_PARAMETERS = "queryParameters"
 
 let EXTENSION_HLS: String = ".m3u8"
 let EXTENSION_MP4: String = ".mp4"
@@ -230,8 +231,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
         guard let contentProtectionData = typedSourceData[SD_PROP_CONTENT_PROTECTION] as? [String:Any] else {
             return nil
         }
-        let sanitisedContentProtectionData = THEOplayerRCTSourceDescriptionBuilder.sanitiseContentProtectionData(contentProtectionData)
-        return THEOplayerRCTSourceDescriptionBuilder.buildContentProtection(sanitisedContentProtectionData)
+        return THEOplayerRCTSourceDescriptionBuilder.buildContentProtection(contentProtectionData)
     }
 
     /**
@@ -339,77 +339,65 @@ class THEOplayerRCTSourceDescriptionBuilder {
     }
 #endif
 
-      /**
-     Updates the contentProtectionData to a valid iOS SDK contentProtectionData, flattening out cross SDK differences
-     - returns: a THEOplayer valid contentProtection data map
+    /**
+     Creates a THEOplayer DRMConfiguration. This requires a contentProtection property in the RN source description.
+     - returns: a THEOplayer DRMConfiguration
      */
-    static func sanitiseContentProtectionData(_ contentProtectionData: [String:Any]) -> [String:Any] {
-        var sanitisedContentProtectionData: [String:Any] = contentProtectionData
-        // fairplay update
+    static func buildContentProtection(_ contentProtectionData: [String:Any]) -> MultiplatformDRMConfiguration? {
+        guard let customIntegrationId = contentProtectionData[SD_PROP_INTEGRATION] as? String else { return nil }
+        
+        // fairplay
+        var fairplayKeySystem: THEOplayerSDK.KeySystemConfiguration? = nil
         if let fairplayData = contentProtectionData[SD_PROP_FAIRPLAY] as? [String:Any] {
-            var sanitisedFairplayData: [String:Any] = [:]
             // certificateUrl
-            if let certificateUrl = fairplayData[SD_PROP_CERTIFICATE_URL] as? String {
-                sanitisedFairplayData[SD_PROP_CERTIFICATE_URL] = certificateUrl
-            }
-            // convert certificate into certificateUrl with marker prefix (also supported by THEOplayer Web SDK)
+            var certificateUrl = fairplayData[SD_PROP_CERTIFICATE_URL] as? String
             if let certificate = fairplayData[SD_PROP_CERTIFICATE] as? String {
-                sanitisedFairplayData[SD_PROP_CERTIFICATE_URL] = "\(CERTIFICATE_MARKER)\(certificate)"
-            }
-            // licenseAcquisitionURL
-            if let licenseAcquisitionURL = fairplayData[SD_PROP_LICENSE_URL] as? String {
-                sanitisedFairplayData[SD_PROP_LICENSE_URL] = licenseAcquisitionURL
+                certificateUrl = "\(CERTIFICATE_MARKER)\(certificate)"
             }
-            // headers
-            if let headers = fairplayData[SD_PROP_HEADERS] as? [String:String] {
-                sanitisedFairplayData[SD_PROP_HEADERS] = headers
-            }
-            // licenseType
-            if let licenseType = fairplayData[SD_PROP_LICENSE_TYPE] as? String {
-                sanitisedFairplayData[SD_PROP_LICENSE_TYPE] = licenseType
-            }
-            sanitisedContentProtectionData[SD_PROP_FAIRPLAY] = sanitisedFairplayData
+            let licenseAcquisitionURL = fairplayData[SD_PROP_LICENSE_URL] as? String
+            let headers = fairplayData[SD_PROP_HEADERS] as? [String:String]
+            let licenseType = fairplayData[SD_PROP_LICENSE_TYPE] as? String
+            let queryParameters = fairplayData[SD_PROP_QUERY_PARAMETERS] as? [String:String]
+                
+            fairplayKeySystem = KeySystemConfiguration(
+                licenseAcquisitionURL: licenseAcquisitionURL,
+                certificateURL: certificateUrl,
+                licenseType: licenseType == "persistent" ? LicenseType.persistent : LicenseType.temporary,
+                headers: headers,
+                queryParameters: queryParameters
+            )
         }
-        // widevine update
+        
+        // widevine
+        var widevineKeySystem: THEOplayerSDK.KeySystemConfiguration? = nil
         if let widevineData = contentProtectionData[SD_PROP_WIDEVINE] as? [String:Any] {
-            var sanitisedWidevineData: [String:Any] = [:]
             // certificateUrl
-            if let certificateUrl = widevineData[SD_PROP_CERTIFICATE_URL] as? String {
-                sanitisedWidevineData[SD_PROP_CERTIFICATE_URL] = certificateUrl
-            }
-            // convert certificate into certificateUrl with marker prefix (also supported by THEOplayer Web SDK)
+            var certificateUrl = widevineData[SD_PROP_CERTIFICATE_URL] as? String
             if let certificate = widevineData[SD_PROP_CERTIFICATE] as? String {
-                sanitisedWidevineData[SD_PROP_CERTIFICATE_URL] = "\(CERTIFICATE_MARKER)\(certificate)"
-            }
-            // licenseAcquisitionURL
-            if let licenseAcquisitionURL = widevineData[SD_PROP_LICENSE_URL] as? String {
-                sanitisedWidevineData[SD_PROP_LICENSE_URL] = licenseAcquisitionURL
-            }
-            // headers
-            if let headers = widevineData[SD_PROP_HEADERS] as? [String:String] {
-                sanitisedWidevineData[SD_PROP_HEADERS] = headers
+                certificateUrl = "\(CERTIFICATE_MARKER)\(certificate)"
             }
-            // licenseType
-            if let licenseType = widevineData[SD_PROP_LICENSE_TYPE] as? String {
-                sanitisedWidevineData[SD_PROP_LICENSE_TYPE] = licenseType
-            }
-            sanitisedContentProtectionData[SD_PROP_WIDEVINE] = sanitisedWidevineData
-        }
-        return sanitisedContentProtectionData
-    }
-
-    /**
-     Creates a THEOplayer DRMConfiguration. This requires a contentProtection property in the RN source description.
-     - returns: a THEOplayer DRMConfiguration
-     */
-    static func buildContentProtection(_ contentProtectionData: [String:Any]) -> MultiplatformDRMConfiguration? {
-        do {
-            let data = try JSONSerialization.data(withJSONObject: contentProtectionData)
-            return try JSONDecoder().decode(MultiplatformDRMConfiguration.self, from: data)
-        } catch {
-            PrintUtils.printLog(logText: "[NATIVE] unsupported contentProtection data format")
+            let licenseAcquisitionURL = widevineData[SD_PROP_LICENSE_URL] as? String
+            let headers = widevineData[SD_PROP_HEADERS] as? [String:String]
+            let licenseType = widevineData[SD_PROP_LICENSE_TYPE] as? String
+            let queryParameters = widevineData[SD_PROP_QUERY_PARAMETERS] as? [String:String]
+                
+            widevineKeySystem = KeySystemConfiguration(
+                licenseAcquisitionURL: licenseAcquisitionURL,
+                certificateURL: certificateUrl,
+                licenseType: licenseType == "persistent" ? LicenseType.persistent : LicenseType.temporary,
+                headers: headers,
+                queryParameters: queryParameters
+            )
         }
-        return nil
+        
+        // global query parameters
+        let queryParameters = contentProtectionData[SD_PROP_QUERY_PARAMETERS] as? [String:String]
+        
+        return MultiplatformDRMConfiguration(
+            customIntegrationId: customIntegrationId,
+            keySystemConfigurations: KeySystemConfigurationCollection(fairplay: fairplayKeySystem, widevine: widevineKeySystem),
+            queryParameters: queryParameters
+        )
     }
 
 

package/ios/THEOplayerRCTView+AppState.swift

@@ -0,0 +1,33 @@
+// THEOplayerRCTView+AppState.swift
+
+import Foundation
+
+extension THEOplayerRCTView {
+    func setupAppStateObservers() {
+        NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(applicationDidEnterBackground),
+            name: UIApplication.didEnterBackgroundNotification,
+            object: nil
+        )
+        
+        NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(applicationWillEnterForeground),
+            name: UIApplication.willEnterForegroundNotification,
+            object: nil
+        )
+    }
+    
+    func clearAppStateObservers() {
+        NotificationCenter.default.removeObserver(self)
+    }
+
+    @objc private func applicationDidEnterBackground() {
+        self.isApplicationInBackground = true
+    }
+
+    @objc private func applicationWillEnterForeground() {
+        self.isApplicationInBackground = false
+    }
+}

package/ios/THEOplayerRCTView.swift

@@ -21,6 +21,8 @@ import THEOplayerMillicastIntegration
 import THEOplayerTHEOliveIntegration
 #endif
 
+let SAFE_AREA_INSET_OFFSET: CGFloat = 47.0
+
 public class THEOplayerRCTView: UIView {
     // MARK: Members
     public private(set) var player: THEOplayer?
@@ -40,6 +42,7 @@ public class THEOplayerRCTView: UIView {
     var remoteCommandsManager: THEOplayerRCTRemoteCommandsManager
     var pipManager: THEOplayerRCTPipManager
     var pipControlsManager: THEOplayerRCTPipControlsManager
+    var isApplicationInBackground: Bool = (UIApplication.shared.applicationState == .background)
     
     var adsConfig = AdsConfig()
     var castConfig = CastConfig()
@@ -108,8 +111,9 @@ public class THEOplayerRCTView: UIView {
         self.remoteCommandsManager = THEOplayerRCTRemoteCommandsManager()
         self.pipManager = THEOplayerRCTPipManager()
         self.pipControlsManager = THEOplayerRCTPipControlsManager()
-        
         super.init(frame: .zero)
+        
+        self.setupAppStateObservers()
     }
     
     required init?(coder aDecoder: NSCoder) {
@@ -126,6 +130,8 @@ public class THEOplayerRCTView: UIView {
     }
   
     deinit {
+        self.clearAppStateObservers()
+        
         self.mainEventHandler.destroy()
         self.textTrackEventHandler.destroy()
         self.mediaTrackEventHandler.destroy()
@@ -144,9 +150,12 @@ public class THEOplayerRCTView: UIView {
         self.destroyBackgroundAudio()
         self.player?.removeAllIntegrations()
         self.player = nil
+        
         if DEBUG_THEOPLAYER_INTERACTION { PrintUtils.printLog(logText: "[NATIVE] THEOplayer instance destroyed.") }
     }
     
+    // MARK: - View Layout
+    
     override public func layoutSubviews() {
         super.layoutSubviews()
         if let player = self.player {
@@ -157,6 +166,25 @@ public class THEOplayerRCTView: UIView {
         }
     }
     
+    override public var safeAreaInsets: UIEdgeInsets {
+#if os(iOS)
+        // When in fullscreen mode, we need to provide some insets
+        // to avoid content being obscured by notches or home indicators.
+        if self.presentationModeManager.presentationMode == .fullscreen,
+           let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
+            let orientation = windowScene.interfaceOrientation
+            let isPortrait = orientation.rawValue <= 2
+            let verticalInset = isPortrait ? SAFE_AREA_INSET_OFFSET: 0.0
+            let horizontalInset = isPortrait ? 0.0: SAFE_AREA_INSET_OFFSET
+            return UIEdgeInsets.init(top: verticalInset, left: horizontalInset, bottom: verticalInset, right: horizontalInset)
+        }
+#endif
+        // When inline, the THEOplayerView itself should be possitioned correctly by the customer,
+        // taking into account their app's safe areas, so no explicit safe area insets needed.
+        // On tvOS no insets required.
+        return .zero
+    }
+    
     // MARK: - Create Player
     
     func createPlayer() {

package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift

@@ -2,20 +2,13 @@
 
 import Foundation
 import THEOplayerSDK
-import AVFAudio
 import AVKit
 
-struct BackgroundAudioConfig {
-    var enabled: Bool = false
-    var shouldResumeAfterInterruption: Bool = false
-    var audioSessionMode: AVAudioSession.Mode = .moviePlayback
-}
-
 class THEOplayerRCTBackgroundAudioManager: NSObject, BackgroundPlaybackDelegate {
     // MARK: Members
     private weak var player: THEOplayer?
     private weak var view: THEOplayerRCTView?
-  
+    
     // MARK: - player setup / breakdown
     func setPlayer(_ player: THEOplayer, view: THEOplayerRCTView?) {
         self.player = player
@@ -26,25 +19,34 @@ class THEOplayerRCTBackgroundAudioManager: NSObject, BackgroundPlaybackDelegate
     func destroy() {
         self.cancelInterruptionNotifications()
     }
-  
+    
     // MARK: - logic
     func shouldContinueAudioPlaybackInBackground() -> Bool {
-        if let view = self.view {
+        if let view = self.view, let player = self.player {
+            let stopOnBackground = view.backgroundAudioConfig.stopOnBackground
+            let inPip = view.presentationModeManager.presentationMode == .pictureInPicture
+            
+            if stopOnBackground && !inPip {
+                if true || DEBUG_THEOPLAYER_INTERACTION { PrintUtils.printLog(logText: "[NATIVE] Moved to background, not in pip and stopOnBackground is enabled => stopping playback") }
+                player.stop()
+                return false
+            }
+            
             view.nowPlayingManager.updateNowPlaying()
             return view.backgroundAudioConfig.enabled
         }
         return false
     }
-  
+    
     func cancelInterruptionNotifications() {
         NotificationCenter.default.removeObserver(self,
                                                   name: AVAudioSession.interruptionNotification,
                                                   object: AVAudioSession.sharedInstance())
     }
-  
+    
     func updateInterruptionNotifications() {
         guard let view = self.view else { return }
-      
+        
         // Get the default notification center instance.
         if view.backgroundAudioConfig.shouldResumeAfterInterruption {
             NotificationCenter.default.addObserver(self,
@@ -57,10 +59,10 @@ class THEOplayerRCTBackgroundAudioManager: NSObject, BackgroundPlaybackDelegate
                                                       object: AVAudioSession.sharedInstance())
         }
     }
-  
+    
     func updateAVAudioSessionMode() {
         guard let view = self.view else { return }
-      
+        
         do {
             THEOplayer.automaticallyManageAudioSession = (view.backgroundAudioConfig.audioSessionMode == .moviePlayback)
             try AVAudioSession.sharedInstance().setCategory(AVAudioSession.Category.playback, mode: view.backgroundAudioConfig.audioSessionMode)
@@ -71,14 +73,14 @@ class THEOplayerRCTBackgroundAudioManager: NSObject, BackgroundPlaybackDelegate
             if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] Unable to update AVAudioSession mode to \(view.backgroundAudioConfig.audioSessionMode.rawValue): \(error)") }
         }
     }
-  
+    
     @objc func handleInterruption(notification: Notification) {
         guard let userInfo = notification.userInfo,
               let typeValue = userInfo[AVAudioSessionInterruptionTypeKey] as? UInt,
               let type = AVAudioSession.InterruptionType(rawValue: typeValue) else {
             return
         }
-      
+        
         // Switch over the interruption type.
         switch type {
         case .began:

package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift

@@ -22,7 +22,7 @@ class THEOplayerRCTNowPlayingManager {
     func destroy() {
         // dettach listeners
         self.detachListeners()
-
+        
         // update elapsed time on close
         if let player = self.player {
             updateCurrentTime(player.currentTime)
@@ -105,7 +105,7 @@ class THEOplayerRCTNowPlayingManager {
             self.clearNowPlayingOnInfoCenter()
         }
     }
-
+    
     private func clearNowPlayingOnInfoCenter() {
         Task { @MainActor in
             MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
@@ -271,7 +271,7 @@ class THEOplayerRCTNowPlayingManager {
                 welf.processNowPlayingToInfoCenter()
             }
         }
-                                          
+        
         
         // RATE_CHANGE
         self.rateChangeListener = player.addEventListener(type: PlayerEventTypes.RATE_CHANGE) { [weak self, weak player] event in