bitmovin-player-react-native 0.3.1 → 0.5.0

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

@@ -4,29 +4,54 @@ import android.os.Handler
 import android.os.Looper
 import android.view.ViewGroup.LayoutParams
 import com.bitmovin.player.PlayerView
+import com.bitmovin.player.reactnative.extensions.getModule
+import com.bitmovin.player.reactnative.ui.FullscreenHandlerBridge
+import com.bitmovin.player.reactnative.ui.FullscreenHandlerModule
+import com.bitmovin.player.reactnative.ui.RNPictureInPictureHandler
 import com.facebook.react.bridge.*
+import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.uimanager.SimpleViewManager
 import com.facebook.react.uimanager.ThemedReactContext
 
+private const val MODULE_NAME = "NativePlayerView"
+
+@ReactModule(name = MODULE_NAME)
 class RNPlayerViewManager(private val context: ReactApplicationContext) : SimpleViewManager<RNPlayerView>() {
     /**
      * Native component functions.
      */
     enum class Commands {
         ATTACH_PLAYER,
+        ATTACH_FULLSCREEN_BRIDGE
     }
 
     /**
      * Exported module name to JS.
      */
-    override fun getName() = "NativePlayerView"
+    override fun getName() = MODULE_NAME
+
+    /**
+     * React Native PiP handler instance. It can be subclassed, then set from other native
+     * modules in case a full-custom implementation is needed. A default implementation is provided
+     * out-of-the-box.
+     */
+    var pictureInPictureHandler = RNPictureInPictureHandler(context)
 
     /**
-     * The component's native view factory. RN calls this method multiple times
+     * The component's native view factory. RN may call this method multiple times
      * for each component instance.
      */
     override fun createViewInstance(reactContext: ThemedReactContext) = RNPlayerView(context)
 
+    /**
+     * Called when the component's view gets detached from the view hierarchy. Useful to perform
+     * cleanups.
+     */
+    override fun onDropViewInstance(view: RNPlayerView) {
+        super.onDropViewInstance(view)
+        view.dispose()
+    }
+
     /**
      * A mapping between a event native identifier and its bubbled version that will
      * be accessed from React.
@@ -45,6 +70,8 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
         "playbackFinished" to "onPlaybackFinished",
         "seek" to "onSeek",
         "seeked" to "onSeeked",
+        "stallStarted" to "onStallStarted",
+        "stallEnded" to "onStallEnded",
         "timeChanged" to "onTimeChanged",
         "sourceLoad" to "onSourceLoad",
         "sourceLoaded" to "onSourceLoaded",
@@ -54,6 +81,25 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
         "subtitleAdded" to "onSubtitleAdded",
         "subtitleChanged" to "onSubtitleChanged",
         "subtitleRemoved" to "onSubtitleRemoved",
+        "pictureInPictureAvailabilityChanged" to "onPictureInPictureAvailabilityChanged",
+        "pictureInPictureEnter" to "onPictureInPictureEnter",
+        "pictureInPictureExit" to "onPictureInPictureExit",
+        "adBreakFinished" to "onAdBreakFinished",
+        "adBreakStarted" to "onAdBreakStarted",
+        "adClicked" to "onAdClicked",
+        "adError" to "onAdError",
+        "adFinished" to "onAdFinished",
+        "adManifestLoad" to "onAdManifestLoad",
+        "adManifestLoaded" to "onAdManifestLoaded",
+        "adQuartile" to "onAdQuartile",
+        "adScheduled" to "onAdScheduled",
+        "adSkipped" to "onAdSkipped",
+        "adStarted" to "onAdStarted",
+        "videoPlaybackQualityChanged" to "onVideoPlaybackQualityChanged",
+        "fullscreenEnabled" to "onFullscreenEnabled",
+        "fullscreenDisabled" to "onFullscreenDisabled",
+        "fullscreenEnter" to "onFullscreenEnter",
+        "fullscreenExit" to "onFullscreenExit",
     )
 
     /**
@@ -75,7 +121,8 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
      * @return map between names (used in js) and command ids (used in native code).
      */
     override fun getCommandsMap(): MutableMap<String, Int> = mutableMapOf(
-        "attachPlayer" to Commands.ATTACH_PLAYER.ordinal
+        "attachPlayer" to Commands.ATTACH_PLAYER.ordinal,
+        "attachFullscreenBridge" to Commands.ATTACH_FULLSCREEN_BRIDGE.ordinal,
     )
 
     /**
@@ -88,36 +135,50 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
         super.receiveCommand(view, commandId, args)
         commandId?.toInt()?.let {
             when (it) {
-                Commands.ATTACH_PLAYER.ordinal -> attachPlayer(view, args?.getString(1))
+                Commands.ATTACH_PLAYER.ordinal -> attachPlayer(view, args?.getString(1), args?.getMap(2))
+                Commands.ATTACH_FULLSCREEN_BRIDGE.ordinal -> args?.getString(1)?.let { fullscreenBridgeId ->
+                    attachFullscreenBridge(view, fullscreenBridgeId)
+                }
                 else -> {}
             }
         }
     }
 
+    private fun attachFullscreenBridge(view: RNPlayerView, fullscreenBridgeId: NativeId) {
+        Handler(Looper.getMainLooper()).post {
+            view.playerView?.setFullscreenHandler(
+                context.getModule<FullscreenHandlerModule>()?.getInstance(fullscreenBridgeId)
+            )
+        }
+    }
+
     /**
      * Set the `Player` instance for the target view using `playerId`.
      * @param view Target `RNPlayerView`.
      * @param playerId `Player` instance id inside `PlayerModule`'s registry.
      */
-    private fun attachPlayer(view: RNPlayerView, playerId: NativeId?) {
+    private fun attachPlayer(view: RNPlayerView, playerId: NativeId?, playerConfig: ReadableMap?) {
         Handler(Looper.getMainLooper()).post {
             val player = getPlayerModule()?.getPlayer(playerId)
+            playerConfig?.getMap("playbackConfig")?.getBoolean("isPictureInPictureEnabled")?.let {
+                pictureInPictureHandler.isPictureInPictureEnabled = it
+                view.pictureInPictureHandler = pictureInPictureHandler
+            }
             if (view.playerView != null) {
                 view.player = player
             } else {
                 val playerView = PlayerView(context, player)
                 playerView.layoutParams = LayoutParams(
                     LayoutParams.MATCH_PARENT,
-                    LayoutParams.MATCH_PARENT)
+                    LayoutParams.MATCH_PARENT
+                )
                 view.addPlayerView(playerView)
             }
-            view.startBubblingEvents()
         }
     }
 
     /**
      * Helper function that gets the instantiated `PlayerModule` from modules registry.
      */
-    private fun getPlayerModule(): PlayerModule? =
-        context.getNativeModule(PlayerModule::class.java)
+    private fun getPlayerModule(): PlayerModule? = context.getModule()
 }

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

