@100mslive/react-native-hms 2.0.0-alpha.0 → 2.0.0-alpha.1

package/ios/HMSHLSPlayerManager.swift

@@ -5,8 +5,8 @@ import AVKit.AVPlayerViewController
 typealias HmsHlsPlayer = HMSHLSPlayerSDK.HMSHLSPlayer
 
 @objc(HMSHLSPlayerManager)
-class HMSHLSPlayerManager: RCTViewManager {
-    override func view() -> (HMSHLSPlayer) {
+public class HMSHLSPlayerManager: RCTViewManager {
+    override public func view() -> (HMSHLSPlayer) {
         let view = HMSHLSPlayer()
         let hms = getHmsFromBridge()
 
@@ -16,80 +16,120 @@ class HMSHLSPlayerManager: RCTViewManager {
     }
 
     func getHmsFromBridge() -> [String: HMSRNSDK] {
-        let collection = (bridge.module(for: HMSManager.classForCoder()) as? HMSManager)?.hmsCollection ?? [String: HMSRNSDK]()
-        return collection
+        return HMSManager.shared?.hmsCollection ?? [String: HMSRNSDK]()
     }
 
-    override class func requiresMainQueueSetup() -> Bool {
+    public override class func requiresMainQueueSetup() -> Bool {
         true
     }
 
-    @objc func play(_ node: NSNumber, url: String? = nil) {
+    /// Look up the `HMSHLSPlayer` view for a given React tag and dispatch a
+    /// command to it. Logs (instead of silently failing) when:
+    ///   - `self.bridge` is nil — happens under bridgeless mode where the
+    ///     Fabric path (HMSHLSPlayerComponentView) handles commands directly.
+    ///     This old-arch fallback path firing under bridgeless indicates a
+    ///     misregistration worth surfacing.
+    ///   - No `HMSHLSPlayer` is found for the given React tag — the view may
+    ///     have been detached, or the tag is invalid.
+    /// Must be called on the main queue.
+    private func withComponent(for node: NSNumber, command: String, _ block: (HMSHLSPlayer) -> Void) {
+        guard let bridge = self.bridge else {
+            NSLog("[HMSHLSPlayerManager] \(command): bridge is nil — Fabric path expected to handle this")
+            return
+        }
+        guard let component = bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer else {
+            NSLog("[HMSHLSPlayerManager] \(command): no HMSHLSPlayer found for reactTag=\(node)")
+            return
+        }
+        block(component)
+    }
+
+    @objc public func play(_ node: NSNumber, url: String? = nil) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.play(url)
-            }
+            self.withComponent(for: node, command: "play") { $0.play(url) }
         }
     }
 
-    @objc func stop(_ node: NSNumber) {
+    @objc public func stop(_ node: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.stop()
-            }
+            self.withComponent(for: node, command: "stop") { $0.stop() }
         }
     }
 
-    @objc func pause(_ node: NSNumber) {
+    @objc public func pause(_ node: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.pause()
-            }
+            self.withComponent(for: node, command: "pause") { $0.pause() }
         }
     }
 
-    @objc func resume(_ node: NSNumber) {
+    @objc public func resume(_ node: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.resume()
-            }
+            self.withComponent(for: node, command: "resume") { $0.resume() }
         }
     }
 
-    @objc func seekToLivePosition(_ node: NSNumber) {
+    @objc public func seekToLivePosition(_ node: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.seekToLivePosition()
-            }
+            self.withComponent(for: node, command: "seekToLivePosition") { $0.seekToLivePosition() }
+        }
+    }
+
+    @objc public func seekForward(_ node: NSNumber, seconds: NSNumber) {
+        DispatchQueue.main.async {
+            self.withComponent(for: node, command: "seekForward") { $0.seekForward(Double(truncating: seconds)) }
+        }
+    }
+
+    @objc public func seekBackward(_ node: NSNumber, seconds: NSNumber) {
+        DispatchQueue.main.async {
+            self.withComponent(for: node, command: "seekBackward") { $0.seekBackward(Double(truncating: seconds)) }
+        }
+    }
+
+    @objc public func setVolume(_ node: NSNumber, level: NSNumber) {
+        DispatchQueue.main.async {
+            self.withComponent(for: node, command: "setVolume") { $0.setVolume(Int(truncating: level)) }
         }
     }
 
