@100mslive/react-native-hms 1.8.0 → 1.9.0

package/lib/module/classes/HMSUpdateListenerActions.js

@@ -26,6 +26,7 @@ export let HMSUpdateListenerActions = /*#__PURE__*/function (HMSUpdateListenerAc
   HMSUpdateListenerActions["ON_AUDIO_DEVICE_CHANGED"] = "ON_AUDIO_DEVICE_CHANGED";
   HMSUpdateListenerActions["ON_SESSION_STORE_AVAILABLE"] = "ON_SESSION_STORE_AVAILABLE";
   HMSUpdateListenerActions["ON_SESSION_STORE_CHANGED"] = "ON_SESSION_STORE_CHANGED";
+  HMSUpdateListenerActions["ON_PEER_LIST_UPDATED"] = "ON_PEER_LIST_UPDATED";
   return HMSUpdateListenerActions;
 }({});
 //# sourceMappingURL=HMSUpdateListenerActions.js.map

package/lib/module/classes/HMSUpdateListenerActions.js.map

@@ -1 +1 @@
-{"version":3,"names":["HMSUpdateListenerActions"],"sources":["HMSUpdateListenerActions.ts"],"sourcesContent":["/**\n * These are the available events emitted by the `HMSSDK`\n *\n * For more info about these events, checkout Event Listener docs\n * {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners}\n */\nexport enum HMSUpdateListenerActions {\n  ON_PREVIEW = 'ON_PREVIEW',\n  ON_JOIN = 'ON_JOIN',\n  ON_ROOM_UPDATE = 'ON_ROOM_UPDATE',\n  ON_PEER_UPDATE = '3',\n  ON_TRACK_UPDATE = 'ON_TRACK_UPDATE',\n  ON_ERROR = 'ON_ERROR',\n  ON_MESSAGE = 'ON_MESSAGE',\n  ON_SPEAKER = 'ON_SPEAKER',\n  RECONNECTING = 'RECONNECTING',\n  RECONNECTED = 'RECONNECTED',\n  ON_ROLE_CHANGE_REQUEST = 'ON_ROLE_CHANGE_REQUEST',\n  ON_CHANGE_TRACK_STATE_REQUEST = 'ON_CHANGE_TRACK_STATE_REQUEST',\n  ON_REMOVED_FROM_ROOM = 'ON_REMOVED_FROM_ROOM',\n  ON_RTC_STATS = 'ON_RTC_STATS',\n  ON_LOCAL_AUDIO_STATS = 'ON_LOCAL_AUDIO_STATS',\n  ON_LOCAL_VIDEO_STATS = 'ON_LOCAL_VIDEO_STATS',\n  ON_REMOTE_AUDIO_STATS = 'ON_REMOTE_AUDIO_STATS',\n  ON_REMOTE_VIDEO_STATS = 'ON_REMOTE_VIDEO_STATS',\n  ON_AUDIO_DEVICE_CHANGED = 'ON_AUDIO_DEVICE_CHANGED',\n  ON_SESSION_STORE_AVAILABLE = 'ON_SESSION_STORE_AVAILABLE',\n  ON_SESSION_STORE_CHANGED = 'ON_SESSION_STORE_CHANGED',\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,wBAAwB,0BAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAA,OAAxBA,wBAAwB;AAAA"}
+{"version":3,"names":["HMSUpdateListenerActions"],"sources":["HMSUpdateListenerActions.ts"],"sourcesContent":["/**\n * These are the available events emitted by the `HMSSDK`\n *\n * For more info about these events, checkout Event Listener docs\n * {@link https://www.100ms.live/docs/react-native/v2/how-to-guides/listen-to-room-updates/event-listeners}\n */\nexport enum HMSUpdateListenerActions {\n  ON_PREVIEW = 'ON_PREVIEW',\n  ON_JOIN = 'ON_JOIN',\n  ON_ROOM_UPDATE = 'ON_ROOM_UPDATE',\n  ON_PEER_UPDATE = '3',\n  ON_TRACK_UPDATE = 'ON_TRACK_UPDATE',\n  ON_ERROR = 'ON_ERROR',\n  ON_MESSAGE = 'ON_MESSAGE',\n  ON_SPEAKER = 'ON_SPEAKER',\n  RECONNECTING = 'RECONNECTING',\n  RECONNECTED = 'RECONNECTED',\n  ON_ROLE_CHANGE_REQUEST = 'ON_ROLE_CHANGE_REQUEST',\n  ON_CHANGE_TRACK_STATE_REQUEST = 'ON_CHANGE_TRACK_STATE_REQUEST',\n  ON_REMOVED_FROM_ROOM = 'ON_REMOVED_FROM_ROOM',\n  ON_RTC_STATS = 'ON_RTC_STATS',\n  ON_LOCAL_AUDIO_STATS = 'ON_LOCAL_AUDIO_STATS',\n  ON_LOCAL_VIDEO_STATS = 'ON_LOCAL_VIDEO_STATS',\n  ON_REMOTE_AUDIO_STATS = 'ON_REMOTE_AUDIO_STATS',\n  ON_REMOTE_VIDEO_STATS = 'ON_REMOTE_VIDEO_STATS',\n  ON_AUDIO_DEVICE_CHANGED = 'ON_AUDIO_DEVICE_CHANGED',\n  ON_SESSION_STORE_AVAILABLE = 'ON_SESSION_STORE_AVAILABLE',\n  ON_SESSION_STORE_CHANGED = 'ON_SESSION_STORE_CHANGED',\n  ON_PEER_LIST_UPDATED = 'ON_PEER_LIST_UPDATED',\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,wBAAwB,0BAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAxBA,wBAAwB;EAAA,OAAxBA,wBAAwB;AAAA"}

package/lib/typescript/classes/HMSPIPListenerActions.d.ts

@@ -1,3 +1,4 @@
 export declare enum HMSPIPListenerActions {
+    ON_PIP_MODE_CHANGED = "ON_PIP_MODE_CHANGED",
     ON_PIP_ROOM_LEAVE = "ON_PIP_ROOM_LEAVE"
 }

package/lib/typescript/classes/HMSPeer.d.ts

@@ -10,7 +10,9 @@ export declare class HMSPeer {
     private _customerUserID;
     private _metadata;
     private _role;
+    private _isHandRaised;
     private _updateIsLocal;
+    private _updateIsHandRaised;
     private _updateCustomerUserID;
     private _updateMetadata;
     private _updateRole;
@@ -19,6 +21,7 @@ export declare class HMSPeer {
         name: string;
     });
     get isLocal(): boolean | undefined;
+    get isHandRaised(): boolean;
     get networkQuality(): HMSNetworkQuality | undefined;
     get customerUserID(): string | undefined;
     get metadata(): string | undefined;

package/lib/typescript/classes/HMSPeerListIterator.d.ts

@@ -0,0 +1,9 @@
+import type { HMSPeer } from './HMSPeer';
+export declare class HMSPeerListIterator {
+    private readonly uniqueId;
+    private _totalCount;
+    get totalCount(): number;
+    constructor(uniqueId: string, totalCount: number);
+    hasNext(): Promise<boolean>;
+    next(): Promise<HMSPeer[]>;
+}

package/lib/typescript/classes/HMSPeerListIteratorOptions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * options for creating `HMSPeerListIterator` instance
+ *
+ * ```
+ * const peerListIterator =  hmsInstance.getPeerListIterator({
+ *   limit: 10,
+ *   byRoleName: 'viewer-realtime',
+ * });
+ * ```
+ */
+export interface HMSPeerListIteratorOptions {
+    /**
+     * filter by role of the peers
+     */
+    byRoleName?: string;
+    /**
+     * `peerID`s of the peers you want to fetch with iterator.
+     */
+    byPeerIds?: string[];
+    /**
+     * number of peers fetched by the iterator in `next` method call. Default value is `10`
+     */
+    limit?: number;
+}

package/lib/typescript/classes/HMSPeerUpdate.d.ts

@@ -4,6 +4,7 @@ export declare enum HMSPeerUpdate {
     METADATA_CHANGED = "METADATA_CHANGED",
     ROLE_CHANGED = "ROLE_CHANGED",
     NAME_CHANGED = "NAME_CHANGED",
-    NETWORK_QUALITY_UPDATED = "NETWORK_QUALITY_UPDATED"
+    NETWORK_QUALITY_UPDATED = "NETWORK_QUALITY_UPDATED",
+    HAND_RAISED_CHANGED = "HAND_RAISED_CHANGED"
 }
 export declare const HMSPeerUpdateOrdinals: Map<string, HMSPeerUpdate>;

package/lib/typescript/classes/HMSPeersCache.d.ts

@@ -20,6 +20,7 @@ export type HMSPeerCacheProps = {
     audioTrack?: HMSAudioTrack | undefined;
     videoTrack?: HMSVideoTrack | undefined;
     auxiliaryTracks?: HMSTrack[] | undefined;
+    isHandRaised?: boolean | undefined;
 };
 export declare class HMSPeersCache {
     private _data;

package/lib/typescript/classes/HMSSDK.d.ts

@@ -18,8 +18,11 @@ import type { HMSAudioMode } from './HMSAudioMode';
 import type { HMSAudioMixingMode } from './HMSAudioMixingMode';
 import type { HMSLogSettings } from './HMSLogSettings';
 import { HMSPIPListenerActions } from './HMSPIPListenerActions';
+import type { HMSPeerListIteratorOptions } from './HMSPeerListIteratorOptions';
+import { HMSPeerListIterator } from './HMSPeerListIterator';
 type HmsViewProps = Omit<HmsComponentProps, 'id'>;
 interface PIPConfig {
+    autoEnterPipMode?: boolean;
     aspectRatio?: [number, number];
     endButton?: boolean;
     audioButton?: boolean;
@@ -33,6 +36,7 @@ export declare class HMSSDK {
     private onJoinDelegate?;
     private onRoomDelegate?;
     private onPeerDelegate?;
+    private onPeerListUpdatedDelegate?;
     private onTrackDelegate?;
     private onErrorDelegate?;
     private onMessageDelegate?;
@@ -50,6 +54,7 @@ export declare class HMSSDK {
     private onAudioDeviceChangedDelegate?;
     private onSessionStoreAvailableDelegate?;
     private onPIPRoomLeaveDelegate?;
+    private onPIPModeChangedDelegate?;
     private emitterSubscriptions;
     private constructor();
     /**
@@ -525,6 +530,40 @@ export declare class HMSSDK {
     getRemoteVideoTrackFromTrackId: (trackId: string) => Promise<import("./HMSRemoteVideoTrack").HMSRemoteVideoTrack>;
     getRemoteAudioTrackFromTrackId: (trackId: string) => Promise<import("./HMSRemoteAudioTrack").HMSRemoteAudioTrack>;
     getPeerFromPeerId: (peerId: string) => HMSPeer | undefined;
+    /**
+     * - This function is used to raise hand for the local peer
+     * @memberof HMSSDK
+     */
+    raiseLocalPeerHand: () => Promise<any>;
+    /**
+     * - This function is used to lower hand for the local peer
+     * @memberof HMSSDK
+     */
+    lowerLocalPeerHand: () => Promise<any>;
+    /**
+     * - This function is used to lower hand for the remote peer
+     * @param peer
+     */
+    lowerRemotePeerHand: (peer: HMSPeer) => Promise<any>;
+    /**
+     * `getPeerListIterator` method returns an instance of `HMSPeerListIterator` class
+     *
+     * @param options options for configuring iterator
+     * @returns instance of HMSPeerListIterator class
+     *
+     * Example usage:
+     * ```
+     * const peerListIterator =  hmsInstance.getPeerListIterator();
+     * ```
+     * OR
+     * ```
+     * const peerListIterator =  hmsInstance.getPeerListIterator({
+     *    limit: 10,
+     *    byRoleName: 'viewer-realtime',
+     * });
+     * ```
+     */
+    getPeerListIterator: (options?: HMSPeerListIteratorOptions) => HMSPeerListIterator;
     /**
      * - This is a prototype event listener that takes action and listens for updates related to that particular action
      *
@@ -565,6 +604,9 @@ export declare class HMSSDK {
     onJoinListener: (data: any) => void;
     onRoomListener: (data: any) => void;
     onPeerListener: (peerData: any) => void;
+    private sendPeerUpdate;
+    private sendPeerUpdateWhenPeerLeaves;
+    onPeerListUpdatedListener: (data: any) => void;
     onTrackListener: (data: any) => void;
     onMessageListener: (data: any) => void;
     onSpeakerListener: (data: any) => void;
@@ -590,8 +632,11 @@ export declare class HMSSDK {
     onPIPRoomLeaveListener: (data: {
         id: string;
     }) => void;
+    onPIPModeChangedListener: (data: {
+        isInPictureInPictureMode: boolean;
+    }) => void;
     isPipModeSupported(): Promise<undefined | boolean>;
-    enablePipMode(data?: PIPConfig): Promise<undefined | boolean>;
+    enterPipMode(data?: PIPConfig): Promise<undefined | boolean>;
     setPipParams(data?: PIPConfig): Promise<undefined | boolean>;
     /**
      * - Returns the instance of logger which can be used to manipulate log levels.

package/lib/typescript/classes/HMSUpdateListenerActions.d.ts

@@ -25,5 +25,6 @@ export declare enum HMSUpdateListenerActions {
     ON_REMOTE_VIDEO_STATS = "ON_REMOTE_VIDEO_STATS",
     ON_AUDIO_DEVICE_CHANGED = "ON_AUDIO_DEVICE_CHANGED",
     ON_SESSION_STORE_AVAILABLE = "ON_SESSION_STORE_AVAILABLE",
-    ON_SESSION_STORE_CHANGED = "ON_SESSION_STORE_CHANGED"
+    ON_SESSION_STORE_CHANGED = "ON_SESSION_STORE_CHANGED",
+    ON_PEER_LIST_UPDATED = "ON_PEER_LIST_UPDATED"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@100mslive/react-native-hms",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Integrate Real Time Audio and Video conferencing, Interactive Live Streaming, and Chat in your apps with 100ms React Native SDK. With support for HLS and RTMP Live Streaming and Recording, Picture-in-Picture (PiP), one-to-one Video Call Modes, Audio Rooms, Video Player and much more, add immersive real-time communications to your apps.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/sdk-versions.json

@@ -1,6 +1,6 @@
 {
-  "ios": "0.9.12",
+  "ios": "1.1.0",
   "iOSBroadcastExtension": "0.0.9",
   "iOSHMSHLSPlayer": "0.0.2",
-  "android": "2.7.6"
+  "android": "2.7.7"
 }

package/src/classes/HMSPIPListenerActions.ts

@@ -1,3 +1,4 @@
 export enum HMSPIPListenerActions {
+  ON_PIP_MODE_CHANGED = 'ON_PIP_MODE_CHANGED',
   ON_PIP_ROOM_LEAVE = 'ON_PIP_ROOM_LEAVE',
 }

package/src/classes/HMSPeer.ts

@@ -13,6 +13,7 @@ export class HMSPeer {
   private _customerUserID: string | undefined;
   private _metadata: string | undefined;
   private _role: HMSRole | undefined;
+  private _isHandRaised: boolean = false;
 
   private _updateIsLocal(value: boolean) {
     // If `_isLocal` is outdated, update it
@@ -21,6 +22,13 @@ export class HMSPeer {
     }
   }
 
+  private _updateIsHandRaised(value: boolean) {
+    // If `_isHandRaised` is outdated, update it
+    if (this._isHandRaised !== value) {
+      this._isHandRaised = value;
+    }
+  }
+
   private _updateCustomerUserID(value: string) {
     // If `_customerUserID` is outdated, update it
     if (this._customerUserID !== value) {
@@ -64,6 +72,23 @@ export class HMSPeer {
     return value ?? this._isLocal;
   }
 
+  get isHandRaised(): boolean {
+    const hmsPeersCache = getHmsPeersCache();
+
+    const value = hmsPeersCache
+      ? hmsPeersCache.getProperty(this.peerID, 'isHandRaised')
+      : getPeerPropertyFromNative(
+          HMSConstants.DEFAULT_SDK_ID,
+          this.peerID,
+          'isHandRaised'
+        );
+
+    if (typeof value === 'boolean') {
+      this._updateIsHandRaised(value);
+    }
+    return value ?? this._isHandRaised;
+  }
+
   get networkQuality(): HMSNetworkQuality | undefined {
     const hmsPeersCache = getHmsPeersCache();
 

package/src/classes/HMSPeerListIterator.ts

@@ -0,0 +1,60 @@
+// import type { HMSException } from "./HMSException";
+import type { HMSPeer } from './HMSPeer';
+import HMSManagerModule from './HMSManagerModule';
+import { HMSEncoder, logger } from '@100mslive/react-native-hms';
+import { HMSConstants } from './HMSConstants';
+import { getHmsPeersCache } from './HMSPeersCache';
+
+export class HMSPeerListIterator {
+  private readonly uniqueId: string;
+  private _totalCount: number = 0;
+
+  get totalCount() {
+    return this._totalCount;
+  }
+
+  constructor(uniqueId: string, totalCount: number) {
+    this.uniqueId = uniqueId;
+    this._totalCount = totalCount;
+  }
+
+  async hasNext(): Promise<boolean> {
+    logger?.verbose('#Function HMSPeerListIterator#hasNext', this.uniqueId);
+    try {
+      return HMSManagerModule.peerListIteratorHasNext({
+        id: HMSConstants.DEFAULT_SDK_ID,
+        uniqueId: this.uniqueId,
+      });
+    } catch (e) {
+      logger?.error('#Error in #Function HMSPeerListIterator#hasNext ', e);
+      return Promise.reject(e);
+    }
+  }
+
+  async next(): Promise<HMSPeer[]> {
+    logger?.verbose('#Function HMSPeerListIterator#next', this.uniqueId);
+    try {
+      const { totalCount, peers } = await HMSManagerModule.peerListIteratorNext({
+        id: HMSConstants.DEFAULT_SDK_ID,
+        uniqueId: this.uniqueId,
+      });
+
+      this._totalCount = totalCount;
+
+      if (Array.isArray(peers) && peers.length > 0) {
+        const hmsPeersCache = getHmsPeersCache();
+
+        if (hmsPeersCache) {
+          peers.forEach(peer => {
+            hmsPeersCache.updatePeerCache(peer.peerID, peer);
+          });
+        }
+      }
+
+      return HMSEncoder.encodeHmsPeers(peers);
+    } catch (e) {
+      logger?.error('#Error in #Function HMSPeerListIterator#next ', e);
+      return Promise.reject(e);
+    }
+  }
+}

package/src/classes/HMSPeerListIteratorOptions.ts

@@ -0,0 +1,26 @@
+/**
+ * options for creating `HMSPeerListIterator` instance
+ *
+ * ```
+ * const peerListIterator =  hmsInstance.getPeerListIterator({
+ *   limit: 10,
+ *   byRoleName: 'viewer-realtime',
+ * });
+ * ```
+ */
+export interface HMSPeerListIteratorOptions {
+  /**
+   * filter by role of the peers
+   */
+  byRoleName?: string;
+
+  /**
+   * `peerID`s of the peers you want to fetch with iterator.
+   */
+  byPeerIds?: string[];
+
+  /**
+   * number of peers fetched by the iterator in `next` method call. Default value is `10`
+   */
+  limit?: number;
+}

package/src/classes/HMSPeerUpdate.ts

@@ -5,6 +5,7 @@ export enum HMSPeerUpdate {
   ROLE_CHANGED = 'ROLE_CHANGED',
   NAME_CHANGED = 'NAME_CHANGED',
   NETWORK_QUALITY_UPDATED = 'NETWORK_QUALITY_UPDATED',
+  HAND_RAISED_CHANGED = 'HAND_RAISED_CHANGED',
 }
 
 export const HMSPeerUpdateOrdinals = new Map([
@@ -14,4 +15,5 @@ export const HMSPeerUpdateOrdinals = new Map([
   ['5', HMSPeerUpdate.NAME_CHANGED],
   ['6', HMSPeerUpdate.METADATA_CHANGED],
   ['7', HMSPeerUpdate.NETWORK_QUALITY_UPDATED],
+  ['8', HMSPeerUpdate.HAND_RAISED_CHANGED],
 ]);

package/src/classes/HMSPeersCache.ts

@@ -39,6 +39,7 @@ export type HMSPeerCacheProps = {
   audioTrack?: HMSAudioTrack | undefined;
   videoTrack?: HMSVideoTrack | undefined;
   auxiliaryTracks?: HMSTrack[] | undefined;
+  isHandRaised?: boolean | undefined;
 };
 
 export class HMSPeersCache {
@@ -206,6 +207,10 @@ export class HMSPeersCache {
         updatedObj.name = data.name;
         break;
       }
+      case HMSPeerUpdate.HAND_RAISED_CHANGED: {
+        updatedObj.isHandRaised = data.isHandRaised;
+        break;
+      }
       default: {
         updatedObj = { ...updatedObj, ...data };
         break;
@@ -256,6 +261,8 @@ export function getPeerPropertyFromNative<T extends keyof HMSPeerCacheProps>(
         : undefined;
   } else if (property === 'name') {
     value = data?.[property];
+  } else if (property === 'isHandRaised') {
+    value = data ? data[property] : false;
   } else {
     value = data ? data[property] : undefined;
   }

package/src/classes/HMSSDK.tsx

@@ -41,13 +41,16 @@ import {
   HMSRoomCache,
   setHmsRoomCache,
 } from './HMSRoomCache';
-import { HMSPeerUpdateOrdinals } from './HMSPeerUpdate';
+import { HMSPeerUpdate, HMSPeerUpdateOrdinals } from './HMSPeerUpdate';
 import { HMSSessionStore } from './HMSSessionStore';
+import type { HMSPeerListIteratorOptions } from './HMSPeerListIteratorOptions';
+import { HMSPeerListIterator } from './HMSPeerListIterator';
 
 type HmsViewProps = Omit<HmsComponentProps, 'id'>;
 
 // TODO: Rename to HMSPIPConfig & to be moved to a separate file
 interface PIPConfig {
+  autoEnterPipMode?: boolean;
   aspectRatio?: [number, number];
   endButton?: boolean;
   audioButton?: boolean;
@@ -66,6 +69,7 @@ export class HMSSDK {
   private onJoinDelegate?: any;
   private onRoomDelegate?: any;
   private onPeerDelegate?: any;
+  private onPeerListUpdatedDelegate?: any;
   private onTrackDelegate?: any;
   private onErrorDelegate?: any;
   private onMessageDelegate?: any;
@@ -83,6 +87,7 @@ export class HMSSDK {
   private onAudioDeviceChangedDelegate?: any;
   private onSessionStoreAvailableDelegate?: any;
   private onPIPRoomLeaveDelegate?: any;
+  private onPIPModeChangedDelegate?: any;
 
   private emitterSubscriptions: Partial<
     Record<
@@ -1145,6 +1150,86 @@ export class HMSSDK {
     return HMSEncoder.encodeHmsPeer({ peerID: peerId });
   };
 
+  /**
+   * - This function is used to raise hand for the local peer
+   * @memberof HMSSDK
+   */
+  raiseLocalPeerHand = async () => {
+    const data = {
+      id: this.id,
+    };
+    logger?.verbose('#Function raiseLocalPeerHand', data);
+    return HMSManager.raiseLocalPeerHand(data);
+  };
+
+  /**
+   * - This function is used to lower hand for the local peer
+   * @memberof HMSSDK
+   */
+  lowerLocalPeerHand = async () => {
+    const data = {
+      id: this.id,
+    };
+    logger?.verbose('#Function lowerLocalPeerHand', data);
+    return HMSManager.lowerLocalPeerHand(data);
+  };
+
+  /**
+   * - This function is used to lower hand for the remote peer
+   * @param peer
+   */
+  lowerRemotePeerHand = async (peer: HMSPeer) => {
+    const data = {
+      peerId: peer.peerID,
+      id: this.id,
+    };
+    logger?.verbose('#Function lowerRemotePeerHand', data);
+    return HMSManager.lowerRemotePeerHand(data);
+  };
+
+  /**
+   * `getPeerListIterator` method returns an instance of `HMSPeerListIterator` class
+   *
+   * @param options options for configuring iterator
+   * @returns instance of HMSPeerListIterator class
+   *
+   * Example usage:
+   * ```
+   * const peerListIterator =  hmsInstance.getPeerListIterator();
+   * ```
+   * OR
+   * ```
+   * const peerListIterator =  hmsInstance.getPeerListIterator({
+   *    limit: 10,
+   *    byRoleName: 'viewer-realtime',
+   * });
+   * ```
+   */
+  getPeerListIterator = (
+    options?: HMSPeerListIteratorOptions
+  ): HMSPeerListIterator => {
+    logger?.verbose('#Function getPeerListIterator', {
+      id: this.id,
+      options,
+    });
+
+    const uniqueId = Math.random().toString(16).slice(2);
+
+    const data: null | { sucess: boolean; uniqueId: string; totalCount: number; } =
+      HMSManager.getPeerListIterator({
+        id: this.id,
+        ...options,
+        limit: options?.limit ?? 10,
+        uniqueId,
+      });
+
+    if (!data) {
+      throw new Error('Unable to create PeerListIterator');
+    }
+
+    return new HMSPeerListIterator(data.uniqueId, data.totalCount);
+  };
+
   /**
    * - This is a prototype event listener that takes action and listens for updates related to that particular action
    *
@@ -1229,6 +1314,28 @@ export class HMSSDK {
         this.onPeerDelegate = callback;
         break;
       }
+      case HMSUpdateListenerActions.ON_PEER_LIST_UPDATED: {
+        // Checking if we already have ON_PEER_LIST_UPDATED subscription
+        if (
+          !this.emitterSubscriptions[
+            HMSUpdateListenerActions.ON_PEER_LIST_UPDATED
+          ]
+        ) {
+          // Adding ON_PEER_LIST_UPDATED native listener
+          const peerListUpdatedSubscription =
+            HMSNativeEventListener.addListener(
+              this.id,
+              HMSUpdateListenerActions.ON_PEER_LIST_UPDATED,
+              this.onPeerListUpdatedListener
+            );
+          this.emitterSubscriptions[
+            HMSUpdateListenerActions.ON_PEER_LIST_UPDATED
+          ] = peerListUpdatedSubscription;
+        }
+        // Adding App Delegate listener
+        this.onPeerListUpdatedDelegate = callback;
+        break;
+      }
       case HMSUpdateListenerActions.ON_TRACK_UPDATE: {
         // Checking if we already have ON_TRACK_UPDATE subscription
         if (
@@ -1554,6 +1661,25 @@ export class HMSSDK {
         }
         break;
       }
+      case HMSPIPListenerActions.ON_PIP_MODE_CHANGED: {
+        if (Platform.OS === 'android') {
+          // Checking if we already have ON_PIP_MODE_CHANGED subscription
+          if (
+            !this.emitterSubscriptions[HMSPIPListenerActions.ON_PIP_MODE_CHANGED]
+          ) {
+            const pipModeChangedSubscription = HMSNativeEventListener.addListener(
+              this.id,
+              HMSPIPListenerActions.ON_PIP_MODE_CHANGED,
+              this.onPIPModeChangedListener
+            );
+            this.emitterSubscriptions[HMSPIPListenerActions.ON_PIP_MODE_CHANGED] =
+              pipModeChangedSubscription;
+          }
+          // Adding PIP mode changed Delegate listener
+          this.onPIPModeChangedDelegate = callback;
+        }
+        break;
+      }
       default:
     }
   };
@@ -1893,6 +2019,22 @@ export class HMSSDK {
         }
         break;
       }
+      case HMSPIPListenerActions.ON_PIP_MODE_CHANGED: {
+        if (Platform.OS === 'android') {
+          const subscription =
+            this.emitterSubscriptions[HMSPIPListenerActions.ON_PIP_MODE_CHANGED];
+          // Removing ON_PIP_MODE_CHANGED native listener
+          if (subscription) {
+            subscription.remove();
+
+            this.emitterSubscriptions[HMSPIPListenerActions.ON_PIP_MODE_CHANGED] =
+              undefined;
+          }
+          // Removing App Delegate listener
+          this.onPIPModeChangedDelegate = null;
+        }
+        break;
+      }
       default:
     }
   };
@@ -2015,8 +2157,15 @@ export class HMSSDK {
     const peer: HMSPeer = HMSEncoder.encodeHmsPeer(data.peer);
     const type = HMSEncoder.encodeHmsPeerUpdate(data.type) || data.type;
 
-    getHmsPeersCache()?.updatePeerCache(data.peer.peerID, data.peer, type);
+    if (type === HMSPeerUpdate.PEER_LEFT) {
+      this.sendPeerUpdateWhenPeerLeaves(data, peer, type);
+    } else {
+      getHmsPeersCache()?.updatePeerCache(data.peer.peerID, data.peer, type);
+      this.sendPeerUpdate(peer, type);
+    }
+  };
 
+  private sendPeerUpdate = (peer: any, type: any) => {
     if (this.onPeerDelegate) {
       logger?.verbose('#Listener ON_PEER_LISTENER_CALL', {
         peer,
@@ -2024,6 +2173,32 @@ export class HMSSDK {
       });
       this.onPeerDelegate({ peer, type });
     }
+  }
+
+  private sendPeerUpdateWhenPeerLeaves = (data: any, peer: any, type: any) => {
+    this.sendPeerUpdate(peer, type);
+
+    getHmsPeersCache()?.updatePeerCache(data.peer.peerID, data.peer, type);
+  }
+
+  onPeerListUpdatedListener = (data: any) => {
+    if (data.id !== this.id) {
+      return;
+    }
+    const addedPeers = HMSEncoder.encodeHmsPeers(data.addedPeers);
+    const removedPeers = HMSEncoder.encodeHmsPeers(data.removedPeers);
+
+    if (this.onPeerListUpdatedDelegate) {
+      logger?.verbose('#Listener ON_PEER_LIST_UPDATED_LISTENER_CALL', {
+        totalAddedPeers: addedPeers.length,
+        totalRemovedPeers: removedPeers.length,
+      });
+
+      this.onPeerListUpdatedDelegate({
+        addedPeers,
+        removedPeers,
+      });
+    }
   };
 
   onTrackListener = (data: any) => {
@@ -2324,12 +2499,20 @@ export class HMSSDK {
     }
   };
 
+  onPIPModeChangedListener = (data: { isInPictureInPictureMode: boolean }) => {
+    if (this.onPIPModeChangedDelegate) {
+      logger?.verbose('#Listener onPIPModeChanged_CALL', data);
+
+      this.onPIPModeChangedDelegate(data);
+    }
+  }
+
   async isPipModeSupported(): Promise<undefined | boolean> {
     return HMSManager.handlePipActions('isPipModeSupported', { id: this.id });
   }
 
-  async enablePipMode(data?: PIPConfig): Promise<undefined | boolean> {
-    return HMSManager.handlePipActions('enablePipMode', {
+  async enterPipMode(data?: PIPConfig): Promise<undefined | boolean> {
+    return HMSManager.handlePipActions('enterPipMode', {
       ...data,
       id: this.id,
     });

package/src/classes/HMSUpdateListenerActions.ts

@@ -26,4 +26,5 @@ export enum HMSUpdateListenerActions {
   ON_AUDIO_DEVICE_CHANGED = 'ON_AUDIO_DEVICE_CHANGED',
   ON_SESSION_STORE_AVAILABLE = 'ON_SESSION_STORE_AVAILABLE',
   ON_SESSION_STORE_CHANGED = 'ON_SESSION_STORE_CHANGED',
+  ON_PEER_LIST_UPDATED = 'ON_PEER_LIST_UPDATED',
 }