react-native-theoplayer 9.4.0 → 9.6.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ 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).
 
+## [9.6.0] - 25-06-27
+
+### Added
+
+- Added, for HLS on iOS, the `unlocalizedLabel` to the text-, audio- and videoTracks API, which contains the unmodified label as extracted from the manifest.
+- Added a flag `focusSkipButtonWhenAvailable` to `GoogleImaConfiguration`.
+
+## [9.5.0] - 25-06-20
+
+### Added
+
+- Added Expo plugin support for iOS. More info on the [documentation](./doc/expo.md) page.
+- Added `currentProgramDateTime` to player API.
+
+### Fixed
+
+- Fixed an issue where a delayed `PresentationModeChange` event on Android could cause lay-out issues when going in to fullscreen mode.
+
 ## [9.4.0] - 25-06-12
 
 ### Fixed

package/README.md

@@ -174,15 +174,16 @@ This section gives an overview of features, limitations and known issues:
 
 - [Adaptive Bitrate (ABR)](./doc/abr.md)
 - [Advertisements](./doc/ads.md)
-- [Android Media3 Pipeline🔥](./doc/media3.md)
+- [Android Media3 Pipeline](./doc/media3.md)
 - [Audio Control Management](./doc/audio-control.md)
 - [Background playback and notifications](./doc/background.md)
 - [Casting with Chromecast and Airplay](./doc/cast.md)
 - [Common Media Client Data (CMCD)](./doc/cmcd.md)
 - [Digital Rights Management (DRM)](./doc/drm.md)
+- [Expo🔥](./doc/expo.md)
 - [Fullscreen presentation](./doc/fullscreen.md)
 - [Media Caching](./doc/media-caching.md)
-- [Migrating to THEOplayer 9.x🔥](./doc/migrating-to-react-native-theoplayer-9.md)
+- [Migrating to THEOplayer 9.x](./doc/migrating-to-react-native-theoplayer-9.md)
 - [Millicast](./doc/millicast.md)
 - [Picture-in-Picture (PiP)](./doc/pip.md)
 - [Subtitles, Closed Captions and Metadata tracks](./doc/texttracks.md)

package/android/build.gradle

