react-native-theoplayer 9.5.0 → 9.7.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.7.0] - 25-07-01
+
+### Added
+
+- Added the theolive discoveryUrl to the PlayerConfiguration's theolive properties.
+- Added focusguides (@THEOplayer/react-native-ui feature) to the example app for tvOS.
+
+## [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

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"
+// The minimum supported THEOplayer version is 9.6.0
+def theoVersion = safeExtGet('THEOplayer_sdk', '[9.6.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"
@@ -39,6 +40,7 @@ private const val PROP_ALLOWED_MIMETYPES = "allowedMimeTypes"
 private const val PROP_THEOLIVE_CONFIG = "theoLive"
 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"
 
 class PlayerConfigAdapter(private val configProps: ReadableMap?) {
@@ -176,6 +178,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)
+        }
       }
     }
   }
@@ -219,7 +225,8 @@ class PlayerConfigAdapter(private val configProps: ReadableMap?) {
       externalSessionId = config?.getString(PROP_THEOLIVE_EXTERNAL_SESSION_ID),
       analyticsDisabled = if (config?.hasKey(PROP_THEOLIVE_ANALYTICS_DISABLED) == true)
         config.getBoolean(PROP_THEOLIVE_ANALYTICS_DISABLED)
-      else false
+      else false,
+      discoveryUrl = config?.getString(PROP_THEOLIVE_DISCOVERY_URL)
     ).build()
   }
 }

package/ios/THEOplayerRCTBridge.m

@@ -266,3 +266,18 @@ RCT_EXTERN_METHOD(broadcastEvent:(nonnull NSNumber *)node
                   event:(NSDictionary)event)
 
 @end
