@webex/plugin-meetings 3.0.0-beta.38 → 3.0.0-beta.39

package/dist/breakouts/breakout.js

@@ -130,7 +130,7 @@ var Breakout = _webexCore.WebexPlugin.extend({
       sessionId: this.sessionId
     });
   },
-  version: "3.0.0-beta.38"
+  version: "3.0.0-beta.39"
 });
 var _default = Breakout;
 exports.default = _default;

package/dist/breakouts/index.js

@@ -451,7 +451,7 @@ var Breakouts = _webexCore.WebexPlugin.extend({
       }, _callee3);
     }))();
   },
-  version: "3.0.0-beta.38"
+  version: "3.0.0-beta.39"
 });
 var _default = Breakouts;
 exports.default = _default;

package/dist/index.js

@@ -9,6 +9,12 @@ _Object$defineProperty(exports, "__esModule", {
   value: true
 });
 exports.REACTIONS = exports.CONSTANTS = void 0;
+_Object$defineProperty(exports, "RemoteMedia", {
+  enumerable: true,
+  get: function get() {
+    return _remoteMedia.RemoteMedia;
+  }
+});
 _Object$defineProperty(exports, "TriggerProxy", {
   enumerable: true,
   get: function get() {
@@ -23,6 +29,7 @@ var _CONSTANTS = _interopRequireWildcard(require("./constants"));
 exports.CONSTANTS = _CONSTANTS;
 var _REACTIONS = _interopRequireWildcard(require("./reactions/reactions"));
 exports.REACTIONS = _REACTIONS;
+var _remoteMedia = require("./multistream/remoteMedia");
 var _triggerProxy = _interopRequireDefault(require("./common/events/trigger-proxy"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["registerPlugin","Meetings","config"],"sources":["index.js"],"sourcesContent":["/* eslint-env browser */\nimport {registerPlugin} from '@webex/webex-core';\n\nimport Meetings from './meetings';\nimport config from './config';\n\nregisterPlugin('meetings', Meetings, {\n  config,\n});\n\nexport default Meetings;\n\nexport * as CONSTANTS from './constants';\nexport * as REACTIONS from './reactions/reactions';\n\nexport {default as TriggerProxy} from './common/events/trigger-proxy';\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA;AAEA;AACA;AAA8B;AAAA;AAAA;AAAA;AAW9B;AAAsE;AAAA;AAftE;;AAMA,IAAAA,yBAAc,EAAC,UAAU,EAAEC,iBAAQ,EAAE;EACnCC,MAAM,EAANA;AACF,CAAC,CAAC;AAAC,eAEYD,iBAAQ;AAAA"}
+{"version":3,"names":["registerPlugin","Meetings","config"],"sources":["index.js"],"sourcesContent":["/* eslint-env browser */\nimport {registerPlugin} from '@webex/webex-core';\n\nimport Meetings from './meetings';\nimport config from './config';\n\nregisterPlugin('meetings', Meetings, {\n  config,\n});\n\nexport default Meetings;\n\nexport * as CONSTANTS from './constants';\nexport * as REACTIONS from './reactions/reactions';\n\nexport {RemoteMedia} from './multistream/remoteMedia';\n\nexport {default as TriggerProxy} from './common/events/trigger-proxy';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA;AAEA;AACA;AAA8B;AAAA;AAAA;AAAA;AAW9B;AAEA;AAAsE;AAAA;AAjBtE;;AAMA,IAAAA,yBAAc,EAAC,UAAU,EAAEC,iBAAQ,EAAE;EACnCC,MAAM,EAANA;AACF,CAAC,CAAC;AAAC,eAEYD,iBAAQ;AAAA"}

package/dist/multistream/mediaRequestManager.js

@@ -12,6 +12,7 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs2/hel
 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 _debounce2 = _interopRequireDefault(require("lodash/debounce"));
 var _cloneDeep2 = _interopRequireDefault(require("lodash/cloneDeep"));
 var _internalMediaCore = require("@webex/internal-media-core");
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
@@ -26,6 +27,7 @@ var CODEC_DEFAULTS = {
     maxMbps: 245760
   }
 };
+var DEBOUNCED_SOURCE_UPDATE_TIME = 1000;
 var MediaRequestManager = /*#__PURE__*/function () {
   function MediaRequestManager(degradationPreferences, sendMediaRequestsCallback) {
     (0, _classCallCheck2.default)(this, MediaRequestManager);
@@ -34,11 +36,13 @@ var MediaRequestManager = /*#__PURE__*/function () {
     (0, _defineProperty2.default)(this, "clientRequests", void 0);
     (0, _defineProperty2.default)(this, "degradationPreferences", void 0);
     (0, _defineProperty2.default)(this, "sourceUpdateListener", void 0);
+    (0, _defineProperty2.default)(this, "debouncedSourceUpdateListener", void 0);
     this.sendMediaRequestsCallback = sendMediaRequestsCallback;
     this.counter = 0;
     this.clientRequests = {};
     this.degradationPreferences = degradationPreferences;
     this.sourceUpdateListener = this.commit.bind(this);
+    this.debouncedSourceUpdateListener = (0, _debounce2.default)(this.sourceUpdateListener, DEBOUNCED_SOURCE_UPDATE_TIME);
   }
   (0, _createClass2.default)(MediaRequestManager, [{
     key: "setDegradationPreferences",
@@ -61,7 +65,7 @@ var MediaRequestManager = /*#__PURE__*/function () {
             id = _ref2[0],
             mr = _ref2[1];
           if (mr.codecInfo) {
-            mr.codecInfo.maxFs = Math.min(mr.codecInfo.maxFs || CODEC_DEFAULTS.h264.maxFs, maxFsLimits[i]);
+            mr.codecInfo.maxFs = Math.min(mr.preferredMaxFs || CODEC_DEFAULTS.h264.maxFs, mr.codecInfo.maxFs || CODEC_DEFAULTS.h264.maxFs, maxFsLimits[i]);
             // we only consider sources with "live" state
             var slotsWithLiveSource = _this.clientRequests[id].receiveSlots.filter(function (rs) {
               return rs.sourceState === 'live';
@@ -109,6 +113,11 @@ var MediaRequestManager = /*#__PURE__*/function () {
       this.clientRequests[newId] = mediaRequest;
       mediaRequest.receiveSlots.forEach(function (rs) {
         rs.on(_receiveSlot.ReceiveSlotEvents.SourceUpdate, _this2.sourceUpdateListener);
+        rs.on(_receiveSlot.ReceiveSlotEvents.MaxFsUpdate, function (_ref3) {
+          var maxFs = _ref3.maxFs;
+          mediaRequest.preferredMaxFs = maxFs;
+          _this2.debouncedSourceUpdateListener();
+        });
       });
       if (commit) {
         this.commit();

package/dist/multistream/mediaRequestManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["CODEC_DEFAULTS","h264","maxFs","maxFps","maxMbps","MediaRequestManager","degradationPreferences","sendMediaRequestsCallback","counter","clientRequests","sourceUpdateListener","commit","bind","sendRequests","maxFsLimits","getMaxFs","totalMacroblocksRequested","forEach","id","mr","codecInfo","Math","min","i","slotsWithLiveSource","receiveSlots","filter","rs","sourceState","length","maxMacroblocksLimit","LoggerProxy","logger","warn","wcmeMediaRequests","getDegradedClientRequests","maxPayloadBitsPerSecond","push","WcmeMediaRequest","policyInfo","policy","Policy","ActiveSpeaker","ReceiverSelected","ActiveSpeakerInfo","priority","crossPriorityDuplication","crossPolicyDuplication","preferLiveVideo","ReceiverSelectedInfo","csi","map","receiveSlot","wcmeReceiveSlot","WcmeCodecInfo","H264Codec","maxWidth","maxHeight","mediaRequest","newId","on","ReceiveSlotEvents","SourceUpdate","requestId","off"],"sources":["mediaRequestManager.ts"],"sourcesContent":["/* eslint-disable require-jsdoc */\nimport {\n  MediaRequest as WcmeMediaRequest,\n  Policy,\n  ActiveSpeakerInfo,\n  ReceiverSelectedInfo,\n  CodecInfo as WcmeCodecInfo,\n  H264Codec,\n} from '@webex/internal-media-core';\nimport {cloneDeep} from 'lodash';\n\nimport LoggerProxy from '../common/logs/logger-proxy';\n\nimport {ReceiveSlot, ReceiveSlotEvents, ReceiveSlotId} from './receiveSlot';\nimport {getMaxFs} from './remoteMedia';\n\nexport interface ActiveSpeakerPolicyInfo {\n  policy: 'active-speaker';\n  priority: number;\n  crossPriorityDuplication: boolean;\n  crossPolicyDuplication: boolean;\n  preferLiveVideo: boolean;\n}\n\nexport interface ReceiverSelectedPolicyInfo {\n  policy: 'receiver-selected';\n  csi: number;\n}\n\nexport type PolicyInfo = ActiveSpeakerPolicyInfo | ReceiverSelectedPolicyInfo;\n\nexport interface H264CodecInfo {\n  codec: 'h264';\n  maxFs?: number;\n  maxFps?: number;\n  maxMbps?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n}\n\nexport type CodecInfo = H264CodecInfo; // we'll add AV1 here in the future when it's available\n\nexport interface MediaRequest {\n  policyInfo: PolicyInfo;\n  receiveSlots: Array<ReceiveSlot>;\n  codecInfo?: CodecInfo;\n}\n\nexport type MediaRequestId = string;\n\nconst CODEC_DEFAULTS = {\n  h264: {\n    maxFs: 8192,\n    maxFps: 3000,\n    maxMbps: 245760,\n  },\n};\n\ntype DegradationPreferences = {\n  maxMacroblocksLimit: number;\n};\n\ntype SendMediaRequestsCallback = (mediaRequests: WcmeMediaRequest[]) => void;\n\nexport class MediaRequestManager {\n  private sendMediaRequestsCallback: SendMediaRequestsCallback;\n\n  private counter: number;\n\n  private clientRequests: {[key: MediaRequestId]: MediaRequest};\n\n  private degradationPreferences: DegradationPreferences;\n\n  private sourceUpdateListener: () => void;\n\n  constructor(\n    degradationPreferences: DegradationPreferences,\n    sendMediaRequestsCallback: SendMediaRequestsCallback\n  ) {\n    this.sendMediaRequestsCallback = sendMediaRequestsCallback;\n    this.counter = 0;\n    this.clientRequests = {};\n    this.degradationPreferences = degradationPreferences;\n    this.sourceUpdateListener = this.commit.bind(this);\n  }\n\n  public setDegradationPreferences(degradationPreferences: DegradationPreferences) {\n    this.degradationPreferences = degradationPreferences;\n    this.sendRequests(); // re-send requests after preferences are set\n  }\n\n  private getDegradedClientRequests() {\n    const clientRequests = cloneDeep(this.clientRequests);\n    const maxFsLimits = [\n      getMaxFs('best'),\n      getMaxFs('large'),\n      getMaxFs('medium'),\n      getMaxFs('small'),\n      getMaxFs('very small'),\n      getMaxFs('thumbnail'),\n    ];\n\n    // reduce max-fs until total macroblocks is below limit\n    for (let i = 0; i < maxFsLimits.length; i += 1) {\n      let totalMacroblocksRequested = 0;\n      Object.entries(clientRequests).forEach(([id, mr]) => {\n        if (mr.codecInfo) {\n          mr.codecInfo.maxFs = Math.min(\n            mr.codecInfo.maxFs || CODEC_DEFAULTS.h264.maxFs,\n            maxFsLimits[i]\n          );\n          // we only consider sources with \"live\" state\n          const slotsWithLiveSource = this.clientRequests[id].receiveSlots.filter(\n            (rs) => rs.sourceState === 'live'\n          );\n          totalMacroblocksRequested += mr.codecInfo.maxFs * slotsWithLiveSource.length;\n        }\n      });\n      if (totalMacroblocksRequested <= this.degradationPreferences.maxMacroblocksLimit) {\n        if (i !== 0) {\n          LoggerProxy.logger.warn(\n            `multistream:mediaRequestManager --> too many streams with high max-fs, frame size will be limited to ${maxFsLimits[i]}`\n          );\n        }\n        break;\n      } else if (i === maxFsLimits.length - 1) {\n        LoggerProxy.logger.warn(\n          `multistream:mediaRequestManager --> even with frame size limited to ${maxFsLimits[i]} you are still requesting too many streams, consider reducing the number of requests`\n        );\n      }\n    }\n\n    return clientRequests;\n  }\n\n  private sendRequests() {\n    const wcmeMediaRequests: WcmeMediaRequest[] = [];\n\n    const clientRequests = this.getDegradedClientRequests();\n    const maxPayloadBitsPerSecond = 10 * 1000 * 1000;\n\n    // map all the client media requests to wcme media requests\n    Object.values(clientRequests).forEach((mr) => {\n      wcmeMediaRequests.push(\n        new WcmeMediaRequest(\n          mr.policyInfo.policy === 'active-speaker'\n            ? Policy.ActiveSpeaker\n            : Policy.ReceiverSelected,\n          mr.policyInfo.policy === 'active-speaker'\n            ? new ActiveSpeakerInfo(\n                mr.policyInfo.priority,\n                mr.policyInfo.crossPriorityDuplication,\n                mr.policyInfo.crossPolicyDuplication,\n                mr.policyInfo.preferLiveVideo\n              )\n            : new ReceiverSelectedInfo(mr.policyInfo.csi),\n          mr.receiveSlots.map((receiveSlot) => receiveSlot.wcmeReceiveSlot),\n          maxPayloadBitsPerSecond,\n          mr.codecInfo && [\n            new WcmeCodecInfo(\n              0x80,\n              new H264Codec(\n                mr.codecInfo.maxFs,\n                mr.codecInfo.maxFps || CODEC_DEFAULTS.h264.maxFps,\n                mr.codecInfo.maxMbps || CODEC_DEFAULTS.h264.maxMbps,\n                mr.codecInfo.maxWidth,\n                mr.codecInfo.maxHeight\n              )\n            ),\n          ]\n        )\n      );\n    });\n\n    this.sendMediaRequestsCallback(wcmeMediaRequests);\n  }\n\n  public addRequest(mediaRequest: MediaRequest, commit = true): MediaRequestId {\n    // eslint-disable-next-line no-plusplus\n    const newId = `${this.counter++}`;\n\n    this.clientRequests[newId] = mediaRequest;\n\n    mediaRequest.receiveSlots.forEach((rs) => {\n      rs.on(ReceiveSlotEvents.SourceUpdate, this.sourceUpdateListener);\n    });\n\n    if (commit) {\n      this.commit();\n    }\n\n    return newId;\n  }\n\n  public cancelRequest(requestId: MediaRequestId, commit = true) {\n    this.clientRequests[requestId]?.receiveSlots.forEach((rs) => {\n      rs.off(ReceiveSlotEvents.SourceUpdate, this.sourceUpdateListener);\n    });\n\n    delete this.clientRequests[requestId];\n\n    if (commit) {\n      this.commit();\n    }\n  }\n\n  public commit() {\n    return this.sendRequests();\n  }\n\n  public reset() {\n    this.clientRequests = {};\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["CODEC_DEFAULTS","h264","maxFs","maxFps","maxMbps","DEBOUNCED_SOURCE_UPDATE_TIME","MediaRequestManager","degradationPreferences","sendMediaRequestsCallback","counter","clientRequests","sourceUpdateListener","commit","bind","debouncedSourceUpdateListener","sendRequests","maxFsLimits","getMaxFs","totalMacroblocksRequested","forEach","id","mr","codecInfo","Math","min","preferredMaxFs","i","slotsWithLiveSource","receiveSlots","filter","rs","sourceState","length","maxMacroblocksLimit","LoggerProxy","logger","warn","wcmeMediaRequests","getDegradedClientRequests","maxPayloadBitsPerSecond","push","WcmeMediaRequest","policyInfo","policy","Policy","ActiveSpeaker","ReceiverSelected","ActiveSpeakerInfo","priority","crossPriorityDuplication","crossPolicyDuplication","preferLiveVideo","ReceiverSelectedInfo","csi","map","receiveSlot","wcmeReceiveSlot","WcmeCodecInfo","H264Codec","maxWidth","maxHeight","mediaRequest","newId","on","ReceiveSlotEvents","SourceUpdate","MaxFsUpdate","requestId","off"],"sources":["mediaRequestManager.ts"],"sourcesContent":["/* eslint-disable require-jsdoc */\nimport {\n  MediaRequest as WcmeMediaRequest,\n  Policy,\n  ActiveSpeakerInfo,\n  ReceiverSelectedInfo,\n  CodecInfo as WcmeCodecInfo,\n  H264Codec,\n} from '@webex/internal-media-core';\nimport {cloneDeep, debounce} from 'lodash';\n\nimport LoggerProxy from '../common/logs/logger-proxy';\n\nimport {ReceiveSlot, ReceiveSlotEvents, ReceiveSlotId} from './receiveSlot';\nimport {getMaxFs} from './remoteMedia';\n\nexport interface ActiveSpeakerPolicyInfo {\n  policy: 'active-speaker';\n  priority: number;\n  crossPriorityDuplication: boolean;\n  crossPolicyDuplication: boolean;\n  preferLiveVideo: boolean;\n}\n\nexport interface ReceiverSelectedPolicyInfo {\n  policy: 'receiver-selected';\n  csi: number;\n}\n\nexport type PolicyInfo = ActiveSpeakerPolicyInfo | ReceiverSelectedPolicyInfo;\n\nexport interface H264CodecInfo {\n  codec: 'h264';\n  maxFs?: number;\n  maxFps?: number;\n  maxMbps?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n}\n\nexport type CodecInfo = H264CodecInfo; // we'll add AV1 here in the future when it's available\n\nexport interface MediaRequest {\n  policyInfo: PolicyInfo;\n  receiveSlots: Array<ReceiveSlot>;\n  codecInfo?: CodecInfo;\n  preferredMaxFs?: number;\n}\n\nexport type MediaRequestId = string;\n\nconst CODEC_DEFAULTS = {\n  h264: {\n    maxFs: 8192,\n    maxFps: 3000,\n    maxMbps: 245760,\n  },\n};\n\nconst DEBOUNCED_SOURCE_UPDATE_TIME = 1000;\n\ntype DegradationPreferences = {\n  maxMacroblocksLimit: number;\n};\n\ntype SendMediaRequestsCallback = (mediaRequests: WcmeMediaRequest[]) => void;\n\nexport class MediaRequestManager {\n  private sendMediaRequestsCallback: SendMediaRequestsCallback;\n\n  private counter: number;\n\n  private clientRequests: {[key: MediaRequestId]: MediaRequest};\n\n  private degradationPreferences: DegradationPreferences;\n\n  private sourceUpdateListener: () => void;\n\n  private debouncedSourceUpdateListener: () => void;\n\n  constructor(\n    degradationPreferences: DegradationPreferences,\n    sendMediaRequestsCallback: SendMediaRequestsCallback\n  ) {\n    this.sendMediaRequestsCallback = sendMediaRequestsCallback;\n    this.counter = 0;\n    this.clientRequests = {};\n    this.degradationPreferences = degradationPreferences;\n    this.sourceUpdateListener = this.commit.bind(this);\n    this.debouncedSourceUpdateListener = debounce(\n      this.sourceUpdateListener,\n      DEBOUNCED_SOURCE_UPDATE_TIME\n    );\n  }\n\n  public setDegradationPreferences(degradationPreferences: DegradationPreferences) {\n    this.degradationPreferences = degradationPreferences;\n    this.sendRequests(); // re-send requests after preferences are set\n  }\n\n  private getDegradedClientRequests() {\n    const clientRequests = cloneDeep(this.clientRequests);\n    const maxFsLimits = [\n      getMaxFs('best'),\n      getMaxFs('large'),\n      getMaxFs('medium'),\n      getMaxFs('small'),\n      getMaxFs('very small'),\n      getMaxFs('thumbnail'),\n    ];\n\n    // reduce max-fs until total macroblocks is below limit\n    for (let i = 0; i < maxFsLimits.length; i += 1) {\n      let totalMacroblocksRequested = 0;\n      Object.entries(clientRequests).forEach(([id, mr]) => {\n        if (mr.codecInfo) {\n          mr.codecInfo.maxFs = Math.min(\n            mr.preferredMaxFs || CODEC_DEFAULTS.h264.maxFs,\n            mr.codecInfo.maxFs || CODEC_DEFAULTS.h264.maxFs,\n            maxFsLimits[i]\n          );\n          // we only consider sources with \"live\" state\n          const slotsWithLiveSource = this.clientRequests[id].receiveSlots.filter(\n            (rs) => rs.sourceState === 'live'\n          );\n          totalMacroblocksRequested += mr.codecInfo.maxFs * slotsWithLiveSource.length;\n        }\n      });\n      if (totalMacroblocksRequested <= this.degradationPreferences.maxMacroblocksLimit) {\n        if (i !== 0) {\n          LoggerProxy.logger.warn(\n            `multistream:mediaRequestManager --> too many streams with high max-fs, frame size will be limited to ${maxFsLimits[i]}`\n          );\n        }\n        break;\n      } else if (i === maxFsLimits.length - 1) {\n        LoggerProxy.logger.warn(\n          `multistream:mediaRequestManager --> even with frame size limited to ${maxFsLimits[i]} you are still requesting too many streams, consider reducing the number of requests`\n        );\n      }\n    }\n\n    return clientRequests;\n  }\n\n  private sendRequests() {\n    const wcmeMediaRequests: WcmeMediaRequest[] = [];\n\n    const clientRequests = this.getDegradedClientRequests();\n    const maxPayloadBitsPerSecond = 10 * 1000 * 1000;\n\n    // map all the client media requests to wcme media requests\n    Object.values(clientRequests).forEach((mr) => {\n      wcmeMediaRequests.push(\n        new WcmeMediaRequest(\n          mr.policyInfo.policy === 'active-speaker'\n            ? Policy.ActiveSpeaker\n            : Policy.ReceiverSelected,\n          mr.policyInfo.policy === 'active-speaker'\n            ? new ActiveSpeakerInfo(\n                mr.policyInfo.priority,\n                mr.policyInfo.crossPriorityDuplication,\n                mr.policyInfo.crossPolicyDuplication,\n                mr.policyInfo.preferLiveVideo\n              )\n            : new ReceiverSelectedInfo(mr.policyInfo.csi),\n          mr.receiveSlots.map((receiveSlot) => receiveSlot.wcmeReceiveSlot),\n          maxPayloadBitsPerSecond,\n          mr.codecInfo && [\n            new WcmeCodecInfo(\n              0x80,\n              new H264Codec(\n                mr.codecInfo.maxFs,\n                mr.codecInfo.maxFps || CODEC_DEFAULTS.h264.maxFps,\n                mr.codecInfo.maxMbps || CODEC_DEFAULTS.h264.maxMbps,\n                mr.codecInfo.maxWidth,\n                mr.codecInfo.maxHeight\n              )\n            ),\n          ]\n        )\n      );\n    });\n\n    this.sendMediaRequestsCallback(wcmeMediaRequests);\n  }\n\n  public addRequest(mediaRequest: MediaRequest, commit = true): MediaRequestId {\n    // eslint-disable-next-line no-plusplus\n    const newId = `${this.counter++}`;\n\n    this.clientRequests[newId] = mediaRequest;\n\n    mediaRequest.receiveSlots.forEach((rs) => {\n      rs.on(ReceiveSlotEvents.SourceUpdate, this.sourceUpdateListener);\n      rs.on(ReceiveSlotEvents.MaxFsUpdate, ({maxFs}) => {\n        mediaRequest.preferredMaxFs = maxFs;\n        this.debouncedSourceUpdateListener();\n      });\n    });\n\n    if (commit) {\n      this.commit();\n    }\n\n    return newId;\n  }\n\n  public cancelRequest(requestId: MediaRequestId, commit = true) {\n    this.clientRequests[requestId]?.receiveSlots.forEach((rs) => {\n      rs.off(ReceiveSlotEvents.SourceUpdate, this.sourceUpdateListener);\n    });\n\n    delete this.clientRequests[requestId];\n\n    if (commit) {\n      this.commit();\n    }\n  }\n\n  public commit() {\n    return this.sendRequests();\n  }\n\n  public reset() {\n    this.clientRequests = {};\n  }\n}\n"],"mappings":"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"}

package/dist/multistream/receiveSlot.js

@@ -25,7 +25,8 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
 function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
 function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
 var ReceiveSlotEvents = {
-  SourceUpdate: 'sourceUpdate'
+  SourceUpdate: 'sourceUpdate',
+  MaxFsUpdate: 'maxFsUpdate'
 };
 exports.ReceiveSlotEvents = ReceiveSlotEvents;
 var receiveSlotCounter = 0;
@@ -95,6 +96,23 @@ var ReceiveSlot = /*#__PURE__*/function (_EventsScope) {
       return (0, _classPrivateFieldGet2.default)(this, _csi);
     }
 
+    /**
+     * Set the max frame size for this slot
+     * @param newFs frame size
+     */
+  }, {
+    key: "setMaxFs",
+    value: function setMaxFs(newFs) {
+      // emit event for media request manager to listen to
+
+      this.emit({
+        file: 'meeting/receiveSlot',
+        function: 'findMemberId'
+      }, ReceiveSlotEvents.MaxFsUpdate, {
+        maxFs: newFs
+      });
+    }
+
     /**
      * Getter for sourceState
      */

package/dist/multistream/receiveSlot.js.map

@@ -1 +1 @@
-{"version":3,"names":["ReceiveSlotEvents","SourceUpdate","receiveSlotCounter","ReceiveSlot","mediaType","mcReceiveSlot","findMemberIdCallback","id","setupEventListeners","scope","file","function","on","WcmeReceiveSlotEvents","state","csi","LoggerProxy","logger","log","undefined","emit","memberId","stream","EventsScope"],"sources":["receiveSlot.ts"],"sourcesContent":["/* eslint-disable valid-jsdoc */\nimport {\n  MediaType,\n  ReceiveSlot as WcmeReceiveSlot,\n  ReceiveSlotEvents as WcmeReceiveSlotEvents,\n  SourceState,\n} from '@webex/internal-media-core';\n\nimport LoggerProxy from '../common/logs/logger-proxy';\nimport EventsScope from '../common/events/events-scope';\n\nexport const ReceiveSlotEvents = {\n  SourceUpdate: 'sourceUpdate',\n};\n\nexport type {SourceState} from '@webex/internal-media-core';\nexport type CSI = number;\nexport type MemberId = string;\nexport type ReceiveSlotId = string;\n\nlet receiveSlotCounter = 0;\n\nexport type FindMemberIdCallback = (csi: CSI) => MemberId | undefined;\n\n/**\n * Class representing a receive slot. A single receive slot is able to receive a single track\n * for example some participant's main video or audio\n */\nexport class ReceiveSlot extends EventsScope {\n  private readonly mcReceiveSlot: WcmeReceiveSlot;\n\n  private readonly findMemberIdCallback: FindMemberIdCallback;\n\n  public readonly id: ReceiveSlotId;\n\n  public readonly mediaType: MediaType;\n\n  #memberId?: MemberId;\n\n  #csi?: CSI;\n\n  #sourceState: SourceState;\n\n  /**\n   * constructor - don't use it directly, you should always use meeting.receiveSlotManager.allocateSlot()\n   * to create any receive slots\n   *\n   * @param {MediaType} mediaType\n   * @param {ReceiveSlot} mcReceiveSlot\n   * @param {FindMemberIdCallback} findMemberIdCallback callback for finding memberId for given CSI\n   */\n  constructor(\n    mediaType: MediaType,\n    mcReceiveSlot: WcmeReceiveSlot,\n    findMemberIdCallback: FindMemberIdCallback\n  ) {\n    super();\n\n    receiveSlotCounter += 1;\n\n    this.findMemberIdCallback = findMemberIdCallback;\n    this.mediaType = mediaType;\n    this.mcReceiveSlot = mcReceiveSlot;\n    this.#sourceState = 'no source';\n    this.id = `r${receiveSlotCounter}`;\n\n    this.setupEventListeners();\n  }\n\n  /**\n   * Getter for memberId\n   */\n  public get memberId() {\n    return this.#memberId;\n  }\n\n  /**\n   * Getter for csi\n   */\n  public get csi() {\n    return this.#csi;\n  }\n\n  /**\n   * Getter for sourceState\n   */\n  public get sourceState() {\n    return this.#sourceState;\n  }\n\n  /**\n   * registers event handlers with the underlying ReceiveSlot\n   */\n  private setupEventListeners() {\n    const scope = {\n      file: 'meeting/receiveSlot',\n      function: 'setupEventListeners',\n    };\n\n    this.mcReceiveSlot.on(\n      WcmeReceiveSlotEvents.SourceUpdate,\n      (state: SourceState, csi?: number) => {\n        LoggerProxy.logger.log(\n          `ReceiveSlot#setupEventListeners --> got source update on receive slot ${this.id}, mediaType=${this.mediaType}, csi=${csi}, state=${state}`\n        );\n        this.#memberId = csi ? this.findMemberIdCallback(csi) : undefined;\n        this.#csi = csi;\n        this.#sourceState = state;\n\n        this.emit(scope, ReceiveSlotEvents.SourceUpdate, {\n          state: this.#sourceState,\n          csi: this.#csi,\n          memberId: this.#memberId,\n        });\n      }\n    );\n  }\n\n  /** Tries to find the member id for this receive slot if it hasn't got one */\n  public findMemberId() {\n    if (this.#memberId === undefined && this.#csi) {\n      this.#memberId = this.findMemberIdCallback(this.#csi);\n\n      if (this.#memberId) {\n        // if we found the memberId, simulate source update so that the client app knows that something's changed\n        this.emit(\n          {\n            file: 'meeting/receiveSlot',\n            function: 'findMemberId',\n          },\n          ReceiveSlotEvents.SourceUpdate,\n          {\n            state: this.#sourceState,\n            csi: this.#csi,\n            memberId: this.#memberId,\n          }\n        );\n      }\n    }\n  }\n\n  /**\n   * The MediaStream object associated with this slot.\n   *\n   * @returns {MediaStream} The MediaStreamTrack.\n   */\n  get stream(): MediaStream {\n    return this.mcReceiveSlot.stream;\n  }\n\n  /**\n   * The underlying WCME receive slot\n   */\n  get wcmeReceiveSlot(): WcmeReceiveSlot {\n    return this.mcReceiveSlot;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AACA;AAOA;AACA;AAAwD;AAAA;AAAA;AAAA;AAEjD,IAAMA,iBAAiB,GAAG;EAC/BC,YAAY,EAAE;AAChB,CAAC;AAAC;AAOF,IAAIC,kBAAkB,GAAG,CAAC;AAAC;AAAA;AAAA;AAI3B;AACA;AACA;AACA;AAHA,IAIaC,WAAW;EAAA;EAAA;EAetB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,qBACEC,SAAoB,EACpBC,aAA8B,EAC9BC,oBAA0C,EAC1C;IAAA;IAAA;IACA;IAAQ;IAAA;IAAA;IAAA;IAAA;MAAA;MAAA;IAAA;IAAA;MAAA;MAAA;IAAA;IAAA;MAAA;MAAA;IAAA;IAERJ,kBAAkB,IAAI,CAAC;IAEvB,MAAKI,oBAAoB,GAAGA,oBAAoB;IAChD,MAAKF,SAAS,GAAGA,SAAS;IAC1B,MAAKC,aAAa,GAAGA,aAAa;IAClC,+FAAoB,WAAW;IAC/B,MAAKE,EAAE,cAAOL,kBAAkB,CAAE;IAElC,MAAKM,mBAAmB,EAAE;IAAC;EAC7B;;EAEA;AACF;AACA;EAFE;IAAA;IAAA,KAGA,eAAsB;MACpB,2CAAO,IAAI;IACb;;IAEA;AACF;AACA;EAFE;IAAA;IAAA,KAGA,eAAiB;MACf,2CAAO,IAAI;IACb;;IAEA;AACF;AACA;EAFE;IAAA;IAAA,KAGA,eAAyB;MACvB,2CAAO,IAAI;IACb;;IAEA;AACF;AACA;EAFE;IAAA;IAAA,OAGA,+BAA8B;MAAA;MAC5B,IAAMC,KAAK,GAAG;QACZC,IAAI,EAAE,qBAAqB;QAC3BC,QAAQ,EAAE;MACZ,CAAC;MAED,IAAI,CAACN,aAAa,CAACO,EAAE,CACnBC,oCAAqB,CAACZ,YAAY,EAClC,UAACa,KAAkB,EAAEC,GAAY,EAAK;QACpCC,oBAAW,CAACC,MAAM,CAACC,GAAG,iFACqD,MAAI,CAACX,EAAE,yBAAe,MAAI,CAACH,SAAS,mBAASW,GAAG,qBAAWD,KAAK,EAC1I;QACD,0CAAI,aAAaC,GAAG,GAAG,MAAI,CAACT,oBAAoB,CAACS,GAAG,CAAC,GAAGI,SAAS;QACjE,0CAAI,QAAQJ,GAAG;QACf,0CAAI,gBAAgBD,KAAK;QAEzB,MAAI,CAACM,IAAI,CAACX,KAAK,EAAET,iBAAiB,CAACC,YAAY,EAAE;UAC/Ca,KAAK,sCAAE,MAAI,eAAa;UACxBC,GAAG,sCAAE,MAAI,OAAK;UACdM,QAAQ,sCAAE,MAAI;QAChB,CAAC,CAAC;MACJ,CAAC,CACF;IACH;;IAEA;EAAA;IAAA;IAAA,OACA,wBAAsB;MACpB,IAAI,wCAAI,iBAAeF,SAAS,wCAAI,IAAI,OAAK,EAAE;QAC7C,wCAAI,aAAa,IAAI,CAACb,oBAAoB,qCAAC,IAAI,QAAM;QAErD,wCAAI,IAAI,cAAY;UAClB;UACA,IAAI,CAACc,IAAI,CACP;YACEV,IAAI,EAAE,qBAAqB;YAC3BC,QAAQ,EAAE;UACZ,CAAC,EACDX,iBAAiB,CAACC,YAAY,EAC9B;YACEa,KAAK,sCAAE,IAAI,eAAa;YACxBC,GAAG,sCAAE,IAAI,OAAK;YACdM,QAAQ,sCAAE,IAAI;UAChB,CAAC,CACF;QACH;MACF;IACF;;IAEA;AACF;AACA;AACA;AACA;EAJE;IAAA;IAAA,KAKA,eAA0B;MACxB,OAAO,IAAI,CAAChB,aAAa,CAACiB,MAAM;IAClC;;IAEA;AACF;AACA;EAFE;IAAA;IAAA,KAGA,eAAuC;MACrC,OAAO,IAAI,CAACjB,aAAa;IAC3B;EAAC;EAAA;AAAA,EA/H8BkB,oBAAW;AAAA"}
+{"version":3,"names":["ReceiveSlotEvents","SourceUpdate","MaxFsUpdate","receiveSlotCounter","ReceiveSlot","mediaType","mcReceiveSlot","findMemberIdCallback","id","setupEventListeners","newFs","emit","file","function","maxFs","scope","on","WcmeReceiveSlotEvents","state","csi","LoggerProxy","logger","log","undefined","memberId","stream","EventsScope"],"sources":["receiveSlot.ts"],"sourcesContent":["/* eslint-disable valid-jsdoc */\nimport {\n  MediaType,\n  ReceiveSlot as WcmeReceiveSlot,\n  ReceiveSlotEvents as WcmeReceiveSlotEvents,\n  SourceState,\n} from '@webex/internal-media-core';\n\nimport LoggerProxy from '../common/logs/logger-proxy';\nimport EventsScope from '../common/events/events-scope';\n\nexport const ReceiveSlotEvents = {\n  SourceUpdate: 'sourceUpdate',\n  MaxFsUpdate: 'maxFsUpdate',\n};\n\nexport type {SourceState} from '@webex/internal-media-core';\nexport type CSI = number;\nexport type MemberId = string;\nexport type ReceiveSlotId = string;\n\nlet receiveSlotCounter = 0;\n\nexport type FindMemberIdCallback = (csi: CSI) => MemberId | undefined;\n\n/**\n * Class representing a receive slot. A single receive slot is able to receive a single track\n * for example some participant's main video or audio\n */\nexport class ReceiveSlot extends EventsScope {\n  private readonly mcReceiveSlot: WcmeReceiveSlot;\n\n  private readonly findMemberIdCallback: FindMemberIdCallback;\n\n  public readonly id: ReceiveSlotId;\n\n  public readonly mediaType: MediaType;\n\n  #memberId?: MemberId;\n\n  #csi?: CSI;\n\n  #sourceState: SourceState;\n\n  /**\n   * constructor - don't use it directly, you should always use meeting.receiveSlotManager.allocateSlot()\n   * to create any receive slots\n   *\n   * @param {MediaType} mediaType\n   * @param {ReceiveSlot} mcReceiveSlot\n   * @param {FindMemberIdCallback} findMemberIdCallback callback for finding memberId for given CSI\n   */\n  constructor(\n    mediaType: MediaType,\n    mcReceiveSlot: WcmeReceiveSlot,\n    findMemberIdCallback: FindMemberIdCallback\n  ) {\n    super();\n\n    receiveSlotCounter += 1;\n\n    this.findMemberIdCallback = findMemberIdCallback;\n    this.mediaType = mediaType;\n    this.mcReceiveSlot = mcReceiveSlot;\n    this.#sourceState = 'no source';\n    this.id = `r${receiveSlotCounter}`;\n\n    this.setupEventListeners();\n  }\n\n  /**\n   * Getter for memberId\n   */\n  public get memberId() {\n    return this.#memberId;\n  }\n\n  /**\n   * Getter for csi\n   */\n  public get csi() {\n    return this.#csi;\n  }\n\n  /**\n   * Set the max frame size for this slot\n   * @param newFs frame size\n   */\n  public setMaxFs(newFs) {\n    // emit event for media request manager to listen to\n\n    this.emit(\n      {\n        file: 'meeting/receiveSlot',\n        function: 'findMemberId',\n      },\n      ReceiveSlotEvents.MaxFsUpdate,\n      {\n        maxFs: newFs,\n      }\n    );\n  }\n\n  /**\n   * Getter for sourceState\n   */\n  public get sourceState() {\n    return this.#sourceState;\n  }\n\n  /**\n   * registers event handlers with the underlying ReceiveSlot\n   */\n  private setupEventListeners() {\n    const scope = {\n      file: 'meeting/receiveSlot',\n      function: 'setupEventListeners',\n    };\n\n    this.mcReceiveSlot.on(\n      WcmeReceiveSlotEvents.SourceUpdate,\n      (state: SourceState, csi?: number) => {\n        LoggerProxy.logger.log(\n          `ReceiveSlot#setupEventListeners --> got source update on receive slot ${this.id}, mediaType=${this.mediaType}, csi=${csi}, state=${state}`\n        );\n        this.#memberId = csi ? this.findMemberIdCallback(csi) : undefined;\n        this.#csi = csi;\n        this.#sourceState = state;\n\n        this.emit(scope, ReceiveSlotEvents.SourceUpdate, {\n          state: this.#sourceState,\n          csi: this.#csi,\n          memberId: this.#memberId,\n        });\n      }\n    );\n  }\n\n  /** Tries to find the member id for this receive slot if it hasn't got one */\n  public findMemberId() {\n    if (this.#memberId === undefined && this.#csi) {\n      this.#memberId = this.findMemberIdCallback(this.#csi);\n\n      if (this.#memberId) {\n        // if we found the memberId, simulate source update so that the client app knows that something's changed\n        this.emit(\n          {\n            file: 'meeting/receiveSlot',\n            function: 'findMemberId',\n          },\n          ReceiveSlotEvents.SourceUpdate,\n          {\n            state: this.#sourceState,\n            csi: this.#csi,\n            memberId: this.#memberId,\n          }\n        );\n      }\n    }\n  }\n\n  /**\n   * The MediaStream object associated with this slot.\n   *\n   * @returns {MediaStream} The MediaStreamTrack.\n   */\n  get stream(): MediaStream {\n    return this.mcReceiveSlot.stream;\n  }\n\n  /**\n   * The underlying WCME receive slot\n   */\n  get wcmeReceiveSlot(): WcmeReceiveSlot {\n    return this.mcReceiveSlot;\n  }\n}\n"],"mappings":"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"}

package/dist/multistream/remoteMedia.js

@@ -96,20 +96,44 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }
 
   /**
-   * 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: "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 {
+        fs = 3600;
+      }
+      (_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$receiveSlot;
+      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',
@@ -184,8 +208,8 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }, {
     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;
     }
 
     /**
@@ -194,8 +218,8 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }, {
     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;
     }
 
     /**
@@ -204,8 +228,8 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }, {
     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;
     }
 
     /**
@@ -214,8 +238,8 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }, {
     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;
     }
 
     /**
@@ -224,8 +248,8 @@ var RemoteMedia = /*#__PURE__*/function (_EventsScope) {
   }, {
     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;
     }
 
     /**

package/dist/multistream/remoteMedia.js.map

@@ -1 +1 @@
-{"version":3,"names":["RemoteMediaEvents","SourceUpdate","ReceiveSlotEvents","Stopped","getMaxFs","paneSize","maxFs","LoggerProxy","logger","warn","remoteMediaCounter","RemoteMedia","receiveSlot","mediaRequestManager","options","setupEventListeners","id","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, SourceState} 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   * 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(): 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, SourceState} 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 {\n      fs = 3600;\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(): 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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"}

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export default Meetings;
 export * as CONSTANTS from "./constants";
 export * as REACTIONS from "./reactions/reactions";
+export { RemoteMedia } from "./multistream/remoteMedia";
 export { default as TriggerProxy } from "./common/events/trigger-proxy";
 import Meetings from "./meetings";

package/dist/types/multistream/mediaRequestManager.d.ts

@@ -25,6 +25,7 @@ export interface MediaRequest {
     policyInfo: PolicyInfo;
     receiveSlots: Array<ReceiveSlot>;
     codecInfo?: CodecInfo;
+    preferredMaxFs?: number;
 }
 export type MediaRequestId = string;
 type DegradationPreferences = {
@@ -37,6 +38,7 @@ export declare class MediaRequestManager {
     private clientRequests;
     private degradationPreferences;
     private sourceUpdateListener;
+    private debouncedSourceUpdateListener;
     constructor(degradationPreferences: DegradationPreferences, sendMediaRequestsCallback: SendMediaRequestsCallback);
     setDegradationPreferences(degradationPreferences: DegradationPreferences): void;
     private getDegradedClientRequests;

package/dist/types/multistream/receiveSlot.d.ts

@@ -2,6 +2,7 @@ import { MediaType, ReceiveSlot as WcmeReceiveSlot, SourceState } from '@webex/i
 import EventsScope from '../common/events/events-scope';
 export declare const ReceiveSlotEvents: {
     SourceUpdate: string;
+    MaxFsUpdate: string;
 };
 export type { SourceState } from '@webex/internal-media-core';
 export type CSI = number;
@@ -35,6 +36,11 @@ export declare class ReceiveSlot extends EventsScope {
      * Getter for csi
      */
     get csi(): number;
+    /**
+     * Set the max frame size for this slot
+     * @param newFs frame size
+     */
+    setMaxFs(newFs: any): void;
     /**
      * Getter for sourceState
      */

package/dist/types/multistream/remoteMedia.d.ts

@@ -37,6 +37,13 @@ export declare class RemoteMedia extends EventsScope {
      * @param options
      */
     constructor(receiveSlot: ReceiveSlot, mediaRequestManager: MediaRequestManager, options?: Options);
+    /**
+     * 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
+     */
+    setSizeHint(width: any, height: any): void;
     /**
      * Invalidates the remote media by clearing the reference to a receive slot and
      * cancelling the media request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/plugin-meetings",
-  "version": "3.0.0-beta.38",
+  "version": "3.0.0-beta.39",
   "description": "",
   "license": "Cisco EULA (https://www.cisco.com/c/en/us/products/end-user-license-agreement.html)",
   "contributors": [
@@ -32,12 +32,12 @@
     "build": "yarn run -T tsc --declaration true --declarationDir ./dist/types"
   },
   "devDependencies": {
-    "@webex/plugin-meetings": "3.0.0-beta.38",
-    "@webex/test-helper-chai": "3.0.0-beta.38",
-    "@webex/test-helper-mocha": "3.0.0-beta.38",
-    "@webex/test-helper-mock-webex": "3.0.0-beta.38",
-    "@webex/test-helper-retry": "3.0.0-beta.38",
-    "@webex/test-helper-test-users": "3.0.0-beta.38",
+    "@webex/plugin-meetings": "3.0.0-beta.39",
+    "@webex/test-helper-chai": "3.0.0-beta.39",
+    "@webex/test-helper-mocha": "3.0.0-beta.39",
+    "@webex/test-helper-mock-webex": "3.0.0-beta.39",
+    "@webex/test-helper-retry": "3.0.0-beta.39",
+    "@webex/test-helper-test-users": "3.0.0-beta.39",
     "chai": "^4.3.4",
     "chai-as-promised": "^7.1.1",
     "jsdom-global": "3.0.2",
@@ -46,18 +46,18 @@
     "typescript": "^4.7.4"
   },
   "dependencies": {
-    "@webex/common": "3.0.0-beta.38",
+    "@webex/common": "3.0.0-beta.39",
     "@webex/internal-media-core": "1.35.2",
-    "@webex/internal-plugin-conversation": "3.0.0-beta.38",
-    "@webex/internal-plugin-device": "3.0.0-beta.38",
-    "@webex/internal-plugin-llm": "3.0.0-beta.38",
-    "@webex/internal-plugin-mercury": "3.0.0-beta.38",
-    "@webex/internal-plugin-metrics": "3.0.0-beta.38",
-    "@webex/internal-plugin-support": "3.0.0-beta.38",
-    "@webex/internal-plugin-user": "3.0.0-beta.38",
-    "@webex/plugin-people": "3.0.0-beta.38",
-    "@webex/plugin-rooms": "3.0.0-beta.38",
-    "@webex/webex-core": "3.0.0-beta.38",
+    "@webex/internal-plugin-conversation": "3.0.0-beta.39",
+    "@webex/internal-plugin-device": "3.0.0-beta.39",
+    "@webex/internal-plugin-llm": "3.0.0-beta.39",
+    "@webex/internal-plugin-mercury": "3.0.0-beta.39",
+    "@webex/internal-plugin-metrics": "3.0.0-beta.39",
+    "@webex/internal-plugin-support": "3.0.0-beta.39",
+    "@webex/internal-plugin-user": "3.0.0-beta.39",
+    "@webex/plugin-people": "3.0.0-beta.39",
+    "@webex/plugin-rooms": "3.0.0-beta.39",
+    "@webex/webex-core": "3.0.0-beta.39",
     "ampersand-collection": "^2.0.2",
     "bowser": "^2.11.0",
     "btoa": "^1.2.1",

package/src/index.js

@@ -13,4 +13,6 @@ export default Meetings;
 export * as CONSTANTS from './constants';
 export * as REACTIONS from './reactions/reactions';
 
+export {RemoteMedia} from './multistream/remoteMedia';
+
 export {default as TriggerProxy} from './common/events/trigger-proxy';

package/src/multistream/mediaRequestManager.ts

@@ -7,7 +7,7 @@ import {
   CodecInfo as WcmeCodecInfo,
   H264Codec,
 } from '@webex/internal-media-core';
-import {cloneDeep} from 'lodash';
+import {cloneDeep, debounce} from 'lodash';
 
 import LoggerProxy from '../common/logs/logger-proxy';
 
@@ -44,6 +44,7 @@ export interface MediaRequest {
   policyInfo: PolicyInfo;
   receiveSlots: Array<ReceiveSlot>;
   codecInfo?: CodecInfo;
+  preferredMaxFs?: number;
 }
 
 export type MediaRequestId = string;
@@ -56,6 +57,8 @@ const CODEC_DEFAULTS = {
   },
 };
 
+const DEBOUNCED_SOURCE_UPDATE_TIME = 1000;
+
 type DegradationPreferences = {
   maxMacroblocksLimit: number;
 };
@@ -73,6 +76,8 @@ export class MediaRequestManager {
 
   private sourceUpdateListener: () => void;
 
+  private debouncedSourceUpdateListener: () => void;
+
   constructor(
     degradationPreferences: DegradationPreferences,
     sendMediaRequestsCallback: SendMediaRequestsCallback
@@ -82,6 +87,10 @@ export class MediaRequestManager {
     this.clientRequests = {};
     this.degradationPreferences = degradationPreferences;
     this.sourceUpdateListener = this.commit.bind(this);
+    this.debouncedSourceUpdateListener = debounce(
+      this.sourceUpdateListener,
+      DEBOUNCED_SOURCE_UPDATE_TIME
+    );
   }
 
   public setDegradationPreferences(degradationPreferences: DegradationPreferences) {
@@ -106,6 +115,7 @@ export class MediaRequestManager {
       Object.entries(clientRequests).forEach(([id, mr]) => {
         if (mr.codecInfo) {
           mr.codecInfo.maxFs = Math.min(
+            mr.preferredMaxFs || CODEC_DEFAULTS.h264.maxFs,
             mr.codecInfo.maxFs || CODEC_DEFAULTS.h264.maxFs,
             maxFsLimits[i]
           );
@@ -183,6 +193,10 @@ export class MediaRequestManager {
 
     mediaRequest.receiveSlots.forEach((rs) => {
       rs.on(ReceiveSlotEvents.SourceUpdate, this.sourceUpdateListener);
+      rs.on(ReceiveSlotEvents.MaxFsUpdate, ({maxFs}) => {
+        mediaRequest.preferredMaxFs = maxFs;
+        this.debouncedSourceUpdateListener();
+      });
     });
 
     if (commit) {

package/src/multistream/receiveSlot.ts

@@ -11,6 +11,7 @@ import EventsScope from '../common/events/events-scope';
 
 export const ReceiveSlotEvents = {
   SourceUpdate: 'sourceUpdate',
+  MaxFsUpdate: 'maxFsUpdate',
 };
 
 export type {SourceState} from '@webex/internal-media-core';
@@ -81,6 +82,25 @@ export class ReceiveSlot extends EventsScope {
     return this.#csi;
   }
 
+  /**
+   * Set the max frame size for this slot
+   * @param newFs frame size
+   */
+  public setMaxFs(newFs) {
+    // emit event for media request manager to listen to
+
+    this.emit(
+      {
+        file: 'meeting/receiveSlot',
+        function: 'findMemberId',
+      },
+      ReceiveSlotEvents.MaxFsUpdate,
+      {
+        maxFs: newFs,
+      }
+    );
+  }
+
   /**
    * Getter for sourceState
    */

package/src/multistream/remoteMedia.ts

@@ -102,6 +102,29 @@ export class RemoteMedia extends EventsScope {
     this.id = `RM${remoteMediaCounter}-${this.receiveSlot.id}`;
   }
 
+  /**
+   * 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
+   */
+  public setSizeHint(width, height) {
+    // only base on height for now
+    let fs: number;
+
+    if (height < 135) {
+      fs = 60;
+    } else if (height < 270) {
+      fs = 240;
+    } else if (height < 540) {
+      fs = 920;
+    } else {
+      fs = 3600;
+    }
+
+    this.receiveSlot?.setMaxFs(fs);
+  }
+
   /**
    * Invalidates the remote media by clearing the reference to a receive slot and
    * cancelling the media request.

package/test/unit/spec/multistream/mediaRequestManager.ts

@@ -3,6 +3,7 @@ import {ReceiveSlot} from '@webex/plugin-meetings/src/multistream/receiveSlot';
 import sinon from 'sinon';
 import {assert} from '@webex/test-helper-chai';
 import {getMaxFs} from '@webex/plugin-meetings/src/multistream/remoteMedia';
+import FakeTimers from '@sinonjs/fake-timers';
 
 type ExpectedActiveSpeaker = {
   policy: 'active-speaker';
@@ -728,4 +729,41 @@ describe('MediaRequestManager', () => {
       },
     ]);
   });
+
+  it('respects the preferredMaxFs if set', () => {
+    sendMediaRequestsCallback.resetHistory();
+    const clock = FakeTimers.install({now: Date.now()});
+
+    addActiveSpeakerRequest(255, fakeReceiveSlots.slice(0, 10), getMaxFs('large'), true);
+
+    sendMediaRequestsCallback.resetHistory();
+
+
+    const maxFsHandlerCall = fakeReceiveSlots[0].on.getCall(1);
+
+    const maxFsHandler = maxFsHandlerCall.args[1];
+    const eventName = maxFsHandlerCall.args[0];
+
+    assert.equal(eventName, 'maxFsUpdate');
+
+    const preferredFrameSize = 100;
+
+    maxFsHandler({maxFs: preferredFrameSize});
+
+    clock.tick(999);
+
+    assert.notCalled(sendMediaRequestsCallback);
+
+    clock.tick(1);
+
+    checkMediaRequestsSent([
+      {
+        policy: 'active-speaker',
+        priority: 255,
+        receiveSlots: fakeWcmeSlots.slice(0, 10),
+        maxFs: preferredFrameSize,
+      },
+    ]);
+  });
+
 });

package/test/unit/spec/multistream/receiveSlot.ts

@@ -133,4 +133,23 @@ describe('ReceiveSlot', () => {
       assert.notCalled(findMemberIdCallbackStub);
     });
   });
+
+  describe('setMaxFs()', () => {
+    it('emits the correct event', () => {
+      sinon.stub(receiveSlot, 'emit');
+      receiveSlot.setMaxFs(100);
+
+      assert.calledOnceWithExactly(
+        receiveSlot.emit,
+        {
+          file: 'meeting/receiveSlot',
+          function: 'findMemberId',
+        },
+        ReceiveSlotEvents.MaxFsUpdate,
+        {
+          maxFs: 100,
+        }
+      );
+    })
+  });
 });

package/test/unit/spec/multistream/remoteMedia.ts

@@ -6,6 +6,7 @@ import {RemoteMedia, RemoteMediaEvents} from '@webex/plugin-meetings/src/multist
 import {ReceiveSlotEvents} from '@webex/plugin-meetings/src/multistream/receiveSlot';
 import sinon from 'sinon';
 import {assert} from '@webex/test-helper-chai';
+import { forEach } from 'lodash';
 
 describe('RemoteMedia', () => {
   let remoteMedia;
@@ -21,6 +22,7 @@ describe('RemoteMedia', () => {
     fakeReceiveSlot.csi = 999;
     fakeReceiveSlot.sourceState = 'avatar';
     fakeReceiveSlot.stream = fakeStream;
+    fakeReceiveSlot.setMaxFs = sinon.stub();
 
     fakeMediaRequestManager = {
       addRequest: sinon.stub(),
@@ -222,4 +224,30 @@ describe('RemoteMedia', () => {
       });
     });
   });
+
+  describe('setSizeHint()', () => {
+
+    it('works if the receive slot is undefined', () => {
+      remoteMedia.receiveSlot = undefined;
+      remoteMedia.setSizeHint(100, 100);
+    });
+
+    forEach(
+      [
+        {height: 134, fs: 60},
+        {height: 135, fs: 240},
+        {height: 269, fs: 240},
+        {height: 270, fs: 920},
+        {height: 539, fs: 920},
+        {height: 540, fs: 3600},
+      ],
+      ({height, fs}) => {
+        it(`sets the max fs to ${fs} correctly when height is ${height}`, () => {
+          remoteMedia.setSizeHint(100, height);
+
+          assert.calledOnceWithExactly(fakeReceiveSlot.setMaxFs, fs);
+        });
+      }
+    );
+  });
 });