fcr-core 3.8.2 → 3.9.0-alpha

package/lib/index.d.ts

@@ -1,3 +1,4 @@
-export type { FcrCoreEngineConfig, FcrDualVideoStreamConfig, FcrDesktopMediaControl, FcrDesktopMediaObserver, FcrMobileMediaControl, FcrMobileMediaObserver, FcrMonitorControl, FcrMonitorObserver, FcrBaseRoomControl, FcrRoomObserver, FcrUserControl, FcrUserObserver, FcrStreamControl, FcrStreamObserver, FcrPrivilegeControl, FcrPermission, FcrBoardMainWindow, FcrBoardMainWindowObserver, FcrColor, } from './type';
-export { FcrStreamLatencyLevel, FcrPermissionAction, FcrPrivilegeUserRole, FcrUserRole, FcrStreamState, FcrRegion, FcrStreamType, FcrUserUpdatedReason, FcrRoomConnectorType, FcrVideoSourceType, FcrAudioSourceType, FcrMediaSourceState, FcrVideoRenderMode, FcrVideoStreamType, FcrCapability, FcrAiDenoiseLevel, FcrStreamPrivilegeOperation, FcrStreamPrivilegeVideoSourceType, FcrStreamPrivilegeAudioSourceType, FcrConnectionState, FcrCoreEngine, registerPlugin, FcrBoardToolType, FcrBoardShape, } from './type';
+export type { FcrDesktopMediaControl, FcrDesktopMediaObserver, FcrMobileMediaControl, FcrMobileMediaObserver, FcrMonitorControl, FcrMonitorObserver, FcrBaseRoomControl, FcrRoomObserver, FcrUserControl, FcrUserObserver, FcrStreamControl, FcrStreamObserver, FcrPrivilegeControl, FcrPermission, FcrBoardMainWindow, FcrBoardMainWindowObserver, FcrColor, } from './type';
+export { FcrStreamLatencyLevel, FcrPermissionAction, FcrPrivilegeUserRole, FcrUserRole, FcrStreamState, FcrRegion, FcrStreamType, FcrUserUpdatedReason, FcrRoomConnectorType, FcrVideoSourceType, FcrAudioSourceType, FcrMediaSourceState, FcrVideoRenderMode, FcrVideoStreamType, FcrCapability, FcrAiDenoiseLevel, FcrStreamPrivilegeOperation, FcrStreamPrivilegeVideoSourceType, FcrStreamPrivilegeAudioSourceType, FcrConnectionState, registerPlugin, FcrBoardToolType, FcrBoardShape, FcrCoreEngineConfig, FcrVideoEncoderConfig, FcrDualVideoStreamConfig, } from './type';
+export { FcrCoreEngineImpl as FcrCoreEngine } from './engine';
 export { FcrError } from './type';

package/lib/index.js