-    @objc func seekForward(_ node: NSNumber, seconds: NSNumber) {
+    @objc public func areClosedCaptionSupported(_ node: NSNumber, requestId: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.seekForward(Double(truncating: seconds))
+            self.withComponent(for: node, command: "areClosedCaptionSupported") {
+                $0.areClosedCaptionSupported(requestId: UInt(truncating: requestId))
             }
         }
     }
 
-    @objc func seekBackward(_ node: NSNumber, seconds: NSNumber) {
+    @objc public func isClosedCaptionEnabled(_ node: NSNumber, requestId: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.seekBackward(Double(truncating: seconds))
+            self.withComponent(for: node, command: "isClosedCaptionEnabled") {
+                $0.isClosedCaptionEnabled(requestId: UInt(truncating: requestId))
             }
         }
     }
 
-    @objc func setVolume(_ node: NSNumber, level: NSNumber) {
+    @objc public func enableClosedCaption(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            self.withComponent(for: node, command: "enableClosedCaption") { $0.enableClosedCaption() }
+        }
+    }
+
+    @objc public func disableClosedCaption(_ node: NSNumber) {
+        DispatchQueue.main.async {
+            self.withComponent(for: node, command: "disableClosedCaption") { $0.disableClosedCaption() }
+        }
+    }
+
+    @objc public func getPlayerDurationDetails(_ node: NSNumber, requestId: NSNumber) {
         DispatchQueue.main.async {
-            if let component = self.bridge.uiManager.view(forReactTag: node) as? HMSHLSPlayer {
-                component.setVolume(Int(truncating: level))
+            self.withComponent(for: node, command: "getPlayerDurationDetails") {
+                $0.getPlayerDurationDetails(requestId: UInt(truncating: requestId))
             }
         }
     }
 }
 
