react-native-theoplayer 10.11.0 → 10.12.1

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [10.12.1] - 26-03-19
+
+### Fixed
+
+- Fixed an issue on Android where play-out of a Google DAI stream would crash the app.
+
+## [10.12.0] - 26-03-12
+
+### Added
+
+- Added `currentsourcechange` event to the player API, which is dispatched when the current source, chosen from the source description's sources, changes.
+- Added `debugLogsEnabled` flag to `PlayerConfiguration` to allow enabling all debug logs from the underlying Android SDK.
+- Added the `id` property to `AdBreak`, representing the identifier of the ad break.
+
+### Fixed
+
+- Fixed an issue on Android where the build process would pick up version from the snapshot repository instead of the release repository, causing build failures.
+- Fixed an issue on iOS & Android where, when using `<StrictMode>`, the player's list of text tracks would be empty.
+
 ## [10.11.0] - 26-03-10
 
 ### Fixed
@@ -25,9 +44,6 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Added
 
 - Added the `DistributionLoaded` event for THEOlive.
-
-### Added
-
 - Added contentProtection extraction for THEOlive endpoints on iOS.
 
 ## [10.9.0] - 26-01-29
@@ -52,6 +68,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Added
 
 - Added support on iOS to push the initial state of the player from the iOS bridge to the React native adapter.
