agora-rte-sdk 3.8.2 → 3.9.0-alpha

package/lib/core/media/effect-enhancer.js

@@ -15,16 +15,6 @@ var AgoraRteAudioEffectEnhancer = exports.AgoraRteAudioEffectEnhancer = /*#__PUR
     this._deviceId = _deviceId;
   }
   return (0, _createClass2["default"])(AgoraRteAudioEffectEnhancer, [{
-    key: "enableAiDenoiser",
-    value: function enableAiDenoiser() {
-      return this._rtcClient.captureEnhancement.enableAiDenoiser(this._deviceId);
-    }
-  }, {
-    key: "disableAiDenoiser",
-    value: function disableAiDenoiser() {
-      return this._rtcClient.captureEnhancement.disableAiDenoiser(this._deviceId);
-    }
-  }, {
     key: "setAiDenoiseLevel",
     value: function setAiDenoiseLevel(level) {
       return this._rtcClient.captureEnhancement.setAiDenoiseLevel(this._deviceId, level);
@@ -40,14 +30,14 @@ var AgoraRteAudioEffectEnhancer = exports.AgoraRteAudioEffectEnhancer = /*#__PUR
       return this._rtcClient.captureEnhancement.disableHiFiMode();
     }
   }, {
-    key: "enableEchoCancellation",
-    value: function enableEchoCancellation() {
-      return this._rtcClient.captureEnhancement.enableEchoCancellation();
+    key: "enableAEC",
+    value: function enableAEC() {
+      return this._rtcClient.captureEnhancement.enableAEC();
     }
   }, {
-    key: "disableEchoCancellation",
-    value: function disableEchoCancellation() {
-      return this._rtcClient.captureEnhancement.disableEchoCancellation();
+    key: "disableAEC",
+    value: function disableAEC() {
+      return this._rtcClient.captureEnhancement.disableAEC();
     }
   }, {
     key: "enableStereoMode",

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

@@ -1,155 +1 @@
-import { AgoraRtcAudioOutputRouting, AgoraRtcCapability, AgoraRtcDeviceInfo, AgoraRtcDisplayInfo, AgoraRtcWindowInfo } from '../rtc/type';
-import { AgoraRteCameraTrack } from './camera';
-import { AgoraRteLoopbackTrack } from './loopback';
-import { AgoraRteMicrophoneTrack } from './microphone';
-import { AgoraRteScreenTrack } from './screen';
-import { AgoraRteMediaControlObserver } from './type';
-/**
- * Interface for the Agora Real-Time Engagement Media Control.
- */
-export interface AgoraRteMediaControl {
-    /**
-     * Retrieves a list of available loopback devices.
-     * @returns An array of available loopback devices.
-     */
-    getLoopbackList(): AgoraRtcDeviceInfo[];
-    /**
-     * Retrieves a list of available cameras.
-     * @returns An array of available cameras.
-     */
-    getCameraList(): Promise<AgoraRtcDeviceInfo[]>;
-    /**
-     * Retrieves a list of available microphones.
-     * @returns An array of available microphones.
-     */
-    getMicrophoneList(): Promise<AgoraRtcDeviceInfo[]>;
-    /**
-     * Retrieves a list of available speakers.
-     * @returns An array of available speakers.
-     */
-    getSpeakerList(): Promise<AgoraRtcDeviceInfo[]>;
-    /**
-     * Retrieves the system-selected microphone.
-     * @returns The system-selected microphone.
-     */
-    getSystemSelectedMicrophone(): Promise<AgoraRtcDeviceInfo | undefined>;
-    /**
-     * Retrieves the system-selected speaker.
-     * @returns The system-selected speaker.
-     */
-    getSystemSelectedSpeaker(): Promise<AgoraRtcDeviceInfo | undefined>;
-    /**
-     * Retrieves a list of available windows for screen sharing.
-     * Only available in Electron, in browsers this method returns an empty array.
-     * @returns A promise that resolves to an array of available windows.
-     */
-    getWindowList(): Promise<AgoraRtcWindowInfo[]>;
-    /**
-     * Retrieves a list of available displays for screen sharing.
-     * Only available in Electron, in browsers this method returns an empty array.
-     * @returns A promise that resolves to an array of available displays.
-     */
-    getDisplayList(): Promise<AgoraRtcDisplayInfo[]>;
-    /**
-     * Retrieves the camera video track for a specific device.
-     * @param deviceId The ID of the device.
-     * @returns The camera video track.
-     */
-    getCameraTrack(deviceId: string): AgoraRteCameraTrack;
-    /**
-     * Retrieves the microphone audio track for a specific device.
-     * @param deviceId The ID of the device.
-     * @returns The microphone audio track.
-     */
-    getMicrophoneTrack(deviceId: string): AgoraRteMicrophoneTrack;
-    /**
-     * Retrieves the screen video track for a specific source.
-     * @param sourceId The ID of the source.
-     * @returns The screen video track.
-     */
-    getScreenTrack(sourceId: string): AgoraRteScreenTrack;
-    /**
-     * Retrieves the loopback audio track for a specific source.
-     * @param sourceId The ID of the source.
-     * @returns The loopback audio track.
-     */
-    getLoopbackTrack(sourceId: string): AgoraRteLoopbackTrack;
-    /**
-     * Sets a speaker for audio playback.
-     * @param deviceId The ID of the speaker device.
-     */
-    setSelectedSpeaker(deviceId: string): void;
-    /**
-     * Enable/Disable speaker playback.
-     * @param enable Whether to enable speaker playback.
-     */
-    setEnableSpeaker(enable: boolean): void;
-    /**
-     * Get the current audio output routing of the SDK
-     */
-    getAudioOutputRouting(): AgoraRtcAudioOutputRouting;
-    /**
-     * Starts a speaker test.
-     * @param url The URL of the audio file for the test.
-     */
-    startSpeakerTest(url: string): void;
-    /**
-     * Stops a speaker test.
-     */
-    stopSpeakerTest(): void;
-    /**
-     * Adjusts the playback audio volume.
-     * @param volume
-     */
-    adjustAudioOutputVolume(volume: number): void;
-    /**
-     * Check if the media control supports the specified capability.
-     * @param capability
-     */
-    isCapabilitySupported(capability: AgoraRtcCapability): boolean;
-    /**
-     * Set the volume of the selected speaker
-     * @param volume The volume to set
-     */
-    setSelectedSpeakerVolume(volume: number): void;
-    /**
-     * Get the volume of the selected speaker
-     */
-    getSelectedSpeakerVolume(): number;
-    /**
-     * Disable AGC
-     * @returns 0 if the AGC is disabled; otherwise,
-     * 1 if the AGC is not supported
-     */
-    disableAGC(): number;
-    /**
-     * Enable AGC
-     * @returns 0 if the AGC is enabled; otherwise,
-     * 1 if the AGC is not supported
-     */
-    enableAGC(): number;
-    /**
-     * Observe the system selected speaker
-     * @param enable
-     */
-    observeSystemSelectedSpeakerChanged(enable: boolean): void;
-    /**
-     * Observe the system selected microphone
-     * @param enable
-     */
-    observeSystemSelectedMicrophoneChanged(enable: boolean): void;
-    /**
-     * Adds an observer to be notified of media device events.
-     * @param observer The observer to add.
-     */
-    addObserver(observer: AgoraRteMediaControlObserver): void;
-    /**
-     * Removes an observer from the media device events.
-     * @param observer The observer to remove.
-     */
-    removeObserver(observer: AgoraRteMediaControlObserver): void;
-    /**
-     * Releases the resources used by the media control.
-     */
-    release(): void;
-}
+export {};

