@webex/plugin-meetings 3.0.0-bnr.5 → 3.0.0-stream-classes.1

package/src/config.ts

@@ -10,13 +10,7 @@ export default {
   meetings: {
     deviceType: deviceType.WEB,
     mediaSettings: {
-      sendAudio: true,
-      sendVideo: true,
-      receiveAudio: true,
-      receiveVideo: true,
       pstn: false,
-      sendShare: false,
-      receiveShare: false,
     },
     reconnection: {
       enabled: false,

package/src/constants.ts

@@ -4,7 +4,6 @@ import {hydraTypes} from '@webex/common';
 // *********** LOWERCASE / CAMELCASE STRINGS ************
 
 export const AUDIO = 'audio';
-export const AUDIO_INPUT = 'audioinput';
 export const AUDIO_STATUS = 'audioStatus';
 export const ALERT = 'alert';
 export const ALIAS = 'alias';
@@ -67,7 +66,6 @@ export const SHARE = 'share';
 export const TYPE = 'type';
 
 export const VIDEO = 'video';
-export const VIDEO_INPUT = 'videoinput';
 export const VIDEO_STATUS = 'videoStatus';
 
 // *********** UPPERCASE ONLY STRINGS ************
@@ -192,7 +190,7 @@ export const ICE_FAIL_TIMEOUT = 3000;
 
 export const RETRY_TIMEOUT = 3000;
 
-export const PC_BAIL_TIMEOUT = 8000;
+export const PC_BAIL_TIMEOUT = 15000;
 
 // ******************** REGEX **********************
 // Please alphabetize
@@ -283,6 +281,7 @@ export const EVENT_TRIGGERS = {
   MEETING_STOPPED_SHARING_LOCAL: 'meeting:stoppedSharingLocal',
   MEETING_STARTED_SHARING_REMOTE: 'meeting:startedSharingRemote',
   MEETING_STOPPED_SHARING_REMOTE: 'meeting:stoppedSharingRemote',
+  MEETING_UPDATE_ANNOTATION_INFO: 'meeting:updateAnnotationInfo',
   MEETING_STARTED_SHARING_WHITEBOARD: 'meeting:startedSharingWhiteboard',
   MEETING_STOPPED_SHARING_WHITEBOARD: 'meeting:stoppedSharingWhiteboard',
   MEETING_MEDIA_LOCAL_STARTED: 'meeting:media:local:start',
@@ -308,11 +307,19 @@ export const EVENT_TRIGGERS = {
   MEETING_SELF_PHONE_AUDIO_UPDATE: 'meeting:self:phoneAudioUpdate',
   MEETING_SELF_CANNOT_VIEW_PARTICIPANT_LIST: 'meeting:self:cannotViewParticipantList',
   MEETING_SELF_IS_SHARING_BLOCKED: 'meeting:self:isSharingBlocked',
+  MEETING_SELF_ROLES_CHANGED: 'meeting:self:rolesChanged',
   MEETING_CONTROLS_LAYOUT_UPDATE: 'meeting:layout:update',
   MEETING_ENTRY_EXIT_TONE_UPDATE: 'meeting:entryExitTone:update',
   MEETING_BREAKOUTS_UPDATE: 'meeting:breakouts:update',
   MEETING_BREAKOUTS_CLOSING: 'meeting:breakouts:closing',
   MEETING_BREAKOUTS_MESSAGE: 'meeting:breakouts:message',
+  MEETING_BREAKOUTS_ASK_RETURN_TO_MAIN: 'meeting:breakouts:askReturnToMain',
+  MEETING_BREAKOUTS_LEAVE: 'meeting:breakouts:leave',
+  MEETING_BREAKOUTS_ASK_FOR_HELP: 'meeting:breakouts:askForHelp',
+  MEETING_BREAKOUTS_PRE_ASSIGNMENTS_UPDATE: 'meeting:breakouts:preAssignmentsUpdate',
+  MEETING_INTERPRETATION_UPDATE: 'meeting:interpretation:update',
+  MEETING_INTERPRETATION_SUPPORT_LANGUAGES_UPDATE: 'meeting:interpretation:supportLanguagesUpdate',
+  MEETING_INTERPRETATION_HANDOFF_REQUESTS_ARRIVED: 'meeting:interpretation:handoffRequestsArrived',
   MEMBERS_UPDATE: 'members:update',
   MEMBERS_CLEAR: 'members:clear',
   MEMBERS_CONTENT_UPDATE: 'members:content:update',
@@ -343,17 +350,28 @@ export const EVENT_TRIGGERS = {
   REMOTE_MEDIA_AUDIO_CREATED: 'media:remoteAudio:created',
   REMOTE_MEDIA_SCREEN_SHARE_AUDIO_CREATED: 'media:remoteScreenShareAudio:created',
   REMOTE_MEDIA_VIDEO_LAYOUT_CHANGED: 'media:remoteVideo:layoutChanged',
+  // Controls
+  MEETING_CONTROLS_MUTE_ON_ENTRY_UPDATED: 'meeting:controls:mute-on-entry:updated',
+  MEETING_CONTROLS_SHARE_CONTROL_UPDATED: 'meeting:controls:share-control:updated',
+  MEETING_CONTROLS_DISALLOW_UNMUTE_UPDATED: 'meeting:controls:disallow-unmute:updated',
+  MEETING_CONTROLS_REACTIONS_UPDATED: 'meeting:controls:reactions:updated',
+  MEETING_CONTROLS_VIEW_THE_PARTICIPANTS_LIST_UPDATED:
+    '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',
+  // Locus URL changed
+  MEETING_LOCUS_URL_UPDATE: 'meeting:locus:locusUrl:update',
+  MEETING_STREAM_PUBLISH_STATE_CHANGED: 'meeting:streamPublishStateChanged',
 };
 
 export const EVENT_TYPES = {
   SELF: 'self',
   OTHER: 'other',
-  LOCAL: 'local',
   REMOTE: 'remote',
   REMOTE_AUDIO: 'remoteAudio',
   REMOTE_VIDEO: 'remoteVideo',
   REMOTE_SHARE: 'remoteShare',
-  LOCAL_SHARE: 'localShare',
+  REMOTE_SHARE_AUDIO: 'remoteShareAudio',
   ERROR: 'error',
 };
 
@@ -366,6 +384,7 @@ export const MEETING_REMOVED_REASON = {
   FULLSTATE_REMOVED: 'FULLSTATE_REMOVED', // meeting got dropped ? not sure
   MEETING_INACTIVE_TERMINATING: 'MEETING_INACTIVE_TERMINATING', // Meeting got ended or everyone left the meeting
   CLIENT_LEAVE_REQUEST: 'CLIENT_LEAVE_REQUEST', // You triggered leave meeting
+  CLIENT_LEAVE_REQUEST_TAB_CLOSED: 'CLIENT_LEAVE_REQUEST_TAB_CLOSED', // You triggered leave meeting, such as closing the browser tab directly
   USER_ENDED_SHARE_STREAMS: 'USER_ENDED_SHARE_STREAMS', // user triggered stop share
   NO_MEETINGS_TO_SYNC: 'NO_MEETINGS_TO_SYNC', // After the syncMeeting no meeting exists
   MEETING_CONNECTION_FAILED: 'MEETING_CONNECTION_FAILED', // meeting failed to connect due to ice failures or firewall issue
@@ -384,6 +403,7 @@ export const SHARE_STOPPED_REASON = {
   SELF_STOPPED: 'SELF_STOPPED',
   MEETING_REJOIN: 'MEETING_REJOIN',
   MEDIA_RECONNECTION: 'MEDIA_RECONNECTION',
+  TRACK_ENDED: 'TRACK_ENDED',
 };
 
 export const EVENTS = {
@@ -531,6 +551,9 @@ export const LOCUS = {
   SYNCDEBUG: 'sync_debug',
 };
 
+export const ANNOTATION = {
+  ANNOTATION_ON_SHARE_SUPPORTED: 'ANNOTATION_ON_SHARE_SUPPORTED',
+};
 export const BREAKOUTS = {
   STATUS: {
     CLOSING: 'CLOSING',
@@ -542,6 +565,10 @@ export const BREAKOUTS = {
     BREAKOUTS_CLOSING: 'BREAKOUTS_CLOSING',
     MESSAGE: 'MESSAGE',
     MEMBERS_UPDATE: 'MEMBERS_UPDATE',
+    ASK_RETURN_TO_MAIN: 'ASK_RETURN_TO_MAIN',
+    LEAVE_BREAKOUT: 'LEAVE_BREAKOUT',
+    ASK_FOR_HELP: 'ASK_FOR_HELP',
+    PRE_ASSIGNMENTS_UPDATE: 'PRE_ASSIGNMENTS_UPDATE',
   },
   SESSION_TYPES: {
     MAIN: 'MAIN',
@@ -564,7 +591,6 @@ export const BREAKOUTS = {
     EDIT_LOCK_TOKEN_MISMATCH: 201409024,
     EDIT_NOT_AUTHORIZED: 201403007,
   },
-  DEFAULT_DURATION: 60000,
   EDIT_LOCK_STATUS: {
     LOCKED: 'LOCKED',
     NOT_LOCKED: 'NOT_LOCKED',
@@ -573,6 +599,20 @@ export const BREAKOUTS = {
   DEFAULT_TTL: 30,
 };
 
+export const INTERPRETATION = {
+  EVENTS: {
+    SUPPORT_LANGUAGES_UPDATE: 'SUPPORT_LANGUAGES_UPDATE',
+    HANDOFF_REQUESTS_ARRIVED: 'HANDOFF_REQUESTS_ARRIVED',
+  },
+  ACTION_TYPE: {
+    OFFERED: 'OFFERED',
+    ACCEPTED: 'ACCEPTED',
+    REQUESTED: 'REQUESTED',
+    DECLINED: 'DECLINED',
+  },
+  RESOURCE_TYPE: 'SiHandover',
+};
+
 export const LOCUSINFO = {
   EVENTS: {
     CONTROLS_MEETING_LAYOUT_UPDATED: 'CONTROLS_MEETING_LAYOUT_UPDATED',
@@ -580,7 +620,16 @@ export const LOCUSINFO = {
     CONTROLS_MEETING_TRANSCRIBE_UPDATED: 'CONTROLS_MEETING_TRANSCRIBE_UPDATED',
     CONTROLS_MEETING_BREAKOUT_UPDATED: 'CONTROLS_MEETING_BREAKOUT_UPDATED',
     CONTROLS_MEETING_CONTAINER_UPDATED: 'CONTROLS_MEETING_CONTAINER_UPDATED',
+    CONTROLS_MEETING_INTERPRETATION_UPDATED: 'CONTROLS_MEETING_INTERPRETATION_UPDATED',
     CONTROLS_ENTRY_EXIT_TONE_UPDATED: 'CONTROLS_ENTRY_EXIT_TONE_UPDATED',
+    CONTROLS_JOIN_BREAKOUT_FROM_MAIN: 'CONTROLS_JOIN_BREAKOUT_FROM_MAIN',
+    CONTROLS_MUTE_ON_ENTRY_CHANGED: 'CONTROLS_MUTE_ON_ENTRY_CHANGED',
+    CONTROLS_SHARE_CONTROL_CHANGED: 'CONTROLS_SHARE_CONTROL_CHANGED',
+    CONTROLS_DISALLOW_UNMUTE_CHANGED: 'CONTROLS_DISALLOW_UNMUTE_CHANGED',
+    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_VIDEO_CHANGED: 'CONTROLS_VIDEO_CHANGED',
     SELF_UNADMITTED_GUEST: 'SELF_UNADMITTED_GUEST',
     SELF_ADMITTED_GUEST: 'SELF_ADMITTED_GUEST',
     SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED: 'SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED',
@@ -588,6 +637,7 @@ export const LOCUSINFO = {
     LOCAL_UNMUTE_REQUESTED: 'LOCAL_UNMUTE_REQUESTED',
     LOCAL_UNMUTE_REQUIRED: 'LOCAL_UNMUTE_REQUIRED',
     SELF_MODERATOR_CHANGED: 'SELF_MODERATOR_CHANGED',
+    SELF_ROLES_CHANGED: 'SELF_ROLES_CHANGED',
     MEETING_UPDATE: 'MEETING_UPDATE',
     MEDIA_STATUS_CHANGE: 'MEDIA_STATUS_CHANGE',
     FULL_STATE_TYPE_UPDATE: 'FULL_STATE_TYPE_UPDATE',
@@ -602,9 +652,9 @@ export const LOCUSINFO = {
     SELF_CANNOT_VIEW_PARTICIPANT_LIST_CHANGE: 'SELF_CANNOT_VIEW_PARTICIPANT_LIST_CHANGE',
     SELF_IS_SHARING_BLOCKED_CHANGE: 'SELF_IS_SHARING_BLOCKED_CHANGE',
     SELF_MEETING_BREAKOUTS_CHANGED: 'SELF_MEETING_BREAKOUTS_CHANGED',
+    SELF_MEETING_INTERPRETATION_CHANGED: 'SELF_MEETING_INTERPRETATION_CHANGED',
     MEDIA_INACTIVITY: 'MEDIA_INACTIVITY',
     LINKS_SERVICES: 'LINKS_SERVICES',
-    SELF_MODERATOR_OR_COHOST_UPGRADE: 'SELF_MODERATOR_OR_COHOST_UPGRADE',
   },
 };
 
@@ -767,6 +817,28 @@ export const MEETING_END_REASON = {
   MEDIA_RELEASED: 'MEDIA_RELEASED',
 };
 
+export enum SELF_POLICY {
+  ENFORCE_VIRTUAL_BACKGROUND = 'enforceVirtualBackground',
+  SUPPORT_LOCAL_RECORD = 'supportLocalRecord',
+  SUPPORT_NETWORK_BASED_RECORD = 'supportNetworkBasedRecord',
+  SUPPORT_REALTIME_CLOSE_CAPTION = 'supportRealtimeCloseCaption',
+  SUPPORT_CHAT = 'supportChat',
+  SUPPORT_DESKTOP_SHARE_REMOTE = 'supportDesktopShareRemote',
+  SUPPORT_DESKTOP_SHARE = 'supportDesktopShare',
+  SUPPORT_WHITEBOARD = 'supportWhiteboard',
+  SUPPORT_FILE_TRANSFER = 'supportFileTransfer',
+  SUPPORT_APP_SHARE = 'supportAppShare',
+  SUPPORT_CAMERA_SHARE = 'supportCameraShare',
+  SUPPORT_FILE_SHARE = 'supportFileShare',
+  SUPPORT_ANNOTATION = 'supportAnnotation',
+  SUPPORT_BROADCAST_MESSAGE = 'supportBroadcastMessage',
+  SUPPORT_VIDEO = 'supportVideo',
+  SUPPORT_HQV = 'supportHQV',
+  SUPPORT_HDV = 'supportHDV',
+  SUPPORT_PARTICIPANT_LIST = 'supportParticipantList',
+  SUPPORT_VOIP = 'supportVoIP',
+}
+
 export const DISPLAY_HINTS = {
   ADD_GUEST: 'ADD_GUEST',
   ROSTER_WAITING_TO_JOIN: 'ROSTER_WAITING_TO_JOIN',
@@ -812,6 +884,7 @@ export const DISPLAY_HINTS = {
 
   // breakout session
   BREAKOUT_MANAGEMENT: 'BREAKOUT_MANAGEMENT',
+  BROADCAST_MESSAGE_TO_BREAKOUT: 'BROADCAST_MESSAGE_TO_BREAKOUT',
   UCF_SUPPRESS_BREAKOUTS_SUPPORT: 'UCF_SUPPRESS_BREAKOUTS_SUPPORT',
   DISABLE_ASK_FOR_HELP: 'DISABLE_ASK_FOR_HELP',
   DISABLE_BREAKOUT_PREASSIGNMENTS: 'DISABLE_BREAKOUT_PREASSIGNMENTS',
@@ -820,8 +893,29 @@ 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',
+
+  // raise hand
+  DISABLE_RAISE_HAND: 'DISABLE_RAISE_HAND',
+  ENABLE_RAISE_HAND: 'ENABLE_RAISE_HAND',
+
+  // video
+  DISABLE_VIDEO: 'DISABLE_VIDEO',
+  ENABLE_VIDEO: 'ENABLE_VIDEO',
+
+  // Sharing
+  SHARE_FILE: 'SHARE_FILE',
+  SHARE_APPLICATION: 'SHARE_APPLICATION',
+  SHARE_CAMERA: 'SHARE_CAMERA',
+  SHARE_DESKTOP: 'SHARE_DESKTOP',
+  SHARE_CONTENT: 'SHARE_CONTENT',
+  SHARE_WHITEBOARD: 'SHARE_WHITEBOARD',
+
+  // Voip (audio/video)
+  VOIP_IS_ENABLED: 'VOIP_IS_ENABLED',
 };
 
+export const INTERSTITIAL_DISPLAY_HINTS = [DISPLAY_HINTS.VOIP_IS_ENABLED];
+
 export const SELF_ROLES = {
   COHOST: 'COHOST',
   MODERATOR: 'MODERATOR',
@@ -1092,16 +1186,6 @@ export const AVAILABLE_RESOLUTIONS = {
   },
 };
 
-export const VIDEO_RESOLUTIONS = {
-  [QUALITY_LEVELS.LOW]: AVAILABLE_RESOLUTIONS['480p'],
-  [QUALITY_LEVELS.MEDIUM]: AVAILABLE_RESOLUTIONS['720p'],
-  [QUALITY_LEVELS.HIGH]: AVAILABLE_RESOLUTIONS['1080p'],
-  [QUALITY_LEVELS['360p']]: AVAILABLE_RESOLUTIONS['360p'],
-  [QUALITY_LEVELS['480p']]: AVAILABLE_RESOLUTIONS['480p'],
-  [QUALITY_LEVELS['720p']]: AVAILABLE_RESOLUTIONS['720p'],
-  [QUALITY_LEVELS['1080p']]: AVAILABLE_RESOLUTIONS['1080p'],
-};
-
 /*
  *  mqa Interval for sending stats metrics
  */
@@ -1114,8 +1198,6 @@ export const MEDIA_DEVICES = {
   CAMERA: 'camera',
 };
 
-export const METRICS_JOIN_TIMES_MAX_DURATION = 1200000;
-
 export const PSTN_STATUS = {
   JOINED: 'JOINED', // we have provisioned a pstn device, which can be used to connect
   CONNECTED: 'CONNECTED', // user is connected to audio with pstn device
@@ -1156,3 +1238,13 @@ export const DEFAULT_MEETING_INFO_REQUEST_BODY = {
   supportHostKey: true,
   supportCountryList: true,
 };
+
+/** the values for IP_VERSION are fixed and defined in Orpheus API */
+export const IP_VERSION = {
+  unknown: 0,
+  only_ipv4: 4,
+  only_ipv6: 6,
+  ipv4_and_ipv6: 1,
+} as const;
+
+export type IP_VERSION = (typeof IP_VERSION)[keyof typeof IP_VERSION];

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

@@ -6,8 +6,10 @@ enum Setting {
 
 enum Control {
   audio = 'audio',
+  raiseHand = 'raiseHand',
   reactions = 'reactions',
   shareControl = 'shareControl',
+  video = 'video',
   viewTheParticipantList = 'viewTheParticipantList',
 }
 

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

@@ -140,8 +140,8 @@ export default class ControlsOptionsManager {
    * @param {Array<ControlConfig>} controls - Spread Array of ControlConfigs
    * @returns {Promise<Array<any>>}- Promise resolving if the request was successful.
    */
-  protected update(...controls: Array<ControlConfig>) {
-    const payload = controls.reduce((output, control) => {
+  public update(...controls: Array<ControlConfig>) {
+    const payloads = controls.map((control) => {
       if (!Object.keys(Control).includes(control.scope)) {
         throw new Error(
           `updating meeting control scope "${control.scope}" is not a supported scope`
@@ -155,17 +155,20 @@ export default class ControlsOptionsManager {
       }
 
       return {
-        ...output,
         [control.scope]: control.properties,
       };
-    }, {});
-
-    // @ts-ignore
-    return this.request.request({
-      uri: `${this.locusUrl}/${CONTROLS}`,
-      body: payload,
-      method: HTTP_VERBS.PATCH,
     });
+
+    return payloads.reduce((previous, payload) => {
+      return previous.then(() =>
+        // @ts-ignore
+        this.request.request({
+          uri: `${this.locusUrl}/${CONTROLS}`,
+          body: payload,
+          method: HTTP_VERBS.PATCH,
+        })
+      );
+    }, Promise.resolve());
   }
 
   /**

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

@@ -17,6 +17,10 @@ export interface AudioProperties {
   muteOnEntry?: boolean;
 }
 
+export interface RaiseHandProperties {
+  enabled?: boolean;
+}
+
 export interface ReactionsProperties {
   enabled?: boolean;
   showDisplayNameWithReactions?: boolean;
@@ -26,14 +30,20 @@ export interface ShareControlProperties {
   control?: 'ANYONE' | 'MODERATOR_PRESENTER';
 }
 
+export interface VideoProperties {
+  enabled?: boolean;
+}
+
 export interface ViewTheParticipantListProperties {
   enabled?: boolean;
 }
 
 export type Properties =
   | AudioProperties
+  | RaiseHandProperties
   | ReactionsProperties
   | ShareControlProperties
+  | VideoProperties
   | ViewTheParticipantListProperties;
 
 export interface ControlConfig<Props = Properties> {

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

@@ -3,8 +3,10 @@ import {Control} from './enums';
 import {
   ControlConfig,
   AudioProperties,
+  RaiseHandProperties,
   ReactionsProperties,
   ViewTheParticipantListProperties,
+  VideoProperties,
 } from './types';
 
 /**
@@ -87,6 +89,20 @@ class Utils {
     return requiredHints.every((hint) => displayHints.includes(hint));
   }
 
+  /**
+   * Validate that the self policy object contains the required policies.
+   *
+   * @param {Object} config - Configuration Object.
+   * @param {Array<string>} config.requiredPolicies - Policies required for validation.
+   * @param {Array<string>} config.policies - All available policies.
+   * @returns {boolean} - True if all of the actions are allowed.
+   */
+  public static hasPolicies(config: {requiredPolicies: Array<string>; policies: Array<string>}) {
+    const {requiredPolicies, policies = {}} = config;
+
+    return requiredPolicies.every((hint) => policies[hint]);
+  }
+
   /**
    * Validate if an audio-scoped control is allowed to be sent to the service.
    *
@@ -122,6 +138,22 @@ class Utils {
     return Utils.hasHints({requiredHints, displayHints});
   }
 
+  public static canUpdateRaiseHand(
+    control: ControlConfig<RaiseHandProperties>,
+    displayHints: Array<string>
+  ) {
+    const requiredHints = [];
+
+    if (control.properties.enabled === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_RAISE_HAND);
+    }
+    if (control.properties.enabled === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_RAISE_HAND);
+    }
+
+    return Utils.hasHints({requiredHints, displayHints});
+  }
+
   /**
    * Validate if an reactions-scoped control is allowed to be sent to the service.
    *
@@ -135,17 +167,22 @@ class Utils {
   ) {
     const requiredHints = [];
 
-    if (control.properties.enabled === true) {
-      requiredHints.push(DISPLAY_HINTS.ENABLE_REACTIONS);
-    }
-    if (control.properties.enabled === false) {
-      requiredHints.push(DISPLAY_HINTS.DISABLE_REACTIONS);
-    }
-    if (control.properties.showDisplayNameWithReactions === true) {
-      requiredHints.push(DISPLAY_HINTS.ENABLE_SHOW_DISPLAY_NAME);
-    }
-    if (control.properties.showDisplayNameWithReactions === false) {
-      requiredHints.push(DISPLAY_HINTS.DISABLE_SHOW_DISPLAY_NAME);
+    // This additional if statement avoids the display hint discrepency due to
+    // the service blocking partial requests with this property only.
+    if (control.properties.showDisplayNameWithReactions !== undefined) {
+      if (control.properties.showDisplayNameWithReactions === true) {
+        requiredHints.push(DISPLAY_HINTS.ENABLE_SHOW_DISPLAY_NAME);
+      }
+      if (control.properties.showDisplayNameWithReactions === false) {
+        requiredHints.push(DISPLAY_HINTS.DISABLE_SHOW_DISPLAY_NAME);
+      }
+    } else {
+      if (control.properties.enabled === true) {
+        requiredHints.push(DISPLAY_HINTS.ENABLE_REACTIONS);
+      }
+      if (control.properties.enabled === false) {
+        requiredHints.push(DISPLAY_HINTS.DISABLE_REACTIONS);
+      }
     }
 
     return Utils.hasHints({requiredHints, displayHints});
@@ -184,6 +221,29 @@ class Utils {
     return Utils.hasHints({requiredHints, displayHints});
   }
 
+  /**
+   * Validate if a video-scoped control is allowed to be sent to the service.
+   *
+   * @param {ControlConfig<VideoProperties>} control - Video control config to validate.
+   * @param {Array<string>} displayHints - All available hints.
+   * @returns {boolean} - True if all of the actions are allowed.
+   */
+  public static canUpdateVideo(
+    control: ControlConfig<VideoProperties>,
+    displayHints: Array<string>
+  ) {
+    const requiredHints = [];
+
+    if (control.properties.enabled === true) {
+      requiredHints.push(DISPLAY_HINTS.ENABLE_VIDEO);
+    }
+    if (control.properties.enabled === false) {
+      requiredHints.push(DISPLAY_HINTS.DISABLE_VIDEO);
+    }
+
+    return Utils.hasHints({requiredHints, displayHints});
+  }
+
   /**
    * Validate that a control can be sent to the service based on the provided
    * display hints.
@@ -200,6 +260,13 @@ class Utils {
         determinant = Utils.canUpdateAudio(control as ControlConfig<AudioProperties>, displayHints);
         break;
 
+      case Control.raiseHand:
+        determinant = Utils.canUpdateRaiseHand(
+          control as ControlConfig<RaiseHandProperties>,
+          displayHints
+        );
+        break;
+
       case Control.reactions:
         determinant = Utils.canUpdateReactions(
           control as ControlConfig<ReactionsProperties>,
@@ -211,6 +278,10 @@ class Utils {
         determinant = Utils.canUpdateShareControl(displayHints);
         break;
 
+      case Control.video:
+        determinant = Utils.canUpdateVideo(control as ControlConfig<VideoProperties>, displayHints);
+        break;
+
       case Control.viewTheParticipantList:
         determinant = Utils.canUpdateViewTheParticipantsList(
           control as ControlConfig<ViewTheParticipantListProperties>,

package/src/index.ts

@@ -9,18 +9,25 @@ registerPlugin('meetings', Meetings, {
 });
 
 export {
-  LocalTrack,
-  LocalDisplayTrack,
-  LocalTrackEvents,
-  type TrackMuteEvent,
+  getDevices,
+  LocalStream,
+  LocalDisplayStream,
+  LocalSystemAudioStream,
+  LocalStreamEventNames,
+  StreamEventNames,
   type ServerMuteReason,
-  LocalMicrophoneTrackEvents,
-  LocalCameraTrackEvents,
-  LocalMicrophoneTrack,
-  LocalCameraTrack,
-  createMicrophoneTrack,
-  createCameraTrack,
-  createDisplayTrack,
+  LocalMicrophoneStreamEventNames,
+  LocalCameraStreamEventNames,
+  LocalMicrophoneStream,
+  LocalCameraStream,
+  createMicrophoneStream,
+  createCameraStream,
+  createDisplayStream,
+  createDisplayStreamWithAudio,
+  FacingMode,
+  DisplaySurface,
+  PresetCameraConstraints,
+  type VideoContentHint,
 } from '@webex/media-helpers';
 
 export default Meetings;

package/src/interpretation/README.md

@@ -0,0 +1,60 @@
+# Simultaneous Interpretation
+
+Simultaneous Interpretation (SI) feature provides support for interpretation of in-meeting audio. The host will specify the target languages at schedule time and assign language pairs to the desired interpreters. Each interpreter will use their client to indicate the language spoken at any point in time. For example, Alice might be translating between English and French. When an English speaker is talking in the meeting, Alice will use her client to indicate she is speaking French. When a French speaker is talking, Alice will indicate that she is speaking English. The host’s client will display the status of each interpreter including the current interpretation direction.
+
+### Structure
+SI languages are available in the siLanguages collection. List the languages which current meeting support to do simultaneous interpretation. Can subscribe the language's voice channel which you want to listen from the list.
+
+```javascript
+interpretation.siLanguages;
+```
+### Attendee functionality
+```javascript
+//subscribe this si language's voice channel
+siLanguage.subscribe();
+
+//unsubscribe this si language's voice channel
+siLanguage.unsubscribe();
+```
+### Host functionality
+The following are methods available to the host of a meeting.
+
+```javascript
+//get the support list of interpretation languages. only host is allowed to call it
+interpretation.getSupportLanguages();
+
+//get the interpreters list of the meeting
+interpretation.getInterpreters();
+
+//update the interpreters list, input parameter is an array of interpreters
+interpretation.updateInterpreters([{
+  sourceLanguage : 'fr-FR',
+  targetLanguage : 'zh-ZH',
+  usingResource : {
+    id : 'a96747e2-1fc6-41d3-9ac7-512dd9478b6e'
+  },
+  order : 0
+},]);
+```
+
+### Interpreter functionality
+
+The following are methods available to the interpreters of a meeting.
+
+```javascript
+//Change direction of interpretation for an interpreter participant
+interpretation.changeDirection();
+
+//Handoff between interpreters, input paramerter participantId is the target to handoff
+interpretation.handoffInterpreter(participantId);
+
+//in-active interpreter request to handoff to self
+interpretation.requestHandoff();
+
+//accept the request of handoff, input paramter url is from last approval event which generate by server side
+interpretation.acceptRequest(url);
+
+//decline the request of handoff, input paramter url is from last approval event which generate by server side
+interpretation.declineRequest(url);
+
+```

package/src/interpretation/collection.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright (c) 2015-2023 Cisco Systems, Inc. See LICENSE file.
+ */
+
+import AmpCollection from 'ampersand-collection';
+
+import {MEETINGS} from '../constants';
+
+import SILanguage from './siLanguage';
+
+const SILanguageCollection = AmpCollection.extend({
+  model: SILanguage,
+
+  namespace: MEETINGS,
+
+  mainIndex: 'languageName',
+});
+
+export default SILanguageCollection;