agora-rte-sdk 3.2.1 → 3.3.0

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

@@ -1,7 +1,7 @@
 import { AgoraRteMediaControl } from '../media';
 import { AgoraRteEngineConfig, AgoraRteEngineObserver, AgoraRteSceneConfig } from '../../type';
 import { AgoraRteMonitor } from '../monitor';
-import { AgoraHttpAuthHeadersProvider, AgoraHttpAuthHeaderSetter } from '../services/type';
+import { AgoraHttpAuthHeadersProvider } from '../services/type';
 import { AgoraRteScene } from '../scene';
 export declare class AgoraRteEngine {
     private logger;
@@ -29,7 +29,7 @@ export declare class AgoraRteEngine {
     release(): void;
     addObserver(observer: AgoraRteEngineObserver): void;
     removeObserver(observer: AgoraRteEngineObserver): void;
-    getHttpAuthHeadersProvider(): AgoraHttpAuthHeadersProvider & AgoraHttpAuthHeaderSetter;
+    getHttpAuthHeadersProvider(): AgoraHttpAuthHeadersProvider;
     private _handleConnectionStateUpdated;
     private _handlePeerMessageReceived;
 }

package/lib/core/engine/index.js

@@ -190,8 +190,7 @@ var AgoraRteEngine = exports.AgoraRteEngine = /*#__PURE__*/function () {
         rtmClient: this._rtmClient,
         apiService: this._apiService,
         appId: this._config.appId,
-        region: this._config.rteRegion,
-        authHeadersSetter: this._httpAuthHeadersProvider
+        region: this._config.rteRegion
       });
       this._mediaControl.addObserver({
         onCameraVideoStateUpdated: rteScene.onCameraVideoStateUpdated,

package/lib/core/media/microphone.js

@@ -126,7 +126,7 @@ var AgoraRteMicrophoneAudioTrackImpl = exports.AgoraRteMicrophoneAudioTrackImpl
     key: "_handleLocalMicrophoneVolumeUpdated",
     value: function _handleLocalMicrophoneVolumeUpdated(deviceId, volume) {
       if (deviceId === this._deviceId) {
-        this.trackObservable.notifyObservers('onAudioVolumeUpdated', this._deviceId, volume);
+        this.trackObservable.notifyObservers('onVolumeIndicationUpdated', this._deviceId, volume);
       }
     }
   }]);

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