package/lib/core/media/index.js

@@ -50,28 +50,28 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
 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 _constant = require("../../constant");
 var _imports = require("../../imports");
+var _type = require("../rtc/type");
 var _logger = require("../utilities/logger");
 var _camera = require("./camera");
 var _loopback = require("./loopback");
 var _microphone = require("./microphone");
 var _screen = require("./screen");
 var _AgoraRteMediaControlImpl;
-var _initProto;
+var _initProto, _observeSystemSelectedSpeakerChangedDecs, _observeSystemSelectedMicrophoneChangedDecs, _setSelectedSpeakerDecs, _setSelectedSpeakerVolumeDecs, _setEnableSpeakerDecs, _startSpeakerTestDecs, _adjustAudioOutputVolumeDecs, _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; }
-/**
- * Interface for the Agora Real-Time Engagement Media Control.
- */
+_ref = (_observeSystemSelectedSpeakerChangedDecs = (0, _imports.trace)(['enable']), _observeSystemSelectedMicrophoneChangedDecs = (0, _imports.trace)(['enable']), _setSelectedSpeakerDecs = (0, _imports.trace)(['deviceId']), _setSelectedSpeakerVolumeDecs = (0, _imports.trace)(['volume']), _setEnableSpeakerDecs = (0, _imports.trace)(['enable']), _startSpeakerTestDecs = (0, _imports.trace)(['url']), _adjustAudioOutputVolumeDecs = (0, _imports.trace)(['volume']), "logger");
 //@internal
 var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/function () {
   function AgoraRteMediaControlImpl() {
     var _this = this;
     (0, _classCallCheck2["default"])(this, AgoraRteMediaControlImpl);
-    (0, _defineProperty2["default"])(this, "logger", (_initProto(this), (0, _logger.createLogger)({
+    (0, _defineProperty2["default"])(this, _ref, (_initProto(this), (0, _logger.createLogger)({
       prefix: 'AgoraRteMediaControlImpl'
     })));
     (0, _defineProperty2["default"])(this, "_observable", new _imports.AgoraObservable());
@@ -80,6 +80,26 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
     (0, _defineProperty2["default"])(this, "_microphoneAudioTracksMap", new Map());
     (0, _defineProperty2["default"])(this, "_screenShareTracksMap", new Map());
     (0, _defineProperty2["default"])(this, "_loopbackAudioTracksMap", new Map());
+    (0, _defineProperty2["default"])(this, "_cameraTrackObserver", {
+      onCameraStateUpdated: function onCameraStateUpdated(deviceId, state) {
+        _this._observable.notifyObservers('onTrackVideoStateUpdated', deviceId, _type.AgoraRtcVideoSourceType.CAMERA, state);
+      }
+    });
+    (0, _defineProperty2["default"])(this, "_microphoneTrackObserver", {
+      onMicrophoneStateUpdated: function onMicrophoneStateUpdated(deviceId, state) {
+        _this._observable.notifyObservers('onTrackAudioStateUpdated', deviceId, _type.AgoraRtcAudioSourceType.MICROPHONE, state);
+      }
+    });
+    (0, _defineProperty2["default"])(this, "_screenTrackObserver", {
+      onScreenCaptureStateUpdated: function onScreenCaptureStateUpdated(deviceId, state) {
+        _this._observable.notifyObservers('onTrackVideoStateUpdated', deviceId, _type.AgoraRtcVideoSourceType.SCREEN, state);
+      }
+    });
+    (0, _defineProperty2["default"])(this, "_loopbackTrackObserver", {
+      onLoopbackRecordingStateUpdated: function onLoopbackRecordingStateUpdated(deviceId, state) {
+        _this._observable.notifyObservers('onTrackAudioStateUpdated', deviceId, _type.AgoraRtcAudioSourceType.LOOPBACK, state);
+      }
+    });
     (0, _defineProperty2["default"])(this, "_sourceManagerObserver", {
       onCameraListAdded: function onCameraListAdded(list) {
         list.forEach(function (device) {
@@ -150,12 +170,12 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
   }, {
     key: "observeSystemSelectedSpeakerChanged",
     value: function observeSystemSelectedSpeakerChanged(enable) {
-      this.rtcClient.observeSystemSelectedSpeakerChanged(enable);
+      return this.rtcClient.observeSystemSelectedSpeakerChanged(enable);
     }
   }, {
     key: "observeSystemSelectedMicrophoneChanged",
     value: function observeSystemSelectedMicrophoneChanged(enable) {
-      this.rtcClient.sourceManager.observeSystemSelectedMicrophoneChanged(enable);
+      return this.rtcClient.sourceManager.observeSystemSelectedMicrophoneChanged(enable);
     }
   }, {
     key: "disableAGC",
@@ -170,12 +190,12 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
   }, {
     key: "setSelectedSpeaker",
     value: function setSelectedSpeaker(deviceId) {
-      this.rtcClient.setSelectedSpeaker(deviceId);
+      return this.rtcClient.setSelectedSpeaker(deviceId);
     }
   }, {
     key: "setSelectedSpeakerVolume",
     value: function setSelectedSpeakerVolume(volume) {
-      this.rtcClient.setSelectedSpeakerVolume(volume);
+      return this.rtcClient.setSelectedSpeakerVolume(volume);
     }
   }, {
     key: "getSelectedSpeakerVolume",
@@ -190,7 +210,7 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
   }, {
     key: "setEnableSpeaker",
     value: function setEnableSpeaker(enable) {
-      this.rtcClient.setEnableSpeaker(enable);
+      return this.rtcClient.setEnableSpeaker(enable);
     }
   }, {
     key: "getCameraTrack",
@@ -199,7 +219,9 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
         return new _camera.AgoraRteCameraDummyTrackImpl();
       }
       if (!this._cameraVideoTracksMap.has(deviceId)) {
-        this._cameraVideoTracksMap.set(deviceId, new _camera.AgoraRteCameraTrackImpl(this.rtcClient, deviceId));
+        var cameraTrack = new _camera.AgoraRteCameraTrackImpl(this.rtcClient, deviceId);
+        cameraTrack.addObserver(this._cameraTrackObserver);
+        this._cameraVideoTracksMap.set(deviceId, cameraTrack);
       }
       return this._cameraVideoTracksMap.get(deviceId);
     }
@@ -210,7 +232,9 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
         return new _microphone.AgoraRteMicrophoneDummyTrackImpl();
       }
       if (!this._microphoneAudioTracksMap.has(deviceId)) {
-        this._microphoneAudioTracksMap.set(deviceId, new _microphone.AgoraRteMicrophoneTrackImpl(this.rtcClient, deviceId));
+        var microphoneTrack = new _microphone.AgoraRteMicrophoneTrackImpl(this.rtcClient, deviceId);
+        microphoneTrack.addObserver(this._microphoneTrackObserver);
+        this._microphoneAudioTracksMap.set(deviceId, microphoneTrack);
       }
       return this._microphoneAudioTracksMap.get(deviceId);
     }
@@ -221,7 +245,9 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
         return new _screen.AgoraRteScreenDummyTrackImpl();
       }
       if (!this._screenShareTracksMap.has(sourceId)) {
-        this._screenShareTracksMap.set(sourceId, new _screen.AgoraRteScreenTrackImpl(this.rtcClient, sourceId));
+        var screenTrack = new _screen.AgoraRteScreenTrackImpl(this.rtcClient, sourceId);
+        screenTrack.addObserver(this._screenTrackObserver);
+        this._screenShareTracksMap.set(sourceId, screenTrack);
       }
       return this._screenShareTracksMap.get(sourceId);
     }
@@ -232,7 +258,9 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
         return new _loopback.AgoraRteLoopbackDummyTrackImpl();
       }
       if (!this._loopbackAudioTracksMap.has(sourceId)) {
-        this._loopbackAudioTracksMap.set(sourceId, new _loopback.AgoraRteLoopbackTrackImpl(this.rtcClient, sourceId));
+        var loopbackTrack = new _loopback.AgoraRteLoopbackTrackImpl(this.rtcClient, sourceId);
+        loopbackTrack.addObserver(this._loopbackTrackObserver);
+        this._loopbackAudioTracksMap.set(sourceId, loopbackTrack);
       }
       return this._loopbackAudioTracksMap.get(sourceId);
     }
@@ -312,11 +340,12 @@ var AgoraRteMediaControlImpl = exports.AgoraRteMediaControlImpl = /*#__PURE__*/f
       this.rtcClient.sourceManager.removeObserver(this._sourceManagerObserver);
       this.rtcClient.removeObserver(this._rtcClientObserver);
       this._rtcClient = null;
+      return _constant.AgoraRteReturnCode.SUCCESS;
     }
   }]);
 }();
 _AgoraRteMediaControlImpl = AgoraRteMediaControlImpl;
