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

package/dist/multistream/remoteMedia.js

@@ -1,47 +1,30 @@
 "use strict";
 
 var _Reflect$construct = require("@babel/runtime-corejs2/core-js/reflect/construct");
-
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-
 exports.RemoteMediaEvents = exports.RemoteMedia = void 0;
 exports.getMaxFs = getMaxFs;
-
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
-
 var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
-
 var _assertThisInitialized2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/assertThisInitialized"));
-
 var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/inherits"));
-
 var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
-
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
-
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
-
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
-
 var _eventsScope = _interopRequireDefault(require("../common/events/events-scope"));
-
 var _receiveSlot = require("./receiveSlot");
-
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = _Reflect$construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
-
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
-
 var RemoteMediaEvents = {
-  SourceUpdate: _receiveSlot.ReceiveSlotEvents.SourceUpdate
+  SourceUpdate: _receiveSlot.ReceiveSlotEvents.SourceUpdate,
+  Stopped: 'stopped'
 };
 exports.RemoteMediaEvents = RemoteMediaEvents;
-
 // highest possible resolution
 
 /**
@@ -51,55 +34,42 @@ exports.RemoteMediaEvents = RemoteMediaEvents;
  */
 function getMaxFs(paneSize) {
   var maxFs;
-
   switch (paneSize) {
     case 'thumbnail':
       maxFs = 60;
       break;
-
     case 'very small':
       maxFs = 240;
       break;
-
     case 'small':
       maxFs = 920;
       break;
-
     case 'medium':
       maxFs = 3600;
       break;
-
     case 'large':
       maxFs = 8192;
       break;
-
     case 'best':
       maxFs = 8192; // for now 'best' is 1080p, so same as 'large'
-
       break;
-
     default:
       _loggerProxy.default.logger.warn("RemoteMedia#getMaxFs --> unsupported paneSize: ".concat(paneSize, ", using \"medium\" instead"));
-
       maxFs = 3600;
   }
-
   return maxFs;
 }
-
 var remoteMediaCounter = 0;
+
 /**
  * Class representing a remote audio/video stream.
  *
  * Internally it is associated with a specific receive slot
  * and a media request for it.
  */
-
 var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   (0, _inherits2.default)(RemoteMedia, _EventsScope);
-
   var _super = _createSuper(RemoteMedia);
-
   /**
    * Constructs RemoteMedia instance
    *
@@ -109,7 +79,6 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
    */
   function RemoteMedia(receiveSlot, mediaRequestManager, options) {
     var _this;
-
     (0, _classCallCheck2.default)(this, RemoteMedia);
     _this = _super.call(this);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "receiveSlot", void 0);
@@ -121,32 +90,59 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
     _this.receiveSlot = receiveSlot;
     _this.mediaRequestManager = mediaRequestManager;
     _this.options = options || {};
-
     _this.setupEventListeners();
-
     _this.id = "RM".concat(remoteMediaCounter, "-").concat(_this.receiveSlot.id);
     return _this;
   }
+
   /**
-   * Invalidates the remote media by clearing the reference to a receive slot and
-   * cancelling the media request.
-   * After this call the remote media is unusable.
-   *
-   * @param {boolean} commit - whether to commit the cancellation of the media request
-   * @internal
+   * Supply the width and height of the video element
+   * to restrict the requested resolution to this size
+   * @param width width of the video element
+   * @param height height of the video element
    */
