@100mslive/react-native-hms 1.6.2 → 1.7.1

package/ios/HMSHLSPlayerManager.swift

@@ -0,0 +1,368 @@
+import HMSSDK
+import HMSHLSPlayerSDK
+import AVKit.AVPlayerViewController
+
+typealias HmsHlsPlayer = HMSHLSPlayerSDK.HMSHLSPlayer
+
+@objc(HMSHLSPlayerManager)
+class HMSHLSPlayerManager: RCTViewManager {
+    override func view() -> (HMSHLSPlayer) {
+        let view = HMSHLSPlayer()
+        let hms = getHmsFromBridge()
+
+        view.setHms(hms)
+
+        return view
+    }
+
+    func getHmsFromBridge() -> [String: HMSRNSDK] {
+        let collection = (bridge.module(for: HMSManager.classForCoder()) as? HMSManager)?.hmsCollection ?? [String: HMSRNSDK]()
+        return collection
+    }
+
+    override class func requiresMainQueueSetup() -> Bool {
+        true
+    }
+
+    @objc func play(_ node: NSNumber, url: String? = nil) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.play(url)
+            }
+        }
+    }
+
+    @objc func stop(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.stop()
+            }
+        }
+    }
+
+    @objc func pause(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.pause()
+            }
+        }
+    }
+
+    @objc func resume(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.resume()
+            }
+        }
+    }
+
+    @objc func seekToLivePosition(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.seekToLivePosition()
+            }
+        }
+    }
+
+    @objc func seekForward(_ node: NSNumber, seconds: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.seekForward(Double(truncating: seconds))
+            }
+        }
+    }
+
+    @objc func seekBackward(_ node: NSNumber, seconds: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.seekBackward(Double(truncating: seconds))
+            }
+        }
+    }
+
+    @objc func setVolume(_ node: NSNumber, level: NSNumber) {
+        DispatchQueue.main.async {
+            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
+                component.setVolume(Int(truncating: level))
+            }
+        }
+    }
+}
+
+class HMSHLSPlayer: UIView {
+    // MARK: class instance properties
+    var hlsStatsTimerRef: Timer?
+    var eventController: HLSPlaybackEventController?
+    var hmsHLSPlayerViewController: AVPlayerViewController?
+    lazy var hmsHLSPlayer = HmsHlsPlayer()
+
+    // MARK: Handle HMSRNSDK Instance in HMSHLSPlayer instance
+    var hmsCollection = [String: HMSRNSDK]()
+
+    func setHms(_ hmsInstance: [String: HMSRNSDK]) {
+        hmsCollection = hmsInstance
+    }
+
+    // MARK: Handle HMSHLSPlayer RN Component props
+
+    @objc var onHmsHlsPlaybackEvent: RCTDirectEventBlock?
+
+    @objc var onHmsHlsStatsEvent: RCTDirectEventBlock?
+
+    @objc var url: String? {
+        didSet {
+            play(url)
+        }
+    }
+
+    @objc var enableStats: Bool = false {
+        didSet {
+            if enableStats == true {
+                attachHLSPlayerStatsListener()
+            } else {
+                // If we have existing Stats Timer, Invalidate it
+                if let hlsStatsTimer = hlsStatsTimerRef {
+                    hlsStatsTimer.invalidate()
+                    hlsStatsTimerRef = nil
+                }
+            }
+        }
+    }
+
+    @objc var enableControls: Bool = true {
+        didSet {
+            hmsHLSPlayerViewController?.showsPlaybackControls = enableControls
+        }
+    }
+
+    // MARK: Handle HMSHLSPlayer RN Component methods
+
+    @objc func play(_ url: String?) {
+        if let validURLString = url, !validURLString.isEmpty {
+            if let urlInstance = URL(string: validURLString) {
+                hmsHLSPlayer.play(urlInstance)
+            }
+            return
+        }
+
+        guard let hlsStreamingState = hmsCollection["12345"]?.hms?.room?.hlsStreamingState else {
+            return
+        }
+
+        if hlsStreamingState.running && !hlsStreamingState.variants.isEmpty {
+            hmsHLSPlayer.play(hlsStreamingState.variants[0].meetingURL)
+        }
+    }
+
+    @objc func stop() {
+        hmsHLSPlayer.stop()
+    }
+
+    @objc func pause() {
+        hmsHLSPlayer.pause()
+    }
+
+    @objc func resume() {
+        hmsHLSPlayer.resume()
+    }
+
+    @objc func seekForward(_ seconds: Double) {
+        hmsHLSPlayer.seekForward(seconds: seconds)
+    }
+
+    @objc func seekBackward(_ seconds: Double) {
+        hmsHLSPlayer.seekBackward(seconds: seconds)
+    }
+
+    @objc func seekToLivePosition() {
+        hmsHLSPlayer.seekToLivePosition()
+    }
+
+    @objc func setVolume(_ level: Int) {
+        hmsHLSPlayer.volume = level
+    }
+
+    // MARK: Constructor & Deconstructor
+
+    override init(frame: CGRect) {
+        super.init(frame: frame)
+
+        // setting properties on current UIView
+        self.frame = frame
+        self.backgroundColor = UIColor(displayP3Red: 0, green: 0, blue: 0, alpha: 1)
+
+        // creating 100ms HLS Player and getting player view controller
+        let playerViewController = hmsHLSPlayer.videoPlayerViewController(showsPlayerControls: false)
+        hmsHLSPlayerViewController = playerViewController
+        playerViewController.view.frame = self.bounds
+
+        // Setting 100ms HLS Player as subview of current UIView
+        self.addSubview(playerViewController.view)
+
+        attachPlayerPlaybackListeners()
+    }
+
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+
+    deinit {
+        cleanup()
+    }
+
+    // MARK: Utility functions
+    func cleanup() {
+        hmsHLSPlayer.stop()
+
+        // Remove HLS player playback events
+        hmsHLSPlayer.delegate = nil
+
+        // Remove HLS player stats timer
+        hlsStatsTimerRef?.invalidate()
+    }
+
+    private func sendHLSPlaybackEventToJS(_ eventName: String, _ data: [String: Any]) {
+        guard let onHmsHlsPlaybackEvent = onHmsHlsPlaybackEvent else { return }
+
+        onHmsHlsPlaybackEvent(["event": eventName, "data": data])
+    }
+
+    private func sendHLSStatsEventToJS(_ eventName: String, _ data: [String: Any]) {
+        guard let onHmsHlsStatsEvent = onHmsHlsStatsEvent else { return }
+
+        onHmsHlsStatsEvent(["event": eventName, "data": data])
+    }
+
+    private func attachPlayerPlaybackListeners() {
+        // Attaching HLS Player Playback Events Listener
+        eventController = HLSPlaybackEventController(self)
+        hmsHLSPlayer.delegate = eventController
+    }
+
+    private func attachHLSPlayerStatsListener() {
+        // Only Attach listener, if there is no previously attached listener
+        if hlsStatsTimerRef == nil {
+
+            // Attaching HLS Player Stats Event Listener
+            hlsStatsTimerRef = Timer.scheduledTimer(withTimeInterval: 2.0, repeats: true) { [weak self] _ in
+                guard let self = self, self.onHmsHlsStatsEvent != nil else { return }
+
+                let statsMonitor = self.hmsHLSPlayer.statMonitor
+
+                var data = [String: Any]()
+
+                // bandwidth
+                data["bandWidthEstimate"] = statsMonitor.estimatedBandwidth
+                data["totalBytesLoaded"] = statsMonitor.bytesDownloaded
+
+                // bufferedDuration
+                data["bufferedDuration"] = statsMonitor.bufferedDuration
+
+                // distanceFromLive
+                data["distanceFromLive"] = statsMonitor.distanceFromLiveEdge
+
+                // frameInfo
+                data["droppedFrameCount"] = statsMonitor.droppedFrames
+
+                // videoInfo
+                data["averageBitrate"] = statsMonitor.bitrate
+                data["videoHeight"] = statsMonitor.videoSize.height
+                data["videoWidth"] = statsMonitor.videoSize.width
+
+                self.sendHLSStatsEventToJS(HMSHLSPlayerConstants.ON_STATS_EVENT_UPDATE, data)
+            }
+        }
+    }
+
+    fileprivate func onCue(cue: HMSHLSCue) {
+        guard onHmsHlsPlaybackEvent != nil else { return }
+
+        var data = [String: Any]()
+
+        data["id"] = cue.id
+        data["startDate"] = String(cue.startDate.timeIntervalSince1970)
+        if let endDate = cue.endDate {
+            data["endDate"] = String(endDate.timeIntervalSince1970)
+        }
+        if let payload = cue.payload {
+            data["payloadval"] = payload
+        }
+
+        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_CUE_EVENT, data)
+    }
+
+    fileprivate func onPlaybackFailure(error: Error) {
+        guard onHmsHlsPlaybackEvent != nil else { return }
+
+        var data = [String: Any]()
+
+        data["error"] = [
+            "errorCode": error.localizedDescription,
+            "errorCodeName": error.localizedDescription,
+            "message": error.localizedDescription
+        ]
+
+        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_FAILURE_EVENT, data)
+    }
+
+    fileprivate func onPlaybackStateChanged(state: HMSHLSPlaybackState) {
+        guard onHmsHlsPlaybackEvent != nil else { return }
+
+        var data = [String: Any]()
+
+        data["state"] = state.description
+
+        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_STATE_CHANGE_EVENT, data)
+    }
+}
+
+class HLSPlaybackEventController: HMSHLSPlayerDelegate {
+    weak var hmsHlsPlayerDelegate: HMSHLSPlayer?
+
+    init(_ hmsPlayerDelegate: HMSHLSPlayer) {
+        self.hmsHlsPlayerDelegate = hmsPlayerDelegate
+    }
+
+    func onPlaybackStateChanged(state: HMSHLSPlaybackState) {
+        hmsHlsPlayerDelegate?.onPlaybackStateChanged(state: state)
+    }
+
+    func onCue(cue: HMSHLSCue) {
+        hmsHlsPlayerDelegate?.onCue(cue: cue)
+    }
+
+    func onPlaybackFailure(error: Error) {
+        hmsHlsPlayerDelegate?.onPlaybackFailure(error: error)
+    }
+}
+
+enum HMSHLSPlayerConstants {
+    // HLS Playback Events
+    static let ON_PLAYBACK_CUE_EVENT = "ON_PLAYBACK_CUE_EVENT"
+    static let ON_PLAYBACK_FAILURE_EVENT = "ON_PLAYBACK_FAILURE_EVENT"
+    static let ON_PLAYBACK_STATE_CHANGE_EVENT = "ON_PLAYBACK_STATE_CHANGE_EVENT"
+
+    // HLS Playback Stats Events
+    static let ON_STATS_EVENT_UPDATE = "ON_STATS_EVENT_UPDATE"
+}
+
+extension HMSHLSPlaybackState: CustomStringConvertible {
+    public var description: String {
+        switch self {
+        case .buffering:
+            return "buffering"
+        case .failed:
+            return "failed"
+        case .paused:
+            return "paused"
+        case .playing:
+            return "playing"
+        case .stopped:
+            return "stopped"
+        case .unknown:
+            return "unknown"
+        @unknown default:
+            return "unknown"
+        }
+    }
+}