+
+// ----------------------------------------------------------------------------
+// THEOlive Module
+// ----------------------------------------------------------------------------
+@interface RCT_EXTERN_REMAP_MODULE(THEORCTTHEOliveModule, THEOplayerRCTTHEOliveAPI, NSObject)
+
+RCT_EXTERN_METHOD(currentLatency:(nonnull NSNumber *)node
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(latencies:(nonnull NSNumber *)node
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/THEOplayerRCTDebug.swift

@@ -45,5 +45,8 @@ let DEBUG_CACHE_EVENTS = DEBUG && false
 // Debug flag to monitor cache API usage
 let DEBUG_CACHE_API = DEBUG && false
 
+// Debug flag to monitor theolive API usage
+let DEBUG_THEOLIVE_API = DEBUG && false
+
 // Debug flag to monitor AudioSession interruptions (e.g. phone cll)
 let DEBUG_INTERRUPTIONS = DEBUG && false

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/ios/THEOplayerRCTView.swift

@@ -17,6 +17,9 @@ import THEOplayerGoogleCastIntegration
 #if canImport(THEOplayerMillicastIntegration)
 import THEOplayerMillicastIntegration
 #endif
+#if canImport(THEOplayerTHEOliveIntegration)
+import THEOplayerTHEOliveIntegration
+#endif
 
 public class THEOplayerRCTView: UIView {
     // MARK: Members
@@ -38,10 +41,11 @@ public class THEOplayerRCTView: UIView {
     var adsConfig = AdsConfig()
     var castConfig = CastConfig()
     var uiConfig = UIConfig()
+    var theoliveConfig = THEOliveConfig()
     
     // integrations
     #if canImport(THEOplayerTHEOadsIntegration)
-    var theoAdsIntegration: THEOplayerTHEOadsIntegration.THEOadsIntegration?
+    var THEOadsIntegration: THEOplayerTHEOadsIntegration.THEOadsIntegration?
     #endif
     #if canImport(THEOplayerGoogleIMAIntegration)
     var imaIntegration: THEOplayerGoogleIMAIntegration.GoogleImaIntegration?
@@ -52,6 +56,9 @@ public class THEOplayerRCTView: UIView {
     #if canImport(THEOplayerMillicastIntegration)
     var millicastIntegration: THEOplayerMillicastIntegration.MillicastIntegration?
     #endif
+    #if canImport(THEOplayerTHEOliveIntegration)
+    var THEOliveIntegration: THEOplayerTHEOliveIntegration.THEOliveIntegration?
+    #endif
 
     var mediaControlConfig = MediaControlConfig() {
         didSet {
@@ -178,7 +185,8 @@ public class THEOplayerRCTView: UIView {
         
         self.initAdsIntegration()
         self.initCastIntegration()
-        self.initTheoAdsIntegration()
+        self.initTHEOadsIntegration()
+        self.initTHEOliveIntegration()
         self.initMillicastIntegration()
         self.initBackgroundAudio()
         self.initPip()
@@ -205,6 +213,7 @@ public class THEOplayerRCTView: UIView {
         self.parseCastConfig(configDict: configDict)
         self.parseUIConfig(configDict: configDict)
         self.parseMediaControlConfig(configDict: configDict)
+        self.parseTHEOliveConfig(configDict: configDict)
         if DEBUG_VIEW { PrintUtils.printLog(logText: "[NATIVE] config prop updated.") }
         
         // Given the bridged config, create the initial THEOplayer instance

package/ios/ads/THEOplayerRCTSourceDescriptionBuilder+Ads.swift

@@ -56,7 +56,7 @@ extension THEOplayerRCTSourceDescriptionBuilder {
             case "google-ima":
                 return THEOplayerRCTSourceDescriptionBuilder.buildSingleGoogleIMAAdsDescription(adsData)
             case "theoads":
-                return THEOplayerRCTSourceDescriptionBuilder.buildSingleTheoAdsDescription(adsData)
+                return THEOplayerRCTSourceDescriptionBuilder.buildSingleTHEOadsDescription(adsData)
             default:
                 if DEBUG_SOURCE_DESCRIPTION_BUIDER  { PrintUtils.printLog(logText: "[NATIVE] We currently require and only support the 'google-ima' or 'sgai' integration in the 'ads' description.") }
             }

package/ios/theoAds/THEOplayerRCTSourceDescriptionBuilder+TheoAds.swift

@@ -1,4 +1,4 @@
-// THEOplayerRCTSourceDescriptionBuilder+TheoAds.swift
+// THEOplayerRCTSourceDescriptionBuilder+THEOads.swift
 
 import Foundation
 import THEOplayerSDK
@@ -14,7 +14,7 @@ extension THEOplayerRCTSourceDescriptionBuilder {
      Creates a THEOplayer GoogleImaAdDescription. This requires an ads property in the RN source description.
      - returns: a THEOplayer GoogleImaAdDescription
      */
-    static func buildSingleTheoAdsDescription(_ adsData: [String:Any]) -> AdDescription? {
+    static func buildSingleTHEOadsDescription(_ adsData: [String:Any]) -> AdDescription? {
 #if canImport(THEOplayerTHEOadsIntegration)
         //...
         let networkCode = adsData[SD_PROP_NETWORK_CODE] as? String

package/ios/theoAds/THEOplayerRCTView+TheoAds.swift

@@ -1,4 +1,4 @@
-// THEOplayerRCTView+TheoAds.swift
+// THEOplayerRCTView+THEOads.swift
 
 import Foundation
 import THEOplayerSDK
@@ -8,15 +8,15 @@ import THEOplayerTHEOadsIntegration
 #endif
 
 extension THEOplayerRCTView {
-    func initTheoAdsIntegration() {
+    func initTHEOadsIntegration() {
         guard let player = self.player else {
             return
         }
         
 #if canImport(THEOplayerTHEOadsIntegration)
         // setup integration
-      self.theoAdsIntegration = THEOadsIntegrationFactory.createIntegration(on: player)
-      player.addIntegration(self.theoAdsIntegration!)
+      self.THEOadsIntegration = THEOadsIntegrationFactory.createIntegration(on: player)
+      player.addIntegration(self.THEOadsIntegration!)
 #endif
         
     }

package/ios/theolive/THEOplayerRCTTHEOliveAPI.swift

@@ -0,0 +1,85 @@
+//
+//  THEOplayerRCTTHEOliveAPI.swift
+//  Theoplayer
+//
+import Foundation
+
+#if canImport(THEOplayerTHEOliveIntegration)
+import THEOplayerTHEOliveIntegration
+#endif
+
+let ERROR_MESSAGE_THEOLIVE_UNSUPPORTED_FEATURE = "This functionality is not supported by the provided iOS SDKs"
+let ERROR_CODE_THEOLIVE_ACCESS_FAILURE = "theolive_access_failure"
+let ERROR_MESSAGE_THEOLIVE_ACCESS_FAILURE = "Could not access THEOplayer THEOlive Module"
+
+@objc(THEOplayerRCTTHEOliveAPI)
+class THEOplayerRCTTHEOliveAPI: NSObject, RCTBridgeModule {
+    @objc var bridge: RCTBridge!
+
+    static func moduleName() -> String! {
+        return "THEORCTTHEOliveModule"
+    }
+
+    static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+
+#if canImport(THEOplayerTHEOliveIntegration)
+    @objc(currentLatency:resolver:rejecter:)
+    func currentLatency(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        DispatchQueue.main.async {
+            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
+               let player = theView.player,
+               let theolive = player.theoLive {
+                var foundLatency: Double = -1
+                /*if let currentLatency = theolive.currentLatency {
+                    foundLatency = currentLatency
+                }*/
+                resolve(foundLatency)
+            } else {
+                if DEBUG_THEOLIVE_API { PrintUtils.printLog(logText: "[NATIVE] Could not get currentLatency (THEOlive module unavailable).") }
+                reject(ERROR_CODE_THEOLIVE_ACCESS_FAILURE, ERROR_MESSAGE_THEOLIVE_ACCESS_FAILURE, nil)
+            }
+        }
+    }
+    
+    @objc(latencies:resolver:rejecter:)
+    func latencies(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        DispatchQueue.main.async {
+            if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView,
+               let player = theView.player,
+               let theolive = player.theoLive {
+                var foundLatencies: [String:Any] = [:]
+                /*if let latencies = theolive.latencies {
+                    foundLatencies = [
+                        "engineLatency": latencies.engineLatency,
+                        "distributionLatency": latencies.distributionLatency,
+                        "playerLatency": latencies.playerLatency,
+                        "theoliveLatency": latencies.theoliveLatency
+                    ]
+                }*/
+                resolve(foundLatencies)
+            } else {
+                if DEBUG_THEOLIVE_API { PrintUtils.printLog(logText: "[NATIVE] Could not get latencies (THEOlive module unavailable).") }
+                reject(ERROR_CODE_THEOLIVE_ACCESS_FAILURE, ERROR_MESSAGE_THEOLIVE_ACCESS_FAILURE, nil)
+            }
+        }
+    }
+
+#else
+
+    @objc(currentLatency:resolver:rejecter:)
+    func currentLatency(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        if DEBUG_THEOLIVE_API { print(ERROR_MESSAGE_THEOLIVE_UNSUPPORTED_FEATURE) }
+        reject(ERROR_CODE_THEOLIVE_ACCESS_FAILURE, ERROR_MESSAGE_THEOLIVE_ACCESS_FAILURE, nil)
+    }
+
+    @objc(latencies:resolver:rejecter:)
+    func latencies(_ node: NSNumber, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) -> Void {
+        if DEBUG_THEOLIVE_API { print(ERROR_MESSAGE_THEOLIVE_UNSUPPORTED_FEATURE) }
+        reject(ERROR_CODE_THEOLIVE_ACCESS_FAILURE, ERROR_MESSAGE_THEOLIVE_ACCESS_FAILURE, nil)
+    }
+
+#endif
+
+}