@100mslive/hms-video-store 0.2.55 → 0.2.58

package/dist/core/IHMSActions.d.ts

@@ -1,5 +1,5 @@
 import { HMSConfig, HMSSimulcastLayer, HMSAudioTrackSettings, HMSVideoTrackSettings, HMSLogLevel, HMSVideoPlugin, HMSAudioPlugin } from '@100mslive/hms-video';
-import { HMSPeerID, HMSRoleName, HMSTrackSource, IHMSPlaylistActions } from './schema';
+import { HMSMessageID, HMSPeerID, HMSRoleName, HMSTrackID, HMSTrackSource, IHMSPlaylistActions } from './schema';
 import { HMSRoleChangeRequest } from './selectors';
 import { RTMPRecordingConfig } from './hmsSDKStore/sdkTypes';
 /**
@@ -55,7 +55,7 @@ export interface IHMSActions {
      * This method removes the track from the local peer's list of auxiliary tracks and unpublishes it.
      * @param trackId string - ID of the track to be removed
      */
-    removeTrack(trackId: string): Promise<void>;
+    removeTrack(trackId: HMSTrackID): Promise<void>;
     /**
      * @deprecated The method should not be used
      * @see sendBroadcastMessage
@@ -93,21 +93,22 @@ export interface IHMSActions {
      * @param readStatus boolean value which you want to set as read flag for message/messages.
      * @param messageId message id whose read falg you want to set.
      */
-    setMessageRead(readStatus: boolean, messageId?: string): void;
+    setMessageRead(readStatus: boolean, messageId?: HMSMessageID): void;
     /**
-     * These functions can be used to mute/unmute the local peer's audio and video
-     * @param enabled boolean
+     * This function can be used to enable/disable(unmute/mute) local audio track
+     * @param enabled boolean - true to unmute, false to mute
      */
     setLocalAudioEnabled(enabled: boolean): Promise<void>;
     /**
-     * @see setLocalAudioEnabled
+     * This function can be used to enable/disable(unmute/mute) local video track
+     * @param enabled boolean - true to unmute, false to mute
      */
     setLocalVideoEnabled(enabled: boolean): Promise<void>;
     /**
      * @param trackId string - ID of the track whose mute status needs to be set
      * @param enabled boolean - true when we want to unmute the track and false when we want to unmute it
      */
-    setEnabledTrack(trackId: string, enabled: boolean): Promise<void>;
+    setEnabledTrack(trackId: HMSTrackID, enabled: boolean): Promise<void>;
     /**
      * Change settings of the local peer's audio track
      * @param settings HMSAudioTrackSettings
@@ -121,25 +122,25 @@ export interface IHMSActions {
      */
     setVideoSettings(settings: Partial<HMSVideoTrackSettings>): Promise<void>;
     /**
-     * If you're not using our Video Component you can use the below functions directly
+     * You can use the attach and detach video function
      * to add/remove video from an element for a track ID. The benefit of using this
      * instead of removing the video yourself is that it'll also auto unsubscribe to
      * the stream coming from server saving significant bandwidth for the user.
-     * @param trackID trackID as stored in the store for the peer
+     * @param localTrackID trackID as stored in the store for the peer
      * @param videoElement HTML native element where the video has to be shown
      */
-    attachVideo(trackID: string, videoElement: HTMLVideoElement): Promise<void>;
+    attachVideo(localTrackID: HMSTrackID, videoElement: HTMLVideoElement): Promise<void>;
     /**
      * @see attachVideo
      */
-    detachVideo(trackID: string, videoElement: HTMLVideoElement): Promise<void>;
+    detachVideo(localTrackID: HMSTrackID, videoElement: HTMLVideoElement): Promise<void>;
     /**
      * Set the output volume of audio tracks(overall/particular audio track)
      * @param value number between 0-100
      * @param trackId string If undefined sets the overall volume(of every audio track in the room); If valid - set the volume of particular audio track
      *
      */
-    setVolume(value: number, trackId?: string): void;
+    setVolume(value: number, trackId?: HMSTrackID): void;
     /**
      * Set the audio output(speaker) device
      * @param deviceId string deviceId of the audio output device
@@ -150,7 +151,7 @@ export interface IHMSActions {
      * @param trackId
      * @param layer
      */
-    setPreferredLayer(trackId: string, layer: HMSSimulcastLayer): void;
+    setPreferredLayer(trackId: HMSTrackID, layer: HMSSimulcastLayer): void;
     /**
      * Add or remove a video plugin from/to the local peer video track. Eg. Virtual Background, Face Filters etc.
      * Video plugins can be added/removed at any time after the join is successful.
@@ -172,7 +173,7 @@ export interface IHMSActions {
      * @param toRole The name of the new role.
      * @param [force] this being true would mean that user won't get a request to accept role change
      */