-var _applyDecs$e = _applyDecs(_AgoraRteMediaControlImpl, [[_imports.trace, 2, "observeSystemSelectedSpeakerChanged"], [_imports.trace, 2, "observeSystemSelectedMicrophoneChanged"], [_imports.trace, 2, "disableAGC"], [_imports.trace, 2, "enableAGC"], [_imports.trace, 2, "setSelectedSpeaker"], [_imports.trace, 2, "setSelectedSpeakerVolume"], [_imports.trace, 2, "setEnableSpeaker"], [_imports.trace, 2, "startSpeakerTest"], [_imports.trace, 2, "stopSpeakerTest"], [_imports.trace, 2, "adjustAudioOutputVolume"], [_imports.trace, 2, "release"]], []).e;
+var _applyDecs$e = _applyDecs(_AgoraRteMediaControlImpl, [[_observeSystemSelectedSpeakerChangedDecs, 2, "observeSystemSelectedSpeakerChanged"], [_observeSystemSelectedMicrophoneChangedDecs, 2, "observeSystemSelectedMicrophoneChanged"], [_imports.trace, 2, "disableAGC"], [_imports.trace, 2, "enableAGC"], [_setSelectedSpeakerDecs, 2, "setSelectedSpeaker"], [_setSelectedSpeakerVolumeDecs, 2, "setSelectedSpeakerVolume"], [_setEnableSpeakerDecs, 2, "setEnableSpeaker"], [_startSpeakerTestDecs, 2, "startSpeakerTest"], [_imports.trace, 2, "stopSpeakerTest"], [_adjustAudioOutputVolumeDecs, 2, "adjustAudioOutputVolume"], [_imports.trace, 2, "release"]], []).e;
 var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
 _initProto = _applyDecs$e2[0];
 _applyDecs$e;

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

