agora-rte-sdk 3.8.2 → 3.9.0-alpha

package/lib/core/engine/index.js

@@ -36,10 +36,11 @@ var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AgoraRteEngine = void 0;
+exports.AgoraRteEngineImpl = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 require("core-js/modules/es.error.cause.js");
 require("core-js/modules/es.error.to-string.js");
+require("core-js/modules/es.array.concat.js");
 require("core-js/modules/es.array.for-each.js");
 require("core-js/modules/es.date.to-json.js");
 require("core-js/modules/es.function.bind.js");
@@ -70,28 +71,40 @@ var _parameters = require("../utilities/parameters");
 var _packageInfo = require("../utilities/package-info");
 var _restfulClient = require("../../plugin/restful-client");
 var _monitor = require("../../plugin/monitor");
+var _constants = require("../utilities/constants");
 var _apDetector = require("./ap-detector");
 var _logger = require("../utilities/logger");
+var _weakInvoker = require("../utilities/weak-invoker");
 var _type3 = require("../processor/type");
-var _AgoraRteEngine;
-var _initProto;
+var _constant = require("../../constant");
+var _AgoraRteEngineImpl;
+var _initProto, _createSceneDecs, _sendPeerMessageDecs, _setParametersDecs, _renewUserTokenDecs, _ref;
 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 set(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 k(e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function k(e) { return e[n]; }, (o < 2 || 4 === o) && (F = function F(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 s(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); }
 function _setFunctionName(e, t, n) { "symbol" == _typeof(t) && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? _typeof(e) : "null")); return e; }
-var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
-  function AgoraRteEngine(config) {
-    (0, _classCallCheck2["default"])(this, AgoraRteEngine);
-    (0, _defineProperty2["default"])(this, "logger", (_initProto(this), (0, _logger.createLogger)({
+_ref = (_createSceneDecs = (0, _imports.trace)(['config']), _sendPeerMessageDecs = (0, _imports.trace)(['payload', 'cmd', 'guaranteedDelivery', 'receiverId']), _setParametersDecs = (0, _imports.trace)(['parameters']), _renewUserTokenDecs = (0, _imports.trace)(['token']), "logger");
+var AgoraRteEngineImpl = exports.AgoraRteEngineImpl = /*#__PURE__*/function () {
+  function AgoraRteEngineImpl(config) {
+    (0, _classCallCheck2["default"])(this, AgoraRteEngineImpl);
+    (0, _defineProperty2["default"])(this, _ref, (_initProto(this), (0, _logger.createLogger)({
       prefix: 'AgoraRteEngine'
     })));
     (0, _defineProperty2["default"])(this, "_observable", new _imports.AgoraObservable());
+    (0, _defineProperty2["default"])(this, "_sceneRefs", new _weakInvoker.WeakInvoker());
     (0, _defineProperty2["default"])(this, "_rtmClientObserver", {
       onConnectionStateUpdated: this._handleConnectionStateUpdated.bind(this),
       onPeerMessageReceived: this._handlePeerMessageReceived.bind(this),
       onTokenWillExpire: this._handleTokenWillExpire.bind(this)
     });
+    (0, _defineProperty2["default"])(this, "_sceneObserver", {
+      onCheckMediaSourceState: this._handleCheckMediaSourceState.bind(this)
+    });
+    (0, _defineProperty2["default"])(this, "_mediaControlObserver", {
+      onTrackAudioStateUpdated: this._handleTrackAudioStateUpdated.bind(this),
+      onTrackVideoStateUpdated: this._handleTrackVideoStateUpdated.bind(this)
+    });
     (0, _defineProperty2["default"])(this, "_apDetector", this._createDefaultApDetector());
     (0, _defineProperty2["default"])(this, "_pluginManager", (0, _plugin.getPluginManager)());
     (0, _defineProperty2["default"])(this, "_requestScheduler", new _imports.AgoraRequestScheduler());
@@ -108,10 +121,10 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
       this._rtcClient = (0, _registry.getRegistry)('web-rtc-client');
     }
     this._rtmClient = (0, _registry.getRegistry)('rtm-client');
-    var mediaContorol = new _media.AgoraRteMediaControlImpl();
-    this._mediaControl = mediaContorol;
+    this._mediaControl = new _media.AgoraRteMediaControlImpl();
+    this._mediaControl.addObserver(this._mediaControlObserver);
     if (this._rtcClient) {
-      mediaContorol.setRtcClient(this._rtcClient);
+      this._mediaControl.setRtcClient(this._rtcClient);
     }
     if (this._rtmClient) {
       this._rtmClient.addObserver(this._rtmClientObserver);
@@ -122,23 +135,22 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
     });
     this._restfulClient = new _restfulClient.AgoraRestfulClientImpl(this._httpAuthHeadersProvider, (0, _domainHolder.getSharedDomainHolder)(this._config.rteRegion), this._requestScheduler);
     this._apiService = new _api.AgoraRteServiceApi(this._restfulClient, this._config.appId, this._config.rteRegion, !(0, _parameters.isEndpointRegionDisabled)(config.parameters));
-    var monitor = new _monitor.AgoraRteMonitorImpl({
+    this._monitor = new _monitor.AgoraRteMonitorImpl({
       appId: this._config.appId,
       appVersion: this.getVersion()
     }, this._httpAuthHeadersProvider, this._config.userId, this._apiService);
-    this._monitor = monitor;
     if (this._rtcClient) {
-      monitor.observeRtcEvents(this._rtcClient);
+      this._monitor.observeRtcEvents(this._rtcClient);
     }
     if (this._rtmClient) {
-      monitor.observeRtmEvents(this._rtmClient);
+      this._monitor.observeRtmEvents(this._rtmClient);
     }
     this._updateApDetector(config.parameters);
     if (config.parameters) {
       this._initializeParameters(config.parameters);
     }
   }
-  return (0, _createClass2["default"])(AgoraRteEngine, [{
+  return (0, _createClass2["default"])(AgoraRteEngineImpl, [{
     key: "rtcClient",
     get: function get() {
       if (!this._rtcClient) {
@@ -215,7 +227,7 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
   }, {
     key: "createScene",
     value: function createScene(config) {
-      var rteScene = new _scene.AgoraRteScene(config.sceneId, {
+      var rteScene = new _scene.AgoraRteSceneImpl(config.sceneId, {
         rtcClient: this.rtcClient,
         rtmClient: this.rtmClient,
         apDetector: this._apDetector,
@@ -224,28 +236,18 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
         region: this._config.rteRegion,
         userId: this._config.userId
       });
-      this.rtcClient.sourceManager.addObserver({
-        onCameraStateUpdated: rteScene.onCameraVideoStateUpdated,
-        onMicrophoneStateUpdated: rteScene.onMicrophoneAudioStateUpdated,
-        onLoopbackRecordingStateUpdated: rteScene.onLoopbackAudioStateUpdated,
-        onScreenCaptureStateUpdated: rteScene.onScreenCaptureVideoStateUpdated
-      });
+      rteScene.addObserver(this._sceneObserver);
+      this._sceneRefs.add(rteScene);
       return rteScene;
     }
   }, {
     key: "getMediaControl",
     value: function getMediaControl() {
-      if (!this._mediaControl) {
-        throw new Error('mediaControl is not initialized');
-      }
       return this._mediaControl;
     }
   }, {
     key: "getMonitor",
     value: function getMonitor() {
-      if (!this._monitor) {
-        throw new Error('monitor is not initialized');
-      }
       return this._monitor;
     }
   }, {
@@ -265,6 +267,8 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
                 }
               });
             case 1:
+              return _context3.abrupt("return", _constant.AgoraRteReturnCode.SUCCESS);
+            case 2:
             case "end":
               return _context3.stop();
           }
@@ -284,18 +288,26 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
         this._setRtcRtmParameters(parameters);
         this._updateApDetector(parameters);
         this._pluginManager.updateParameters(parameters);
+        return _constant.AgoraRteReturnCode.SUCCESS;
       } catch (e) {
         this.logger.warn('setParameters failed', e);
+        return _constant.AgoraRteReturnCode.UNDEFINED;
       }
     }
   }, {
     key: "renewUserToken",
     value: function renewUserToken(token) {
-      this.rtmClient.renewToken(token);
+      this._httpAuthHeadersProvider.putHeaders((0, _defineProperty2["default"])({}, _constants.HTTP_HEADER_K_AUTHORIZATION, (0, _authHeaders.getAuthorization)(token)));
+      return this.rtmClient.renewToken(token);
     }
   }, {
     key: "release",
     value: function release() {
+      var _this = this;
+      this._sceneRefs.invoke(function (scene) {
+        scene.removeObserver(_this._sceneObserver);
+      });
+      this._sceneRefs.cleanup();
       this._pluginManager.callRelease();
       if (this._monitor) {
         this._monitor.release();
@@ -304,6 +316,8 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
         this._mediaControl.release();
       }
       // restoreConsoleHijack();
+
+      return _constant.AgoraRteReturnCode.SUCCESS;
     }
   }, {
     key: "addObserver",
@@ -359,21 +373,21 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
   }, {
     key: "_handlePeerMessageReceived",
     value: function _handlePeerMessageReceived(userId, message) {
-      var _this = this;
-      var _ref = JSON.parse(message),
-        list = _ref.list,
-        fromRoomUuid = _ref.fromRoomUuid;
+      var _this2 = this;
+      var _ref2 = JSON.parse(message),
+        list = _ref2.list,
+        fromRoomUuid = _ref2.fromRoomUuid;
       if (fromRoomUuid !== undefined) {
         return;
       }
-      list.forEach(function (_ref2) {
-        var cmd = _ref2.cmd,
-          ts = _ref2.ts,
-          _ref2$data = _ref2.data,
-          payload = _ref2$data.payload,
-          fromUser = _ref2$data.fromUser;
+      list.forEach(function (_ref3) {
+        var cmd = _ref3.cmd,
+          ts = _ref3.ts,
+          _ref3$data = _ref3.data,
+          payload = _ref3$data.payload,
+          fromUser = _ref3$data.fromUser;
         if (cmd === _type3.AgoraRteServerMessageCmd.MESSAGE_EXTENSION) {
-          _this._observable.notifyObservers('onPeerMessageReceived', {
+          _this2._observable.notifyObservers('onPeerMessageReceived', {
             payload: payload,
             timestamp: ts,
             senderId: fromUser.userUuid,
@@ -394,18 +408,18 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
   }, {
     key: "_setRtcRtmParameters",
     value: function _setRtcRtmParameters(parameters) {
-      var _this2 = this;
-      var _ref3 = parameters,
-        rtc = _ref3.rtc,
-        rtm = _ref3.rtm;
+      var _this3 = this;
+      var _ref4 = parameters,
+        rtc = _ref4.rtc,
+        rtm = _ref4.rtm;
       if (rtc && this._rtcClient) {
         rtc.forEach(function (param) {
-          _this2.rtcClient.setParameters(param);
+          _this3.rtcClient.setParameters(param);
         });
       }
       if (rtm && this._rtmClient) {
         rtm.forEach(function (param) {
-          _this2.rtmClient.setParameters(param);
+          _this3.rtmClient.setParameters(param);
         });
       }
     }
@@ -446,10 +460,80 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
     value: function _createDefaultApDetector() {
       return new _apDetector.AgoraRteApDetectorImpl();
     }
+  }, {
+    key: "_handleTrackAudioStateUpdated",
+    value: function _handleTrackAudioStateUpdated(sourceId, sourceType, state) {
+      this._sceneRefs.invoke(function (scene) {
+        scene.onTrackAudioStateUpdated(sourceId, sourceType, state);
+      });
+    }
+  }, {
+    key: "_handleTrackVideoStateUpdated",
+    value: function _handleTrackVideoStateUpdated(sourceId, sourceType, state) {
+      this._sceneRefs.invoke(function (scene) {
+        scene.onTrackVideoStateUpdated(sourceId, sourceType, state);
+      });
+    }
+  }, {
+    key: "_handleCheckMediaSourceState",
+    value: function _handleCheckMediaSourceState(sceneId, stream, token) {
+      var _this4 = this;
+      // Helper function to update stream state
+      var updateStreamState = function updateStreamState(sourceId, currentState, sourceType, fieldName, streamType) {
+        _this4.logger.info("".concat(streamType, " source state changed for stream ").concat(stream.streamId, ", updating server ").concat(streamType, " source state, ").concat(sourceType, "SourceId: ").concat(sourceId, ", ").concat(sourceType, "SourceState: ").concat(currentState));
+        var updateData = {
+          roomUuid: sceneId,
+          userUuid: stream.owner.userId,
+          streamUuid: stream.streamId
+        };
+        updateData[fieldName] = currentState;
+        _this4._apiService.updateStreamWithToken(updateData, token);
+      };
+
+      // Handle microphone audio
+      if (stream.audioSourceType === _type.AgoraRteAudioSourceType.MICROPHONE && stream.audioSourceId) {
+        var microphoneTrack = this._mediaControl.getMicrophoneTrack(stream.audioSourceId);
+        var correctAudioState = microphoneTrack.getState();
+        var needUpdateAudioState = correctAudioState !== stream.audioSourceState;
+        if (needUpdateAudioState) {
+          updateStreamState(stream.audioSourceId, correctAudioState, 'audio', 'audioSourceState', 'audio');
+        }
+      }
+
+      // Handle loopback audio
+      if (stream.audioSourceType === _type.AgoraRteAudioSourceType.LOOPBACK && stream.audioSourceId) {
+        var loopbackTrack = this._mediaControl.getLoopbackTrack(stream.audioSourceId);
+        var _correctAudioState = loopbackTrack.getState();
+        var _needUpdateAudioState = _correctAudioState !== stream.audioSourceState;
+        if (_needUpdateAudioState) {
+          updateStreamState(stream.audioSourceId, _correctAudioState, 'audio', 'audioSourceState', 'audio');
+        }
+      }
+
+      // Handle camera video
+      if (stream.videoSourceType === _type.AgoraRteVideoSourceType.CAMERA && stream.videoSourceId) {
+        var cameraTrack = this._mediaControl.getCameraTrack(stream.videoSourceId);
+        var correctVideoState = cameraTrack.getState();
+        var needUpdateVideoState = correctVideoState !== stream.videoSourceState;
+        if (needUpdateVideoState) {
+          updateStreamState(stream.videoSourceId, correctVideoState, 'video', 'videoSourceState', 'video');
+        }
+      }
+
+      // Handle screen share video
+      if (stream.videoSourceType === _type.AgoraRteVideoSourceType.SCREEN && stream.videoSourceId) {
+        var screenTrack = this._mediaControl.getScreenTrack(stream.videoSourceId);
+        var _correctVideoState = screenTrack.getState();
+        var _needUpdateVideoState = _correctVideoState !== stream.videoSourceState;
+        if (_needUpdateVideoState) {
+          updateStreamState(stream.videoSourceId, _correctVideoState, 'video', 'videoSourceState', 'video');
+        }
+      }
+    }
   }]);
 }();
-_AgoraRteEngine = AgoraRteEngine;
-var _applyDecs$e = _applyDecs(_AgoraRteEngine, [[_imports.trace, 2, "login"], [_imports.trace, 2, "logout"], [_imports.trace, 2, "createScene"], [_imports.trace, 2, "sendPeerMessage"], [_imports.trace, 2, "setParameters"], [_imports.trace, 2, "renewUserToken"], [_imports.trace, 2, "release"], [_imports.bound, 2, "_updateApDetector"]], []).e;
+_AgoraRteEngineImpl = AgoraRteEngineImpl;
+var _applyDecs$e = _applyDecs(_AgoraRteEngineImpl, [[_imports.trace, 2, "login"], [_imports.trace, 2, "logout"], [_createSceneDecs, 2, "createScene"], [_sendPeerMessageDecs, 2, "sendPeerMessage"], [_setParametersDecs, 2, "setParameters"], [_renewUserTokenDecs, 2, "renewUserToken"], [_imports.trace, 2, "release"], [_imports.bound, 2, "_updateApDetector"]], []).e;
 var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
 _initProto = _applyDecs$e2[0];
 _applyDecs$e;

package/lib/core/engine/plugin.js

@@ -42,7 +42,7 @@ require("core-js/modules/web.dom-collections.iterator.js");
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _imports = require("../../imports");
+var _logger = require("../utilities/logger");
 var AgoraRtePluginManager = /*#__PURE__*/function () {
   function AgoraRtePluginManager() {
     (0, _classCallCheck2["default"])(this, AgoraRtePluginManager);
@@ -86,7 +86,7 @@ var getPluginManager = exports.getPluginManager = function getPluginManager() {
   return pluginManager;
 };
 var registerPlugin = exports.registerPlugin = function registerPlugin(plugin) {
-  var logger = (0, _imports.getLogger)();
+  var logger = (0, _logger.getLogger)();
   logger.info('Register plugin:', plugin.name);
   getPluginManager().registerPlugin(plugin);
 };

package/lib/core/engine/type.d.ts

@@ -0,0 +1,29 @@
+import { AgoraRteReturnCode } from '../../constant';
+import { AgoraRequestScheduler } from '../../imports';
+import { AgoraRteConnectionState, AgoraRteMessage, AgoraRteSceneConfig } from '../../type';
+import { AgoraRteMediaControl } from '../media/type';
+import { AgoraRteMonitor } from '../monitor';
+import { AgoraRteScene } from '../scene/type';
+import { AgoraHttpAuthHeadersProvider } from '../services/type';
+export interface AgoraRteEngineObserver {
+    onPeerMessageReceived?(message: AgoraRteMessage): void;
+    onConnectionStateUpdated?(state: AgoraRteConnectionState): void;
+    onUserTokenWillExpire?(): void;
+}
+export interface AgoraRteEngine {
+    login(): Promise<void>;
+    logout(): void;
+    getVersion(): string;
+    getDependencyVersions(): Record<string, string>;
+    createScene(config: AgoraRteSceneConfig): AgoraRteScene;
+    getMediaControl(): AgoraRteMediaControl;
+    getMonitor(): AgoraRteMonitor;
+    sendPeerMessage(payload: Record<string, unknown>, cmd: string, guaranteedDelivery: boolean, receiverId: string): Promise<AgoraRteReturnCode>;
+    setParameters(parameters: Record<string, unknown>): AgoraRteReturnCode;
+    renewUserToken(token: string): Promise<AgoraRteReturnCode>;
+    getHttpAuthHeadersProvider(): AgoraHttpAuthHeadersProvider;
+    getRequestScheduler(): AgoraRequestScheduler;
+    release(): void;
+    addObserver(observer: AgoraRteEngineObserver): void;
+    removeObserver(observer: AgoraRteEngineObserver): void;
+}

package/lib/core/engine/type.js

@@ -0,0 +1,6 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/core/media/camera.d.ts

@@ -23,35 +23,35 @@ export interface AgoraRteCameraTrack extends AgoraRteObservableTrack<AgoraRteCam
     /**
      * Starts the camera.
      */
-    start(): void;
+    start(): number;
     /**
      * Stops the camera.
      */
-    stop(): void;
+    stop(): 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: AgoraRteVideoRenderConfig, view: unknown): void;
+    startPreview(config: AgoraRteVideoRenderConfig, view: unknown): number;
     /**
      * Stops the camera preview.
      * @param view The HTML element to render the video on.
      */
-    stopPreview(view: unknown): void;
+    stopPreview(view: unknown): number;
     /**
      * Starts the camera test.
      */
-    startTest(): void;
+    startTest(): number;
     /**
      * Stops the camera test.
      */
-    stopTest(): void;
+    stopTest(): number;
     /**
      * Sets the capture parameters for the camera.
      * @param params The parameters for the video capture.
      */
-    setCaptureParams(params: AgoraRteCameraCaptureParams): void;
+    setCaptureParams(params: AgoraRteCameraCaptureParams): number;
     /**
      * Switches the camera position.
      * @returns The new camera position.
@@ -71,5 +71,5 @@ export interface AgoraRteCameraTrack extends AgoraRteObservableTrack<AgoraRteCam
      * Sets the video orientation for the camera track.
      * @param orientation The orientation to set.
      */
-    setVideoOrientation(orientation: AgoraRteVideoOrientation): void;
+    setVideoOrientation(orientation: AgoraRteVideoOrientation): number;
 }

package/lib/core/media/camera.js

@@ -56,7 +56,7 @@ var _effectEnhancer = require("./effect-enhancer");
 var _logger = require("../utilities/logger");
 var _imports = require("../../imports");
 var _ref, _AgoraRteCameraTrackImpl;
-var _initProto;
+var _initProto, _startPreviewDecs, _stopPreviewDecs, _setCaptureParamsDecs, _setVideoOrientationDecs, _ref2;
 function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2["default"])(o), (0, _possibleConstructorReturn2["default"])(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], (0, _getPrototypeOf2["default"])(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 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 set(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 k(e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function k(e) { return e[n]; }, (o < 2 || 4 === o) && (F = function F(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 s(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)]; } }; }
@@ -67,13 +67,14 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
 /**
  * Interface for a video track from a camera in Agora RTE SDK.
  */
+_ref2 = (_startPreviewDecs = (0, _imports.trace)(['config', 'view']), _stopPreviewDecs = (0, _imports.trace)(['view']), _setCaptureParamsDecs = (0, _imports.trace)(['params']), _setVideoOrientationDecs = (0, _imports.trace)(['orientation']), "logger");
 //@internal
-var AgoraRteCameraTrackImpl = exports.AgoraRteCameraTrackImpl = /*#__PURE__*/function (_ref2) {
+var AgoraRteCameraTrackImpl = exports.AgoraRteCameraTrackImpl = /*#__PURE__*/function (_ref3) {
   function AgoraRteCameraTrackImpl(_rtcClient, _deviceId) {
     var _this;
     (0, _classCallCheck2["default"])(this, AgoraRteCameraTrackImpl);
     _this = _callSuper(this, AgoraRteCameraTrackImpl, [_rtcClient]);
-    (0, _defineProperty2["default"])(_this, "logger", (_initProto(_this), (0, _logger.createLogger)({
+    (0, _defineProperty2["default"])(_this, _ref2, (_initProto(_this), (0, _logger.createLogger)({
       prefix: 'AgoraRteCameraTrackImpl'
     })));
     (0, _defineProperty2["default"])(_this, "_state", _type.AgoraRteMediaSourceState.CLOSE);
@@ -84,7 +85,7 @@ var AgoraRteCameraTrackImpl = exports.AgoraRteCameraTrackImpl = /*#__PURE__*/fun
     });
     return _this;
   }
-  (0, _inherits2["default"])(AgoraRteCameraTrackImpl, _ref2);
+  (0, _inherits2["default"])(AgoraRteCameraTrackImpl, _ref3);
   return (0, _createClass2["default"])(AgoraRteCameraTrackImpl, [{
     key: "getVideoEffectEnhancer",
     value: function getVideoEffectEnhancer() {
@@ -119,42 +120,42 @@ var AgoraRteCameraTrackImpl = exports.AgoraRteCameraTrackImpl = /*#__PURE__*/fun
   }, {
     key: "start",
     value: function start() {
-      this._rtcClient.sourceManager.openCamera(this._deviceId);
+      return this._rtcClient.sourceManager.openCamera(this._deviceId);
     }
   }, {
     key: "stop",
     value: function stop() {
-      this._rtcClient.sourceManager.closeCamera(this._deviceId);
+      return this._rtcClient.sourceManager.closeCamera(this._deviceId);
     }
   }, {
     key: "startPreview",
     value: function startPreview(config, view) {
-      this._rtcClient.startRenderCameraPreview(this._deviceId, view, config.renderMode, config.isMirror);
+      return this._rtcClient.startRenderCameraPreview(this._deviceId, view, config.renderMode, config.isMirror);
     }
   }, {
     key: "stopPreview",
     value: function stopPreview(view) {
-      this._rtcClient.stopRenderCameraPreview(this._deviceId, view);
+      return this._rtcClient.stopRenderCameraPreview(this._deviceId, view);
     }
   }, {
     key: "startTest",
     value: function startTest() {
-      this._rtcClient.sourceManager.startCameraTest(this._deviceId);
+      return this._rtcClient.sourceManager.startCameraTest(this._deviceId);
     }
   }, {
     key: "stopTest",
     value: function stopTest() {
-      this._rtcClient.sourceManager.stopCameraTest(this._deviceId);
+      return this._rtcClient.sourceManager.stopCameraTest(this._deviceId);
     }
   }, {
     key: "setCaptureParams",
     value: function setCaptureParams(params) {
-      this._rtcClient.sourceManager.setCameraCaptureParams(this._deviceId, params);
+      return this._rtcClient.sourceManager.setCameraCaptureParams(this._deviceId, params);
     }
   }, {
     key: "setVideoOrientation",
     value: function setVideoOrientation(orientation) {
-      this._rtcClient.sourceManager.setCameraVideoOrientation(this._deviceId, orientation);
+      return this._rtcClient.sourceManager.setCameraVideoOrientation(this._deviceId, orientation);
     }
   }, {
     key: "_handleCameraStateUpdated",
@@ -167,7 +168,7 @@ var AgoraRteCameraTrackImpl = exports.AgoraRteCameraTrackImpl = /*#__PURE__*/fun
   }]);
 }(_ref = _baseTrack.AgoraRteBaseTrack); // @internal
 _AgoraRteCameraTrackImpl = AgoraRteCameraTrackImpl;
-var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteCameraTrackImpl, [[_imports.trace, 2, "switchPosition"], [_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_imports.trace, 2, "startPreview"], [_imports.trace, 2, "stopPreview"], [_imports.trace, 2, "startTest"], [_imports.trace, 2, "stopTest"], [_imports.trace, 2, "setCaptureParams"], [_imports.trace, 2, "setVideoOrientation"]], [], 0, void 0, _ref).e, 1);
+var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteCameraTrackImpl, [[_imports.trace, 2, "switchPosition"], [_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_startPreviewDecs, 2, "startPreview"], [_stopPreviewDecs, 2, "stopPreview"], [_imports.trace, 2, "startTest"], [_imports.trace, 2, "stopTest"], [_setCaptureParamsDecs, 2, "setCaptureParams"], [_setVideoOrientationDecs, 2, "setVideoOrientation"]], [], 0, void 0, _ref).e, 1);
 _initProto = _applyDecs$e[0];
 var AgoraRteCameraDummyTrackImpl = exports.AgoraRteCameraDummyTrackImpl = /*#__PURE__*/function () {
   function AgoraRteCameraDummyTrackImpl() {
@@ -196,25 +197,39 @@ var AgoraRteCameraDummyTrackImpl = exports.AgoraRteCameraDummyTrackImpl = /*#__P
     }
   }, {
     key: "start",
-    value: function start() {}
+    value: function start() {
+      return 0;
+    }
   }, {
     key: "stop",
-    value: function stop() {}
+    value: function stop() {
+      return 0;
+    }
   }, {
     key: "startPreview",
-    value: function startPreview(config, view) {}
+    value: function startPreview(config, view) {
+      return 0;
+    }
   }, {
     key: "stopPreview",
-    value: function stopPreview(view) {}
+    value: function stopPreview(view) {
+      return 0;
+    }
   }, {
     key: "startTest",
-    value: function startTest() {}
+    value: function startTest() {
+      return 0;
+    }
   }, {
     key: "stopTest",
-    value: function stopTest() {}
+    value: function stopTest() {
+      return 0;
+    }
   }, {
     key: "setCaptureParams",
-    value: function setCaptureParams(params) {}
+    value: function setCaptureParams(params) {
+      return 0;
+    }
   }, {
     key: "switchPosition",
     value: function switchPosition() {
@@ -232,6 +247,8 @@ var AgoraRteCameraDummyTrackImpl = exports.AgoraRteCameraDummyTrackImpl = /*#__P
     }
   }, {
     key: "setVideoOrientation",
-    value: function setVideoOrientation(orientation) {}
+    value: function setVideoOrientation(orientation) {
+      return 0;
+    }
   }]);
 }();

package/lib/core/media/effect-enhancer.d.ts

@@ -1,16 +1,15 @@
 import { AgoraRtcClient } from '../rtc';
-import { AgoraRtcAiDenoiseLevel, AgoraRtcBeautyOptions, AgoraRtcVirtualBackgroundOptions } from '../rtc/type';
+import { AgoraRtcBeautyOptions, AgoraRtcVirtualBackgroundOptions } from '../rtc/type';
+import { AgoraRteAiDenoiseLevel } from './type';
 export declare class AgoraRteAudioEffectEnhancer {
     private _rtcClient;
     private _deviceId;
     constructor(_rtcClient: AgoraRtcClient, _deviceId: string);
-    enableAiDenoiser(): number;
-    disableAiDenoiser(): number;
-    setAiDenoiseLevel(level: AgoraRtcAiDenoiseLevel): number;
+    setAiDenoiseLevel(level: AgoraRteAiDenoiseLevel): number;
     enableHiFiMode(): number;
     disableHiFiMode(): number;
-    enableEchoCancellation(): number;
-    disableEchoCancellation(): number;
+    enableAEC(): number;
+    disableAEC(): number;
     enableStereoMode(): number;
     disableStereoMode(): number;
     enableOriginalSoundMode(): number;