react-native-theoplayer 9.10.0 → 10.1.0

package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift

@@ -16,6 +16,7 @@ class THEOplayerRCTNowPlayingManager {
     private var rateChangeListener: EventListener?
     private var seekedListener: EventListener?
     private var sourceChangeListener: EventListener?
+    private var appTerminationObserver: Any?
     
     // MARK: - destruction
     func destroy() {
@@ -31,6 +32,8 @@ class THEOplayerRCTNowPlayingManager {
         // clear nowPlayingInfo
         self.nowPlayingInfo = [:]
         self.clearNowPlayingOnInfoCenter()
+        
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] Destroy, nowPlayingInfo cleared on infoCenter.") }
     }
     
     // MARK: - player setup / breakdown
@@ -41,6 +44,24 @@ class THEOplayerRCTNowPlayingManager {
         self.attachListeners()
     }
     
+    func printCurrentNowPlayingInfo() {
+        Task { @MainActor [weak self] in
+            if let info = MPNowPlayingInfoCenter.default().nowPlayingInfo {
+                PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO] MPNowPlayingInfoCenter.default().nowPlayingInfo = ")
+                info.forEach { (key: String, value: Any) in
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO]   -> \(key): \(value)")
+                }
+                if let player = self?.player {
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO] playerInfo = ")
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO]   -> currentTime: \(player.currentTime)")
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO]   -> playbackRate: \(player.playbackRate)")
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO]   -> paused: \(player.paused)")
+                    PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO CURRENT INFO]   -> duration: \(player.duration ?? -1)")
+                }
+            }
+        }
+    }
+    
     func updateNowPlaying() {
         // Reset any existing playing info
         self.nowPlayingInfo = [:]
@@ -50,7 +71,6 @@ class THEOplayerRCTNowPlayingManager {
            let sourceDescription = player.source,
            let metadata = sourceDescription.metadata {
             let artWorkUrlString = self.getArtWorkUrlStringFromSourceDescription(sourceDescription)
-            self.updatePlaybackState()
             self.nowPlayingInfo = [String : Any]()
             self.updateTitle(metadata.title)
             self.updateArtist(metadata.metadataKeys?["artist"] as? String)
@@ -66,31 +86,33 @@ class THEOplayerRCTNowPlayingManager {
                 self?.processNowPlayingToInfoCenter()
             }
         } else {
-          self.clearNowPlayingOnInfoCenter()
+            self.clearNowPlayingOnInfoCenter()
         }
     }
     
     private func processNowPlayingToInfoCenter() {
         let nowPlayingInfo = self.nowPlayingInfo
-        DispatchQueue.main.async {
-            if !nowPlayingInfo.isEmpty {
+        if !nowPlayingInfo.isEmpty {
+            Task { @MainActor in
                 MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
-            } else {
-                MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
+                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] nowPlayingInfo processed to infoCenter.") }
+                
+                if DEBUG_NOWINFO {
+                    self.printCurrentNowPlayingInfo()
+                }
             }
+        } else {
+            self.clearNowPlayingOnInfoCenter()
         }
     }
 
     private func clearNowPlayingOnInfoCenter() {
-        DispatchQueue.main.async {
+        Task { @MainActor in
             MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
-        }
-    }
-    
-    private func processPlaybackStateToInfoCenter(paused: Bool) {
-        if #available(iOS 13.0, tvOS 13.0, *) {
-            DispatchQueue.main.async {
-                MPNowPlayingInfoCenter.default().playbackState = paused ? MPNowPlayingPlaybackState.paused : MPNowPlayingPlaybackState.playing
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] clearing nowPlayingInfo (to nil) on infoCenter.") }
+            
+            if DEBUG_NOWINFO {
+                self.printCurrentNowPlayingInfo()
             }
         }
     }
@@ -110,58 +132,48 @@ class THEOplayerRCTNowPlayingManager {
     private func updateTitle(_ metadataTitle: String?) {
         if let title = metadataTitle {
             self.nowPlayingInfo[MPMediaItemPropertyTitle] = title
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] title [\(title)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateArtist(_ metadataArtist: String?) {
         if let artist = metadataArtist {
             self.nowPlayingInfo[MPMediaItemPropertyArtist] = artist
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] artist [\(artist)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateAlbum(_ metadataAlbum: String?) {
         if let album = metadataAlbum {
             self.nowPlayingInfo[MPMediaItemPropertyAlbumTitle] = album
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] album [\(album)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateSubtitle(_ metadataSubtitle: String?) {
         if let subtitle = metadataSubtitle {
             self.nowPlayingInfo[MPMediaItemPropertyArtist] = subtitle
-        }
-    }
-    
-    private func updateDuration(_ playerDuration: Double?) {
-        if let duration = playerDuration {
-            self.nowPlayingInfo[MPNowPlayingInfoPropertyIsLiveStream] = duration.isInfinite
-            if (!duration.isInfinite) {
-                self.nowPlayingInfo[MPMediaItemPropertyPlaybackDuration] = duration
-            }
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] subtitle [\(subtitle)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateServiceIdentifier(_ serviceId: String?) {
-        if let id = serviceId {
-            self.nowPlayingInfo[MPNowPlayingInfoPropertyServiceIdentifier] = id
+        if let serviceId = serviceId {
+            self.nowPlayingInfo[MPNowPlayingInfoPropertyServiceIdentifier] = serviceId
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] serviceId [\(serviceId)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateContentIdentifier(_ contentId: String?) {
-        if let id = contentId {
-            self.nowPlayingInfo[MPNowPlayingInfoPropertyExternalContentIdentifier] = id
+        if let contentId = contentId {
+            self.nowPlayingInfo[MPNowPlayingInfoPropertyExternalContentIdentifier] = contentId
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] contentId [\(contentId)] stored in nowPlayingInfo.") }
         }
     }
     
     private func updateMediaType() {
         self.nowPlayingInfo[MPNowPlayingInfoPropertyMediaType] = NSNumber(value: 2)
-    }
-    
-    private func updatePlaybackState() {
-        if #available(iOS 13.0, tvOS 13.0, *) {
-            if let player = self.player {
-                self.processPlaybackStateToInfoCenter(paused: player.paused)
-            }
-        }
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] mediaType [hardcoded 2, for video] stored in nowPlayingInfo.") }
     }
     
     private func updateArtWork(_ urlString: String?, completion: (() -> Void)?) {
@@ -173,9 +185,9 @@ class THEOplayerRCTNowPlayingManager {
                     self?.nowPlayingInfo[MPMediaItemPropertyArtwork] = MPMediaItemArtwork(boundsSize: displayIcon.size) { size in
                         return displayIcon
                     }
-                    if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] Artwork updated in nowPlayingInfo.") }
+                    if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] Artwork stored in nowPlayingInfo.") }
                 } else {
-                    if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] Failed to update artwork in nowPlayingInfo.") }
+                    if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] Failed to store artwork in nowPlayingInfo.") }
                 }
                 completion?()
             }
@@ -187,10 +199,31 @@ class THEOplayerRCTNowPlayingManager {
     
     private func updatePlaybackRate(_ playerPlaybackRate: Double) {
         self.nowPlayingInfo[MPNowPlayingInfoPropertyPlaybackRate] = NSNumber(value: playerPlaybackRate)
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] playbackrate [\(playerPlaybackRate)] stored in nowPlayingInfo.") }
     }
     
     private func updateCurrentTime(_ currentTime: Double) {
         self.nowPlayingInfo[MPNowPlayingInfoPropertyElapsedPlaybackTime] = NSNumber(value: currentTime)
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] currentTime [\(currentTime)] stored in nowPlayingInfo.") }
+    }
+    
+    private func updateDuration(_ duration: Double?) {
+        if let duration = duration {
+            let isLiveStream = duration.isInfinite
+            self.nowPlayingInfo[MPNowPlayingInfoPropertyIsLiveStream] = isLiveStream
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] isLiveStream [\(isLiveStream)] stored in nowPlayingInfo.") }
+            if !isLiveStream {
+                self.nowPlayingInfo[MPMediaItemPropertyPlaybackDuration] = NSNumber(value: duration)
+                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] duration [\(duration)] stored in nowPlayingInfo.") }
+            }
+        }
+    }
+    
+    @objc
+    private func appWillTerminate() {
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] App will terminate notification received.") }
+        MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
+        if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO] nowPlayingInfo cleared for app termination.") }
     }
     
     private func attachListeners() {
@@ -198,40 +231,43 @@ class THEOplayerRCTNowPlayingManager {
             return
         }
         
+        // When app terminates, clear the nowPlayingInfo.
+        self.appTerminationObserver = NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(appWillTerminate),
+            name: UIApplication.willTerminateNotification,
+            object: nil
+        )
+        
         // DURATION_CHANGE
         self.durationChangeListener = player.addEventListener(type: PlayerEventTypes.DURATION_CHANGE) { [weak self, weak player] event in
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] DURATION_CHANGE") }
             if let welf = self,
                let wplayer = player,
                let duration = wplayer.duration {
-                welf.nowPlayingInfo[MPNowPlayingInfoPropertyIsLiveStream] = duration.isInfinite
-                if (!duration.isInfinite) {
-                    welf.nowPlayingInfo[MPMediaItemPropertyPlaybackDuration] = duration
-                    if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] DURATION_CHANGE: Updating duration on NowPlayingInfoCenter...") }
-                    welf.processNowPlayingToInfoCenter()
-                }
+                welf.updateDuration(duration)
+                welf.processNowPlayingToInfoCenter()
             }
         }
         
         // PLAYING
         self.playingListener = player.addEventListener(type: PlayerEventTypes.PLAYING) { [weak self, weak player] event in
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] PLAYING") }
             if let welf = self,
                let wplayer = player {
                 welf.updatePlaybackRate(wplayer.playbackRate)
-                welf.updatePlaybackState()
                 welf.updateCurrentTime(wplayer.currentTime)
-                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] PLAYING: Updating playbackState and time on NowPlayingInfoCenter...") }
                 welf.processNowPlayingToInfoCenter()
             }
         }
         
         // PAUSE
         self.pauseListener = player.addEventListener(type: PlayerEventTypes.PAUSE) { [weak self, weak player] event in
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] PAUSE") }
             if let welf = self,
                let wplayer = player {
                 welf.updatePlaybackRate(0)
-                welf.updatePlaybackState()
                 welf.updateCurrentTime(wplayer.currentTime)
-                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] PAUSED: Updating PlaybackState and time on NowPlayingInfoCenter...") }
                 welf.processNowPlayingToInfoCenter()
             }
         }