@@ -1,6 +1,7 @@
 package com.bitmovin.player.reactnative
 
 import android.view.View
+import com.bitmovin.player.reactnative.ui.FullscreenHandlerModule
 import com.facebook.react.ReactPackage
 import com.facebook.react.bridge.NativeModule
 import com.facebook.react.bridge.ReactApplicationContext
@@ -21,7 +22,9 @@ class RNPlayerViewPackage : ReactPackage {
             PlayerModule(reactContext),
             SourceModule(reactContext),
             DrmModule(reactContext),
+            AnalyticsModule(reactContext),
             RNPlayerViewManager(reactContext),
+            FullscreenHandlerModule(reactContext)
         )
     }
 

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

@@ -6,7 +6,9 @@ import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.uimanager.UIManagerModule
 
-@ReactModule(name = SourceModule.name)
+private const val MODULE_NAME = "SourceModule"
+
+@ReactModule(name = MODULE_NAME)
 class SourceModule(private val context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
     /**
      * In-memory mapping from `nativeId`s to `Source` instances.
@@ -16,10 +18,7 @@ class SourceModule(private val context: ReactApplicationContext) : ReactContextB
     /**
      * JS exported module name.
      */
-    companion object {
-        const val name = "SourceModule"
-    }
-    override fun getName() = SourceModule.name
+    override fun getName() = MODULE_NAME
 
     /**
      * Fetches the `Source` instance associated with `nativeId` from internal sources.

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

@@ -5,11 +5,13 @@ import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
 import java.util.*
 
+private const val MODULE_NAME = "UuidModule"
+
 class UuidModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
     /**
      * Exported JS module name.
      */
-    override fun getName() = "UuidModule"
+    override fun getName() = MODULE_NAME
 
     /**
      * Synchronously generate a random UUIDv4.

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

@@ -1,20 +1,32 @@
 package com.bitmovin.player.reactnative.converter
 
+import com.bitmovin.analytics.BitmovinAnalyticsConfig
+import com.bitmovin.analytics.data.CustomData
 import com.bitmovin.player.api.DeviceDescription.DeviceName
 import com.bitmovin.player.api.DeviceDescription.ModelName
 import com.bitmovin.player.api.PlaybackConfig
 import com.bitmovin.player.api.PlayerConfig
 import com.bitmovin.player.api.TweaksConfig
+import com.bitmovin.player.api.advertising.*
 import com.bitmovin.player.api.drm.WidevineConfig
 import com.bitmovin.player.api.event.PlayerEvent
 import com.bitmovin.player.api.event.SourceEvent
 import com.bitmovin.player.api.event.data.SeekPosition
 import com.bitmovin.player.api.media.subtitle.SubtitleTrack
+import com.bitmovin.player.api.media.thumbnail.ThumbnailTrack
+import com.bitmovin.player.api.media.video.quality.VideoQuality
 import com.bitmovin.player.api.source.Source
 import com.bitmovin.player.api.source.SourceConfig
 import com.bitmovin.player.api.source.SourceType
+import com.bitmovin.player.api.ui.ScalingMode
+import com.bitmovin.player.api.ui.StyleConfig
 import com.bitmovin.player.reactnative.extensions.getName
+import com.bitmovin.player.reactnative.extensions.putInt
+import com.bitmovin.player.reactnative.extensions.putDouble
 import com.bitmovin.player.reactnative.extensions.toList
+import com.bitmovin.player.reactnative.extensions.toReadableArray
+import com.bitmovin.player.reactnative.extensions.getProperty
+import com.bitmovin.player.reactnative.extensions.setProperty
 import com.facebook.react.bridge.*
 import java.util.UUID
 
@@ -41,11 +53,21 @@ class JsonConverter {
                     playerConfig.playbackConfig = it
                 }
             }
+            if (json.hasKey("styleConfig")) {
+                toStyleConfig(json.getMap("styleConfig"))?.let {
+                    playerConfig.styleConfig = it
+                }
+            }
             if (json.hasKey("tweaksConfig")) {
                 toTweaksConfig(json.getMap("tweaksConfig"))?.let {
                     playerConfig.tweaksConfig = it
                 }
             }
+            if (json.hasKey("advertisingConfig")) {
+                toAdvertisingConfig(json.getMap("advertisingConfig"))?.let {
+                    playerConfig.advertisingConfig = it
+                }
+            }
             return playerConfig
         }
 
@@ -72,6 +94,47 @@ class JsonConverter {
             return playbackConfig
         }
 
+        /**
+         * Converts any JS object into a `StyleConfig` object.
+         * @param json JS object representing the `StyleConfig`.
+         * @return The generated `StyleConfig` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toStyleConfig(json: ReadableMap?): StyleConfig? {
+            if (json == null) {
+                return null
+            }
+            val styleConfig = StyleConfig()
+            if (json.hasKey("isUiEnabled")) {
+                styleConfig.isUiEnabled = json.getBoolean("isUiEnabled")
+            }
+            if (json.hasKey("playerUiCss")) {
+                val playerUiCss = json.getString("playerUiCss")
+                if (!playerUiCss.isNullOrEmpty()) {
+                    styleConfig.playerUiCss = playerUiCss
+                }
+            }
+            if (json.hasKey("supplementalPlayerUiCss")) {
+                val supplementalPlayerUiCss = json.getString("supplementalPlayerUiCss")
+                if (!supplementalPlayerUiCss.isNullOrEmpty()) {
+                    styleConfig.supplementalPlayerUiCss = supplementalPlayerUiCss
+                }
+            }
+            if (json.hasKey("playerUiJs")) {
+                val playerUiJs = json.getString("playerUiJs")
+                if (!playerUiJs.isNullOrEmpty()) {
+                    styleConfig.playerUiJs = playerUiJs
+                }
+            }
+            if (json.hasKey("scalingMode")) {
+                val scalingMode = json.getString("scalingMode")
+                if (!scalingMode.isNullOrEmpty()) {
+                    styleConfig.scalingMode = ScalingMode.valueOf(scalingMode)
+                }
+            }
+            return styleConfig
+        }
+
         /**
          * Converts any JS object into a `TweaksConfig` object.
          * @param json JS object representing the `TweaksConfig`.
@@ -124,6 +187,54 @@ class JsonConverter {
             return tweaksConfig
         }
 
+        /**
+         * Converts any JS object into an `AdvertisingConfig` object.
+         * @param json JS object representing the `AdvertisingConfig`.
+         * @return The generated `AdvertisingConfig` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toAdvertisingConfig(json: ReadableMap?): AdvertisingConfig? = json?.getArray("schedule")
+            ?.toList<ReadableMap>()
+            ?.mapNotNull(::toAdItem)
+            ?.let { AdvertisingConfig(it) }
+
+        /**
+         * Converts any JS object into an `AdItem` object.
+         * @param json JS object representing the `AdItem`.
+         * @return The generated `AdItem` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toAdItem(json: ReadableMap?): AdItem? {
+            val sources = json?.getArray("sources")
+                ?.toList<ReadableMap>()
+                ?.mapNotNull(::toAdSource)
+                ?.toTypedArray()
+                ?: return null
+            return AdItem(sources, json?.getString("position") ?: "pre")
+        }
+
+        /**
+         * Converts any JS object into an `AdSource` object.
+         * @param json JS object representing the `AdSource`.
+         * @return The generated `AdSource` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toAdSource(json: ReadableMap?): AdSource? = json?.getString("tag")?.let {
+            AdSource(toAdSourceType(json.getString("type")), it)
+        }
+
+        /**
+         * Converts any JS string into an `AdSourceType` enum value.
+         * @param json JS string representing the `AdSourceType`.
+         * @return The generated `AdSourceType`.
+         */
+        @JvmStatic
+        fun toAdSourceType(json: String?): AdSourceType = when (json) {
+            "ima" -> AdSourceType.Ima
+            "progressive" -> AdSourceType.Progressive
+            else -> AdSourceType.Unknown
+        }
+
         /**
          * Converts an arbitrary `json` to `SourceConfig`.
          * @param json JS object representing the `SourceConfig`.
@@ -150,6 +261,9 @@ class JsonConverter {
                     }
                 }
             }
+            if (json.hasKey("thumbnailTrack")) {
+                config.thumbnailTrack = toThumbnailTrack(json.getString("thumbnailTrack"))
+            }
             return config
         }
 
@@ -270,6 +384,59 @@ class JsonConverter {
                 json.putMap("from", fromSeekPosition(event.from))
                 json.putMap("to", fromSeekPosition(event.to))
             }
+            if (event is PlayerEvent.PictureInPictureAvailabilityChanged) {
+                json.putBoolean("isPictureInPictureAvailable", event.isPictureInPictureAvailable)
+            }
+            if (event is PlayerEvent.AdBreakFinished) {
+                json.putMap("adBreak", fromAdBreak(event.adBreak))
+            }
+            if (event is PlayerEvent.AdBreakStarted) {
+                json.putMap("adBreak", fromAdBreak(event.adBreak))
+            }
+            if (event is PlayerEvent.AdClicked) {
+                json.putString("clickThroughUrl", event.clickThroughUrl)
+            }
+            if (event is PlayerEvent.AdError) {
+                json.putInt("code", event.code)
+                json.putString("message", event.message)
+                json.putMap("adConfig", fromAdConfig(event.adConfig))
+                json.putMap("adItem", fromAdItem(event.adItem))
+            }
+            if (event is PlayerEvent.AdFinished) {
+                json.putMap("ad", fromAd(event.ad))
+            }
+            if (event is PlayerEvent.AdManifestLoad) {
+                json.putMap("adBreak", fromAdBreak(event.adBreak))
+                json.putMap("adConfig", fromAdConfig(event.adConfig))
+            }
+            if (event is PlayerEvent.AdManifestLoaded) {
+                json.putMap("adBreak", fromAdBreak(event.adBreak))
+                json.putMap("adConfig", fromAdConfig(event.adConfig))
+                json.putDouble("downloadTime", event.downloadTime.toDouble())
+            }
+            if (event is PlayerEvent.AdQuartile) {
+                json.putString("quartile", fromAdQuartile(event.quartile))
+            }
+            if (event is PlayerEvent.AdScheduled) {
+                json.putInt("numberOfAds", event.numberOfAds)
+            }
+            if (event is PlayerEvent.AdSkipped) {
+                json.putMap("ad", fromAd(event.ad))
+            }
+            if (event is PlayerEvent.AdStarted) {
+                json.putMap("ad", fromAd(event.ad))
+                json.putString("clickThroughUrl", event.clickThroughUrl)
+                json.putString("clientType", fromAdSourceType(event.clientType))
+                json.putDouble("duration", event.duration)
+                json.putInt("indexInQueue", event.indexInQueue)
+                json.putString("position", event.position)
+                json.putDouble("skipOffset", event.skipOffset)
+                json.putDouble("timeOffset", event.timeOffset)
+            }
+            if (event is PlayerEvent.VideoPlaybackQualityChanged) {
+                json.putMap("newVideoQuality", fromVideoQuality(event.newVideoQuality))
+                json.putMap("oldVideoQuality", fromVideoQuality(event.oldVideoQuality))
+            }
             return json
         }
 
@@ -287,6 +454,19 @@ class JsonConverter {
             widevineConfig
         }
 
+        /**
+         * Converts an `url` string into a `ThumbnailsTrack`.
+         * @param url JS object representing the `ThumbnailsTrack`.
+         * @return The generated `ThumbnailsTrack` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toThumbnailTrack(url: String?): ThumbnailTrack? {
+            if (url == null) {
+                return null
+            }
+            return ThumbnailTrack(url);
+        }
+
         /**
          * Converts an arbitrary `json` into a `SubtitleTrack`.
          * @param json JS object representing the `SubtitleTrack`.
@@ -378,5 +558,214 @@ class JsonConverter {
             }
             return mimeType.split("/").last()
         }
+
+        /**
+         * Converts any `AdBreak` object into its json representation.
+         * @param adBreak `AdBreak` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAdBreak(adBreak: AdBreak?): WritableMap? = adBreak?.let {
+            Arguments.createMap().apply {
+                putArray("ads", it.ads.mapNotNull(::fromAd).toReadableArray())
+                putString("id", it.id)
+                putDouble("scheduleTime", it.scheduleTime)
+            }
+        }
+
+        /**
+         * Converts any `Ad` object into its json representation.
+         * @param ad `Ad` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAd(ad: Ad?): WritableMap? = ad?.let {
+            Arguments.createMap().apply {
+                putString("clickThroughUrl", it.clickThroughUrl)
+                putMap("data", fromAdData(it.data))
+                putInt("height", it.height)
+                putString("id", it.id)
+                putBoolean("isLinear", it.isLinear)
+                putString("mediaFileUrl", it.mediaFileUrl)
+                putInt("width", it.width)
+            }
+        }
+
+        /**
+         * Converts any `AdData` object into its json representation.
+         * @param adData `AdData` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAdData(adData: AdData?): WritableMap? = adData?.let {
+            Arguments.createMap().apply {
+                putInt("bitrate", it.bitrate)
+                putInt("maxBitrate", it.maxBitrate)
+                putString("mimeType", it.mimeType)
+                putInt("minBitrate", it.minBitrate)
+            }
+        }
+
+        /**
+         * Converts any `AdConfig` object into its json representation.
+         * @param adConfig `AdConfig` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAdConfig(adConfig: AdConfig?): WritableMap? = adConfig?.let {
+            Arguments.createMap().apply {
+                putDouble("replaceContentDuration", it.replaceContentDuration)
+            }
+        }
+
+        /**
+         * Converts any `AdItem` object into its json representation.
+         * @param adItem `AdItem` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAdItem(adItem: AdItem?): WritableMap? = adItem?.let {
+            Arguments.createMap().apply {
+                putString("position", it.position)
+                putArray("sources", it.sources.mapNotNull(::fromAdSource).toReadableArray())
+            }
+        }
+
+        /**
+         * Converts any `AdSource` object into its json representation.
+         * @param adSource `AdSource` object.
+         * @return The produced JS object.
+         */
+        @JvmStatic
+        fun fromAdSource(adSource: AdSource?): WritableMap? = adSource?.let {
+            Arguments.createMap().apply {
+                putString("tag", it.tag)
+                putString("type", fromAdSourceType(it.type))
+            }
+        }
+
+        /**
+         * Converts any `AdSourceType` value into its json representation.
+         * @param adSourceType `AdSourceType` value.
+         * @return The produced JS string.
+         */
+        @JvmStatic
+        fun fromAdSourceType(adSourceType: AdSourceType?): String? = when (adSourceType) {
+            AdSourceType.Ima -> "ima"
+            AdSourceType.Unknown -> "unknown"
+            AdSourceType.Progressive -> "progressive"
+            else -> null
+        }
+
+        /**
+         * Converts any `AdQuartile` value into its json representation.
+         * @param adQuartile `AdQuartile` value.
+         * @return The produced JS string.
+         */
+        @JvmStatic
+        fun fromAdQuartile(adQuartile: AdQuartile?): String? = when (adQuartile) {
+            AdQuartile.FirstQuartile -> "first"
+            AdQuartile.MidPoint -> "mid_point"
+            AdQuartile.ThirdQuartile -> "third"
+            else -> null
+        }
+
+        /**
+         * Converts an arbitrary json object into a `BitmovinAnalyticsConfig`.
+         * @param json JS object representing the `BitmovinAnalyticsConfig`.
+         * @return The produced `BitmovinAnalyticsConfig` or null.
+         */
+        @JvmStatic
+        fun toAnalyticsConfig(json: ReadableMap?): BitmovinAnalyticsConfig? = json?.let {
+            var config: BitmovinAnalyticsConfig? = null
+            it.getString("key")?.let { key ->
+                config = it.getString("playerKey")
+                    ?.let { playerKey -> BitmovinAnalyticsConfig(key, playerKey) }
+                    ?: BitmovinAnalyticsConfig(key)
+            }
+            it.getString("cdnProvider")?.let { cdnProvider ->
+                config?.cdnProvider = cdnProvider
+            }
+            it.getString("customUserId")?.let { customUserId ->
+                config?.customUserId = customUserId
+            }
+            it.getString("experimentName")?.let { experimentName ->
+                config?.experimentName = experimentName
+            }
+            it.getString("videoId")?.let { videoId ->
+                config?.videoId = videoId
+            }
+            it.getString("title")?.let { title ->
+                config?.title = title
+            }
+            it.getString("path")?.let { path ->
+                config?.path = path
+            }
+            if (it.hasKey("isLive")) {
+                config?.isLive = it.getBoolean("isLive")
+            }
+            if (it.hasKey("ads")) {
+                config?.ads = it.getBoolean("ads")
+            }
+            if (it.hasKey("randomizeUserId")) {
+                config?.randomizeUserId = it.getBoolean("randomizeUserId")
+            }
+            for (n in 1..30) {
+                it.getString("customData${n}")?.let { customDataN ->
+                    config?.setProperty("customData${n}", customDataN)
+                }
+            }
+            config
+        }
+
+        /**
+         * Converts an arbitrary json object into an analytics `CustomData`.
+         * @param json JS object representing the `CustomData`.
+         * @return The produced `CustomData` or null.
+         */
+        @JvmStatic
+        fun toAnalyticsCustomData(json: ReadableMap?): CustomData? = json?.let {
+            val customData = CustomData()
+            for (n in 1..30) {
+                it.getString("customData${n}")?.let { customDataN ->
+                    customData.setProperty("customData${n}", customDataN)
+                }
+            }
+            customData
+        }
+
+        /**
+         * Converts an arbitrary analytics `CustomData` object into a JS value.
+         * @param customData `CustomData` to be converted.
+         * @return The produced JS value or null.
+         */
+        @JvmStatic
+        fun fromAnalyticsCustomData(customData: CustomData?): ReadableMap? = customData?.let {
+            val json = Arguments.createMap()
+            for (n in 1..30) {
+                it.getProperty<String>("customData${n}")?.let { customDataN ->
+                    json.putString("customData${n}", customDataN)
+                }
+            }
+            json
+        }
+
+        /**
+         * Converts any `VideoQuality` value into its json representation.
+         * @param videoQuality `VideoQuality` value.
+         * @return The produced JS string.
+         */
+        @JvmStatic
+        fun fromVideoQuality(videoQuality: VideoQuality?): WritableMap? = videoQuality?.let {
+            Arguments.createMap().apply {
+                putString("id", videoQuality.id)
+                putString("label", videoQuality.label)
+                putInt("bitrate", videoQuality.bitrate)
+                putString("codec", videoQuality.codec)
+                putDouble("frameRate", videoQuality.frameRate.toDouble())
+                putInt("height", videoQuality.height)
+                putInt("width", videoQuality.width)
+            }
+        }
     }
 }