react-native-theoplayer 10.4.0 → 10.5.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).
 
+## [10.5.1] - 25-11-28
+
+### Added
+
+- Support for contentProtection query parameters on THEOlive sources.
+
+## [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.
+- On iOS, we now also pass all available qualities and the current active quality when bridging video- and audio track data.
+
 ## [10.4.0] - 25-11-13
 
 ### Fixed
@@ -15,6 +38,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 +162,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/source/SourceAdapter.kt

@@ -178,6 +178,9 @@ class SourceAdapter {
       },
       latencyConfiguration=jsonTypedSource.optJSONObject(PROP_LATENCY_CONFIGURATION)?.let {
         parseLatencyConfiguration(it)
+      },
+      drm=jsonTypedSource.optJSONObject(PROP_CONTENT_PROTECTION)?.let {
+        ContentProtectionAdapter.drmConfigurationFromJson(it)
       }
     )
   }

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,12 @@ 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)
+            
             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": THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: event.quality)
             ])
         }
     }
@@ -264,23 +250,12 @@ 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)
             
             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": THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: event.quality)
             ])
         }
     }
@@ -299,14 +274,4 @@ class THEOplayerRCTMediaTrackEventHandler {
         }
         return nil;
     }
-    
-    private func labelFromBandWidth(_ bandWidth: Int) -> String {
-        if bandWidth > 1000000 {
-            return "\(Double(bandWidth / 1000) / 1000) Mbps"
-        } else if bandWidth > 1000 {
-            return "\(bandWidth / 1000) kbps"
-        } else {
-            return "No Label"
-        }
-    }
 }

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"
@@ -194,7 +195,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
         let type = typedSourceData[SD_PROP_TYPE] as? String
         
         if integration == "theolive" || type == "theolive" {
-            return THEOplayerRCTSourceDescriptionBuilder.buildTHEOliveDescription(typedSourceData)
+            return THEOplayerRCTSourceDescriptionBuilder.buildTHEOliveDescription(typedSourceData, contentPotection: contentProtection)
         }
 
         if type == "millicast" {
@@ -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? {
+        let customIntegrationId = contentProtectionData[SD_PROP_INTEGRATION] as? String ?? "internal"
+        
+        // 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/THEOplayerRCTTrackMetadataAggregator.swift

@@ -179,9 +179,16 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_LABEL] = audioTrack.label
         entry[PROP_UNLOCALIZED_LABEL] = audioTrack.unlocalizedLabel
         entry[PROP_ENABLED] = audioTrack.enabled
-        entry[PROP_QUALITIES] = []          // empty: qualities are not being exposed on iOS
-        //entry[PROP_ACTIVE_QUALITY] =      // undefined: qualities are not being exposed on iOS
-        //entry[PROP_TARGET_QUALITY] =      // undefined: qualities are not being exposed on iOS
+        
+        // add known qualities
+        entry[PROP_QUALITIES] = (0..<audioTrack.qualities.count).map { index in
+            return THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: audioTrack.qualities.get(index))
+        }
+        
+        // add active quality
+        if let activeQuality = audioTrack.activeQuality {
+            entry[PROP_ACTIVE_QUALITY] = THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: activeQuality)
+        }
         return entry
     }
     
@@ -221,9 +228,17 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_LABEL] = videoTrack.label
         entry[PROP_UNLOCALIZED_LABEL] = videoTrack.unlocalizedLabel
         entry[PROP_ENABLED] = videoTrack.enabled
-        entry[PROP_QUALITIES] = []          // empty: qualities are not being exposed on iOS
-        //entry[PROP_ACTIVE_QUALITY] =      // undefined: qualities are not being exposed on iOS
-        //entry[PROP_TARGET_QUALITY] =      // undefined: qualities are not being exposed on iOS
+        
+        // add known qualities
+        entry[PROP_QUALITIES] = (0..<videoTrack.qualities.count).map { index in
+            return THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: videoTrack.qualities.get(index))
+        }
+        
+        // add active quality
+        if let activeQuality = videoTrack.activeQuality {
+            entry[PROP_ACTIVE_QUALITY] = THEOplayerRCTTrackMetadataAggregator.aggregatedQualityInfo(quality: activeQuality)
+        }
+        
         return entry
     }
 
@@ -240,6 +255,43 @@ class THEOplayerRCTTrackMetadataAggregator {
         return 0
     }
     
+    class func labelFromBandWidth(_ bandWidth: Int) -> String {
+        if bandWidth > 1000000 {
+            return "\(Double(bandWidth / 1000) / 1000) Mbps"
+        } else if bandWidth > 1000 {
+            return "\(bandWidth / 1000) kbps"
+        } else {
+            return "No Label"
+        }
+    }
+    
+    class func aggregatedQualityInfo(quality: Quality) -> [String:Any] {
+        let identifier = String(quality.bandwidth)
+        let label = THEOplayerRCTTrackMetadataAggregator.labelFromBandWidth(quality.bandwidth)
+        
+        // common properties
+        var entry: [String:Any] = [
+            "bandwidth": quality.bandwidth,
+            "codecs": "",
+            "id": identifier,
+            "uid": identifier,
+            "name": label,
+            "label": label,
+            "available": true,
+        ]
+        if let averageBandwidth = quality.averageBandwidth {
+            entry["averageBandwidth"] = averageBandwidth
+        }
+ 
+        // videoQuality specific properties
+        if let videoQuality = quality as? VideoQuality {
+            entry["width"] = videoQuality.width
+            entry["height"] = videoQuality.height
+        }
+         
+        return entry
+    }
+    
     class func aggregatedMetadataAndChapterTrackInfo(trackDescriptions: [TextTrackDescription], completed: (([[String:Any]]) -> Void)? ) {
         var trackIndex = 0
         var tracksInfo: [[String:Any]] = []

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() {