react-native-theoplayer 8.11.1 → 8.13.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ 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).
 
+## [8.13.0] - 25-01-15
+
+### Added
+
+- Added support for New Architecture's through the Interop Layer. More info on the [React Native developer pages](https://reactnative.dev/architecture/landing-page).
+
+### Fixed
+
+- Fixed an issue on Web where picture-in-picture presentation mode would sometimes fail.
+
+### Changed
+
+- Upgraded the example app to use react-native-tvos@0.76.5-0.
+
+## [8.12.0] - 25-01-09
+
+### Fixed
+
+- Fixed a memory leak on iOS, where the presentationModeManager was holding a strong reference to the fullscreen's target and return views
+- Fixed an issue on iOS where the destruction of the THEOplayerView was not always propagated correctly over the iOS Bridge, resulting in an occasional memory leak.
+- Fixed an issue where, when requesting a text track's cues, the time properties would sometimes be in seconds instead of milliseconds.
+- Fixed a rare crash on Android due to a `java.lang.NullPointerException` when creating the THEOplayerView.
+- Fixed an issue on Android where R8 minification would obfuscate some API class names, which could lead to a crash.
+
+### Added
+
+- Added a `adLoadTimeout` property to `GoogleImaConfiguration` to control the amount of time that the SDK will wait before moving onto the next ad or main content.
+
 ## [8.11.1] - 24-12-18
 
 ### Fixed

package/android/build.gradle

@@ -25,6 +25,14 @@ static def versionString(version) {
   return "${version == '+' ? 'latest' : version}"
 }
 
+def isNewArchitectureEnabled() {
+  // To opt-in for the New Architecture, you can either:
+  // - Set `newArchEnabled` to true inside the `gradle.properties` file
+  // - Invoke gradle with `-newArchEnabled=true`
+  // - Set an environment variable `ORG_GRADLE_PROJECT_newArchEnabled=true`
+  return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
 // Extensions
 def enabledGoogleIMA = safeExtGet("THEOplayer_extensionGoogleIMA", 'false').toBoolean()
 def enabledGoogleDAI = safeExtGet("THEOplayer_extensionGoogleDAI", 'false').toBoolean()
@@ -69,6 +77,8 @@ android {
     buildConfigField "boolean", "EXTENSION_MEDIASESSION", "${enabledMediaSession}"
     buildConfigField "boolean", "EXTENSION_MEDIA3", "${enabledMedia3}"
 
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+
     consumerProguardFiles 'proguard-rules.pro'
   }
 

package/android/proguard-rules.pro

@@ -1,3 +1,7 @@
 # Do no warn if any of the API classes we resolve with compileOnly are missing because the feature
 # is disabled: it is expected.
 -dontwarn com.theoplayer.android.api.**
+-dontwarn com.google.android.gms.cast.**
+
+# We rely on gson to instantiate some source classes from json, so make sure they are not obfuscated.
+-keep,includedescriptorclasses class com.theoplayer.android.api.source.** { *; }

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

@@ -28,6 +28,7 @@ private const val PROP_RETRY_MAX_BACKOFF = "maximumBackoff"
 private const val PROP_CAST_CONFIGURATION = "cast"
 private const val PROP_ADS_CONFIGURATION = "ads"
 private const val PROP_IMA_CONFIGURATION = "ima"
+private const val PROP_IMA_AD_LOAD_TIMEOUT = "adLoadTimeout"
 private const val PROP_MEDIA_CONTROL = "mediaControl"
 private const val PROP_PPID = "ppid"
 private const val PROP_MAX_REDIRECTS = "maxRedirects"
@@ -169,11 +170,17 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
           }
         }
       }
-      // bitrate is configured under the ima config
+      // bitrate and timeout are configured under the ima config
       configProps?.getMap(PROP_ADS_CONFIGURATION)?.getMap(PROP_IMA_CONFIGURATION)?.run {
         if (hasKey(PROP_BITRATE)) {
           bitrateKbps = getInt(PROP_BITRATE)
         }
+
+        // The time needs to be in milliseconds on android but seconds on ios.
+        // we unify the prop from javascript by multiplying it by 1000 here
+        if (hasKey(PROP_IMA_AD_LOAD_TIMEOUT)) {
+          setLoadVideoTimeout(getInt(PROP_IMA_AD_LOAD_TIMEOUT) * 1000)
+        }
       }
     }
   }

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