+- Added RNRepo support for Android to the example app. More info on the official [documentation](https://rnrepo.org/) page.
 
 ### Fixed
 
@@ -61,10 +78,6 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Fixed an issue on Android where the player would sometimes have wrong dimensions after transitioning to fullscreen presentation mode.
 - Fixed an issue on Android where the `useEMSG` property was not included when setting a TheoAds source description.
 
-### Added
-
-- Added RNRepo support for Android to the example app. More info on the official [documentation](https://rnrepo.org/) page.
-
 ## [10.7.1] - 26-01-06
 
 ### Added
@@ -176,9 +189,6 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Changed
 
 - Added `THEOplayer.theoLive` and deprecated `THEOplayer.theolive`, to be consistent with the THEOplayer SDKs for other platforms.
-
-### Changed
-
 - Moved the `hlsDateRange` property from `SourceConfiguration` to its correct location in `TypedSource`.
 
 ## [10.1.0] - 25-10-06

package/android/build.gradle

@@ -109,7 +109,6 @@ android {
 rootProject.allprojects {
     repositories {
         maven { url "https://maven.theoplayer.com/releases" }
-        maven { url "https://maven.theoplayer.com/snapshots" }
         maven { url("$rootDir/../node_modules/react-native-theoplayer/android/local") }
         mavenLocal()
     }
@@ -119,15 +118,14 @@ repositories {
     google()
     mavenCentral()
     maven { url "https://maven.theoplayer.com/releases" }
-    maven { url "https://maven.theoplayer.com/snapshots" }
     maven { url("$rootDir/../node_modules/react-native-theoplayer/android/local") }
     mavenLocal()
 }
 
-// The minimum supported THEOplayer version is 10.10.0
-def theoVersion = safeExtGet('THEOplayer_sdk', '[10.10.0, 11.0.0)')
+// The minimum supported THEOplayer version is 10.12.0
+def theoVersion = safeExtGet('THEOplayer_sdk', '[10.12.0, 11.0.0)')
 def theoMediaSessionVersion = safeExtGet('THEOplayer_mediasession', '[8.0.0, 11.0.0)')
-def theoAdsWrapperVersion = "10.0.0"
+def theoAdsWrapperVersion = "10.12.0"
 def coroutinesVersion = safeExtGet('coroutinesVersion', '1.10.2')
 def appcompatVersion = safeExtGet('appcompatVersion', '1.7.1')
 def corektxVersion = safeExtGet('corektxVersion', '1.16.0')

package/android/local/com/theoplayer/theoplayer-sdk-android/ads-wrapper/{10.0.0/ads-wrapper-10.0.0.pom → 10.12.0/ads-wrapper-10.12.0.pom}

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <modelVersion>10.0.0</modelVersion>
+  <modelVersion>10.12.0</modelVersion>
   <groupId>com.theoplayer.theoplayer-sdk-android</groupId>
   <artifactId>ads-wrapper</artifactId>
-  <version>10.0.0</version>
+  <version>10.12.0</version>
   <packaging>aar</packaging>
   <dependencies>
     <!-- Include transitive dependencies -->

package/android/local/com/theoplayer/theoplayer-sdk-android/ads-wrapper/maven-metadata-local.xml

@@ -3,11 +3,11 @@
   <groupId>com.theoplayer.theoplayer-sdk-android</groupId>
   <artifactId>ads-wrapper</artifactId>
   <versioning>
-    <latest>10.0.0</latest>
-    <release>10.0.0</release>
+    <latest>10.12.0</latest>
+    <release>10.12.0</release>
     <versions>
-      <version>10.0.0</version>
+      <version>10.12.0</version>
     </versions>
-    <lastUpdated>20250913190622</lastUpdated>
+    <lastUpdated>20260318164412</lastUpdated>
   </versioning>
 </metadata>

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

@@ -43,9 +43,19 @@ private const val PROP_THEOLIVE_EXTERNAL_SESSION_ID = "externalSessionId"
 private const val PROP_THEOLIVE_ANALYTICS_DISABLED = "analyticsDisabled"
 private const val PROP_THEOLIVE_DISCOVERY_URL = "discoveryUrl"
 private const val PROP_MULTIMEDIA_TUNNELING_ENABLED = "tunnelingEnabled"
+private const val PROP_DEBUG_LOGS_ENABLED = "debugLogsEnabled"
 
 class PlayerConfigAdapter(private val configProps: ReadableMap?) {
 
+  /**
+   * Whether debug logs from the native SDK should be enabled.
+   */
+  fun debugLogsEnabled(): Boolean {
+    return configProps?.let {
+      if (it.hasKey(PROP_DEBUG_LOGS_ENABLED)) it.getBoolean(PROP_DEBUG_LOGS_ENABLED) else false
+    } ?: false
+  }
+
   /**
    * Get general THEOplayerConfig object; these properties apply:
    * - license: The license for the player.
@@ -62,12 +72,12 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
           licenseUrl(licenseUrl)
         }
         if (hasKey(PROP_RETRY_CONFIG) || hasKey(PROP_USE_HTTPENGINE)) {
-          networkConfiguration(networkConfig())
+          network(networkConfig())
         }
         if (hasKey(PROP_THEOLIVE_CONFIG)) {
-          theoLiveConfiguration(theoLiveConfig())
+          theoLive(theoLiveConfig())
         }
-        pipConfiguration(PipConfiguration.Builder().build())
+        pip(PipConfiguration.Builder().build())
         // Opt-out for auto-integrations for now
         autoIntegrations(false)
         if (hasKey(PROP_MULTIMEDIA_TUNNELING_ENABLED)) {

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

@@ -44,6 +44,7 @@ import com.theoplayer.android.api.player.track.texttrack.TextTrackKind
 import com.theoplayer.android.api.player.track.texttrack.TextTrackMode
 import com.theoplayer.cast.CastEventAdapter
 import com.theoplayer.presentation.PresentationModeChangeContext
+import com.theoplayer.source.SourceAdapter
 import com.theoplayer.theoads.THEOadsEventAdapter
 import com.theoplayer.theolive.THEOliveEventAdapter
 import com.theoplayer.track.*
@@ -55,6 +56,7 @@ private val TAG = PlayerEventEmitter::class.java.name
 private const val EVENT_PLAYER_READY = "onNativePlayerReady"
 private const val EVENT_PLAYER_STATE_SYNC = "onNativePlayerStateSync"
 private const val EVENT_SOURCECHANGE = "onNativeSourceChange"
+private const val EVENT_CURRENTSOURCECHANGE = "onNativeCurrentSourceChange"
 private const val EVENT_LOADSTART = "onNativeLoadStart"
 private const val EVENT_LOADEDMETADATA = "onNativeLoadedMetadata"
 private const val EVENT_LOADEDDATA = "onNativeLoadedData"
@@ -101,6 +103,7 @@ class PlayerEventEmitter internal constructor(
     EVENT_PLAYER_READY,
     EVENT_PLAYER_STATE_SYNC,
     EVENT_SOURCECHANGE,
+    EVENT_CURRENTSOURCECHANGE,
     EVENT_LOADSTART,
     EVENT_LOADEDMETADATA,
     EVENT_LOADEDDATA,
@@ -139,6 +142,7 @@ class PlayerEventEmitter internal constructor(
       EVENT_PLAYER_READY,
       EVENT_PLAYER_STATE_SYNC,
       EVENT_SOURCECHANGE,
+      EVENT_CURRENTSOURCECHANGE,
       EVENT_LOADSTART,
       EVENT_LOADEDMETADATA,
       EVENT_LOADEDDATA,
@@ -181,6 +185,7 @@ class PlayerEventEmitter internal constructor(
   private var castEventAdapter: CastEventAdapter? = null
   private var theoLiveEventAdapter: THEOliveEventAdapter? = null
   private var theoAdsEventAdapter: THEOadsEventAdapter? = null
+  private val sourceAdapter: SourceAdapter = SourceAdapter()
   private var lastTimeUpdate: Long = 0
   private var lastCurrentTime = 0.0
   private var dimensionChangeListener = View.OnLayoutChangeListener { v, _, _, _, _, oldLeft, oldTop, oldRight, oldBottom ->
@@ -195,6 +200,8 @@ class PlayerEventEmitter internal constructor(
     playerListeners[PlayerEventTypes.SOURCECHANGE] = EventListener<PlayerEvent<*>> {
       receiveEvent(EVENT_SOURCECHANGE, null)
     }
+    playerListeners[PlayerEventTypes.CURRENTSOURCECHANGE] =
+      EventListener { event: CurrentSourceChangeEvent -> onCurrentSourceChange(event) }
     playerListeners[PlayerEventTypes.LOADSTART] = EventListener<PlayerEvent<*>> {
       receiveEvent(EVENT_LOADSTART, null)
     }
@@ -340,6 +347,14 @@ class PlayerEventEmitter internal constructor(
     receiveEvent(EVENT_ERROR, PayloadBuilder().error(code, message).build())
   }
 
+  private fun onCurrentSourceChange(event: CurrentSourceChangeEvent) {
+    event.currentSource?.let { currentSource ->
+      receiveEvent(EVENT_CURRENTSOURCECHANGE, Arguments.createMap().apply {
+        putMap("currentSource", sourceAdapter.fromTypedSource(currentSource))
+      })
+    }
+  }
+
   private fun onLoadedMetadata() {
     playerView.player?.let {
       receiveEvent(

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

@@ -14,6 +14,7 @@ import android.support.v4.media.session.MediaSessionCompat
 import android.support.v4.media.session.PlaybackStateCompat
 import android.util.Log
 import com.facebook.react.uimanager.ThemedReactContext
+import com.theoplayer.android.api.THEOplayerGlobal
 import com.theoplayer.android.api.THEOplayerView
 import com.theoplayer.android.api.ads.dai.GoogleDaiIntegration
 import com.theoplayer.android.api.ads.dai.GoogleDaiIntegrationFactory
@@ -229,6 +230,11 @@ class ReactTHEOplayerContext private constructor(
   }
 
   private fun initializePlayerView() {
+    // Enable all debug logs from the underlying Android SDK if configured.
+    if (configAdapter.debugLogsEnabled()) {
+      THEOplayerGlobal.getSharedInstance(reactContext).logger.enableAllTags()
+    }
+
     playerView = object : THEOplayerView(reactContext, configAdapter.playerConfig()) {
       private fun measureAndLayout() {
         measure(

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

@@ -39,6 +39,7 @@ private const val PROP_ADBREAK_INTEGRATION = "integration"
 private const val PROP_ADBREAK_MAXDURATION = "maxDuration"
 private const val PROP_ADBREAK_TIMEOFFSET = "timeOffset"
 private const val PROP_ADBREAK_MAXREMAININGDURATION = "maxRemainingDuration"
+private const val PROP_ADBREAK_ID = "id"
 private const val PROP_ADBREAK_ADS = "ads"
 private const val PROP_COMPANION_ADSLOTID = "adSlotId"
 private const val PROP_COMPANION_ALTTEXT = "altText"
@@ -141,6 +142,7 @@ object AdAdapter {
       return adbreakPayload
     }
     adbreakPayload.putString(PROP_ADBREAK_INTEGRATION, adbreak.integration.type)
+    adbreakPayload.putString(PROP_ADBREAK_ID, adbreak.idAsString)
     adbreakPayload.putInt(PROP_ADBREAK_MAXDURATION,adbreak.maxDuration)
     adbreakPayload.putInt(PROP_ADBREAK_TIMEOFFSET, adbreak.timeOffset)
     adbreakPayload.putDouble(PROP_ADBREAK_MAXREMAININGDURATION, adbreak.maxRemainingDuration)
@@ -286,6 +288,10 @@ object AdAdapter {
         return adBreak.getString(PROP_AD_CUSTOM_INTEGRATION)
       }
 
+      override fun getIdAsString(): String? {
+        return if (adBreak.hasKey(PROP_ADBREAK_ID)) adBreak.getString(PROP_ADBREAK_ID) else null
+      }
+
       override fun getCustomData(): Any? {
         // Not supported yet
         return null

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

@@ -456,6 +456,10 @@ class SourceAdapter {
     return BridgeUtils.fromJSONObjectToBridge(json)
   }
 
+  fun fromTypedSource(typedSource: TypedSource): WritableMap {
+    return BridgeUtils.fromJSONObjectToBridge(JSONObject(gson.toJson(typedSource)))
+  }
+
   private fun parseCmcdTransmissionMode(cmcdConfiguration : JSONObject) : CMCDTransmissionMode {
     try {
       val transmissionMode = cmcdConfiguration.optInt(CMCD_TRANSMISSION_MODE)

package/ios/THEOplayerRCTBridge.m

@@ -19,6 +19,7 @@ RCT_EXPORT_VIEW_PROPERTY(config, NSDictionary);
 RCT_EXPORT_VIEW_PROPERTY(onNativePause, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativePlay, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeSourceChange, RCTDirectEventBlock);
+RCT_EXPORT_VIEW_PROPERTY(onNativeCurrentSourceChange, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeLoadStart, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeReadyStateChange, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onNativeDurationChange, RCTDirectEventBlock);

package/ios/THEOplayerRCTMainEventHandler.swift

@@ -13,6 +13,7 @@ public class THEOplayerRCTMainEventHandler {
     var onNativePlay: RCTDirectEventBlock?
     var onNativePause: RCTDirectEventBlock?
     var onNativeSourceChange: RCTDirectEventBlock?
+    var onNativeCurrentSourceChange: RCTDirectEventBlock?
     var onNativeLoadStart: RCTDirectEventBlock?
     var onNativeReadyStateChange: RCTDirectEventBlock?
     var onNativeDurationChange: RCTDirectEventBlock?
@@ -36,6 +37,7 @@ public class THEOplayerRCTMainEventHandler {
     private var playListener: EventListener?
     private var pauseListener: EventListener?
     private var sourceChangeListener: EventListener?
+    private var currentSourceChangeListener: EventListener?
     private var loadStartListener: EventListener?
     private var readyStateChangeListener: EventListener?
     private var durationChangeListener: EventListener?
@@ -107,7 +109,22 @@ public class THEOplayerRCTMainEventHandler {
             }
         }
         if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] SourceChange listener attached to THEOplayer") }
-        
+
+        // CURRENT_SOURCE_CHANGE
+        self.currentSourceChangeListener = player.addEventListener(type: PlayerEventTypes.CURRENT_SOURCE_CHANGE) { [weak self] event in
+            if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received CURRENT_SOURCE_CHANGE event from THEOplayer") }
+            if let forwardedCurrentSourceChangeEvent = self?.onNativeCurrentSourceChange {
+                var typedSource: [String:Any]? = nil
+                if let currentSource = event.currentSource {
+                    typedSource = THEOplayerRCTSourceDescriptionAggregator.aggregateTypedSource(typedSource: currentSource)
+                }
+                forwardedCurrentSourceChangeEvent(
+                    ["currentSource": typedSource ?? [:]]
+                )
+            }
+        }
+        if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] CurrentSourceChange listener attached to THEOplayer") }
+
         // LOAD_START
         self.loadStartListener = player.addEventListener(type: PlayerEventTypes.LOAD_START) { [weak self] event in
             if DEBUG_THEOPLAYER_EVENTS { PrintUtils.printLog(logText: "[NATIVE] Received LOAD_START event from THEOplayer") }
@@ -361,7 +378,13 @@ public class THEOplayerRCTMainEventHandler {
             player.removeEventListener(type: PlayerEventTypes.SOURCE_CHANGE, listener: sourceChangeListener)
             if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] SourceChange listener dettached from THEOplayer") }
         }
-        
+
+        // CURRENT_SOURCE_CHANGE
+        if let currentSourceChangeListener = self.currentSourceChangeListener {
+            player.removeEventListener(type: PlayerEventTypes.CURRENT_SOURCE_CHANGE, listener: currentSourceChangeListener)
+            if DEBUG_EVENTHANDLER { PrintUtils.printLog(logText: "[NATIVE] CurrentSourceChange listener dettached from THEOplayer") }
+        }
+
         // LOAD_START
         if let loadStartListener = self.loadStartListener {
             player.removeEventListener(type: PlayerEventTypes.LOAD_START, listener: loadStartListener)

package/ios/THEOplayerRCTSourceDescriptionAggregator.swift

@@ -19,6 +19,20 @@ class THEOplayerRCTSourceDescriptionAggregator {
         return nil
     }
     
+    class func aggregateTypedSource(typedSource: TypedSource) -> [String:Any]? {
+        do {
+            let jsonEncoder = JSONEncoder()
+            let data = try jsonEncoder.encode(typedSource)
+            if let result = try? JSONSerialization.jsonObject(with: data, options: []) as? [String:Any] {
+                return result
+            }
+        } catch {
+            if DEBUG { PrintUtils.printLog(logText: "[NATIVE] Could not aggregate typedSource: \(error.localizedDescription)")}
+            return nil
+        }
+        return nil
+    }
+    
     class func aggregateCacheTaskSourceDescription(sourceDescription: SourceDescription, cachingTaskId: String) -> [String:Any]? {
         if let result = THEOplayerRCTSourceDescriptionAggregator.aggregateSourceDescription(sourceDescription: sourceDescription) {
             let srcDescription = THEOplayerRCTSourceDescriptionAggregator.sanitiseSourceDescriptionMetadata(input: result)

package/ios/THEOplayerRCTView.swift

@@ -364,7 +364,13 @@ public class THEOplayerRCTView: UIView {
         self.mainEventHandler.onNativeSourceChange = nativeSourceChange
         if DEBUG_VIEW { PrintUtils.printLog(logText: "[NATIVE] nativeSourceChange prop set.") }
     }
-    
+
+    @objc(setOnNativeCurrentSourceChange:)
+    func setOnNativeCurrentSourceChange(nativeCurrentSourceChange: @escaping RCTDirectEventBlock) {
+        self.mainEventHandler.onNativeCurrentSourceChange = nativeCurrentSourceChange
+        if DEBUG_VIEW { PrintUtils.printLog(logText: "[NATIVE] nativeCurrentSourceChange prop set.") }
+    }
+
     @objc(setOnNativeLoadStart:)
     func setOnNativeLoadStart(nativeLoadStart: @escaping RCTDirectEventBlock) {
         self.mainEventHandler.onNativeLoadStart = nativeLoadStart

package/ios/ads/THEOplayerRCTAdAdapter.swift

@@ -27,6 +27,7 @@ let PROP_GOOGLE_AD_ID_VALUE: String = "adIdValue"
 let PROP_GOOGLE_AD_WRAPPER_AD_IDS: String = "wrapperAdIds"
 let PROP_GOOGLE_AD_WRAPPER_AD_SYSTEMS: String = "wrapperAdSystems"
 let PROP_GOOGLE_AD_WRAPPER_CREATIVE_IDS: String = "wrapperCreativeIds"
+let PROP_ADBREAK_ID: String = "id"
 let PROP_ADBREAK_MAX_DURATION: String = "maxDuration"
 let PROP_ADBREAK_TIME_OFFSET: String = "timeOffset"
 let PROP_ADBREAK_MAX_REMAINING_DURATION: String = "maxRemainingDuration"
@@ -173,6 +174,7 @@ class THEOplayerRCTAdAdapter {
     
     class func fromAdBreak(adBreak: AdBreak) -> [String:Any] {
         var adBreakData: [String:Any] = [:]
+        adBreakData[PROP_ADBREAK_ID] = adBreak.id
         adBreakData[PROP_ADBREAK_MAX_DURATION] = adBreak.maxDuration
         adBreakData[PROP_ADBREAK_TIME_OFFSET] = adBreak.timeOffset
         adBreakData[PROP_ADBREAK_MAX_REMAINING_DURATION] = adBreak.maxRemainingDuration
@@ -204,6 +206,7 @@ class THEOplayerRCTAdAdapter {
         }
         
         return NativeAdBreak(ads: ads,
+                             id: adBreakData[PROP_ADBREAK_ID] as? String,
                              maxDuration: lround((adBreakData[PROP_ADBREAK_MAX_DURATION] as? Double) ?? 0),
                              maxRemainingDuration: (adBreakData[PROP_ADBREAK_MAX_REMAINING_DURATION] as? Double) ?? 0,
                              timeOffset: lround((adBreakData[PROP_ADBREAK_TIME_OFFSET] as? Double) ?? 0),
@@ -212,7 +215,7 @@ class THEOplayerRCTAdAdapter {
     }
     
     class func defaultAdBreak() -> NativeAdBreak {
-        return NativeAdBreak(ads: [], maxDuration: 0, maxRemainingDuration: 0, timeOffset: 0, integration: .custom)
+        return NativeAdBreak(ads: [], id: nil, maxDuration: 0, maxRemainingDuration: 0, timeOffset: 0, integration: .custom)
     }
     
     class private func fromCompanionAds(companionAds: [CompanionAd]) -> [[String:Any]] {

package/ios/ads/THEOplayerRCTAdsNative.swift

@@ -30,7 +30,7 @@ class NativeAd: THEOplayerSDK.Ad {
     var clickThrough: String? = nil
     /**The type of custom ad integration.*/
     var customIntegration: String? = nil
-    
+
     init(adBreak: AdBreak, companions: [THEOplayerSDK.CompanionAd], type: String, id: String? = nil, skipOffset: Int? = nil, resourceURI: String? = nil, width: Int? = nil, height: Int? = nil, isSlate: Bool = false, integration: THEOplayerSDK.AdIntegrationKind, duration: Int? = 0, clickThrough: String?, customIntegration: String?) {
         self.adBreak = adBreak
         self.companions = companions
@@ -51,11 +51,11 @@ class NativeAd: THEOplayerSDK.Ad {
 class NativeLinearAd: NativeAd, THEOplayerSDK.LinearAd {
     /** An array of mediafiles, which provides some meta data retrieved from the VAST file.*/
     var mediaFiles: [THEOplayerSDK.MediaFile] = []
-    
+
     init(adBreak: AdBreak, companions: [THEOplayerSDK.CompanionAd], type: String, id: String? = nil, skipOffset: Int? = nil, resourceURI: String? = nil, width: Int? = nil, height: Int? = nil, integration: THEOplayerSDK.AdIntegrationKind, duration: Int? = 0, clickThrough: String? = nil, customIntegration: String? = nil, mediaFiles: [THEOplayerSDK.MediaFile] = []) {
-        
+
         self.mediaFiles = mediaFiles
-        
+
         super.init(adBreak:adBreak,
                    companions: companions,
                    type: type,
@@ -88,7 +88,7 @@ class NativeLinearGoogleImaAd: NativeLinearAd, THEOplayerSDK.GoogleImaAd {
     var universalAdIds: [UniversalAdId] = []
     /** The String representing custom trafficking parameters from the VAST response.*/
     var traffickingParameters: String = ""
-    
+
     init(adBreak: AdBreak, companions: [THEOplayerSDK.CompanionAd], type: String, id: String? = nil, skipOffset: Int? = nil, resourceURI: String? = nil, width: Int? = nil, height: Int? = nil, integration: THEOplayerSDK.AdIntegrationKind, duration: Int? = 0, clickThrough: String? = nil, customIntegration: String? = nil, mediaFiles: [THEOplayerSDK.MediaFile] = [], adSystem: String? = nil, creativeId: String? = nil, wrapperAdIds: [String], wrapperAdSystems: [String], wrapperCreativeIds: [String], vastMediaBitrate: Int, universalAdIds: [UniversalAdId], traffickingParameters: String) {
         self.adSystem = adSystem
         self.creativeId = creativeId
@@ -98,7 +98,7 @@ class NativeLinearGoogleImaAd: NativeLinearAd, THEOplayerSDK.GoogleImaAd {
         self.vastMediaBitrate = vastMediaBitrate
         self.universalAdIds = universalAdIds
         self.traffickingParameters = traffickingParameters
-        
+
         super.init(adBreak: adBreak,
                    companions: companions,
                    type: type,
@@ -134,8 +134,8 @@ class NativeAdBreak: THEOplayerSDK.AdBreak {
        - For other integrations, this may be `nil`.
     */
    var id: String? = nil
-    
-    init(ads: [Ad], maxDuration: Int, maxRemainingDuration: Double, timeOffset: Int, integration: THEOplayerSDK.AdIntegrationKind, customIntegration: String? = nil, id: String? = nil) {
+
+    init(ads: [Ad], id: String? = nil, maxDuration: Int, maxRemainingDuration: Double, timeOffset: Int, integration: THEOplayerSDK.AdIntegrationKind, customIntegration: String? = nil) {
         self.ads = ads
         self.maxDuration = maxDuration
         self.maxRemainingDuration = maxRemainingDuration
@@ -161,7 +161,7 @@ class NativeCompanionAd: THEOplayerSDK.CompanionAd {
     var width: Int
     /** The type of the companion ad.*/
     var type: String = ""
-    
+
     init(adSlotId: String? = nil, altText: String? = nil, clickThrough: String? = nil, height: Int, resourceURI: String? = nil, width: Int, type: String) {
         self.adSlotId = adSlotId
         self.altText = altText
@@ -178,7 +178,7 @@ class NativeUniversalAdId: THEOplayerSDK.UniversalAdId {
     var adIdValue: String = ""
     /** The registry associated with cataloging the UniversalAdId of the selected creative for the ad.*/
     var adIdRegistry: String = ""
-    
+
     init(adIdValue: String, adIdRegistry: String) {
         self.adIdValue = adIdValue
         self.adIdRegistry = adIdRegistry

package/lib/commonjs/api/event/PlayerEvent.js

@@ -125,6 +125,13 @@ let PresentationModeChangePipContext = exports.PresentationModeChangePipContext
  * @category Player
  * @public
  */
+/**
+ * Dispatched when the current source, which is chosen from the source description's sources, changes.
+ *
+ * @category Events
+ * @category Player
+ * @public
+ */
 /**
  * Dispatched when the player has finished seeking to a new position.
  *

package/lib/commonjs/api/event/PlayerEvent.js.map

@@ -1 +1 @@
-{"version":3,"names":["PresentationModeChangePipContext","exports"],"sourceRoot":"../../../../src","sources":["api/event/PlayerEvent.ts"],"mappings":";;;;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,gCAAgC,GAAAC,OAAA,CAAAD,gCAAA,0BAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAA,OAAhCA,gCAAgC;AAAA;AAmB5C;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["PresentationModeChangePipContext","exports"],"sourceRoot":"../../../../src","sources":["api/event/PlayerEvent.ts"],"mappings":";;;;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,gCAAgC,GAAAC,OAAA,CAAAD,gCAAA,0BAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAhCA,gCAAgC;EAAA,OAAhCA,gCAAgC;AAAA;AAmB5C;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/player/PlayerEventMap.js

@@ -16,6 +16,7 @@ let PlayerEventType = exports.PlayerEventType = /*#__PURE__*/function (PlayerEve
   PlayerEventType["CANPLAY"] = "canplay";
   PlayerEventType["PLAYING"] = "playing";
   PlayerEventType["SOURCE_CHANGE"] = "sourcechange";
+  PlayerEventType["CURRENT_SOURCE_CHANGE"] = "currentsourcechange";
   PlayerEventType["LOAD_START"] = "loadstart";
   PlayerEventType["LOADED_METADATA"] = "loadedmetadata";
   PlayerEventType["LOADED_DATA"] = "loadeddata";

package/lib/commonjs/api/player/PlayerEventMap.js.map

@@ -1 +1 @@
-{"version":3,"names":["PlayerEventType","exports"],"sourceRoot":"../../../../src","sources":["api/player/PlayerEventMap.ts"],"mappings":";;;;;;AAwBA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAuC3B;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["PlayerEventType","exports"],"sourceRoot":"../../../../src","sources":["api/player/PlayerEventMap.ts"],"mappings":";;;;;;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAwC3B;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}