@@ -1,36 +1,36 @@
 buildscript {
-  ext.safeExtGet = { prop, fallback ->
-    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
-  }
+    ext.safeExtGet = { prop, fallback ->
+        rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
 
-  repositories {
-    google()
-    mavenCentral()
-  }
+    repositories {
+        google()
+        mavenCentral()
+    }
 
-  dependencies {
-    classpath "com.android.tools.build:gradle:${safeExtGet('gradlePluginVersion', '8.3.2')}"
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${safeExtGet('kotlinVersion', '1.9.21')}"
-  }
+    dependencies {
+        classpath "com.android.tools.build:gradle:${safeExtGet('gradlePluginVersion', '8.3.2')}"
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${safeExtGet('kotlinVersion', '1.9.21')}"
+    }
 }
 
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 
 def safeExtGet(prop, fallback) {
-  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
 }
 
 static def versionString(version) {
-  return "${version == '+' ? 'latest' : version}"
+    return "${version == '+' ? 'latest' : version}"
 }
 
 def isNewArchitectureEnabled() {
-  // To opt-in for the New Architecture, you can either:
-  // - Set `newArchEnabled` to true inside the `gradle.properties` file
-  // - Invoke gradle with `-newArchEnabled=true`
-  // - Set an environment variable `ORG_GRADLE_PROJECT_newArchEnabled=true`
-  return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+    // To opt-in for the New Architecture, you can either:
+    // - Set `newArchEnabled` to true inside the `gradle.properties` file
+    // - Invoke gradle with `-newArchEnabled=true`
+    // - Set an environment variable `ORG_GRADLE_PROJECT_newArchEnabled=true`
+    return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
 }
 
 // Extensions
@@ -43,155 +43,125 @@ def enabledMediaSession = safeExtGet("THEOplayer_extensionMediaSession", 'true')
 def enabledMillicast = safeExtGet("THEOplayer_extensionMillicast", 'false').toBoolean()
 
 android {
-  compileSdk safeExtGet('THEOplayer_compileSdkVersion', 34)
-  namespace "com.theoplayer"
-
-  defaultConfig {
-    minSdkVersion safeExtGet('THEOplayer_minSdkVersion', 21)
-    targetSdkVersion safeExtGet('THEOplayer_targetSdkVersion', 34)
-    versionCode 1
-    versionName "1.0"
-
-    // Optionally limit timeUpdate rate. Possible values:
-    // - "com.theoplayer.TimeUpdateRate.UNLIMITED"
-    // - "com.theoplayer.TimeUpdateRate.LIMITED_ONE_HZ"
-    // - "com.theoplayer.TimeUpdateRate.LIMITED_TWO_HZ"
-    // - "com.theoplayer.TimeUpdateRate.LIMITED_THREE_HZ"
-    def TimeUpdateRate = "com.theoplayer.TimeUpdateRate"
-    buildConfigField TimeUpdateRate, "TIMEUPDATE_RATE", safeExtGet('THEOplayer_timeUpdateRate', "${TimeUpdateRate}.UNLIMITED")
-
-    // Optionally re-parent player view on fullscreen or PiP event
-    buildConfigField "boolean", "REPARENT_ON_FULLSCREEN", "${safeExtGet('THEOplayer_reparent_on_fullscreen', 'true')}"
-    buildConfigField "boolean", "REPARENT_ON_PIP", "${safeExtGet('THEOplayer_reparent_on_PiP', 'false')}"
-
-    // Optionally log events to logcat
-    buildConfigField "boolean", "LOG_PLAYER_EVENTS", "${safeExtGet('THEOplayer_logPlayerEvents', 'false')}"
-    buildConfigField "boolean", "LOG_VIEW_EVENTS", "${safeExtGet('THEOplayer_logViewEvents', 'false')}"
-    buildConfigField "boolean", "LOG_MEDIASESSION_EVENTS", "${safeExtGet('THEOplayer_logMediaSessionEvents', 'false')}"
-    buildConfigField "boolean", "USE_PLAYBACK_SERVICE", "${safeExtGet('THEOplayer_usePlaybackService', 'true')}"
-
-    // Extension buildConfig fields
-    buildConfigField "boolean", "EXTENSION_GOOGLE_IMA", "${enabledGoogleIMA}"
-    buildConfigField "boolean", "EXTENSION_GOOGLE_DAI", "${enabledGoogleDAI}"
-    buildConfigField "boolean", "EXTENSION_THEOADS", "${enabledTHEOads}"
-    buildConfigField "boolean", "EXTENSION_ADS", "${enabledAds}"
-    buildConfigField "boolean", "EXTENSION_CAST", "${enabledCast}"
-    buildConfigField "boolean", "EXTENSION_MEDIASESSION", "${enabledMediaSession}"
-    buildConfigField "boolean", "EXTENSION_MILLICAST", "${enabledMillicast}"
-
-    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
-
-    consumerProguardFiles 'proguard-rules.pro'
-  }
-
-  buildTypes {
-    debug {
-      minifyEnabled false
+    compileSdk safeExtGet('THEOplayer_compileSdkVersion', 34)
+    namespace "com.theoplayer"
+
+    defaultConfig {
+        minSdkVersion safeExtGet('THEOplayer_minSdkVersion', 21)
+        targetSdkVersion safeExtGet('THEOplayer_targetSdkVersion', 34)
+        versionCode 1
+        versionName "1.0"
+
+        // Optionally limit timeUpdate rate. Possible values:
+        // - "com.theoplayer.TimeUpdateRate.UNLIMITED"
+        // - "com.theoplayer.TimeUpdateRate.LIMITED_ONE_HZ"
+        // - "com.theoplayer.TimeUpdateRate.LIMITED_TWO_HZ"
+        // - "com.theoplayer.TimeUpdateRate.LIMITED_THREE_HZ"
+        def TimeUpdateRate = "com.theoplayer.TimeUpdateRate"
+        buildConfigField TimeUpdateRate, "TIMEUPDATE_RATE", safeExtGet('THEOplayer_timeUpdateRate', "${TimeUpdateRate}.UNLIMITED")
+
+        // Optionally re-parent player view on fullscreen or PiP event
+        buildConfigField "boolean", "REPARENT_ON_FULLSCREEN", "${safeExtGet('THEOplayer_reparent_on_fullscreen', 'true')}"
+        buildConfigField "boolean", "REPARENT_ON_PIP", "${safeExtGet('THEOplayer_reparent_on_PiP', 'false')}"
+
+        // Optionally log events to logcat
+        buildConfigField "boolean", "LOG_PLAYER_EVENTS", "${safeExtGet('THEOplayer_logPlayerEvents', 'false')}"
+        buildConfigField "boolean", "LOG_VIEW_EVENTS", "${safeExtGet('THEOplayer_logViewEvents', 'false')}"
+        buildConfigField "boolean", "LOG_MEDIASESSION_EVENTS", "${safeExtGet('THEOplayer_logMediaSessionEvents', 'false')}"
+        buildConfigField "boolean", "USE_PLAYBACK_SERVICE", "${safeExtGet('THEOplayer_usePlaybackService', 'true')}"
+
+        // Extension buildConfig fields
+        buildConfigField "boolean", "EXTENSION_GOOGLE_IMA", "${enabledGoogleIMA}"
+        buildConfigField "boolean", "EXTENSION_GOOGLE_DAI", "${enabledGoogleDAI}"
+        buildConfigField "boolean", "EXTENSION_THEOADS", "${enabledTHEOads}"
+        buildConfigField "boolean", "EXTENSION_ADS", "${enabledAds}"
+        buildConfigField "boolean", "EXTENSION_CAST", "${enabledCast}"
+        buildConfigField "boolean", "EXTENSION_MEDIASESSION", "${enabledMediaSession}"
+        buildConfigField "boolean", "EXTENSION_MILLICAST", "${enabledMillicast}"
+
+        buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+
+        consumerProguardFiles 'proguard-rules.pro'
+    }
+
+    buildTypes {
+        debug {
+            minifyEnabled false
+        }
+        release {
+            minifyEnabled false
+        }
+    }
+    lint {
+        disable 'GradleCompatible'
     }
-    release {
-      minifyEnabled false
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+    packagingOptions {
+        exclude 'META-INF/kotlin-stdlib.kotlin_module'
+        exclude 'META-INF/annotation-experimental_release.kotlin_module'
     }
-  }
-  lint {
-    disable 'GradleCompatible'
-  }
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_1_8
-    targetCompatibility JavaVersion.VERSION_1_8
-  }
-  packagingOptions {
-    exclude 'META-INF/kotlin-stdlib.kotlin_module'
-    exclude 'META-INF/annotation-experimental_release.kotlin_module'
-  }
 }
 
+// Make sure all subprojects can resolve THEOplayer modules
 rootProject.allprojects {
-  repositories {
-    mavenLocal()
-    maven { url "https://maven.theoplayer.com/releases" }
-    maven { url "https://maven.theoplayer.com/snapshots" }
-    maven { url("$rootDir/../node_modules/react-native-theoplayer/android/local") }
-  }
+    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()
+    }
 }
 
 repositories {
-  mavenLocal()
-  maven {
-    // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
-    url("$rootDir/../node_modules/react-native/android")
-  }
-  google()
-  mavenCentral()
-  maven { url("local") }
-  maven { url "https://maven.theoplayer.com/releases" }
+    google()
+    mavenCentral()
 }
 
 // The minimum supported THEOplayer version is 9.5.0
-def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[9.5.0, 10.0.0)')
-def theoplayer_mediasession_version = safeExtGet('THEOplayer_mediasession', '[8.0.0, 10.0.0)')
-def theoplayer_ads_wrapper_version = "9.0.0"
+def theoVersion = safeExtGet('THEOplayer_sdk', '[9.5.0, 10.0.0)')
+def theoMediaSessionVersion = safeExtGet('THEOplayer_mediasession', '[8.0.0, 10.0.0)')
+def theoAdsWrapperVersion = "9.0.0"
+def coroutinesVersion = safeExtGet('coroutinesVersion', '1.7.3')
+def appcompatVersion = safeExtGet('appcompatVersion', '1.7.1')
+def corektxVersion = safeExtGet('corektxVersion', '1.13.1')
+def gsonVersion = "2.12.1"
+def millicastVersion = safeExtGet('millicastVersion', '2.0.0')
 
 dependencies {
-  //noinspection GradleDynamicVersion
-  implementation "com.facebook.react:react-native:+"  // From node_modules
-  implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:${safeExtGet('coroutinesVersion', '1.7.3')}"
-  implementation "androidx.appcompat:appcompat:${safeExtGet('appcompatVersion', '1.6.1')}"
-  implementation "androidx.core:core-ktx:${safeExtGet('corektxVersion', '1.13.1')}"
-  implementation "com.google.code.gson:gson:2.11.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:$theoplayer_ads_wrapper_version"
-  implementation "com.theoplayer.android-connector:mediasession:$theoplayer_mediasession_version"
-
-  if (enabledGoogleIMA) {
-    println('Enable THEOplayer IMA extension.')
-    implementation "com.theoplayer.theoplayer-sdk-android:integration-ads-ima:$theoplayer_sdk_version"
-  } else {
-    println('Disable THEOplayer IMA extension.')
-    compileOnly "com.theoplayer.theoplayer-sdk-android:integration-ads-ima:$theoplayer_sdk_version"
-  }
-
-  if (enabledGoogleDAI) {
-    println('Enable THEOplayer DAI extension.')
-    implementation "com.theoplayer.theoplayer-sdk-android:integration-ads-dai:$theoplayer_sdk_version"
-  } else {
-    println('Disable THEOplayer DAI extension.')
-    compileOnly "com.theoplayer.theoplayer-sdk-android:integration-ads-dai:$theoplayer_sdk_version"
-  }
-
-  if (enabledTHEOads) {
-    println('Enable THEOplayer THEOads extension.')
-    implementation "com.theoplayer.theoplayer-sdk-android:integration-ads-theoads:$theoplayer_sdk_version"
-  } else {
-    println('Disable THEOplayer THEOads extension.')
-    compileOnly "com.theoplayer.theoplayer-sdk-android:integration-ads-theoads:$theoplayer_sdk_version"
-  }
-
-  if (enabledCast) {
-    println('Enable THEOplayer cast extension.')
-    implementation "com.theoplayer.theoplayer-sdk-android:integration-cast:$theoplayer_sdk_version"
-  } else {
-    println('Disable THEOplayer cast extension.')
-    compileOnly "com.theoplayer.theoplayer-sdk-android:integration-cast:$theoplayer_sdk_version"
-  }
-
-  if (enabledMillicast) {
-    println('Enable THEOplayer millicast extension.')
-    implementation "com.theoplayer.theoplayer-sdk-android:integration-millicast:${theoplayer_sdk_version}"
-    implementation "com.millicast:millicast-sdk-android:2.0.0"
-  } else {
-    println('Disable THEOplayer millicast extension.')
-    compileOnly "com.theoplayer.theoplayer-sdk-android:integration-millicast:${theoplayer_sdk_version}"
-    compileOnly "com.millicast:millicast-sdk-android:2.0.0"
-  }
-}
+    def addOptiViewIntegration = { enabled, notation, additional = null ->
+        if (enabled) {
+            println("Enable $notation.")
+            implementation("com.theoplayer.theoplayer-sdk-android:$notation:$theoVersion") {
+                version {
+                    strictly theoVersion
+                }
+            }
+            if (additional) implementation "$additional"
+        } else {
+            println("Disable $notation.")
+            compileOnly("com.theoplayer.theoplayer-sdk-android:$notation:$theoVersion")
+            if (additional) compileOnly "$additional"
+        }
+    }
 
-// Make sure to align all ads extension versions
-configurations.configureEach {
-  resolutionStrategy {
-    force "com.theoplayer.theoplayer-sdk-android:integration-ads-ima:$theoplayer_sdk_version"
-    force "com.theoplayer.theoplayer-sdk-android:integration-ads-dai:$theoplayer_sdk_version"
-    force "com.theoplayer.theoplayer-sdk-android:integration-ads-theoads:$theoplayer_sdk_version"
-  }
+    //noinspection GradleDynamicVersion
+    implementation("com.facebook.react:react-native:+")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutinesVersion")
+    implementation("androidx.appcompat:appcompat:$appcompatVersion")
+    implementation("androidx.core:core-ktx:$corektxVersion")
+    implementation("com.google.code.gson:gson:$gsonVersion")
+
+    println("Using THEOplayer (${versionString(theoVersion)})")
+    implementation("com.theoplayer.theoplayer-sdk-android:core:$theoVersion")
+    implementation("com.theoplayer.theoplayer-sdk-android:ads-wrapper:$theoAdsWrapperVersion")
+    implementation("com.theoplayer.android-connector:mediasession:$theoMediaSessionVersion")
+
+    addOptiViewIntegration(enabledGoogleIMA || enabledGoogleDAI || enabledTHEOads, 'integration-ads-ima')
+    addOptiViewIntegration(enabledGoogleDAI || enabledTHEOads, 'integration-ads-dai')
+    addOptiViewIntegration(enabledTHEOads, 'integration-ads-theoads')
+    addOptiViewIntegration(enabledCast, 'integration-cast')
+    addOptiViewIntegration(enabledMillicast, 'integration-millicast', "com.millicast:millicast-sdk-android:$millicastVersion")
 }

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

@@ -27,6 +27,7 @@ private const val PROP_CAST_CONFIGURATION = "cast"
 private const val PROP_ADS_CONFIGURATION = "ads"
 private const val PROP_IMA_CONFIGURATION = "ima"
 private const val PROP_IMA_AD_LOAD_TIMEOUT = "adLoadTimeout"
+private const val PROP_IMA_FOCUS_SKIP_BUTTON_WHEN_AVAILABLE = "focusSkipButtonWhenAvailable"
 private const val PROP_MEDIA_CONTROL = "mediaControl"
 private const val PROP_PPID = "ppid"
 private const val PROP_MAX_REDIRECTS = "maxRedirects"
@@ -176,6 +177,10 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
         if (hasKey(PROP_IMA_AD_LOAD_TIMEOUT)) {
           setLoadVideoTimeout(getInt(PROP_IMA_AD_LOAD_TIMEOUT) * 1000)
         }
+
+        if (hasKey(PROP_IMA_FOCUS_SKIP_BUTTON_WHEN_AVAILABLE)) {
+          focusSkipButtonWhenAvailable = getBoolean(PROP_IMA_FOCUS_SKIP_BUTTON_WHEN_AVAILABLE)
+        }
       }
     }
   }

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

