react-native-theoplayer 3.10.2 → 7.0.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ 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).
 
+## [7.0.0] - 24-04-10
+
+### Fixed
+
+- Fixed an issue where the player had the wrong layout in fullscreen presentationMode, after changing the source.
+- Fixed an issue where not enabling autoplay would explicitly pause the stream, reverting a possible play() request right after setting up the source.
+
+### Added
+
+- Added support for THEOplayer native SDK 7.0.
+- Aligned SDK major version with native player SDKs.
+
+### Changed
+
+- Raise minimal ios deployment target to 13.4, to match react native 0.73's minimal deployment target
+
+## [3.10.3] - 24-03-22
+
+### Fixed
+
+- Fixed a crash on iOS when playing an IMA Ad after reparenting the THEOplayerView to a different native Viewcontroller.
+
 ## [3.10.2] - 24-03-22
 
 ### Changed
@@ -190,7 +212,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Changed
 
-- Added support for THEOplayer 6.0. See [THEOplayer's changelog](https://docs.theoplayer.com/changelog.md) for details.
+- Added support for THEOplayer 6.0. See [THEOplayer's changelog](https://www.theoplayer.com/docs/theoplayer/changelog/) for details.
 - Bumped minimal version for SideloadedTextTracks connection on iOS to v6.1.1 which contains fix for iOS 17.0.
 
 ### Added
@@ -486,7 +508,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Added
 
-- Added `onPlayerReady` callback on `THEOplayerView` to pass a `THEOplayer` instance once it is ready for access. More info on the [migration documentation](./doc/migrating_v2.md) page.
+- Added `onPlayerReady` callback on `THEOplayerView` to pass a `THEOplayer` instance once it is ready for access. More info on the [migration documentation](./doc/migrating-v2.md) page.
 - Added `canplay` event, which is dispatched when the player can start play-out.
 - Added `waiting` event, which is dispatched when the player has stopped play-out because of a temporary lack of data.
 - Added `nativeHandle` property on `THEOplayer` to access the native player instance on web, and view id on mobile.
@@ -507,8 +529,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Changed
 
-- Moved all player properties such as `paused`, `muted` and `volume`, from `THEOplayerView` component to `THEOplayer` instance. More info on the [migration documentation](./doc/migrating_v2.md) page.
-- Removed `onEventName` callback methods from `THEOplayerView` component in favor of `THEOplayer` event listener's interface. More info on the [migration documentation](./doc/migrating_v2.md) page.
+- Moved all player properties such as `paused`, `muted` and `volume`, from `THEOplayerView` component to `THEOplayer` instance. More info on the [migration documentation](./doc/migrating-v2.md) page.
+- Removed `onEventName` callback methods from `THEOplayerView` component in favor of `THEOplayer` event listener's interface. More info on the [migration documentation](./doc/migrating-v2.md) page.
 - Changed documentation sample code to reflect API changes.
 - Exposed the `activeQuality` of a `MediaTrack` as a `Quality` instance instead of the quality's `uid`.
 - Set the default container style for web to let the player cover the whole container.

package/README.md

@@ -32,6 +32,7 @@ It also gives a description of the properties of the `THEOplayerView` component,
 a list of features and known limitations.
 
 ## Prerequisites
+
 For each platform, a dependency to the corresponding THEOplayer SDK is included through a dependency manager:
 
 - Gradle & Maven for Android
@@ -39,8 +40,7 @@ For each platform, a dependency to the corresponding THEOplayer SDK is included
 - npm for Web
 
 In order to use one of these THEOplayer SDKs, it is necessary to obtain a valid THEOplayer license for that specific platform,
-i.e. HTML5, Android, and/or iOS. You can use your existing THEOplayer SDK license or request a
-[free trial account](https://www.theoplayer.com/free-trial-theoplayer?hsLang=en-us).
+i.e. HTML5, Android, and/or iOS. You can sign up for a THEOplayer SDK license through [our portal](https://portal.theoplayer.com/).
 
 If you have no previous experience in React Native, we encourage you to first explore the
 [React Native Documentation](https://reactnative.dev/docs/getting-started),
@@ -59,7 +59,72 @@ Depending on the platform on which the application is deployed, a different set
 If a feature missing, additional help is needed, or you need to extend the package,
 please reach out to us for support.
 
-<img src="./doc/features.svg">
+<table>
+<thead>
+<tr>
+<th>Feature</th>
+<th>Android, Android TV, Fire TV</th>
+<th>Web</th>
+<th>iOS, tvOS</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Streaming</strong></td>
+<td colspan="2">MPEG-DASH (fmp4, CMAF), HLS (TS, CMAF), Progressive MP4, MP3</td>
+<td>HLS (TS, CMAF), Progressive MP4, MP3</td>
+</tr>
+<tr>
+<td><strong>Content Protection</strong></td>
+<td>Widevine</td>
+<td>Widevine, PlayReady, Fairplay</td>
+<td>Fairplay</td>
+</tr>
+<tr>
+<td><strong>DRM Connectors</strong></td>
+<td colspan="3">BuyDRM, EZDRM, Anvato, Titanium, Axinom, Irdeto, VuDRM, Comcast, Verimatrix, Azure, …</td>
+</tr>
+<tr>
+<td><strong>Analytics Connectors</strong></td>
+<td colspan="3">Adobe, Agama, Comscore, Conviva, Mux, Nielsen, Youbora</td>
+</tr>
+<tr>
+<td><strong>Subtitles &amp; Closed Captions</strong></td>
+<td colspan="3">CEA-608/708, SRT, TTML, WebVTT</td>
+</tr>
+<tr>
+<td><strong>Metadata</strong></td>
+<td colspan="3">Event stream, emsg, ID3, EXT-X-DATERANGE, EXT-X-PROGRAM-DATE-TIME</td>
+</tr>
+<tr>
+<td><strong>Advertising Integration</strong></td>
+<td colspan="3">Google IMA, Google DAI</td>
+</tr>
+<tr>
+<td><strong>Cast Integration</strong></td>
+<td>Chromecast</td>
+<td colspan="2">Chromecast, Airplay</td>
+</tr>
+<tr>
+<td><strong>Presentation Mode</strong></td>
+<td colspan="3">Inline, Picture-in-Picture, Fullscreen</td>
+</tr>
+<tr>
+<td><strong>Audio Control Management</strong></td>
+<td>Audio focus &amp; Audio-Becoming-Noisy mgmt</td>
+<td colspan="2">(Audio control management by platform)</td>
+</tr>
+<tr>
+<td><strong>Advanced APIs</strong></td>
+<td colspan="2">Background playback,<br/>Media Session,<br/>Media Cache (offline playback)</td>
+<td>Background playback,<br/>NowPlaying,<br/>Media Cache (iOS only)</td>
+</tr>
+<tr>
+<td><strong>User Interface</strong><br/><code>@theoplayer/react-native-ui</code></td>
+<td colspan="3">Basic playback, media &amp; text track selection, progress bar, live &amp; vod, preview thumbnails, customisable &amp; extensible</td>
+</tr>
+</tbody>
+</table>
 
 ## Available connectors
 
@@ -67,7 +132,7 @@ The `react-native-theoplayer` package can be combined with any number of connect
 functionality. Currently, the following connectors are available:
 
 | Package name                                                                                                              | Purpose                                                  | Registry                                                                                                                                                      |
-|---------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [`@theoplayer/react-native-analytics-adobe`](https://github.com/THEOplayer/react-native-theoplayer-analytics)             | Adobe analytics connector                                | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-adobe)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-adobe)       |
 | [`@theoplayer/react-native-analytics-agama`](https://github.com/THEOplayer/react-native-theoplayer-analytics)             | Agama analytics connector                                | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-agama)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-agama)       |
 | [`@theoplayer/react-native-analytics-comscore`](https://github.com/THEOplayer/react-native-theoplayer-analytics)          | Comscore analytics connector                             | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-analytics-comscore)](https://www.npmjs.com/package/@theoplayer/react-native-analytics-comscore) |
@@ -79,31 +144,40 @@ functionality. Currently, the following connectors are available:
 | [`@theoplayer/react-native-ui`](https://github.com/THEOplayer/react-native-theoplayer-ui)                                 | React Native user interface                              | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-ui)](https://www.npmjs.com/package/@theoplayer/react-native-ui)                                 |
 | [`@theoplayer/react-native-connector-template`](https://github.com/THEOplayer/react-native-theoplayer-connector-template) | A template for<br/>`react-native-theoplayer` connectors. | [![npm](https://img.shields.io/npm/v/@theoplayer/react-native-connector-template)](https://www.npmjs.com/package/@theoplayer/react-native-connector-template) |
 
-## Getting Started
+## Creating your first app
 
 This section starts with creating a minimal demo app that integrates the `react-native-theoplayer` package,
 followed by an overview of the available properties and functionality of the THEOplayerView component.
 An example application including a basic user interface and demo sources is included in the
-[git repository](https://github.com/THEOplayer/react-native-theoplayer/tree/master/example),
-and discussed in the next section. Finally, an overview of features, limitations and known issues is listed.
+[git repository](https://github.com/THEOplayer/react-native-theoplayer/tree/develop/example),
+and discussed in the next section.
 
 - [Creating a minimal demo app](./doc/creating-minimal-app.md)
-    - [Getting started on Android](./doc/creating-minimal-app.md#getting-started-on-android)
-    - [Getting started on iOS](./doc/creating-minimal-app.md#getting-started-on-ios-and-tvos)
-    - [Getting started on Web](./doc/creating-minimal-app.md#getting-started-on-web)
+  - [Getting started on Android](./doc/creating-minimal-app.md#getting-started-on-android)
+  - [Getting started on iOS](./doc/creating-minimal-app.md#getting-started-on-ios-and-tvos)
+  - [Getting started on Web](./doc/creating-minimal-app.md#getting-started-on-web)
 - [The THEOplayerView component](./doc/theoplayerview-component.md)
 - [The example application](./doc/example-app.md)
-- Knowledge Base
-  - [Adaptive Bitrate (ABR)](./doc/abr.md)
-  - [Advertisements](./doc/ads.md)
-  - [Audio Control Management](./doc/audio-control.md)
-  - [Background playback and notifications](./doc/background.md)
-  - [Casting with Chromecast and Airplay](./doc/cast.md)
-  - [Custom iOS framework](./doc/custom-ios-framework.md)
-  - [Digital Rights Management (DRM)](./doc/drm.md)
-  - [Fullscreen presentation](./doc/fullscreen.md)
-  - [Media Caching](./doc/media_caching.md)
-  - [Migrating to `react-native-theoplayer` v2.x](./doc/migrating_v2.md)
-  - [Picture-in-Picture (PiP)](./doc/pip.md)
-  - [Subtitles, Closed Captions and Metadata tracks](./doc/texttracks.md)
-  - [Limitations and known issues](./doc/limitations.md)
+
+## Knowledge Base
+
+This section gives an overview of features, limitations and known issues:
+
+- [Adaptive Bitrate (ABR)](./doc/abr.md)
+- [Advertisements](./doc/ads.md)
+- [Audio Control Management](./doc/audio-control.md)
+- [Background playback and notifications](./doc/background.md)
+- [Casting with Chromecast and Airplay](./doc/cast.md)
+- [Custom iOS framework](./doc/custom-ios-framework.md)
+- [Digital Rights Management (DRM)](./doc/drm.md)
+- [Fullscreen presentation](./doc/fullscreen.md)
+- [Media Caching](./doc/media-caching.md)
+- [Migrating to `react-native-theoplayer` v2.x](./doc/migrating-v2.md)
+- [Picture-in-Picture (PiP)](./doc/pip.md)
+- [Subtitles, Closed Captions and Metadata tracks](./doc/texttracks.md)
+- [Limitations and known issues](./doc/limitations.md)
+
+## API Reference
+
+See the [API Reference](https://theoplayer.github.io/react-native-theoplayer/api/) for detailed documentation
+about all available components and functions.

package/android/build.gradle

@@ -112,12 +112,11 @@ dependencies {
   implementation "androidx.appcompat:appcompat:${safeExtGet('appcompatVersion', '1.6.1')}"
   implementation "androidx.core:core-ktx:${safeExtGet('corektxVersion', '1.10.1')}"
 
-  // The minimum supported THEOplayer version is 6.0.0
-  def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[6.0.0,7.0)')
+  // The minimum supported THEOplayer version is 7.0.0
+  def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[7.0.0, 8.0.0)')
 
   println("Using THEOplayer (${versionString(theoplayer_sdk_version)})")
   implementation "com.theoplayer.theoplayer-sdk-android:core:${theoplayer_sdk_version}"
-
   implementation "com.theoplayer.theoplayer-sdk-android:ads-wrapper:6.10.0"
 
   if (enabledMediaSession) {

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

@@ -4,9 +4,8 @@ import android.text.TextUtils
 import com.facebook.react.bridge.ReadableMap
 import com.google.ads.interactivemedia.v3.api.AdsRenderingSettings
 import com.google.ads.interactivemedia.v3.api.ImaSdkFactory
+import com.google.ads.interactivemedia.v3.api.ImaSdkSettings
 import com.theoplayer.android.api.THEOplayerConfig
-import com.theoplayer.android.api.ads.AdsConfiguration
-import com.theoplayer.android.api.ads.AdPreloadType
 import com.theoplayer.android.api.cast.CastStrategy
 import com.theoplayer.android.api.cast.CastConfiguration
 import com.theoplayer.android.api.pip.PipConfiguration
@@ -86,24 +85,36 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
   }
 
   /**
-   * Get AdsConfiguration object; these properties apply:
-   * - preload: Whether media files of mid- and postrolls are preloaded.
-   * - uiEnabled: Whether an advertisement UI is shown.
+   * Get ImaSdkSettings object.
+   *
+   * @see <a href="https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkSettings">IMA SDK for Android</a>.
    */
-  fun adsConfig(): AdsConfiguration {
-    return AdsConfiguration.Builder().apply {
+  fun imaSdkSettings(): ImaSdkSettings{
+    return ImaSdkFactory.getInstance().createImaSdkSettings().apply {
       configProps?.getMap(PROP_ADS_CONFIGURATION)?.run {
+        // TODO: bridge all settings
+      }
+    }
+  }
+
+  /**
+   * Create a AdsRenderingSettings object.
+   *
+   * @see <a href="https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/AdsRenderingSettings">IMA SDK for Android</a>.
+   */
+  fun adsRenderSettings(): AdsRenderingSettings {
+    return ImaSdkFactory.getInstance().createAdsRenderingSettings().apply {
+      configProps?.getMap(PROP_ADS_CONFIGURATION)?.run {
+        if (hasKey(PROP_UI_ENABLED) && !getBoolean(PROP_UI_ENABLED)) {
+          setUiElements(emptySet())
+          disableUi = true
+        }
         if (hasKey(PROP_PRELOAD)) {
           val preloadTypeString = getString(PROP_PRELOAD)
-          if (!TextUtils.isEmpty(preloadTypeString)) {
-            preload(AdPreloadType.from(preloadTypeString))
-          }
-        }
-        if (hasKey(PROP_UI_ENABLED)) {
-          showCountdown(getBoolean(PROP_UI_ENABLED))
+          enablePreloading = preloadTypeString !== "none"
         }
       }
-    }.build()
+    }
   }
 
   /**
@@ -121,20 +132,6 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
     }.build()
   }
 
-  /**
-   * Create a AdsRenderingSettings object.
-   */
-  fun adsRenderSettings(): AdsRenderingSettings {
-    return ImaSdkFactory.getInstance().createAdsRenderingSettings().apply {
-      configProps?.getMap(PROP_ADS_CONFIGURATION)?.run {
-        if (hasKey(PROP_UI_ENABLED) && !getBoolean(PROP_UI_ENABLED)) {
-          setUiElements(emptySet())
-          disableUi = true
-        }
-      }
-    }
-  }
-
   /**
    * Get CastConfiguration object; these properties apply:
    * - strategy: The join strategy of the player.

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

@@ -243,7 +243,7 @@ class ReactTHEOplayerContext private constructor(
     try {
       if (BuildConfig.EXTENSION_GOOGLE_IMA) {
         imaIntegration = GoogleImaIntegrationFactory.createGoogleImaIntegration(
-          playerView, configAdapter.adsConfig()
+          playerView, configAdapter.imaSdkSettings()
         ).apply {
           setAdsRenderingSettings(configAdapter.adsRenderSettings())
         }.also {
@@ -256,7 +256,7 @@ class ReactTHEOplayerContext private constructor(
     try {
       if (BuildConfig.EXTENSION_GOOGLE_DAI) {
         daiIntegration = GoogleDaiIntegrationFactory.createGoogleDaiIntegration(
-          playerView, configAdapter.adsConfig()
+          playerView, configAdapter.imaSdkSettings()
         ).apply {
           setAdsRenderingSettings(configAdapter.adsRenderSettings())
         }.also {

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -60,6 +60,7 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                 let (sourceDescription, metadataTrackDescriptions) = THEOplayerRCTSourceDescriptionBuilder.buildSourceDescription(src)
                 if let srcDescription = sourceDescription {
                     if let player = theView.player {
+                        self.triggerViewHierarchyValidation(player)
                         self.setNewSourceDescription(player: player, srcDescription: srcDescription)
                         theView.processMetadataTracks(metadataTrackDescriptions: metadataTrackDescriptions)
                     }
@@ -71,6 +72,15 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
             }
         }
     }
+    
+    private func triggerViewHierarchyValidation(_ player: THEOplayer) {
+        // TEMP: trigger a ViewController Hierarchy revalidation for IMA on the iOS THEOplayer SDK
+#if canImport(THEOplayerGoogleIMAIntegration)
+        let originalFrame = player.frame
+        player.frame.size.width -= 1
+        player.frame = originalFrame
+#endif
+    }
 
     private func setNewSourceDescription(player: THEOplayer, srcDescription: SourceDescription) {
         if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Setting new source on TheoPlayer") }
@@ -124,7 +134,7 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                 let playbackRateValue = playbackRate.doubleValue
                 if player.playbackRate != playbackRateValue {
                     if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Setting playbackRate on TheoPlayer to \(playbackRateValue)") }
-                    player.setPlaybackRate(playbackRateValue)
+                    player.playbackRate = playbackRateValue
                 }
             }
         }
@@ -261,7 +271,7 @@ class THEOplayerRCTPlayerAPI: NSObject, RCTBridgeModule {
                 let preloadType = THEOplayerRCTTypeUtils.preloadTypeFromString(type)
                 if player.preload != preloadType {
                     if DEBUG_PLAYER_API { PrintUtils.printLog(logText: "[NATIVE] Changing TheoPlayer preload type to \(type)") }
-                    player.setPreload(preloadType)
+                    player.preload = preloadType
                 }
             }
         }

package/ios/THEOplayerRCTView.swift

@@ -106,40 +106,22 @@ public class THEOplayerRCTView: UIView {
         }
     }
     
-#if os(iOS)
     private func initPlayer() -> THEOplayer? {
         let stylePath = Bundle.main.path(forResource:"style", ofType: "css")
         let cssPaths = stylePath != nil ? [stylePath!] : []
-        self.player = THEOplayer(configuration: THEOplayerConfiguration(chromeless: self.chromeless,
-                                                                        cssPaths: cssPaths,
-                                                                        pip: self.playerPipConfiguration(),
-                                                                        ads: self.playerAdsConfiguration(),
-                                                                        ui: self.playerUIConfiguration(),
-                                                                        cast: self.playerCastConfiguration(),
-                                                                        hlsDateRange: self.hlsDateRange,
-                                                                        license: self.license,
-                                                                        licenseUrl: self.licenseUrl))
+        let config = THEOplayerConfigurationBuilder()
+        config.pip = self.playerPipConfiguration()
+        config.hlsDateRange = self.hlsDateRange
+        config.license = self.license
+        config.licenseUrl = self.licenseUrl
+        self.player = THEOplayer(configuration: config.build())
+        
         self.initAdsIntegration()
         self.initCastIntegration()
         self.initBackgroundAudio()
         self.initPip()
         return self.player
     }
-#else
-    private func initPlayer() -> THEOplayer? {
-        self.player = THEOplayer(configuration: THEOplayerConfiguration(chromeless: self.chromeless,
-                                                                        ads: self.playerAdsConfiguration(),
-                                                                        hlsDateRange: self.hlsDateRange,
-                                                                        license: self.license,
-                                                                        licenseUrl: self.licenseUrl,
-                                                                        pip: self.playerPipConfiguration(),
-                                                                        ui: self.playerUIConfiguration()))
-        self.initAdsIntegration()
-        self.initBackgroundAudio()
-        self.initPip()
-        return self.player
-    }
-#endif
     
     // MARK: - Destroy Player
     

package/ios/pip/THEOplayerRCTPipControlsManager.swift

@@ -60,23 +60,16 @@ class THEOplayerRCTPipControlsManager: NSObject {
         }
     }
         
-#if os(iOS)
-    
-    func newPipConfiguration() -> PiPConfiguration {
-        return PiPConfiguration(retainPresentationModeOnSourceChange: false,
-                                nativePictureInPicture: true,
-                                canStartPictureInPictureAutomaticallyFromInline: self.pipConfig.canStartPictureInPictureAutomaticallyFromInline,
-                                requiresLinearPlayback: self.isLive || self.inAd)
-    }
-    
-#elseif os(tvOS)
-    
     func newPipConfiguration() -> PiPConfiguration {
-        return PiPConfiguration(retainPresentationModeOnSourceChange: false,
-                                requiresLinearPlayback: self.isLive || self.inAd)
-    }
-    
+        let builder = PiPConfigurationBuilder()
+        builder.retainPresentationModeOnSourceChange = false
+        builder.requiresLinearPlayback = self.isLive || self.inAd
+#if os(iOS)
+        builder.nativePictureInPicture = true
+        builder.canStartPictureInPictureAutomaticallyFromInline = self.pipConfig.canStartPictureInPictureAutomaticallyFromInline
 #endif
+        return builder.build()
+    }
     
     private func attachListeners() {
         guard let player = self.player else {

package/ios/pip/THEOplayerRCTView+PipConfig.swift

@@ -10,23 +10,16 @@ struct PipConfig {
 
 extension THEOplayerRCTView: AVPictureInPictureControllerDelegate {
     
-#if os(iOS)
-    
-    func playerPipConfiguration() -> PiPConfiguration {
-        return PiPConfiguration(retainPresentationModeOnSourceChange: false,
-                                nativePictureInPicture: true,
-                                canStartPictureInPictureAutomaticallyFromInline: self.pipConfig.canStartPictureInPictureAutomaticallyFromInline,
-                                requiresLinearPlayback: false)
-    }
-    
-#elseif os(tvOS)
-    
     func playerPipConfiguration() -> PiPConfiguration {
-        return PiPConfiguration(retainPresentationModeOnSourceChange: false,
-                                requiresLinearPlayback: false)
-    }
-    
+        let builder = PiPConfigurationBuilder()
+        builder.retainPresentationModeOnSourceChange = false
+        builder.requiresLinearPlayback = false
+#if os(iOS)
+        builder.nativePictureInPicture = true
+        builder.canStartPictureInPictureAutomaticallyFromInline = self.pipConfig.canStartPictureInPictureAutomaticallyFromInline
 #endif
+        return builder.build()
+    }
     
     func initPip() {
         if let player = self.player,

package/lib/commonjs/api/THEOplayerView.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["api/THEOplayerView.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["api/THEOplayerView.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/abr/ABRConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"names":["ABRStrategyType","exports"],"sourceRoot":"../../../../src","sources":["api/abr/ABRConfiguration.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAM3B;AACA;AACA;AACA;AACA;AAUA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA"}
+{"version":3,"names":["ABRStrategyType","exports"],"sourceRoot":"../../../../src","sources":["api/abr/ABRConfiguration.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAM3B;AACA;AACA;AACA;AACA;AAUA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/abr/barrel.js.map

@@ -1 +1 @@
-{"version":3,"names":["_ABRConfiguration","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../../src","sources":["api/abr/barrel.ts"],"mappings":";;;;;AAAA,IAAAA,iBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,iBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,iBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,iBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA"}
+{"version":3,"names":["_ABRConfiguration","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../../src","sources":["api/abr/barrel.ts"],"mappings":";;;;;AAAA,IAAAA,iBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,iBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,iBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,iBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/api/ads/Ad.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/Ad.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/Ad.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/AdBreak.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdBreak.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdBreak.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/AdsAPI.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdsAPI.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdsAPI.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/AdsConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdsConfiguration.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/AdsConfiguration.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/CompanionAd.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/CompanionAd.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/CompanionAd.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/GoogleDai.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleDai.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleDai.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/GoogleImaAd.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleImaAd.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleImaAd.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/GoogleImaConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleImaConfiguration.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/ads/GoogleImaConfiguration.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/ads/barrel.js.map

@@ -1 +1 @@
-{"version":3,"names":["_Ad","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_AdBreak","_AdsConfiguration","_AdsAPI","_CompanionAd","_GoogleDai","_GoogleImaAd","_GoogleImaConfiguration"],"sourceRoot":"../../../../src","sources":["api/ads/barrel.ts"],"mappings":";;;;;AAAA,IAAAA,GAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,GAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,GAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,GAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,QAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,QAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,QAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,QAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,iBAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,iBAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,iBAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,iBAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,OAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,OAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,OAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,OAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,YAAA,GAAAZ,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAU,YAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,YAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,YAAA,CAAAR,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,UAAA,GAAAb,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAW,UAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAS,UAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAK,UAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,YAAA,GAAAd,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAY,YAAA,EAAAX,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAU,YAAA,CAAAV,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAM,YAAA,CAAAV,GAAA;IAAA;EAAA;AAAA;AACA,IAAAW,uBAAA,GAAAf,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAa,uBAAA,EAAAZ,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAW,uBAAA,CAAAX,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAO,uBAAA,CAAAX,GAAA;IAAA;EAAA;AAAA"}
+{"version":3,"names":["_Ad","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_AdBreak","_AdsConfiguration","_AdsAPI","_CompanionAd","_GoogleDai","_GoogleImaAd","_GoogleImaConfiguration"],"sourceRoot":"../../../../src","sources":["api/ads/barrel.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/api/backgroundAudio/BackgroundAudioConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/backgroundAudio/BackgroundAudioConfiguration.ts"],"mappings":""}
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/backgroundAudio/BackgroundAudioConfiguration.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/api/backgroundAudio/barrel.js.map

@@ -1 +1 @@
-{"version":3,"names":["_BackgroundAudioConfiguration","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../../src","sources":["api/backgroundAudio/barrel.ts"],"mappings":";;;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,6BAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,6BAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,6BAAA,CAAAK,GAAA;IAAA;EAAA;AAAA"}
+{"version":3,"names":["_BackgroundAudioConfiguration","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../../src","sources":["api/backgroundAudio/barrel.ts"],"mappings":";;;;;AAAA,IAAAA,6BAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,6BAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,6BAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,6BAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}