-    changeRole(forPeerId: string, toRole: string, force?: boolean): Promise<void>;
+    changeRole(forPeerId: HMSPeerID, toRole: HMSRoleName, force?: boolean): Promise<void>;
     /**
      * Accept the role change request received
      * @param {HMSRoleChangeRequest} request The original request that was received
@@ -189,9 +190,11 @@ export interface IHMSActions {
      * @param forRemoteTrackID The track ID or array of track IDs for which you want to change the state
      * @param enabled `true` if you wish to enable(unmute permission is required) the track, `false` if you wish to disable(mute permission is required) the track
      */
-    setRemoteTrackEnabled(forRemoteTrackID: string | string[], enabled: boolean): Promise<void>;
+    setRemoteTrackEnabled(forRemoteTrackID: HMSTrackID | HMSTrackID[], enabled: boolean): Promise<void>;
     /**
-     * Method to be called with some UI interaction after autoplay error is received
+     * Most browsers have limitations where an audio can not be played if there was no user interaction.
+     * SDK throws an autoplay error in this case, this method can be called after an UI interaction
+     * to resolve the autoplay error
      */
     unblockAudio: () => Promise<void>;
     /**
@@ -201,12 +204,12 @@ export interface IHMSActions {
     endRoom: (lock: boolean, reason: string) => Promise<void>;
     /**
      * If you have **removeOthers** permission, you can remove a peer from the room.
-     * @param peerID peerID of the peer to be removed from the remove
+     * @param peerID peerID of the peer to be removed from the room
      * @param reason a string explaining why the peer is removed from the room.
      * This string could be used to notify the user before they're removed from the room
      * using the `REMOVED_FROM_ROOM` type of notification
      */
