react-native-theoplayer 3.10.3 → 7.1.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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.1.0] - 24-04-23
+
+### Fixed
+
+- Fixed a build issue on tvOS example app due to the deprecated `prepare` method.
+
+### Added
+
+- Added multiple configuration options to `GoogleImaConfiguration` for both iOS and Android. These map to the corresponding IMASettings from the underlying native Google IMA SDKs.
+- Added `skipForwardInterval` and `skipBackwardInterval` properties to `MediaControlConfiguration` for Android and Web, enabling configurable skip intervals for media sessions.
+- Added ios bridging code to make 'forced' property available from native iOS TextTrack API.
+
+### Removed
+
+- Removed support for the web-based native iOS SDK on the RN iOS Bridge.
+
+## [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
@@ -196,7 +228,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
@@ -492,7 +524,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.
@@ -513,8 +545,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,38 @@ 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)
+- [Digital Rights Management (DRM)](./doc/drm.md)
+- [Fullscreen presentation](./doc/fullscreen.md)
+- [Media Caching](./doc/media-caching.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,21 +112,13 @@ 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) {
-    println("Enable THEOplayer MediaSession extension (${versionString(theoplayer_sdk_version)})")
-    implementation "com.theoplayer.android-connector:mediasession:${theoplayer_sdk_version}"
-  } else {
-    println('Disable THEOplayer MediaSession extension.')
-    compileOnly "com.theoplayer.android-connector:mediasession:${theoplayer_sdk_version}"
-  }
+  implementation "com.theoplayer.android-connector:mediasession:${theoplayer_sdk_version}"
 
   if (enabledGoogleIMA) {
     println('Enable THEOplayer IMA extension.')

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

@@ -4,14 +4,16 @@ 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.THEOplayerGlobal
 import com.theoplayer.android.api.cast.CastStrategy
 import com.theoplayer.android.api.cast.CastConfiguration
 import com.theoplayer.android.api.pip.PipConfiguration
 import com.theoplayer.android.api.player.NetworkConfiguration
 import com.theoplayer.android.api.ui.UIConfiguration
+import com.theoplayer.media.MediaSessionConfig
+import com.theoplayer.media.MediaSessionConfigAdapter
 
 private const val PROP_LICENSE = "license"
 private const val PROP_LICENSE_URL = "licenseUrl"
@@ -27,7 +29,15 @@ private const val PROP_RETRY_MIN_BACKOFF = "minimumBackoff"
 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_UI_CONFIGURATION = "ui"
+private const val PROP_MEDIA_CONTROL = "mediaControl"
+private const val PROP_PPID = "ppid"
+private const val PROP_MAX_REDIRECTS = "maxRedirects"
+private const val PROP_FEATURE_FLAGS = "featureFlags"
+private const val PROP_AUTOPLAY_AD_BREAKS = "autoPlayAdBreaks"
+private const val PROP_SESSION_ID = "sessionID"
+private const val PROP_ENABLE_DEBUG_MODE = "enableDebugMode"
 
 class PlayerConfigAdapter(private val configProps: ReadableMap?) {
 
@@ -86,24 +96,72 @@ 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)?.getMap(PROP_IMA_CONFIGURATION)?.run {
+        // Specifies whether VMAP and ad rules ad breaks are automatically played.
+        if (hasKey(PROP_AUTOPLAY_AD_BREAKS)) {
+          autoPlayAdBreaks = getBoolean(PROP_AUTOPLAY_AD_BREAKS)
+        }
+        // Feature flags and their states. Used to control experimental features.
+        if (hasKey(PROP_FEATURE_FLAGS)) {
+          val convertedMap: MutableMap<String, String> = mutableMapOf()
+          getMap(PROP_FEATURE_FLAGS)?.toHashMap()?.forEach { (key, value) ->
+            convertedMap[key] = value as String
+          }
+          featureFlags = convertedMap
+        }
+        // The current ISO 639-1 language code, get it from the UI config.
+        uiConfig().language?.let {
+          language = it
+        }
+        // The maximum number of VAST redirects.
+        if (hasKey(PROP_MAX_REDIRECTS)) {
+          maxRedirects = getInt(PROP_MAX_REDIRECTS)
+        }
+        // The partner provided player type.
+        playerType = "THEOplayer"
+        // The partner provided player version.
+        playerVersion = THEOplayerGlobal.getVersion()
+        // The Publisher Provided Identification (PPID) sent with ads request.
+        if (hasKey(PROP_PPID)) {
+          ppid = getString(PROP_PPID) ?: ""
+        }
+        // The session ID to identify a single user session. This should be a UUID. It
+        // is used exclusively for frequency capping across the user session.
+        if (hasKey(PROP_SESSION_ID)) {
+          sessionId = getString(PROP_PPID) ?: ""
+        }
+        // Toggles debug mode which will output detailed log information to the console.
+        if (hasKey(PROP_ENABLE_DEBUG_MODE)) {
+          isDebugMode = getBoolean(PROP_ENABLE_DEBUG_MODE)
+        }
+      }
+    }
+  }
+
+  /**
+   * 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 +179,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.
@@ -157,4 +201,14 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
       else -> null
     }
   }
+
+  /**
+   * Get MediaSession connector configuration; these properties apply:
+   * - mediaSessionEnabled: whether or not the media session should be enabled.
+   * - skipForwardInterval: the amount of seconds the player will skip forward.
+   * - skipBackwardInterval: the amount of seconds the player will skip backward.
+   */
+  fun mediaSessionConfig(): MediaSessionConfig {
+    return MediaSessionConfigAdapter.fromProps(configProps?.getMap(PROP_MEDIA_CONTROL))
+  }
 }

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

