@100mslive/react-native-hms 0.9.2 → 0.9.5

package/README.md

@@ -192,10 +192,9 @@ const styles = StyleSheet.create({
 });
 
 // trackId can be acquired from the method explained above
-// sink is passed false video would be removed. It is a ios only prop, for android it is handled by the package itself.
 // scaleType can be selected from HMSVideoViewMode as required
 // mirror can be passed as true to flip videos horizontally
-<HmsView sink={true} style={styles.hmsView} trackId={trackId} mirror={true} scaleType={HMSVideoViewMode.ASPECT_FIT} />
+<HmsView style={styles.hmsView} trackId={trackId} mirror={true} scaleType={HMSVideoViewMode.ASPECT_FIT} />
 
 ...
 ```

package/android/build.gradle

@@ -63,7 +63,7 @@ dependencies {
     //noinspection GradleDynamicVersion
     implementation "com.facebook.react:react-native:+"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"  // From node_modules
-    implementation 'com.github.100mslive.android-sdk:lib:2.3.4'
+    implementation 'com.github.100mslive.android-sdk:lib:2.3.7'
     implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.1.0'
     implementation 'androidx.appcompat:appcompat:1.3.1'

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

@@ -1,6 +1,7 @@
 package com.reactnativehmssdk
 
 import com.facebook.react.bridge.*
+import live.hms.video.connection.stats.quality.HMSNetworkQuality
 import live.hms.video.error.HMSException
 import live.hms.video.media.settings.HMSAudioTrackSettings
 import live.hms.video.media.settings.HMSVideoResolution
@@ -47,6 +48,7 @@ object HmsDecoder {
       peer.putBoolean("isLocal", hmsPeer.isLocal)
       peer.putString("customerUserID", hmsPeer.customerUserID)
       peer.putString("metadata", hmsPeer.metadata)
+      peer.putMap("networkQuality", this.getHmsNetworkQuality(hmsPeer.networkQuality))
       peer.putMap("audioTrack", this.getHmsAudioTrack(hmsPeer.audioTrack))
       peer.putMap("videoTrack", this.getHmsVideoTrack(hmsPeer.videoTrack))
       peer.putMap("role", this.getHmsRole(hmsPeer.hmsRole))
@@ -182,6 +184,7 @@ object HmsDecoder {
       peer.putBoolean("isLocal", hmsLocalPeer.isLocal)
       peer.putString("customerUserID", hmsLocalPeer.customerUserID)
       peer.putString("metadata", hmsLocalPeer.metadata)
+      peer.putMap("networkQuality", this.getHmsNetworkQuality(hmsLocalPeer.networkQuality))
       peer.putMap("audioTrack", this.getHmsAudioTrack(hmsLocalPeer.audioTrack))
       peer.putMap("videoTrack", this.getHmsVideoTrack(hmsLocalPeer.videoTrack))
       peer.putMap("role", this.getHmsRole(hmsLocalPeer.hmsRole))
@@ -276,6 +279,7 @@ object HmsDecoder {
       peer.putBoolean("isLocal", hmsRemotePeer.isLocal)
       peer.putString("customerUserID", hmsRemotePeer.customerUserID)
       peer.putString("metadata", hmsRemotePeer.metadata)
+      peer.putMap("networkQuality", this.getHmsNetworkQuality(hmsRemotePeer.networkQuality))
       peer.putMap("audioTrack", this.getHmsAudioTrack(hmsRemotePeer.audioTrack))
       peer.putMap("videoTrack", this.getHmsVideoTrack(hmsRemotePeer.videoTrack))
       peer.putMap("role", this.getHmsRole(hmsRemotePeer.hmsRole))
@@ -508,4 +512,12 @@ object HmsDecoder {
     }
     return hmsRecipient
   }
+
+  private fun getHmsNetworkQuality(networkQuality: HMSNetworkQuality?): WritableMap {
+    val hmsNetworkQuality: WritableMap = Arguments.createMap()
+    if (networkQuality != null) {
+      hmsNetworkQuality.putInt("downlinkQuality", networkQuality.downlinkQuality)
+    }
+    return hmsNetworkQuality
+  }
 }

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

@@ -1,17 +1,33 @@
 package com.reactnativehmssdk
 
+import android.content.Context
+import android.graphics.Bitmap
+import android.os.Build
+import android.os.Handler
+import android.util.Base64
+import android.util.Log
+import android.view.PixelCopy
+import androidx.annotation.RequiresApi
+import com.facebook.react.bridge.*
 import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.uimanager.events.RCTEventEmitter
+import java.io.ByteArrayOutputStream
+import java.util.*
+import live.hms.video.error.HMSException
 import live.hms.video.media.codec.HMSAudioCodec
 import live.hms.video.media.codec.HMSVideoCodec
 import live.hms.video.media.settings.HMSAudioTrackSettings
 import live.hms.video.media.settings.HMSTrackSettings
 import live.hms.video.media.settings.HMSVideoResolution
 import live.hms.video.media.settings.HMSVideoTrackSettings
-import live.hms.video.media.tracks.*
+import live.hms.video.media.tracks.HMSRemoteAudioTrack
+import live.hms.video.media.tracks.HMSRemoteVideoTrack
+import live.hms.video.media.tracks.HMSTrack
 import live.hms.video.sdk.models.*
-import live.hms.video.sdk.models.role.*
+import live.hms.video.sdk.models.role.HMSRole
 import live.hms.video.utils.HmsUtilities
+import org.webrtc.SurfaceViewRenderer
 
 object HmsHelper {
 
@@ -307,4 +323,160 @@ object HmsHelper {
     }
     return meetingURLVariant
   }
+
+  fun getHmsConfig(credentials: ReadableMap): HMSConfig {
+    var config =
+        HMSConfig(
+            credentials.getString("username") as String,
+            credentials.getString("authToken") as String,
+        )
+
+    when {
+      areAllRequiredKeysAvailable(
+          credentials,
+          arrayOf(
+              Pair("endpoint", "String"),
+              Pair("metadata", "String"),
+              Pair("captureNetworkQualityInPreview", "Boolean")
+          )
+      ) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                initEndpoint = credentials.getString("endpoint") as String,
+                metadata = credentials.getString("metadata") as String,
+                captureNetworkQualityInPreview =
+                    credentials.getBoolean("captureNetworkQualityInPreview"),
+            )
+      }
+      areAllRequiredKeysAvailable(
+          credentials,
+          arrayOf(Pair("endpoint", "String"), Pair("metadata", "String"))
+      ) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                initEndpoint = credentials.getString("endpoint") as String,
+                metadata = credentials.getString("metadata") as String,
+            )
+      }
+      areAllRequiredKeysAvailable(
+          credentials,
+          arrayOf(Pair("endpoint", "String"), Pair("captureNetworkQualityInPreview", "Boolean"))
+      ) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                initEndpoint = credentials.getString("endpoint") as String,
+                captureNetworkQualityInPreview =
+                    credentials.getBoolean("captureNetworkQualityInPreview"),
+            )
+      }
+      areAllRequiredKeysAvailable(
+          credentials,
+          arrayOf(Pair("metadata", "String"), Pair("captureNetworkQualityInPreview", "Boolean"))
+      ) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                metadata = credentials.getString("metadata") as String,
+                captureNetworkQualityInPreview =
+                    credentials.getBoolean("captureNetworkQualityInPreview"),
+            )
+      }
+      areAllRequiredKeysAvailable(credentials, arrayOf(Pair("endpoint", "String"))) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                initEndpoint = credentials.getString("endpoint") as String,
+            )
+      }
+      areAllRequiredKeysAvailable(credentials, arrayOf(Pair("metadata", "String"))) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                metadata = credentials.getString("metadata") as String,
+            )
+      }
+      areAllRequiredKeysAvailable(
+          credentials,
+          arrayOf(Pair("captureNetworkQualityInPreview", "Boolean"))
+      ) -> {
+        config =
+            HMSConfig(
+                credentials.getString("username") as String,
+                credentials.getString("authToken") as String,
+                captureNetworkQualityInPreview =
+                    credentials.getBoolean("captureNetworkQualityInPreview")
+            )
+      }
+    }
+    return config
+  }
+
+  @RequiresApi(Build.VERSION_CODES.N)
+  fun captureSurfaceView(
+      surfaceView: SurfaceViewRenderer,
+      sdkId: String,
+      args: ReadableArray?,
+      context: Context,
+      id: Int
+  ) {
+    val output = Arguments.createMap()
+    if (args != null) {
+      output.putInt("requestId", args.getInt(0))
+    } else {
+      output.putInt("requestId", -1)
+    }
+    val reactContext = context as ReactContext
+    try {
+      val bitmap: Bitmap =
+          Bitmap.createBitmap(surfaceView.width, surfaceView.height, Bitmap.Config.ARGB_8888)
+      PixelCopy.request(
+          surfaceView,
+          bitmap,
+          { copyResult ->
+            if (copyResult === PixelCopy.SUCCESS) {
+              Log.d("captureSurfaceView", "bitmap: $bitmap")
+              val byteArrayOutputStream = ByteArrayOutputStream()
+              bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteArrayOutputStream)
+              val byteArray = byteArrayOutputStream.toByteArray()
+              val encoded: String = Base64.encodeToString(byteArray, Base64.DEFAULT)
+              Log.d("captureSurfaceView", "Base64: $encoded")
+              output.putString("result", encoded)
+              reactContext
+                  .getJSModule(RCTEventEmitter::class.java)
+                  .receiveEvent(id, "captureFrame", output)
+            } else {
+              Log.e("captureSurfaceView", "copyResult: $copyResult")
+              HmsModule.hmsCollection[sdkId]?.emitHMSError(
+                  HMSException(
+                      103,
+                      copyResult.toString(),
+                      copyResult.toString(),
+                      copyResult.toString(),
+                      copyResult.toString()
+                  )
+              )
+              output.putString("error", copyResult.toString())
+              reactContext
+                  .getJSModule(RCTEventEmitter::class.java)
+                  .receiveEvent(id, "captureFrame", output)
+            }
+          },
+          Handler()
+      )
+    } catch (e: Exception) {
+      Log.e("captureSurfaceView", "error: $e")
+      HmsModule.hmsCollection[sdkId]?.emitHMSError(e as HMSException)
+      output.putString("error", e.message)
+      reactContext.getJSModule(RCTEventEmitter::class.java).receiveEvent(id, "captureFrame", output)
+    }
+  }
 }

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

@@ -97,42 +97,7 @@ class HmsSDK(
         )
     if (requiredKeys) {
       previewInProgress = true
-      var config =
-          HMSConfig(
-              credentials.getString("username") as String,
-              credentials.getString("authToken") as String,
-          )
-
-      when {
-        HmsHelper.areAllRequiredKeysAvailable(
-            credentials,
-            arrayOf(Pair("endpoint", "String"), Pair("metadata", "String"))
-        ) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  initEndpoint = credentials.getString("endpoint") as String,
-                  metadata = credentials.getString("metadata") as String,
-              )
-        }
-        HmsHelper.areAllRequiredKeysAvailable(credentials, arrayOf(Pair("endpoint", "String"))) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  initEndpoint = credentials.getString("endpoint") as String,
-              )
-        }
-        HmsHelper.areAllRequiredKeysAvailable(credentials, arrayOf(Pair("metadata", "String"))) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  metadata = credentials.getString("metadata") as String,
-              )
-        }
-      }
+      val config = HmsHelper.getHmsConfig(credentials)
 
       hmsSDK?.preview(
           config,
@@ -217,42 +182,7 @@ class HmsSDK(
             arrayOf(Pair("username", "String"), Pair("authToken", "String"))
         )
     if (requiredKeys) {
-      var config =
-          HMSConfig(
-              credentials.getString("username") as String,
-              credentials.getString("authToken") as String
-          )
-
-      when {
-        HmsHelper.areAllRequiredKeysAvailable(
-            credentials,
-            arrayOf(Pair("endpoint", "String"), Pair("metadata", "String"))
-        ) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  initEndpoint = credentials.getString("endpoint") as String,
-                  metadata = credentials.getString("metadata") as String,
-              )
-        }
-        HmsHelper.areAllRequiredKeysAvailable(credentials, arrayOf(Pair("endpoint", "String"))) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  initEndpoint = credentials.getString("endpoint") as String,
-              )
-        }
-        HmsHelper.areAllRequiredKeysAvailable(credentials, arrayOf(Pair("metadata", "String"))) -> {
-          config =
-              HMSConfig(
-                  credentials.getString("username") as String,
-                  credentials.getString("authToken") as String,
-                  metadata = credentials.getString("metadata") as String,
-              )
-        }
-      }
+      val config = HmsHelper.getHmsConfig(credentials)
 
       HMSCoroutineScope.launch {
         try {
@@ -375,7 +305,7 @@ class HmsSDK(
                   data.putMap("sender", HmsDecoder.getHmsPeer(message.sender))
                   data.putString("message", message.message)
                   data.putString("type", message.type)
-                  data.putString("time", message.serverReceiveTime.toString())
+                  data.putString("time", message.serverReceiveTime.time.toString())
                   data.putString("id", id)
                   data.putMap("recipient", HmsDecoder.getHmsMessageRecipient(message.recipient))
 

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

@@ -37,10 +37,15 @@ class HmsScreenshareActivity : ComponentActivity() {
           )
         } else {
           val id = intent.getStringExtra("id")
-          val data: WritableMap = Arguments.createMap()
-          data.putBoolean("success", true)
-          data.putString("message", "RESULT_CANCELED")
-          HmsModule.hmsCollection[id]?.screenshareCallback?.resolve(data)
+          val error = HMSException(
+            103,
+            "RESULT_CANCELED",
+            "RESULT_CANCELED",
+            "RESULT_CANCELED",
+            "RESULT_CANCELED"
+          )
+          HmsModule.hmsCollection[id]?.screenshareCallback?.reject(error)
+          HmsModule.hmsCollection[id]?.emitHMSError(error)
           finish()
         }
       }

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

@@ -2,14 +2,17 @@ package com.reactnativehmssdk
 
 import android.annotation.SuppressLint
 import android.content.Context
+import android.os.Build
 import android.view.LayoutInflater
 import android.widget.FrameLayout
+import androidx.annotation.RequiresApi
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.uimanager.events.RCTEventEmitter
-import live.hms.video.media.tracks.HMSTrackType
 import live.hms.video.media.tracks.HMSVideoTrack
+import live.hms.video.utils.HmsUtilities
 import live.hms.video.utils.SharedEglContext
 import org.webrtc.RendererCommon
 import org.webrtc.SurfaceViewRenderer
@@ -18,8 +21,8 @@ import org.webrtc.SurfaceViewRenderer
 class HmsView(context: ReactContext) : FrameLayout(context) {
   private var surfaceView: SurfaceViewRenderer = SurfaceViewRenderer(context)
   private var videoTrack: HMSVideoTrack? = null
-  private var localTrack: String? = null
   private var scaleTypeApplied: Boolean = false
+  private var sdkId: String = "12345"
   private var currentScaleType: RendererCommon.ScalingType =
       RendererCommon.ScalingType.SCALE_ASPECT_FILL
 
@@ -31,6 +34,11 @@ class HmsView(context: ReactContext) : FrameLayout(context) {
     surfaceView.setEnableHardwareScaler(true)
   }
 
+  @RequiresApi(Build.VERSION_CODES.N)
+  fun captureHmsView(args: ReadableArray?) {
+    HmsHelper.captureSurfaceView(surfaceView, sdkId, args, context, id)
+  }
+
   private fun onReceiveNativeEvent() {
     val event: WritableMap = Arguments.createMap()
     event.putString("message", "MyMessage")
@@ -56,6 +64,13 @@ class HmsView(context: ReactContext) : FrameLayout(context) {
     }
   }
 
+  fun updateZOrderMediaOverlay(setZOrderMediaOverlay: Boolean?) {
+    if (setZOrderMediaOverlay != null && setZOrderMediaOverlay) {
+      // surfaceView.setZOrderOnTop(true);
+      surfaceView.setZOrderMediaOverlay(setZOrderMediaOverlay)
+    }
+  }
+
   fun updateScaleType(scaleType: String?) {
     if (scaleType != null) {
       when (scaleType) {
@@ -87,40 +102,16 @@ class HmsView(context: ReactContext) : FrameLayout(context) {
       hmsCollection: MutableMap<String, HmsSDK>,
       mirror: Boolean?
   ) {
-    var sdkId = "12345"
     if (id != null) {
       sdkId = id
     }
-
     val hms = hmsCollection[sdkId]?.hmsSDK
 
     if (trackId != null && hms != null) {
       if (mirror != null) {
         surfaceView.setMirror(mirror)
       }
-      localTrack = trackId
-      val localTrackId = hms.getLocalPeer()?.videoTrack?.trackId
-      if (localTrackId == localTrack) {
-        videoTrack = hms.getLocalPeer()?.videoTrack
-      }
-
-      val remotePeers = hms.getRemotePeers()
-      for (peer in remotePeers) {
-        val videoTrackId = peer.videoTrack?.trackId
-
-        val auxiliaryTracks = peer.auxiliaryTracks
-        for (track in auxiliaryTracks) {
-          val auxTrackId = track.trackId
-          if (trackId == auxTrackId && track.type == HMSTrackType.VIDEO && !track.isMute) {
-            videoTrack = track as HMSVideoTrack
-            return
-          }
-        }
-        if (videoTrackId == localTrack) {
-          videoTrack = peer.videoTrack
-          return
-        }
-      }
+      videoTrack = hms.getRoom()?.let { HmsUtilities.getVideoTrack(trackId, it) }
     }
   }
 }

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

@@ -1,5 +1,10 @@
 package com.reactnativehmssdk
 
+import android.os.Build
+import androidx.annotation.NonNull
+import androidx.annotation.Nullable
+import androidx.annotation.RequiresApi
+import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.common.MapBuilder
 import com.facebook.react.uimanager.SimpleViewManager
@@ -28,17 +33,41 @@ class HmssdkViewManager : SimpleViewManager<HmsView>() {
         .build()
   }
 
+  override fun getExportedCustomDirectEventTypeConstants(): MutableMap<String, Any>? {
+    return MapBuilder.of(
+        "captureFrame",
+        MapBuilder.of("registrationName", "onDataReturned"),
+    )
+  }
+
+  @RequiresApi(Build.VERSION_CODES.N)
+  override fun receiveCommand(@NonNull root: HmsView, commandId: String?, args: ReadableArray?) {
+    when (commandId) {
+      "capture" -> root.captureHmsView(args)
+    }
+  }
+
+  @RequiresApi(Build.VERSION_CODES.N)
+  override fun receiveCommand(@NonNull root: HmsView, commandId: Int, args: ReadableArray?) {
+    when (commandId) {
+      1 -> root.captureHmsView(args)
+    }
+  }
+
+  @Nullable
+  override fun getCommandsMap(): Map<String, Int>? {
+    return MapBuilder.of("capture", 1)
+  }
+
   @ReactProp(name = "data")
   fun setData(view: HmsView, data: ReadableMap) {
     val trackId = data.getString("trackId")
-    //    val sink = data.getBoolean("sink")
     val id = data.getString("id")
     val mirror = data.getBoolean("mirror")
     val hmsCollection = getHms()
     if (hmsCollection != null) {
       view.setData(id, trackId, hmsCollection, mirror)
     }
-    // do the processing here
   }
 
   @ReactProp(name = "scaleType")
@@ -46,6 +75,11 @@ class HmssdkViewManager : SimpleViewManager<HmsView>() {
     view.updateScaleType(data)
   }
 
+  @ReactProp(name = "setZOrderMediaOverlay")
+  fun setZOrderMediaOverlay(view: HmsView, data: Boolean?) {
+    view.updateZOrderMediaOverlay(data)
+  }
+
   private fun getHms(): MutableMap<String, HmsSDK>? {
     return reactContext?.getNativeModule(HmsModule::class.java)?.getHmsInstance()
   }

package/ios/HmsDecoder.swift

@@ -37,6 +37,7 @@ class HmsDecoder: NSObject {
         let audioTrack = getHmsAudioTrack(peer.audioTrack)
         let videoTrack = getHmsVideoTrack(peer.videoTrack)
         let role = getHmsRole(peer.role)
+        let networkQuality = getHmsNetworkQuality(peer.networkQuality)
 
         let auxiliaryTracks = getAllTracks(peer.auxiliaryTracks ?? [] )
 
@@ -49,6 +50,7 @@ class HmsDecoder: NSObject {
                 "audioTrack": audioTrack,
                 "videoTrack": videoTrack,
                 "auxiliaryTracks": auxiliaryTracks,
+                "networkQuality": networkQuality,
                 "role": role]
     }
 
@@ -114,6 +116,7 @@ class HmsDecoder: NSObject {
         let audioTrack = getHmsAudioTrack(peer.audioTrack)
         let videoTrack = getHmsVideoTrack(peer.videoTrack)
         let role = getHmsRole(peer.role)
+        let networkQuality = getHmsNetworkQuality(peer.networkQuality)
 
         var auxiliaryTracks = [[String: Any]]()
         for track in peer.auxiliaryTracks ?? [] {
@@ -133,7 +136,7 @@ class HmsDecoder: NSObject {
             localVideoTrackData = getHmsLocalVideoTrack(localVideo)
         }
 
-        return ["peerID": peerID, "name": name, "isLocal": isLocal, "customerUserID": customerUserID, "customerDescription": customerDescription, "metadata": metadata, "audioTrack": audioTrack, "videoTrack": videoTrack, "auxiliaryTracks": auxiliaryTracks, "localAudioTrackData": localAudioTrackData, "localVideoTrackData": localVideoTrackData, "role": role]
+        return ["peerID": peerID, "name": name, "isLocal": isLocal, "customerUserID": customerUserID, "customerDescription": customerDescription, "metadata": metadata, "audioTrack": audioTrack, "videoTrack": videoTrack, "auxiliaryTracks": auxiliaryTracks, "localAudioTrackData": localAudioTrackData, "localVideoTrackData": localVideoTrackData, "role": role, "networkQuality": networkQuality]
     }
     
     static func getHmsLocalAudioTrack(_ localAudio: HMSLocalAudioTrack) -> [String: Any] {
@@ -232,6 +235,7 @@ class HmsDecoder: NSObject {
         let audioTrack = getHmsAudioTrack(hmsRemotePeer.audioTrack)
         let videoTrack = getHmsVideoTrack(hmsRemotePeer.videoTrack)
         let role = getHmsRole(hmsRemotePeer.role)
+        let networkQuality = getHmsNetworkQuality(hmsRemotePeer.networkQuality)
 
         var auxiliaryTracks = [[String: Any]]()
 
@@ -252,7 +256,7 @@ class HmsDecoder: NSObject {
             remoteVideoTrackData = getHMSRemoteVideoTrack(remoteVideo)
         }
 
-        return ["peerID": peerID, "name": name, "isLocal": isLocal, "customerUserID": customerUserID, "customerDescription": customerDescription, "metadata": metadata, "audioTrack": audioTrack, "videoTrack": videoTrack, "auxiliaryTracks": auxiliaryTracks, "remoteAudioTrackData": remoteAudioTrackData, "remoteVideoTrackData": remoteVideoTrackData, "role": role]
+        return ["peerID": peerID, "name": name, "isLocal": isLocal, "customerUserID": customerUserID, "customerDescription": customerDescription, "metadata": metadata, "audioTrack": audioTrack, "videoTrack": videoTrack, "auxiliaryTracks": auxiliaryTracks, "remoteAudioTrackData": remoteAudioTrackData, "remoteVideoTrackData": remoteVideoTrackData, "role": role, "networkQuality": networkQuality]
     }
     
     static func getHMSRemoteAudioTrack(_ remoteAudio: HMSRemoteAudioTrack) -> [String: Any] {
@@ -589,6 +593,12 @@ class HmsDecoder: NSObject {
         return ["recipientPeer": getHmsPeer(recipient.peerRecipient), "recipientRoles": getAllRoles(recipient.rolesRecipient), "type": self.getRecipientType(from: recipient.type)]
     }
     
+    static func getHmsNetworkQuality(_ hmsNetworkQuality: HMSNetworkQuality?) -> [String: Any] {
+        guard let networkQuality = hmsNetworkQuality else { return [:] }
+        
+        return ["downlinkQuality": networkQuality.downlinkQuality]
+    }
+    
     static private func getRecipientType(from recipientType: HMSMessageRecipientType) -> String {
         switch recipientType {
         case .broadcast:

package/ios/HmsSDK.swift

@@ -72,13 +72,15 @@ class HmsSDK: HMSUpdateListener, HMSPreviewListener {
         }
 
         let metadata = credentials.value(forKey: "metadata") as? String
+        let captureNetworkQualityInPreview = credentials.value(forKey: "captureNetworkQualityInPreview") as? Bool ?? false
+        
         DispatchQueue.main.async { [weak self] in
             guard let strongSelf = self else { return }
             if let endpoint = credentials.value(forKey: "endpoint") as? String {
-                strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, endpoint: endpoint)
+                strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, endpoint: endpoint, captureNetworkQualityInPreview: captureNetworkQualityInPreview)
                 strongSelf.hms?.preview(config: strongSelf.config!, delegate: strongSelf)
             } else {
-                strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata)
+                strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, captureNetworkQualityInPreview: captureNetworkQualityInPreview)
                 strongSelf.hms?.preview(config: strongSelf.config!, delegate: strongSelf)
             }
             strongSelf.previewInProgress = true
@@ -135,6 +137,7 @@ class HmsSDK: HMSUpdateListener, HMSPreviewListener {
         }
 
         let metadata = credentials.value(forKey: "metadata") as? String
+        let captureNetworkQualityInPreview = credentials.value(forKey: "captureNetworkQualityInPreview") as? Bool ?? false
 
         DispatchQueue.main.async { [weak self] in
             guard let strongSelf = self else { return }
@@ -142,10 +145,10 @@ class HmsSDK: HMSUpdateListener, HMSPreviewListener {
                 strongSelf.hms?.join(config: config, delegate: strongSelf)
             } else {
                 if let endpoint = credentials.value(forKey: "endpoint") as? String {
-                    strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, endpoint: endpoint)
+                    strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, endpoint: endpoint, captureNetworkQualityInPreview: captureNetworkQualityInPreview)
                     strongSelf.hms?.join(config: strongSelf.config!, delegate: strongSelf)
                 } else {
-                    strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata)
+                    strongSelf.config = HMSConfig(userName: user, authToken: authToken, metadata: metadata, captureNetworkQualityInPreview: captureNetworkQualityInPreview)
                     strongSelf.hms?.join(config: strongSelf.config!, delegate: strongSelf)
                 }
             }
@@ -950,6 +953,8 @@ class HmsSDK: HMSUpdateListener, HMSPreviewListener {
             return "NAME_CHANGED"
         case .defaultUpdate:
             return "DEFAULT_UPDATE"
+        case .networkQualityUpdated:
+            return "NETWORK_QUALITY_UPDATED"
         default:
             return ""
         }