bitmovin-player-react-native 0.1.0 → 0.2.0

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

@@ -0,0 +1,178 @@
+package com.bitmovin.player.reactnative
+
+import com.bitmovin.player.api.source.Source
+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
+
+@ReactModule(name = SourceModule.name)
+class SourceModule(private val context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
+    /**
+     * In-memory mapping from `nativeId`s to `Source` instances.
+     */
+    private val sources: Registry<Source> = mutableMapOf()
+
+    /**
+     * JS exported module name.
+     */
+    companion object {
+        const val name = "SourceModule"
+    }
+    override fun getName() = SourceModule.name
+
+    /**
+     * Fetches the `Source` instance associated with `nativeId` from internal sources.
+     * @param nativeId `Source` instance ID.
+     * @return The associated `Source` instance or `null`.
+     */
+    fun getSource(nativeId: NativeId?): Source? {
+        if (nativeId == null) {
+            return null
+        }
+        return sources[nativeId]
+    }
+
+    /**
+     * Creates a new `Source` instance inside the internal sources using the provided `config` object.
+     * @param nativeId ID to be associated with the `Source` instance.
+     * @param config `SourceConfig` object received from JS.
+     */
+    @ReactMethod
+    fun initWithConfig(nativeId: NativeId, config: ReadableMap?) {
+        uiManager()?.addUIBlock {
+            if (!sources.containsKey(nativeId)) {
+                JsonConverter.toSourceConfig(config)?.let {
+                    sources[nativeId] = Source.create(it)
+                }
+            }
+        }
+    }
+
+    /**
+     * Creates a new `Source` instance inside the internal sources using the provided
+     * `config` object and an initialized DRM configuration ID.
+     * @param nativeId ID to be associated with the `Source` instance.
+     * @param drmNativeId ID of the DRM config to use.
+     * @param config `SourceConfig` object received from JS.
+     */
+    @ReactMethod
+    fun initWithDrmConfig(nativeId: NativeId, drmNativeId: NativeId, config: ReadableMap?) {
+        uiManager()?.addUIBlock {
+            val drmConfig = drmModule()?.getConfig(drmNativeId)
+            if (!sources.containsKey(nativeId) && drmConfig != null) {
+                JsonConverter.toSourceConfig(config)?.let {
+                    it.drmConfig = drmConfig
+                    sources[nativeId] = Source.create(it)
+                }
+            }
+        }
+    }
+
+    /**
+     * Removes the `Source` instance associated with `nativeId` from the internal sources.
+     * @param nativeId `Source` to be disposed.
+     */
+    @ReactMethod
+    fun destroy(nativeId: NativeId) {
+        sources.remove(nativeId)
+    }
+
+    /**
+     * Whether `nativeId` source is currently attached to a player instance.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun isAttachedToPlayer(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(sources[nativeId]?.isAttachedToPlayer)
+        }
+    }
+
+    /**
+     * Whether `nativeId` source is currently active in a `Player`.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun isActive(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(sources[nativeId]?.isActive)
+        }
+    }
+
+    /**
+     * The duration of `nativeId` source in seconds.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun duration(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(sources[nativeId]?.duration)
+        }
+    }
+
+    /**
+     * The current loading state of `nativeId` source.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun loadingState(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(sources[nativeId]?.loadingState?.ordinal)
+        }
+    }
+
+    /**
+     * Metadata for the currently loaded `nativeId` source.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun getMetadata(nativeId: NativeId, promise: Promise) {
+        uiManager()?.addUIBlock {
+            promise.resolve(sources[nativeId]?.config?.metadata)
+        }
+    }
+
+    /**
+     * Set the metadata for a loaded `nativeId` source.
+     * @param nativeId Source `nativeId`.
+     * @param promise: JS promise object.
+     */
+    @ReactMethod
+    fun setMetadata(nativeId: NativeId, metadata: ReadableMap?) {
+        uiManager()?.addUIBlock {
+            sources[nativeId]?.config?.metadata = asStringMap(metadata)
+        }
+    }
+
+    /**
+     * Helper method that converts a React `ReadableMap` into a kotlin String -> String map.
+     */
+    private fun asStringMap(readableMap: ReadableMap?): Map<String, String>? {
+        if (readableMap == null) {
+            return null
+        }
+        val map = mutableMapOf<String, String>()
+        for (entry in readableMap.entryIterator) {
+            map[entry.key] = entry.value.toString()
+        }
+        return map
+    }
+
+    /**
+     * Helper function that returns the initialized `UIManager` instance.
+     */
+    private fun uiManager(): UIManagerModule? =
+        context.getNativeModule(UIManagerModule::class.java)
+
+    /**
+     * Helper function that returns the initialized `DrmModule` instance.
+     */
+    private fun drmModule(): DrmModule? =
+        context.getNativeModule(DrmModule::class.java)
+}

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