-class HMSHLSPlayer: UIView {
+public class HMSHLSPlayer: UIView {
     // MARK: class instance properties
     var hlsStatsTimerRef: Timer?
     var eventController: HLSPlaybackEventController?
@@ -97,25 +137,38 @@ class HMSHLSPlayer: UIView {
     lazy var hmsHLSPlayer = HmsHlsPlayer()
 
     // MARK: Handle HMSRNSDK Instance in HMSHLSPlayer instance
-    var hmsCollection = [String: HMSRNSDK]()
-
+    // Read live from HMSManager.shared on every access. Previously this was a
+    // stored snapshot taken at view creation time (via `setHms`), which left
+    // the view holding references to destroyed HMSRNSDK instances after a
+    // leave → rejoin cycle (the SDK destroys & recreates instances; the
+    // snapshot stayed stale → HLS streaming state lookup returned nil →
+    // playback broken on rejoin). Same fix as `HmssdkDisplayView`.
+    var hmsCollection: [String: HMSRNSDK] {
+        return HMSManager.shared?.hmsCollection ?? [String: HMSRNSDK]()
+    }
+
+    // Kept as a no-op for backward compatibility with the paper view
+    // manager's `view()` factory, which still calls this. The actual lookup
+    // is now live via the computed `hmsCollection` above.
     func setHms(_ hmsInstance: [String: HMSRNSDK]) {
-        hmsCollection = hmsInstance
+        // Intentionally empty — hmsCollection is now computed.
     }
 
     // MARK: Handle HMSHLSPlayer RN Component props
 
-    @objc var onHmsHlsPlaybackEvent: RCTDirectEventBlock?
+    @objc public var onDataReturned: RCTDirectEventBlock?
+
+    @objc public var onHmsHlsPlaybackEvent: RCTDirectEventBlock?
 
-    @objc var onHmsHlsStatsEvent: RCTDirectEventBlock?
+    @objc public var onHmsHlsStatsEvent: RCTDirectEventBlock?
 
-    @objc var url: String? {
+    @objc public var url: String? {
         didSet {
             play(url)
         }
     }
 
-    @objc var enableStats: Bool = false {
+    @objc public var enableStats: Bool = false {
         didSet {
             if enableStats == true {
                 attachHLSPlayerStatsListener()
@@ -129,7 +182,7 @@ class HMSHLSPlayer: UIView {
         }
     }
 
-    @objc var enableControls: Bool = true {
+    @objc public var enableControls: Bool = true {
         didSet {
             hmsHLSPlayerViewController?.showsPlaybackControls = enableControls
         }
@@ -137,7 +190,7 @@ class HMSHLSPlayer: UIView {
 
     // MARK: Handle HMSHLSPlayer RN Component methods
 
-    @objc func play(_ url: String?) {
+    @objc public func play(_ url: String?) {
         if let validURLString = url, !validURLString.isEmpty {
             if let urlInstance = URL(string: validURLString) {
                 hmsHLSPlayer.play(urlInstance)
@@ -149,40 +202,131 @@ class HMSHLSPlayer: UIView {
             return
         }
 
-        if hlsStreamingState.running && !hlsStreamingState.variants.isEmpty {
+        if hlsStreamingState.state == .started && !hlsStreamingState.variants.isEmpty {
             hmsHLSPlayer.play(hlsStreamingState.variants[0].meetingURL)
         }
     }
 
-    @objc func stop() {
+    @objc public func stop() {
         hmsHLSPlayer.stop()
     }
 
-    @objc func pause() {
+    private func isCCSupported() -> Bool {
+        guard let playerItem = hmsHLSPlayer._nativePlayer.currentItem else {
+            return false
+        }
+        guard let mediaSelectionGroup = playerItem.asset.mediaSelectionGroup(forMediaCharacteristic: .legible) else {
+            return false
+        }
+        guard let firstMediaSelectionGroupOption = mediaSelectionGroup.options.first else {
+            return false
+        }
+        return firstMediaSelectionGroupOption.mediaType == .subtitle
+    }
+
+    private func isCCEnabled() -> Bool {
+        guard let playerItem = hmsHLSPlayer._nativePlayer.currentItem else {
+            return false
+        }
+        guard let subtitle = playerItem.asset.mediaSelectionGroup(forMediaCharacteristic: .legible) else {
+            return false
+        }
+        let selectedOption = playerItem.currentMediaSelection.selectedMediaOption(in: subtitle)
+        return selectedOption != nil
+    }
+
+    @objc public func areClosedCaptionSupported(requestId: UInt) {
+        let supported = isCCSupported()
+
+        sendRequestedDataToJS(requestId, supported)
+    }
+
+    @objc public func isClosedCaptionEnabled(requestId: UInt) {
+        let enabled = isCCEnabled()
+
+        sendRequestedDataToJS(requestId, enabled)
+    }
+
+    @objc public func enableClosedCaption() {
+        if !isCCSupported() {
+            print("#func Closed Caption is not supported")
+            return
+        }
+        if isCCEnabled() {
+            print("#func Closed Caption already enabled!")
+            return
+        }
+        guard let playerItem = hmsHLSPlayer._nativePlayer.currentItem else {
+            return
+        }
+        guard let subtitle = playerItem.asset.mediaSelectionGroup(forMediaCharacteristic: .legible) else {
+            return
+        }
+        guard let firstSubtitleTrack = subtitle.options.first(where: {$0.mediaType == .subtitle}) else {
+            return
+        }
+        playerItem.select(firstSubtitleTrack, in: subtitle)
+    }
+
+    @objc public func disableClosedCaption() {
+        if !isCCSupported() {
+            print("#func Closed Caption is not supported")
+            return
+        }
+        if !isCCEnabled() {
+            print("#func Closed Caption already disabled!")
+            return
+        }
+        guard let playerItem = hmsHLSPlayer._nativePlayer.currentItem else {
+            return
+        }
+        guard let subtitle = playerItem.asset.mediaSelectionGroup(forMediaCharacteristic: .legible) else {
+            return
+        }
+        playerItem.select(nil, in: subtitle)
+    }
+
+    @objc public func getPlayerDurationDetails(requestId: UInt) {
+        var map = [String: Any?]()
+        guard let playerItem = hmsHLSPlayer._nativePlayer.currentItem else {
+          sendRequestedDataToJS(requestId, map)
+          return
+        }
+        // If duration is known
+        if !playerItem.duration.isIndefinite {
+            map["streamDuration"] = playerItem.duration.seconds
+        }
+        if let timeRange = playerItem.seekableTimeRanges.last as? CMTimeRange {
+            map["rollingWindowTime"] = timeRange.duration.seconds * 1000
+        }
+        sendRequestedDataToJS(requestId, map)
+    }
+
+    @objc public func pause() {
         hmsHLSPlayer.pause()
     }
 
-    @objc func resume() {
+    @objc public func resume() {
         hmsHLSPlayer.resume()
     }
 
-    @objc func seekForward(_ seconds: Double) {
+    @objc public func seekForward(_ seconds: Double) {
         hmsHLSPlayer.seekForward(seconds: seconds)
     }
 
-    @objc func seekBackward(_ seconds: Double) {
+    @objc public func seekBackward(_ seconds: Double) {
         hmsHLSPlayer.seekBackward(seconds: seconds)
     }
 
-    @objc func seekToLivePosition() {
+    @objc public func seekToLivePosition() {
         hmsHLSPlayer.seekToLivePosition()
     }
 
-    @objc func setVolume(_ level: Int) {
+    @objc public func setVolume(_ level: Int) {
         hmsHLSPlayer.volume = level
     }
 
-    // MARK: Constructor & Deconstructor
+    // MARK: Lifecycle methods
 
     override init(frame: CGRect) {
         super.init(frame: frame)
@@ -191,6 +335,10 @@ class HMSHLSPlayer: UIView {
         self.frame = frame
         self.backgroundColor = UIColor(displayP3Red: 0, green: 0, blue: 0, alpha: 1)
 
+        if #available(iOS 15.0, *) {
+            hmsHLSPlayer._nativePlayer.audiovisualBackgroundPlaybackPolicy = .continuesIfPossible
+        }
+
         // creating 100ms HLS Player and getting player view controller
         let playerViewController = hmsHLSPlayer.videoPlayerViewController(showsPlayerControls: false)
         hmsHLSPlayerViewController = playerViewController
@@ -202,7 +350,10 @@ class HMSHLSPlayer: UIView {
         attachPlayerPlaybackListeners()
 
         hmsHLSPlayerViewController?.showsPlaybackControls = false
-        hmsHLSPlayerViewController?.allowsPictureInPicturePlayback = false
+        hmsHLSPlayerViewController?.allowsPictureInPicturePlayback = true
+        if #available(iOS 14.2, *) {
+            hmsHLSPlayerViewController?.canStartPictureInPictureAutomaticallyFromInline = true
+        }
     }
 
     required init?(coder: NSCoder) {
@@ -214,7 +365,7 @@ class HMSHLSPlayer: UIView {
     }
 
     // MARK: Utility functions
-    func cleanup() {
+    public func cleanup() {
         hmsHLSPlayer.stop()
 
         // Remove HLS player playback events
@@ -230,6 +381,12 @@ class HMSHLSPlayer: UIView {
         onHmsHlsPlaybackEvent(["event": eventName, "data": data])
     }
 
+    private func sendRequestedDataToJS(_ requestId: UInt, _ data: Any) {
+        guard let onDataReturned = onDataReturned else { return }
+
+        onDataReturned(["requestId": requestId, "data": data])
+    }
+
     private func sendHLSStatsEventToJS(_ eventName: String, _ data: [String: Any]) {
         guard let onHmsHlsStatsEvent = onHmsHlsStatsEvent else { return }
 
@@ -308,18 +465,31 @@ class HMSHLSPlayer: UIView {
         sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_FAILURE_EVENT, data)
     }
 
-    fileprivate func onPlaybackStateChanged(state: HMSHLSPlaybackState? = nil, videoSizeChanged: Bool = false, aspectRatio: Double? = nil) {
+    fileprivate func onPlaybackStateChanged(state: HMSHLSPlaybackState) {
         guard onHmsHlsPlaybackEvent != nil else { return }
 
         var data = [String: Any]()
 
-        data["state"] = videoSizeChanged ? "onVideoSizeChanged" : state?.description
+        data["state"] = state.description
+
+        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_STATE_CHANGE_EVENT, data)
+    }
 
-        if let aspectRatio = aspectRatio {
-            data["aspectRatio"] = aspectRatio
+    fileprivate func onResolutionChanged(videoSize: CGSize) {
+        if videoSize.width >= videoSize.height {
+            hmsHLSPlayerViewController?.videoGravity = .resizeAspect
+        } else {
+            hmsHLSPlayerViewController?.videoGravity = .resizeAspectFill
         }
 
-        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_STATE_CHANGE_EVENT, data)
+        guard onHmsHlsPlaybackEvent != nil else { return }
+
+        var data = [String: Any]()
+
+        data["width"] = videoSize.width
+        data["height"] = videoSize.height
+
+        sendHLSPlaybackEventToJS(HMSHLSPlayerConstants.ON_PLAYBACK_RESOLUTION_CHANGE_EVENT, data)
     }
 }
 
@@ -330,25 +500,20 @@ class HLSPlaybackEventController: HMSHLSPlayerDelegate {
         self.hmsHlsPlayerDelegate = hmsPlayerDelegate
     }
 
-    func onPlaybackStateChanged(state: HMSHLSPlaybackState) {
+    public func onPlaybackStateChanged(state: HMSHLSPlaybackState) {
         hmsHlsPlayerDelegate?.onPlaybackStateChanged(state: state)
     }
 
-    func onCue(cue: HMSHLSCue) {
+    public func onCue(cue: HMSHLSCue) {
         hmsHlsPlayerDelegate?.onCue(cue: cue)
     }
 
-    func onPlaybackFailure(error: Error) {
+    public func onPlaybackFailure(error: Error) {
         hmsHlsPlayerDelegate?.onPlaybackFailure(error: error)
     }
 
-    func onResolutionChanged(videoSize: CGSize) {
-        if videoSize.width >= videoSize.height {
-            hmsHlsPlayerDelegate?.hmsHLSPlayerViewController?.videoGravity = .resizeAspect
-        } else {
-            hmsHlsPlayerDelegate?.hmsHLSPlayerViewController?.videoGravity = .resizeAspectFill
-        }
-        hmsHlsPlayerDelegate?.onPlaybackStateChanged(videoSizeChanged: true, aspectRatio: videoSize.width/videoSize.height)
+    public func onResolutionChanged(videoSize: CGSize) {
+        hmsHlsPlayerDelegate?.onResolutionChanged(videoSize: videoSize)
     }
 }
 
@@ -357,6 +522,7 @@ enum HMSHLSPlayerConstants {
     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"
+    static let ON_PLAYBACK_RESOLUTION_CHANGE_EVENT = "ON_PLAYBACK_RESOLUTION_CHANGE_EVENT"
 
     // HLS Playback Stats Events
     static let ON_STATS_EVENT_UPDATE = "ON_STATS_EVENT_UPDATE"