@100mslive/react-native-hms 1.4.0 → 1.6.0

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

@@ -2,12 +2,14 @@ package com.reactnativehmssdk
 
 import android.content.Intent
 import android.content.Intent.FLAG_ACTIVITY_NEW_TASK
+import android.util.Log
 import com.facebook.react.bridge.*
 import com.facebook.react.bridge.UiThreadUtil.runOnUiThread
 import kotlinx.coroutines.launch
 import live.hms.video.audio.HMSAudioManager
 import live.hms.video.connection.stats.*
 import live.hms.video.error.HMSException
+import live.hms.video.media.settings.HMSLayer
 import live.hms.video.media.tracks.*
 import live.hms.video.sdk.*
 import live.hms.video.sdk.models.*
@@ -16,17 +18,21 @@ import live.hms.video.sdk.models.enums.HMSPeerUpdate
 import live.hms.video.sdk.models.enums.HMSRoomUpdate
 import live.hms.video.sdk.models.enums.HMSTrackUpdate
 import live.hms.video.sdk.models.trackchangerequest.HMSChangeTrackStateRequest
+import live.hms.video.sessionstore.HMSKeyChangeListener
+import live.hms.video.sessionstore.HmsSessionStore
 import live.hms.video.signal.init.HMSTokenListener
 import live.hms.video.signal.init.TokenRequest
 import live.hms.video.signal.init.TokenRequestOptions
 import live.hms.video.utils.HMSCoroutineScope
 import live.hms.video.utils.HmsUtilities