@@ -21,14 +21,14 @@ export interface AgoraRteLoopbackTrack extends AgoraRteObservableTrack<AgoraRteL
     /**
      * 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 The volume level to set.
      */
-    adjustVolume(volume: number): void;
+    adjustVolume(volume: number): number;
 }

package/lib/core/media/loopback.js

@@ -54,7 +54,7 @@ var _type = require("../../type");
 var _logger = require("../utilities/logger");
 var _baseTrack = require("./base-track");
 var _ref, _AgoraRteLoopbackTrackImpl;
-var _initProto;
+var _initProto, _adjustVolumeDecs, _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)]; } }; }
@@ -65,13 +65,14 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
 /**
  * Interface for a loopback audio track in Agora RTE SDK.
  */
+_ref2 = (_adjustVolumeDecs = (0, _imports.trace)(['volume']), "logger");
 //@internal
-var AgoraRteLoopbackTrackImpl = exports.AgoraRteLoopbackTrackImpl = /*#__PURE__*/function (_ref2) {
+var AgoraRteLoopbackTrackImpl = exports.AgoraRteLoopbackTrackImpl = /*#__PURE__*/function (_ref3) {
   function AgoraRteLoopbackTrackImpl(_rtcClient, _deviceId) {
     var _this;
     (0, _classCallCheck2["default"])(this, AgoraRteLoopbackTrackImpl);
     _this = _callSuper(this, AgoraRteLoopbackTrackImpl, [_rtcClient]);
-    (0, _defineProperty2["default"])(_this, "logger", (_initProto(_this), (0, _logger.createLogger)({
+    (0, _defineProperty2["default"])(_this, _ref2, (_initProto(_this), (0, _logger.createLogger)({
       prefix: 'AgoraRteLoopbackTrackImpl'
     })));
     (0, _defineProperty2["default"])(_this, "_state", _type.AgoraRteMediaSourceState.CLOSE);
@@ -81,7 +82,7 @@ var AgoraRteLoopbackTrackImpl = exports.AgoraRteLoopbackTrackImpl = /*#__PURE__*
     });
     return _this;
   }
-  (0, _inherits2["default"])(AgoraRteLoopbackTrackImpl, _ref2);
+  (0, _inherits2["default"])(AgoraRteLoopbackTrackImpl, _ref3);
   return (0, _createClass2["default"])(AgoraRteLoopbackTrackImpl, [{
     key: "getDeviceId",
     value: function getDeviceId() {
@@ -100,18 +101,18 @@ var AgoraRteLoopbackTrackImpl = exports.AgoraRteLoopbackTrackImpl = /*#__PURE__*
   }, {
     key: "start",
     value: function start() {
-      this._rtcClient.sourceManager.startLoopbackRecording(this._deviceId);
+      return this._rtcClient.sourceManager.startLoopbackRecording(this._deviceId);
     }
   }, {
     key: "stop",
     value: function stop() {
-      this._rtcClient.sourceManager.stopLoopbackRecording(this._deviceId);
+      return this._rtcClient.sourceManager.stopLoopbackRecording(this._deviceId);
     }
   }, {
     key: "adjustVolume",
     value: function adjustVolume(volume) {
       // todo
-      this._rtcClient.sourceManager.adjustLoopbackVolume('', volume);
+      return this._rtcClient.sourceManager.adjustLoopbackVolume('', volume);
     }
   }, {
     key: "_handleLoopbackStateUpdated",
@@ -124,7 +125,7 @@ var AgoraRteLoopbackTrackImpl = exports.AgoraRteLoopbackTrackImpl = /*#__PURE__*
   }]);
 }(_ref = _baseTrack.AgoraRteBaseTrack); // @internal
 _AgoraRteLoopbackTrackImpl = AgoraRteLoopbackTrackImpl;
-var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteLoopbackTrackImpl, [[_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_imports.trace, 2, "adjustVolume"]], [], 0, void 0, _ref).e, 1);
+var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteLoopbackTrackImpl, [[_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_adjustVolumeDecs, 2, "adjustVolume"]], [], 0, void 0, _ref).e, 1);
 _initProto = _applyDecs$e[0];
 var AgoraRteLoopbackDummyTrackImpl = exports.AgoraRteLoopbackDummyTrackImpl = /*#__PURE__*/function () {
   function AgoraRteLoopbackDummyTrackImpl() {
@@ -153,12 +154,18 @@ var AgoraRteLoopbackDummyTrackImpl = exports.AgoraRteLoopbackDummyTrackImpl = /*
     }
   }, {
     key: "start",
-    value: function start() {}
+    value: function start() {
+      return 0;
+    }
   }, {
     key: "stop",
-    value: function stop() {}
+    value: function stop() {
+      return 0;
+    }
   }, {
     key: "adjustVolume",
-    value: function adjustVolume(volume) {}
+    value: function adjustVolume(volume) {
+      return 0;
+    }
   }]);
 }();

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

@@ -21,7 +21,7 @@ export interface AgoraRteMicrophoneTrack extends AgoraRteObservableTrack<AgoraRt
      * Sets the audio raw data configuration for the track.
      * @param config The audio raw data configuration.
      */
-    setAudioRawDataConfig(config: AgoraRteAudioRawDataConfig): void;
+    setAudioRawDataConfig(config: AgoraRteAudioRawDataConfig): number;
     /**
      * Starts the microphone audio track for the specified device.
      * onLocalMicrophoneAudioStateUpdated callback will be triggered when the state of the microphone changes.
@@ -29,25 +29,25 @@ export interface AgoraRteMicrophoneTrack extends AgoraRteObservableTrack<AgoraRt
      * - {@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 The volume level to set, range from 0 to 100.
      */
-    adjustVolume(volume: number): void;
+    adjustVolume(volume: number): number;
     /**
      * Gets the audio effect enhancer for the microphone audio track.
      * @returns The audio effect enhancer for the track.

package/lib/core/media/microphone.js

@@ -54,8 +54,9 @@ var _baseTrack = require("./base-track");
 var _effectEnhancer = require("./effect-enhancer");
 var _imports = require("../../imports");
 var _logger = require("../utilities/logger");
+var _constant = require("../../constant");
 var _ref, _AgoraRteMicrophoneTrackImpl;
-var _initProto;
+var _initProto, _setAudioRawDataConfigDecs, _startTestDecs, _adjustVolumeDecs, _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)]; } }; }
@@ -66,13 +67,14 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
 /**
  * Interface for a microphone audio track in Agora RTE SDK.
  */
+_ref2 = (_setAudioRawDataConfigDecs = (0, _imports.trace)(['config']), _startTestDecs = (0, _imports.trace)(['interval']), _adjustVolumeDecs = (0, _imports.trace)(['volume']), "logger");
 //@internal
-var AgoraRteMicrophoneTrackImpl = exports.AgoraRteMicrophoneTrackImpl = /*#__PURE__*/function (_ref2) {
+var AgoraRteMicrophoneTrackImpl = exports.AgoraRteMicrophoneTrackImpl = /*#__PURE__*/function (_ref3) {
   function AgoraRteMicrophoneTrackImpl(_rtcClient, _deviceId) {
     var _this;
     (0, _classCallCheck2["default"])(this, AgoraRteMicrophoneTrackImpl);
     _this = _callSuper(this, AgoraRteMicrophoneTrackImpl, [_rtcClient]);
-    (0, _defineProperty2["default"])(_this, "logger", (_initProto(_this), (0, _logger.createLogger)({
+    (0, _defineProperty2["default"])(_this, _ref2, (_initProto(_this), (0, _logger.createLogger)({
       prefix: 'AgoraRteMicrophoneTrackImpl'
     })));
     (0, _defineProperty2["default"])(_this, "_state", _type.AgoraRteMediaSourceState.CLOSE);
@@ -85,11 +87,12 @@ var AgoraRteMicrophoneTrackImpl = exports.AgoraRteMicrophoneTrackImpl = /*#__PUR
     _this._rtcClient.sourceManager.addObserver(_this._sourceManagerObserver);
     return _this;
   }
-  (0, _inherits2["default"])(AgoraRteMicrophoneTrackImpl, _ref2);
+  (0, _inherits2["default"])(AgoraRteMicrophoneTrackImpl, _ref3);
   return (0, _createClass2["default"])(AgoraRteMicrophoneTrackImpl, [{
     key: "release",
     value: function release() {
       this._rtcClient.sourceManager.removeObserver(this._sourceManagerObserver);
+      return _constant.AgoraRteReturnCode.SUCCESS;
     }
   }, {
     key: "getAudioEffectEnhancer",
@@ -115,31 +118,32 @@ var AgoraRteMicrophoneTrackImpl = exports.AgoraRteMicrophoneTrackImpl = /*#__PUR
     key: "setAudioRawDataConfig",
     value: function setAudioRawDataConfig(config) {
       // this._rtcClient.sourceManager.setAudioRawDataConfig(this._deviceId, config);
+      return _constant.AgoraRteReturnCode.SUCCESS;
     }
   }, {
     key: "start",
     value: function start() {
-      this._rtcClient.sourceManager.openMicrophone(this._deviceId);
+      return this._rtcClient.sourceManager.openMicrophone(this._deviceId);
     }
   }, {
     key: "stop",
     value: function stop() {
-      this._rtcClient.sourceManager.closeMicrophone(this._deviceId);
+      return this._rtcClient.sourceManager.closeMicrophone(this._deviceId);
     }
   }, {
     key: "startTest",
     value: function startTest(interval) {
-      this._rtcClient.sourceManager.startMicrophoneTest(this._deviceId, interval);
+      return this._rtcClient.sourceManager.startMicrophoneTest(this._deviceId, interval);
     }
   }, {
     key: "stopTest",
     value: function stopTest() {
-      this._rtcClient.sourceManager.stopMicrophoneTest(this._deviceId);
+      return this._rtcClient.sourceManager.stopMicrophoneTest(this._deviceId);
     }
   }, {
     key: "adjustVolume",
     value: function adjustVolume(volume) {
-      this._rtcClient.sourceManager.adjustMicrophoneVolume(this._deviceId, volume);
+      return this._rtcClient.sourceManager.adjustMicrophoneVolume(this._deviceId, volume);
     }
   }, {
     key: "_handleMicrophoneStateUpdated",
@@ -159,7 +163,7 @@ var AgoraRteMicrophoneTrackImpl = exports.AgoraRteMicrophoneTrackImpl = /*#__PUR
   }]);
 }(_ref = _baseTrack.AgoraRteBaseTrack); // @internal
 _AgoraRteMicrophoneTrackImpl = AgoraRteMicrophoneTrackImpl;
-var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteMicrophoneTrackImpl, [[_imports.trace, 2, "release"], [_imports.trace, 2, "setAudioRawDataConfig"], [_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_imports.trace, 2, "startTest"], [_imports.trace, 2, "stopTest"], [_imports.trace, 2, "adjustVolume"], [_imports.bound, 2, "_handleMicrophoneStateUpdated"], [_imports.bound, 2, "_handleLocalMicrophoneVolumeUpdated"]], [], 0, void 0, _ref).e, 1);
+var _applyDecs$e = (0, _slicedToArray2["default"])(_applyDecs(_AgoraRteMicrophoneTrackImpl, [[_imports.trace, 2, "release"], [_setAudioRawDataConfigDecs, 2, "setAudioRawDataConfig"], [_imports.trace, 2, "start"], [_imports.trace, 2, "stop"], [_startTestDecs, 2, "startTest"], [_imports.trace, 2, "stopTest"], [_adjustVolumeDecs, 2, "adjustVolume"], [_imports.bound, 2, "_handleMicrophoneStateUpdated"], [_imports.bound, 2, "_handleLocalMicrophoneVolumeUpdated"]], [], 0, void 0, _ref).e, 1);
 _initProto = _applyDecs$e[0];
 var AgoraRteMicrophoneDummyTrackImpl = exports.AgoraRteMicrophoneDummyTrackImpl = /*#__PURE__*/function () {
   function AgoraRteMicrophoneDummyTrackImpl() {
@@ -178,22 +182,34 @@ var AgoraRteMicrophoneDummyTrackImpl = exports.AgoraRteMicrophoneDummyTrackImpl
     }
   }, {
     key: "setAudioRawDataConfig",
-    value: function setAudioRawDataConfig(config) {}
+    value: function setAudioRawDataConfig(config) {
+      return 0;
+    }
   }, {
     key: "start",
-    value: function start() {}
+    value: function start() {
+      return 0;
+    }
   }, {
     key: "stop",
-    value: function stop() {}
+    value: function stop() {
+      return 0;
+    }
   }, {
     key: "startTest",
-    value: function startTest(interval) {}
+    value: function startTest(interval) {
+      return 0;
+    }
   }, {
     key: "stopTest",
-    value: function stopTest() {}
+    value: function stopTest() {
+      return 0;
+    }
   }, {
     key: "adjustVolume",
-    value: function adjustVolume(volume) {}
+    value: function adjustVolume(volume) {
+      return 0;
+    }
   }, {
     key: "getAudioEffectEnhancer",
     value: function getAudioEffectEnhancer() {