@webex/plugin-meetings 3.6.0-next.9 → 3.7.0-next.1

package/src/constants.ts

@@ -356,6 +356,11 @@ export const EVENT_TRIGGERS = {
     'meeting:controls:view-the-participants-list:updated',
   MEETING_CONTROLS_RAISE_HAND_UPDATED: 'meeting:controls:raise-hand:updated',
   MEETING_CONTROLS_VIDEO_UPDATED: 'meeting:controls:video:updated',
+  MEETING_CONTROLS_STAGE_VIEW_UPDATED: 'meeting:controls:stage-view:updated',
+  MEETING_CONTROLS_WEBCAST_UPDATED: 'meeting:controls:webcast:updated',
+  MEETING_CONTROLS_MEETING_FULL_UPDATED: 'meeting:controls:meeting-full:updated',
+  MEETING_CONTROLS_PRACTICE_SESSION_STATUS_UPDATED:
+    'meeting:controls:practice-session-status:updated',
   // Locus URL changed
   MEETING_LOCUS_URL_UPDATE: 'meeting:locus:locusUrl:update',
   MEETING_STREAM_PUBLISH_STATE_CHANGED: 'meeting:streamPublishStateChanged',
@@ -676,7 +681,11 @@ export const LOCUSINFO = {
     CONTROLS_REACTIONS_CHANGED: 'CONTROLS_REACTIONS_CHANGED',
     CONTROLS_VIEW_THE_PARTICIPANTS_LIST_CHANGED: 'CONTROLS_VIEW_THE_PARTICIPANTS_LIST_CHANGED',
     CONTROLS_RAISE_HAND_CHANGED: 'CONTROLS_RAISE_HAND_CHANGED',
+    CONTROLS_WEBCAST_CHANGED: 'CONTROLS_WEBCAST_CHANGED',
+    CONTROLS_MEETING_FULL_CHANGED: 'CONTROLS_MEETING_FULL_CHANGED',
+    CONTROLS_PRACTICE_SESSION_STATUS_UPDATED: 'CONTROLS_PRACTICE_SESSION_STATUS_UPDATED',
     CONTROLS_VIDEO_CHANGED: 'CONTROLS_VIDEO_CHANGED',
+    CONTROLS_STAGE_VIEW_UPDATED: 'CONTROLS_STAGE_VIEW_UPDATED',
     SELF_UNADMITTED_GUEST: 'SELF_UNADMITTED_GUEST',
     SELF_ADMITTED_GUEST: 'SELF_ADMITTED_GUEST',
     SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED: 'SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED',
@@ -702,6 +711,7 @@ export const LOCUSINFO = {
     SELF_MEETING_INTERPRETATION_CHANGED: 'SELF_MEETING_INTERPRETATION_CHANGED',
     MEDIA_INACTIVITY: 'MEDIA_INACTIVITY',
     LINKS_SERVICES: 'LINKS_SERVICES',
+    LINKS_RESOURCES: 'LINKS_RESOURCES',
   },
 };
 
@@ -944,6 +954,11 @@ export const DISPLAY_HINTS = {
   // participants list
   DISABLE_VIEW_THE_PARTICIPANT_LIST: 'DISABLE_VIEW_THE_PARTICIPANT_LIST',
   ENABLE_VIEW_THE_PARTICIPANT_LIST: 'ENABLE_VIEW_THE_PARTICIPANT_LIST',
+  // for webinar participants list
+  DISABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST: 'DISABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST',
+  ENABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST: 'ENABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST',
+  DISABLE_SHOW_ATTENDEE_COUNT: 'DISABLE_SHOW_ATTENDEE_COUNT',
+  ENABLE_SHOW_ATTENDEE_COUNT: 'ENABLE_SHOW_ATTENDEE_COUNT',
 
   // raise hand
   DISABLE_RAISE_HAND: 'DISABLE_RAISE_HAND',
@@ -963,6 +978,16 @@ export const DISPLAY_HINTS = {
 
   // Voip (audio/video)
   VOIP_IS_ENABLED: 'VOIP_IS_ENABLED',
+
+  // Webcast
+  WEBCAST_CONTROL_START: 'WEBCAST_CONTROL_START',
+  WEBCAST_CONTROL_STOP: 'WEBCAST_CONTROL_STOP',
+
+  // Stage View
+  STAGE_VIEW_ACTIVE: 'STAGE_VIEW_ACTIVE',
+  STAGE_VIEW_INACTIVE: 'STAGE_VIEW_INACTIVE',
+  ENABLE_STAGE_VIEW: 'ENABLE_STAGE_VIEW',
+  DISABLE_STAGE_VIEW: 'DISABLE_STAGE_VIEW',
 };
 
 export const INTERSTITIAL_DISPLAY_HINTS = [DISPLAY_HINTS.VOIP_IS_ENABLED];

package/src/controls-options-manager/enums.ts

@@ -2,6 +2,7 @@ enum Setting {
   disallowUnmute = 'DisallowUnmute',
   muteOnEntry = 'MuteOnEntry',
   muted = 'Muted',
+  roles = 'Roles',
 }
 
 enum Control {

package/src/controls-options-manager/index.ts

@@ -177,7 +177,12 @@ export default class ControlsOptionsManager {
    * @memberof ControlsOptionsManager
    * @returns {Promise}
    */
-  private setControls(setting: {[key in Setting]?: boolean}): Promise<any> {
+  private setControls(setting: {
+    [Setting.muted]?: boolean;
+    [Setting.disallowUnmute]?: boolean;
+    [Setting.muteOnEntry]?: boolean;
+    [Setting.roles]?: Array<string>;
+  }): Promise<any> {
     LoggerProxy.logger.log(
       `ControlsOptionsManager:index#setControls --> ${JSON.stringify(setting)}`
     );
@@ -190,6 +195,7 @@ export default class ControlsOptionsManager {
     Object.entries(setting).forEach(([key, value]) => {
       if (
         !shouldSkipCheckToMergeBody &&
+        value !== undefined &&
         !Util?.[`${value ? CAN_SET : CAN_UNSET}${key}`](this.displayHints)
       ) {
         error = new PermissionError(`${key} [${value}] not allowed, due to moderator property.`);
@@ -219,6 +225,14 @@ export default class ControlsOptionsManager {
           }
           break;
 
+        case Setting.roles:
+          if (Array.isArray(value)) {
+            body.audio = body.audio
+              ? {...body.audio, [camelCase(key)]: value}
+              : {[camelCase(key)]: value};
+          }
+          break;
+
         default:
           error = new PermissionError(`${key} [${value}] not allowed, due to moderator property.`);
       }
@@ -261,18 +275,21 @@ export default class ControlsOptionsManager {
    * @param {boolean} mutedEnabled
    * @param {boolean} disallowUnmuteEnabled
    * @param {boolean} muteOnEntryEnabled
+   * @param {array} roles which should be muted
    * @memberof ControlsOptionsManager
    * @returns {Promise}
    */
   public setMuteAll(
     mutedEnabled: boolean,
     disallowUnmuteEnabled: boolean,
-    muteOnEntryEnabled: boolean
+    muteOnEntryEnabled: boolean,
+    roles: Array<string>
   ): Promise<any> {
     return this.setControls({
       [Setting.muted]: mutedEnabled,
       [Setting.disallowUnmute]: disallowUnmuteEnabled,
       [Setting.muteOnEntry]: muteOnEntryEnabled,
+      [Setting.roles]: roles,
     });
   }
 }

package/src/controls-options-manager/types.ts

@@ -36,6 +36,8 @@ export interface VideoProperties {
 
 export interface ViewTheParticipantListProperties {
   enabled?: boolean;
+  panelistEnabled?: boolean;
+  attendeeCount?: boolean;
 }
 
 export type Properties =

package/src/controls-options-manager/util.ts

@@ -217,6 +217,18 @@ class Utils {
     if (control.properties.enabled === false) {
       requiredHints.push(DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST);
     }
+    if (control.properties.panelistEnabled === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST);
+    }
+    if (control.properties.panelistEnabled === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST);
+    }
+    if (control.properties.attendeeCount === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_SHOW_ATTENDEE_COUNT);
+    }
+    if (control.properties.attendeeCount === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_SHOW_ATTENDEE_COUNT);
+    }
 
     return Utils.hasHints({requiredHints, displayHints});
   }

package/src/locus-info/controlsUtils.ts

@@ -79,7 +79,11 @@ ControlsUtils.parse = (controls: any) => {
   }
 
   if (controls?.viewTheParticipantList) {
-    parsedControls.viewTheParticipantList = {enabled: controls.viewTheParticipantList.enabled};
+    parsedControls.viewTheParticipantList = {
+      enabled: controls.viewTheParticipantList?.enabled ?? false,
+      panelistEnabled: controls.viewTheParticipantList?.panelistEnabled ?? false,
+      attendeeCount: controls.viewTheParticipantList?.attendeeCount ?? 0,
+    };
   }
 
   if (controls?.raiseHand) {
@@ -90,6 +94,23 @@ ControlsUtils.parse = (controls: any) => {
     parsedControls.video = {enabled: controls.video.enabled};
   }
 
+  if (controls?.webcastControl) {
+    parsedControls.webcastControl = {streaming: controls.webcastControl.streaming};
+  }
+
+  if (controls?.meetingFull) {
+    parsedControls.meetingFull = {
+      meetingFull: controls.meetingFull?.meetingFull ?? false,
+      meetingPanelistFull: controls.meetingFull?.meetingPanelistFull ?? false,
+    };
+  }
+
+  if (controls?.practiceSession) {
+    parsedControls.practiceSession = {
+      enabled: controls.practiceSession.enabled,
+    };
+  }
+
   return parsedControls;
 };
 
@@ -121,7 +142,11 @@ ControlsUtils.getControls = (oldControls: any, newControls: any) => {
         previous?.reactions?.showDisplayNameWithReactions,
 
       hasViewTheParticipantListChanged:
-        current?.viewTheParticipantList?.enabled !== previous?.viewTheParticipantList?.enabled,
+        current?.viewTheParticipantList?.enabled !== previous?.viewTheParticipantList?.enabled ||
+        current?.viewTheParticipantList?.panelistEnabled !==
+          previous?.viewTheParticipantList?.panelistEnabled ||
+        current?.viewTheParticipantList?.attendeeCount !==
+          previous?.viewTheParticipantList?.attendeeCount,
 
       hasRaiseHandChanged: current?.raiseHand?.enabled !== previous?.raiseHand?.enabled,
 
@@ -167,6 +192,25 @@ ControlsUtils.getControls = (oldControls: any, newControls: any) => {
       hasVideoEnabledChanged:
         newControls.video?.enabled !== undefined &&
         !isEqual(previous?.videoEnabled, current?.videoEnabled),
+
+      hasWebcastChanged: !isEqual(
+        previous?.webcastControl?.streaming,
+        current?.webcastControl?.streaming
+      ),
+
+      hasMeetingFullChanged:
+        !isEqual(previous?.meetingFull?.meetingFull, current?.meetingFull?.meetingFull) ||
+        !isEqual(
+          previous?.meetingFull?.meetingPanelistFull,
+          current?.meetingFull?.meetingPanelistFull
+        ),
+
+      hasPracticeSessionEnabledChanged: !isEqual(
+        previous?.practiceSession?.enabled,
+        current?.practiceSession?.enabled
+      ),
+
+      hasStageViewChanged: !isEqual(previous?.videoLayout, current?.videoLayout),
     },
   };
 };

package/src/locus-info/fullState.ts

@@ -6,6 +6,7 @@ FullState.parse = (fullState) => ({
   type: fullState.type || FULL_STATE.UNKNOWN,
   meetingState: fullState.state,
   locked: fullState.locked,
+  attendeeCount: typeof fullState.attendeeCount === 'number' ? fullState.attendeeCount : 0,
 });
 
 FullState.getFullState = (oldFullState, newFullState) => {

package/src/locus-info/index.ts

@@ -64,6 +64,7 @@ export default class LocusInfo extends EventsScope {
   replace: any;
   url: any;
   services: any;
+  resources: any;
   mainSessionLocusCache: any;
   /**
    * Constructor
@@ -263,6 +264,7 @@ export default class LocusInfo extends EventsScope {
     this.updateHostInfo(locus.host);
     this.updateMediaShares(locus.mediaShares);
     this.updateServices(locus.links?.services);
+    this.updateResources(locus.links?.resources);
   }
 
   /**
@@ -452,6 +454,7 @@ export default class LocusInfo extends EventsScope {
     this.updateIdentifiers(locus.identities);
     this.updateEmbeddedApps(locus.embeddedApps);
     this.updateServices(locus.links?.services);
+    this.updateResources(locus.links?.resources);
     this.compareAndUpdate();
     // update which required to compare different objects from locus
   }
@@ -805,6 +808,10 @@ export default class LocusInfo extends EventsScope {
           hasRaiseHandChanged,
           hasVideoChanged,
           hasInterpretationChanged,
+          hasWebcastChanged,
+          hasMeetingFullChanged,
+          hasPracticeSessionEnabledChanged,
+          hasStageViewChanged,
         },
         current,
       } = ControlsUtils.getControls(this.controls, controls);
@@ -1008,6 +1015,38 @@ export default class LocusInfo extends EventsScope {
         );
       }
 
+      if (hasWebcastChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_WEBCAST_CHANGED,
+          {state: current.webcastControl}
+        );
+      }
+
+      if (hasMeetingFullChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_MEETING_FULL_CHANGED,
+          {state: current.meetingFull}
+        );
+      }
+
+      if (hasPracticeSessionEnabledChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_PRACTICE_SESSION_STATUS_UPDATED,
+          {state: current.practiceSession}
+        );
+      }
+
+      if (hasStageViewChanged) {
+        this.emitScoped(
+          {file: 'locus-info', function: 'updateControls'},
+          LOCUSINFO.EVENTS.CONTROLS_STAGE_VIEW_UPDATED,
+          {state: current.videoLayout}
+        );
+      }
+
       this.controls = controls;
     }
   }
@@ -1064,6 +1103,27 @@ export default class LocusInfo extends EventsScope {
     }
   }
 
+  /**
+   * @param {Object} resources
+   * @returns {undefined}
+   * @memberof LocusInfo
+   */
+  updateResources(resources: Record<'webcastInstance', {url: string}>) {
+    if (resources && !isEqual(this.resources, resources)) {
+      this.resources = resources;
+      this.emitScoped(
+        {
+          file: 'locus-info',
+          function: 'updateResources',
+        },
+        LOCUSINFO.EVENTS.LINKS_RESOURCES,
+        {
+          resources,
+        }
+      );
+    }
+  }
+
   /**
    * @param {Object} fullState
    * @returns {undefined}

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

@@ -3,6 +3,7 @@
  */
 
 import {MEETINGS} from '../constants';
+import ControlsOptionsUtil from '../controls-options-manager/util';
 
 /**
  * IInMeetingActions
@@ -64,6 +65,10 @@ interface IInMeetingActions {
   canUpdateShareControl?: boolean;
   canEnableViewTheParticipantsList?: boolean;
   canDisableViewTheParticipantsList?: boolean;
+  canEnableViewTheParticipantsListPanelist?: boolean;
+  canDisableViewTheParticipantsListPanelist?: boolean;
+  canEnableShowAttendeeCount?: boolean;
+  canDisableShowAttendeeCount?: boolean;
   canEnableRaiseHand?: boolean;
   canDisableRaiseHand?: boolean;
   canEnableVideo?: boolean;
@@ -83,6 +88,11 @@ interface IInMeetingActions {
   canShareWhiteBoard?: boolean;
   enforceVirtualBackground?: boolean;
   canPollingAndQA?: boolean;
+  canStartWebcast?: boolean;
+  canStopWebcast?: boolean;
+  canShowStageView?: boolean;
+  canEnableStageView?: boolean;
+  canDisableStageView?: boolean;
 }
 
 /**
@@ -201,6 +211,14 @@ export default class InMeetingActions implements IInMeetingActions {
 
   canDisableViewTheParticipantsList = null;
 
+  canEnableViewTheParticipantsListPanelist = null;
+
+  canDisableViewTheParticipantsListPanelist = null;
+
+  canEnableShowAttendeeCount = null;
+
+  canDisableShowAttendeeCount = null;
+
   canEnableRaiseHand = null;
 
   canDisableRaiseHand = null;
@@ -238,6 +256,16 @@ export default class InMeetingActions implements IInMeetingActions {
   canShareWhiteBoard = null;
 
   canPollingAndQA = null;
+
+  canStartWebcast = null;
+
+  canStopWebcast = null;
+
+  canShowStageView = null;
+
+  canEnableStageView = null;
+
+  canDisableStageView = null;
   /**
    * Returns all meeting action options
    * @returns {Object}
@@ -298,6 +326,10 @@ export default class InMeetingActions implements IInMeetingActions {
     canUpdateShareControl: this.canUpdateShareControl,
     canEnableViewTheParticipantsList: this.canEnableViewTheParticipantsList,
     canDisableViewTheParticipantsList: this.canDisableViewTheParticipantsList,
+    canEnableViewTheParticipantsListPanelist: this.canEnableViewTheParticipantsListPanelist,
+    canDisableViewTheParticipantsListPanelist: this.canDisableViewTheParticipantsListPanelist,
+    canEnableShowAttendeeCount: this.canEnableShowAttendeeCount,
+    canDisableShowAttendeeCount: this.canDisableShowAttendeeCount,
     canEnableRaiseHand: this.canEnableRaiseHand,
     canDisableRaiseHand: this.canDisableRaiseHand,
     canEnableVideo: this.canEnableVideo,
@@ -317,6 +349,11 @@ export default class InMeetingActions implements IInMeetingActions {
     supportHDV: this.supportHDV,
     canShareWhiteBoard: this.canShareWhiteBoard,
     canPollingAndQA: this.canPollingAndQA,
+    canStartWebcast: this.canStartWebcast,
+    canStopWebcast: this.canStopWebcast,
+    canShowStageView: this.canShowStageView,
+    canEnableStageView: this.canEnableStageView,
+    canDisableStageView: this.canDisableStageView,
   });
 
   /**

package/src/meeting/index.ts

@@ -2014,6 +2014,7 @@ export default class Meeting extends StatelessWebexPlugin {
     this.setUpLocusInfoSelfListener();
     this.setUpLocusInfoMeetingListener();
     this.setUpLocusServicesListener();
+    this.setUpLocusResourcesListener();
     // members update listeners
     this.setUpLocusFullStateListener();
     this.setUpLocusUrlListener();
@@ -2635,6 +2636,42 @@ export default class Meeting extends StatelessWebexPlugin {
       );
     });
 
+    this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_WEBCAST_CHANGED, ({state}) => {
+      Trigger.trigger(
+        this,
+        {file: 'meeting/index', function: 'setupLocusControlsListener'},
+        EVENT_TRIGGERS.MEETING_CONTROLS_WEBCAST_UPDATED,
+        {state}
+      );
+    });
+
+    this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_MEETING_FULL_CHANGED, ({state}) => {
+      Trigger.trigger(
+        this,
+        {file: 'meeting/index', function: 'setupLocusControlsListener'},
+        EVENT_TRIGGERS.MEETING_CONTROLS_MEETING_FULL_UPDATED,
+        {state}
+      );
+    });
+
+    this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_PRACTICE_SESSION_STATUS_UPDATED, ({state}) => {
+      Trigger.trigger(
+        this,
+        {file: 'meeting/index', function: 'setupLocusControlsListener'},
+        EVENT_TRIGGERS.MEETING_CONTROLS_PRACTICE_SESSION_STATUS_UPDATED,
+        {state}
+      );
+    });
+
+    this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_STAGE_VIEW_UPDATED, ({state}) => {
+      Trigger.trigger(
+        this,
+        {file: 'meeting/index', function: 'setupLocusControlsListener'},
+        EVENT_TRIGGERS.MEETING_CONTROLS_STAGE_VIEW_UPDATED,
+        {state}
+      );
+    });
+
     this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_VIDEO_CHANGED, ({state}) => {
       Trigger.trigger(
         this,
@@ -2996,10 +3033,20 @@ export default class Meeting extends StatelessWebexPlugin {
       this.breakouts.breakoutServiceUrlUpdate(payload?.services?.breakout?.url);
       this.annotation.approvalUrlUpdate(payload?.services?.approval?.url);
       this.simultaneousInterpretation.approvalUrlUpdate(payload?.services?.approval?.url);
-      this.webinar.webcastUrlUpdate(payload?.services?.webcast?.url);
-      this.webinar.webinarAttendeesSearchingUrlUpdate(
-        payload?.services?.webinarAttendeesSearching?.url
-      );
+    });
+  }
+
+  /**
+   * Set up the locus info resources link listener
+   * update the locusInfo for webcast instance url
+   * @param {Object} payload - The event payload
+   * @returns {undefined}
+   * @private
+   * @memberof Meeting
+   */
+  private setUpLocusResourcesListener() {
+    this.locusInfo.on(LOCUSINFO.EVENTS.LINKS_RESOURCES, (payload) => {
+      this.webinar.updateWebcastUrl(payload);
     });
   }
 
@@ -3311,7 +3358,7 @@ export default class Meeting extends StatelessWebexPlugin {
       this.simultaneousInterpretation.updateCanManageInterpreters(
         payload.newRoles?.includes(SELF_ROLES.MODERATOR)
       );
-      this.webinar.updateCanManageWebcast(payload.newRoles?.includes(SELF_ROLES.MODERATOR));
+      this.webinar.updateRoleChanged(payload);
       Trigger.trigger(
         this,
         {
@@ -3805,6 +3852,22 @@ export default class Meeting extends StatelessWebexPlugin {
             requiredHints: [DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST],
             displayHints: this.userDisplayHints,
           }),
+          canEnableViewTheParticipantsListPanelist: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.ENABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST],
+            displayHints: this.userDisplayHints,
+          }),
+          canDisableViewTheParticipantsListPanelist: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.DISABLE_VIEW_THE_PARTICIPANT_LIST_PANELIST],
+            displayHints: this.userDisplayHints,
+          }),
+          canEnableShowAttendeeCount: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.ENABLE_SHOW_ATTENDEE_COUNT],
+            displayHints: this.userDisplayHints,
+          }),
+          canDisableShowAttendeeCount: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.DISABLE_SHOW_ATTENDEE_COUNT],
+            displayHints: this.userDisplayHints,
+          }),
           canEnableRaiseHand: ControlsOptionsUtil.hasHints({
             requiredHints: [DISPLAY_HINTS.ENABLE_RAISE_HAND],
             displayHints: this.userDisplayHints,
@@ -3821,6 +3884,26 @@ export default class Meeting extends StatelessWebexPlugin {
             requiredHints: [DISPLAY_HINTS.DISABLE_VIDEO],
             displayHints: this.userDisplayHints,
           }),
+          canStartWebcast: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.WEBCAST_CONTROL_START],
+            displayHints: this.userDisplayHints,
+          }),
+          canStopWebcast: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.WEBCAST_CONTROL_STOP],
+            displayHints: this.userDisplayHints,
+          }),
+          canShowStageView: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.STAGE_VIEW_ACTIVE],
+            displayHints: this.userDisplayHints,
+          }),
+          canEnableStageView: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.ENABLE_STAGE_VIEW],
+            displayHints: this.userDisplayHints,
+          }),
+          canDisableStageView: ControlsOptionsUtil.hasHints({
+            requiredHints: [DISPLAY_HINTS.DISABLE_STAGE_VIEW],
+            displayHints: this.userDisplayHints,
+          }),
           canShareFile:
             (ControlsOptionsUtil.hasHints({
               requiredHints: [DISPLAY_HINTS.SHARE_FILE],
@@ -4688,8 +4771,6 @@ export default class Meeting extends StatelessWebexPlugin {
       if (!joinResponse) {
         // This is the 1st attempt or a retry after join request failed -> we need to do a join with TURN discovery
 
-        // @ts-ignore
-        joinOptions.reachability = await this.webex.meetings.reachability.getReachabilityResults();
         const turnDiscoveryRequest = await this.roap.generateTurnDiscoveryRequestMessage(
           this,
           true
@@ -4821,6 +4902,8 @@ export default class Meeting extends StatelessWebexPlugin {
       );
     }
 
+    this.cleanUpBeforeReconnection();
+
     return this.reconnectionManager
       .reconnect(options, async () => {
         await this.waitForRemoteSDPAnswer();
@@ -6238,7 +6321,7 @@ export default class Meeting extends StatelessWebexPlugin {
     this.mediaProperties.webrtcMediaConnection.on(
       MediaConnectionEventNames.ICE_CANDIDATE,
       (event) => {
-        if (event.candidate) {
+        if (event.candidate && event.candidate.candidate && event.candidate.candidate.length > 0) {
           this.iceCandidatesCount += 1;
         }
       }
@@ -6949,6 +7032,23 @@ export default class Meeting extends StatelessWebexPlugin {
     }
   }
 
+  private async cleanUpBeforeReconnection(): Promise<void> {
+    try {
+      // when media fails, we want to upload a webrtc dump to see whats going on
+      // this function is async, but returns once the stats have been gathered
+      await this.forceSendStatsReport({callFrom: 'cleanUpBeforeReconnection'});
+
+      if (this.statsAnalyzer) {
+        await this.statsAnalyzer.stopAnalyzer();
+      }
+    } catch (error) {
+      LoggerProxy.logger.error(
+        'Meeting:index#cleanUpBeforeReconnection --> Error during cleanup: ',
+        error
+      );
+    }
+  }
+
   /**
    * Creates an instance of LocusMediaRequest for this meeting - it is needed for doing any calls
    * to Locus /media API (these are used for sending Roap messages and updating audio/video mute status).
@@ -7040,7 +7140,7 @@ export default class Meeting extends StatelessWebexPlugin {
       shareAudioEnabled = true,
       shareVideoEnabled = true,
       remoteMediaManagerConfig,
-      bundlePolicy,
+      bundlePolicy = 'max-bundle',
     } = options;
 
     this.allowMediaInLobby = options?.allowMediaInLobby;
@@ -7927,18 +8027,21 @@ export default class Meeting extends StatelessWebexPlugin {
    * @param {boolean} mutedEnabled
    * @param {boolean} disallowUnmuteEnabled
    * @param {boolean} muteOnEntryEnabled
+   * @param {array} roles
    * @public
    * @memberof Meeting
    */
   public setMuteAll(
     mutedEnabled: boolean,
     disallowUnmuteEnabled: boolean,
-    muteOnEntryEnabled: boolean
+    muteOnEntryEnabled: boolean,
+    roles: Array<string>
   ) {
     return this.controlsOptionsManager.setMuteAll(
       mutedEnabled,
       disallowUnmuteEnabled,
-      muteOnEntryEnabled
+      muteOnEntryEnabled,
+      roles
     );
   }
 

package/src/meeting/locusMediaRequest.ts

@@ -2,8 +2,9 @@
 import {defer} from 'lodash';
 import {Defer} from '@webex/common';
 import {WebexPlugin} from '@webex/webex-core';
-import {MEDIA, HTTP_VERBS, ROAP, IP_VERSION} from '../constants';
+import {MEDIA, HTTP_VERBS, ROAP} from '../constants';
 import LoggerProxy from '../common/logs/logger-proxy';
+import {ClientMediaPreferences} from '../reachability/reachability.types';
 
 export type MediaRequestType = 'RoapMessage' | 'LocalMute';
 export type RequestResult = any;
@@ -14,9 +15,8 @@ export type RoapRequest = {
   mediaId: string;
   roapMessage: any;
   reachability: any;
+  clientMediaPreferences: ClientMediaPreferences;
   sequence?: any;
-  joinCookie: any; // any, because this is opaque to the client, we pass whatever object we got from one backend component (Orpheus) to the other (Locus)
-  ipVersion?: IP_VERSION;
 };
 
 export type LocalMuteRequest = {
@@ -202,10 +202,6 @@ export class LocusMediaRequest extends WebexPlugin {
     const body: any = {
       device: this.config.device,
       correlationId: this.config.correlationId,
-      clientMediaPreferences: {
-        preferTranscoding: this.config.preferTranscoding,
-        ipver: request.type === 'RoapMessage' ? request.ipVersion : undefined,
-      },
     };
 
     const localMedias: any = {
@@ -223,7 +219,7 @@ export class LocusMediaRequest extends WebexPlugin {
       case 'RoapMessage':
         localMedias.roapMessage = request.roapMessage;
         localMedias.reachability = request.reachability;
-        body.clientMediaPreferences.joinCookie = request.joinCookie;
+        body.clientMediaPreferences = request.clientMediaPreferences;
 
         // @ts-ignore
         this.webex.internal.newMetrics.submitClientEvent({