bitmovin-player-react-native 0.1.0 → 0.2.0

package/ios/RNPlayerView.swift

@@ -2,7 +2,7 @@ import BitmovinPlayer
 
 @objc(RNPlayerView)
 class RNPlayerView: UIView {
-    /// Component events.
+    /// React component events. Directly mapped to props in `NativePlayerView`.
     @objc var onEvent: RCTBubblingEventBlock?
     @objc var onPlayerActive: RCTBubblingEventBlock?
     @objc var onPlayerError: RCTBubblingEventBlock?
@@ -23,9 +23,11 @@ class RNPlayerView: UIView {
     @objc var onSourceUnloaded: RCTBubblingEventBlock?
     @objc var onSourceError: RCTBubblingEventBlock?
     @objc var onSourceWarning: RCTBubblingEventBlock?
+    @objc var onSubtitleAdded: RCTBubblingEventBlock?
+    @objc var onSubtitleRemoved: RCTBubblingEventBlock?
+    @objc var onSubtitleChanged: RCTBubblingEventBlock?
 
-    /// Bitmovin's player view.
-    /// Get's initialized when there's a player instance ready to be used.
+    /// The `PlayerView` subview.
     var playerView: PlayerView? {
         willSet {
             newValue?.autoresizingMask = [

package/ios/RNPlayerViewManager.m

@@ -22,8 +22,10 @@ RCT_EXPORT_VIEW_PROPERTY(onSourceLoaded, RCTBubblingEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onSourceUnloaded, RCTBubblingEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onSourceError, RCTBubblingEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onSourceWarning, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSubtitleAdded, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSubtitleRemoved, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSubtitleChanged, RCTBubblingEventBlock)
 
 RCT_EXTERN_METHOD(attachPlayer:(nonnull NSNumber *)viewId playerId:(NSString *)playerId)
-RCT_EXTERN_METHOD(detachPlayer:(nonnull NSNumber *)viewId playerId:(NSString *)playerId)
 
 @end

package/ios/RNPlayerViewManager.swift

@@ -3,8 +3,8 @@ import Foundation
 
 @objc(RNPlayerViewManager)
 class RNPlayerViewManager: RCTViewManager {
-    /// Register module to be initialized on the main thread.
-    override class func requiresMainQueueSetup() -> Bool {
+    /// Initialize module on main thread.
+    override static func requiresMainQueueSetup() -> Bool {
         true
     }
 
@@ -19,11 +19,11 @@ class RNPlayerViewManager: RCTViewManager {
      - Parameter viewId: `RNPlayerView` id inside `UIManager`'s registry.
      - Parameter playerId: `Player` instance id inside `PlayerModule`'s registry.
      */
-    @objc func attachPlayer(_ viewId: NSNumber, playerId: String) {
+    @objc func attachPlayer(_ viewId: NSNumber, playerId: NativeId) {
         bridge.uiManager.addUIBlock { [weak self] _, views in
             guard
                 let view = views?[viewId] as? RNPlayerView,
-                let player = self?.getPlayerModule()?.player(with: playerId)
+                let player = self?.getPlayerModule()?.retrieve(playerId)
             else {
                 return
             }
@@ -35,23 +35,6 @@ class RNPlayerViewManager: RCTViewManager {
             player.add(listener: view)
         }
     }
-    
-    /**
-     Remove `RNPlayerView` from its associated `Player` listeners list.
-     - Parameter viewId: `RNPlayerView` id inside `UIManager`'s registry.
-     - Parameter playerId: `Player` instance id inside `PlayerModule`'s registry.
-     */
-    @objc func detachPlayer(_ viewId: NSNumber, playerId: String) {
-        bridge.uiManager.addUIBlock { [weak self] _, views in
-            guard
-                let view = views?[viewId] as? RNPlayerView,
-                let player = self?.getPlayerModule()?.player(with: playerId)
-            else {
-                return
-            }
-            player.remove(listener: view)
-        }
-    }
 
     /// Fetches the initialized `PlayerModule` instance on RN's bridge object.
     private func getPlayerModule() -> PlayerModule? {

package/ios/Registry.swift

@@ -0,0 +1,5 @@
+/// Represents the `UUID` string used as index for a certain registry object.
+typealias NativeId = String
+
+/// Represents an in memory storage facility that associates an object of type `T` with a certain `NativeId`.
+typealias Registry<T> = [NativeId: T]

package/ios/SourceModule.m

@@ -0,0 +1,30 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_REMAP_MODULE(SourceModule, SourceModule, NSObject)
+
+RCT_EXTERN_METHOD(initWithConfig:(NSString *)nativeId config:(nullable id)config)
+RCT_EXTERN_METHOD(initWithDrmConfig:(NSString *)nativeId drmNativeId:(NSString *)drmNativeId config:(nullable id)config)
+RCT_EXTERN_METHOD(destroy:(NSString *)nativeId)
+RCT_EXTERN_METHOD(
+    isAttachedToPlayer:(NSString *)nativeId
+    resolver:(RCTPromiseResolveBlock)resolve
+    rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(
+    isActive:(NSString *)nativeId
+    resolver:(RCTPromiseResolveBlock)resolve
+    rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(
+    duration:(NSString *)nativeId
+    resolver:(RCTPromiseResolveBlock)resolve
+    rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(
+    loadingState:(NSString *)nativeId
+    resolver:(RCTPromiseResolveBlock)resolve
+    rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(
+    getMetadata:(NSString *)nativeId
+    resolver:(RCTPromiseResolveBlock)resolve
+    rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(setMetadata:(NSString *)nativeId metadata:(nullable id)metadata)
+
+@end

package/ios/SourceModule.swift

@@ -0,0 +1,187 @@
+import BitmovinPlayer
+
+@objc(SourceModule)
+class SourceModule: NSObject, RCTBridgeModule {
+    /// React bridge reference.
+    @objc var bridge: RCTBridge!
+
+    /// In-memory mapping from `nativeId`s to `Source` instances.
+    private var sources: Registry<Source> = [:]
+
+    /// JS module name.
+    static func moduleName() -> String! {
+        "SourceModule"
+    }
+
+    /// Module requires main thread initialization.
+    static func requiresMainQueueSetup() -> Bool {
+        true
+    }
+
+    /// Use `UIManager.addBlock` to enqueue module methods on UI thread.
+    var methodQueue: DispatchQueue! {
+        bridge.uiManager.methodQueue
+    }
+
+    /**
+     Fetches the `Source` instance associated with `nativeId` from internal sources.
+     - Parameter nativeId: `Source` instance ID.
+     - Returns: The associated `Source` instance or `nil`.
+     */
+    @objc func retrieve(_ nativeId: NativeId) -> Source? {
+        sources[nativeId]
+    }
+
+    /**
+     Creates a new `Source` instance inside the internal sources using the provided `config` object.
+     - Parameter nativeId: ID to be associated with the `Source` instance.
+     - Parameter config: `SourceConfig` object received from JS.
+     */
+    @objc(initWithConfig:config:)
+    func initWithConfig(_ nativeId: NativeId, config: Any?) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            guard
+                self?.sources[nativeId] == nil,
+                let sourceConfig = RCTConvert.sourceConfig(config)
+            else {
+                return
+            }
+            self?.sources[nativeId] = SourceFactory.create(from: sourceConfig)
+        }
+    }
+
+    /**
+     Creates a new `Source` instance inside the internal sources using the provided `config` object and an initialized DRM configuration ID.
+     - Parameter nativeId: ID to be associated with the `Source` instance.
+     - Parameter drmNativeId: ID of the DRM config object to use.
+     - Parameter config: `SourceConfig` object received from JS.
+     */
+    @objc(initWithDrmConfig:drmNativeId:config:)
+    func initWithDrmConfig(_ nativeId: NativeId, drmNativeId: NativeId, config: Any?) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            guard
+                self?.sources[nativeId] == nil,
+                let fairplayConfig = self?.getDrmModule()?.retrieve(drmNativeId),
+                let sourceConfig = RCTConvert.sourceConfig(config, drmConfig: fairplayConfig)
+            else {
+                return
+            }
+            self?.sources[nativeId] = SourceFactory.create(from: sourceConfig)
+        }
+    }
+
+    /// Fetches the initialized `DrmModule` instance on RN's bridge object.
+    private func getDrmModule() -> DrmModule? {
+        bridge.module(for: DrmModule.self) as? DrmModule
+    }
+
+    /**
+     Removes the `Source` instance associated with `nativeId` from `sources`.
+     - Parameter nativeId: Instance to be disposed.
+     */
+    @objc(destroy:)
+    func destroy(_ nativeId: NativeId) {
+        sources.removeValue(forKey: nativeId)
+    }
+
+    /**
+     Whether `nativeId` source is currently attached to a player instance.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(isAttachedToPlayer:resolver:rejecter:)
+    func isAttachedToPlayer(
+        _ nativeId: NativeId,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            resolve(self?.sources[nativeId]?.isAttachedToPlayer)
+        }
+    }
+
+    /**
+     Whether `nativeId` source is currently active in a `Player`.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(isActive:resolver:rejecter:)
+    func isActive(
+        _ nativeId: NativeId,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            resolve(self?.sources[nativeId]?.isActive)
+        }
+    }
+
+    /**
+     The duration of `nativeId` source in seconds.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(duration:resolver:rejecter:)
+    func duration(
+        _ nativeId: NativeId,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            resolve(self?.sources[nativeId]?.duration)
+        }
+    }
+
+    /**
+     The current loading state of `nativeId` source.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(loadingState:resolver:rejecter:)
+    func loadingState(
+        _ nativeId: NativeId,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            resolve(self?.sources[nativeId]?.loadingState)
+        }
+    }
+
+    /**
+     Metadata for the currently loaded `nativeId` source.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(getMetadata:resolver:rejecter:)
+    func getMetadata(
+        _ nativeId: NativeId,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            resolve(self?.sources[nativeId]?.metadata)
+        }
+    }
+
+    /**
+     Set the metadata for a loaded `nativeId` source.
+     - Parameter nativeId: Source `nativeId`.
+     - Parameter resolver: JS promise resolver.
+     - Parameter rejecter: JS promise rejecter.
+     */
+    @objc(setMetadata:metadata:)
+    func setMetadata(_ nativeId: NativeId, metadata: Any?) {
+        bridge.uiManager.addUIBlock { [weak self] _, _ in
+            guard let metadata = metadata as? [String: AnyObject] else {
+                return
+            }
+            self?.sources[nativeId]?.metadata = metadata
+        }
+    }
+}

package/ios/UuidModule.m

@@ -0,0 +1,9 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_REMAP_MODULE(UuidModule, UuidModule, NSObject)
+
+// UUID generation is sync and runs on the JS thread so in order to avoid performance
+// issues, it should be as fast as possible.
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(generate)
+
+@end

package/ios/UuidModule.swift

@@ -0,0 +1,23 @@
+/**
+ Native module for easy and fast unique ID generation on JS side. Used to generate native instance IDs.
+ */
+@objc(UuidModule)
+class UuidModule: NSObject, RCTBridgeModule {
+    /// Initialize this module on main thread.
+    static func requiresMainQueueSetup() -> Bool {
+        true
+    }
+
+    /// Exported JS module name.
+    static func moduleName() -> String! {
+        "UuidModule"
+    }
+
+    /**
+     Synchronously generate a random UUIDv4.
+     - Returns: Random UUID RFC 4122 version 4.
+     */
+    @objc func generate() -> String {
+        UUID().uuidString
+    }
+}