@@ -0,0 +1,20 @@
+package com.bitmovin.player.reactnative
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import java.util.*
+
+class UuidModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
+    /**
+     * Exported JS module name.
+     */
+    override fun getName() = "UuidModule"
+
+    /**
+     * Synchronously generate a random UUIDv4.
+     * @return Random UUID RFC 4122 version 4.
+     */
+    @ReactMethod(isBlockingSynchronousMethod = true)
+    fun generate() = UUID.randomUUID().toString()
+}

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

@@ -1,14 +1,17 @@
 package com.bitmovin.player.reactnative.converter
 
 import com.bitmovin.player.api.PlayerConfig
+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.source.Source
 import com.bitmovin.player.api.source.SourceConfig
 import com.bitmovin.player.api.source.SourceType
 import com.bitmovin.player.reactnative.extensions.getName
 import com.facebook.react.bridge.*
+import java.util.UUID
 
 /**
  * Helper class to gather all conversion methods between JS -> Native objects.
@@ -21,7 +24,7 @@ class JsonConverter {
          * @return The generated `PlayerConfig` if successful, `null` otherwise.
          */
         @JvmStatic
-        fun toPlayerConfig(json: ReadableMap?): PlayerConfig? {
+        fun toPlayerConfig(json: ReadableMap?): PlayerConfig {
             if (json != null && json.hasKey("licenseKey")) {
                 return PlayerConfig(key = json.getString("licenseKey"))
             }
@@ -46,6 +49,14 @@ class JsonConverter {
             if (json.hasKey("isPosterPersistent")) {
                 config.isPosterPersistent = json.getBoolean("isPosterPersistent")
             }
+            if (json.hasKey("subtitleTracks")) {
+                val subtitleTracks = json.getArray("subtitleTracks") as ReadableArray
+                for (i in 0 until subtitleTracks.size()) {
+                    toSubtitleTrack(subtitleTracks.getMap(i))?.let {
+                        config.addSubtitleTrack(it)
+                    }
+                }
+            }
             return config
         }
 
@@ -119,6 +130,16 @@ class JsonConverter {
                 json.putInt("code", event.code.value)
                 json.putString("message", event.message)
             }
+            if (event is SourceEvent.SubtitleTrackAdded) {
+                json.putMap("subtitleTrack", fromSubtitleTrack(event.subtitleTrack))
+            }
+            if (event is SourceEvent.SubtitleTrackRemoved) {
+                json.putMap("subtitleTrack", fromSubtitleTrack(event.subtitleTrack))
+            }
+            if (event is SourceEvent.SubtitleTrackChanged) {
+                json.putMap("oldSubtitleTrack", fromSubtitleTrack(event.oldSubtitleTrack))
+                json.putMap("newSubtitleTrack", fromSubtitleTrack(event.newSubtitleTrack))
+            }
             return json
         }
 
@@ -158,5 +179,111 @@ class JsonConverter {
             }
             return json
         }