-    removePeer(peerID: string, reason: string): Promise<void>;
+    removePeer(peerID: HMSPeerID, reason: string): Promise<void>;
     /**
      * If you want to start RTMP streaming or recording.
      * @param params.meetingURL This is the meeting url which is opened in a headless chrome instance for streaming and recording.

package/dist/core/hmsSDKStore/HMSSDKActions.d.ts

@@ -143,7 +143,13 @@ export declare class HMSSDKActions implements IHMSActions {
     private getStoreLocalTrackIDfromSDKTrack;
     private setProgress;
     private syncPlaylistState;
-    private syncTrackState;
+    /**
+     * Handle store update on remote track changes
+     * @param {string} action - 'trackAdded' | 'trackUpdate'
+     * @param {SDKHMSTrack} track - track added/updated
+     * @param {sdkTypes.HMSPeer}peer - peer on which track is added/updated
+     */
+    private syncRemoteTrackState;
     private peerUpdateInternal;
     /**
      * setState is separate so any future changes to how state change can be done from one place.

package/dist/core/hmsSDKStore/adapter.d.ts

@@ -39,16 +39,7 @@ export declare class SDKToHMS {
     };
     private static getConvertedPlaylistType;
     static convertRecordingRTMPState(recording: sdkTypes.HMSRecording | undefined, rtmp: sdkTypes.HMSRTMP | undefined): {
-        recording: {
-            browser: {
-                running: boolean;
-            };
-            server: {
-                running: boolean;
-            };
-        };
-        rtmp: {
-            running: boolean;
-        };
+        recording: sdkTypes.HMSRecording;
+        rtmp: sdkTypes.HMSRTMP;
     };
 }

package/dist/core/index.d.ts

@@ -4,4 +4,4 @@ export { IHMSNotifications as HMSNotifications } from './IHMSNotifications';
 export { HMSReactiveStore } from './hmsSDKStore/HMSReactiveStore';
 export * from './schema';
 export * from './selectors';
-export { HMSConfig, HMSAudioTrackSettings, HMSVideoTrackSettings, HMSSimulcastLayer, SimulcastLayerDefinition, DeviceMap, HMSLogLevel, RTMPRecordingConfig, } from './hmsSDKStore/sdkTypes';
+export { HMSConfig, HMSAudioTrackSettings, HMSVideoTrackSettings, HMSSimulcastLayer, SimulcastLayerDefinition, DeviceMap, HMSLogLevel, RTMPRecordingConfig, HMSRecording, HMSRTMP, } from './hmsSDKStore/sdkTypes';

package/dist/core/schema/index.d.ts

@@ -3,7 +3,6 @@ export * from './room';
 export * from './peer';
 export * from './message';
 export * from './settings';
-export * from './ui';
 export * from './notification';
 export * from './role';
 export * from './error';

package/dist/core/schema/room.d.ts

@@ -1,4 +1,5 @@
 import { HMSPeerID } from './peer';
+import { HMSRecording, HMSRTMP } from '@100mslive/hms-video';
 export declare type HMSRoomID = string;
 export declare enum HMSRoomState {
     Disconnected = "Disconnected",
@@ -17,15 +18,6 @@ export interface HMSRoom {
     shareableLink: string;
     hasWaitingRoom: boolean;
     roomState: HMSRoomState;
-    recording: {
-        browser: {
-            running: boolean;
-        };
-        server: {
-            running: boolean;
-        };
-    };
-    rtmp: {
-        running: boolean;
-    };
+    recording: HMSRecording;
+    rtmp: HMSRTMP;
 }

package/dist/core/selectors/selectors.d.ts

@@ -179,23 +179,5 @@ export declare const selectPermissions: import("reselect").OutputSelector<HMSSto
     mute: boolean;
     changeRole: boolean;
 } | undefined>;
-export declare const selectRecordingState: import("reselect").OutputSelector<HMSStore, {
-    browser: {
-        running: boolean;
-    };
-    server: {
-        running: boolean;
-    };
-}, (res: HMSRoom) => {
-    browser: {
-        running: boolean;
-    };
-    server: {
-        running: boolean;
-    };
-}>;
-export declare const selectRTMPState: import("reselect").OutputSelector<HMSStore, {
-    running: boolean;
-}, (res: HMSRoom) => {
-    running: boolean;
-}>;
+export declare const selectRecordingState: import("reselect").OutputSelector<HMSStore, import("@100mslive/hms-video/dist/interfaces/room").HMSRecording, (res: HMSRoom) => import("@100mslive/hms-video/dist/interfaces/room").HMSRecording>;
+export declare const selectRTMPState: import("reselect").OutputSelector<HMSStore, import("@100mslive/hms-video/dist/interfaces/room").HMSRTMP, (res: HMSRoom) => import("@100mslive/hms-video/dist/interfaces/room").HMSRTMP>;

package/dist/hms-video-store.cjs.development.js

@@ -1295,12 +1295,12 @@ var SDKToHMS = /*#__PURE__*/function () {
   };
 
   SDKToHMS.convertRecordingRTMPState = function convertRecordingRTMPState(recording, rtmp) {
-    var _recording$server;
+    var _recording$browser, _recording$server;
 
     return {
       recording: {
         browser: {
-          running: !!(recording != null && recording.browser.running)
+          running: !!(recording != null && (_recording$browser = recording.browser) != null && _recording$browser.running)
         },
         server: {
           running: !!(recording != null && (_recording$server = recording.server) != null && _recording$server.running)
@@ -2655,8 +2655,15 @@ var HMSSDKActions = /*#__PURE__*/function () {
         Object.assign(draftStore.playlist, SDKToHMS.convertPlaylist(_this.sdk.getPlaylistManager()));
       }, action);
     };
+    /**
+     * Handle store update on remote track changes
+     * @param {string} action - 'trackAdded' | 'trackUpdate'
+     * @param {SDKHMSTrack} track - track added/updated
+     * @param {sdkTypes.HMSPeer}peer - peer on which track is added/updated
+     */
 
-    this.syncTrackState = function (action, track, peer) {
+
+    this.syncRemoteTrackState = function (action, track, peer) {
       console.time('trackUpdate');
 
       _this.setState(function (draftStore) {
@@ -2664,19 +2671,23 @@ var HMSSDKActions = /*#__PURE__*/function () {
         var hmsTrack = SDKToHMS.convertTrack(track);
 
         if (action === 'trackAdded') {
+          var _peer$audioTrack, _peer$videoTrack;
+
           draftStore.tracks[track.trackId] = hmsTrack;
 
-          if (hmsTrack.source === 'regular') {
-            if (hmsTrack.type === 'audio') {
-              draftPeer.audioTrack = hmsTrack.id;
-            } else {
-              draftPeer.videoTrack = hmsTrack.id;
-            }
+          if (((_peer$audioTrack = peer.audioTrack) == null ? void 0 : _peer$audioTrack.trackId) === track.trackId) {
+            draftPeer.audioTrack = hmsTrack.id;
+          } else if (((_peer$videoTrack = peer.videoTrack) == null ? void 0 : _peer$videoTrack.trackId) === track.trackId) {
+            draftPeer.videoTrack = hmsTrack.id;
           } else if (!draftPeer.auxiliaryTracks.includes(hmsTrack.id)) {
             draftPeer.auxiliaryTracks.push(hmsTrack.id);
           }
         } else {
-          Object.assign(draftStore.tracks[hmsTrack.id], hmsTrack);
+          if (draftStore.tracks[hmsTrack.id]) {
+            Object.assign(draftStore.tracks[hmsTrack.id], hmsTrack);
+          } else {
+            _this.logPossibleInconsistency("track " + hmsTrack.id + " not present, unable to update track");
+          }
         }
 
         _this.hmsSDKTracks[hmsTrack.id] = track;
@@ -4161,7 +4172,7 @@ var HMSSDKActions = /*#__PURE__*/function () {
       this.handleTrackRemove(track, peer);
     } else {
       var actionName = type === sdkTypes.HMSTrackUpdate.TRACK_ADDED ? 'trackAdded' : 'trackUpdate';
-      this.syncTrackState(actionName, track, peer);
+      this.syncRemoteTrackState(actionName, track, peer);
       this.hmsNotifications.sendTrackUpdate(type, track.trackId);
     }
   };