+import java.io.File
+import java.util.Date
 
 class HMSRNSDK(
   data: ReadableMap?,
   HmsDelegate: HMSManager,
   sdkId: String,
-  reactApplicationContext: ReactApplicationContext
+  reactApplicationContext: ReactApplicationContext,
 ) {
   var hmsSDK: HMSSDK? = null
   var screenshareCallback: Promise? = null
@@ -37,12 +43,13 @@ class HMSRNSDK(
   private var context: ReactApplicationContext = reactApplicationContext
   private var previewInProgress: Boolean = false
   private var reconnectingStage: Boolean = false
-  private var rtcStatsAttached: Boolean = false
   private var networkQualityUpdatesAttached: Boolean = false
   private var audioMixingMode: AudioMixingMode = AudioMixingMode.TALK_AND_MUSIC
   private var id: String = sdkId
   private var self = this
   private var eventsEnableStatus = mutableMapOf<String, Boolean>()
+  private var sessionStore: HmsSessionStore? = null
+  private val keyChangeObservers = mutableMapOf<String, HMSKeyChangeListener?>()
 
   init {
     val builder = HMSSDK.Builder(reactApplicationContext)
@@ -98,7 +105,7 @@ class HMSRNSDK(
         message,
         message,
         null,
-        false
+        false,
       )
     data.putString("id", id)
     data.putMap("error", HMSDecoder.getError(hmsError))
@@ -109,6 +116,21 @@ class HMSRNSDK(
     callback?.reject("6002", message)
   }
 
+  // Handle resetting states and data cleanup
+  private fun cleanup() {
+    screenshareCallback = null
+    audioshareCallback = null
+    isAudioSharing = false
+    recentRoleChangeRequest = null
+    previewInProgress = false
+    reconnectingStage = false
+    networkQualityUpdatesAttached = false
+    eventsEnableStatus.clear()
+    sessionStore = null
+    keyChangeObservers.clear()
+    HMSDecoder.clearRestrictDataStates()
+  }
+
   fun emitHMSError(error: HMSException) {
     if (eventsEnableStatus["ON_ERROR"] != true) {
       return
@@ -136,7 +158,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         credentials,
-        arrayOf(Pair("username", "String"), Pair("authToken", "String"))
+        arrayOf(Pair("username", "String"), Pair("authToken", "String")),
       )
     if (requiredKeys === null) {
       previewInProgress = true
@@ -208,7 +230,7 @@ class HMSRNSDK(
             data.putString("id", id)
             delegate.emitEvent("ON_PREVIEW", data)
           }
-        }
+        },
       )
     } else {
       val errorMessage = "preview: $requiredKeys"
@@ -224,7 +246,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         credentials,
-        arrayOf(Pair("username", "String"), Pair("authToken", "String"))
+        arrayOf(Pair("username", "String"), Pair("authToken", "String")),
       )
     if (requiredKeys === null) {
       reconnectingStage = false
@@ -243,15 +265,14 @@ class HMSRNSDK(
                   HMSDecoder.getHmsChangeTrackStateRequest(details, id)
                 delegate.emitEvent(
                   "ON_CHANGE_TRACK_STATE_REQUEST",
-                  decodedChangeTrackStateRequest
+                  decodedChangeTrackStateRequest,
                 )
               }
 
               override fun onRemovedFromRoom(notification: HMSRemovedFromRoom) {
                 super.onRemovedFromRoom(notification)
-
-                HMSDecoder.clearRestrictDataStates()
                 if (eventsEnableStatus["ON_REMOVED_FROM_ROOM"] != true) {
+                  cleanup() // resetting states and doing data cleanup
                   return
                 }
                 val data: WritableMap = Arguments.createMap()
@@ -266,6 +287,7 @@ class HMSRNSDK(
                 data.putString("id", id)
 
                 delegate.emitEvent("ON_REMOVED_FROM_ROOM", data)
+                cleanup() // resetting states and doing data cleanup
               }
 
               override fun onError(error: HMSException) {
@@ -394,7 +416,17 @@ class HMSRNSDK(
                 val decodedChangeRoleRequest = HMSDecoder.getHmsRoleChangeRequest(request, id)
                 delegate.emitEvent("ON_ROLE_CHANGE_REQUEST", decodedChangeRoleRequest)
               }
-            }
+
+              override fun onSessionStoreAvailable(sessionStore: HmsSessionStore) {
+                self.sessionStore = sessionStore
+                if (eventsEnableStatus["ON_SESSION_STORE_AVAILABLE"] != true) {
+                  return
+                }
+                val data: WritableMap = Arguments.createMap()
+                data.putString("id", id)
+                delegate.emitEvent("ON_SESSION_STORE_AVAILABLE", data)
+              }
+            },
           )
         } catch (e: HMSException) {
           self.emitHMSError(e)
@@ -423,7 +455,7 @@ class HMSRNSDK(
               data.putString("id", id)
               delegate.emitEvent("ON_SPEAKER", data)
             }
-          }
+          },
         )
 
         hmsSDK?.addRtcStatsObserver(
@@ -431,20 +463,17 @@ class HMSRNSDK(
             override fun onLocalAudioStats(
               audioStats: HMSLocalAudioStats,
               hmsTrack: HMSTrack?,
-              hmsPeer: HMSPeer?
+              hmsPeer: HMSPeer?,
             ) {
-              if (eventsEnableStatus["ON_LOCAL_AUDIO_STATS"] != true) {
-                return
-              }
-              if (!rtcStatsAttached) {
+              if (eventsEnableStatus["ON_LOCAL_AUDIO_STATS"] != true || hmsPeer == null || hmsTrack == null) {
                 return
               }
-              val localAudioStats = HMSDecoder.getLocalAudioStats(audioStats)
+              val localAudioStats = HMSDecoder.getLocalAudioStats(audioStats) // [bitrate, bytesSent, roundTripTime]
               val track = HMSDecoder.getHmsLocalAudioTrack(hmsTrack as HMSLocalAudioTrack)
               val peer = HMSDecoder.getHmsPeerSubset(hmsPeer)
 
               val data: WritableMap = Arguments.createMap()
-              data.putMap("localAudioStats", localAudioStats)
+              data.putArray("localAudioStats", localAudioStats)
               data.putMap("track", track)
               data.putMap("peer", peer)
               data.putString("id", id)
@@ -454,16 +483,12 @@ class HMSRNSDK(
             override fun onLocalVideoStats(
               videoStats: List<HMSLocalVideoStats>,
               hmsTrack: HMSTrack?,
-              hmsPeer: HMSPeer?
+              hmsPeer: HMSPeer?,
             ) {
-              if (eventsEnableStatus["ON_LOCAL_VIDEO_STATS"] != true) {
-                return
-              }
-              if (!rtcStatsAttached && hmsPeer != null && hmsTrack != null) {
+              if (eventsEnableStatus["ON_LOCAL_VIDEO_STATS"] != true || hmsPeer == null || hmsTrack == null) {
                 return
               }
-
-              val localVideoStats = HMSDecoder.getLocalVideoStats(videoStats)
+              val localVideoStats = HMSDecoder.getLocalVideoStats(videoStats) // List<[bitrate, bytesSent, roundTripTime, frameRate, resolution]>
               val track = HMSDecoder.getHmsLocalVideoTrack(hmsTrack as HMSLocalVideoTrack)
               val peer = HMSDecoder.getHmsPeerSubset(hmsPeer)
 
@@ -479,17 +504,14 @@ class HMSRNSDK(
               if (eventsEnableStatus["ON_RTC_STATS"] != true) {
                 return
               }
-              if (!rtcStatsAttached) {
-                return
-              }
-              val video = HMSDecoder.getHMSRTCStats(rtcStats.video)
-              val audio = HMSDecoder.getHMSRTCStats(rtcStats.audio)
-              val combined = HMSDecoder.getHMSRTCStats(rtcStats.combined)
+              val video = HMSDecoder.getHMSRTCStats(rtcStats.video) // [bitrateReceived, bitrateSent, bytesReceived, bytesSent, packetsLost, packetsReceived, roundTripTime]
+              val audio = HMSDecoder.getHMSRTCStats(rtcStats.audio) // [bitrateReceived, bitrateSent, bytesReceived, bytesSent, packetsLost, packetsReceived, roundTripTime]
+              val combined = HMSDecoder.getHMSRTCStats(rtcStats.combined) // [bitrateReceived, bitrateSent, bytesReceived, bytesSent, packetsLost, packetsReceived, roundTripTime]
 
               val data: WritableMap = Arguments.createMap()
-              data.putMap("video", video)
-              data.putMap("audio", audio)
-              data.putMap("combined", combined)
+              data.putArray("video", video)
+              data.putArray("audio", audio)
+              data.putArray("combined", combined)
               data.putString("id", id)
               delegate.emitEvent("ON_RTC_STATS", data)
             }
@@ -497,21 +519,17 @@ class HMSRNSDK(
             override fun onRemoteAudioStats(
               audioStats: HMSRemoteAudioStats,
               hmsTrack: HMSTrack?,
-              hmsPeer: HMSPeer?
+              hmsPeer: HMSPeer?,
             ) {
-              if (eventsEnableStatus["ON_REMOTE_AUDIO_STATS"] != true) {
-                return
-              }
-              if (!rtcStatsAttached) {
+              if (eventsEnableStatus["ON_REMOTE_AUDIO_STATS"] != true || hmsPeer == null || hmsTrack == null) {
                 return
               }
-
-              val remoteAudioStats = HMSDecoder.getRemoteAudioStats(audioStats)
+              val remoteAudioStats = HMSDecoder.getRemoteAudioStats(audioStats) // [bitrate, bytesReceived, jitter, packetsLost, packetsReceived]
               val track = HMSDecoder.getHmsRemoteAudioTrack(hmsTrack as HMSRemoteAudioTrack)
               val peer = HMSDecoder.getHmsPeerSubset(hmsPeer)
 
               val data: WritableMap = Arguments.createMap()
-              data.putMap("remoteAudioStats", remoteAudioStats)
+              data.putArray("remoteAudioStats", remoteAudioStats)
               data.putMap("track", track)
               data.putMap("peer", peer)
               data.putString("id", id)
@@ -521,27 +539,23 @@ class HMSRNSDK(
             override fun onRemoteVideoStats(
               videoStats: HMSRemoteVideoStats,
               hmsTrack: HMSTrack?,
-              hmsPeer: HMSPeer?
+              hmsPeer: HMSPeer?,
             ) {
-              if (eventsEnableStatus["ON_REMOTE_VIDEO_STATS"] != true) {
-                return
-              }
-              if (!rtcStatsAttached) {
+              if (eventsEnableStatus["ON_REMOTE_VIDEO_STATS"] != true || hmsPeer == null || hmsTrack == null) {
                 return
               }
-
-              val remoteVideoStats = HMSDecoder.getRemoteVideoStats(videoStats)
+              val remoteVideoStats = HMSDecoder.getRemoteVideoStats(videoStats) // [bitrate, bytesReceived, frameRate, jitter, packetsLost, packetsReceived, resolution]
               val track = HMSDecoder.getHmsRemoteVideoTrack(hmsTrack as HMSRemoteVideoTrack)
               val peer = HMSDecoder.getHmsPeerSubset(hmsPeer)
 
               val data: WritableMap = Arguments.createMap()
-              data.putMap("remoteVideoStats", remoteVideoStats)
+              data.putArray("remoteVideoStats", remoteVideoStats)
               data.putMap("track", track)
               data.putMap("peer", peer)
               data.putString("id", id)
               delegate.emitEvent("ON_REMOTE_VIDEO_STATS", data)
             }
-          }
+          },
         )
       }
     } else {
@@ -554,7 +568,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("roomCode", "String"))
+        arrayOf(Pair("roomCode", "String")),
       )
 
     if (requiredKeys === null) {
@@ -576,7 +590,7 @@ class HMSRNSDK(
           override fun onTokenSuccess(string: String) {
             promise.resolve(string)
           }
-        }
+        },
       )
     } else {
       val errorMessage = "getAuthTokenByRoomCode: $requiredKeys"
@@ -614,12 +628,6 @@ class HMSRNSDK(
       hmsSDK?.leave(
         object : HMSActionResultListener {
           override fun onSuccess() {
-            isAudioSharing = false
-            screenshareCallback = null
-            audioshareCallback = null
-            networkQualityUpdatesAttached = false
-            rtcStatsAttached = false
-            HMSDecoder.clearRestrictDataStates()
             if (fromPIP) {
               context.currentActivity?.moveTaskToBack(false)
 
@@ -632,6 +640,7 @@ class HMSRNSDK(
             } else {
               callback?.resolve(emitHMSSuccess())
             }
+            cleanup() // resetting states and doing data cleanup
           }
 
           override fun onError(error: HMSException) {
@@ -640,7 +649,7 @@ class HMSRNSDK(
             }
             self.emitHMSError(error)
           }
-        }
+        },
       )
     }
   }
@@ -649,7 +658,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("message", "String"), Pair("type", "String"))
+        arrayOf(Pair("message", "String"), Pair("type", "String")),
       )
     if (requiredKeys === null) {
       hmsSDK?.sendBroadcastMessage(
@@ -663,7 +672,7 @@ class HMSRNSDK(
           override fun onSuccess(hmsMessage: HMSMessage) {
             callback?.resolve(emitHMSSuccess(hmsMessage))
           }
-        }
+        },
       )
     } else {
       val errorMessage = "sendBroadcastMessage: $requiredKeys"
@@ -676,7 +685,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("message", "String"), Pair("roles", "Array"), Pair("type", "String"))
+        arrayOf(Pair("message", "String"), Pair("roles", "Array"), Pair("type", "String")),
       )
     if (requiredKeys === null) {
       val targetedRoles = data.getArray("roles")?.toArrayList() as? ArrayList<String>
@@ -695,7 +704,7 @@ class HMSRNSDK(
           override fun onSuccess(hmsMessage: HMSMessage) {
             callback?.resolve(emitHMSSuccess(hmsMessage))
           }
-        }
+        },
       )
     } else {
       val errorMessage = "sendGroupMessage: $requiredKeys"
@@ -708,7 +717,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("message", "String"), Pair("peerId", "String"), Pair("type", "String"))
+        arrayOf(Pair("message", "String"), Pair("peerId", "String"), Pair("type", "String")),
       )
     if (requiredKeys === null) {
       val peerId = data.getString("peerId")
@@ -726,7 +735,7 @@ class HMSRNSDK(
             override fun onSuccess(hmsMessage: HMSMessage) {
               callback?.resolve(emitHMSSuccess(hmsMessage))
             }
-          }
+          },
         )
       } else {
         self.emitCustomError("PEER_NOT_FOUND")
@@ -744,7 +753,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("peerId", "String"), Pair("role", "String"), Pair("force", "Boolean"))
+        arrayOf(Pair("peerId", "String"), Pair("role", "String"), Pair("force", "Boolean")),
       )
     if (requiredKeys === null) {
       val peerId = data.getString("peerId")
@@ -768,7 +777,7 @@ class HMSRNSDK(
                 self.emitHMSError(error)
                 callback?.reject(error.code.toString(), error.message)
               }
-            }
+            },
           )
         }
       }