package/ios/HMSHelper.swift

@@ -139,11 +139,15 @@ class HMSHelper: NSObject {
     static func getFrameworkInfo(_ frameworkInfo: NSDictionary?) -> HMSFrameworkInfo? {
         guard let data = frameworkInfo,
               let version = data.value(forKey: "version") as? String,
-              let sdkVersion = data.value(forKey: "sdkVersion") as? String
+              let sdkVersion = data.value(forKey: "sdkVersion") as? String,
+                let isPrebuilt = data["isPrebuilt"] as? Bool
         else {
             return nil
         }
-        return HMSFrameworkInfo(type: HMSFrameworkType.reactNative, version: version, sdkVersion: sdkVersion)
+        return HMSFrameworkInfo(type: HMSFrameworkType.reactNative,
+                                version: version,
+                                sdkVersion: sdkVersion,
+                                isPrebuilt: isPrebuilt)
     }
 
     static func getLocalVideoSettings(_ settings: NSDictionary?) -> HMSVideoTrackSettings? {

package/ios/HMSManager.m

@@ -38,6 +38,7 @@ RCT_EXTERN_METHOD(destroy: (NSDictionary) data :(RCTPromiseResolveBlock) resolve
 RCT_EXTERN_METHOD(startScreenshare: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(stopScreenshare: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(isScreenShared: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
+RCT_EXTERN_METHOD(switchAudioOutputUsingIOSUI: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(playAudioShare: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(setAudioShareVolume: (NSDictionary) data)
 RCT_EXTERN_METHOD(stopAudioShare: (NSDictionary) data)
@@ -51,8 +52,6 @@ RCT_EXTERN_METHOD(getRemotePeers: (NSDictionary) data :(RCTPromiseResolveBlock)
 RCT_EXTERN_METHOD(getRoles: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(enableNetworkQualityUpdates: (NSDictionary) data)
 RCT_EXTERN_METHOD(disableNetworkQualityUpdates: (NSDictionary) data)
-RCT_EXTERN_METHOD(setSessionMetaData: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
-RCT_EXTERN_METHOD(getSessionMetaData: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(changeRoleOfPeer: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(changeRoleOfPeersWithRoles: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 
@@ -80,4 +79,8 @@ RCT_EXTERN_METHOD(setSessionMetadataForKey: (NSDictionary) data :(RCTPromiseReso
 RCT_EXTERN_METHOD(addKeyChangeListener: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 RCT_EXTERN_METHOD(removeKeyChangeListener: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
 
+#pragma mark - Prebuilt
+
+RCT_EXTERN_METHOD(getRoomLayout: (NSDictionary) data :(RCTPromiseResolveBlock) resolve :(RCTPromiseRejectBlock) reject)
+
 @end

package/ios/HMSManager.swift

@@ -1,4 +1,5 @@
 import HMSSDK
+import AVKit.AVRoutePickerView
 
 @objc(HMSManager)
 class HMSManager: RCTEventEmitter {
@@ -74,6 +75,14 @@ class HMSManager: RCTEventEmitter {
         resolve?(["success": id + " removed"])
     }
 
+    // MARK: - Prebuilt
+
+    @objc
+    func getRoomLayout(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+        let hms = HMSHelper.getHms(data, hmsCollection)
+        hms?.getRoomLayout(data, resolve, reject)
+    }
+
     // MARK: - Preview
 
     @objc
@@ -182,6 +191,27 @@ class HMSManager: RCTEventEmitter {
         hms?.setVolume(data)
     }
 
+    @objc
+    func switchAudioOutputUsingIOSUI(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
+        DispatchQueue.main.async {
+            // Creating RoutePickerView
+            // Note:- We will trigger tap event on it without rendering this view in UI.
+            let routePickerView = AVRoutePickerView()
+
+            // Iterating over subviews of AVRoutePickerView
+            for view in routePickerView.subviews {
+                // Checking if the current subview is UIButton
+                if let button = view as? UIButton {
+                    // Trigger tap event on the button
+                    // so, that Picker View is shown
+                    button.sendActions(for: .touchUpInside)
+                    break
+                }
+            }
+            resolve?(true)
+        }
+    }
+
     // MARK: - Messaging
 
     @objc
@@ -411,15 +441,6 @@ class HMSManager: RCTEventEmitter {
         hms?.disableNetworkQualityUpdates()
     }
 
-    // MARK: - Session Metadata
-
-    @objc
-    func setSessionMetaData(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
-        let hms = HMSHelper.getHms(data, hmsCollection)
-
-        hms?.setSessionMetaData(data, resolve, reject)
-    }
-
     // MARK: - Peer & Room Property Getter Functions
 
     @objc
@@ -499,13 +520,6 @@ class HMSManager: RCTEventEmitter {
         hms?.getRoles(resolve)
     }
 
-    @objc
-    func getSessionMetaData(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
-        let hms = HMSHelper.getHms(data, hmsCollection)
-
-        hms?.getSessionMetaData(resolve, reject)
-    }
-
     @objc
     func getRemoteVideoTrackFromTrackId(_ data: NSDictionary, _ resolve: RCTPromiseResolveBlock?, _ reject: RCTPromiseRejectBlock?) {
         let hms = HMSHelper.getHms(data, hmsCollection)