@100mslive/react-native-hms 1.10.7 → 1.10.9

package/README.md

@@ -1,5 +1,5 @@
 <a href="https://100ms.live/">
-<img src="https://raw.githubusercontent.com/100mslive/react-native-hms/main/100ms.svg" title="100ms logo" float=center height=256>
+<img src="https://raw.githubusercontent.com/100mslive/react-native-hms/main/100ms.svg" title="100ms logo" float=center height=256 alt="100ms logo">
 </a>
 
 [![npm](https://img.shields.io/npm/v/@100mslive/react-native-hms)](https://www.npmjs.com/package/@100mslive/react-native-hms)
@@ -22,10 +22,11 @@ With support for HLS and RTMP Live Streaming and Recording, Picture-in-Picture (
 
 📖 Read the Complete Documentation here: https://www.100ms.live/docs/react-native/v2/foundation/basics
 
-| Package                          | Version                                                                                                                                 |
-| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| @100mslive/react-native-room-kit | [![npm](https://img.shields.io/npm/v/@100mslive/react-native-room-kit)](https://www.npmjs.com/package/@100mslive/react-native-room-kit) |
-| @100mslive/react-native-hms      | [![npm](https://img.shields.io/npm/v/@100mslive/react-native-hms)](https://www.npmjs.com/package/@100mslive/react-native-hms)           |
+| Package                              | Version                                                                                                                                         |
+| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| @100mslive/react-native-room-kit     | [![npm](https://img.shields.io/npm/v/@100mslive/react-native-room-kit)](https://www.npmjs.com/package/@100mslive/react-native-room-kit)         |
+| @100mslive/react-native-hms          | [![npm](https://img.shields.io/npm/v/@100mslive/react-native-hms)](https://www.npmjs.com/package/@100mslive/react-native-hms)                   |
+| @100mslive/react-native-video-plugin | [![npm](https://img.shields.io/npm/v/@100mslive/react-native-video-plugin)](https://www.npmjs.com/package/@100mslive/react-native-video-plugin) |
 
 ## 🏃 Example App
 

package/android/src/main/java/com/reactnativehmssdk/HMSManager.kt

@@ -21,6 +21,7 @@ import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.reactnativehmssdk.HMSManager.Companion.REACT_CLASS
 import live.hms.video.error.HMSException
 import live.hms.video.factories.noisecancellation.AvailabilityStatus
+import live.hms.video.sdk.HMSActionResultListener
 import java.util.UUID
 
 @ReactModule(name = REACT_CLASS)
@@ -1092,7 +1093,7 @@ class HMSManager(
       activity.setPictureInPictureParams(pipParams)
       return true
     } catch (e: Exception) {
-      throw e
+      return false
     }
   }
 
@@ -1127,7 +1128,7 @@ class HMSManager(
 
       return activity.enterPictureInPictureMode(pipParams)
     } catch (e: Exception) {
-      throw e
+      return false
     }
   }
 
@@ -1517,8 +1518,19 @@ class HMSManager(
         )
         return
       }
-    hmsSdk.setNoiseCancellationEnabled(true)
-    promise?.resolve(true)
+
+    hmsSdk.enableNoiseCancellation(
+      true,
+      object : HMSActionResultListener {
+        override fun onError(error: HMSException) {
+          promise?.reject(error.code.toString(), error.message)
+        }
+
+        override fun onSuccess() {
+          promise?.resolve(true)
+        }
+      },
+    )
   }
 
   @ReactMethod
@@ -1542,8 +1554,18 @@ class HMSManager(
         )
         return
       }
-    hmsSdk.setNoiseCancellationEnabled(false)
-    promise?.resolve(true)
+    hmsSdk.enableNoiseCancellation(
+      false,
+      object : HMSActionResultListener {
+        override fun onError(error: HMSException) {
+          promise?.reject(error.code.toString(), error.message)
+        }
+
+        override fun onSuccess() {
+          promise?.resolve(true)
+        }
+      },
+    )
   }
 
   @ReactMethod
@@ -1567,7 +1589,7 @@ class HMSManager(
         )
         return
       }
-    val isEnabled = hmsSdk.getNoiseCancellationEnabled()
+    val isEnabled = hmsSdk.isNoiseCancellationEnabled()
     promise?.resolve(isEnabled)
   }
 
@@ -1593,7 +1615,7 @@ class HMSManager(
         return
       }
 
-    val availability: AvailabilityStatus = hmsSdk.isNoiseCancellationAvailable()
+    val availability: AvailabilityStatus = hmsSdk.isNoiseCancellationSupported()
     val isAvailable =
       if (availability == AvailabilityStatus.Available) {
         true
@@ -1624,6 +1646,23 @@ class HMSManager(
   }
   // endregion
 
+  @ReactMethod
+  fun setPermissionsAccepted(
+    data: ReadableMap,
+    promise: Promise?,
+  ) {
+    val rnSDK =
+      HMSHelper.getHms(data, hmsCollection) ?: run {
+        promise?.reject(
+          "6004",
+          "RN HMS SDK not initialized",
+        )
+        return
+      }
+    rnSDK.hmsSDK?.setPermissionsAccepted()
+    promise?.resolve(null)
+  }
+
   // region Warning on JS side
   @ReactMethod
   fun addListener(eventName: String) {

package/android/src/main/java/com/reactnativehmssdk/HMSRNSDK.kt

@@ -87,6 +87,13 @@ class HMSRNSDK(
       }
     }
 
+    if (data?.hasKey("haltPreviewJoinForPermissionsRequest") == true) {
+      val halt = data?.getBoolean("haltPreviewJoinForPermissionsRequest")
+      if (halt != null) {
+        builder.haltPreviewJoinForPermissionsRequest(halt)
+      }
+    }
+
     this.hmsSDK = builder.build()
 
     hmsSDK?.let {
@@ -286,6 +293,17 @@ class HMSRNSDK(
             data.putArray("removedPeers", removedPeersArray)
             delegate.emitEvent("ON_PEER_LIST_UPDATED", data)
           }
+
+          override fun onPermissionsRequested(permissions: List<String>) {
+            if (eventsEnableStatus["ON_PERMISSIONS_REQUESTED"] != true) {
+              return
+            }
+            val data: WritableMap = Arguments.createMap()
+
+            data.putArray("permissions", Arguments.fromList(permissions))
+            data.putString("id", id)
+            delegate.emitEvent("ON_PERMISSIONS_REQUESTED", data)
+          }
         },
       )
     } else {
@@ -557,6 +575,17 @@ class HMSRNSDK(
               data.putString("id", id)
               delegate.emitEvent("ON_TRANSCRIPTS", data)
             }
+
+            override fun onPermissionsRequested(permissions: List<String>) {
+              if (eventsEnableStatus["ON_PERMISSIONS_REQUESTED"] != true) {
+                return
+              }
+              val data: WritableMap = Arguments.createMap()
+
+              data.putArray("permissions", Arguments.fromList(permissions))
+              data.putString("id", id)
+              delegate.emitEvent("ON_PERMISSIONS_REQUESTED", data)
+            }
           },
         )
 
@@ -1440,6 +1469,7 @@ class HMSRNSDK(
 
           if (audioTrackId == trackId) {
             peer.audioTrack?.setVolume(volume)
+            callback?.resolve(null)
             return
           }
 
@@ -1449,6 +1479,7 @@ class HMSRNSDK(
 
               if (trackExtracted != null) {
                 trackExtracted.setVolume(volume)
+                callback?.resolve(null)
                 return
               }
             }
@@ -1721,7 +1752,7 @@ class HMSRNSDK(
       val audioDevice = data.getString("audioDevice")
       hmsSDK?.let {
         it.switchAudioOutput(HMSHelper.getAudioDevice(audioDevice))
-        callback?.resolve(true)
+        callback?.resolve(null)
       }
     } else {
       val errorMessage = "switchAudioOutput: $requiredKeys"
@@ -1807,7 +1838,7 @@ class HMSRNSDK(
         override fun onSuccess() {
           isAudioSharing = false
           audioshareCallback = null
-          callback?.resolve(getPromiseResolveData())
+          callback?.resolve(true)
         }
       },
     )
@@ -1825,7 +1856,7 @@ class HMSRNSDK(
       val mode = HMSHelper.getAudioMixingMode(data.getString("audioMixingMode"))
       audioMixingMode = mode
       hmsSDK?.setAudioMixingMode(mode)
-      callback?.resolve(getPromiseResolveData())
+      callback?.resolve(true)
     } else {
       val errorMessage = "setAudioMixingMode: $requiredKeys"
       rejectCallback(callback, errorMessage)

package/android/src/main/java/com/reactnativehmssdk/PipActionReceiver.kt

@@ -7,6 +7,8 @@ import android.content.Intent
 import android.content.IntentFilter
 import android.os.Build
 import androidx.annotation.RequiresApi
+import androidx.core.content.ContextCompat
+import androidx.core.content.ContextCompat.RECEIVER_NOT_EXPORTED
 
 data class PIPAction(
   val title: String,
@@ -62,7 +64,7 @@ class PipActionReceiver(
 
     IntentFilter().also {
       it.addAction(PIP_INTENT_ACTION)
-      activity.registerReceiver(this, it)
+      ContextCompat.registerReceiver(activity, this, it, RECEIVER_NOT_EXPORTED)
     }
     registered = true
   }

package/ios/HMSConstants.swift

@@ -34,4 +34,5 @@ struct HMSConstants {
     static let ON_POLL_UPDATE = "ON_POLL_UPDATE"
     static let ON_WHITEBOARD_UPDATE = "ON_WHITEBOARD_UPDATE"
     static let ON_TRANSCRIPTS = "ON_TRANSCRIPTS"
+    static let ON_PIP_MODE_CHANGED = "ON_PIP_MODE_CHANGED"
 }

package/ios/HMSManager.m

@@ -393,4 +393,43 @@ RCT_EXTERN_METHOD(handleRealTimeTranscription
                   : (NSDictionary)data
                   : (RCTPromiseResolveBlock)resolve
                   : (RCTPromiseRejectBlock)reject)
+
+#pragma mark - PIP Mode Support
+
+RCT_EXTERN_METHOD(handlePipActions
+                  : (NSString)action
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setupPIP
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(stopPIP
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(disposePIP
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(isPIPActive
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(changeIOSPIPVideoTrack
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setActiveSpeakerInIOSPIP
+                  : (NSDictionary)data
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject)
+
 @end

package/ios/HMSManager.swift

@@ -37,7 +37,7 @@ class HMSManager: RCTEventEmitter {
     }
 
     override func supportedEvents() -> [String]! {
-        return [ON_JOIN, ON_PREVIEW, ON_ROOM_UPDATE, ON_PEER_UPDATE, ON_TRACK_UPDATE, ON_ERROR, ON_MESSAGE, ON_SPEAKER, RECONNECTING, RECONNECTED, ON_ROLE_CHANGE_REQUEST, ON_CHANGE_TRACK_STATE_REQUEST, ON_REMOVED_FROM_ROOM, ON_RTC_STATS, ON_LOCAL_AUDIO_STATS, ON_LOCAL_VIDEO_STATS, ON_REMOTE_AUDIO_STATS, ON_REMOTE_VIDEO_STATS, ON_AUDIO_DEVICE_CHANGED, HMSConstants.ON_SESSION_STORE_AVAILABLE, HMSConstants.ON_SESSION_STORE_CHANGED, HMSConstants.ON_PEER_LIST_UPDATED, HMSConstants.ON_POLL_UPDATE, HMSConstants.ON_WHITEBOARD_UPDATE, HMSConstants.ON_TRANSCRIPTS]
+        return [ON_JOIN, ON_PREVIEW, ON_ROOM_UPDATE, ON_PEER_UPDATE, ON_TRACK_UPDATE, ON_ERROR, ON_MESSAGE, ON_SPEAKER, RECONNECTING, RECONNECTED, ON_ROLE_CHANGE_REQUEST, ON_CHANGE_TRACK_STATE_REQUEST, ON_REMOVED_FROM_ROOM, ON_RTC_STATS, ON_LOCAL_AUDIO_STATS, ON_LOCAL_VIDEO_STATS, ON_REMOTE_AUDIO_STATS, ON_REMOTE_VIDEO_STATS, ON_AUDIO_DEVICE_CHANGED, HMSConstants.ON_SESSION_STORE_AVAILABLE, HMSConstants.ON_SESSION_STORE_CHANGED, HMSConstants.ON_PEER_LIST_UPDATED, HMSConstants.ON_POLL_UPDATE, HMSConstants.ON_WHITEBOARD_UPDATE, HMSConstants.ON_TRANSCRIPTS, HMSConstants.ON_PIP_MODE_CHANGED]
     }
 
     // MARK: - HMS SDK Delegate Callbacks
@@ -837,4 +837,119 @@ class HMSManager: RCTEventEmitter {
         }
         rnsdk.handleRealTimeTranscription(data, resolve, reject)
     }
+
+    // MARK: - PIP Mode Support
+
+    @objc
+    func handlePipActions(_ action: String,
+                          _ data: NSDictionary,
+                          _ resolve: RCTPromiseResolveBlock?,
+                          _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            switch action {
+            case "isPipModeSupported":
+                self?.isPipModeSupported(resolve, reject)
+            case "enterPipMode":
+                rnsdk.enterPipMode(resolve, reject)
+            case "setPictureInPictureParams":
+                if #available(iOS 15.0, *) {
+                    rnsdk.setPictureInPictureParams(data, resolve, reject)
+                } else {
+                    reject?("6004", "setPictureInPictureParams should be invoked for iOS 15 & above versions", nil)
+                }
+            default:
+                reject?("6004", "Unknown action type received", nil)
+            }
+        }
+    }
+
+    @objc
+    func stopPIP(_ data: NSDictionary,
+                 _ resolve: RCTPromiseResolveBlock?,
+                 _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+
+        DispatchQueue.main.async {
+            rnsdk.stopPIP(resolve, reject)
+        }
+    }
+
+    @objc
+    func disposePIP(_ data: NSDictionary,
+                    _ resolve: RCTPromiseResolveBlock?,
+                    _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+
+        DispatchQueue.main.async {
+            rnsdk.disposePIP(resolve, reject)
+        }
+    }
+
+    @objc
+    func isPipModeSupported(_ resolve: RCTPromiseResolveBlock?,
+                        _ reject: RCTPromiseRejectBlock?) {
+
+        resolve?(AVPictureInPictureController.isPictureInPictureSupported())
+    }
+
+    @objc
+    func isPIPActive(_ data: NSDictionary,
+                     _ resolve: RCTPromiseResolveBlock?,
+                     _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+
+        DispatchQueue.main.async {
+            rnsdk.isPIPActive(resolve, reject)
+        }
+    }
+
+    @objc
+    func changeIOSPIPVideoTrack(_ data: NSDictionary,
+                                _ resolve: RCTPromiseResolveBlock?,
+                                _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+        DispatchQueue.main.async {
+            if #available(iOS 15.0, *) {
+                rnsdk.changeIOSPIPVideoTrack(data, resolve, reject)
+            } else {
+                reject?("6004", "changeIOSPIPVideoTrack is not supported on iOS version lower than 15.0", nil)
+            }
+        }
+    }
+
+    @objc
+    func setActiveSpeakerInIOSPIP(_ data: NSDictionary,
+                                  _ resolve: RCTPromiseResolveBlock?,
+                                  _ reject: RCTPromiseRejectBlock?) {
+
+        guard let rnsdk = HMSHelper.getHms(data, hmsCollection) else {
+            reject?("6004", "HMSRNSDK instance not found!", nil)
+            return
+        }
+        DispatchQueue.main.async {
+            rnsdk.setActiveSpeakerInIOSPIP(data, resolve, reject)
+        }
+    }
 }