@@ -783,7 +792,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("peerId", "String"), Pair("role", "String"), Pair("force", "Boolean"))
+        arrayOf(Pair("peerId", "String"), Pair("role", "String"), Pair("force", "Boolean")),
       )
     if (requiredKeys === null) {
       val peerId = data.getString("peerId")
@@ -807,7 +816,7 @@ class HMSRNSDK(
                 self.emitHMSError(error)
                 promise?.reject(error.code.toString(), error.message)
               }
-            }
+            },
           )
         }
       }
@@ -822,7 +831,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("ofRoles", "Array"), Pair("toRole", "String"))
+        arrayOf(Pair("ofRoles", "Array"), Pair("toRole", "String")),
       )
     if (requiredKeys === null) {
       val ofRoles = data.getArray("ofRoles")
@@ -848,7 +857,7 @@ class HMSRNSDK(
                 self.emitHMSError(error)
                 promise?.reject(error.code.toString(), error.message)
               }
-            }
+            },
           )
         }
       }
@@ -863,7 +872,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("trackId", "String"), Pair("mute", "Boolean"))
+        arrayOf(Pair("trackId", "String"), Pair("mute", "Boolean")),
       )
     if (requiredKeys === null) {
       val trackId = data.getString("trackId")
@@ -881,7 +890,7 @@ class HMSRNSDK(
               self.emitHMSError(error)
               callback?.reject(error.code.toString(), error.message)
             }
-          }
+          },
         )
       }
     } else {
@@ -932,7 +941,7 @@ class HMSRNSDK(
             self.emitHMSError(error)
             callback?.reject(error.code.toString(), error.message)
           }
-        }
+        },
       )
     } else {
       val errorMessage = "changeTrackStateForRoles: $requiredKeys"
@@ -963,7 +972,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("peerId", "String"), Pair("reason", "String"))
+        arrayOf(Pair("peerId", "String"), Pair("reason", "String")),
       )
     if (requiredKeys === null) {
       val peerId = data.getString("peerId")
@@ -981,7 +990,7 @@ class HMSRNSDK(
               self.emitHMSError(error)
               callback?.reject(error.code.toString(), error.message)
             }
-          }
+          },
         )
       } else {
         self.emitCustomError("PEER_NOT_FOUND")
@@ -998,7 +1007,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("lock", "Boolean"), Pair("reason", "String"))
+        arrayOf(Pair("lock", "Boolean"), Pair("reason", "String")),
       )
     if (requiredKeys === null) {
       hmsSDK?.endRoom(
@@ -1007,12 +1016,13 @@ class HMSRNSDK(
         object : HMSActionResultListener {
           override fun onSuccess() {
             callback?.resolve(emitHMSSuccess())
+            cleanup() // resetting states and doing data cleanup
           }
           override fun onError(error: HMSException) {
             self.emitHMSError(error)
             callback?.reject(error.code.toString(), error.message)
           }
-        }
+        },
       )
     } else {
       val errorMessage = "endRoom: $requiredKeys"
@@ -1033,7 +1043,7 @@ class HMSRNSDK(
             self.emitHMSError(error)
             callback?.reject(error.code.toString(), error.message)
           }
-        }
+        },
       )
       recentRoleChangeRequest = null
     } else {
@@ -1056,7 +1066,7 @@ class HMSRNSDK(
             override fun onError(error: HMSException) {
               customError = error
             }
-          }
+          },
         )
       }
       if (customError === null) {
@@ -1090,7 +1100,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("trackId", "String"), Pair("playbackAllowed", "Boolean"))
+        arrayOf(Pair("trackId", "String"), Pair("playbackAllowed", "Boolean")),
       )
     if (requiredKeys === null) {
       val trackId = data.getString("trackId")
@@ -1158,7 +1168,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("trackId", "String"), Pair("volume", "Float"))
+        arrayOf(Pair("trackId", "String"), Pair("volume", "Float")),
       )
 
     if (requiredKeys === null) {
@@ -1234,7 +1244,7 @@ class HMSRNSDK(
               callback?.reject(error.code.toString(), error.message)
               self.emitHMSError(error)
             }
-          }
+          },
         )
       }
     } else {
@@ -1248,7 +1258,7 @@ class HMSRNSDK(
     val requiredKeys =
       HMSHelper.getUnavailableRequiredKey(
         data,
-        arrayOf(Pair("record", "Boolean"), Pair("meetingURL", "String"))
+        arrayOf(Pair("record", "Boolean"), Pair("meetingURL", "String")),
       )
     if (requiredKeys === null) {
       val config = HMSHelper.getRtmpConfig(data)
@@ -1267,7 +1277,7 @@ class HMSRNSDK(
               callback?.reject(error.code.toString(), error.message)
               self.emitHMSError(error)
             }
-          }
+          },
         )
       }
     } else {
@@ -1287,7 +1297,7 @@ class HMSRNSDK(
           callback?.reject(error.code.toString(), error.message)
           self.emitHMSError(error)
         }
-      }
+      },
     )
   }
 
