@webex/plugin-meetings 3.0.0-beta.4 → 3.0.0-beta.400

package/src/common/logs/logger-proxy.js

@@ -1,33 +0,0 @@
-/* eslint-disable no-unused-vars */
-import LoggerConfig from './logger-config';
-
-const LoggerProxy = {
-  logger: {
-    info: (args) => { console.error('LoggerProxy->info#NO LOGGER DEFINED'); },
-    log: (args) => { console.error('LoggerProxy->log#NO LOGGER DEFINED'); },
-    error: (args) => { console.error('LoggerProxy->error#NO LOGGER DEFINED'); },
-    warn: (args) => { console.error('LoggerProxy->warn#NO LOGGER DEFINED'); },
-    trace: (args) => { console.error('LoggerProxy->trace#NO LOGGER DEFINED'); },
-    debug: (args) => { console.error('LoggerProxy->debug#NO LOGGER DEFINED'); }
-  }
-};
-
-LoggerProxy.set = (logger) => {
-  if (!LoggerConfig.enable) {
-    LoggerProxy.logger = {
-      info: () => {},
-      log: () => {},
-      error: () => {},
-      warn: () => {},
-      trace: () => {},
-      debug: () => {}
-    };
-  }
-  else {
-    LoggerProxy.logger = logger;
-  }
-};
-
-LoggerProxy.get = () => LoggerProxy.logger;
-
-export default LoggerProxy;

package/src/index.js

@@ -1,15 +0,0 @@
-/* eslint-env browser */
-import {registerPlugin} from '@webex/webex-core';
-
-import Meetings from './meetings';
-import config from './config';
-
-registerPlugin('meetings', Meetings, {
-  config
-});
-
-export default Meetings;
-
-export * as CONSTANTS from './constants';
-
-export {default as TriggerProxy} from './common/events/trigger-proxy';

package/src/locus-info/controlsUtils.js

@@ -1,102 +0,0 @@
-import {isEqual} from 'lodash';
-
-const ControlsUtils = {};
-
-/**
- * Controls
- * @typedef {Object} LocusControls
- * @property {Object} record
- * @property {Boolean} record.recording
- * @property {Object} record.meta
- * @property {String} record.meta.modifiedBy
- */
-
-/**
- * parse the relevant host values that we care about: id
- * @param {LocusControls} controls
- * @returns {Object} parsedObject - parsed host or null if host was undefined
- * @returns {String} parsedObject.recordingId
- */
-ControlsUtils.parse = (controls) => {
-  const parsedControls = {...controls};
-
-  if (controls && controls.record) {
-    parsedControls.record = {
-      modifiedBy: ControlsUtils.getId(controls),
-      paused: controls.record.paused ? controls.record.paused : false,
-      recording: controls.record.recording,
-      lastModified: controls.record.meta.lastModified
-    };
-  }
-
-  if (controls && controls.meetingContainer) {
-    parsedControls.meetingContainer = {
-      meetingContainerUrl: controls.meetingContainer.meetingContainerUrl
-    };
-  }
-
-  if (controls && controls.transcribe) {
-    parsedControls.transcribe = {
-      transcribing: controls.transcribe.transcribing,
-      caption: controls.transcribe.caption
-    };
-  }
-
-  if (controls && controls.entryExitTone) {
-    parsedControls.entryExitTone = controls.entryExitTone.enabled ? controls.entryExitTone.mode : null;
-  }
-
-  return parsedControls;
-};
-
-/**
- * parses and returns previous state vs current state and triggers the changes.
- * @param {LocusControls} oldControls previous state
- * @param {LocusControls} newControls current state
- * @returns {Object} combination of state plus the changes
- */
-ControlsUtils.getControls = (oldControls, newControls) => {
-  const previous = ControlsUtils.parse(oldControls);
-  const current = ControlsUtils.parse(newControls);
-
-  return {
-    previous,
-    current,
-    updates: {
-      hasRecordingPausedChanged: current?.record &&
-      !isEqual(previous?.record?.paused, current.record.paused) &&
-      (previous?.record?.recording || current?.record?.recording), // see comments directly below
-
-      hasRecordingChanged: current?.record &&
-      !isEqual(previous?.record?.recording, current?.record?.recording) && // upon first join, previous?.record?.recording = undefined; thus, never going to be equal and will always return true
-      (previous?.record?.recording || current?.record?.recording), // therefore, condition added to prevent false firings of #meeting:recording:stopped upon first joining a meeting
-
-      hasMeetingContainerChanged: current?.meetingContainer &&
-        !isEqual(previous?.meetingContainer?.meetingContainerUrl,
-          current?.meetingContainer?.meetingContainerUrl),
-
-      hasTranscribeChanged: current?.transcribe &&
-          !isEqual(previous?.transcribe?.transcribing, current?.transcribe?.transcribing) && // upon first join, previous?.record?.recording = undefined; thus, never going to be equal and will always return true
-          (previous?.transcribe?.transcribing || current?.transcribe?.transcribing), // therefore, condition added to prevent false firings of #meeting:recording:stopped upon first joining a meeting
-
-      hasEntryExitToneChanged: !!(newControls.entryExitTone &&
-          !isEqual(previous?.entryExitTone, current?.entryExitTone) &&
-          (previous?.entryExitTone || current?.entryExitTone)),
-    }
-  };
-};
-
-/**
- * Extract the id from the record controls object
- * @param {LocusControls} controls
- * @returns {String|null}
- */
-ControlsUtils.getId = (controls) => {
-  if (controls.record.meta) {
-    return controls.record.meta.modifiedBy;
-  }
-
-  return null;
-};
-
-export default ControlsUtils;