@@ -228,10 +228,7 @@ class PresentationManager(
         hide(WindowInsetsCompat.Type.systemBars())
       }
 
-      // Delay the event making sure it does not arrive before animations ended.
-      viewCtx.playerView.postOnAnimation {
-        updatePresentationMode(PresentationMode.FULLSCREEN)
-      }
+      updatePresentationMode(PresentationMode.FULLSCREEN)
 
       if (BuildConfig.REPARENT_ON_FULLSCREEN) {
         reparentPlayerToRoot()

package/ios/THEOplayerRCTTrackMetadataAggregator.swift

@@ -16,6 +16,7 @@ let PROP_KIND: String = "kind"
 let PROP_LANGUAGE: String = "language"
 let PROP_MODE: String = "mode"
 let PROP_LABEL: String = "label"
+let PROP_UNLOCALIZED_LABEL: String = "unlocalizedLabel"
 let PROP_ENABLED: String = "enabled"
 let PROP_TYPE: String = "type"
 let PROP_QUALITIES: String = "qualities"
@@ -73,6 +74,7 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_LANGUAGE] = textTrack.language
         entry[PROP_MODE] = textTrack.mode._rawValue
         entry[PROP_LABEL] = textTrack.label
+        entry[PROP_UNLOCALIZED_LABEL] = textTrack.unlocalizedLabel
         entry[PROP_TYPE] = textTrack.type
         entry[PROP_SRC] = textTrack.src
         entry[PROP_FORCED] = textTrack.forced