@@ -1317,7 +1327,7 @@ class HMSRNSDK(
           screenshareCallback = null
           callback?.resolve(emitHMSSuccess())
         }
-      }
+      },
     )
   }
 
@@ -1333,7 +1343,7 @@ class HMSRNSDK(
           callback?.reject(error.code.toString(), error.message)
           self.emitHMSError(error)
         }
-      }
+      },
     )
   }
 
@@ -1348,7 +1358,7 @@ class HMSRNSDK(
           callback?.reject(error.code.toString(), error.message)
           self.emitHMSError(error)
         }
-      }
+      },
     )
   }
 
@@ -1388,7 +1398,7 @@ class HMSRNSDK(
               callback?.reject(error.code.toString(), error.message)
               self.emitHMSError(error)
             }
-          }
+          },
         )
       } else {
         self.emitCustomError("NAME_UNDEFINED")
@@ -1401,14 +1411,6 @@ class HMSRNSDK(
     }
   }
 
-  fun enableRTCStats() {
-    rtcStatsAttached = true
-  }
-
-  fun disableRTCStats() {
-    rtcStatsAttached = false
-  }
-
   fun enableNetworkQualityUpdates() {
     networkQualityUpdatesAttached = true
   }
@@ -1453,7 +1455,7 @@ class HMSRNSDK(
       object : HMSAudioManager.AudioManagerDeviceChangeListener {
         override fun onAudioDeviceChanged(
           device: HMSAudioManager.AudioDevice?,
-          audioDevicesList: Set<HMSAudioManager.AudioDevice>?
+          audioDevicesList: Set<HMSAudioManager.AudioDevice>?,
         ) {
           if (eventsEnableStatus["ON_AUDIO_DEVICE_CHANGED"] != true) {
             return
@@ -1468,7 +1470,7 @@ class HMSRNSDK(
         override fun onError(error: HMSException) {
           self.emitHMSError(error)
         }
-      }
+      },
     )
   }
 
@@ -1508,7 +1510,7 @@ class HMSRNSDK(
           audioshareCallback = null
           callback?.resolve(emitHMSSuccess())
         }
-      }
+      },
     )
   }
 
