@webex/plugin-meetings 3.0.0-beta.33 → 3.0.0-beta.331

package/src/media/properties.ts

@@ -1,41 +1,65 @@
 import {ConnectionState, Event} from '@webex/internal-media-core';
 
-import {MEETINGS, PC_BAIL_TIMEOUT, QUALITY_LEVELS} from '../constants';
+import {
+  LocalCameraStream,
+  LocalMicrophoneStream,
+  LocalDisplayStream,
+  LocalSystemAudioStream,
+  RemoteStream,
+} from '@webex/media-helpers';
+
+import {MEETINGS, ICE_AND_DTLS_CONNECTION_TIMEOUT, QUALITY_LEVELS} from '../constants';
 import LoggerProxy from '../common/logs/logger-proxy';
 
+export type MediaDirection = {
+  sendAudio: boolean;
+  sendVideo: boolean;
+  sendShare: boolean;
+  receiveAudio: boolean;
+  receiveVideo: boolean;
+  receiveShare: boolean;
+};
+
 /**
  * @class MediaProperties
  */
 export default class MediaProperties {
-  audioTrack: any;
-  localQualityLevel: any;
-  mediaDirection: any;
+  audioStream?: LocalMicrophoneStream;
+  mediaDirection: MediaDirection;
   mediaSettings: any;
   webrtcMediaConnection: any;
-  remoteAudioTrack: any;
+  remoteAudioStream: RemoteStream;
   remoteQualityLevel: any;
-  remoteShare: any;
-  remoteVideoTrack: any;
-  shareTrack: any;
+  remoteShareStream: RemoteStream;
+  remoteVideoStream: RemoteStream;
+  shareVideoStream?: LocalDisplayStream;
+  shareAudioStream?: LocalSystemAudioStream;
   videoDeviceId: any;
-  videoTrack: any;
+  videoStream?: LocalCameraStream;
   namespace = MEETINGS;
 
   /**
    * @param {Object} [options] -- to auto construct
    * @returns {MediaProperties}
    */
-  constructor(options: any = {}) {
+  constructor() {
     this.webrtcMediaConnection = null;
-    this.mediaDirection = options.mediaDirection;
-    this.videoTrack = options.videoTrack;
-    this.audioTrack = options.audioTrack;
-    this.shareTrack = options.shareTrack;
-    this.remoteShare = options.remoteShare;
-    this.remoteAudioTrack = options.remoteAudioTrack;
-    this.remoteVideoTrack = options.remoteVideoTrack;
-    this.localQualityLevel = options.localQualityLevel || QUALITY_LEVELS['720p'];
-    this.remoteQualityLevel = options.remoteQualityLevel || QUALITY_LEVELS.HIGH;
+    this.mediaDirection = {
+      receiveAudio: false,
+      receiveVideo: false,
+      receiveShare: false,
+      sendAudio: false,
+      sendVideo: false,
+      sendShare: false,
+    };
+    this.videoStream = null;
+    this.audioStream = null;
+    this.shareVideoStream = null;
+    this.shareAudioStream = null;
+    this.remoteShareStream = undefined;
+    this.remoteAudioStream = undefined;
+    this.remoteVideoStream = undefined;
+    this.remoteQualityLevel = QUALITY_LEVELS.HIGH;
     this.mediaSettings = {};
     this.videoDeviceId = null;
   }
@@ -60,46 +84,46 @@ export default class MediaProperties {
     this.webrtcMediaConnection = mediaPeerConnection;
   }
 
-  setLocalVideoTrack(videoTrack) {
-    this.videoTrack = videoTrack;
+  setLocalVideoStream(videoStream?: LocalCameraStream) {
+    this.videoStream = videoStream;
   }
 
-  setLocalAudioTrack(audioTrack) {
-    this.audioTrack = audioTrack;
+  setLocalAudioStream(audioStream?: LocalMicrophoneStream) {
+    this.audioStream = audioStream;
   }
 
-  setLocalQualityLevel(localQualityLevel) {
-    this.localQualityLevel = localQualityLevel;
+  setLocalShareVideoStream(shareVideoStream?: LocalDisplayStream) {
+    this.shareVideoStream = shareVideoStream;
   }
 
-  setLocalShareTrack(shareTrack) {
-    this.shareTrack = shareTrack;
+  setLocalShareAudioStream(shareAudioStream?: LocalSystemAudioStream) {
+    this.shareAudioStream = shareAudioStream;
   }
 
   setRemoteQualityLevel(remoteQualityLevel) {
     this.remoteQualityLevel = remoteQualityLevel;
   }
 
-  setRemoteShare(remoteShare) {
-    this.remoteShare = remoteShare;
+  setRemoteShareStream(remoteShareStream: RemoteStream) {
+    this.remoteShareStream = remoteShareStream;
   }
 
   /**
-   * Sets the remote audio track
-   * @param {MediaTrack} remoteAudioTrack MediaTrack to save
+   * Sets the remote audio stream
+   * @param {RemoteStream} remoteAudioStream RemoteStream to save
    * @returns {void}
    */
-  setRemoteAudioTrack(remoteAudioTrack: any) {
-    this.remoteAudioTrack = remoteAudioTrack;
+  setRemoteAudioStream(remoteAudioStream: RemoteStream) {
+    this.remoteAudioStream = remoteAudioStream;
   }
 
   /**
-   * Sets the remote video track
-   * @param {MediaTrack} remoteVideoTrack MediaTrack to save
+   * Sets the remote video stream
+   * @param {RemoteStream} remoteVideoStream RemoteStream to save
    * @returns {void}
    */
-  setRemoteVideoTrack(remoteVideoTrack: any) {
-    this.remoteVideoTrack = remoteVideoTrack;
+  setRemoteVideoStream(remoteVideoStream: RemoteStream) {
+    this.remoteVideoStream = remoteVideoStream;
   }
 
   /**
@@ -115,96 +139,34 @@ export default class MediaProperties {
     this.webrtcMediaConnection = null;
   }
 
-  unsetLocalVideoTrack() {
-    this.videoTrack = null;
-  }
-
-  unsetLocalShareTrack() {
-    this.shareTrack = null;
-  }
-
-  unsetLocalAudioTrack() {
-    this.audioTrack = null;
-  }
-
-  /**
-   * Removes remote stream from class instance
-   * @deprecated after v1.89.3
-   * @returns {void}
-   */
-  unsetRemoteStream() {
-    LoggerProxy.logger.warn(
-      'Media:properties#unsetRemoteStream --> [DEPRECATION WARNING]: unsetRemoteStream has been deprecated after v1.89.3 (use unsetRemoteTracks instead)'
-    );
-    // unsets audio and video only
-    this.unsetRemoteMedia();
-  }
-
   /**
    * Removes both remote audio and video from class instance
    * @returns {void}
    */
   unsetRemoteMedia() {
-    this.remoteAudioTrack = null;
-    this.remoteVideoTrack = null;
-  }
-
-  unsetRemoteShare() {
-    this.remoteShare = null;
+    this.remoteAudioStream = null;
+    this.remoteVideoStream = null;
   }
 
-  unsetLocalVideoTracks() {
-    this.unsetLocalVideoTrack();
-    this.unsetLocalShareTrack();
+  unsetRemoteShareStream() {
+    this.remoteShareStream = null;
   }
 
   /**
-   * Removes remote stream and remote share from class instance
-   * @deprecated after v1.89.3
+   * Unsets all remote streams
    * @returns {void}
    */
   unsetRemoteStreams() {
-    LoggerProxy.logger.warn(
-      'Media:properties#unsetRemoteStreams --> [DEPRECATION WARNING]: unsetRemoteStreams has been deprecated after v1.89.3 (use unsetRemoteTracks instead)'
-    );
-    this.unsetRemoteStream();
-    this.unsetRemoteShare();
-  }
-
-  /**
-   * Unsets all remote tracks
-   * @returns {void}
-   */
-  unsetRemoteTracks() {
     this.unsetRemoteMedia();
-    this.unsetRemoteShare();
-  }
-
-  unsetShareStreams() {
-    this.unsetLocalShareTrack();
-    this.unsetRemoteShare();
+    this.unsetRemoteShareStream();
   }
 
   /**
-   * Removes both local and remote video stream from class instance
-   * @deprecated after v1.89.3
-   * @returns {void}
+   * Returns if we have at least one local share stream or not.
+   * @returns {Boolean}
    */
-  unsetMediaStreams() {
-    LoggerProxy.logger.warn(
-      'Media:properties#unsetMediaStreams --> [DEPRECATION WARNING]: unsetMediaStreams has been deprecated after v1.89.3 (use unsetMediaTracks instead)'
-    );
-    this.unsetLocalVideoTrack();
-    this.unsetRemoteStream();
-  }
-
-  /**
-   * Removes both local and remote video stream from class instance
-   * @returns {void}
-   */
-  unsetMediaTracks() {
-    this.unsetLocalVideoTrack();
-    this.unsetRemoteMedia();
+  hasLocalShareStream() {
+    return !!(this.shareAudioStream || this.shareVideoStream);
   }
 
   /**
@@ -238,7 +200,7 @@ export default class MediaProperties {
       timer = setTimeout(() => {
         this.webrtcMediaConnection.off(Event.CONNECTION_STATE_CHANGED, connectionStateListener);
         reject();
-      }, PC_BAIL_TIMEOUT);
+      }, ICE_AND_DTLS_CONNECTION_TIMEOUT);
 
       this.webrtcMediaConnection.on(Event.CONNECTION_STATE_CHANGED, connectionStateListener);
     });
@@ -297,10 +259,25 @@ export default class MediaProperties {
 
         return true;
       }
+      LoggerProxy.logger.warn(
+        `Media:properties#getCurrentConnectionType --> missing localCandidate.protocol, candidateType=${localCandidate.candidateType}`
+      );
 
       return false;
     });
 
+    if (foundConnectionType === 'unknown') {
+      const candidatePairStates = allStatsReports
+        .filter((report) => report.type === 'candidate-pair')
+        .map((report) => report.state);
+
+      LoggerProxy.logger.warn(
+        `Media:properties#getCurrentConnectionType --> all candidate pair states: ${JSON.stringify(
+          candidatePairStates
+        )}`
+      );
+    }
+
     return foundConnectionType;
   }
 }

package/src/meeting/in-meeting-actions.ts

@@ -17,7 +17,11 @@ interface IInMeetingActions {
   canUnsetMuteOnEntry?: boolean;
   canSetDisallowUnmute?: boolean;
   canUnsetDisallowUnmute?: boolean;
+  canSetMuted?: boolean;
+  canUnsetMuted?: boolean;
   canAssignHost?: boolean;
+  canSetPresenter?: boolean;
+  canUnsetPresenter?: boolean;
   canStartRecording?: boolean;
   canPauseRecording?: boolean;
   canResumeRecording?: boolean;
@@ -30,13 +34,51 @@ interface IInMeetingActions {
   canStartTranscribing?: boolean;
   canStopTranscribing?: boolean;
   isClosedCaptionActive?: boolean;
+  isSaveTranscriptsEnabled?: boolean;
   isWebexAssistantActive?: boolean;
   canViewCaptionPanel?: boolean;
   isRealTimeTranslationEnabled?: boolean;
   canSelectSpokenLanguages?: boolean;
   waitingForOthersToJoin?: boolean;
-  canEnableReactions?: boolean;
   canSendReactions?: boolean;
+  canManageBreakout?: boolean;
+  canBroadcastMessageToBreakout?: boolean;
+  canAdmitLobbyToBreakout?: boolean;
+  isBreakoutPreassignmentsEnabled?: boolean;
+  canUserAskForHelp?: boolean;
+  canUserRenameSelfAndObserved?: boolean;
+  canUserRenameOthers?: boolean;
+  canMuteAll?: boolean;
+  canUnmuteAll?: boolean;
+  canEnableHardMute?: boolean;
+  canDisableHardMute?: boolean;
+  canEnableMuteOnEntry?: boolean;
+  canDisableMuteOnEntry?: boolean;
+  canEnableReactions?: boolean;
+  canDisableReactions?: boolean;
+  canEnableReactionDisplayNames?: boolean;
+  canDisableReactionDisplayNames?: boolean;
+  canUpdateShareControl?: boolean;
+  canEnableViewTheParticipantsList?: boolean;
+  canDisableViewTheParticipantsList?: boolean;
+  canEnableRaiseHand?: boolean;
+  canDisableRaiseHand?: boolean;
+  canEnableVideo?: boolean;
+  canDisableVideo?: boolean;
+  canShareFile?: boolean;
+  canShareApplication?: boolean;
+  canShareCamera?: boolean;
+  canShareDesktop?: boolean;
+  canShareContent?: boolean;
+  canTransferFile?: boolean;
+  canChat?: boolean;
+  canDoVideo?: boolean;
+  canAnnotate?: boolean;
+  canUseVoip?: boolean;
+  supportHQV?: boolean;
+  supportHDV?: boolean;
+  canShareWhiteBoard?: boolean;
+  enforceVirtualBackground?: boolean;
 }
 
 /**
@@ -65,12 +107,20 @@ export default class InMeetingActions implements IInMeetingActions {
 
   canSetMuteOnEntry = null;
 
+  canSetPresenter = null;
+
+  canUnsetPresenter = null;
+
   canUnsetMuteOnEntry = null;
 
   canSetDisallowUnmute = null;
 
   canUnsetDisallowUnmute = null;
 
+  canSetMuted = null;
+
+  canUnsetMuted = null;
+
   canRaiseHand = null;
 
   canLowerAllHands = null;
@@ -87,6 +137,8 @@ export default class InMeetingActions implements IInMeetingActions {
 
   isClosedCaptionActive = null;
 
+  isSaveTranscriptsEnabled = null;
+
   isWebexAssistantActive = null;
 
   canViewCaptionPanel = null;
@@ -97,9 +149,83 @@ export default class InMeetingActions implements IInMeetingActions {
 
   waitingForOthersToJoin = null;
 
+  canSendReactions = null;
+
+  canManageBreakout = null;
+
+  canBroadcastMessageToBreakout = null;
+
+  canAdmitLobbyToBreakout = null;
+
+  isBreakoutPreassignmentsEnabled = null;
+
+  canUserAskForHelp = null;
+
+  canUserRenameSelfAndObserved = null;
+
+  canUserRenameOthers = null;
+
+  canMuteAll = null;
+
+  canUnmuteAll = null;
+
+  canEnableHardMute = null;
+
+  canDisableHardMute = null;
+
+  canEnableMuteOnEntry = null;
+
+  canDisableMuteOnEntry = null;
+
   canEnableReactions = null;
 
-  canSendReactions = null;
+  canDisableReactions = null;
+
+  canEnableReactionDisplayNames = null;
+
+  canDisableReactionDisplayNames = null;
+
+  canUpdateShareControl = null;
+
+  canEnableViewTheParticipantsList = null;
+
+  canDisableViewTheParticipantsList = null;
+
+  canEnableRaiseHand = null;
+
+  canDisableRaiseHand = null;
+
+  canEnableVideo = null;
+
+  canDisableVideo = null;
+
+  canShareFile = null;
+
+  canShareApplication = null;
+
+  canShareCamera = null;
+
+  canShareDesktop = null;
+
+  canShareContent = null;
+
+  canTransferFile = null;
+
+  canChat = null;
+
+  canDoVideo = null;
+
+  canAnnotate = null;
+
+  canUseVoip = null;
+
+  supportHQV = null;
+
+  enforceVirtualBackground = null;
+
+  supportHDV = null;
+
+  canShareWhiteBoard = null;
 
   /**
    * Returns all meeting action options
@@ -114,6 +240,10 @@ export default class InMeetingActions implements IInMeetingActions {
     canSetMuteOnEntry: this.canSetMuteOnEntry,
     canUnsetMuteOnEntry: this.canUnsetMuteOnEntry,
     canSetDisallowUnmute: this.canSetDisallowUnmute,
+    canSetMuted: this.canSetMuted,
+    canUnsetMuted: this.canUnsetMuted,
+    canSetPresenter: this.canSetPresenter,
+    canUnsetPresenter: this.canUnsetPresenter,
     canUnsetDisallowUnmute: this.canUnsetDisallowUnmute,
     canStartRecording: this.canStartRecording,
     canPauseRecording: this.canPauseRecording,
@@ -127,13 +257,51 @@ export default class InMeetingActions implements IInMeetingActions {
     canStartTranscribing: this.canStartTranscribing,
     canStopTranscribing: this.canStopTranscribing,
     isClosedCaptionActive: this.isClosedCaptionActive,
+    isSaveTranscriptsEnabled: this.isSaveTranscriptsEnabled,
     isWebexAssistantActive: this.isWebexAssistantActive,
     canViewCaptionPanel: this.canViewCaptionPanel,
     isRealTimeTranslationEnabled: this.isRealTimeTranslationEnabled,
     canSelectSpokenLanguages: this.canSelectSpokenLanguages,
     waitingForOthersToJoin: this.waitingForOthersToJoin,
-    canEnableReactions: this.canEnableReactions,
     canSendReactions: this.canSendReactions,
+    canManageBreakout: this.canManageBreakout,
+    canBroadcastMessageToBreakout: this.canBroadcastMessageToBreakout,
+    canAdmitLobbyToBreakout: this.canAdmitLobbyToBreakout,
+    isBreakoutPreassignmentsEnabled: this.isBreakoutPreassignmentsEnabled,
+    canUserAskForHelp: this.canUserAskForHelp,
+    canUserRenameSelfAndObserved: this.canUserRenameSelfAndObserved,
+    canUserRenameOthers: this.canUserRenameOthers,
+    canMuteAll: this.canMuteAll,
+    canUnmuteAll: this.canUnmuteAll,
+    canEnableHardMute: this.canEnableHardMute,
+    canDisableHardMute: this.canDisableHardMute,
+    canEnableMuteOnEntry: this.canEnableMuteOnEntry,
+    canDisableMuteOnEntry: this.canDisableMuteOnEntry,
+    canEnableReactions: this.canEnableReactions,
+    canDisableReactions: this.canDisableReactions,
+    canEnableReactionDisplayNames: this.canEnableReactionDisplayNames,
+    canDisableReactionDisplayNames: this.canDisableReactionDisplayNames,
+    canUpdateShareControl: this.canUpdateShareControl,
+    canEnableViewTheParticipantsList: this.canEnableViewTheParticipantsList,
+    canDisableViewTheParticipantsList: this.canDisableViewTheParticipantsList,
+    canEnableRaiseHand: this.canEnableRaiseHand,
+    canDisableRaiseHand: this.canDisableRaiseHand,
+    canEnableVideo: this.canEnableVideo,
+    canDisableVideo: this.canDisableVideo,
+    canShareFile: this.canShareFile,
+    canShareApplication: this.canShareApplication,
+    canShareCamera: this.canShareCamera,
+    canShareDesktop: this.canShareDesktop,
+    canShareContent: this.canShareContent,
+    canTransferFile: this.canTransferFile,
+    canChat: this.canChat,
+    canDoVideo: this.canDoVideo,
+    canAnnotate: this.canAnnotate,
+    canUseVoip: this.canUseVoip,
+    enforceVirtualBackground: this.enforceVirtualBackground,
+    supportHQV: this.supportHQV,
+    supportHDV: this.supportHDV,
+    canShareWhiteBoard: this.canShareWhiteBoard,
   });
 
   /**