@@ -52,7 +52,7 @@ export type AgoraRteLoopbackObserver = {
 };
 export type AgoraRteMicrophoneTrackObserver = {
     onMicrophoneStateUpdated(deviceId: string, state: AgoraRteMediaSourceState): void;
-    onAudioVolumeUpdated(deviceId: string, volume: number): void;
+    onVolumeIndicationUpdated(deviceId: string, volume: number): void;
 };
 export type AgoraRteRecordAudioRawDataObserver = {
     onAudioRawDataRecorded(deviceId: string, data: AgoraRteAudioRawData): void;

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

@@ -1,7 +1,4 @@
-import { BaseUploadParams } from './log-upload/handler';
-import { AgoraHttpAuthHeadersProvider } from '../services/type';
 import { AgoraRteMonitorObserver } from './type';
-import { AgoraRtcClient } from '../rtc';
 /**
  * Interface for the Agora Real-Time Engagement Monitor.
  */
@@ -28,21 +25,3 @@ export interface AgoraRteMonitor {
      */
     removeObserver(observer: AgoraRteMonitorObserver): void;
 }
-export declare class AgoraRteMonitorImpl implements AgoraRteMonitor {
-    private _rtcClient;
-    protected logger: import("agora-foundation/lib/logger").Logger;
-    private _consoleLogUploadScheduler;
-    private _sdkLogUploadScheduler;
-    private _task;
-    private _perfObservable;
-    private _perfObserver;
-    private _perf?;
-    private _interval;
-    constructor(baseParams: BaseUploadParams, authHeadersProvider: AgoraHttpAuthHeadersProvider, _rtcClient: AgoraRtcClient);
-    uploadLog(meta: unknown): Promise<void>;
-    release(): void;
-    addObserver(observer: AgoraRteMonitorObserver): void;
-    removeObserver(observer: AgoraRteMonitorObserver): void;
-    private _updatePerf;
-    private _notifyPerf;
-}

package/lib/core/monitor/index.js

@@ -20,15 +20,18 @@ var _observable = require("agora-foundation/lib/utilities/observable");
 var _env = require("agora-foundation/lib/utilities/env");
 var _upload = require("agora-foundation/lib/upload");
 var _zip = require("agora-foundation/lib/utilities/zip");
+var _mutex = require("agora-foundation/lib/worker/mutex");
 /**
  * Interface for the Agora Real-Time Engagement Monitor.
  */
+//@internal
 var AgoraRteMonitorImpl = exports.AgoraRteMonitorImpl = /*#__PURE__*/function () {
   function AgoraRteMonitorImpl(baseParams, authHeadersProvider, _rtcClient) {
     (0, _classCallCheck2["default"])(this, AgoraRteMonitorImpl);
     (0, _defineProperty2["default"])(this, "logger", (0, _logger.getLogger)());
     (0, _defineProperty2["default"])(this, "_perfObservable", new _observable.AgoraObservable());
     (0, _defineProperty2["default"])(this, "_interval", 3000);
+    (0, _defineProperty2["default"])(this, "_uploadMutex", new _mutex.Mutex());
     this._rtcClient = _rtcClient;
     this._updatePerf = this._updatePerf.bind(this);
     this._notifyPerf = this._notifyPerf.bind(this);
@@ -43,54 +46,65 @@ var AgoraRteMonitorImpl = exports.AgoraRteMonitorImpl = /*#__PURE__*/function ()
   return (0, _createClass2["default"])(AgoraRteMonitorImpl, [{
     key: "uploadLog",
     value: function () {
-      var _uploadLog = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(meta) {
-        var logManager, consoleLogs, path, _logBasePath, logs;
-        return _regenerator["default"].wrap(function _callee$(_context) {
-          while (1) switch (_context.prev = _context.next) {
+      var _uploadLog = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee2(meta) {
+        var _this = this;
+        return _regenerator["default"].wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
             case 0:
-              _context.prev = 0;
-              logManager = (0, _logger.getLogManager)();
-              _context.next = 4;
-              return logManager.collectLogs();
-            case 4:
-              consoleLogs = _context.sent;
-              this._consoleLogUploadScheduler.addUploadTask({
-                id: Date.now(),
-                file: consoleLogs,
-                meta: meta
-              });
-              _context.next = 8;
-              return logManager.flush();
-            case 8:
-              if (!(0, _env.isElectron)()) {
-                _context.next = 15;
-                break;
-              }
-              path = window.require('path');
-              _logBasePath = path.resolve(window.require('@electron/remote').app.getPath('logs'), 'logs');
-              _context.next = 13;
-              return (0, _zip.zipDir)(_logBasePath);
-            case 13:
-              logs = _context.sent;
-              if (logs) {
-                this._sdkLogUploadScheduler.addUploadTask({
-                  id: Date.now(),
-                  file: logs,
-                  meta: meta
-                });
-              }
-            case 15:
-              _context.next = 20;
-              break;
-            case 17:
-              _context.prev = 17;
-              _context.t0 = _context["catch"](0);
-              this.logger.error('[AgoraRteMonitor] failed to upload electron sdk logs', _context.t0);
-            case 20:
+              return _context2.abrupt("return", this._uploadMutex.dispatch(/*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee() {
+                var logManager, consoleLogs, path, _logBasePath, logs;
+                return _regenerator["default"].wrap(function _callee$(_context) {
+                  while (1) switch (_context.prev = _context.next) {
+                    case 0:
+                      _context.prev = 0;
+                      logManager = (0, _logger.getLogManager)();
+                      _context.next = 4;
+                      return logManager.collectLogs();
+                    case 4:
+                      consoleLogs = _context.sent;
+                      _this._consoleLogUploadScheduler.addUploadTask({
+                        id: Date.now(),
+                        file: consoleLogs,
+                        meta: meta
+                      });
+                      _context.next = 8;
+                      return logManager.flush();
+                    case 8:
+                      if (!(0, _env.isElectron)()) {
+                        _context.next = 15;
+                        break;
+                      }
+                      path = window.require('path');
+                      _logBasePath = path.resolve(window.require('@electron/remote').app.getPath('logs'), 'logs');
+                      _context.next = 13;
+                      return (0, _zip.zipDir)(_logBasePath);
+                    case 13:
+                      logs = _context.sent;
+                      if (logs) {
+                        _this._sdkLogUploadScheduler.addUploadTask({
+                          id: Date.now(),
+                          file: logs,
+                          meta: meta
+                        });
+                      }
+                    case 15:
+                      _context.next = 20;
+                      break;
+                    case 17:
+                      _context.prev = 17;
+                      _context.t0 = _context["catch"](0);
+                      _this.logger.error('[AgoraRteMonitor] failed to upload electron sdk logs', _context.t0);
+                    case 20:
+                    case "end":
+                      return _context.stop();
+                  }
+                }, _callee, null, [[0, 17]]);
+              }))));
+            case 1:
             case "end":
-              return _context.stop();
+              return _context2.stop();
           }
-        }, _callee, this, [[0, 17]]);
+        }, _callee2, this);
       }));
       function uploadLog(_x) {
         return _uploadLog.apply(this, arguments);
@@ -100,6 +114,8 @@ var AgoraRteMonitorImpl = exports.AgoraRteMonitorImpl = /*#__PURE__*/function ()
   }, {
     key: "release",
     value: function release() {
+      this._sdkLogUploadScheduler.release();
+      this._consoleLogUploadScheduler.release();
       this._task.stop();
       this._rtcClient.removeObserver(this._perfObserver);
     }

package/lib/core/monitor/log-upload/handler.js

@@ -53,7 +53,7 @@ var AgoraLogUploadHandler = exports.AgoraLogUploadHandler = /*#__PURE__*/functio
     (0, _classCallCheck2["default"])(this, AgoraLogUploadHandler);
     //  always use prd domain for policy api
     (0, _defineProperty2["default"])(this, "_policyHost", 'https://api.sd-rtn.com');
-    (0, _defineProperty2["default"])(this, "_httpTimeout", 10000);
+    (0, _defineProperty2["default"])(this, "_httpTimeout", 30000);
     (0, _defineProperty2["default"])(this, "_platform", 'web');
     this._authHeadersProvider = _authHeadersProvider;
     var _UAParser$getResult$o = new _uaParserJs["default"]().getResult().os,

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

@@ -46,7 +46,6 @@ export declare class AgoraRteScene implements AgoraRtcClientMediaTrackEventsObse
     private _streamPlayer?;
     private _timestampGap;
     private _totalUserCount;
-    private _authHeaderSetter;
     private _localCameraVideoDeviceId?;
     private _localCameraVideoState;
     private _localMicrophoneAudioDeviceId?;

package/lib/core/scene/index.js

@@ -90,7 +90,6 @@ var _misc = require("agora-foundation/lib/utilities/misc");
 var _error = require("../utilities/error");
 var _type3 = require("../rtc/type");
 var _helper = require("./helper");
-var _constants = require("../utilities/constants");
 var _decorator = require("agora-foundation/lib/decorator");
 var _clone = require("../utilities/clone");
 var _AgoraRteScene;
@@ -119,7 +118,6 @@ var AgoraRteScene = exports.AgoraRteScene = /*#__PURE__*/function () {
     this._sceneId = sceneId;
     this._rtmClient = options.rtmClient;
     this._rtcClient = options.rtcClient;
-    this._authHeaderSetter = options.authHeadersSetter;
     this._apiService = options.apiService;
     this._stateSynchronizer = new _stateSync.AgoraRteOnlineStateSynchronizer(this._apiService, sceneId);
     this._messageSynchronizer = new _messageHandler.AgoraRteMessageHandle({
@@ -249,7 +247,8 @@ var AgoraRteScene = exports.AgoraRteScene = /*#__PURE__*/function () {
                       if (localUser.subscribe === _type2.AgoraRteSequenceMessageSubscribeUserState.SUBSCRIBE) {
                         _this2._stateSynchronizer.setSyncDelay(sysConfig.onlineStateEnsureDelay || 5000);
                       }
-                      _this2._authHeaderSetter.putHeaders((0, _defineProperty2["default"])({}, _constants.HTTP_HEADER_K_TOKEN, localUser.userToken));
+                      _this2._apiService = _this2._apiService.cloneWithUserCredential(localUser.userUuid, localUser.userToken);
+
                       // 2. join rtm channel & join rtc channel
                       _context.next = 18;
                       return Promise.all([_this2._joinRTCChannel({
@@ -1507,7 +1506,7 @@ var AgoraRteScene = exports.AgoraRteScene = /*#__PURE__*/function () {
   }]);
 }();
 _AgoraRteScene = AgoraRteScene;
-var _applyDecs$e = _applyDecs(_AgoraRteScene, [[_decorator.bound, 2, "onCameraVideoStateUpdated"], [_decorator.bound, 2, "onMicrophoneAudioStateUpdated"], [_decorator.bound, 2, "_syncLocalCameraVideoState"], [_decorator.bound, 2, "_syncLocalMicrophoneAudioState"], [_decorator.bound, 2, "_handleStreamIdTokenMapChanged"], [_decorator.bound, 2, "_handleStreamIdTokenMapRemoved"], [_decorator.bound, 2, "_createScreenChannelClient"], [_decorator.bound, 2, "_handleNetworkOnline"], [_decorator.bound, 2, "_handleNetworkOffline"]], []).e;
+var _applyDecs$e = _applyDecs(_AgoraRteScene, [[_decorator.trace, 2, "join"], [_decorator.trace, 2, "leave"], [_decorator.bound, 2, "onCameraVideoStateUpdated"], [_decorator.bound, 2, "onMicrophoneAudioStateUpdated"], [_decorator.bound, 2, "_syncLocalCameraVideoState"], [_decorator.bound, 2, "_syncLocalMicrophoneAudioState"], [_decorator.bound, 2, "_handleStreamIdTokenMapChanged"], [_decorator.bound, 2, "_handleStreamIdTokenMapRemoved"], [_decorator.bound, 2, "_createScreenChannelClient"], [_decorator.bound, 2, "_handleNetworkOnline"], [_decorator.bound, 2, "_handleNetworkOffline"]], []).e;
 var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
 _initProto = _applyDecs$e2[0];
 _applyDecs$e;

package/lib/core/scene/local-user.d.ts

@@ -33,7 +33,7 @@ export declare class AgoraRteLocalUser {
      * @param guaranteedDelivery
      * @returns
      */
-    sendSceneMessage(payload: Record<string, unknown>, guaranteedDelivery?: boolean): Promise<any>;
+    sendSceneMessage(payload: Record<string, unknown>, cmd: string, guaranteedDelivery?: boolean): Promise<any>;
     /**
      * Update the properties of the current scene.
      * All users in the scene can receive the message through the `onScenePropertiesUpdated` callback.

package/lib/core/scene/local-user.js

@@ -89,11 +89,12 @@ var AgoraRteLocalUser = exports.AgoraRteLocalUser = /*#__PURE__*/function () {
      */
   }, {
     key: "sendSceneMessage",
-    value: function sendSceneMessage(payload) {
-      var guaranteedDelivery = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    value: function sendSceneMessage(payload, cmd) {
+      var guaranteedDelivery = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       return this._apiService.sendCustomChannelMessage({
         roomUuid: this._fromSceneId,
         payload: payload,
+        cmd: cmd,
         sync: guaranteedDelivery
       });
     }

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

@@ -8,7 +8,6 @@ import { AgoraRteStreamPlayer } from './stream-player';
 import { AgoraRtcClient, AgoraRtcVideoCanvas } from '../rtc';
 import { AgoraRteAudioRawData } from '../media/type';
 import { AgoraRteError } from '../utilities/error';
-import { AgoraHttpAuthHeaderSetter } from '../services/type';
 import { AgoraRteServiceApi } from '../services/api';
 export interface AgoraRteSceneJoinSnapshotOptions {
     snapshot: AgoraRteEntryRoomResponse;
@@ -65,7 +64,6 @@ export interface AgoraRteSceneInitOptions {
     apiService: AgoraRteServiceApi;
     appId: string;
     region: AgoraRteRegion;
-    authHeadersSetter: AgoraHttpAuthHeaderSetter;
 }
 export type AgoraRteStreamJoinConfig = {
     videoEncoderConfig?: AgoraRtcVideoEncoderConfiguration;

package/lib/core/services/api.d.ts

@@ -34,8 +34,12 @@ export type AgoraRteSyncSequenceResponse = {
 };
 export declare class AgoraRteServiceApi {
     private _client;
+    private _appId;
+    private _region;
+    private _pathIncludeRegion;
     protected logger: import("agora-foundation/lib/logger").Logger;
-    constructor(_client: AgoraRestfulClient, appId: string, region: AgoraRteRegion, pathIncludeRegion?: boolean);
+    constructor(_client: AgoraRestfulClient, _appId: string, _region: AgoraRteRegion, _pathIncludeRegion?: boolean);
+    cloneWithUserCredential(userId: string, token: string): AgoraRteServiceApi;
     createRoom(params: {
         roomUuid: string;
         roomName: string;
@@ -160,10 +164,11 @@ export declare class AgoraRteServiceApi {
         message: string;
         roomUuid: string;
     }): Promise<any>;
-    sendCustomChannelMessage({ roomUuid, payload, sync, }: {
+    sendCustomChannelMessage({ roomUuid, payload, cmd, sync, }: {
         roomUuid: string;
         payload: Record<string, unknown>;
         sync?: boolean;
+        cmd: string;
     }): Promise<any>;
     sendCustomPeerMessage({ payload, toUserUuid, waitForAck, }: {
         payload: {

package/lib/core/services/api.js

@@ -35,19 +35,28 @@ var _excluded = ["roomUuid"],
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var AgoraRteServiceApi = exports.AgoraRteServiceApi = /*#__PURE__*/function () {
-  function AgoraRteServiceApi(_client, appId, region) {
-    var pathIncludeRegion = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : true;
+  function AgoraRteServiceApi(_client, _appId, _region) {
+    var _pathIncludeRegion = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : true;
     (0, _classCallCheck2["default"])(this, AgoraRteServiceApi);
     (0, _defineProperty2["default"])(this, "logger", (0, _logger.getLogger)());
     this._client = _client;
-    var pathPrefix = "/scene/apps/".concat(appId);
-    if (pathIncludeRegion) {
-      pathPrefix = "/".concat((0, _toLower["default"])(region)).concat(pathPrefix);
+    this._appId = _appId;
+    this._region = _region;
+    this._pathIncludeRegion = _pathIncludeRegion;
+    var pathPrefix = "/scene/apps/".concat(_appId);
+    if (_pathIncludeRegion) {
+      pathPrefix = "/".concat((0, _toLower["default"])(_region)).concat(pathPrefix);
     }
     this.logger.info('[AgoraRteServiceApi] set path prefix for RTE Service API:', pathPrefix);
     this._client.setPathPrefix(pathPrefix);
   }
   return (0, _createClass2["default"])(AgoraRteServiceApi, [{
+    key: "cloneWithUserCredential",
+    value: function cloneWithUserCredential(userId, token) {
+      var client = this._client.cloneWithUserCredential(userId, token);
+      return new AgoraRteServiceApi(client, this._appId, this._region, this._pathIncludeRegion);
+    }
+  }, {
     key: "createRoom",
     value: function () {
       var _createRoom = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(params) {
@@ -593,17 +602,20 @@ var AgoraRteServiceApi = exports.AgoraRteServiceApi = /*#__PURE__*/function () {
     key: "sendCustomChannelMessage",
     value: function () {
       var _sendCustomChannelMessage = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee18(_ref14) {
-        var roomUuid, payload, _ref14$sync, sync;
+        var roomUuid, payload, cmd, _ref14$sync, sync;
         return _regenerator["default"].wrap(function _callee18$(_context18) {
           while (1) switch (_context18.prev = _context18.next) {
             case 0:
-              roomUuid = _ref14.roomUuid, payload = _ref14.payload, _ref14$sync = _ref14.sync, sync = _ref14$sync === void 0 ? false : _ref14$sync;
+              roomUuid = _ref14.roomUuid, payload = _ref14.payload, cmd = _ref14.cmd, _ref14$sync = _ref14.sync, sync = _ref14$sync === void 0 ? false : _ref14$sync;
               _context18.next = 3;
               return this._client.fetch({
                 path: "/v1/rooms/".concat(roomUuid, "/message/channel"),
                 method: 'POST',
                 data: {
-                  payload: payload,
+                  payload: {
+                    data: payload,
+                    cmd: cmd
+                  },
                   sync: sync
                 }
               });

package/lib/core/services/auth-headers.d.ts

@@ -1,11 +1,12 @@
-import { AgoraHttpAuthHeadersProvider, AgoraHttpAuthHeaderSetter } from './type';
-export declare class AgoraHttpAuthHeadersProviderImpl implements AgoraHttpAuthHeadersProvider, AgoraHttpAuthHeaderSetter {
+import { AgoraHttpAuthHeadersProvider } from './type';
+export declare class AgoraHttpAuthHeadersProviderImpl implements AgoraHttpAuthHeadersProvider {
     private _headers;
     constructor(auth: {
         userId: string;
         token: string;
     });
-    getHeaders(): Record<string, string>;
+    clone(): AgoraHttpAuthHeadersProvider;
+    getHeaders(): Readonly<Record<string, string>>;
     setHeaders(headers: Record<string, string>): void;
     putHeaders(headers: Record<string, string>): void;
 }

package/lib/core/services/auth-headers.js

@@ -34,6 +34,14 @@ var AgoraHttpAuthHeadersProviderImpl = exports.AgoraHttpAuthHeadersProviderImpl
     this._headers = (0, _defineProperty2["default"])((0, _defineProperty2["default"])((0, _defineProperty2["default"])({}, _constants.HTTP_HEADER_K_AGORA_TOKEN, auth.token), _constants.HTTP_HEADER_K_AGORA_UID, auth.userId), _constants.HTTP_HEADER_K_AUTHORIZATION, "agora token=\"".concat(auth.token, "\""));
   }
   return (0, _createClass2["default"])(AgoraHttpAuthHeadersProviderImpl, [{
+    key: "clone",
+    value: function clone() {
+      return new AgoraHttpAuthHeadersProviderImpl({
+        userId: this._headers[_constants.HTTP_HEADER_K_AGORA_UID],
+        token: this._headers[_constants.HTTP_HEADER_K_AGORA_TOKEN]
+      });
+    }
+  }, {
     key: "getHeaders",
     value: function getHeaders() {
       return this._headers;

package/lib/core/services/client.d.ts

@@ -8,6 +8,7 @@ export declare class AgoraRestfulClient {
     private _retryInterval;
     private _requestTimeout;
     constructor(_authHeadersProvider: AgoraHttpAuthHeadersProvider, _domainHolder: AgoraDomainHolder);
+    cloneWithUserCredential(userId: string, token: string): AgoraRestfulClient;
     get host(): string;
     setPathPrefix(pathPrefix: string): void;
     fetch(params: AgoraFetchParams): Promise<any>;

package/lib/core/services/client.js

@@ -70,6 +70,13 @@ var AgoraRestfulClient = exports.AgoraRestfulClient = /*#__PURE__*/function () {
     this._domainHolder = _domainHolder;
   }
   return (0, _createClass2["default"])(AgoraRestfulClient, [{
+    key: "cloneWithUserCredential",
+    value: function cloneWithUserCredential(userId, token) {
+      var provider = this._authHeadersProvider.clone();
+      provider.putHeaders((0, _defineProperty2["default"])((0, _defineProperty2["default"])({}, _constants.HTTP_HEADER_K_AGORA_UID, userId), _constants.HTTP_HEADER_K_TOKEN, token));
+      return new AgoraRestfulClient(provider, this._domainHolder);
+    }
+  }, {
     key: "host",
     get: function get() {
       return this._domainHolder.domain;

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

@@ -10,8 +10,7 @@ export interface AgoraFetchParams {
 }
 export interface AgoraHttpAuthHeadersProvider {
     getHeaders(): Record<string, string>;
-}
-export interface AgoraHttpAuthHeaderSetter {
     setHeaders(headers: Record<string, string>): void;
     putHeaders(headers: Record<string, string>): void;
+    clone(): AgoraHttpAuthHeadersProvider;
 }

package/lib/core/utilities/parameters.d.ts

@@ -6,6 +6,21 @@ type AgoraRteEngineParameters = {
 export declare const getRteIpList: (parameters?: AgoraRteEngineParameters) => string[] | undefined;
 export declare const getRtcIpList: (parameters?: AgoraRteEngineParameters) => string[] | undefined;
 export declare const getRtcVerifyDomainName: (parameters?: AgoraRteEngineParameters) => string | undefined;
+export declare const getRtcServerList: (parameters?: AgoraRteEngineParameters) => string[] | undefined;
+export declare const getRtcServerPort: (parameters?: AgoraRteEngineParameters) => number | undefined;
+export declare const getRtcServerDomain: (parameters?: AgoraRteEngineParameters) => string | undefined;
+export declare const getRtcCdsConfig: (parameters?: AgoraRteEngineParameters) => {
+    hostname?: string[];
+    port?: number;
+} | undefined;
+export declare const getRtcLogConfig: (parameters?: AgoraRteEngineParameters) => {
+    hostname?: string[];
+    port?: number;
+} | undefined;
+export declare const getRtcReportConfig: (parameters?: AgoraRteEngineParameters) => {
+    hostname?: string[];
+    port?: number;
+} | undefined;
 export declare const getRtmIpList: (parameters?: AgoraRteEngineParameters) => string[] | undefined;
 export declare const getRtmOriginDomains: (parameters?: AgoraRteEngineParameters) => string[] | undefined;
 export declare const getRtmEventUploadHosts: (parameters?: AgoraRteEngineParameters) => string[] | undefined;

package/lib/core/utilities/parameters.js

@@ -4,7 +4,7 @@ require("core-js/modules/es.object.define-property.js");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isEndpointRegionDisabled = exports.getRtmOriginDomains = exports.getRtmLogUploadHosts = exports.getRtmIpList = exports.getRtmEventUploadHosts = exports.getRteIpList = exports.getRtcVerifyDomainName = exports.getRtcIpList = void 0;
+exports.isEndpointRegionDisabled = exports.getRtmOriginDomains = exports.getRtmLogUploadHosts = exports.getRtmIpList = exports.getRtmEventUploadHosts = exports.getRteIpList = exports.getRtcVerifyDomainName = exports.getRtcServerPort = exports.getRtcServerList = exports.getRtcServerDomain = exports.getRtcReportConfig = exports.getRtcLogConfig = exports.getRtcIpList = exports.getRtcCdsConfig = void 0;
 var _valueCheck = require("agora-foundation/lib/utilities/value-check");
 var getRteIpList = exports.getRteIpList = function getRteIpList(parameters) {
   var _parameters$rte;
@@ -12,43 +12,91 @@ var getRteIpList = exports.getRteIpList = function getRteIpList(parameters) {
     return parameters.rte.rteIpList;
   }
 };
+// for native use only
 var getRtcIpList = exports.getRtcIpList = function getRtcIpList(parameters) {
   var _parameters$rte2;
   if (parameters !== null && parameters !== void 0 && (_parameters$rte2 = parameters.rte) !== null && _parameters$rte2 !== void 0 && _parameters$rte2.rtcIpList) {
     return parameters.rte.rtcIpList;
   }
 };
+// for native use only
 var getRtcVerifyDomainName = exports.getRtcVerifyDomainName = function getRtcVerifyDomainName(parameters) {
   var _parameters$rte3;
   if (parameters !== null && parameters !== void 0 && (_parameters$rte3 = parameters.rte) !== null && _parameters$rte3 !== void 0 && _parameters$rte3.rtcVerifyDomainName) {
     return parameters.rte.rtcVerifyDomainName;
   }
 };
-var getRtmIpList = exports.getRtmIpList = function getRtmIpList(parameters) {
+
+// for websdk use only
+var getRtcServerList = exports.getRtcServerList = function getRtcServerList(parameters) {
   var _parameters$rte4;
-  if (parameters !== null && parameters !== void 0 && (_parameters$rte4 = parameters.rte) !== null && _parameters$rte4 !== void 0 && _parameters$rte4.rtmIpList) {
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte4 = parameters.rte) !== null && _parameters$rte4 !== void 0 && _parameters$rte4.rtcServerList) {
+    return parameters.rte.rtcServerList;
+  }
+};
+
+// for websdk use only
+var getRtcServerPort = exports.getRtcServerPort = function getRtcServerPort(parameters) {
+  var _parameters$rte5;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte5 = parameters.rte) !== null && _parameters$rte5 !== void 0 && _parameters$rte5.rtcServerPort) {
+    return parameters.rte.rtcServerPort;
+  }
+};
+
+// for websdk use only
+var getRtcServerDomain = exports.getRtcServerDomain = function getRtcServerDomain(parameters) {
+  var _parameters$rte6;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte6 = parameters.rte) !== null && _parameters$rte6 !== void 0 && _parameters$rte6.rtcServerDomain) {
+    return parameters.rte.rtcServerDomain;
+  }
+};
+
+// for websdk use only
+var getRtcCdsConfig = exports.getRtcCdsConfig = function getRtcCdsConfig(parameters) {
+  var _parameters$rte7;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte7 = parameters.rte) !== null && _parameters$rte7 !== void 0 && _parameters$rte7.rtcCdsConfig) {
+    return parameters.rte.rtcCdsConfig;
+  }
+};
+// for websdk use only
+var getRtcLogConfig = exports.getRtcLogConfig = function getRtcLogConfig(parameters) {
+  var _parameters$rte8;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte8 = parameters.rte) !== null && _parameters$rte8 !== void 0 && _parameters$rte8.rtcLogConfig) {
+    return parameters.rte.rtcLogConfig;
+  }
+};
+// for websdk use only
+var getRtcReportConfig = exports.getRtcReportConfig = function getRtcReportConfig(parameters) {
+  var _parameters$rte9;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte9 = parameters.rte) !== null && _parameters$rte9 !== void 0 && _parameters$rte9.rtcReportConfig) {
+    return parameters.rte.rtcReportConfig;
+  }
+};
+var getRtmIpList = exports.getRtmIpList = function getRtmIpList(parameters) {
+  var _parameters$rte10;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte10 = parameters.rte) !== null && _parameters$rte10 !== void 0 && _parameters$rte10.rtmIpList) {
     return parameters.rte.rtmIpList;
   }
 };
 var getRtmOriginDomains = exports.getRtmOriginDomains = function getRtmOriginDomains(parameters) {
-  var _parameters$rte5;
-  if (parameters !== null && parameters !== void 0 && (_parameters$rte5 = parameters.rte) !== null && _parameters$rte5 !== void 0 && _parameters$rte5.rtmOriginDomains) {
+  var _parameters$rte11;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte11 = parameters.rte) !== null && _parameters$rte11 !== void 0 && _parameters$rte11.rtmOriginDomains) {
     return parameters.rte.rtmOriginDomains;
   }
 };
 var getRtmEventUploadHosts = exports.getRtmEventUploadHosts = function getRtmEventUploadHosts(parameters) {
-  var _parameters$rte6;
-  if (parameters !== null && parameters !== void 0 && (_parameters$rte6 = parameters.rte) !== null && _parameters$rte6 !== void 0 && _parameters$rte6.rtmEventUploadHosts) {
+  var _parameters$rte12;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte12 = parameters.rte) !== null && _parameters$rte12 !== void 0 && _parameters$rte12.rtmEventUploadHosts) {
     return parameters.rte.rtmEventUploadHosts;
   }
 };
 var getRtmLogUploadHosts = exports.getRtmLogUploadHosts = function getRtmLogUploadHosts(parameters) {
-  var _parameters$rte7;
-  if (parameters !== null && parameters !== void 0 && (_parameters$rte7 = parameters.rte) !== null && _parameters$rte7 !== void 0 && _parameters$rte7.rtmLogUploadHosts) {
+  var _parameters$rte13;
+  if (parameters !== null && parameters !== void 0 && (_parameters$rte13 = parameters.rte) !== null && _parameters$rte13 !== void 0 && _parameters$rte13.rtmLogUploadHosts) {
     return parameters.rte.rtmLogUploadHosts;
   }
 };
 var isEndpointRegionDisabled = exports.isEndpointRegionDisabled = function isEndpointRegionDisabled(parameters) {
-  var _parameters$rte8;
-  return (0, _valueCheck.isTrueValue)(parameters === null || parameters === void 0 || (_parameters$rte8 = parameters.rte) === null || _parameters$rte8 === void 0 ? void 0 : _parameters$rte8.disableEndpointRegion);
+  var _parameters$rte14;
+  return (0, _valueCheck.isTrueValue)(parameters === null || parameters === void 0 || (_parameters$rte14 = parameters.rte) === null || _parameters$rte14 === void 0 ? void 0 : _parameters$rte14.disableEndpointRegion);
 };

package/lib/plugin/rtc/electron/client.js

@@ -758,9 +758,7 @@ var AgoraRtcElectronV3AdapterImp = exports.AgoraRtcElectronV3AdapterImp = /*#__P
   }, {
     key: "startLoopbackRecording",
     value: function startLoopbackRecording(sourceId) {
-      // return this._loopbackAudioMixer.startLoopbackRecording(sourceId);
-
-      return 0;
+      return this._loopbackAudioMixer.startLoopbackRecording(sourceId);
     }
   }, {
     key: "stopLoopbackRecording",
@@ -1217,11 +1215,6 @@ var AgoraRtcElectronV3AdapterImp = exports.AgoraRtcElectronV3AdapterImp = /*#__P
         if (localMicrophone && localMicrophone.volume) {
           var _this$_currentMicroph;
           this.rtcClientObservable.notifyObservers('onMicrophoneVolumeIndicationUpdated', (_this$_currentMicroph = this._currentMicrophoneDeviceId) !== null && _this$_currentMicroph !== void 0 ? _this$_currentMicroph : '', Math.floor(localMicrophone.volume / 255 * 100));
-        } else {
-          if (!localMicrophone) {
-            var _this$_currentMicroph2;
-            this.rtcClientObservable.notifyObservers('onMicrophoneVolumeIndicationUpdated', (_this$_currentMicroph2 = this._currentMicrophoneDeviceId) !== null && _this$_currentMicroph2 !== void 0 ? _this$_currentMicroph2 : '', 0);
-          }
         }
         if (hasRemoteAudio) {
           this._clientEventObservable.notifyObservers('onRemoteUserAudioVolumeUpdated', connection, speakers.filter(function (_ref14) {