@@ -1531,6 +1533,7 @@ class HMSRNSDK(
     }
   }
 
+  @Deprecated("SessionMetaData APIs has been deprecated in favour of Session Store APIs", ReplaceWith("setSessionMetadataForKey"), DeprecationLevel.WARNING)
   fun setSessionMetaData(data: ReadableMap, callback: Promise?) {
     if (data.hasKey("sessionMetaData")) {
       val sessionMetaData = data.getString("sessionMetaData")
@@ -1545,7 +1548,7 @@ class HMSRNSDK(
             callback?.reject(error.code.toString(), error.message)
             self.emitHMSError(error)
           }
-        }
+        },
       )
     } else {
       val errorMessage = "setSessionMetaData: sessionMetaData_Is_Required"
@@ -1554,18 +1557,23 @@ class HMSRNSDK(
     }
   }
 
+  @Deprecated("SessionMetaData APIs has been deprecated in favour of Session Store APIs", ReplaceWith("getSessionMetadataForKey"), DeprecationLevel.WARNING)
   fun getSessionMetaData(callback: Promise?) {
     hmsSDK?.getSessionMetaData(
       object : HMSSessionMetadataListener {
-        override fun onSuccess(sessionMetadata: String?) {
-          callback?.resolve(sessionMetadata)
+        override fun onSuccess(sessionMetadata: Any?) {
+          if (sessionMetadata is String?) {
+            callback?.resolve(sessionMetadata)
+          } else {
+            callback?.reject("6002", "Session Store: Unsupported type received, only String type is supported")
+          }
         }
 
         override fun onError(error: HMSException) {
           callback?.reject(error.code.toString(), error.message)
           self.emitHMSError(error)
         }
-      }
+      },
     )
   }
 