-
-
   (0, _createClass2.default)(RemoteMedia, [{
-    key: "stop",
-    value: function stop() {
+    key: "setSizeHint",
+    value: function setSizeHint(width, height) {
       var _this$receiveSlot;
+      // only base on height for now
+      var fs;
+      if (height < 135) {
+        fs = 60;
+      } else if (height < 270) {
+        fs = 240;
+      } else if (height < 540) {
+        fs = 920;
+      } else if (height <= 720) {
+        fs = 3600;
+      } else {
+        fs = 8192;
+      }
+      (_this$receiveSlot = this.receiveSlot) === null || _this$receiveSlot === void 0 ? void 0 : _this$receiveSlot.setMaxFs(fs);
+    }
 
+    /**
+     * Invalidates the remote media by clearing the reference to a receive slot and
+     * cancelling the media request.
+     * After this call the remote media is unusable.
+     *
+     * @param {boolean} commit - whether to commit the cancellation of the media request
+     * @internal
+     */
+  }, {
+    key: "stop",
+    value: function stop() {
+      var _this$receiveSlot2;
       var commit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
       this.cancelMediaRequest(commit);
-      (_this$receiveSlot = this.receiveSlot) === null || _this$receiveSlot === void 0 ? void 0 : _this$receiveSlot.removeAllListeners();
+      (_this$receiveSlot2 = this.receiveSlot) === null || _this$receiveSlot2 === void 0 ? void 0 : _this$receiveSlot2.removeAllListeners();
       this.receiveSlot = undefined;
+      this.emit({
+        file: 'multistream/remoteMedia',
+        function: 'stop'
+      }, RemoteMediaEvents.Stopped, {});
     }
+
     /**
      * Sends a new media request. This method can only be used for receiver-selected policy,
      * because only in that policy we have a 1-1 relationship between RemoteMedia and MediaRequest
@@ -156,18 +152,15 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
      *
      * @internal
      */
-
   }, {
     key: "sendMediaRequest",
     value: function sendMediaRequest(csi, commit) {
       if (this.mediaRequestId) {
         this.cancelMediaRequest(false);
       }
-
       if (!this.receiveSlot) {
         throw new Error('sendMediaRequest() called on an invalidated RemoteMedia instance');
       }
-
       this.mediaRequestId = this.mediaRequestManager.addRequest({
         policyInfo: {
           policy: 'receiver-selected',
@@ -180,10 +173,10 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
         }
       }, commit);
     }
+
     /**
      * @internal
      */
-
   }, {
     key: "cancelMediaRequest",
     value: function cancelMediaRequest(commit) {
@@ -192,18 +185,17 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
         this.mediaRequestId = undefined;
       }
     }
+
     /**
      * registers event listeners on the receive slot and forwards all the events
      */
-
   }, {
     key: "setupEventListeners",
     value: function setupEventListeners() {
       var _this2 = this;
-
       if (this.receiveSlot) {
         var scope = {
-          file: 'meeting/remoteMedia',
+          file: 'multistream/remoteMedia',
           function: 'setupEventListeners'
         };
         this.receiveSlot.on(_receiveSlot.ReceiveSlotEvents.SourceUpdate, function (data) {
@@ -211,66 +203,61 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
         });
       }
     }
+
     /**
      * Getter for mediaType
      */
-
   }, {
     key: "mediaType",
     get: function get() {
-      var _this$receiveSlot2;
-
-      return (_this$receiveSlot2 = this.receiveSlot) === null || _this$receiveSlot2 === void 0 ? void 0 : _this$receiveSlot2.mediaType;
+      var _this$receiveSlot3;
+      return (_this$receiveSlot3 = this.receiveSlot) === null || _this$receiveSlot3 === void 0 ? void 0 : _this$receiveSlot3.mediaType;
     }
+
     /**
      * Getter for memberId
      */
-
   }, {
     key: "memberId",
     get: function get() {
-      var _this$receiveSlot3;
-
-      return (_this$receiveSlot3 = this.receiveSlot) === null || _this$receiveSlot3 === void 0 ? void 0 : _this$receiveSlot3.memberId;
+      var _this$receiveSlot4;
+      return (_this$receiveSlot4 = this.receiveSlot) === null || _this$receiveSlot4 === void 0 ? void 0 : _this$receiveSlot4.memberId;
     }
+
     /**
      * Getter for csi
      */
-
   }, {
     key: "csi",
     get: function get() {
-      var _this$receiveSlot4;
-
-      return (_this$receiveSlot4 = this.receiveSlot) === null || _this$receiveSlot4 === void 0 ? void 0 : _this$receiveSlot4.csi;
+      var _this$receiveSlot5;
+      return (_this$receiveSlot5 = this.receiveSlot) === null || _this$receiveSlot5 === void 0 ? void 0 : _this$receiveSlot5.csi;
     }
+
     /**
      * Getter for source state
      */
-
   }, {
     key: "sourceState",
     get: function get() {
-      var _this$receiveSlot5;
-
-      return (_this$receiveSlot5 = this.receiveSlot) === null || _this$receiveSlot5 === void 0 ? void 0 : _this$receiveSlot5.sourceState;
+      var _this$receiveSlot6;
+      return (_this$receiveSlot6 = this.receiveSlot) === null || _this$receiveSlot6 === void 0 ? void 0 : _this$receiveSlot6.sourceState;
     }
+
     /**
      * Getter for remote media stream
      */
-
   }, {
     key: "stream",
     get: function get() {
-      var _this$receiveSlot6;
-
-      return (_this$receiveSlot6 = this.receiveSlot) === null || _this$receiveSlot6 === void 0 ? void 0 : _this$receiveSlot6.stream;
+      var _this$receiveSlot7;
+      return (_this$receiveSlot7 = this.receiveSlot) === null || _this$receiveSlot7 === void 0 ? void 0 : _this$receiveSlot7.stream;
     }
+
     /**
      * @internal
      * @returns {ReceiveSlot}
      */
-
   }, {
     key: "getUnderlyingReceiveSlot",
     value: function getUnderlyingReceiveSlot() {
@@ -279,6 +266,5 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }]);
   return RemoteMedia;
 }(_eventsScope.default);