@@ -42,7 +42,19 @@ Object.defineProperty(exports, "FcrConnectionState", {
 Object.defineProperty(exports, "FcrCoreEngine", {
   enumerable: true,
   get: function () {
-    return _type.FcrCoreEngine;
+    return _engine.FcrCoreEngineImpl;
+  }
+});
+Object.defineProperty(exports, "FcrCoreEngineConfig", {
+  enumerable: true,
+  get: function () {
+    return _type.FcrCoreEngineConfig;
+  }
+});
+Object.defineProperty(exports, "FcrDualVideoStreamConfig", {
+  enumerable: true,
+  get: function () {
+    return _type.FcrDualVideoStreamConfig;
   }
 });
 Object.defineProperty(exports, "FcrError", {
@@ -129,6 +141,12 @@ Object.defineProperty(exports, "FcrUserUpdatedReason", {
     return _type.FcrUserUpdatedReason;
   }
 });
+Object.defineProperty(exports, "FcrVideoEncoderConfig", {
+  enumerable: true,
+  get: function () {
+    return _type.FcrVideoEncoderConfig;
+  }
+});
 Object.defineProperty(exports, "FcrVideoRenderMode", {
   enumerable: true,
   get: function () {
@@ -153,4 +171,5 @@ Object.defineProperty(exports, "registerPlugin", {
     return _type.registerPlugin;
   }
 });
-var _type = require("./type");
+var _type = require("./type");
+var _engine = require("./engine");

package/lib/media-control/desktop.js

@@ -28,7 +28,7 @@ var _imports = require("../imports");
 var _schema = require("../schema");
 var _validateParams = _interopRequireDefault(require("../utilities/validate-params"));
 var _logger = require("../utilities/logger");
-let _initProto, _getCameraTrackDecs, _getMicrophoneTrackDecs, _getScreenTrackDecs, _getLoopbackTrackDecs, _setSelectedSpeakerDecs, _startSelectedSpeakerTestDecs, _isCapabilitySupportedDecs, _adjustOutputVolumeDecs, _setSelectedSpeakerVolumeDecs;
+let _initProto, _getCameraTrackDecs, _getMicrophoneTrackDecs, _getScreenTrackDecs, _getLoopbackTrackDecs, _setSelectedSpeakerDecs, _startSelectedSpeakerTestDecs, _stopSelectedSpeakerTestDecs, _isCapabilitySupportedDecs, _adjustOutputVolumeDecs, _setSelectedSpeakerVolumeDecs, _observeSystemSelectedSpeakerChangedDecs, _observeSystemSelectedMicrophoneChangedDecs, _disableAGCDecs, _enableAGCDecs;
 function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, t, e)]; } }; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
@@ -39,16 +39,16 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
  */
 class FcrDesktopMediaControlImpl {
   static {
-    [_initProto] = _applyDecs(this, [[_imports.trace, 2, "getLoopbackList"], [_imports.trace, 2, "getCameraList"], [_imports.trace, 2, "getMicrophoneList"], [_imports.trace, 2, "getSpeakerList"], [_imports.trace, 2, "getSystemSelectedMicrophone"], [_imports.trace, 2, "getSystemSelectedSpeaker"], [_imports.trace, 2, "getWindowList"], [_imports.trace, 2, "getDisplayList"], [_getCameraTrackDecs, 2, "getCameraTrack"], [_getMicrophoneTrackDecs, 2, "getMicrophoneTrack"], [_getScreenTrackDecs, 2, "getScreenTrack"], [_getLoopbackTrackDecs, 2, "getLoopbackTrack"], [_setSelectedSpeakerDecs, 2, "setSelectedSpeaker"], [_startSelectedSpeakerTestDecs, 2, "startSelectedSpeakerTest"], [_imports.trace, 2, "stopSelectedSpeakerTest"], [_isCapabilitySupportedDecs, 2, "isCapabilitySupported"], [_adjustOutputVolumeDecs, 2, "adjustOutputVolume"], [_setSelectedSpeakerVolumeDecs, 2, "setSelectedSpeakerVolume"], [_imports.trace, 2, "getSelectedSpeakerVolume"], [_imports.trace, 2, "observeSystemSelectedSpeakerChanged"], [_imports.trace, 2, "observeSystemSelectedMicrophoneChanged"], [_imports.trace, 2, "disableAGC"], [_imports.trace, 2, "enableAGC"]], []).e;
+    [_initProto] = _applyDecs(this, [[_imports.trace, 2, "getLoopbackList"], [_imports.trace, 2, "getCameraList"], [_imports.trace, 2, "getMicrophoneList"], [_imports.trace, 2, "getSpeakerList"], [_imports.trace, 2, "getSystemSelectedMicrophone"], [_imports.trace, 2, "getSystemSelectedSpeaker"], [_imports.trace, 2, "getWindowList"], [_imports.trace, 2, "getDisplayList"], [_getCameraTrackDecs, 2, "getCameraTrack"], [_getMicrophoneTrackDecs, 2, "getMicrophoneTrack"], [_getScreenTrackDecs, 2, "getScreenTrack"], [_getLoopbackTrackDecs, 2, "getLoopbackTrack"], [_setSelectedSpeakerDecs, 2, "setSelectedSpeaker"], [_startSelectedSpeakerTestDecs, 2, "startSelectedSpeakerTest"], [_stopSelectedSpeakerTestDecs, 2, "stopSelectedSpeakerTest"], [_isCapabilitySupportedDecs, 2, "isCapabilitySupported"], [_adjustOutputVolumeDecs, 2, "adjustOutputVolume"], [_setSelectedSpeakerVolumeDecs, 2, "setSelectedSpeakerVolume"], [_imports.trace, 2, "getSelectedSpeakerVolume"], [_observeSystemSelectedSpeakerChangedDecs, 2, "observeSystemSelectedSpeakerChanged"], [_observeSystemSelectedMicrophoneChangedDecs, 2, "observeSystemSelectedMicrophoneChanged"], [_disableAGCDecs, 2, "disableAGC"], [_enableAGCDecs, 2, "enableAGC"]], []).e;
   }
-  [(_getCameraTrackDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _getMicrophoneTrackDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _getScreenTrackDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _getLoopbackTrackDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _setSelectedSpeakerDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _startSelectedSpeakerTestDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _isCapabilitySupportedDecs = [_imports.trace, (0, _validateParams.default)(_schema.fcrCapabilitySchema)], _adjustOutputVolumeDecs = [_imports.trace, (0, _validateParams.default)(_schema.numberSchema)], _setSelectedSpeakerVolumeDecs = [_imports.trace, (0, _validateParams.default)(_schema.numberSchema)], "logger")] = (_initProto(this), (0, _logger.createLogger)({
+  [(_getCameraTrackDecs = [(0, _imports.trace)(['deviceId']), (0, _validateParams.default)(_schema.stringSchema)], _getMicrophoneTrackDecs = [(0, _imports.trace)(['deviceId']), (0, _validateParams.default)(_schema.stringSchema)], _getScreenTrackDecs = [(0, _imports.trace)(['sourceId']), (0, _validateParams.default)(_schema.stringSchema)], _getLoopbackTrackDecs = [(0, _imports.trace)(['sourceId']), (0, _validateParams.default)(_schema.stringSchema)], _setSelectedSpeakerDecs = [(0, _imports.trace)(['deviceId'], true), (0, _validateParams.default)(_schema.stringSchema)], _startSelectedSpeakerTestDecs = [(0, _imports.trace)(['url'], true), (0, _validateParams.default)(_schema.stringSchema)], _stopSelectedSpeakerTestDecs = (0, _imports.trace)(true), _isCapabilitySupportedDecs = [(0, _imports.trace)(['capability']), (0, _validateParams.default)(_schema.fcrCapabilitySchema)], _adjustOutputVolumeDecs = [(0, _imports.trace)(['volume'], true), (0, _validateParams.default)(_schema.numberSchema)], _setSelectedSpeakerVolumeDecs = [(0, _imports.trace)(['volume'], true), (0, _validateParams.default)(_schema.numberSchema)], _observeSystemSelectedSpeakerChangedDecs = (0, _imports.trace)(true), _observeSystemSelectedMicrophoneChangedDecs = (0, _imports.trace)(true), _disableAGCDecs = (0, _imports.trace)(true), _enableAGCDecs = (0, _imports.trace)(true), "logger")] = (_initProto(this), (0, _logger.createLogger)({
     prefix: 'FcrDesktopMediaControlImpl'
   }));
   _observable = new _imports.AgoraObservable();
-  _cameraLogObserver = (0, _logger.generateLogObserver)(this.logger, ['onCameraStateUpdated']);
-  _microphoneLogObserver = (0, _logger.generateLogObserver)(this.logger, ['onMicrophoneStateUpdated']);
-  _screenLogObserver = (0, _logger.generateLogObserver)(this.logger, ['onScreenCaptureStateUpdated']);
-  _loopbackLogObserver = (0, _logger.generateLogObserver)(this.logger, ['onLoopbackRecordingStateUpdated']);
+  _cameraLogObserver = (0, _logger.generateLogObserver)(this.logger, [['onCameraStateUpdated', ['deviceId', 'state']]]);
+  _microphoneLogObserver = (0, _logger.generateLogObserver)(this.logger, [['onMicrophoneStateUpdated', ['deviceId', 'state']]]);
+  _screenLogObserver = (0, _logger.generateLogObserver)(this.logger, [['onScreenCaptureStateUpdated', ['sourceId', 'state']]]);
+  _loopbackLogObserver = (0, _logger.generateLogObserver)(this.logger, [['onLoopbackRecordingStateUpdated', ['deviceId', 'state']]]);
   constructor(mediaControl) {
     this._mediaControl = mediaControl;
     this._mediaControl.addObserver({
@@ -138,22 +138,22 @@ class FcrDesktopMediaControlImpl {
     return track;
   }
   setSelectedSpeaker(deviceId) {
-    this._mediaControl.setSelectedSpeaker(deviceId);
+    return this._mediaControl.setSelectedSpeaker(deviceId);
   }
   startSelectedSpeakerTest(url) {
-    this._mediaControl.startSpeakerTest(url);
+    return this._mediaControl.startSpeakerTest(url);
   }
   stopSelectedSpeakerTest() {
-    this._mediaControl.stopSpeakerTest();
+    return this._mediaControl.stopSpeakerTest();
   }
   isCapabilitySupported(capability) {
     return this._mediaControl.isCapabilitySupported(capability);
   }
   adjustOutputVolume(volume) {
-    this._mediaControl.adjustAudioOutputVolume(volume);
+    return this._mediaControl.adjustAudioOutputVolume(volume);
   }
   setSelectedSpeakerVolume(volume) {
-    this._mediaControl.setSelectedSpeakerVolume(volume);
+    return this._mediaControl.setSelectedSpeakerVolume(volume);
   }
   getSelectedSpeakerVolume() {
     return this._mediaControl.getSelectedSpeakerVolume();

package/lib/media-control/mobile.js

@@ -127,6 +127,10 @@ class FcrMobileMediaControlImpl {
   stopScreenCapture() {
     this._mediaControl.getScreenTrack(this._screenDeviceName).stop();
   }
+  startScreenCaptureWithParams(params) {
+    this._mediaControl.getScreenTrack(this._screenDeviceName).setCaptureParams(params);
+    this._mediaControl.getScreenTrack(this._screenDeviceName).start(_imports.AgoraRteScreenCaptureType.SCREEN, []);
+  }
   getScreenCaptureState() {
     return this._mediaControl.getScreenTrack(this._screenDeviceName).getState();
   }

package/lib/media-control/type.d.ts

@@ -118,14 +118,6 @@ export type FcrAudioRawDataConfig = AgoraRteAudioRawDataConfig;
 export type FcrScreenCaptureParams = AgoraRteScreenCaptureParams;
 export type FcrCameraCaptureParams = AgoraRteCameraCaptureParams;
 export interface FcrAudioEffectEnhancer {
-    /**
-     * Enables the AI denoiser for the audio track.
-     */
-    enableAiDenoiser(): void;
-    /**
-     * Disables the AI denoiser for the audio track.
-     */
-    disableAiDenoiser(): void;
     /**
      * Sets the AI denoiser level for the audio track.
      * @param level The AI denoiser level to set.
@@ -140,13 +132,13 @@ export interface FcrAudioEffectEnhancer {
      */
     disableHiFiMode(): void;
     /**
-     * Enables echo cancellation for the audio track.
+     * Enables AEC for the audio track.
      */
-    enableEchoCancellation(): void;
+    enableAEC(): void;
     /**
-     * Disables echo cancellation for the audio track.
+     * Disables AEC for the audio track.
      */
-    disableEchoCancellation(): void;
+    disableAEC(): void;
     /**
      * Enables stereo mode for the audio track.
      */
@@ -280,35 +272,35 @@ export interface FcrCameraTrack {
     /**
      * Starts the camera.
      */
-    start(): void;
+    start(): number;
     /**
      * Stops the camera.
      */
-    stop(): void;
+    stop(): number;
     /**
      * Starts the camera test.
      */
-    startTest(): void;
+    startTest(): number;
     /**
      * Stops the camera test.
      */
-    stopTest(): void;
+    stopTest(): number;
     /**
      * Starts the camera preview with the specified configuration and view.
      * @param config The configuration for the video render.
      * @param view The HTML element to render the video on.
      */
-    startPreview(config: FcrRenderConfig, view: FcrRenderView): void;
+    startPreview(config: FcrRenderConfig, view: FcrRenderView): number;
     /**
      * Stops the camera preview.
      * @param view The HTML element to render the video on.
      */
-    stopPreview(view: FcrRenderView): void;
+    stopPreview(view: FcrRenderView): number;
     /**
      * Sets the capture parameters for the camera.
      * @param params The parameters for the video capture.
      */
-    setCaptureParams(params: FcrCameraCaptureParams): void;
+    setCaptureParams(params: FcrCameraCaptureParams): number;
     /**
      * Retrieves the video effect enhancer.
      *
@@ -321,7 +313,7 @@ export interface FcrCameraTrack {
      * Sets the video orientation for the camera.
      * @param orientation orientation of the camera video.
      */
-    setVideoOrientation(orientation: FcrVideoOrientation): void;
+    setVideoOrientation(orientation: FcrVideoOrientation): number;
     /**
      *
      * @param observer
@@ -351,16 +343,16 @@ export interface FcrLoopbackTrack {
     /**
      * Starts the loopback audio track.
      */
-    start(): void;
+    start(): number;
     /**
      * Stops the loopback audio track.
      */
-    stop(): void;
+    stop(): number;
     /**
      * Updates the signal volume for the loopback audio track.
      * @param volume Range from 0 to 400. 100 is the default volume.
      */
-    adjustVolume(volume: number): void;
+    adjustVolume(volume: number): number;
     /**
      *
      * @param observer
@@ -404,25 +396,25 @@ export interface FcrMicrophoneTrack {
      * - {@link startTest} should be called after this method when you are not in a channel,
      * otherwise onLocalMicrophoneAudioStateUpdated may not be triggered in electron.
      */
-    start(): void;
+    start(): number;
     /**
      * Stops the microphone audio track for the specified device.
      */
-    stop(): void;
+    stop(): number;
     /**
      * Starts the microphone test for the specified device.
      * @param interval The interval for the microphone test.
      */
-    startTest(interval: number): void;
+    startTest(interval: number): number;
     /**
      * Stops the microphone test for the specified device.
      */
-    stopTest(): void;
+    stopTest(): number;
     /**
      * Updates the signal volume for the microphone audio track.
      * @param volume Range from 0 to 400. 100 is the default volume.
      */
-    adjustVolume(volume: number): void;
+    adjustVolume(volume: number): number;
     /**
      * Retrieves the audio effect enhancer.
      *
@@ -455,27 +447,33 @@ export interface FcrScreenTrack {
      * @param config The configuration for the video render.
      * @param view The HTML element to render the video on.
      */
-    startPreview(config: FcrRenderConfig, view: FcrRenderView): void;
+    startPreview(config: FcrRenderConfig, view: FcrRenderView): number;
     /**
      * Stops the screen preview.
      * @param view The HTML element to render the video on.
      */
-    stopPreview(view: FcrRenderView): void;
+    stopPreview(view: FcrRenderView): number;
     /**
      * Sets the capture parameters for the screen.
      * @param params The parameters for the video capture.
      */
-    setCaptureParams(params: FcrScreenCaptureParams): void;
+    setCaptureParams(params: FcrScreenCaptureParams): number;
     /**
      * Starts the screen video track with the specified type and parameters.
      * @param type The type of screen capture.
      * @param excludeWindowList The list of window IDs to exclude from the screen capture.
      */
-    start(type: FcrScreenCaptureType, excludeWindowList: string[]): void;
+    start(type: FcrScreenCaptureType, excludeWindowList: string[]): number;
     /**
      * Stops the screen video track for the specified source.
      */
-    stop(): void;
+    stop(): number;
+    /**
+     * Updates the list of window to exclude from the screen capture.
+     * @param excludeWindowList The list of window to exclude.
+     * @returns A number indicating the result of the update operation.
+     */
+    updateExcludeWindows(excludeWindowList: string[]): number;
     /**
      * Adds an observer for the screen video track.
      * @param observer The observer for the screen video track.
@@ -642,6 +640,7 @@ export interface FcrMobileMediaControl {
     stopCameraPreviewOnAllCanvas(): void;
     isCapabilitySupported(capability: FcrCapability): boolean;
     startScreenCapture(excludeWindowList: string[]): void;
+    startScreenCaptureWithParams(params: FcrScreenCaptureParams): void;
     stopScreenCapture(): void;
     getScreenCaptureState(): FcrMediaSourceState;
     startLoopbackRecording(): void;

package/lib/monitor-control/index.js

@@ -22,7 +22,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.FcrMonitorControlImpl = void 0;
 var _imports = require("../imports");
-let _initProto;
+let _initProto, _uploadEventDecs;
 function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, t, e)]; } }; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
@@ -33,9 +33,9 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
  */
 class FcrMonitorControlImpl {
   static {
-    [_initProto] = _applyDecs(this, [[_imports.trace, 2, "uploadEvent"]], []).e;
+    [_initProto] = _applyDecs(this, [[_uploadEventDecs, 2, "uploadEvent"]], []).e;
   }
-  _monitor = void _initProto(this);
+  [(_uploadEventDecs = (0, _imports.trace)(['event']), "_monitor")] = void _initProto(this);
   constructor(engine, _config) {
     this._config = _config;
     this._monitor = engine.getMonitor();

package/lib/peer-session/index.js

@@ -42,7 +42,7 @@ class FcrPeerSessionControlImpl {
     [_initProto] = _applyDecs(this, [[_startPeerSessionDecs, 2, "startPeerSession"], [_stopPeerSessionDecs, 2, "stopPeerSession"], [_acceptPeerSessionDecs, 2, "acceptPeerSession"], [_rejectPeerSessionDecs, 2, "rejectPeerSession"]], []).e;
   }
   //@internal
-  [(_startPeerSessionDecs = [_imports.trace, (0, _validateParams.default)(_schema.fcrPeerSessionParamsSchema)], _stopPeerSessionDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _acceptPeerSessionDecs = [_imports.trace, (0, _validateParams.default)(_schema.fcrSessionBaseSchema, _schema.stringKeyUnknownValueSchema.optional())], _rejectPeerSessionDecs = [_imports.trace, (0, _validateParams.default)(_schema.fcrSessionBaseSchema, _schema.stringKeyUnknownValueSchema.optional())], "logger")] = (_initProto(this), (0, _logger.createLogger)({
+  [(_startPeerSessionDecs = [(0, _imports.trace)(['params']), (0, _validateParams.default)(_schema.fcrPeerSessionParamsSchema)], _stopPeerSessionDecs = [(0, _imports.trace)(['sessionId']), (0, _validateParams.default)(_schema.stringSchema)], _acceptPeerSessionDecs = [(0, _imports.trace)(['session', 'cause']), (0, _validateParams.default)(_schema.fcrSessionBaseSchema, _schema.stringKeyUnknownValueSchema.optional())], _rejectPeerSessionDecs = [(0, _imports.trace)(['session', 'cause']), (0, _validateParams.default)(_schema.fcrSessionBaseSchema, _schema.stringKeyUnknownValueSchema.optional())], "logger")] = (_initProto(this), (0, _logger.createLogger)({
     prefix: 'FcrPeerSessionControlImpl'
   }));
   //@internal
@@ -96,18 +96,18 @@ class FcrPeerSessionControlImpl {
       this.logger.info(`[PeerSession] put into session schedule: ${session.sessionId}, next ts: ${nextTs}, remain: ${nextTs - Date.now()}ms`);
       return session.sessionId;
     } catch (e) {
-      throw (0, _error.generateFcrCoreServerError)(_error.FcrErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'start peer session failed', e);
+      throw (0, _error.generateFcrCoreServerError)(_imports.DetailErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'start peer session failed', e);
     }
   }
   stopPeerSession(sessionId) {
-    this._scheduleMap.delete(sessionId);
+    return this._scheduleMap.delete(sessionId);
   }
   async acceptPeerSession(session, cause) {
     if (this._isSessionExpired(session)) {
-      throw (0, _error.generateFcrCoreServerError)(_error.FcrErrorCode.EXPIRED, 'accept peer session failed: session expired', new Error());
+      throw (0, _error.generateFcrCoreServerError)(_imports.DetailErrorCode.EXPIRED, 'accept peer session failed: session expired', new Error());
     }
     try {
-      this._api.deletePeerSession({
+      return this._api.deletePeerSession({
         userId: this._userId,
         sessionId: session.sessionId,
         sessionKey: session.sessionKey,
@@ -118,15 +118,15 @@ class FcrPeerSessionControlImpl {
         }
       });
     } catch (e) {
-      throw (0, _error.generateFcrCoreServerError)(_error.FcrErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'accept peer session failed', e);
+      throw (0, _error.generateFcrCoreServerError)(_imports.DetailErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'accept peer session failed', e);
     }
   }
   async rejectPeerSession(session, cause) {
     if (this._isSessionExpired(session)) {
-      throw (0, _error.generateFcrCoreServerError)(_error.FcrErrorCode.EXPIRED, 'reject peer session failed: session expired', new Error());
+      throw (0, _error.generateFcrCoreServerError)(_imports.DetailErrorCode.EXPIRED, 'reject peer session failed: session expired', new Error());
     }
     try {
-      this._api.deletePeerSession({
+      return this._api.deletePeerSession({
         userId: this._userId,
         sessionId: session.sessionId,
         sessionKey: session.sessionKey,
@@ -137,7 +137,7 @@ class FcrPeerSessionControlImpl {
         }
       });
     } catch (e) {
-      throw (0, _error.generateFcrCoreServerError)(_error.FcrErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'reject peer session failed', e);
+      throw (0, _error.generateFcrCoreServerError)(_imports.DetailErrorCode.LOCAL_HTTP_REQUEST_FAILED, 'reject peer session failed', e);
     }
   }
   addObserver(observer) {
@@ -162,13 +162,13 @@ class FcrPeerSessionControlImpl {
         interval: 0
       };
       if (this._isSessionExpired(session)) {
-        this.logger.info(`[PeerSession] peer session expired, removed: ${session.sessionId}`);
+        this.logger.info(`peer session expired, removed: ${session.sessionId}`);
         this._scheduleMap.delete(session.sessionId);
         continue;
       }
       // check timeout
       if (params.nextTs < Date.now()) {
-        this.logger.info(`[PeerSession] ping session: ${session.sessionId}`);
+        this.logger.info(`ping session: ${session.sessionId}`);
         try {
           const {
             data: {
@@ -191,7 +191,7 @@ class FcrPeerSessionControlImpl {
             this.logger.info(`[PeerSession] refresh session schedule: ${session.sessionId}, next ts: ${nextTs}`);
           }
         } catch (e) {
-          this.logger.error(`[PeerSession] ping session failed: ${e}`);
+          this.logger.error(`ping session failed: ${e}`);
         }
       }
     }
@@ -200,7 +200,7 @@ class FcrPeerSessionControlImpl {
       const session = this._receivedMap.get(key);
       if (this._isSessionExpired(session)) {
         this._receivedMap.delete(key);
-        this.logger.info(`[PeerSession] delete session callback: ${key}`);
+        this.logger.info(`delete session callback: ${key}`);
       }
     }
   }
@@ -280,7 +280,7 @@ class FcrPeerSessionControlImpl {
     return session.timestamp + session.duration * _imports.Duration.second(1) < Date.now();
   }
   _addLogObserver() {
-    this.addObserver((0, _logger.generateLogObserver)(this.logger, ['onPeerSessionAccepted', 'onPeerSessionReceived', 'onPeerSessionRejected']));
+    this.addObserver((0, _logger.generateLogObserver)(this.logger, [['onPeerSessionAccepted', ['session']], ['onPeerSessionReceived', ['session']], ['onPeerSessionRejected', ['session']]]));
   }
 }
 exports.FcrPeerSessionControlImpl = FcrPeerSessionControlImpl;

package/lib/peer-session/type.d.ts

@@ -8,7 +8,7 @@ export interface FcrPeerSessionControl {
     /**
      * Stop the current peer session.
      */
-    stopPeerSession(sessionId: string): void;
+    stopPeerSession(sessionId: string): boolean;
     /**
      * Accept an incoming peer session.
      */