+
+        /**
+         * Converts an arbitrary `json` to `WidevineConfig`.
+         * @param json JS object representing the `WidevineConfig`.
+         * @return The generated `WidevineConfig` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toWidevineConfig(json: ReadableMap?): WidevineConfig? = json?.getMap("widevine")?.let {
+            val widevineConfig = WidevineConfig(it.getString("licenseUrl"))
+            if (it.hasKey("preferredSecurityLevel")) {
+                widevineConfig.preferredSecurityLevel = it.getString("preferredSecurityLevel")
+            }
+            widevineConfig
+        }
+
+        /**
+         * Converts an arbitrary `json` into a `SubtitleTrack`.
+         * @param json JS object representing the `SubtitleTrack`.
+         * @return The generated `SubtitleTrack` if successful, `null` otherwise.
+         */
+        @JvmStatic
+        fun toSubtitleTrack(json: ReadableMap?): SubtitleTrack? {
+            val url = json?.getString("url")
+            val label = json?.getString("label")
+            if (json == null || url == null || label == null) {
+                return null
+            }
+            val identifier = json.getString("identifier") ?: UUID.randomUUID().toString()
+            val isDefault = if (json.hasKey("isDefault")) {
+                json.getBoolean("isDefault")
+            } else {
+                false
+            }
+            val isForced = if (json.hasKey("isForced")) {
+                json.getBoolean("isForced")
+            } else {
+                false
+            }
+            val format = json.getString("format")
+            if (format != null && format.isNotBlank()) {
+                return SubtitleTrack(
+                    url = url,
+                    label = label,
+                    id = identifier,
+                    isDefault = isDefault,
+                    language = json.getString("language"),
+                    isForced = isForced,
+                    mimeType = toSubtitleMimeType(format),
+                )
+            }
+            return SubtitleTrack(
+                url = url,
+                label = label,
+                id = identifier,
+                isDefault = isDefault,
+                language = json.getString("language"),
+                isForced = isForced,
+            )
+        }
+
+        /**
+         * Converts any subtitle format name in its mime type representation.
+         * @param format The file format string received from JS.
+         * @return The subtitle file mime type.
+         */
+        @JvmStatic
+        fun toSubtitleMimeType(format: String?): String? {
+            if (format == null) {
+                return null
+            }
+            return "text/${format}"
+        }
+
+        /**
+         * Converts any `SubtitleTrack` into its json representation.
+         * @param subtitleTrack `SubtitleTrack` object to be converted.
+         * @return The generated json map.
+         */
+        @JvmStatic
+        fun fromSubtitleTrack(subtitleTrack: SubtitleTrack?): WritableMap? {
+            if (subtitleTrack == null) {
+                return null
+            }
+            val json = Arguments.createMap()
+            json.putString("url", subtitleTrack.url)
+            json.putString("label", subtitleTrack.label)
+            json.putBoolean("isDefault", subtitleTrack.isDefault)
+            json.putString("identifier", subtitleTrack.id)
+            json.putString("language", subtitleTrack.language)
+            json.putBoolean("isForced", subtitleTrack.isForced)
+            json.putString("format", fromSubtitleMimeType(subtitleTrack.mimeType))
+            return json
+        }
+
+        /**
+         * Converts any subtitle track mime type into its json representation (file format value).
+         * @param mimeType `SubtitleTrack` file mime type.
+         * @return The extracted file format.
+         */
+        @JvmStatic
+        fun fromSubtitleMimeType(mimeType: String?): String? {
+            if (mimeType == null) {
+                return null
+            }
+            return mimeType.split("/").last()
+        }
     }
 }

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

@@ -10,6 +10,15 @@ fun PlayerEvent.getName(): String {
     return "on${this.javaClass.simpleName}"
 }
 
-fun SourceEvent.getName(): String {
-    return "onSource${this.javaClass.simpleName}"
+/**
+ * TODO: Until a certain point, all source events supported by this library followed the pattern
+ *  `onSource{EventName}`. But it's necessary to improve the way how event names are dynamically
+ *   computed based on the event type so they can match the same names provided by iOS and possibly
+ *   other platforms.
+ */
+fun SourceEvent.getName(): String = when (this) {
+    is SourceEvent.SubtitleTrackAdded -> "onSubtitleAdded"
+    is SourceEvent.SubtitleTrackChanged -> "onSubtitleChanged"
+    is SourceEvent.SubtitleTrackRemoved -> "onSubtitleRemoved"
+    else -> "onSource${this.javaClass.simpleName}"
 }

package/ios/DrmModule.m

@@ -0,0 +1,16 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_REMAP_MODULE(DrmModule, DrmModule, NSObject)
+
+RCT_EXTERN_METHOD(initWithConfig:(NSString *)nativeId config:(nullable id)config)
+RCT_EXTERN_METHOD(destroy:(NSString *)nativeId)
+
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedCertificate:(NSString *)nativeId certificate:(NSString *)certificate)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedMessage:(NSString *)nativeId message:(NSString *)message)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedSyncMessage:(NSString *)nativeId syncMessage:(NSString *)syncMessage)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedLicense:(NSString *)nativeId license:(NSString *)license)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedLicenseServerUrl:(NSString *)nativeId url:(NSString *)url)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setPreparedContentId:(NSString *)nativeId contentId:(NSString *)contentId)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(setProvidedLicenseData:(NSString *)nativeId licenseData:(nullable NSString *)licenseData)
+
+@end