react-native-theoplayer 10.7.1 → 10.9.0

package/CHANGELOG.md

@@ -5,6 +5,41 @@ 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.9.0] - 26-01-29
+
+### Fixed
+
+- Fixed an issue on Android where the player could disrupt the layout by sending an unexpected dimension change event.
+- Fixed an issue on Android where the default properties of the player's `backgroundAudioConfiguration` would not be properly applied.
+
+### Added
+
+- Added functionality to synchronize the player state from the native mobile players to React Native.
+- Added a bypass property on iOS to control the THEOplayerView's ability to detach from its superView.
+- Trigger an update for the iOS control centers (nowPlayingInfo and remoteCommands) to reflect a player state sync.
+
+### Changed
+
+- Changed license to BSD 3-Cause Clear. See [LICENSE](./LICENSE) file for more information.
+
+## [10.8.0] - 26-01-22
+
+### Added
+
+- Added support on iOS to push the initial state of the player from the iOS bridge to the React native adapter.
+
+### Fixed
+
+- Fixed an issue on iOS where the integrationParameters from the contentProtection section of the source were not processed correctly, resulting in failures for DRM connectors that depend on them.
+- Fixed an issue on iOS where the player could crash when terminating the app while the player is backgrounded in fullscreen.
+- Fixed an issue on Android where `player.ads.currentAds` would not return an array of ads due to a native error.
+- Fixed an issue on Android where the player would sometimes have wrong dimensions after transitioning to fullscreen presentation mode.
+- Fixed an issue on Android where the `useEMSG` property was not included when setting a TheoAds source description.
+
+### Added
+
+- Added RNRepo support for Android to the example app. More info on the official [documentation](https://rnrepo.org/) page.
+
 ## [10.7.1] - 26-01-06
 
 ### Added

package/LICENSE

@@ -1,21 +1,33 @@
-MIT License
+The Clear BSD License
 
-Copyright (c) 2021 THEOplayer
+Copyright (c) 2025 Dolby International AB
+All rights reserved.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Redistribution and use in source and binary forms, with or without
+modification, are permitted (subject to the limitations in the disclaimer
+below) provided that the following conditions are met:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED
+BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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

@@ -53,6 +53,7 @@ import kotlin.math.floor
 private val TAG = PlayerEventEmitter::class.java.name
 
 private const val EVENT_PLAYER_READY = "onNativePlayerReady"
+private const val EVENT_PLAYER_STATE_SYNC = "onNativePlayerStateSync"
 private const val EVENT_SOURCECHANGE = "onNativeSourceChange"
 private const val EVENT_LOADSTART = "onNativeLoadStart"
 private const val EVENT_LOADEDMETADATA = "onNativeLoadedMetadata"
@@ -98,6 +99,7 @@ class PlayerEventEmitter internal constructor(
   @Retention(AnnotationRetention.SOURCE)
   @StringDef(
     EVENT_PLAYER_READY,
+    EVENT_PLAYER_STATE_SYNC,
     EVENT_SOURCECHANGE,
     EVENT_LOADSTART,
     EVENT_LOADEDMETADATA,
@@ -135,6 +137,7 @@ class PlayerEventEmitter internal constructor(
   companion object {
     val Events = arrayOf(
       EVENT_PLAYER_READY,
+      EVENT_PLAYER_STATE_SYNC,
       EVENT_SOURCECHANGE,
       EVENT_LOADSTART,
       EVENT_LOADEDMETADATA,
@@ -291,10 +294,28 @@ class PlayerEventEmitter internal constructor(
 
   fun preparePlayer(player: Player) {
     attachListeners(player)
+    emitPlayerReady()
+  }
 
-    val payload = Arguments.createMap()
-    payload.putMap(
-      EVENT_PROP_STATE,
+  fun emitPlayerReady() {
+    // Notify the player is ready
+    receiveEvent(EVENT_PLAYER_READY, Arguments.createMap().apply {
+      putMap(EVENT_PROP_STATE, collectPlayerState())
+      putMap(EVENT_PROP_VERSION, WritableNativeMap().apply {
+        putString(EVENT_PROP_VERSION, THEOplayerGlobal.getVersion())
+        putString(EVENT_PROP_SUITE_VERSION, "")
+      })
+    })
+  }
+
+  fun emitPlayerStateSync() {
+      receiveEvent(EVENT_PLAYER_STATE_SYNC, Arguments.createMap().apply {
+        putMap(EVENT_PROP_STATE, collectPlayerState())
+      })
+  }
+
+  private fun collectPlayerState(): WritableMap {
+    return playerView.player?.let { player ->
       PayloadBuilder()
         .source(player.source)
         .currentTime(player.currentTime)
@@ -312,14 +333,7 @@ class PlayerEventEmitter internal constructor(
         .selectedAudioTrack(getSelectedAudioTrack(player))
         .selectedVideoTrack(getSelectedVideoTrack(player))
         .build()
-    )
-    payload.putMap(EVENT_PROP_VERSION, WritableNativeMap().apply {
-      putString(EVENT_PROP_VERSION, THEOplayerGlobal.getVersion())
-      putString(EVENT_PROP_SUITE_VERSION, "")
-    })
-
-    // Notify the player is ready
-    receiveEvent(EVENT_PLAYER_READY, payload)
+    } ?: Arguments.createMap()
   }
 
   private fun emitError(code: String, message: String?) {

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

@@ -20,12 +20,15 @@ private const val TAG = "ReactTHEOplayerView"
 class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
   FrameLayout(reactContext), LifecycleEventListener {
 
-  private val eventEmitter: PlayerEventEmitter =
+  // Set true to bypass ReactNative lifecycle, avoiding THEOplayerView being disposed by Fabric
+  var bypassDropInstanceOnReactLifecycle = false
+  val eventEmitter: PlayerEventEmitter =
     PlayerEventEmitter(reactContext.reactApplicationContext, this)
   val broadcast = EventBroadcastAdapter(this)
   var presentationManager: PresentationManager? = null
   var playerContext: ReactTHEOplayerContext? = null
-  private var isInitialized: Boolean = false
+  var isInitialized: Boolean = false
+    private set
   private var config: PlayerConfigAdapter? = null
 
   val adsApi: AdsApiWrapper

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

@@ -23,7 +23,9 @@ class ReactTHEOplayerViewManager : ViewGroupManager<ReactTHEOplayerView>() {
    * {@link ViewManager} subclass.
    */
   override fun onDropViewInstance(view: ReactTHEOplayerView) {
-    view.releasePlayer()
+    if (!view.bypassDropInstanceOnReactLifecycle) {
+      view.releasePlayer()
+    }
   }
 
   @ReactProp(name = PROP_CONFIG)

package/android/src/main/java/com/theoplayer/ads/AdAdapter.kt

@@ -56,10 +56,12 @@ object AdAdapter {
   /**
    * Convert a list of native Ads to a ReactNative Ads.
    */
-  fun fromAds(ads: List<Ad>): WritableArray {
+  fun fromAds(ads: List<Ad?>): WritableArray {
     val payload = Arguments.createArray()
     for (ad in ads) {
-      payload.pushMap(fromAd(ad, true))
+      if (ad !== null) {
+        payload.pushMap(fromAd(ad, true))
+      }
     }
     return payload
   }

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

@@ -1,6 +1,7 @@
 package com.theoplayer.audio
 
 import com.facebook.react.bridge.ReadableMap
+import com.theoplayer.util.getBooleanOrNull
 
 object BackgroundAudioConfigAdapter {
   private const val PROP_ENABLED = "enabled"
@@ -10,15 +11,10 @@ object BackgroundAudioConfigAdapter {
   private const val DEFAULT_STOP_ON_BACKGROUND = false
 
   fun fromProps(props: ReadableMap?): BackgroundAudioConfig {
-    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
+      enabled = props?.getBooleanOrNull(PROP_ENABLED) ?: DEFAULT_ENABLED,
+      stopOnBackground = props?.getBooleanOrNull(PROP_STOP_ON_BACKGROUND)
+        ?: DEFAULT_STOP_ON_BACKGROUND,
     )
   }
 }

package/android/src/main/java/com/theoplayer/player/PlayerModule.kt

@@ -1,6 +1,7 @@
 package com.theoplayer.player
 
 import android.os.Build
+import android.util.Log
 import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.module.model.ReactModuleInfo
@@ -18,6 +19,8 @@ import com.theoplayer.audio.BackgroundAudioConfigAdapter
 import com.theoplayer.presentation.PipConfigAdapter
 import com.theoplayer.track.TextTrackStyleAdapter
 import com.theoplayer.util.ViewResolver
+import com.theoplayer.util.findReactRootView
+import com.theoplayer.util.getClosestParentOfType
 
 @Suppress("unused")
 @ReactModule(name = PlayerModule.NAME)
@@ -287,13 +290,11 @@ class PlayerModule(context: ReactApplicationContext) : ReactContextBaseJavaModul
   @ReactMethod(isBlockingSynchronousMethod = true)
   fun getUsableScreenDimensions(): WritableMap {
     // Pass the dimensions of the top-most View in the view hierarchy.
-    val topView = reactApplicationContext.currentActivity?.window?.decorView?.rootView
-    reactApplicationContext.resources.displayMetrics.also {
-      val density = it.density
-      return Arguments.createMap().apply {
-        putDouble("width", (topView?.width ?: 0) / density.toDouble())
-        putDouble("height", (topView?.height ?: 0) / density.toDouble())
-      }
+    val topView = findReactRootView( reactApplicationContext)
+    val density = reactApplicationContext.resources.displayMetrics.density.toDouble()
+    return Arguments.createMap().apply {
+      putDouble("width", (topView?.width ?: 0) / density)
+      putDouble("height", (topView?.height ?: 0) / density)
     }
   }
 }

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

@@ -2,11 +2,11 @@ package com.theoplayer.presentation
 
 import android.util.Log
 import android.view.View
-import android.view.ViewGroup
 import android.view.ViewTreeObserver
-import androidx.core.view.children
+import com.facebook.react.ReactRootView
 import com.facebook.react.views.view.ReactViewGroup
 import com.theoplayer.ReactTHEOplayerView
+import com.theoplayer.util.applyOnViewTree
 
 private const val TAG = "FSLayoutObserver"
 
@@ -20,14 +20,13 @@ class FullScreenLayoutObserver {
   private var globalLayoutListener: ViewTreeObserver.OnGlobalLayoutListener? = null
   private var attached: ReactViewGroup? = null
 
-  fun attach(viewGroup: ReactViewGroup?) {
+  fun attach(viewGroup: ReactViewGroup?, root: ReactRootView) {
     if (attached != null) {
       Log.w(TAG, "A previously attached ViewGroup was not properly detached.")
     }
 
     viewGroup?.let { reactPlayerGroup ->
       globalLayoutListener = ViewTreeObserver.OnGlobalLayoutListener {
-        val root = getRootViewFrom(reactPlayerGroup)
         reactPlayerGroup.post {
           applyOnViewTree(reactPlayerGroup) { view ->
             if (view == reactPlayerGroup || view is ReactTHEOplayerView) {
@@ -51,24 +50,3 @@ class FullScreenLayoutObserver {
     globalLayoutListener = null
   }
 }
-
-/**
- * Find the view root, most likely the decorView
- */
-fun getRootViewFrom(view: View): View {
-  var current = view
-  while (current.parent is View) {
-    current = current.parent as View
-  }
-  return current
-}
-
-/**
- * Conditionally apply an operation on each view in a hierarchy.
- */
-fun applyOnViewTree(view: View, doOp: (View) -> Unit) {
-  doOp(view)
-  if (view is ViewGroup) {
-    view.children.forEach { ch -> applyOnViewTree(ch, doOp) }
-  }
-}

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

@@ -10,13 +10,13 @@ import android.content.pm.PackageManager
 import android.os.Build
 import android.view.View
 import android.view.ViewGroup
-import android.view.ViewParent
 import androidx.activity.ComponentActivity
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.WindowInsetsControllerCompat
 import androidx.core.view.children
 import androidx.lifecycle.Lifecycle
 import com.facebook.react.ReactRootView
+import com.facebook.react.bridge.ReactContext
 import com.facebook.react.uimanager.ThemedReactContext
 import com.facebook.react.views.view.ReactViewGroup
 import com.theoplayer.BuildConfig
@@ -26,11 +26,14 @@ import com.theoplayer.ReactTHEOplayerView
 import com.theoplayer.android.api.error.ErrorCode
 import com.theoplayer.android.api.error.THEOplayerException
 import com.theoplayer.android.api.player.PresentationMode
+import com.theoplayer.util.findReactRootView
+import com.theoplayer.util.getClosestParentOfType
 
 const val IS_TRANSITION_INTO_PIP = "isTransitioningToPip"
 const val IS_IN_PIP_MODE = "isInPictureInPictureMode"
 const val ON_USER_LEAVE_HINT = "onUserLeaveHint"
 const val ON_PIP_MODE_CHANGED = "onPictureInPictureModeChanged"
+const val ON_DID_UPDATE_DIMENSIONS = "_didUpdateDimensions"
 
 @Suppress("KotlinConstantConditions", "SimplifyBooleanWithConstants")
 @SuppressLint("UnspecifiedRegisterReceiverFlag")
@@ -52,6 +55,11 @@ class PresentationManager(
   private val playerGroupRestoreOptions by lazy {
     PlayerGroupRestoreOptions()
   }
+  private val layoutChangeListener = View.OnLayoutChangeListener { _, _, _, _, _, _, _, _, _ ->
+      reactContext
+          .getJSModule(ReactContext.RCTDeviceEventEmitter::class.java)
+          .emit(ON_DID_UPDATE_DIMENSIONS, null)
+  }
   var currentPresentationMode: PresentationMode = PresentationMode.INLINE
     private set
   var currentPresentationModeChangeContext: PresentationModeChangeContext? = null
@@ -71,6 +79,11 @@ class PresentationManager(
         }
       }
     }
+
+    // Emit a private dimension update event when layout changes
+    // This makes sure a dimension update is sent after fullscreen immersive animations complete.
+    rootView?.addOnLayoutChangeListener(layoutChangeListener)
+
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
       supportsPip =
         reactContext.packageManager.hasSystemFeature(PackageManager.FEATURE_PICTURE_IN_PICTURE)
@@ -118,6 +131,7 @@ class PresentationManager(
       }
 
       fullScreenLayoutObserver.remove()
+      rootView?.removeOnLayoutChangeListener(layoutChangeListener)
       pipUtils.destroy()
     } catch (_: Exception) {
     }
@@ -269,12 +283,7 @@ class PresentationManager(
     get() = viewCtx.playerView.getClosestParentOfType()
 
   private val rootView: ReactRootView?
-    get() {
-      val activity = reactContext.currentActivity ?: return null
-      // Try to search in parents and as a fallback option from root to bottom using depth-first order
-      return reactPlayerGroup?.getClosestParentOfType()
-        ?: (activity.window.decorView.rootView as? ViewGroup)?.getClosestParentOfType(false)
-    }
+    get() = findReactRootView( reactContext, reactPlayerGroup)
 
   private fun reparentPlayerToRoot() {
     reactPlayerGroup?.let { playerGroup ->
@@ -283,10 +292,12 @@ class PresentationManager(
 
         // Re-parent the playerViewGroup to the root node
         parent.removeView(playerGroup)
-        rootView?.addView(playerGroup)
+        rootView?.let { root ->
+          root.addView(playerGroup)
 
-        // Attach an observer that overrides the react-native lay-out and forces fullscreen.
-        fullScreenLayoutObserver.attach(playerGroup)
+          // Attach an observer that overrides the react-native lay-out and forces fullscreen.
+          fullScreenLayoutObserver.attach(playerGroup, root)
+        }
       }
     }
   }
@@ -335,35 +346,6 @@ class PresentationManager(
   }
 }
 
-inline fun <reified T : View> ViewGroup.getClosestParentOfType(upward: Boolean = true): T? {
-  if (upward) {
-    // Search in the parent views of `this` view up to the root
-    var parent: ViewParent? = parent
-    while (parent != null && parent !is T) {
-      parent = parent.parent
-    }
-    return parent as? T
-  } else {
-    // Search in the children collection.
-    val viewStack = ArrayDeque(children.toList())
-    // Use Stack/LIFO instead of recursion
-    while (viewStack.isNotEmpty()) {
-      when (val view = viewStack.removeAt(0)) {
-        is T -> {
-          return view
-        }
-
-        is ViewGroup -> {
-          // Filling LIFO with all children of the ViewGroup: depth-first order
-          viewStack.addAll(0, view.children.toList())
-        }
-      }
-    }
-    // Found nothing
-    return null
-  }
-}
-
 private class PlayerGroupRestoreOptions {
   var childIndex: Int? = null
   var parentNode: ViewGroup? = null

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

@@ -68,6 +68,7 @@ private const val PROP_CUSTOM_ASSET_KEY = "customAssetKey"
 private const val PROP_OVERRIDE_LAYOUT = "overrideLayout"
 private const val PROP_NETWORK_CODE = "networkCode"
 private const val PROP_USE_ID3 = "useId3"
+private const val PROP_USE_EMSG = "useEMSG"
 private const val PROP_RETRIEVE_POD_ID_URI = "retrievePodIdURI"
 private const val PROP_INITIALIZATION_DELAY = "initializationDelay"
 private const val PROP_SSE_ENDPOINT = "sseEndpoint"
@@ -360,6 +361,7 @@ class SourceAdapter {
       networkCode = jsonAdDescription.optString(PROP_NETWORK_CODE).takeIf { it.isNotEmpty() },
       overrideLayout = parseOverrideLayout(jsonAdDescription.optString(PROP_OVERRIDE_LAYOUT)),
       useId3 = jsonAdDescription.optBoolean(PROP_USE_ID3, false),
+      useEMSG = jsonAdDescription.optBoolean(PROP_USE_EMSG, false),
       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() },

package/android/src/main/java/com/theoplayer/util/ReadableExtension.kt

@@ -0,0 +1,10 @@
+package com.theoplayer.util
+
+import com.facebook.react.bridge.ReadableMap
+
+/**
+ * Gets a boolean value from the map, or null if the key does not exist.
+ */
+fun ReadableMap.getBooleanOrNull(name: String): Boolean? {
+  return if (hasKey(name)) getBoolean(name) else null
+}

package/android/src/main/java/com/theoplayer/util/ViewUtils.kt

@@ -0,0 +1,67 @@
+package com.theoplayer.util
+
+import android.view.View
+import android.view.ViewGroup
+import android.view.ViewParent
+import androidx.core.view.children
+import com.facebook.react.ReactRootView
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.views.view.ReactViewGroup
+import kotlin.sequences.forEach
+
+/**
+ * Conditionally apply an operation on each view in a hierarchy.
+ */
+fun applyOnViewTree(view: View, doOp: (View) -> Unit) {
+  doOp(view)
+  if (view is ViewGroup) {
+    view.children.forEach { ch -> applyOnViewTree(ch, doOp) }
+  }
+}
+
+/**
+ * Finds the closest ReactRootView either by searching upwards from the given ReactViewGroup
+ * or, if that fails, by searching downwards from the root view of the current activity.
+ */
+fun findReactRootView(reactContext: ReactContext, reactPlayerGroup: ReactViewGroup? = null): ReactRootView? {
+  val activity = reactContext.currentActivity ?: return null
+  // Try to search in parents and as a fallback option from root to bottom using depth-first order
+  return reactPlayerGroup?.getClosestParentOfType()
+    ?: (activity.window.decorView.rootView as? ViewGroup)?.getClosestParentOfType(false)
+}
+
+/**
+ * Finds the closest parent view of the specified type [T].
+ *
+ * @param upward If true, searches upwards in the view hierarchy (towards the root).
+ *                 If false, searches downwards in the view hierarchy (towards the children).
+ * @return The closest parent view of type [T], or null if none is found.
+ */
+inline fun <reified T : View> ViewGroup.getClosestParentOfType(upward: Boolean = true): T? {
+  if (upward) {
+    // Search in the parent views of `this` view up to the root
+    var parent: ViewParent? = parent
+    while (parent != null && parent !is T) {
+      parent = parent.parent
+    }
+    return parent as? T
+  } else {
+    // Search in the children collection.
+    val viewStack = ArrayDeque(children.toList())
+    // Use Stack/LIFO instead of recursion
+    while (viewStack.isNotEmpty()) {
+      when (val view = viewStack.removeAt(0)) {
+        is T -> {
+          return view
+        }
+
+        is ViewGroup -> {
+          // Filling LIFO with all children of the ViewGroup: depth-first order
+          viewStack.addAll(0, view.children.toList())
+        }
+      }
+    }
+    // Found nothing
+    return null
+  }
+}

package/ios/THEOplayerRCTBridge.m

@@ -52,6 +52,7 @@ RCT_EXPORT_VIEW_PROPERTY(onNativeAdEvent, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeTHEOliveEvent, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeTHEOadsEvent, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeCastEvent, RCTDirectEventBlock);
+RCT_EXPORT_VIEW_PROPERTY(onNativePlayerStateSync, RCTDirectEventBlock);
 
 @end
 

package/ios/THEOplayerRCTDebug.swift

@@ -19,7 +19,7 @@ let DEBUG_CONTENT_PROTECTION_API = DEBUG && false
 let DEBUG_VIEW = DEBUG && false
 
 // Debug flag to monitor correct SourceDescription buildup
-let DEBUG_SOURCE_DESCRIPTION_BUIDER = DEBUG && false
+let DEBUG_SOURCE_DESCRIPTION_BUILDER = DEBUG && false
 
 // Debug flag to monitor ads API usage
 let DEBUG_ADS_API = DEBUG && false
@@ -51,5 +51,12 @@ let DEBUG_THEOLIVE_API = DEBUG && false
 // Debug flag to monitor THEOAds API usage
 let DEBUG_THEOADS_API = DEBUG && false
 
-// Debug flag to monitor AudioSession interruptions (e.g. phone cll)
+// Debug flag to monitor AudioSession interruptions (e.g. phone call)
 let DEBUG_INTERRUPTIONS = DEBUG && false
+
+// Debug flag to monitor Presentationmode changes
+let DEBUG_PRESENTATIONMODES = DEBUG && false
+
+// Debug flag to monitor App state changes
+let DEBUG_APPSTATE = DEBUG && false
+

package/ios/THEOplayerRCTMainEventHandler.swift

@@ -7,7 +7,7 @@ public class THEOplayerRCTMainEventHandler {
     // MARK: Members
     private weak var player: THEOplayer?
     private weak var presentationModeContext: THEOplayerRCTPresentationModeContext?
-    private var loadedMetadataAndChapterTracksInfo: [[String:Any]] = []
+    private(set) var loadedMetadataAndChapterTracksInfo: [[String:Any]] = []
         
     // MARK: Events
     var onNativePlay: RCTDirectEventBlock?
@@ -274,9 +274,9 @@ public class THEOplayerRCTMainEventHandler {
         self.loadedMetadataListener = player.addEventListener(type: PlayerEventTypes.LOADED_META_DATA) { [weak self, weak player] event in
             if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received LOADED_META_DATA event from THEOplayer") }
             if let wplayer = player,
-               let welf = self,
-               let forwardedLoadedMetadataEvent = self?.onNativeLoadedMetadata {
-              let metadata = THEOplayerRCTTrackMetadataAggregator.aggregateTrackMetadata(player: wplayer, metadataTracksInfo: welf.loadedMetadataAndChapterTracksInfo)
+               let self,
+               let forwardedLoadedMetadataEvent = self.onNativeLoadedMetadata {
+              let metadata = THEOplayerRCTTrackMetadataAggregator.aggregateTrackInfo(player: wplayer, metadataTracksInfo: self.loadedMetadataAndChapterTracksInfo)
                 forwardedLoadedMetadataEvent(metadata)
             }
         }