bitmovin-player-react-native 0.11.0 → 0.13.0

package/README.md

@@ -1,6 +1,6 @@
 # Bitmovin Player React Native
 
-Official React Native bindings for Bitmovin's mobile Player SDKs.
+This is an open-source project created to enable customers to integrate the Bitmovin mobile Player SDKs into React Native projects. It has been created to provide customers with a starting point, which can be built upon through active collaboration and contributions. We look forward to seeing this library expand and grow.
 
 [![Build](https://github.com/bitmovin/bitmovin-player-react-native/actions/workflows/ci.yml/badge.svg)](https://github.com/bitmovin/bitmovin-player-react-native/actions/workflows/ci.yml)
 ![Platforms](https://img.shields.io/badge/platforms-iOS%20%7C%20tvOS%20%7C%20Android%20%7C%20Android%20TV-lightgrey.svg)
@@ -10,17 +10,6 @@ Official React Native bindings for Bitmovin's mobile Player SDKs.
 [![npm dm](https://img.shields.io/npm/dm/bitmovin-player-react-native.svg)](https://www.npmjs.com/package/bitmovin-player-react-native)
 [![npm dt](https://img.shields.io/npm/dt/bitmovin-player-react-native.svg)](https://www.npmjs.com/package/bitmovin-player-react-native)
 
-> As the library is under active development, this means certain features from our native SDKs are not yet exposed through these React Native bindings.
-
-- [Bitmovin Player React Native](#bitmovin-player-react-native)
-  - [Platform Support](#platform-support)
-  - [Feature Support](#feature-support)
-  - [Documentation](#documentation)
-    - [Getting Started](#getting-started-guide)
-    - [Feature Guides](#feature-guides)
-    - [Sample Application](#sample-application)
-  - [Contributing](#contributing)
-
 ## Platform Support
 
 This library requires at least React Native 0.64+ and React 17+ to work properly. The currently supported platforms are:
@@ -39,6 +28,10 @@ Please refer to the [Features](https://developer.bitmovin.com/playback/docs/reac
 
 ## Documentation
 
+### API Reference
+
+Our API reference can be found [here](https://cdn.bitmovin.com/player/reactnative/0/docs/index.html).
+
 ### Getting Started Guide
 
 Our [Getting Started Guide](https://developer.bitmovin.com/playback/docs/getting-started-react-native) walks you through setting up and configuring the Bitmovin Player in React Native projects.
@@ -51,6 +44,26 @@ Check out our [React Native Guides](https://developer.bitmovin.com/playback/docs
 
 In the [/example/](https://github.com/bitmovin/bitmovin-player-react-native/tree/development/example) folder you can find a sample application showcasing many of the features of the Player React Native SDK.
 
-## Contributing
+## Maintenance and Updates
+
+As an open source project, this library is not part of a regular maintenance or update schedule and is updated on an adhoc basis when contributions are made.
+
+## Contributing to this project
+
+We are pleased to accept changes, updates and fixes from the community wishing to use and expand this project. Bitmovin will review any Pull Requests made. We do our best to provide timely feedback, but please note that no SLAs apply. New releases are tagged and published on our discretion. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more details on how to contribute.
+
+## Raising a Feature Suggestion
+
+If you see something missing that might be useful but are unable to contribute the feature yourself, please feel free to [submit a feature request](https://community.bitmovin.com/t/how-to-submit-a-feature-request-to-us/1463) through the Bitmovin Community. Feature suggestions will be considered by Bitmovin’s Product team for future roadmap plans.
+
+## Reporting a bug
+
+If you come across a bug related to the Player React Native SDK, please raise this through the support ticketing system accessible in your [Bitmovin Dashboard](https://dashboard.bitmovin.com/support/tickets).
+
+## Support and SLA Disclaimer
+
+As an open-source project and not a core product offering, any request, issue or query related to this project is excluded from any SLA and Support terms that a customer might have with either Bitmovin or another third-party service provider or Company contributing to this project. Any and all updates are purely at the contributor's discretion.
+
+## Need more help?
 
-See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+Should you need further help, please raise your request to your Bitmovin account team. We can assist in a number of ways, from providing you professional services help to putting you in touch with preferred system integrators who can work with you to achieve your goals.

package/RNBitmovinPlayer.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
   s.dependency "React-Core"
-  s.dependency "BitmovinPlayer", "3.44.1"
+  s.dependency "BitmovinPlayer", "3.46.0"
   s.ios.dependency "GoogleAds-IMA-iOS-SDK", "3.18.4"
   s.tvos.dependency "GoogleAds-IMA-tvOS-SDK", "4.8.2"
 end

package/android/.editorconfig

@@ -0,0 +1,8 @@
+[*.{kt,kts}]
+ktlint_code_style=android_studio
+max_line_length=120
+# Allow wildcard imports for react native bridge, since IntelliJ does this automatically when performing
+# imports optimization.
+ij_kotlin_packages_to_use_import_on_demand = com.facebook.react.bridge.*
+ij_kotlin_allow_trailing_comma=true
+ij_kotlin_allow_trailing_comma_on_call_site=true

package/android/build.gradle

@@ -2,19 +2,25 @@ buildscript {
     ext {
         kotlinVersion = '1.7.21'
         androidToolsVersion = '7.4.2'
+        ktlintVersion = '11.6.0'
     }
     repositories {
         google()
         mavenCentral()
+        maven {
+            url "https://plugins.gradle.org/m2/"
+        }
     }
     dependencies {
         classpath "com.android.tools.build:gradle:$androidToolsVersion"
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
+        classpath "org.jlleitschuh.gradle:ktlint-gradle:$ktlintVersion"
     }
 }
 
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
+apply plugin: 'org.jlleitschuh.gradle.ktlint'
 
 repositories {
     mavenLocal()
@@ -51,9 +57,9 @@ android {
 
 dependencies {
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlinVersion"
-    implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.29.0'
+    implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.31.0'
     implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
-    implementation 'com.bitmovin.player:player:3.43.0'
+    implementation 'com.bitmovin.player:player:3.48.0+jason'
     //noinspection GradleDynamicVersion
     implementation 'com.facebook.react:react-native:+' // From node_modules
 }

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.2-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/android/src/main/java/com/bitmovin/player/reactnative/BitmovinCastManagerModule.kt

@@ -0,0 +1,76 @@
+package com.bitmovin.player.reactnative
+
+import com.bitmovin.player.casting.BitmovinCastManager
+import com.bitmovin.player.reactnative.converter.JsonConverter
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.UIManagerModule
+
+private const val MODULE_NAME = "BitmovinCastManagerModule"
+
+@ReactModule(name = MODULE_NAME)
+class BitmovinCastManagerModule(
+    private val context: ReactApplicationContext,
+) : ReactContextBaseJavaModule(context) {
+    override fun getName() = MODULE_NAME
+
+    /**
+     * Returns whether the [BitmovinCastManager] is initialized.
+     */
+    @ReactMethod
+    fun isInitialized(promise: Promise) = uiManager?.addUIBlock {
+        promise.resolve(BitmovinCastManager.isInitialized())
+    }
+
+    /**
+     * Initializes the [BitmovinCastManager] with the given options.
+     */
+    @ReactMethod
+    fun initializeCastManager(options: ReadableMap?, promise: Promise) {
+        val castOptions = JsonConverter.toCastOptions(options)
+        uiManager?.addUIBlock {
+            BitmovinCastManager.initialize(
+                castOptions?.applicationId,
+                castOptions?.messageNamespace,
+            )
+            promise.resolve(null)
+        }
+    }
+
+    /**
+     * Sends a message to the receiver.
+     */
+    @ReactMethod
+    fun sendMessage(message: String, messageNamespace: String?, promise: Promise) {
+        uiManager?.addUIBlock {
+            BitmovinCastManager.getInstance().sendMessage(message, messageNamespace)
+            promise.resolve(null)
+        }
+    }
+
+    /**
+     * Updates the context of the [BitmovinCastManager] to the current activity.
+     */
+    @ReactMethod
+    fun updateContext(promise: Promise) {
+        uiManager?.addUIBlock {
+            BitmovinCastManager.getInstance().updateContext(currentActivity)
+            promise.resolve(null)
+        }
+    }
+
+    private val uiManager: UIManagerModule?
+        get() = context.getNativeModule(UIManagerModule::class.java)
+}
+
+/**
+ * Represents configuration options for the [BitmovinCastManager].
+ */
+data class BitmovinCastManagerOptions(
+    val applicationId: String? = null,
+    val messageNamespace: String? = null,
+)

package/android/src/main/java/com/bitmovin/player/reactnative/DrmModule.kt

@@ -130,7 +130,7 @@ class DrmModule(private val context: ReactApplicationContext) : ReactContextBase
                 nativeId,
                 "onPrepareMessage",
                 preparedMessages,
-                preparedMessagesCondition
+                preparedMessagesCondition,
             )
             widevineConfig.prepareMessageCallback = PrepareMessageCallback {
                 prepareMessage(it)
@@ -151,7 +151,7 @@ class DrmModule(private val context: ReactApplicationContext) : ReactContextBase
                 nativeId,
                 "onPrepareLicense",
                 preparedLicenses,
-                preparedLicensesCondition
+                preparedLicensesCondition,
             )
             widevineConfig.prepareLicenseCallback = PrepareLicenseCallback {
                 prepareLicense(it)
@@ -170,11 +170,11 @@ class DrmModule(private val context: ReactApplicationContext) : ReactContextBase
         nativeId: NativeId,
         method: String,
         registry: Registry<String>,
-        registryCondition: Condition
+        registryCondition: Condition,
     ): PrepareCallback = {
         val args = Arguments.createArray()
         args.pushString(Base64.encodeToString(it, Base64.NO_WRAP))
-        context.catalystInstance.callFunction("DRM-${nativeId}", method, args as NativeArray)
+        context.catalystInstance.callFunction("DRM-$nativeId", method, args as NativeArray)
         lock.withLock {
             registryCondition.await()
             val result = registry[nativeId]

package/android/src/main/java/com/bitmovin/player/reactnative/EventRelay.kt

@@ -21,7 +21,7 @@ class EventRelay<E : EventEmitter<T>, T : Event>(
     /**
      * Is called for every relayed event together with its associated name.
      */
-    private val eventOutput: (String, Event) -> Unit
+    private val eventOutput: (String, Event) -> Unit,
 ) {
     private val eventListeners = forwardingEventClassesAndNameMapping.map {
         Subscription(it.key) { event -> eventOutput(it.value, event) }

package/android/src/main/java/com/bitmovin/player/reactnative/OfflineModule.kt

@@ -3,8 +3,8 @@ package com.bitmovin.player.reactnative
 import com.bitmovin.player.api.offline.options.OfflineOptionEntryState
 import com.bitmovin.player.reactnative.converter.JsonConverter
 import com.bitmovin.player.reactnative.extensions.toList
-import com.bitmovin.player.reactnative.offline.OfflineDownloadRequest
 import com.bitmovin.player.reactnative.offline.OfflineContentManagerBridge
+import com.bitmovin.player.reactnative.offline.OfflineDownloadRequest
 import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.uimanager.UIManagerModule
@@ -69,7 +69,13 @@ class OfflineModule(private val context: ReactApplicationContext) : ReactContext
                     return@addUIBlock
                 }
 
-                offlineContentManagerBridges[nativeId] = OfflineContentManagerBridge(nativeId, context, identifier, sourceConfig, context.cacheDir.path)
+                offlineContentManagerBridges[nativeId] = OfflineContentManagerBridge(
+                    nativeId,
+                    context,
+                    identifier,
+                    sourceConfig,
+                    context.cacheDir.path,
+                )
             }
             promise.resolve(null)
         }
@@ -117,7 +123,8 @@ class OfflineModule(private val context: ReactApplicationContext) : ReactContext
                         return@safeOfflineContentManager
                     }
                     OfflineOptionEntryState.Downloading,
-                    OfflineOptionEntryState.Failed -> {
+                    OfflineOptionEntryState.Failed,
+                    -> {
                         promise.reject(IllegalStateException("Download already in progress"))
                         return@safeOfflineContentManager
                     }
@@ -127,7 +134,7 @@ class OfflineModule(private val context: ReactApplicationContext) : ReactContext
                     }
                     else -> {}
                 }
-                val minimumBitRate = if(request.hasKey("minimumBitrate")) request.getInt("minimumBitrate") else null
+                val minimumBitRate = if (request.hasKey("minimumBitrate")) request.getInt("minimumBitrate") else null
                 if (minimumBitRate != null && minimumBitRate < 0) {
                     promise.reject(IllegalArgumentException("Invalid download request"))
                     return@safeOfflineContentManager
@@ -136,7 +143,9 @@ class OfflineModule(private val context: ReactApplicationContext) : ReactContext
                 val audioOptionIds = request.getArray("audioOptionIds")?.toList<String>()?.filterNotNull()
                 val textOptionIds = request.getArray("textOptionIds")?.toList<String>()?.filterNotNull()
 
-                getOfflineContentManagerBridge(nativeId)?.process(OfflineDownloadRequest(minimumBitRate, audioOptionIds, textOptionIds))
+                getOfflineContentManagerBridge(nativeId)?.process(
+                    OfflineDownloadRequest(minimumBitRate, audioOptionIds, textOptionIds),
+                )
                 promise.resolve(null)
             } catch (e: Exception) {
                 promise.reject(e)
@@ -260,20 +269,22 @@ class OfflineModule(private val context: ReactApplicationContext) : ReactContext
         }
     }
 
-    private fun safeOfflineContentManager(nativeId: NativeId, promise: Promise, runBlock: OfflineContentManagerBridge.() -> Unit) {
+    private fun safeOfflineContentManager(
+        nativeId: NativeId,
+        promise: Promise,
+        runBlock: OfflineContentManagerBridge.() -> Unit,
+    ) {
         getOfflineContentManagerBridge(nativeId)?.let(runBlock)
-                ?: promise.reject(IllegalArgumentException("Could not find the offline module instance"))
+            ?: promise.reject(IllegalArgumentException("Could not find the offline module instance"))
     }
 
     /**
      * Helper function that returns the initialized `DrmModule` instance.
      */
-    private fun drmModule(): DrmModule? =
-            context.getNativeModule(DrmModule::class.java)
+    private fun drmModule(): DrmModule? = context.getNativeModule(DrmModule::class.java)
 
     /**
      * Helper function that returns the initialized `UIManager` instance.
      */
-    private fun uiManager(): UIManagerModule? =
-            context.getNativeModule(UIManagerModule::class.java)
+    private fun uiManager(): UIManagerModule? = context.getNativeModule(UIManagerModule::class.java)
 }

package/android/src/main/java/com/bitmovin/player/reactnative/PlayerAnalyticsModule.kt

@@ -0,0 +1,58 @@
+package com.bitmovin.player.reactnative
+
+import com.bitmovin.player.api.analytics.AnalyticsApi.Companion.analytics
+import com.bitmovin.player.reactnative.converter.JsonConverter
+import com.facebook.react.bridge.*
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.UIManagerModule
+
+private const val MODULE_NAME = "PlayerAnalyticsModule"
+
+@ReactModule(name = MODULE_NAME)
+class PlayerAnalyticsModule(private val context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
+    /**
+     * JS exported module name.
+     */
+    override fun getName() = MODULE_NAME
+
+    /**
+     * Sends a sample with the provided custom data.
+     * Does not change the configured custom data of the collector or source.
+     * @param nativeId Native Id of the collector instance.
+     * @param json Custom data config json.
+     */
+    @ReactMethod
+    fun sendCustomDataEvent(nativeId: NativeId, json: ReadableMap?) {
+        uiManager()?.addUIBlock { _ ->
+            JsonConverter.toAnalyticsCustomData(json)?.let {
+                playerModule()?.getPlayer(nativeId)?.analytics?.sendCustomDataEvent(it)
+            }
+        }
+    }
+
+    /**
+     * Gets the current user Id for a player instance with analytics.
+     * @param nativeId Native Id of the the player instance.
+     * @param promise JS promise object.
+     */
+    @ReactMethod
+    fun getUserId(playerId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock { _ ->
+            playerModule()?.getPlayer(playerId)?.analytics?.let {
+                promise.resolve(it.userId)
+            }
+        }
+    }
+
+    /**
+     * Helper function that gets the instantiated `UIManagerModule` from modules registry.
+     */
+    private fun uiManager(): UIManagerModule? =
+        context.getNativeModule(UIManagerModule::class.java)
+
+    /**
+     * Helper function that gets the instantiated `PlayerModule` from modules registry.
+     */
+    private fun playerModule(): PlayerModule? =
+        context.getNativeModule(PlayerModule::class.java)
+}

package/android/src/main/java/com/bitmovin/player/reactnative/PlayerModule.kt

@@ -1,6 +1,10 @@
 package com.bitmovin.player.reactnative
 
+import android.util.Log
+import com.bitmovin.analytics.api.DefaultMetadata
 import com.bitmovin.player.api.Player
+import com.bitmovin.player.api.analytics.create
+import com.bitmovin.player.api.event.PlayerEvent
 import com.bitmovin.player.reactnative.converter.JsonConverter
 import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
@@ -47,6 +51,37 @@ class PlayerModule(private val context: ReactApplicationContext) : ReactContextB
         }
     }
 
+    /**
+     * Creates a new `Player` instance inside the internal players using the provided `playerConfig` and `analyticsConfig`.
+     * @param playerConfigJson `PlayerConfig` object received from JS.
+     * @param analyticsConfigJson `AnalyticsConfig` object received from JS.
+     */
+    @ReactMethod
+    fun initWithAnalyticsConfig(nativeId: NativeId, playerConfigJson: ReadableMap?, analyticsConfigJson: ReadableMap?) {
+        uiManager()?.addUIBlock {
+            if (players.containsKey(nativeId)) {
+                Log.d("[PlayerModule]", "Duplicate player creation for id $nativeId")
+                return@addUIBlock
+            }
+            val playerConfig = JsonConverter.toPlayerConfig(playerConfigJson)
+            val analyticsConfig = JsonConverter.toAnalyticsConfig(analyticsConfigJson)
+            val defaultMetadata = JsonConverter.toAnalyticsDefaultMetadata(
+                analyticsConfigJson?.getMap("defaultMetadata"),
+            )
+
+            players[nativeId] = if (analyticsConfig == null) {
+                Player.create(context, playerConfig)
+            } else {
+                Player.create(
+                    context = context,
+                    playerConfig = playerConfig,
+                    analyticsConfig = analyticsConfig,
+                    defaultMetadata = defaultMetadata ?: DefaultMetadata(),
+                )
+            }
+        }
+    }
+
     /**
      * Load the source of the given `nativeId` with `config` options from JS.
      * @param nativeId Target player.
@@ -448,7 +483,9 @@ class PlayerModule(private val context: ReactApplicationContext) : ReactContextB
     @ReactMethod
     fun setMaxSelectableBitrate(nativeId: NativeId, maxSelectableBitrate: Int) {
         uiManager()?.addUIBlock {
-            players[nativeId]?.setMaxSelectableVideoBitrate(maxSelectableBitrate.takeUnless { it == -1 } ?: Integer.MAX_VALUE)
+            players[nativeId]?.setMaxSelectableVideoBitrate(
+                maxSelectableBitrate.takeUnless { it == -1 } ?: Integer.MAX_VALUE,
+            )
         }
     }
 
@@ -464,6 +501,48 @@ class PlayerModule(private val context: ReactApplicationContext) : ReactContextB
         }
     }
 
+    /**
+     * Initiates casting the current video to a cast-compatible remote device. The user has to choose to which device it
+     * should be sent.
+     */
+    @ReactMethod
+    fun castVideo(nativeId: NativeId) {
+        uiManager()?.addUIBlock {
+            players[nativeId]?.castVideo()
+        }
+    }
+
+    /**
+     * Stops casting the current video. Has no effect if [isCasting] is false.
+     */
+    @ReactMethod
+    fun castStop(nativeId: NativeId) {
+        uiManager()?.addUIBlock {
+            players[nativeId]?.castStop()
+        }
+    }
+
+    /**
+     * Whether casting to a cast-compatible remote device is available. [PlayerEvent.CastAvailable] signals when
+     * casting becomes available.
+     */
+    @ReactMethod
+    fun isCastAvailable(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(players[nativeId]?.isCastAvailable)
+        }
+    }
+
+    /**
+     * Whether video is currently being casted to a remote device and not played locally.
+     */
+    @ReactMethod
+    fun isCasting(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(players[nativeId]?.isCasting)
+        }
+    }
+
     /**
      * Helper function that returns the initialized `UIManager` instance.
      */

package/android/src/main/java/com/bitmovin/player/reactnative/RNPlayerView.kt

@@ -11,6 +11,7 @@ import com.bitmovin.player.api.Player
 import com.bitmovin.player.api.event.Event
 import com.bitmovin.player.api.event.PlayerEvent
 import com.bitmovin.player.api.event.SourceEvent
+import com.bitmovin.player.api.ui.PlayerViewConfig
 import com.bitmovin.player.reactnative.converter.JsonConverter
 import com.bitmovin.player.reactnative.ui.RNPictureInPictureDelegate
 import com.bitmovin.player.reactnative.ui.RNPictureInPictureHandler
@@ -62,6 +63,18 @@ private val EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING = mapOf(
     PlayerEvent.AdSkipped::class to "adSkipped",
     PlayerEvent.AdStarted::class to "adStarted",
     PlayerEvent.VideoPlaybackQualityChanged::class to "videoPlaybackQualityChanged",
+    PlayerEvent.CastStart::class to "castStart",
+    @Suppress("DEPRECATION")
+    PlayerEvent.CastPlaybackFinished::class to "castPlaybackFinished",
+    @Suppress("DEPRECATION")
+    PlayerEvent.CastPaused::class to "castPaused",
+    @Suppress("DEPRECATION")
+    PlayerEvent.CastPlaying::class to "castPlaying",
+    PlayerEvent.CastStarted::class to "castStarted",
+    PlayerEvent.CastAvailable::class to "castAvailable",
+    PlayerEvent.CastStopped::class to "castStopped",
+    PlayerEvent.CastWaitingForDevice::class to "castWaitingForDevice",
+    PlayerEvent.CastTimeUpdated::class to "castTimeUpdated",
 )
 
 private val EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING_UI = mapOf<KClass<out Event>, String>(
@@ -80,8 +93,11 @@ private val EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING_UI = mapOf<KClass<out Event
  * exposes player events as bubbling events.
  */
 @SuppressLint("ViewConstructor")
-class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context),
-    LifecycleEventListener, View.OnLayoutChangeListener, RNPictureInPictureDelegate {
+class RNPlayerView(val context: ReactApplicationContext) :
+    LinearLayout(context),
+    LifecycleEventListener,
+    View.OnLayoutChangeListener,
+    RNPictureInPictureDelegate {
 
     init {
         // React Native has a bug that dynamically added views sometimes aren't laid out again properly.
@@ -97,6 +113,7 @@ class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context)
      * to the `eventOutput` callback.
      */
     private val playerEventRelay = EventRelay<Player, Event>(EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING, ::emitEvent)
+
     /**
      * Relays the provided set of events, emitted by the player view, together with the associated name
      * to the `eventOutput` callback.
@@ -128,6 +145,11 @@ class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context)
      */
     var pictureInPictureHandler: RNPictureInPictureHandler? = null
 
+    /**
+     * Configures the visual presentation and behaviour of the [playerView].
+     */
+    var config: RNPlayerViewConfigWrapper? = null
+
     /**
      * Whether this view should pause video playback when activity's onPause is called.
      * By default, `shouldPausePlaybackOnActivityPause` is set to false when entering PiP mode.
@@ -261,7 +283,7 @@ class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context)
         post {
             measure(
                 MeasureSpec.makeMeasureSpec(width, MeasureSpec.EXACTLY),
-                MeasureSpec.makeMeasureSpec(height, MeasureSpec.EXACTLY)
+                MeasureSpec.makeMeasureSpec(height, MeasureSpec.EXACTLY),
             )
             layout(left, top, right, bottom)
         }
@@ -269,8 +291,8 @@ class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context)
 
     /**
      * Emits a bubbling event with payload to js.
-     * @param event Native event name.
-     * @param json Optional js object to be sent as payload.
+     * @param name Native event name.
+     * @param event Optional js object to be sent as payload.
      */
     private inline fun <reified E : Event> emitEvent(name: String, event: E) {
         val payload = if (event is PlayerEvent) {
@@ -284,3 +306,12 @@ class RNPlayerView(val context: ReactApplicationContext) : LinearLayout(context)
             .receiveEvent(id, name, payload)
     }
 }
+
+/**
+ * Representation of the React Native API `PlayerViewConfig` object.
+ * This is necessary as not all of its values can be directly mapped to the native `PlayerViewConfig`.
+ */
+data class RNPlayerViewConfigWrapper(
+    val playerViewConfig: PlayerViewConfig?,
+    val pictureInPictureConfig: RNPictureInPictureHandler.PictureInPictureConfig?,
+)