@@ -1582,7 +1590,9 @@ class HMSRNSDK(
     val peerId = data.getString("peerId")!!
     val property = data.getString("property")!!
 
-    val peer = HMSHelper.getPeerFromPeerId(peerId, nativeHmsSDK.getRoom())
+    val hmsRoom = nativeHmsSDK.getRoom()
+
+    val peer = HMSHelper.getPeerFromPeerId(peerId, hmsRoom)
 
     if (peer !== null) {
       val result: WritableMap = Arguments.createMap()
@@ -1740,4 +1750,333 @@ class HMSRNSDK(
       rejectCallback(promise, errorMessage)
     }
   }
+
+  fun getRemoteVideoTrackFromTrackId(data: ReadableMap, promise: Promise) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("trackId", "String")))
+    if (requiredKeys === null) {
+      val trackId = data.getString("trackId")
+      val remoteVideoTrack = HMSHelper.getRemoteVideoTrackFromTrackId(trackId, hmsSDK?.getRoom())
+      if (remoteVideoTrack === null) {
+        promise.reject("101", "TRACK_NOT_FOUND")
+      } else {
+        promise.resolve(HMSDecoder.getHmsRemoteVideoTrack(remoteVideoTrack))
+      }
+    } else {
+      val errorMessage = "getRemoteVideoTrackFromTrackId: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun getRemoteAudioTrackFromTrackId(data: ReadableMap, promise: Promise) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("trackId", "String")))
+    if (requiredKeys === null) {
+      val trackId = data.getString("trackId")
+      val remoteAudioTrack = HMSHelper.getRemoteAudioTrackFromTrackId(trackId, hmsSDK?.getRoom())
+      if (remoteAudioTrack === null) {
+        promise.reject("101", "TRACK_NOT_FOUND")
+      } else {
+        promise.resolve(HMSDecoder.getHmsRemoteAudioTrack(remoteAudioTrack))
+      }
+    } else {
+      val errorMessage = "getRemoteAudioTrackFromTrackId: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun getVideoTrackLayer(data: ReadableMap, promise: Promise) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("trackId", "String")))
+    if (requiredKeys === null) {
+      val trackId = data.getString("trackId")
+      val remoteVideoTrack = HMSHelper.getRemoteVideoTrackFromTrackId(trackId, hmsSDK?.getRoom())
+      if (remoteVideoTrack === null) {
+        promise.reject("101", "TRACK_NOT_FOUND")
+      } else {
+        val layer = remoteVideoTrack.getLayer()
+        promise.resolve(layer.name)
+      }
+    } else {
+      val errorMessage = "getVideoTrackLayer: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun getVideoTrackLayerDefinition(data: ReadableMap, promise: Promise) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("trackId", "String")))
+    if (requiredKeys === null) {
+      val trackId = data.getString("trackId")
+      val remoteVideoTrack = HMSHelper.getRemoteVideoTrackFromTrackId(trackId, hmsSDK?.getRoom())
+      if (remoteVideoTrack === null) {
+        promise.reject("101", "TRACK_NOT_FOUND")
+      } else {
+        val layerDefinition = remoteVideoTrack.getLayerDefinition()
+
+        promise.resolve(HMSDecoder.getSimulcastLayerDefinitions(layerDefinition))
+      }
+    } else {
+      val errorMessage = "getVideoTrackLayerDefinition: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun setVideoTrackLayer(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("trackId", "String"), Pair("layer", "String")))
+    if (requiredKeys === null) {
+      val trackId = data.getString("trackId")
+      val layerString = data.getString("layer")
+
+      if (HMSLayer.values().find { it.name == layerString } === null) {
+        // DOUBT: which error to throw here?
+        // emitError or 101 or 6000?
+        promise?.reject("6000", "INVALID_LAYER")
+        return
+      }
+
+      val remoteVideoTrack = HMSHelper.getRemoteVideoTrackFromTrackId(trackId, hmsSDK?.getRoom())
+
+      if (remoteVideoTrack === null) {
+        promise?.reject("101", "TRACK_NOT_FOUND")
+      } else {
+        val layer = HMSLayer.valueOf(layerString!!)
+        remoteVideoTrack.setLayer(layer)
+        promise?.resolve(true)
+      }
+    } else {
+      val errorMessage = "setVideoTrackLayer: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun captureImageAtMaxSupportedResolution(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("flash", "Boolean")))
+    if (requiredKeys === null) {
+      val localPeer = hmsSDK?.getLocalPeer().let {
+        if (it == null) {
+          promise?.reject("6004", "An instance of Local Peer could not be found! Please check if a Room is joined.")
+          return
+        } else {
+          it
+        }
+      }
+      val localVideoTrack = localPeer.videoTrack.let {
+        if (it == null) {
+          promise?.reject("6004", "Video Track of Local Peer could not be found! Please check if the Local Peer has permission to publish video & video is unmuted currently.")
+          return
+        } else {
+          it
+        }
+      }
+      val cameraControl = localVideoTrack.getCameraControl().let {
+        if (it == null) {
+          promise?.reject("6004", "Camera Controls not available!")
+          return
+        } else {
+          it
+        }
+      }
+
+      val flashSupported = cameraControl.isFlashSupported()
+      var flashActionOnSuccess = 0 // 0 - Do nothing on success, 1 - set flash on, 2 - set flash off
+      if (flashSupported) {
+        val useFlash = data.getBoolean("flash")
+
+        val flashEnabled = cameraControl.isFlashEnabled()
+
+        // if flash option is true, and flash is already on
+        // -> do nothing now and on success
+
+        // if flash option is true, and flash is off
+        // -> turn it on and later turn it off
+        if (useFlash && !flashEnabled) {
+          cameraControl.setFlash(true)
+          flashActionOnSuccess = 2
+        }
+
+        // if flash option is false, and flash is on
+        // -> turn it off and later turn it on
+        if (!useFlash && flashEnabled) {
+          cameraControl.setFlash(false)
+          flashActionOnSuccess = 1
+        }
+
+        // if flash option is false, and flash is off
+        // -> do nothing now and on success
+      }
+
+      val dir = context.getExternalFilesDir("images")
+      val imagePath = "$dir/hms_${Date().time}.jpg"
+      val savePath = File(imagePath)
+
+      cameraControl.captureImageAtMaxSupportedResolution(
+        savePath,
+      ) { success ->
+        if (flashActionOnSuccess > 0) {
+          cameraControl.setFlash(flashActionOnSuccess === 1)
+        }
+        if (success) {
+          promise?.resolve(imagePath)
+        } else {
+          promise?.reject("6004", "Could Not Capture Image!")
+        }
+      }
+    } else {
+      val errorMessage = "captureImageAtMaxSupportedResolution: $requiredKeys"
+      self.emitRequiredKeysError(errorMessage)
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  // Mark: Session Store
+
+  fun setSessionMetadataForKey(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("key", "String")))
+    if (requiredKeys === null) {
+      val key = data.getString("key")!!
+      val value = data.getString("value")
+
+      sessionStore.let {
+        if (it === null) {
+          val errorMessage = "setSessionMetadataForKey: HmsSessionStore instance is not available!"
+          rejectCallback(promise, errorMessage)
+          return
+        }
+
+        it.set(
+          value, // data/value
+          key, // key
+          object : HMSActionResultListener {
+            override fun onError(error: HMSException) {
+              promise?.reject(error.code.toString(), error.message)
+            }
+            override fun onSuccess() {
+              val result: WritableMap = Arguments.createMap()
+              result.putBoolean("success", true)
+              result.putString("finalValue", value)
+              promise?.resolve(result)
+            }
+          },
+        )
+      }
+    } else {
+      val errorMessage = "setSessionMetadataForKey: $requiredKeys"
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun getSessionMetadataForKey(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("key", "String")))
+    if (requiredKeys === null) {
+      val key = data.getString("key")!!
+
+      sessionStore.let {
+        if (it === null) {
+          val errorMessage = "setSessionMetadataForKey: HmsSessionStore instance is not available!"
+          rejectCallback(promise, errorMessage)
+          return
+        }
+
+        it.get(
+          key,
+          object : HMSSessionMetadataListener {
+            override fun onError(error: HMSException) {
+              promise?.reject(error.code.toString(), error.message)
+            }
+            override fun onSuccess(sessionMetadata: Any?) {
+              if (sessionMetadata is String?) {
+                promise?.resolve(sessionMetadata)
+              } else {
+                promise?.reject("6002", "Session Store: Unsupported type received for '$key' key, only String type is supported")
+              }
+            }
+          },
+        )
+      }
+    } else {
+      val errorMessage = "getSessionMetadataForKey: $requiredKeys"
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun addKeyChangeListener(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("keys", "Array"), Pair("uniqueId", "String")))
+    if (requiredKeys === null) {
+      val keys = ArrayList(data.getArray("keys")!!.toArrayList().map { it.toString() })
+      val uniqueId = data.getString("uniqueId")!!
+
+      sessionStore.let {
+        if (it === null) {
+          val errorMessage = "setSessionMetadataForKey: HmsSessionStore instance is not available!"
+          rejectCallback(promise, errorMessage)
+          return
+        }
+
+        val keyChangeListener = object : HMSKeyChangeListener {
+          override fun onKeyChanged(key: String, value: Any?) {
+            val map = Arguments.createMap()
+            map.putString("id", id)
+            map.putString("key", key)
+            if (value is String?) {
+              map.putString("value", value)
+            } else {
+              Log.e("HMSRNSDK", "Session Store: '$value' value received for '$key' key, expected only NullableString type for value")
+              map.putString("value", null) // resetting value to `null`, as the current type is not supported
+            }
+            delegate.emitEvent("ON_SESSION_STORE_CHANGED", map)
+          }
+        }
+
+        val actionResultListener = object : HMSActionResultListener {
+          override fun onError(error: HMSException) {
+            promise?.reject(error.code.toString(), error.message)
+          }
+          override fun onSuccess() {
+            keyChangeObservers[uniqueId] = keyChangeListener
+            promise?.resolve(true)
+          }
+        }
+
+        it.addKeyChangeListener(
+          keys,
+          keyChangeListener,
+          actionResultListener,
+        )
+      }
+    } else {
+      val errorMessage = "addKeyChangeListener: $requiredKeys"
+      rejectCallback(promise, errorMessage)
+    }
+  }
+
+  fun removeKeyChangeListener(data: ReadableMap, promise: Promise?) {
+    val requiredKeys = HMSHelper.getUnavailableRequiredKey(data, arrayOf(Pair("uniqueId", "String")))
+    if (requiredKeys === null) {
+      val uniqueId = data.getString("uniqueId")!!
+
+      sessionStore.let { localSessionStore ->
+        if (localSessionStore === null) {
+          val errorMessage = "removeKeyChangeListener: HmsSessionStore instance is not available!"
+          rejectCallback(promise, errorMessage)
+          return
+        }
+
+        keyChangeObservers[uniqueId].let {
+          if (it == null) {
+            val errorMessage = "removeKeyChangeListener: No listener found to remove for the '$uniqueId' uniqueId passed."
+            rejectCallback(promise, errorMessage)
+          } else {
+            localSessionStore.removeKeyChangeListener(it)
+            keyChangeObservers.remove(uniqueId)
+            promise?.resolve(true)
+          }
+        }
+      }
+    } else {
+      val errorMessage = "removeKeyChangeListener: $requiredKeys"
+      rejectCallback(promise, errorMessage)
+    }
+  }
 }