@@ -239,28 +275,29 @@ class THEOplayerRCTNowPlayingManager {
         
         // RATE_CHANGE
         self.rateChangeListener = player.addEventListener(type: PlayerEventTypes.RATE_CHANGE) { [weak self, weak player] event in
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] RATE_CHANGE") }
             if let welf = self,
                let wplayer = player {
                 welf.updatePlaybackRate(wplayer.playbackRate)
                 welf.updateCurrentTime(wplayer.currentTime)
-                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] RATE_CHANGE: Updating playbackRate on NowPlayingInfoCenter...") }
                 welf.processNowPlayingToInfoCenter()
             }
         }
         
         // SEEKED
         self.seekedListener = player.addEventListener(type: PlayerEventTypes.SEEKED) { [weak self, weak player] event in
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] SEEKED") }
             if let welf = self,
                let wplayer = player {
+                welf.updatePlaybackRate(wplayer.playbackRate)
                 welf.updateCurrentTime(wplayer.currentTime)
-                if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] SEEKED: Time updated on NowPlayingInfoCenter.") }
                 welf.processNowPlayingToInfoCenter()
             }
         }
         
         // SOURCE_CHANGE
         self.sourceChangeListener = player.addEventListener(type: PlayerEventTypes.SOURCE_CHANGE) { [weak self] event in
-            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE] SOURCE_CHANGE: Full update on NowPlayingInfoCenter.") }
+            if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE-NOWPLAYINGINFO-EVENT] SOURCE_CHANGE \(event.source == nil ? "to nil" : "")") }
             self?.updateNowPlaying()
         }
     }