package/src/media/index.js

@@ -1,459 +0,0 @@
-/*!
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
- */
-/* globals navigator */
-
-import LoggerProxy from '../common/logs/logger-proxy';
-import {
-  AUDIO_INPUT,
-  VIDEO_INPUT,
-  MEDIA_TRACK_CONSTRAINT,
-} from '../constants';
-import Config from '../config';
-import StaticConfig from '../common/config';
-import MediaError from '../common/errors/media';
-import BrowserDetection from '../common/browser-detection';
-
-import {RoapMediaConnection, MultistreamRoapMediaConnection} from './internal-media-core-wrapper';
-
-const {isBrowser} = BrowserDetection();
-
-/**
- * MediaDirection
- * @typedef {Object} MediaDirection
- * @property {boolean} sendAudio
- * @property {boolean} receiveAudio
- * @property {boolean} sendVideo
- * @property {boolean} receiveVideo
- * @property {boolean} sendShare
- * @property {boolean} receiveShare
- */
-
-/**
- * SendOptions
- * @typedef {Object} SendOptions
- * @property sendAudio
- * @property sendVideo
- * @property sendShare
- * @property isSharing
- * @property {Object} sharePreferences
- */
-/**
- *
- * @public
- * @export
- * Mimic browser APIs as "the ultimate browser".
- * Handles the quirks of each browser.
- * Extends and enhances adapter.js, i.e., the "media" file from the web client.
- */
-const Media = {};
-
-/**
- * @param {boolean} enabled
- * @param {MediaStreamTrack} track
- * @returns {Boolean}
- * @public
- */
-Media.setLocalTrack = (enabled, track) => {
-  if (track) {
-    track.enabled = enabled;
-
-    return true;
-  }
-
-  return false;
-};
-
-/**
- * format the media array for send
- * @param {String} mediaId
- * @param {Boolean} audioMuted
- * @param {Boolean} videoMuted
- * @returns {Array} medias
- */
-Media.generateLocalMedias = (mediaId, audioMuted, videoMuted) => {
-  if (mediaId) {
-    return [
-      {
-        localSdp: JSON.stringify({
-          audioMuted,
-          videoMuted
-        }),
-        mediaId
-      }
-    ];
-  }
-
-  return [];
-};
-
-/**
- * make a browser call to get the media
- * @param {SendOptions} options
- * @param {Object} config SDK Configuration for meetings plugin
- * @returns {Promise}
- */
-Media.getLocalMedia = (options, config) => {
-  const {
-    sendAudio, sendVideo, sendShare, sharePreferences, isSharing
-  } = options;
-
-  if (sendAudio || sendVideo) {
-    return Media.getMedia(sendAudio, sendVideo, config);
-  }
-
-  if (sendShare && !isSharing) {
-    return Media.getDisplayMedia(
-      {
-        sendAudio: false,
-        sendShare: true,
-        sharePreferences
-      },
-      config
-    );
-  }
-
-  return Promise.resolve(undefined);
-};
-
-/**
- * creates a webrtc media connection with provided tracks and mediaDirection configuration
- * @param {Object} mediaProperties only applicable to non-multistream connections, contains mediaDirection and local tracks:
- *                                 audioTrack, videoTrack and shareTrack
- * @param {Object} options
- * @param {boolean} options.isMultistream
- * @param {string} [options.remoteQualityLevel] LOW|MEDIUM|HIGH applicable only to non-multistream connections
- * @param {boolean} [options.enableRtx] applicable only to non-multistream connections
- * @param {boolean} [options.enableExtmap] applicable only to non-multistream connections
- * @param {Object} [options.turnServerInfo]
- * @returns {RoapMediaConnection}
- */
-Media.createMediaConnection = (mediaProperties, {
-  isMultistream,
-  remoteQualityLevel,
-  enableRtx,
-  enableExtmap,
-  turnServerInfo
-}) => {
-  const {
-    mediaDirection,
-    audioTrack,
-    videoTrack,
-    shareTrack
-  } = mediaProperties;
-
-  const iceServers = [];
-
-  if (turnServerInfo) {
-    iceServers.push({
-      urls: turnServerInfo.url,
-      username: turnServerInfo.username || '',
-      credential: turnServerInfo.password || ''
-    });
-  }
-
-  if (isMultistream) {
-    return new MultistreamRoapMediaConnection({
-      iceServers,
-    }, 'mc');
-  }
-
-  return new RoapMediaConnection({
-    iceServers,
-    skipInactiveTransceivers: false,
-    requireH264: true,
-    sdpMunging: {
-      convertPort9to0: false,
-      addContentSlides: true,
-      bandwidthLimits: {
-        audio: StaticConfig.meetings.bandwidth.audio,
-        video: StaticConfig.meetings.bandwidth.video,
-      },
-      startBitrate: StaticConfig.meetings.bandwidth.startBitrate,
-      periodicKeyframes: 20, // it's always been hardcoded in SDK so for now keeping it that way
-      disableExtmap: !enableExtmap,
-      disableRtx: !enableRtx, // see https://bugs.chromium.org/p/chromium/issues/detail?id=1020642 why we might want to remove RTX from SDP
-    }
-  }, {
-    send: {
-      audio: audioTrack,
-      video: videoTrack,
-      screenShareVideo: shareTrack
-    },
-    receive: {
-      audio: mediaDirection.receiveAudio,
-      video: mediaDirection.receiveVideo,
-      screenShareVideo: mediaDirection.receiveShare,
-      remoteQualityLevel
-    }
-  }, 'mc');
-};
-
-/**
- * generates share streams
- * @param {Object} options parameter
- * @param {Boolean} options.sendAudio send audio from the display share
- * @param {Boolean} options.sendShare send video from the display share
- * @param {Object} options.sharePreferences
- * @param {MediaTrackConstraints} options.sharePreferences.shareConstraints constraints to apply to video
- *   @see {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackConstraints}
- * @param {Boolean} options.sharePreferences.highFrameRate if shareConstraints isn't provided, set default values based off of this boolean
- * @param {Object} config SDK Configuration for meetings plugin
- * @returns {Promise.<MediaStream>}
- */
-Media.getDisplayMedia = (options, config = {}) => {
-  // SDK screen share resolution settings from Webex.init
-  const customResolution = config.screenResolution || {};
-  // user defined screen share frame rate
-  const customShareFrameRate = config.screenFrameRate || null;
-  // user defined share preferences
-  const hasSharePreferences = options.sharePreferences;
-  const hasCustomConstraints = hasSharePreferences && hasSharePreferences.shareConstraints;
-  const hasHighFrameRate = hasSharePreferences && hasSharePreferences.highFrameRate;
-  const {
-    screenResolution,
-    resolution,
-    videoShareFrameRate,
-    screenFrameRate,
-    aspectRatio
-  } = Config.meetings;
-
-  let shareConstraints = {
-    cursor: MEDIA_TRACK_CONSTRAINT.CURSOR.AWLAYS,
-    aspectRatio
-  };
-
-  if (hasCustomConstraints) {
-    shareConstraints = hasSharePreferences.shareConstraints;
-  }
-  else if (hasHighFrameRate) {
-    shareConstraints = {
-      ...shareConstraints,
-      frameRate: videoShareFrameRate,
-      height: resolution.idealHeight,
-      width: resolution.idealWidth,
-      ...config.resolution
-    };
-  }
-  else {
-    shareConstraints = {
-      ...shareConstraints,
-      frameRate: customShareFrameRate || screenFrameRate,
-      height: customResolution.idealHeight || screenResolution.idealHeight,
-      width: customResolution.idealWidth || screenResolution.idealWidth,
-      ...config.screenResolution
-    };
-  }
-
-  // chrome and webkit based browsers (edge, safari) automatically adjust everything
-  // and we have noticed higher quality with those browser types
-  // firefox specifically has some issues with resolution and frame rate decision making
-  // so we are making it optional and configurable (with defaults) for firefox
-  // to have higher quality, and for developers to control the values
-  // eventually we may have to add the same functionality to chrome, OR conversely, get to with firefox
-
-
-  if (isBrowser('firefox')) {
-    const mediaConfig = {
-      audio: options.sendAudio,
-      video: options.sendShare
-    };
-
-
-    return navigator.mediaDevices.getDisplayMedia({audio: options.sendAudio, video: mediaConfig})
-      .then((stream) => {
-        if (options.sendShare && stream.getVideoTracks().length > 0) {
-          // Firefox has a bug with the spec where changing in the height and width only happens
-          // after we get the inital tracks
-          // https://bugzilla.mozilla.org/show_bug.cgi?id=1321221
-          stream.getVideoTracks()[0].applyConstraints(shareConstraints);
-        }
-
-
-        return stream;
-      });
-  }
-
-  const getDisplayMediaParams = {video: options.sendShare ? shareConstraints : false};
-
-  // safari doesn't support sending screen share audio
-  // https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia
-  if (options.sendAudio && isBrowser('safari')) {
-    getDisplayMediaParams.audio = options.sendAudio;
-  }
-
-  return navigator.mediaDevices.getDisplayMedia(getDisplayMediaParams);
-};
-
-/**
- * generates audio and video using constraints (often called after getSupportedDevices)
- * @param {Object|Boolean} audio gum constraints
- * @param {Object|Boolean} video gum constraints
- * @param {Object} config SDK Configuration for meetings plugin
- * @returns {Object} {streams}
- */
-Media.getMedia = (audio, video, config) => {
-  const defaultWidth = {ideal: config.resolution.idealWidth, max: config.resolution.maxWidth};
-  const defaultHeight = {ideal: config.resolution.idealHeight, max: config.resolution.maxHeight};
-  const mediaConfig = {
-    audio,
-    // TODO: Remove temporary workaround once Firefox fixes low constraint issues
-    // eslint-disable-next-line no-nested-ternary
-    video: video ?
-      isBrowser('firefox') && video.width && video.width.max === 320 ?
-        {
-          deviceId: video.deviceId ? video.deviceId : undefined,
-          width: 320,
-          height: 180
-        } :
-        {
-          deviceId: video.deviceId ? video.deviceId : undefined,
-          width: video.width ? video.width : defaultWidth,
-          height: video.height ? video.height : defaultHeight
-        } :
-      false,
-    fake: process.env.NODE_ENV === 'test' // Special case to get fake media for Firefox browser for testing
-  };
-
-  return navigator.mediaDevices
-    .getUserMedia(mediaConfig)
-    .catch((err) => {
-      const logPath = 'Media:index#getMedia --> navigator.mediaDevices.getUserMedia';
-
-      LoggerProxy.logger.error(`${logPath} failed - ${err} (${err.constraint})`);
-      throw err;
-    });
-};
-
-/**
- * Checks if the machine has at least one audio or video device (Dont use this for screen share)
- * @param {object} [options]
- * {
- *    sendAudio: true/false,
- *    sendVideo: true/false
- * }
- * @returns {Object} {
- *    sendAudio: true/false,
- *    sendVideo: true/false
- *}
- */
-Media.getSupportedDevice = ({sendAudio, sendVideo}) =>
-  Promise.resolve().then(() => {
-    if (!navigator.mediaDevices || navigator.mediaDevices.enumerateDevices === undefined) {
-      return {
-        sendAudio: false,
-        sendVideo: false
-      };
-    }
-
-    return navigator.mediaDevices.enumerateDevices().then((devices) => {
-      const supported = {
-        audio: devices.filter((device) => device.kind === AUDIO_INPUT).length > 0,
-        video: devices.filter((device) => device.kind === VIDEO_INPUT).length > 0
-      };
-
-      return {
-        sendAudio: supported.audio && sendAudio,
-        sendVideo: supported.video && sendVideo
-      };
-    });
-  });
-
-/**
- * proxy to browser navigator.mediaDevices.enumerateDevices()
- * @returns {Promise}
- */
-Media.getDevices = () => {
-  if (navigator && navigator.mediaDevices && navigator.mediaDevices.enumerateDevices) {
-    return navigator.mediaDevices.enumerateDevices();
-  }
-
-  return Promise.reject(new MediaError('enumerateDevices not supported.'));
-};
-
-/**
- *
- * Toggle a specific stream
- * noop as of now, does nothing
- * @returns {null}
- */
-Media.toggleStream = () => {};
-
-/**
- * Stop input stream
- * @param {MediaTrack} track A media stream
- * @returns {null}
- */
-Media.stopTracks = (track) => {
-  if (!track) {
-    return Promise.resolve();
-  }
-
-  return Promise.resolve().then(() => {
-    if (track && track.stop) {
-      try {
-        track.stop();
-      }
-      catch (e) {
-        LoggerProxy.logger.error(`Media:index#stopTracks --> Unable to stop the track with state ${track.readyState}, error: ${e}`);
-      }
-    }
-  });
-};
-
-/**
- *
- * Stop input stream
- * @param {Stream} stream A media stream
- * @returns {null}
- * @deprecated after v1.89.3
- */
-Media.stopStream = (stream) => {
-  LoggerProxy.logger.warn('Media:index#stopStream --> [DEPRECATION WARNING]: stopStream has been deprecated after v1.89.3');
-  if (!stream) {
-    return Promise.resolve();
-  }
-
-  /*
-   * To release local media
-   * 1) Chrome requires all tracks to be stopped (stream.stop got deprecated)
-   * 2) Firefox requires the stream to be stopped
-   */
-  return Promise.resolve().then(() => {
-    if (stream.getTracks) {
-      stream.getTracks().forEach((track) => {
-        track.stop();
-      });
-    }
-    else if (stream.stop) {
-      stream.stop();
-    }
-  });
-};
-
-/**
- * generates streams for audio video and share
- * @param {object} mediaSetting parameter
- * @param {Object} mediaSetting.sendAudio sendAudio: {Boolean} sendAudio constraints
- * @param {Object} mediaSetting.sendVideo sendVideo: {Boolean} sendVideo constraints
- * @param {Object} mediaSetting.sendShare sendShare: {Boolean} sendShare constraints
- * @param {Object} mediaSetting.isSharing isSharing: {Boolean} isSharing constraints
- * @param {Object} audioVideo parameter
- * @param {Object} audioVideo.audio {deviceId: {String}}
- * @param {Object} audioVideo.video {deviceId: {String}}
- * @param {Object} sharePreferences parameter
- * @param {Object} sharePreferences.shareConstraints parameter
- * @param {Boolean} sharePreferences.highFrameRate parameter
- * @param {Object} config SDK Config
- * @returns {Array} [localStream, shareStream]
- */
-Media.getUserMedia = (mediaSetting, audioVideo, sharePreferences, config) => Media.getLocalMedia({
-  sendAudio: mediaSetting.sendAudio ? audioVideo.audio || mediaSetting.sendAudio : false,
-  sendVideo: mediaSetting.sendVideo ? audioVideo.video || mediaSetting.sendVideo : false
-}, config).then((localStream) => Media.getLocalMedia({
-  sendShare: mediaSetting.sendShare,
-  isSharing: mediaSetting.isSharing,
-  sharePreferences
-}, config).then((shareStream) => [localStream, shareStream]));
-
-export default Media;

package/src/media/internal-media-core-wrapper.ts

@@ -1,9 +0,0 @@
-import {MediaConnection as MC} from '@webex/internal-media-core';
-
-/* We have this wrapper just because otherwise it's impossible to mock
- * RoapMediaConnection and MultistreamRoapMediaConnection constructors in unit tests,
- * because they are exported by @webex/internal-media-core as non-writable, non-configurable
- * properties of MediaConnection and sinon doesn't allow spying on them or stubbing them.
- */
-export const RoapMediaConnection = MC.RoapMediaConnection;
-export const MultistreamRoapMediaConnection = MC.MultistreamRoapMediaConnection;