@@ -8,7 +8,7 @@ import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.bridge.WritableNativeMap
 import com.facebook.react.uimanager.UIManagerHelper
-import com.facebook.react.uimanager.common.ViewUtil
+import com.facebook.react.uimanager.common.UIManagerType
 import com.theoplayer.ads.AdEventAdapter
 import com.theoplayer.ads.AdEventAdapter.AdEventEmitter
 import com.theoplayer.android.api.THEOplayerGlobal
@@ -47,7 +47,6 @@ import com.theoplayer.track.*
 import com.theoplayer.util.PayloadBuilder
 import kotlin.math.floor
 
-
 private val TAG = PlayerEventEmitter::class.java.name
 
 private const val EVENT_PLAYER_READY = "onNativePlayerReady"
@@ -613,8 +612,13 @@ class PlayerEventEmitter internal constructor(
       } catch (ignore: RuntimeException) {
       }
     }
-    val uiManager = UIManagerHelper.getUIManager(reactContext, ViewUtil.getUIManagerType(viewId))
-    uiManager?.receiveEvent(UIManagerHelper.getSurfaceId(reactContext), viewId, type, event)
+    UIManagerHelper.getUIManager(
+      reactContext,
+      if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
+        UIManagerType.FABRIC
+      } else {
+        UIManagerType.DEFAULT
+      })?.receiveEvent(UIManagerHelper.getSurfaceId(playerView), viewId, type, event)
   }
 
   private fun attachListeners(player: Player) {

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

@@ -205,7 +205,7 @@ class ReactTHEOplayerContext private constructor(
   }
 
   private fun initializePlayerView() {
-    playerView = object : THEOplayerView(reactContext.currentActivity!!, configAdapter.playerConfig()) {
+    playerView = object : THEOplayerView(reactContext, configAdapter.playerConfig()) {
       private fun measureAndLayout() {
         measure(
           MeasureSpec.makeMeasureSpec(measuredWidth, MeasureSpec.EXACTLY),

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

@@ -26,6 +26,7 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
   var presentationManager: PresentationManager? = null
   var playerContext: ReactTHEOplayerContext? = null
   private var isInitialized: Boolean = false
+  private var config: PlayerConfigAdapter? = null
 
   val adsApi: AdsApiWrapper
 
@@ -40,7 +41,7 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
     adsApi = AdsApiWrapper()
   }
 
-  fun initialize(configProps: ReadableMap?) {
+  fun initialize(config: PlayerConfigAdapter) {
     if (BuildConfig.LOG_VIEW_EVENTS) {
       Log.d(TAG, "Initialize view")
     }
@@ -48,10 +49,15 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
       Log.w(TAG, "Already initialized view")
       return
     }
+    this.config = config
+    if (!isAttachedToWindow) {
+      // The view is not attached to the window yet, postpone the initialization.
+      return
+    }
     isInitialized = true
     playerContext = ReactTHEOplayerContext.create(
       reactContext,
-      PlayerConfigAdapter(configProps)
+      config
     )
     playerContext?.apply {
       adsApi.initialize(player, imaIntegration, daiIntegration)
@@ -59,17 +65,22 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
       playerView.layoutParams = layoutParams
       (playerView.parent as? ViewGroup)?.removeView(playerView)
       addView(playerView, 0, layoutParams)
-
       presentationManager = PresentationManager(
         this,
         reactContext,
         eventEmitter
       )
-
       eventEmitter.preparePlayer(player)
     }
   }
 
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    if (!isInitialized) {
+      config?.let { initialize(it) }
+    }
+  }
+
   override fun setId(id: Int) {
     super.setId(id)
     eventEmitter.setViewId(id)

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

@@ -31,7 +31,7 @@ class ReactTHEOplayerViewManager : ViewGroupManager<ReactTHEOplayerView>() {
 
   @ReactProp(name = PROP_CONFIG)
   fun setConfig(videoView: ReactTHEOplayerView, config: ReadableMap?) {
-    videoView.initialize(config)
+    videoView.initialize(PlayerConfigAdapter(config))
   }
 
   override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> {

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

@@ -16,6 +16,7 @@ import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.WindowInsetsControllerCompat
 import androidx.lifecycle.Lifecycle
 import com.facebook.react.ReactRootView
+import com.facebook.react.runtime.ReactSurfaceView
 import com.facebook.react.uimanager.ThemedReactContext
 import com.facebook.react.views.view.ReactViewGroup
 import com.theoplayer.BuildConfig
@@ -211,7 +212,7 @@ class PresentationManager(
     // Get the player's ReactViewGroup parent, which contains THEOplayerView and its children (typically the UI).
     val reactPlayerGroup: ReactViewGroup? = getClosestParentOfType(this.viewCtx.playerView)
 
-    // Get ReactNative's root node or the render hiearchy
+    // Get ReactNative's root node or the render hierarchy
     val root: ReactRootView? = getClosestParentOfType(reactPlayerGroup)
 
     if (fullscreen) {
@@ -223,7 +224,11 @@ class PresentationManager(
       if (!BuildConfig.REPARENT_ON_FULLSCREEN) {
         return
       }
-      playerGroupParentNode = (reactPlayerGroup?.parent as ReactViewGroup?)?.also { parent ->
+      playerGroupParentNode = if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
+        reactPlayerGroup?.parent as? ReactSurfaceView?
+      } else {
+        reactPlayerGroup?.parent as? ReactViewGroup?
+      }?.also { parent ->
         playerGroupChildIndex = parent.indexOfChild(reactPlayerGroup)
         // Re-parent the playerViewGroup to the root node
         parent.removeView(reactPlayerGroup)

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

@@ -3,31 +3,28 @@ package com.theoplayer.util
 import android.util.Log
 import android.view.View
 import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.uimanager.UIManagerModule
+import com.facebook.react.uimanager.UIManagerHelper
 
 private const val TAG = "ViewResolver"
 private const val INVALID_TAG = -1
 
 @Suppress("UNCHECKED_CAST")
 class ViewResolver(private val reactContext: ReactApplicationContext) {
-  private var uiManager: UIManagerModule? = null
-
   fun <T: View> resolveViewByTag(tag: Int, onResolved: (view: T?) -> Unit) {
     if (tag == INVALID_TAG) {
       // Don't bother trying to resolve an invalid tag.
       onResolved(null)
     }
-    if (uiManager == null) {
-      uiManager = reactContext.getNativeModule(UIManagerModule::class.java)
-    }
-    uiManager?.addUIBlock {
-      try {
-        onResolved(it.resolveView(tag) as? T?)
-      } catch (e: Exception) {
-        // The View instance could not be resolved: log but do not forward exception.
-        Log.e(TAG, "Failed to resolve View tag $tag: $e")
-        onResolved(null)
+    try {
+      reactContext.runOnUiQueueThread {
+        UIManagerHelper.getUIManagerForReactTag(reactContext, tag)?.let {
+          onResolved(it.resolveView(tag) as? T?)
+        }
       }
+    } catch (e: Exception) {
+      // The ReactTHEOplayerView instance could not be resolved: log but do not forward exception.
+      Log.e(TAG, "Failed to resolve ReactTHEOplayerView tag $tag: $e")
+      onResolved(null)
     }
   }
 }

package/ios/THEOplayerRCTBridge.m

@@ -112,8 +112,6 @@ RCT_EXTERN_METHOD(setPreload:(nonnull NSNumber *)node
 RCT_EXTERN_METHOD(setTextTrackStyle:(nonnull NSNumber *)node
                   textTrackStyle:(NSDictionary)textTrackStyle)
 
-RCT_EXTERN_METHOD(destroyPlayer:(nonnull NSNumber *)node);
-
 @end
 
 // ----------------------------------------------------------------------------

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -356,14 +356,4 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
             }
         }
     }
-  
-    @objc(destroyPlayer:)
-    func destroyPlayer(_ node: NSNumber) -> Void {
-        DispatchQueue.main.async {
-            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView {
-                theView.destroyPlayer()
-            }
-        }
-    }
-
 }

package/ios/THEOplayerRCTView.swift

@@ -9,15 +9,16 @@ public class THEOplayerRCTView: UIView {
     public private(set) var player: THEOplayer?
     public private(set) var mainEventHandler: THEOplayerRCTMainEventHandler
     public private(set) var broadcastEventHandler: THEOplayerRCTBroadcastEventHandler
-    let theoPlayerViewController = UIViewController()
     var textTrackEventHandler: THEOplayerRCTTextTrackEventHandler
     var mediaTrackEventHandler: THEOplayerRCTMediaTrackEventHandler
     var metadataTrackEventHandler: THEOplayerRCTSideloadedMetadataTrackEventHandler
     var adEventHandler: THEOplayerRCTAdsEventHandler
     var castEventHandler: THEOplayerRCTCastEventHandler
     var presentationModeManager: THEOplayerRCTPresentationModeManager
+    var backgroundAudioManager: THEOplayerRCTBackgroundAudioManager
     var nowPlayingManager: THEOplayerRCTNowPlayingManager
     var remoteCommandsManager: THEOplayerRCTRemoteCommandsManager
+    var pipManager: THEOplayerRCTPipManager
     var pipControlsManager: THEOplayerRCTPipControlsManager
     
     var adsConfig = AdsConfig()
@@ -36,8 +37,8 @@ public class THEOplayerRCTView: UIView {
     }
     var backgroundAudioConfig = BackgroundAudioConfig() {
           didSet {
-              self.updateInterruptionNotifications()
-              self.updateAVAudioSessionMode()
+              self.backgroundAudioManager.updateInterruptionNotifications()
+              self.backgroundAudioManager.updateAVAudioSessionMode()
           }
       }
 
@@ -61,8 +62,10 @@ public class THEOplayerRCTView: UIView {
         self.adEventHandler = THEOplayerRCTAdsEventHandler()
         self.castEventHandler = THEOplayerRCTCastEventHandler()
         self.presentationModeManager = THEOplayerRCTPresentationModeManager()
+        self.backgroundAudioManager = THEOplayerRCTBackgroundAudioManager()
         self.nowPlayingManager = THEOplayerRCTNowPlayingManager()
         self.remoteCommandsManager = THEOplayerRCTRemoteCommandsManager()
+        self.pipManager = THEOplayerRCTPipManager()
         self.pipControlsManager = THEOplayerRCTPipControlsManager()
         
         super.init(frame: .zero)
@@ -71,20 +74,32 @@ public class THEOplayerRCTView: UIView {
     required init?(coder aDecoder: NSCoder) {
         fatalError("[NATIVE] init(coder:) has not been implemented")
     }
+  
+    deinit {
+        self.mainEventHandler.destroy()
+        self.textTrackEventHandler.destroy()
+        self.mediaTrackEventHandler.destroy()
+        self.adEventHandler.destroy()
+        self.castEventHandler.destroy()
+        self.nowPlayingManager.destroy()
+        self.remoteCommandsManager.destroy()
+        self.pipManager.destroy()
+        self.pipControlsManager.destroy()
+        self.presentationModeManager.destroy()
+        self.backgroundAudioManager.destroy()
+      
+        self.destroyBackgroundAudio()
+        self.player?.removeAllIntegrations()
+        self.player?.destroy()
+        self.player = nil
+        if DEBUG_THEOPLAYER_INTERACTION { PrintUtils.printLog(logText: "[NATIVE] THEOplayer instance destroyed.") }
+    }
     
     override public func layoutSubviews() {
         super.layoutSubviews()
         if let player = self.player {
             player.frame = self.frame
             player.autoresizingMask = [.flexibleBottomMargin, .flexibleHeight, .flexibleLeftMargin, .flexibleRightMargin, .flexibleTopMargin, .flexibleWidth]
-          
-            // wrap theoPlayerViewController around the view
-            if theoPlayerViewController.parent == nil,
-               let parentViewController = self.findViewController() {
-                parentViewController.addChild(self.theoPlayerViewController)
-                self.theoPlayerViewController.didMove(toParent: parentViewController)
-                self.theoPlayerViewController.view = self
-            }
         }
     }
     
@@ -97,12 +112,14 @@ public class THEOplayerRCTView: UIView {
             self.mainEventHandler.setPlayer(player)
             self.textTrackEventHandler.setPlayer(player)
             self.mediaTrackEventHandler.setPlayer(player)
-            self.presentationModeManager.setPlayer(player, view: self)
             self.adEventHandler.setPlayer(player)
             self.castEventHandler.setPlayer(player)
             self.nowPlayingManager.setPlayer(player)
             self.remoteCommandsManager.setPlayer(player)
             self.pipControlsManager.setPlayer(player)
+            self.presentationModeManager.setPlayer(player, view: self)
+            self.backgroundAudioManager.setPlayer(player, view: self)
+            self.pipManager.setView(view: self)
             // Attach player to view
             player.addAsSubview(of: self)
         }
@@ -137,28 +154,6 @@ public class THEOplayerRCTView: UIView {
         return self.player
     }
     
-    // MARK: - Destroy Player
-    
-    public func destroyPlayer() {
-        self.mainEventHandler.destroy()
-        self.textTrackEventHandler.destroy()
-        self.mediaTrackEventHandler.destroy()
-        self.adEventHandler.destroy()
-        self.castEventHandler.destroy()
-        self.nowPlayingManager.destroy()
-        self.remoteCommandsManager.destroy()
-        self.pipControlsManager.destroy()
-        
-        self.destroyBackgroundAudio()
-        self.player?.removeAllIntegrations()
-        self.player?.destroy()
-        self.player = nil
-        if DEBUG_THEOPLAYER_INTERACTION { PrintUtils.printLog(logText: "[NATIVE] THEOplayer instance destroyed.") }
-      
-        self.theoPlayerViewController.view = nil
-        self.theoPlayerViewController.removeFromParent()
-    }
-    
     func processMetadataTracks(metadataTrackDescriptions: [TextTrackDescription]?) {
         THEOplayerRCTSideloadedMetadataProcessor.loadTrackInfoFromTrackDescriptions(metadataTrackDescriptions) { tracksInfo in
             self.mainEventHandler.setLoadedMetadataTracksInfo(tracksInfo)

package/ios/THEOplayerRCTViewManager.swift

@@ -16,13 +16,4 @@ class THEOplayerRCTViewManager: RCTViewManager {
     override class func requiresMainQueueSetup() -> Bool {
         return true
     }
-    
-    @objc func destroy(_ node: NSNumber) {
-        DispatchQueue.main.async {
-            let theView = self.bridge.uiManager.view(
-                forReactTag: node
-            ) as! THEOplayerRCTView
-            theView.destroyPlayer()
-        }
-    }
 }

package/ios/ads/THEOplayerRCTAdsAPI+DAI.swift

@@ -79,6 +79,11 @@ extension THEOplayerRCTAdsAPI {
         resolve(false)
     }
     
+    @objc(daiSetSnapback:enabled:)
+    func daiSetSnapback(_ node: NSNumber, enabled: Bool) -> Void {
+        if DEBUG_ADS_API { print(ERROR_MESSAGE_ADS_UNSUPPORTED_FEATURE) }
+    }
+    
     @objc(daiContentTimeForStreamTime:time:resolver:rejecter:)
     func daiContentTimeForStreamTime(_ node: NSNumber, timeValue: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
         if DEBUG_ADS_API { print(ERROR_MESSAGE_ADS_UNSUPPORTED_FEATURE) }

package/ios/ads/THEOplayerRCTView+Ads.swift

@@ -57,6 +57,10 @@ extension THEOplayerRCTView {
             imaRenderSettings.mimeTypes = allowedMimeTypes
         }
         
+        if let adLoadTimeout = self.adsConfig.adsImaConfig.adLoadTimeout {
+            imaRenderSettings.loadVideoTimeout = adLoadTimeout
+        }
+        
         // setup integration
         let imaIntegration = GoogleIMAIntegrationFactory.createIntegration(on: player, with: imaSettings)
         imaIntegration.renderingSettings = imaRenderSettings

package/ios/ads/THEOplayerRCTView+AdsConfig.swift

@@ -21,14 +21,16 @@ struct AdsImaConfig {
     var autoPlayAdBreaks: Bool?
     var sessionID: String?
     var bitrate: Int
+    var adLoadTimeout: TimeInterval?
     
-    init(maxRedirects: UInt, enableDebugMode: Bool, ppid: String? = nil, featureFlags: [String : String]? = nil, autoPlayAdBreaks: Bool? = nil, sessionID: String? = nil, bitrate: Int? = -1) {
+    init(maxRedirects: UInt, enableDebugMode: Bool, ppid: String? = nil, featureFlags: [String : String]? = nil, autoPlayAdBreaks: Bool? = nil, sessionID: String? = nil, bitrate: Int? = -1, adLoadTimeout: TimeInterval? = nil) {
         self.maxRedirects = maxRedirects
         self.enableDebugMode = enableDebugMode
         self.ppid = ppid
         self.featureFlags = featureFlags
         self.autoPlayAdBreaks = autoPlayAdBreaks
         self.sessionID = sessionID
+        self.adLoadTimeout = adLoadTimeout
 #if canImport(THEOplayerGoogleIMAIntegration)
         self.bitrate = bitrate ?? kIMAAutodetectBitrate
 #else
@@ -67,6 +69,9 @@ extension THEOplayerRCTView {
                 if let bitrate = adsImaConfig["bitrate"] as? Int {
                     self.adsConfig.adsImaConfig.bitrate = bitrate
                 }
+                if let adLoadTimeout = adsImaConfig["adLoadTimeout"] as? TimeInterval {
+                    self.adsConfig.adsImaConfig.adLoadTimeout = adLoadTimeout
+                }
             }
         }
     }

package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift

@@ -0,0 +1,105 @@
+// TTHEOplayerRCTBackgroundAudioManager.swift
+
+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
+        self.view = view
+    }
+    
+    // MARK: - destruction
+    func destroy() {
+        self.cancelInterruptionNotifications()
+    }
+  
+    // MARK: - logic
+    func shouldContinueAudioPlaybackInBackground() -> Bool {
+        if let view = self.view {
+            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,
+                                                   selector: #selector(handleInterruption),
+                                                   name: AVAudioSession.interruptionNotification,
+                                                   object: AVAudioSession.sharedInstance())
+        } else {
+            NotificationCenter.default.removeObserver(self,
+                                                      name: AVAudioSession.interruptionNotification,
+                                                      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)
+            if view.backgroundAudioConfig.audioSessionMode != .moviePlayback {
+                if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] AVAudioSession mode updated to \(view.backgroundAudioConfig.audioSessionMode.rawValue)") }
+            }
+        } catch {
+            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:
+            // An interruption began. Update the UI as necessary.
+            if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] An interruption began")}
+        case .ended:
+            // An interruption ended. Resume playback, if appropriate.
+            if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] An interruption ended")}
+            guard let optionsValue = userInfo[AVAudioSessionInterruptionOptionKey] as? UInt else { return }
+            let options = AVAudioSession.InterruptionOptions(rawValue: optionsValue)
+            if options.contains(.shouldResume) {
+                // An interruption ended. Resume playback.
+                if let player = self.player {
+                    if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] Ended interruption should resume playback => play()")}
+                    player.play()
+                }
+            } else {
+                // An interruption ended. Don't resume playback.
+                if DEBUG_INTERRUPTIONS { PrintUtils.printLog(logText: "[NATIVE] Ended interruption should not resume playback.")}
+            }
+        default: ()
+        }
+    }
+}