@@ -270,6 +307,15 @@ class THEOplayerRCTNowPlayingManager {
             return
         }
         
+        // When app terminates, clear the nowPlayingInfo.
+        if let appTerminationObserver = self.appTerminationObserver {
+            NotificationCenter.default.removeObserver(
+                appTerminationObserver,
+                name: UIApplication.willTerminateNotification,
+                object: nil)
+            self.appTerminationObserver = nil
+        }
+        
         // DURATION_CHANGE
         if let durationChangeListener = self.durationChangeListener {
             player.removeEventListener(type: PlayerEventTypes.DURATION_CHANGE, listener: durationChangeListener)

package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift

@@ -84,7 +84,6 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
         // 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.pauseCommand.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

package/ios/casting/THEOplayerRCTCastEventHandler.swift

@@ -52,7 +52,7 @@ class THEOplayerRCTCastEventHandler {
             if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received Chromecast STATE_CHANGE event from THEOplayer cast.chromecast") }
             if let forwardedCastEvent = self?.onNativeCastEvent {
                 let newCastState = event.state._rawValue
-                if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] New Chromecast state: \(newCastState)") }
+                if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received new Chromecast state: \(newCastState)") }
                 forwardedCastEvent([
                     CAST_EVENT_PROP_TYPE: EVENT_TYPE_CHROMECAST_STATE_CHANGE,
                     CAST_EVENT_PROP_STATE: newCastState

package/ios/presentationMode/THEOplayerRCTPresentationModeManager.swift

@@ -15,6 +15,7 @@ public class THEOplayerRCTPresentationModeManager {
   
     private weak var containerView: UIView?                  // view containing the playerView and it's siblings (e.g. UI)
     private weak var inlineParentView: UIView?               // target view for inline representation
+    private var inlineParentViewIndex: Int?
         
     // MARK: Events
     var onNativePresentationModeChange: RCTDirectEventBlock?
@@ -58,7 +59,11 @@ public class THEOplayerRCTPresentationModeManager {
         return viewControllers
     }
 
-    private func moveView(_ movingView: UIView, to targetView: UIView) {
+    /**
+     * Moves a view to a new parent.
+     * The view is inserted at the provided targetViewIndex or else at the front.
+     */
+    private func moveView(_ movingView: UIView, to targetView: UIView, targetViewIndex: Int? = nil) {
         // detach the moving viewControllers from their parent
         let movingViewControllers = self.movingVCs(for: movingView)
         movingViewControllers.forEach { movedVC in
@@ -67,8 +72,13 @@ public class THEOplayerRCTPresentationModeManager {
         
         // move the actual view
         movingView.removeFromSuperview()
-        targetView.addSubview(movingView)
-        targetView.bringSubviewToFront(movingView)
+        if let viewIndex = targetViewIndex {
+            let safeIndex = min(viewIndex, targetView.subviews.count)
+            targetView.insertSubview(movingView, at: safeIndex)
+        } else {
+            targetView.addSubview(movingView)
+            targetView.bringSubviewToFront(movingView)
+        }
         
         // attach the moving viewControllers to their new parent
         if let targetViewController = targetView.findViewController() {
@@ -85,9 +95,11 @@ public class THEOplayerRCTPresentationModeManager {
         
         // move the player
         if let containerView = self.containerView,
+           let inlineParentView = self.inlineParentView,
            let fullscreenParentView = self.view?.findParentViewOfType(["RCTRootContentView", "RCTRootComponentView"])  {
-            self.moveView(containerView, to: fullscreenParentView)
-
+            self.inlineParentViewIndex = inlineParentView.subviews.firstIndex(of: containerView)
+            self.moveView(containerView, to: fullscreenParentView, targetViewIndex: nil)
+            
             // start hiding home indicator
             setHomeIndicatorHidden(true)
         }
@@ -101,10 +113,16 @@ public class THEOplayerRCTPresentationModeManager {
         // move the player
         if let containerView = self.containerView,
            let inlineParentView = self.inlineParentView {
-            self.moveView(containerView, to: inlineParentView)
+            self.moveView(containerView, to: inlineParentView, targetViewIndex: self.inlineParentViewIndex)
         }
         self.rnInlineMode = .inline
     }
+    
+    /*private func logSubviews(of parent: UIView) {
+        for (index, subview) in parent.subviews.enumerated() {
+            print("Index \(index): \(type(of: subview)) - \(subview)")
+        }
+    }*/
 
     private func setHomeIndicatorHidden(_ hidden: Bool) {
 #if os(iOS)

package/ios/theoAds/THEOplayerRCTTHEOAdsAPI.swift

@@ -0,0 +1,101 @@
+//
+//  THEOplayerRCTTHEOAdsAPI.swift
+//  Theoplayer
+//
+import Foundation
+
+#if canImport(THEOplayerTHEOadsIntegration)
+import THEOplayerTHEOadsIntegration
+#endif
+
+let ERROR_MESSAGE_THEOADS_UNSUPPORTED_FEATURE = "This functionality is not supported by the provided iOS SDKs"
+let ERROR_CODE_THEOADS_ACCESS_FAILURE = "theoads_access_failure"
+let ERROR_MESSAGE_THEOADS_ACCESS_FAILURE = "Could not access THEOplayer THEOAds Module"
+
+@objc(THEOplayerRCTTHEOAdsAPI)
+class THEOplayerRCTTHEOAdsAPI: NSObject, RCTBridgeModule {
+    @objc var bridge: RCTBridge!
+
+    static func moduleName() -> String! {
+        return "THEORCTTHEOAdsModule"
+    }
+
+    static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+
+#if canImport(THEOplayerTHEOadsIntegration)
+    @objc(currentInterstitials:resolver:rejecter:)
+    func currentInterstitials(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        DispatchQueue.main.async {
+            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
+               let player = theView.player,
+               let theoAds = player.ads.theoAds {
+                var currentInterstitials: [[String:Any]] = []
+                for interstitial in theoAds.currentInterstitials {
+                    currentInterstitials.append(THEOplayerRCTTHEOadsEventAdapter.fromInterstitial(interstitial))
+                }
+                resolve(currentInterstitials)
+            } else {
+                if DEBUG_THEOADS_API { PrintUtils.printLog(logText: "[NATIVE] Could not get currentInterstitials (THEOAds module unavailable).") }
+                reject(ERROR_CODE_THEOADS_ACCESS_FAILURE, ERROR_MESSAGE_THEOADS_ACCESS_FAILURE, nil)
+            }
+        }
+    }
+    
+    @objc(scheduledInterstitials:resolver:rejecter:)
+    func scheduledInterstitials(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        DispatchQueue.main.async {
+            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
+               let player = theView.player,
+               let theoAds = player.ads.theoAds {
+                var scheduledInterstitials: [[String:Any]] = []
+                for interstitial in theoAds.scheduledInterstitials {
+                    scheduledInterstitials.append(THEOplayerRCTTHEOadsEventAdapter.fromInterstitial(interstitial))
+                }
+                resolve(scheduledInterstitials)
+            } else {
+                if DEBUG_THEOADS_API { PrintUtils.printLog(logText: "[NATIVE] Could not get scheduledInterstitials (THEOAds module unavailable).") }
+                reject(ERROR_CODE_THEOADS_ACCESS_FAILURE, ERROR_MESSAGE_THEOADS_ACCESS_FAILURE, nil)
+            }
+        }
+    }
+    
+    @objc(replaceAdTagParameters:adTagParameters:)
+    func replaceAdTagParameters(_ node: NSNumber, adTagParameters: [String:Any]?) -> Void {
+        DispatchQueue.main.async {
+            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
+               let player = theView.player,
+               let theoAds = player.ads.theoAds {
+                if let newParams = adTagParameters as? [String: String] {
+                    theoAds.replaceAdTagParams(params: newParams)
+                    if DEBUG_THEOADS_API { PrintUtils.printLog(logText: "[NATIVE] THEOAds adTagParameters replaced.") }
+                } else {
+                    if DEBUG_THEOADS_API { PrintUtils.printLog(logText: "[NATIVE] Could not replace THEOAds adTagParameters.") }
+                }
+            }
+        }
+    }
+
+#else
+
+    @objc(currentInterstitials:resolver:rejecter:)
+    func currentInterstitials(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        if DEBUG_THEOADS_API { print(ERROR_MESSAGE_THEOADS_UNSUPPORTED_FEATURE) }
+        reject(ERROR_CODE_THEOADS_ACCESS_FAILURE, ERROR_MESSAGE_THEOADS_ACCESS_FAILURE, nil)
+    }
+
+    @objc(scheduledInterstitials:resolver:rejecter:)
+    func scheduledInterstitials(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        if DEBUG_THEOADS_API { print(ERROR_MESSAGE_THEOADS_UNSUPPORTED_FEATURE) }
+        reject(ERROR_CODE_THEOADS_ACCESS_FAILURE, ERROR_MESSAGE_THEOADS_ACCESS_FAILURE, nil)
+    }
+    
+    @objc(replaceAdTagParameters:token:)
+    func replaceAdTagParameters(_ node: NSNumber, adTagParameters: [String:Any]?) -> Void {
+        if DEBUG_THEOADS_API { print(ERROR_MESSAGE_THEOADS_UNSUPPORTED_FEATURE) }
+    }
+
+#endif
+
+}

package/ios/theoAds/THEOplayerRCTTHEOAdsEventAdapter.swift

@@ -0,0 +1,118 @@
+// THEOplayerRCTTHEOadsEventAdapter.swift
+
+import Foundation
+import THEOplayerSDK
+
+#if canImport(THEOplayerTHEOadsIntegration)
+@_spi(Core) import THEOplayerTHEOadsIntegration
+#endif
+
+// general
+let PROP_INTERSTITIAL_ID: String = "id"
+let PROP_INTERSTITIAL_TYPE: String = "type"
+let PROP_INTERSTITIAL_START_TIME: String = "startTime"
+let PROP_INTERSTITIAL_DURATION: String = "duration"
+
+// adbreak specific
+let PROP_ADBREAK_INTERSTITIAL_LAYOUT: String = "layout"
+let PROP_ADBREAK_INTERSTITIAL_BACKDROPURI: String = "backdropUri"
+let PROP_ADBREAK_INTERSTITIAL_ADS: String = "ads"
+
+// overlay specific
+let PROP_OVERLAY_INTERSTITIAL_IMAGE_URL: String = "imageUrl"
+let PROP_OVERLAY_INTERSTITIAL_CLICKTHROUGH: String = "clickThrough"
+let PROP_OVERLAY_INTERSTITIAL_POSITION: String = "position"
+let PROP_OVERLAY_INTERSTITIAL_SIZE: String = "size"
+
+class THEOplayerRCTTHEOadsEventAdapter {
+
+#if canImport(THEOplayerTHEOadsIntegration)
+    class func fromInterstitial(_ interstitial: THEOplayerTHEOadsIntegration.Interstitial?) -> [String:Any] {
+        guard let interstitial = interstitial else {
+            return [:]
+        }
+        
+        var interstitialData: [String:Any] = [:]
+        interstitialData[PROP_INTERSTITIAL_ID] = interstitial.id
+        interstitialData[PROP_INTERSTITIAL_TYPE] = THEOplayerRCTTHEOadsEventAdapter.fromInterstitialType(interstitial.type)
+        interstitialData[PROP_INTERSTITIAL_START_TIME] = interstitial.startTime
+        if let duration = interstitial.duration {
+            interstitialData[PROP_INTERSTITIAL_DURATION] = duration
+        }
+        
+        // ADBREAK-INTERSTITIAL SPECIFIC:
+        if let adBreakInterstitial = interstitial as? THEOplayerTHEOadsIntegration.AdBreakInterstitial {
+            interstitialData[PROP_ADBREAK_INTERSTITIAL_LAYOUT] = THEOplayerRCTTHEOadsEventAdapter.fromInterstitialLayout(adBreakInterstitial.layout)
+            if let backdropUri = adBreakInterstitial.backdropUri {
+                interstitialData[PROP_ADBREAK_INTERSTITIAL_BACKDROPURI] = backdropUri
+            }
+            let interstitialAds = adBreakInterstitial.ads
+            var ads: [[String:Any]] = []
+            for ad in interstitialAds {
+                ads.append(THEOplayerRCTAdAdapter.fromAd(ad: ad))
+            }
+            interstitialData[PROP_ADBREAK_INTERSTITIAL_ADS] = ads
+        }
+        
+        // OVERLAY-INTERSTITIAL SPECIFIC
+        if let overlayInterstitial = interstitial as? THEOplayerTHEOadsIntegration.OverlayInterstitial {
+            if let imageUrl = overlayInterstitial.imageUrl {
+                interstitialData[PROP_OVERLAY_INTERSTITIAL_IMAGE_URL] = imageUrl
+            }
+            if let clickThrough = overlayInterstitial.clickThrough {
+                interstitialData[PROP_OVERLAY_INTERSTITIAL_CLICKTHROUGH] = clickThrough
+            }
+            interstitialData[PROP_OVERLAY_INTERSTITIAL_POSITION] = THEOplayerRCTTHEOadsEventAdapter.fromOverlayPosition(overlayInterstitial.position)
+            interstitialData[PROP_OVERLAY_INTERSTITIAL_SIZE] = THEOplayerRCTTHEOadsEventAdapter.fromOverlaySize(overlayInterstitial.size)
+        }
+        
+        return interstitialData
+    }
+    
+    class func fromInterstitialType(_ interstitialType: THEOplayerTHEOadsIntegration.InterstitialType) -> String {
+        switch interstitialType {
+        case InterstitialType.adbreak:
+            return "adbreak"
+        default:
+            return "overlay"
+        }
+    }
+    
+    class func fromInterstitialLayout(_ interstitialLayout: THEOplayerTHEOadsIntegration.THEOadsLayout) -> String {
+        switch interstitialLayout {
+        case THEOadsLayout.single:
+            return "single"
+        case THEOadsLayout.double:
+            return "double"
+        default:
+            return "l-shape"
+        }
+    }
+    
+    class func fromOverlayPosition(_ overlayPosition: THEOplayerTHEOadsIntegration.OverlayPosition) -> [String:Any] {
+        var overlayPositionData: [String:Any] = [:]
+        if let left = overlayPosition.left {
+            overlayPositionData["left"] = left
+        }
+        if let right = overlayPosition.right {
+            overlayPositionData["right"] = right
+        }
+        if let top = overlayPosition.top {
+            overlayPositionData["top"] = top
+        }
+        if let bottom = overlayPosition.bottom {
+            overlayPositionData["bottom"] = bottom
+        }
+        return overlayPositionData
+    }
+    
+    class func fromOverlaySize(_ overlaySize: THEOplayerTHEOadsIntegration.OverlaySize) -> [String:Any] {
+        var overlaySizeData: [String:Any] = [:]
+        overlaySizeData["width"] = overlaySize.width
+        overlaySizeData["height"] = overlaySize.height
+        return overlaySizeData
+    }
+
+#endif
+    
+}