@@ -28,6 +28,7 @@ import com.theoplayer.audio.AudioBecomingNoisyManager
 import com.theoplayer.audio.AudioFocusManager
 import com.theoplayer.audio.BackgroundAudioConfig
 import com.theoplayer.media.MediaPlaybackService
+import com.theoplayer.media.MediaSessionConfig
 import java.util.concurrent.atomic.AtomicBoolean
 
 private const val TAG = "ReactTHEOplayerContext"
@@ -42,7 +43,8 @@ private const val ALLOWED_PLAYBACK_ACTIONS = (
     PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED)
 
 class ReactTHEOplayerContext private constructor(
-  private val reactContext: ThemedReactContext
+  private val reactContext: ThemedReactContext,
+  private val configAdapter: PlayerConfigAdapter
 ) {
   private val mainHandler = Handler(Looper.getMainLooper())
   private var isBound = AtomicBoolean()
@@ -60,6 +62,12 @@ class ReactTHEOplayerContext private constructor(
       field = value
     }
 
+  var mediaSessionConfig: MediaSessionConfig = configAdapter.mediaSessionConfig()
+    set(value) {
+      applyMediaSessionConfig(mediaSessionConnector, value)
+      field = value
+    }
+
   lateinit var playerView: THEOplayerView
 
   val player: Player
@@ -85,8 +93,8 @@ class ReactTHEOplayerContext private constructor(
       reactContext: ThemedReactContext,
       configAdapter: PlayerConfigAdapter
     ): ReactTHEOplayerContext {
-      return ReactTHEOplayerContext(reactContext).apply {
-        initializePlayerView(configAdapter)
+      return ReactTHEOplayerContext(reactContext, configAdapter).apply {
+        initializePlayerView()
       }
     }
   }
@@ -96,9 +104,9 @@ class ReactTHEOplayerContext private constructor(
       binder = service as MediaPlaybackService.MediaPlaybackBinder
 
       // Get media session connector from service
-      mediaSessionConnector = binder?.mediaSessionConnector
-      mediaSessionConnector?.player = player
-      mediaSessionConnector?.setMediaSessionMetadata(player.source)
+      mediaSessionConnector = binder?.mediaSessionConnector?.also {
+        applyMediaSessionConfig(it, mediaSessionConfig)
+      }
 
       // Pass player context
       binder?.setPlayerContext(this@ReactTHEOplayerContext)
@@ -184,7 +192,7 @@ class ReactTHEOplayerContext private constructor(
     binder = null
   }
 
-  private fun initializePlayerView(configAdapter: PlayerConfigAdapter) {
+  private fun initializePlayerView() {
     playerView = object : THEOplayerView(reactContext.currentActivity!!, configAdapter.playerConfig()) {
       private fun measureAndLayout() {
         measure(
@@ -205,7 +213,7 @@ class ReactTHEOplayerContext private constructor(
     // By default, the screen should remain on.
     playerView.keepScreenOn = true
 
-    addIntegrations(configAdapter)
+    addIntegrations()
     addListeners()
 
     audioFocusManager = AudioFocusManager(reactContext, player)
@@ -229,21 +237,34 @@ class ReactTHEOplayerContext private constructor(
     mediaSession.setMediaButtonReceiver(null)
 
     // Create a MediaSessionConnector and attach the THEOplayer instance.
-    mediaSessionConnector = MediaSessionConnector(mediaSession).apply {
+    mediaSessionConnector = MediaSessionConnector(mediaSession).also {
+      applyMediaSessionConfig(it, mediaSessionConfig)
+    }
+  }
+
+  private fun applyMediaSessionConfig(connector: MediaSessionConnector?, config: MediaSessionConfig) {
+    connector?.apply {
       debug = BuildConfig.LOG_MEDIASESSION_EVENTS
+
       player = this@ReactTHEOplayerContext.player
 
       // Set mediaSession active and ready to receive media button events, but not if the player
       // is backgrounded.
-      setActive(!isHostPaused)
+      setActive(!isHostPaused && BuildConfig.EXTENSION_MEDIASESSION && config.mediaSessionEnabled)
+
+      skipForwardInterval = config.skipForwardInterval
+      skipBackwardsInterval = config.skipBackwardInterval
+
+      // Pass metadata from source description
+      setMediaSessionMetadata(player?.source)
     }
   }
 
-  private fun addIntegrations(configAdapter: PlayerConfigAdapter) {
+  private fun addIntegrations() {
     try {
       if (BuildConfig.EXTENSION_GOOGLE_IMA) {
         imaIntegration = GoogleImaIntegrationFactory.createGoogleImaIntegration(
-          playerView, configAdapter.adsConfig()
+          playerView, configAdapter.imaSdkSettings()
         ).apply {
           setAdsRenderingSettings(configAdapter.adsRenderSettings())
         }.also {
@@ -256,7 +277,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 {
@@ -357,7 +378,7 @@ class ReactTHEOplayerContext private constructor(
    */
   fun onHostResume() {
     isHostPaused = false
-    mediaSessionConnector?.setActive(true)
+    mediaSessionConnector?.setActive(BuildConfig.EXTENSION_MEDIASESSION)
     playerView.onResume()
     if (!player.isPaused) {
       audioFocusManager?.retrieveAudioFocus()

package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt

@@ -173,7 +173,7 @@ class MediaPlaybackService : MediaBrowserServiceCompat() {
       debug = BuildConfig.LOG_MEDIASESSION_EVENTS
 
       // Set mediaSession active
-      setActive(true)
+      setActive(BuildConfig.EXTENSION_MEDIASESSION)
     }
 
     // Set the MediaBrowserServiceCompat's media session.

package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt

@@ -0,0 +1,18 @@
+package com.theoplayer.media
+
+data class MediaSessionConfig (
+  /**
+   * Whether or not the media session should be enabled.
+   */
+  var mediaSessionEnabled: Boolean = true,
+
+  /**
+   * The amount of seconds the player will skip forward.
+   */
+  var skipForwardInterval: Double = 5.0,
+
+  /**
+   * The amount of seconds the player will skip backward.
+   */
+  var skipBackwardInterval: Double = 5.0,
+)

package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt

@@ -0,0 +1,23 @@
+package com.theoplayer.media
+
+import com.facebook.react.bridge.ReadableMap
+
+object MediaSessionConfigAdapter {
+  private const val PROP_ENABLED = "mediaSessionEnabled"
+  private const val PROP_SKIP_FORWARD_INTERVAL = "skipForwardInterval"
+  private const val PROP_SKIP_BACKWARD_INTERVAL = "skipBackwardInterval"
+
+  fun fromProps(props: ReadableMap?): MediaSessionConfig {
+    return MediaSessionConfig().apply {
+      if (props?.hasKey(PROP_ENABLED) == true) {
+        mediaSessionEnabled = props.getBoolean(PROP_ENABLED)
+      }
+      if (props?.hasKey(PROP_SKIP_FORWARD_INTERVAL) == true) {
+        skipForwardInterval = props.getDouble(PROP_SKIP_FORWARD_INTERVAL)
+      }
+      if (props?.hasKey(PROP_SKIP_BACKWARD_INTERVAL) == true) {
+        skipBackwardInterval = props.getDouble(PROP_SKIP_BACKWARD_INTERVAL)
+      }
+    }
+  }
+}

package/ios/THEOplayerRCTPlayerAPI.swift

@@ -134,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
                 }
             }
         }
@@ -271,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/THEOplayerRCTSourceDescriptionBuilder.swift

@@ -352,17 +352,7 @@ class THEOplayerRCTSourceDescriptionBuilder {
     static func buildContentProtection(_ contentProtectionData: [String:Any]) -> MultiplatformDRMConfiguration? {
         do {
             let data = try JSONSerialization.data(withJSONObject: contentProtectionData)
-            if let integration = contentProtectionData[SD_PROP_INTEGRATION] as? String {
-                switch integration {
-                case DRM_INTEGRATION_ID_EZDRM: return try JSONDecoder().decode(EzdrmDRMConfiguration.self, from: data)
-                case DRM_INTEGRATION_ID_KEYOS: return try JSONDecoder().decode(KeyOSDRMConfiguration.self, from: data)
-                case DRM_INTEGRATION_ID_VERIMATRIX: return try JSONDecoder().decode(VerimatrixDRMConfiguration.self, from: data)
-                default: return try JSONDecoder().decode(MultiplatformDRMConfiguration.self, from: data)
-                }
-            } else {
-                PrintUtils.printLog(logText: "[NATIVE] integration type not specified... trying default drm integration")
-                return try JSONDecoder().decode(MultiplatformDRMConfiguration.self, from: data)
-            }
+            return try JSONDecoder().decode(MultiplatformDRMConfiguration.self, from: data)
         } catch {
             PrintUtils.printLog(logText: "[NATIVE] unsupported contentProtection data format")
         }

package/ios/THEOplayerRCTTrackMetadataAggregator.swift

@@ -26,6 +26,7 @@ let PROP_CUES: String = "cues"
 let PROP_CUE_CONTENT: String = "content"
 let PROP_CUE_CUSTOM_ATTRIBUTES: String = "customAttributes"
 let PROP_SRC: String = "src"
+let PROP_FORCED: String = "forced"
 let PROP_START_DATE: String = "startDate"
 let PROP_END_DATE: String = "endDate"
 let PROP_ATTRIBUTE_CLASS: String = "class"
@@ -73,6 +74,7 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_LABEL] = textTrack.label
         entry[PROP_TYPE] = textTrack.type
         entry[PROP_SRC] = textTrack.src
+        entry[PROP_FORCED] = textTrack.forced
         // process cues when texttrack contains them
         if !textTrack.cues.isEmpty {
             var cueList: [[String:Any]] = []