-
 exports.RemoteMedia = RemoteMedia;
 //# sourceMappingURL=remoteMedia.js.map

package/dist/multistream/remoteMedia.js.map

@@ -1 +1 @@
-{"version":3,"names":["RemoteMediaEvents","SourceUpdate","ReceiveSlotEvents","getMaxFs","paneSize","maxFs","LoggerProxy","logger","warn","remoteMediaCounter","RemoteMedia","receiveSlot","mediaRequestManager","options","setupEventListeners","id","commit","cancelMediaRequest","removeAllListeners","undefined","csi","mediaRequestId","Error","addRequest","policyInfo","policy","receiveSlots","codecInfo","resolution","codec","cancelRequest","scope","file","function","on","data","emit","mediaType","memberId","sourceState","stream","EventsScope"],"sources":["remoteMedia.ts"],"sourcesContent":["/* eslint-disable valid-jsdoc */\nimport LoggerProxy from '../common/logs/logger-proxy';\nimport EventsScope from '../common/events/events-scope';\n\nimport {MediaRequestId, MediaRequestManager} from './mediaRequestManager';\nimport {CSI, ReceiveSlot, ReceiveSlotEvents} from './receiveSlot';\n\nexport const RemoteMediaEvents = {\n  SourceUpdate: ReceiveSlotEvents.SourceUpdate,\n};\n\nexport type RemoteVideoResolution =\n  | 'thumbnail' // the smallest possible resolution, 90p or less\n  | 'very small' // 180p or less\n  | 'small' // 360p or less\n  | 'medium' // 720p or less\n  | 'large' // 1080p or less\n  | 'best'; // highest possible resolution\n\n/**\n * Converts pane size into h264 maxFs\n * @param {PaneSize} paneSize\n * @returns {number}\n */\nexport function getMaxFs(paneSize: RemoteVideoResolution): number {\n  let maxFs;\n\n  switch (paneSize) {\n    case 'thumbnail':\n      maxFs = 60;\n      break;\n    case 'very small':\n      maxFs = 240;\n      break;\n    case 'small':\n      maxFs = 920;\n      break;\n    case 'medium':\n      maxFs = 3600;\n      break;\n    case 'large':\n      maxFs = 8192;\n      break;\n    case 'best':\n      maxFs = 8192; // for now 'best' is 1080p, so same as 'large'\n      break;\n    default:\n      LoggerProxy.logger.warn(\n        `RemoteMedia#getMaxFs --> unsupported paneSize: ${paneSize}, using \"medium\" instead`\n      );\n      maxFs = 3600;\n  }\n\n  return maxFs;\n}\n\ntype Options = {\n  resolution?: RemoteVideoResolution; // applies only to groups of type MC.MediaType.VideoMain and MC.MediaType.VideoSlides\n};\n\nexport type RemoteMediaId = string;\n\nlet remoteMediaCounter = 0;\n\n/**\n * Class representing a remote audio/video stream.\n *\n * Internally it is associated with a specific receive slot\n * and a media request for it.\n */\nexport class RemoteMedia extends EventsScope {\n  private receiveSlot?: ReceiveSlot;\n\n  private readonly mediaRequestManager: MediaRequestManager;\n\n  private readonly options: Options;\n\n  private mediaRequestId?: MediaRequestId;\n\n  public readonly id: RemoteMediaId;\n\n  /**\n   * Constructs RemoteMedia instance\n   *\n   * @param receiveSlot\n   * @param mediaRequestManager\n   * @param options\n   */\n  constructor(\n    receiveSlot: ReceiveSlot,\n    mediaRequestManager: MediaRequestManager,\n    options?: Options\n  ) {\n    super();\n    remoteMediaCounter += 1;\n    this.receiveSlot = receiveSlot;\n    this.mediaRequestManager = mediaRequestManager;\n    this.options = options || {};\n    this.setupEventListeners();\n    this.id = `RM${remoteMediaCounter}-${this.receiveSlot.id}`;\n  }\n\n  /**\n   * Invalidates the remote media by clearing the reference to a receive slot and\n   * cancelling the media request.\n   * After this call the remote media is unusable.\n   *\n   * @param {boolean} commit - whether to commit the cancellation of the media request\n   * @internal\n   */\n  public stop(commit: boolean = true) {\n    this.cancelMediaRequest(commit);\n    this.receiveSlot?.removeAllListeners();\n    this.receiveSlot = undefined;\n  }\n\n  /**\n   * Sends a new media request. This method can only be used for receiver-selected policy,\n   * because only in that policy we have a 1-1 relationship between RemoteMedia and MediaRequest\n   * and the request id is then stored in this RemoteMedia instance.\n   * For active-speaker policy, the same request is shared among many RemoteMedia instances,\n   * so it's managed through RemoteMediaGroup\n   *\n   * @internal\n   */\n  public sendMediaRequest(csi: CSI, commit: boolean) {\n    if (this.mediaRequestId) {\n      this.cancelMediaRequest(false);\n    }\n\n    if (!this.receiveSlot) {\n      throw new Error('sendMediaRequest() called on an invalidated RemoteMedia instance');\n    }\n\n    this.mediaRequestId = this.mediaRequestManager.addRequest(\n      {\n        policyInfo: {\n          policy: 'receiver-selected',\n          csi,\n        },\n        receiveSlots: [this.receiveSlot],\n        codecInfo: this.options.resolution && {\n          codec: 'h264',\n          maxFs: getMaxFs(this.options.resolution),\n        },\n      },\n      commit\n    );\n  }\n\n  /**\n   * @internal\n   */\n  public cancelMediaRequest(commit: boolean) {\n    if (this.mediaRequestId) {\n      this.mediaRequestManager.cancelRequest(this.mediaRequestId, commit);\n      this.mediaRequestId = undefined;\n    }\n  }\n\n  /**\n   * registers event listeners on the receive slot and forwards all the events\n   */\n  private setupEventListeners() {\n    if (this.receiveSlot) {\n      const scope = {\n        file: 'meeting/remoteMedia',\n        function: 'setupEventListeners',\n      };\n\n      this.receiveSlot.on(ReceiveSlotEvents.SourceUpdate, (data) => {\n        this.emit(scope, RemoteMediaEvents.SourceUpdate, data);\n      });\n    }\n  }\n\n  /**\n   * Getter for mediaType\n   */\n  public get mediaType() {\n    return this.receiveSlot?.mediaType;\n  }\n\n  /**\n   * Getter for memberId\n   */\n  public get memberId() {\n    return this.receiveSlot?.memberId;\n  }\n\n  /**\n   * Getter for csi\n   */\n  public get csi() {\n    return this.receiveSlot?.csi;\n  }\n\n  /**\n   * Getter for source state\n   */\n  public get sourceState() {\n    return this.receiveSlot?.sourceState;\n  }\n\n  /**\n   * Getter for remote media stream\n   */\n  public get stream() {\n    return this.receiveSlot?.stream;\n  }\n\n  /**\n   * @internal\n   * @returns {ReceiveSlot}\n   */\n  public getUnderlyingReceiveSlot() {\n    return this.receiveSlot;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["RemoteMediaEvents","SourceUpdate","ReceiveSlotEvents","Stopped","getMaxFs","paneSize","maxFs","LoggerProxy","logger","warn","remoteMediaCounter","RemoteMedia","receiveSlot","mediaRequestManager","options","setupEventListeners","id","width","height","fs","setMaxFs","commit","cancelMediaRequest","removeAllListeners","undefined","emit","file","function","csi","mediaRequestId","Error","addRequest","policyInfo","policy","receiveSlots","codecInfo","resolution","codec","cancelRequest","scope","on","data","mediaType","memberId","sourceState","stream","EventsScope"],"sources":["remoteMedia.ts"],"sourcesContent":["/* eslint-disable valid-jsdoc */\nimport {MediaType, StreamState} from '@webex/internal-media-core';\nimport LoggerProxy from '../common/logs/logger-proxy';\nimport EventsScope from '../common/events/events-scope';\n\nimport {MediaRequestId, MediaRequestManager} from './mediaRequestManager';\nimport {CSI, ReceiveSlot, ReceiveSlotEvents} from './receiveSlot';\n\nexport const RemoteMediaEvents = {\n  SourceUpdate: ReceiveSlotEvents.SourceUpdate,\n  Stopped: 'stopped',\n};\n\nexport type RemoteVideoResolution =\n  | 'thumbnail' // the smallest possible resolution, 90p or less\n  | 'very small' // 180p or less\n  | 'small' // 360p or less\n  | 'medium' // 720p or less\n  | 'large' // 1080p or less\n  | 'best'; // highest possible resolution\n\n/**\n * Converts pane size into h264 maxFs\n * @param {PaneSize} paneSize\n * @returns {number}\n */\nexport function getMaxFs(paneSize: RemoteVideoResolution): number {\n  let maxFs;\n\n  switch (paneSize) {\n    case 'thumbnail':\n      maxFs = 60;\n      break;\n    case 'very small':\n      maxFs = 240;\n      break;\n    case 'small':\n      maxFs = 920;\n      break;\n    case 'medium':\n      maxFs = 3600;\n      break;\n    case 'large':\n      maxFs = 8192;\n      break;\n    case 'best':\n      maxFs = 8192; // for now 'best' is 1080p, so same as 'large'\n      break;\n    default:\n      LoggerProxy.logger.warn(\n        `RemoteMedia#getMaxFs --> unsupported paneSize: ${paneSize}, using \"medium\" instead`\n      );\n      maxFs = 3600;\n  }\n\n  return maxFs;\n}\n\ntype Options = {\n  resolution?: RemoteVideoResolution; // applies only to groups of type MediaType.VideoMain and MediaType.VideoSlides\n};\n\nexport type RemoteMediaId = string;\n\nlet remoteMediaCounter = 0;\n\n/**\n * Class representing a remote audio/video stream.\n *\n * Internally it is associated with a specific receive slot\n * and a media request for it.\n */\nexport class RemoteMedia extends EventsScope {\n  private receiveSlot?: ReceiveSlot;\n\n  private readonly mediaRequestManager: MediaRequestManager;\n\n  private readonly options: Options;\n\n  private mediaRequestId?: MediaRequestId;\n\n  public readonly id: RemoteMediaId;\n\n  /**\n   * Constructs RemoteMedia instance\n   *\n   * @param receiveSlot\n   * @param mediaRequestManager\n   * @param options\n   */\n  constructor(\n    receiveSlot: ReceiveSlot,\n    mediaRequestManager: MediaRequestManager,\n    options?: Options\n  ) {\n    super();\n    remoteMediaCounter += 1;\n    this.receiveSlot = receiveSlot;\n    this.mediaRequestManager = mediaRequestManager;\n    this.options = options || {};\n    this.setupEventListeners();\n    this.id = `RM${remoteMediaCounter}-${this.receiveSlot.id}`;\n  }\n\n  /**\n   * Supply the width and height of the video element\n   * to restrict the requested resolution to this size\n   * @param width width of the video element\n   * @param height height of the video element\n   */\n  public setSizeHint(width, height) {\n    // only base on height for now\n    let fs: number;\n\n    if (height < 135) {\n      fs = 60;\n    } else if (height < 270) {\n      fs = 240;\n    } else if (height < 540) {\n      fs = 920;\n    } else if (height <= 720) {\n      fs = 3600;\n    } else {\n      fs = 8192;\n    }\n\n    this.receiveSlot?.setMaxFs(fs);\n  }\n\n  /**\n   * Invalidates the remote media by clearing the reference to a receive slot and\n   * cancelling the media request.\n   * After this call the remote media is unusable.\n   *\n   * @param {boolean} commit - whether to commit the cancellation of the media request\n   * @internal\n   */\n  public stop(commit = true) {\n    this.cancelMediaRequest(commit);\n    this.receiveSlot?.removeAllListeners();\n    this.receiveSlot = undefined;\n    this.emit(\n      {\n        file: 'multistream/remoteMedia',\n        function: 'stop',\n      },\n      RemoteMediaEvents.Stopped,\n      {}\n    );\n  }\n\n  /**\n   * Sends a new media request. This method can only be used for receiver-selected policy,\n   * because only in that policy we have a 1-1 relationship between RemoteMedia and MediaRequest\n   * and the request id is then stored in this RemoteMedia instance.\n   * For active-speaker policy, the same request is shared among many RemoteMedia instances,\n   * so it's managed through RemoteMediaGroup\n   *\n   * @internal\n   */\n  public sendMediaRequest(csi: CSI, commit: boolean) {\n    if (this.mediaRequestId) {\n      this.cancelMediaRequest(false);\n    }\n\n    if (!this.receiveSlot) {\n      throw new Error('sendMediaRequest() called on an invalidated RemoteMedia instance');\n    }\n\n    this.mediaRequestId = this.mediaRequestManager.addRequest(\n      {\n        policyInfo: {\n          policy: 'receiver-selected',\n          csi,\n        },\n        receiveSlots: [this.receiveSlot],\n        codecInfo: this.options.resolution && {\n          codec: 'h264',\n          maxFs: getMaxFs(this.options.resolution),\n        },\n      },\n      commit\n    );\n  }\n\n  /**\n   * @internal\n   */\n  public cancelMediaRequest(commit: boolean) {\n    if (this.mediaRequestId) {\n      this.mediaRequestManager.cancelRequest(this.mediaRequestId, commit);\n      this.mediaRequestId = undefined;\n    }\n  }\n\n  /**\n   * registers event listeners on the receive slot and forwards all the events\n   */\n  private setupEventListeners() {\n    if (this.receiveSlot) {\n      const scope = {\n        file: 'multistream/remoteMedia',\n        function: 'setupEventListeners',\n      };\n\n      this.receiveSlot.on(ReceiveSlotEvents.SourceUpdate, (data) => {\n        this.emit(scope, RemoteMediaEvents.SourceUpdate, data);\n      });\n    }\n  }\n\n  /**\n   * Getter for mediaType\n   */\n  public get mediaType(): MediaType {\n    return this.receiveSlot?.mediaType;\n  }\n\n  /**\n   * Getter for memberId\n   */\n  public get memberId() {\n    return this.receiveSlot?.memberId;\n  }\n\n  /**\n   * Getter for csi\n   */\n  public get csi() {\n    return this.receiveSlot?.csi;\n  }\n\n  /**\n   * Getter for source state\n   */\n  public get sourceState(): StreamState {\n    return this.receiveSlot?.sourceState;\n  }\n\n  /**\n   * Getter for remote media stream\n   */\n  public get stream() {\n    return this.receiveSlot?.stream;\n  }\n\n  /**\n   * @internal\n   * @returns {ReceiveSlot}\n   */\n  public getUnderlyingReceiveSlot() {\n    return this.receiveSlot;\n  }\n}\n"],"mappings":"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"}

package/dist/multistream/remoteMediaGroup.js

@@ -1,37 +1,23 @@
 "use strict";
 
 var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
-
 var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");
-
 _Object$defineProperty(exports, "__esModule", {
   value: true
 });
-
 exports.RemoteMediaGroup = void 0;
-
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/toConsumableArray"));
-
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/classCallCheck"));
-
 var _createClass2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/createClass"));
-
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
-
+var _forEach2 = _interopRequireDefault(require("lodash/forEach"));
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
-
 var _remoteMedia = require("./remoteMedia");
-
-/* eslint-disable valid-jsdoc */
-
-/* eslint-disable require-jsdoc */
-
-/* eslint-disable import/prefer-default-export */
 var RemoteMediaGroup = /*#__PURE__*/function () {
   // id of the "active-speaker" media request id
+
   function RemoteMediaGroup(mediaRequestManager, receiveSlots, priority, commitMediaRequest) {
     var _this = this;
-
     var options = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
     (0, _classCallCheck2.default)(this, RemoteMediaGroup);
     (0, _defineProperty2.default)(this, "mediaRequestManager", void 0);
@@ -51,91 +37,123 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
     this.pinnedRemoteMedia = [];
     this.sendActiveSpeakerMediaRequest(commitMediaRequest);
   }
+
   /**
    * Gets the array of remote media elements from the group
    *
    * @param {string} filter - 'all' (default) returns both pinned and unpinned
    * @returns {Array<RemoteMedia>}
    */
-
-
   (0, _createClass2.default)(RemoteMediaGroup, [{
     key: "getRemoteMedia",
     value: function getRemoteMedia() {
       var filter = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'all';
-
       if (filter === 'unpinned') {
         // return a shallow copy so that the client cannot modify this.unpinnedRemoteMedia array
         return (0, _toConsumableArray2.default)(this.unpinnedRemoteMedia);
       }
-
       if (filter === 'pinned') {
         // return a shallow copy so that the client cannot modify this.pinnedRemoteMedia array
         return (0, _toConsumableArray2.default)(this.pinnedRemoteMedia);
       }
-
       return [].concat((0, _toConsumableArray2.default)(this.unpinnedRemoteMedia), (0, _toConsumableArray2.default)(this.pinnedRemoteMedia));
     }
+
+    /**
+     * Sets CSIs for multiple RemoteMedia instances belonging to this RemoteMediaGroup.
+     * For each entry in the remoteMediaCsis array:
+     * - if csi is specified, the RemoteMedia instance is pinned to that CSI
+     * - if csi is undefined, the RemoteMedia instance is unpinned
+     * @internal
+     */
+  }, {
+    key: "setActiveSpeakerCsis",
+    value: function setActiveSpeakerCsis(remoteMediaCsis) {
+      var _this2 = this;
+      var commit = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+      (0, _forEach2.default)(remoteMediaCsis, function (_ref) {
+        var csi = _ref.csi,
+          remoteMedia = _ref.remoteMedia;
+        if (csi) {
+          if (!(_this2.pinnedRemoteMedia.indexOf(remoteMedia) >= 0)) {
+            var unpinId = _this2.unpinnedRemoteMedia.indexOf(remoteMedia);
+            if (unpinId >= 0) {
+              _this2.unpinnedRemoteMedia.splice(unpinId, 1);
+              _this2.pinnedRemoteMedia.push(remoteMedia);
+            } else {
+              throw new Error("failed to pin a remote media object ".concat(remoteMedia.id, ", because it is not found in this remote media group"));
+            }
+          }
+          remoteMedia.sendMediaRequest(csi, false);
+        } else {
+          if (!(_this2.unpinnedRemoteMedia.indexOf(remoteMedia) >= 0)) {
+            var pinId = _this2.pinnedRemoteMedia.indexOf(remoteMedia);
+            if (pinId >= 0) {
+              _this2.pinnedRemoteMedia.splice(pinId, 1);
+              _this2.unpinnedRemoteMedia.push(remoteMedia);
+            } else {
+              throw new Error("failed to unpin a remote media object ".concat(remoteMedia.id, ", because it is not found in this remote media group"));
+            }
+          }
+          remoteMedia.cancelMediaRequest(false);
+        }
+      });
+      this.cancelActiveSpeakerMediaRequest(false);
+      this.sendActiveSpeakerMediaRequest(false);
+      if (commit) {
+        this.mediaRequestManager.commit();
+      }
+    }
+
     /**
      * Pins a specific remote media instance to a specfic CSI, so the media will
      * no longer come from active speaker, but from that CSI.
      * If no CSI is given, the current CSI value is used.
      *
      */
-
   }, {
     key: "pin",
     value: function pin(remoteMedia, csi) {
       // if csi is not specified, use the current one
       var targetCsi = csi || remoteMedia.csi;
-
       if (!targetCsi) {
         throw new Error("failed to pin a remote media object ".concat(remoteMedia.id, ", because it has no CSI set and no CSI value was given"));
       }
-
       if (this.pinnedRemoteMedia.indexOf(remoteMedia) >= 0) {
         if (targetCsi === remoteMedia.csi) {
           // remote media already pinned to target CSI, nothing to do
           _loggerProxy.default.logger.log("RemoteMediaGroup#pin --> remote media ".concat(remoteMedia.id, " already pinned"));
-
           return;
         }
       } else {
         var idx = this.unpinnedRemoteMedia.indexOf(remoteMedia);
-
         if (idx < 0) {
           throw new Error("failed to pin a remote media object ".concat(remoteMedia.id, ", because it is not found in this remote media group"));
         }
-
         this.unpinnedRemoteMedia.splice(idx, 1);
         this.pinnedRemoteMedia.push(remoteMedia);
         this.cancelActiveSpeakerMediaRequest(false);
         this.sendActiveSpeakerMediaRequest(false);
       }
-
       remoteMedia.sendMediaRequest(targetCsi, false);
       this.mediaRequestManager.commit();
     }
+
     /**
      * Unpins a remote media instance, so that it will again provide media from active speakers
      *
      */
-
   }, {
     key: "unpin",
     value: function unpin(remoteMedia) {
       if (this.unpinnedRemoteMedia.indexOf(remoteMedia) >= 0) {
         _loggerProxy.default.logger.log("RemoteMediaGroup#pin --> remote media ".concat(remoteMedia.id, " already unpinned"));
-
         return;
       }
-
       var idx = this.pinnedRemoteMedia.indexOf(remoteMedia);
-
       if (idx < 0) {
         throw new Error("failed to unpin a remote media object ".concat(remoteMedia.id, ", because it is not found in this remote media group"));
       }
-
       this.pinnedRemoteMedia.splice(idx, 1);
       this.unpinnedRemoteMedia.push(remoteMedia);
       remoteMedia.cancelMediaRequest(false);
@@ -149,18 +167,28 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
       if (this.unpinnedRemoteMedia.indexOf(remoteMedia) >= 0) {
         return false;
       }
-
       if (this.pinnedRemoteMedia.indexOf(remoteMedia) >= 0) {
         return true;
       }
-
       throw new Error("remote media object ".concat(remoteMedia.id, " not found in the group"));
     }
+
+    /**
+     * setPreferLiveVideo - sets preferLiveVideo to true/false
+     * @internal
+     */
+  }, {
+    key: "setPreferLiveVideo",
+    value: function setPreferLiveVideo(preferLiveVideo, commit) {
+      if (this.options.preferLiveVideo !== preferLiveVideo) {
+        this.options.preferLiveVideo = preferLiveVideo;
+        this.sendActiveSpeakerMediaRequest(commit);
+      }
+    }
   }, {
     key: "sendActiveSpeakerMediaRequest",
     value: function sendActiveSpeakerMediaRequest(commit) {
-      var _this$options;
-
+      var _this$options, _this$options$namedMe, _this$options2;
       this.cancelActiveSpeakerMediaRequest(false);
       this.mediaRequestId = this.mediaRequestManager.addRequest({
         policyInfo: {
@@ -168,7 +196,8 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
           priority: this.priority,
           crossPriorityDuplication: false,
           crossPolicyDuplication: false,
-          preferLiveVideo: !!((_this$options = this.options) !== null && _this$options !== void 0 && _this$options.preferLiveVideo)
+          preferLiveVideo: !!((_this$options = this.options) !== null && _this$options !== void 0 && _this$options.preferLiveVideo),
+          namedMediaGroups: (_this$options$namedMe = this.options.namedMediaGroup) !== null && _this$options$namedMe !== void 0 && _this$options$namedMe.value ? [(_this$options2 = this.options) === null || _this$options2 === void 0 ? void 0 : _this$options2.namedMediaGroup] : undefined
         },
         receiveSlots: this.unpinnedRemoteMedia.map(function (remoteMedia) {
           return remoteMedia.getUnderlyingReceiveSlot();
@@ -187,6 +216,20 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
         this.mediaRequestId = undefined;
       }
     }
+
+    /**
+     * setNamedMediaGroup - sets named media group type and value
+     * @internal
+     */
+  }, {
+    key: "setNamedMediaGroup",
+    value: function setNamedMediaGroup(namedMediaGroup, commit) {
+      if (this.options.namedMediaGroup.value !== namedMediaGroup.value || this.options.namedMediaGroup.type !== namedMediaGroup.type) {
+        this.options.namedMediaGroup = namedMediaGroup;
+        this.sendActiveSpeakerMediaRequest(commit);
+      }
+    }
+
     /**
      * Invalidates the remote media group by clearing the references to the receive slots
      * used by all remote media from that group and cancelling all media requests.
@@ -195,7 +238,6 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
      * @param{boolean} commit whether to commit the cancellation of media requests
      * @internal
      */
-
   }, {
     key: "stop",
     value: function stop() {
@@ -207,11 +249,11 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
         return remoteMedia.stop(false);
       });
       this.cancelActiveSpeakerMediaRequest(false);
-
       if (commit) {
         this.mediaRequestManager.commit();
       }
     }
+
     /**
      * Checks if a given RemoteMedia instance belongs to this group.
      *
@@ -219,25 +261,20 @@ var RemoteMediaGroup = /*#__PURE__*/function () {
      * @param filter controls which remote media from the group to check
      * @returns true if remote media is found
      */
-
   }, {
     key: "includes",
     value: function includes(remoteMedia) {
       var filter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'all';
-
       if (filter === 'pinned') {
         return this.pinnedRemoteMedia.includes(remoteMedia);
       }
-
       if (filter === 'unpinned') {
         return this.unpinnedRemoteMedia.includes(remoteMedia);
       }
-
       return this.unpinnedRemoteMedia.includes(remoteMedia) || this.pinnedRemoteMedia.includes(remoteMedia);
     }
   }]);
   return RemoteMediaGroup;
 }();
-
 exports.RemoteMediaGroup = RemoteMediaGroup;
 //# sourceMappingURL=remoteMediaGroup.js.map