@@ -175,6 +177,7 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_KIND] = audioTrack.kind
         entry[PROP_LANGUAGE] = audioTrack.language
         entry[PROP_LABEL] = audioTrack.label
+        entry[PROP_UNLOCALIZED_LABEL] = audioTrack.unlocalizedLabel
         entry[PROP_ENABLED] = audioTrack.enabled
         entry[PROP_QUALITIES] = []          // empty: qualities are not being exposed on iOS
         //entry[PROP_ACTIVE_QUALITY] =      // undefined: qualities are not being exposed on iOS
@@ -216,6 +219,7 @@ class THEOplayerRCTTrackMetadataAggregator {
         entry[PROP_KIND] = videoTrack.kind
         entry[PROP_LANGUAGE] = videoTrack.language
         entry[PROP_LABEL] = videoTrack.label
+        entry[PROP_UNLOCALIZED_LABEL] = videoTrack.unlocalizedLabel
         entry[PROP_ENABLED] = videoTrack.enabled
         entry[PROP_QUALITIES] = []          // empty: qualities are not being exposed on iOS
         //entry[PROP_ACTIVE_QUALITY] =      // undefined: qualities are not being exposed on iOS

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

@@ -10,6 +10,7 @@ exports.ABRStrategyType = void 0;
  * <br/> - `'quality'`: The player will optimize ABR behavior to focus displaying the best visual quality to the end-user. This strategy initiates playback with the highest bit rate suitable for the device.
  * <br/> - `'bandwidth'`: The player will optimize the ABR behavior to focus on displaying the most optimal quality based on historic data of available bandwidth and knowledge of the network conditions.
  *
+ * @category ABR
  * @public
  */
 let ABRStrategyType = exports.ABRStrategyType = /*#__PURE__*/function (ABRStrategyType) {
@@ -21,21 +22,25 @@ let ABRStrategyType = exports.ABRStrategyType = /*#__PURE__*/function (ABRStrate
 /**
  * Describes the metadata of the adaptive bitrate strategy.
  *
+ * @category ABR
  * @public
  */
 /**
  * Describes the configuration of the adaptive bitrate strategy.
  *
+ * @category ABR
  * @public
  */
 /**
  * The adaptive bitrate stratey.
  *
+ * @category ABR
  * @public
  */
 /**
  * Describes the adaptive bitrate configuration.
  *
+ * @category ABR
  * @public
  */
 //# sourceMappingURL=ABRConfiguration.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["ABRStrategyType","exports"],"sourceRoot":"../../../../src","sources":["api/abr/ABRConfiguration.ts"],"mappings":";;;;;;AAEA;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":[]}
+{"version":3,"names":["ABRStrategyType","exports"],"sourceRoot":"../../../../src","sources":["api/abr/ABRConfiguration.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AARA,IASYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAM3B;AACA;AACA;AACA;AACA;AACA;AAUA;AACA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/ads/Omid.js

@@ -4,6 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.OmidFriendlyObstructionPurpose = void 0;
+/**
+ * The list of reasons for which an obstruction would be registered as friendly.
+ *
+ * @category Ads
+ * @public
+ */
 let OmidFriendlyObstructionPurpose = exports.OmidFriendlyObstructionPurpose = /*#__PURE__*/function (OmidFriendlyObstructionPurpose) {
   OmidFriendlyObstructionPurpose["VIDEO_CONTROLS"] = "videoControls";
   OmidFriendlyObstructionPurpose["CLOSE_AD"] = "closeAd";
@@ -11,7 +17,16 @@ let OmidFriendlyObstructionPurpose = exports.OmidFriendlyObstructionPurpose = /*
   OmidFriendlyObstructionPurpose["OTHER"] = "other";
   return OmidFriendlyObstructionPurpose;
 }({});
+/**
+ * Represents a friendly obstruction instance for OMID.
+ *
+ * @category Ads
+ * @public
+ */
 /**
  * The Omid API, which can be used to add as well as remove friendly video controls overlay obstructions.
+ *
+ * @category Ads
+ * @public
  */
 //# sourceMappingURL=Omid.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["OmidFriendlyObstructionPurpose","exports"],"sourceRoot":"../../../../src","sources":["api/ads/Omid.ts"],"mappings":";;;;;;IAEYA,8BAA8B,GAAAC,OAAA,CAAAD,8BAAA,0BAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAAA,OAA9BA,8BAA8B;AAAA;AAyC1C;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["OmidFriendlyObstructionPurpose","exports"],"sourceRoot":"../../../../src","sources":["api/ads/Omid.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AALA,IAMYA,8BAA8B,GAAAC,OAAA,CAAAD,8BAAA,0BAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAA9BA,8BAA8B;EAAA,OAA9BA,8BAA8B;AAAA;AAsB1C;AACA;AACA;AACA;AACA;AACA;AAoBA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/cache/CachingTask.js

@@ -12,6 +12,7 @@ exports.CacheTaskStatus = void 0;
  * <br/> - `'error'`: The task has encountered an error while downloading or evicting content.
  * <br/> - `'evicted'`: All data associated with the task has been removed because the task expired or the user invoked the {@link CachingTask.remove|remove} method.
  *
+ * @category Caching
  * @public
  */
 let CacheTaskStatus = exports.CacheTaskStatus = /*#__PURE__*/function (CacheTaskStatus) {
@@ -25,6 +26,7 @@ let CacheTaskStatus = exports.CacheTaskStatus = /*#__PURE__*/function (CacheTask
 /**
  * Represents a caching task.
  *
+ * @category Caching
  * @public
  */
 //# sourceMappingURL=CachingTask.js.map

package/lib/commonjs/api/cache/CachingTask.js.map

@@ -1 +1 @@
-{"version":3,"names":["CacheTaskStatus","exports"],"sourceRoot":"../../../../src","sources":["api/cache/CachingTask.ts"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATA,IAUYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAQ3B;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["CacheTaskStatus","exports"],"sourceRoot":"../../../../src","sources":["api/cache/CachingTask.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAVA,IAWYA,eAAe,GAAAC,OAAA,CAAAD,eAAA,0BAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAfA,eAAe;EAAA,OAAfA,eAAe;AAAA;AAQ3B;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/cache/CachingTaskParameters.js

@@ -8,6 +8,8 @@ exports.StorageType = void 0;
  * The types of cache storage supported by THEOplayer.
  *
  * @platform android
+ * @category Caching
+ * @public
  */
 let StorageType = exports.StorageType = /*#__PURE__*/function (StorageType) {
   StorageType["LEGACY"] = "legacy";
@@ -17,6 +19,7 @@ let StorageType = exports.StorageType = /*#__PURE__*/function (StorageType) {
 /**
  * Describes the configuration of a caching task.
  *
+ * @category Caching
  * @public
  */
 //# sourceMappingURL=CachingTaskParameters.js.map

package/lib/commonjs/api/cache/CachingTaskParameters.js.map

@@ -1 +1 @@
-{"version":3,"names":["StorageType","exports"],"sourceRoot":"../../../../src","sources":["api/cache/CachingTaskParameters.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AAJA,IAKYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAqBvB;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["StorageType","exports"],"sourceRoot":"../../../../src","sources":["api/cache/CachingTaskParameters.ts"],"mappings":";;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAqBvB;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/cache/MediaCacheAPI.js

@@ -9,6 +9,7 @@ exports.CacheStatus = void 0;
  * <br/> - `'uninitialised'`: Previously stored caching tasks are unavailable.
  * <br/> - `'initialised'`: Previously stored caching tasks are now available.
  *
+ * @category Caching
  * @public
  */
 let CacheStatus = exports.CacheStatus = /*#__PURE__*/function (CacheStatus) {
@@ -19,6 +20,7 @@ let CacheStatus = exports.CacheStatus = /*#__PURE__*/function (CacheStatus) {
 /**
  * The media cache API.
  *
+ * @category Caching
  * @public
  */
 //# sourceMappingURL=MediaCacheAPI.js.map

package/lib/commonjs/api/cache/MediaCacheAPI.js.map

@@ -1 +1 @@
-{"version":3,"names":["CacheStatus","exports"],"sourceRoot":"../../../../src","sources":["api/cache/MediaCacheAPI.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAKvB;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["CacheStatus","exports"],"sourceRoot":"../../../../src","sources":["api/cache/MediaCacheAPI.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAPA,IAQYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;AAKvB;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/lib/commonjs/api/cache/events/CacheEvent.js

@@ -4,6 +4,13 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.CacheEventType = void 0;
+/**
+ * The event types dispatched by the {@link MediaCacheAPI | cache API}.
+ *
+ * @category Caching
+ * @category Events
+ * @public
+ */
 let CacheEventType = exports.CacheEventType = /*#__PURE__*/function (CacheEventType) {
   CacheEventType["statechange"] = "statechange";
   CacheEventType["addtask"] = "addtask";
@@ -13,16 +20,26 @@ let CacheEventType = exports.CacheEventType = /*#__PURE__*/function (CacheEventT
 /**
  * The events dispatched by the {@link MediaCacheAPI | cache API}.
  *
+ * @category Caching
+ * @category Events
+ * @public
+ */
+/**
+ * CacheStatusChangeEvent is dispatched when the status of a caching task is updated.
+ *
+ * @category Caching
  * @public
  */
 /**
- * Dispatched when a caching task is added.
+ * AddCachingTaskEvent is dispatched when a caching task is added.
  *
+ * @category Caching
  * @public
  */
 /**
- * Dispatched when a caching task is removed.
+ * RemoveCachingTaskEvent is dispatched when a caching task is removed.
  *
+ * @category Caching
  * @public
  */
 //# sourceMappingURL=CacheEvent.js.map

package/lib/commonjs/api/cache/events/CacheEvent.js.map

@@ -1 +1 @@
-{"version":3,"names":["CacheEventType","exports"],"sourceRoot":"../../../../../src","sources":["api/cache/events/CacheEvent.ts"],"mappings":";;;;;;IAIYA,cAAc,GAAAC,OAAA,CAAAD,cAAA,0BAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA;AAM1B;AACA;AACA;AACA;AACA;AAyBA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["CacheEventType","exports"],"sourceRoot":"../../../../../src","sources":["api/cache/events/CacheEvent.ts"],"mappings":";;;;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AANA,IAOYA,cAAc,GAAAC,OAAA,CAAAD,cAAA,0BAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA;AAM1B;AACA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA;AAQA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}