agora-rte-sdk 3.7.1 → 3.7.3

package/lib/constant.d.ts

@@ -26,5 +26,6 @@ export declare enum AgoraRtcErrorCode {
     PLACEMENT_IS_NOT_RENDERED = 21,
     UNKNOWN_RENDER_TYPE = 22,
     INVALID_ARGUMENT = 23,
-    UNSUPPORT_SCENARIO_TYPE = 24
+    UNSUPPORT_SCENARIO_TYPE = 24,
+    CANNOT_SET_SPEAKER_TO_AGORA_ALD = 25
 }

package/lib/constant.js

@@ -36,5 +36,6 @@ var AgoraRtcErrorCode = exports.AgoraRtcErrorCode = /*#__PURE__*/function (Agora
   AgoraRtcErrorCode[AgoraRtcErrorCode["UNKNOWN_RENDER_TYPE"] = 22] = "UNKNOWN_RENDER_TYPE";
   AgoraRtcErrorCode[AgoraRtcErrorCode["INVALID_ARGUMENT"] = 23] = "INVALID_ARGUMENT";
   AgoraRtcErrorCode[AgoraRtcErrorCode["UNSUPPORT_SCENARIO_TYPE"] = 24] = "UNSUPPORT_SCENARIO_TYPE";
+  AgoraRtcErrorCode[AgoraRtcErrorCode["CANNOT_SET_SPEAKER_TO_AGORA_ALD"] = 25] = "CANNOT_SET_SPEAKER_TO_AGORA_ALD";
   return AgoraRtcErrorCode;
 }({});

package/lib/core/processor/message-handler.d.ts

@@ -1,11 +1,11 @@
 import { AgoraObservable } from '../../imports';
 import { AgoraRteSyncDataStore } from './sequence-msg/data';
 import { AgoraRteSequenceMessage, AgoraRteMessageHandlerObserver, AgoraRteSequenceMessageInUser, AgoraRteSequenceMessageOutUser } from './type';
-import { AgoraRteMediaStreamInfo, AgoraRteSyncSnapshotData } from './struct';
+import { AgoraRteSyncSnapshotData } from './struct';
 import { AgoraRteServiceApi } from '../services/api';
 import { AgoraRtmClient } from '../rtm';
 import { AgoraRtmChannelClient } from '../rtm/channel';
-import { AgoraRteUserInfo } from '../scene/type';
+import { AgoraRteMediaStreamInfo, AgoraRteUserInfo } from '../scene/type';
 export declare class AgoraRteMessageHandle {
     protected readonly logger: import("agora-foundation/lib/logger/type").Logger;
     protected readonly observable: AgoraObservable<Partial<{
@@ -26,8 +26,8 @@ export declare class AgoraRteMessageHandle {
         onUserUpdated: (user: AgoraRteUserInfo, operator?: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
         onRemoteUsersRemoved: (removedUsers: AgoraRteSequenceMessageOutUser[], removedStreamsData: AgoraRteMediaStreamInfo[]) => void;
         onLocalUserRemoved: (user: AgoraRteSequenceMessageOutUser) => void;
-        onLocalUserAdded: (user: AgoraRteSequenceMessageInUser) => void;
-        onUserSubscribe: (subscribeUsers: AgoraRteUserInfo[], operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
+        onLocalUserAdded: (user: AgoraRteSequenceMessageInUser, addedStreamsData: AgoraRteMediaStreamInfo[], removedStreamsData: AgoraRteMediaStreamInfo[]) => void;
+        onUserSubscribe: (subscribeUsers: AgoraRteUserInfo[], addedStreamsData: AgoraRteMediaStreamInfo[], operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
         onUserUnsubscribe: (unsubscribeUsers: AgoraRteUserInfo[], removedStreamsData: AgoraRteMediaStreamInfo[], operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
         onUserCountUpdated: (total: number) => void;
         onUserPropertyUpdated: (userUuid: string, userProperties: Record<string, unknown>, operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;

package/lib/core/processor/message-handler.js

@@ -95,10 +95,10 @@ var _type = require("./type");
 var _struct = require("./struct");
 var _synchronizer = require("./sequence-msg/synchronizer");
 var _messageParser = require("./sequence-msg/message-parser");
-var _type2 = require("../scene/type");
-var _type3 = require("../rtm/type");
+var _type2 = require("../rtm/type");
 var _clone = require("../utilities/clone");
 var _logger = require("../utilities/logger");
+var _diff = require("../utilities/diff");
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
@@ -110,10 +110,12 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       apiService = _ref.apiService,
       rtmClient = _ref.rtmClient;
     (0, _classCallCheck2["default"])(this, AgoraRteMessageHandle);
-    (0, _defineProperty2["default"])(this, "logger", (0, _logger.getLogger)());
+    (0, _defineProperty2["default"])(this, "logger", (0, _logger.createLogger)({
+      prefix: 'AgoraRteMessageHandle'
+    }));
     (0, _defineProperty2["default"])(this, "observable", new _imports.AgoraObservable());
     (0, _defineProperty2["default"])(this, "_timestampGap", 0);
-    (0, _defineProperty2["default"])(this, "_rtmConnectionState", _type3.AgoraRtmConnectionState.DISCONNECTED);
+    (0, _defineProperty2["default"])(this, "_rtmConnectionState", _type2.AgoraRtmConnectionState.DISCONNECTED);
     this._onSeqMessage = this._onSeqMessage.bind(this);
     this.handleSeqMessage = this.handleSeqMessage.bind(this);
     this._handleUserSubscribe = this._handleUserSubscribe.bind(this);
@@ -136,6 +138,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
     });
     this._addMessageEventListeners();
     this._addConnectionEventListeners();
+    this.logger.info('initialized, sceneId:', this.sceneId);
   }
   return (0, _createClass2["default"])(AgoraRteMessageHandle, [{
     key: "setUserId",
@@ -172,9 +175,9 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
   }, {
     key: "_onConnectionStateUpdated",
     value: function _onConnectionStateUpdated(state) {
-      if ((this._rtmConnectionState === _type3.AgoraRtmConnectionState.RECONNECTING || this._rtmConnectionState === _type3.AgoraRtmConnectionState.CONNECTING) && state === _type3.AgoraRtmConnectionState.CONNECTED) {
+      if ((this._rtmConnectionState === _type2.AgoraRtmConnectionState.RECONNECTING || this._rtmConnectionState === _type2.AgoraRtmConnectionState.CONNECTING) && state === _type2.AgoraRtmConnectionState.CONNECTED) {
         var syncCount = 100;
-        this.logger.info("[RteMessageHandle] RTM connection state updated to connected, start sync sequence for last ".concat(syncCount));
+        this.logger.info("RTM connection state updated to connected, start sync sequence for last ".concat(syncCount));
         this._channelMessageSynchronizer.syncSequence(syncCount);
         this._peerMessageSynchronizer.syncSequence(syncCount);
       }
@@ -213,7 +216,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
               var packet = seqMessageParser.parsePacket(message);
               _this._handleSequenceMessagePacket(packet, _this._channelMessageSynchronizer);
             } catch (e) {
-              _this.logger.error("[RteMessageHandle] ".concat(e.message, " original: ").concat(message));
+              _this.logger.error("".concat(e.message, " original: ").concat(message));
             }
           }
         }
@@ -222,7 +225,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
   }, {
     key: "handleSnapshot",
     value: function handleSnapshot(snapshot) {
-      this.logger.info('[RteMessageHandle] snapshot loaded:', snapshot);
+      this.logger.info("snapshot loaded: ".concat(snapshot));
       this._dataStore.setUsers(snapshot.users);
       this._dataStore.setStreams(snapshot.streams);
       this._dataStore.setRoomProperties(snapshot.roomProperties);
@@ -235,7 +238,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       var _this2 = this;
       var tasks = packet.list;
       if (packet.startSequence) {
-        this.logger.info("[RteMessageHandle] add ".concat(packet.total, " tasks to ").concat(messageSynchronizer.sequenceTypeLabel, " queue, start: ").concat(packet.startSequence, ", total: ").concat(packet.total));
+        this.logger.info("add ".concat(packet.total, " tasks to ").concat(messageSynchronizer.sequenceTypeLabel, " queue, start: ").concat(packet.startSequence, ", total: ").concat(packet.total));
         messageSynchronizer.addTasks(tasks);
       } else {
         tasks.forEach(function (task) {
@@ -256,7 +259,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
             this._handleSequenceMessagePacket(packet, this._peerMessageSynchronizer);
           }
         } catch (e) {
-          this.logger.error("[RteMessageHandle] ".concat(e.message, " original: ").concat(message));
+          this.logger.error("".concat(e.message, " original: ").concat(message));
         }
       }
     }
@@ -314,7 +317,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
           this._handleCustomMessage(task);
           break;
         default:
-          this.logger.warn("[RteMessageHandle] unknown message cmd: ".concat(cmd, ", data: ").concat(JSON.stringify(task)));
+          this.logger.warn("unknown message cmd: ".concat(cmd, ", data: ").concat(JSON.stringify(task)));
       }
     }
   }, {
@@ -345,7 +348,8 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         var userUuid = fromUser.userUuid;
         var user = _this3._dataStore.findUser(userUuid);
         if (!user) {
-          return _this3.logger.warn("[RteMessageHandle] user ".concat(userUuid, " not exists, update property failed"));
+          _this3.logger.warn("user ".concat(userUuid, " not exists, update property failed"));
+          return;
         }
         var mergedProperties = _this3._mergeProperties((_user$userProperties = user.userProperties) !== null && _user$userProperties !== void 0 ? _user$userProperties : {}, changeProperties);
         user.setUserProperties(mergedProperties);
@@ -356,7 +360,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       });
       this.observable.notifyObservers('onUserPropertyListUpdated', changedProperties,
       // FIXME: get real connector
-      _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+      _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
     }
   }, {
     key: "_mergeProperties",
@@ -366,7 +370,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         var key = _Object$keys[_i];
         var originalPaths = key.split('.');
         if (originalPaths.length === 0) {
-          this.logger.error("[RteMessageHandle] invalid key when batch set room properties ".concat(key));
+          this.logger.error("invalid key when batch set room properties ".concat(key));
           continue;
         }
         var paths = originalPaths.filter(function (path) {
@@ -417,11 +421,11 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       if (action === _type.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
         this.observable.notifyObservers('onRoomPropertyUpdated', changeProperties, changedKeys,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       } else {
         this.observable.notifyObservers('onRoomPropertyDeleted', changedKeys,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       }
 
       //
@@ -437,6 +441,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         cause = data.cause;
       var subscribeUsersData = [];
       var unsubscribeUsersData = [];
+      var addedStreamsData = [];
       var removedStreamsData = [];
       users.forEach(function (u) {
         var user;
@@ -444,7 +449,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
           user = _this4._dataStore.findUser(_this4.userId);
           user.userRole = u.role;
         } else {
-          user = _type2.AgoraRteUser.fromSeqData(u);
+          user = _struct.AgoraRteUser.fromSeqData(u);
         }
         if (u.subscribe === _type.AgoraRteSequenceMessageSubscribeUserState.SUBSCRIBE) {
           _this4._dataStore.setUser(user.userId, user);
@@ -452,6 +457,9 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
             streams = _u$streams === void 0 ? [] : _u$streams;
           streams.forEach(function (streamData) {
             var stream = _struct.AgoraRteMediaStream.fromData(streamData, user);
+            if (!_this4._dataStore.findStream(stream.streamId)) {
+              addedStreamsData.push(stream);
+            }
             _this4._dataStore.setStream(stream.streamId, stream);
           });
           subscribeUsersData.push(user);
@@ -463,7 +471,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
           _this4._dataStore.deleteStreams(streamUuids);
           if (_this4.userId !== u.userUuid) {
             _this4._dataStore.deleteUser(u.userUuid);
-            _this4.logger.info("[RteMessageHandle] unsubscribe remote user, delete user and streams from data store, userUuid: ".concat(u.userUuid, ", streams: ").concat(streamUuids.join(',')));
+            _this4.logger.info("unsubscribe remote user, delete user and streams from data store, userUuid: ".concat(u.userUuid, ", streams: ").concat(streamUuids.join(',')));
           } else {
             _this4.logger.info('unsubscribe local user');
           }
@@ -474,14 +482,14 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         }
       });
       if (subscribeUsersData.length > 0) {
-        this.observable.notifyObservers('onUserSubscribe', subscribeUsersData,
+        this.observable.notifyObservers('onUserSubscribe', subscribeUsersData, addedStreamsData,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       }
       if (unsubscribeUsersData.length > 0) {
         this.observable.notifyObservers('onUserUnsubscribe', unsubscribeUsersData, removedStreamsData,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       }
     }
   }, {
@@ -551,7 +559,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       // 处理上线用户
       remoteUsers.online.forEach(function (userData) {
         try {
-          var user = _type2.AgoraRteUser.fromSeqData(userData);
+          var user = _struct.AgoraRteUser.fromSeqData(userData);
           _this6._dataStore.setUser(user.userId, user);
 
           // 处理用户流
@@ -568,7 +576,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
           });
           addedUsers.push(userData);
         } catch (error) {
-          _this6.logger.error("[RteMessageHandle] Failed to process online remote user: ".concat(userData.userUuid), error);
+          _this6.logger.error("failed to process online remote user: ".concat(userData.userUuid), error);
         }
       });
 
@@ -585,9 +593,9 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
             removedStreams.push.apply(removedStreams, (0, _toConsumableArray2["default"])(streams));
           }
           removedUsers.push(userData);
-          _this6.logger.info("[RteMessageHandle] Removed remote user and streams, userUuid: ".concat(userData.userUuid, ", streams: ").concat(streamUuids.join(',')));
+          _this6.logger.info("removed remote user and streams, userUuid: ".concat(userData.userUuid, ", streams: ").concat(streamUuids.join(',')));
         } catch (error) {
-          _this6.logger.error("[RteMessageHandle] Failed to process offline remote user: ".concat(userData.userUuid), error);
+          _this6.logger.error("Failed to process offline remote user: ".concat(userData.userUuid), error);
         }
       });
       this._notifyRemoteUserChanges(addedUsers, removedUsers, removedStreams);
@@ -599,15 +607,26 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
   }, {
     key: "_processLocalUsers",
     value: function _processLocalUsers(localUsers) {
+      var _this7 = this;
       // 处理本地用户上线 - 查找当前用户的上线信息
       var currentUserOnline = this._findCurrentUserInList(localUsers.online);
       if (currentUserOnline) {
-        var user = this._dataStore.findUser(currentUserOnline.userUuid);
-        if (user && user.userRole !== currentUserOnline.role) {
-          user.userRole = currentUserOnline.role;
-          this.observable.notifyObservers('onUserSubscribe', [user], _type2.AgoraRteUser.fromSeqData(currentUserOnline));
+        var localStreams = this._dataStore.findUserStreams(this.userId);
+        var localUserInfo = this._dataStore.findUser(this.userId);
+        if (!localUserInfo) {
+          this.logger.error("local user info not found for userId: ".concat(this.userId));
+          return;
         }
-        this.observable.notifyObservers('onLocalUserAdded', currentUserOnline);
+        var _diffStreams = (0, _diff.diffStreams)(currentUserOnline.streams || [], localStreams, localUserInfo),
+          addedStreams = _diffStreams.addedStreams,
+          removedStreams = _diffStreams.removedStreams;
+        removedStreams.forEach(function (stream) {
+          _this7.dataStore.deleteStream(stream.streamId);
+        });
+        addedStreams.forEach(function (stream) {
+          _this7.dataStore.setStream(stream.streamId, stream);
+        });
+        this.observable.notifyObservers('onLocalUserAdded', currentUserOnline, addedStreams, removedStreams);
       }
 
       // 处理本地用户下线 - 查找当前用户的下线信息
@@ -623,12 +642,12 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
   }, {
     key: "_findCurrentUserInList",
     value: function _findCurrentUserInList(userList) {
-      var _this7 = this;
+      var _this8 = this;
       if (!this.userId || userList.length === 0) {
         return undefined;
       }
       return userList.find(function (user) {
-        return user.userUuid === _this7.userId;
+        return user.userUuid === _this8.userId;
       });
     }
 
@@ -657,12 +676,12 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         operator = data.operator;
       var user = this._dataStore.findUser(userUuid);
       if (!user) {
-        return this.logger.warn("[RteMessageHandle] user ".concat(userUuid, " not exists, update info failed"));
+        return this.logger.warn("user ".concat(userUuid, " not exists, update info failed"));
       }
       user.userName = userName;
       this.observable.notifyObservers('onUserUpdated', user,
       // FIXME: get real connector
-      _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)));
+      _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)));
     }
   }, {
     key: "_handleUserProperty",
@@ -682,21 +701,21 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       var userUuid = fromUser.userUuid;
       var user = this._dataStore.findUser(userUuid);
       if (!user) {
-        return this.logger.warn("[RteMessageHandle] user ".concat(userUuid, " not exists, update property failed"));
+        return this.logger.warn("user ".concat(userUuid, " not exists, update property failed"));
       }
       var mergedProperties = this._mergeProperties((_user$userProperties2 = user.userProperties) !== null && _user$userProperties2 !== void 0 ? _user$userProperties2 : {}, changeProperties);
       user.setUserProperties(mergedProperties);
       if (action === _type.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
         this.observable.notifyObservers('onUserPropertyUpdated', userUuid, changeProperties,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       } else {
         var changedKeys = Array.from(new Set(Object.keys(changeProperties).map(function (k) {
           return k.split('.')[0];
         })));
         this.observable.notifyObservers('onUserPropertyDeleted', userUuid, changedKeys,
         // FIXME: get real connector
-        _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       }
     }
   }, {
@@ -723,17 +742,17 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         cause = data.cause;
       var user = this._dataStore.findUser(data.fromUser.userUuid);
       if (!user) {
-        this.logger.warn("[RteMessageHandle] user not found when handle stream inout, userId: ".concat(data.fromUser.userUuid));
+        this.logger.warn("user not found when handle stream inout, userId: ".concat(data.fromUser.userUuid));
         return;
       }
       var stream = _struct.AgoraRteMediaStream.fromData(data, user);
       var eventType = this._processStreamEvent(action, stream);
-      this.observable.notifyObservers(eventType, [stream], operator && _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+      this.observable.notifyObservers(eventType, [stream], operator && _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
     }
   }, {
     key: "_handleStreamsInOut",
     value: function _handleStreamsInOut(task) {
-      var _this8 = this;
+      var _this9 = this;
       var data = task.data;
       var streams = data.streams,
         operator = data.operator,
@@ -742,13 +761,13 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       streams.forEach(function (streamData) {
         var action = streamData.action,
           fromUser = streamData.fromUser;
-        var user = _this8._dataStore.findUser(fromUser.userUuid);
+        var user = _this9._dataStore.findUser(fromUser.userUuid);
         if (!user) {
-          _this8.logger.warn("[RteMessageHandle] user not found when handle streams inout, userId: ".concat(fromUser.userUuid));
+          _this9.logger.warn("user not found when handle streams inout, userId: ".concat(fromUser.userUuid));
           return;
         }
         var stream = _struct.AgoraRteMediaStream.fromData(streamData, user);
-        var eventType = _this8._processStreamEvent(action, stream);
+        var eventType = _this9._processStreamEvent(action, stream);
         if (!eventMap.has(eventType)) {
           eventMap.set(eventType, [stream]);
         } else {
@@ -756,7 +775,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         }
       });
       eventMap.forEach(function (value, key) {
-        _this8.observable.notifyObservers(key, value, operator && _type2.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
+        _this9.observable.notifyObservers(key, value, operator && _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       });
     }
   }, {

package/lib/core/processor/sequence-msg/data.d.ts

@@ -1,7 +1,7 @@
-import { AgoraRteUser } from '../../scene/type';
-import { AgoraRteMediaStream } from '../struct';
+import { AgoraRteMediaStream, AgoraRteUser } from '../struct';
 import { Immutable } from '../../../imports';
 export declare class AgoraRteSyncDataStore {
+    protected logger: import("agora-foundation/lib/logger/type").Logger;
     private _userCount;
     private _users;
     private _streams;

package/lib/core/processor/sequence-msg/data.js

@@ -1,7 +1,38 @@
 "use strict";
 
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.symbol.to-primitive.js");
+require("core-js/modules/es.error.cause.js");
+require("core-js/modules/es.error.to-string.js");
+require("core-js/modules/es.array.is-array.js");
+require("core-js/modules/es.array.push.js");
+require("core-js/modules/es.date.to-primitive.js");
+require("core-js/modules/es.function.bind.js");
+require("core-js/modules/es.function.name.js");
+require("core-js/modules/es.map.js");
+require("core-js/modules/es.number.constructor.js");
+require("core-js/modules/es.object.create.js");
 require("core-js/modules/es.object.define-property.js");
+require("core-js/modules/es.object.get-own-property-descriptor.js");
+require("core-js/modules/esnext.function.metadata.js");
+require("core-js/modules/esnext.map.delete-all.js");
+require("core-js/modules/esnext.map.emplace.js");
+require("core-js/modules/esnext.map.every.js");
+require("core-js/modules/esnext.map.filter.js");
+require("core-js/modules/esnext.map.find.js");
+require("core-js/modules/esnext.map.find-key.js");
+require("core-js/modules/esnext.map.includes.js");
+require("core-js/modules/esnext.map.key-of.js");
+require("core-js/modules/esnext.map.map-keys.js");
+require("core-js/modules/esnext.map.map-values.js");
+require("core-js/modules/esnext.map.merge.js");
+require("core-js/modules/esnext.map.reduce.js");
+require("core-js/modules/esnext.map.some.js");
+require("core-js/modules/esnext.map.update.js");
+require("core-js/modules/esnext.symbol.metadata.js");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -14,13 +45,25 @@ require("core-js/modules/es.string.iterator.js");
 require("core-js/modules/esnext.iterator.constructor.js");
 require("core-js/modules/esnext.iterator.filter.js");
 require("core-js/modules/web.dom-collections.iterator.js");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 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 _AgoraRteSyncDataStore;
+var _initProto;
+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 AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/function () {
   function AgoraRteSyncDataStore() {
     (0, _classCallCheck2["default"])(this, AgoraRteSyncDataStore);
+    (0, _defineProperty2["default"])(this, "logger", (_initProto(this), (0, _logger.createLogger)({
+      prefix: 'AgoraRteSyncDataStore'
+    })));
     (0, _defineProperty2["default"])(this, "_userCount", 0);
     (0, _defineProperty2["default"])(this, "_users", _imports.Immutable.Map());
     (0, _defineProperty2["default"])(this, "_streams", _imports.Immutable.Map());
@@ -109,4 +152,9 @@ var AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/functio
       this._userCount = userCount;
     }
   }]);
-}();
+}();
+_AgoraRteSyncDataStore = AgoraRteSyncDataStore;
+var _applyDecs$e = _applyDecs(_AgoraRteSyncDataStore, [[_imports.trace, 2, "setUsers"], [_imports.trace, 2, "setUser"], [_imports.trace, 2, "deleteUser"], [_imports.trace, 2, "setStreams"], [_imports.trace, 2, "setStream"], [_imports.trace, 2, "deleteStream"], [_imports.trace, 2, "deleteStreams"]], []).e;
+var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
+_initProto = _applyDecs$e2[0];
+_applyDecs$e;

package/lib/core/processor/sequence-msg/synchronizer.d.ts

@@ -4,7 +4,7 @@ import { AgoraRteServiceApi } from '../../services/api';
 import { Logger, AgoraObservable } from '../../../imports';
 export declare class AgoraRteSynchronizer {
     protected logger: Logger;
-    protected readonly observable: AgoraObservable<AgoraRteSynchronizerObserver>;
+    protected observable: AgoraObservable<AgoraRteSynchronizerObserver>;
     private _apiService;
     private _userId?;
     private _sceneId;

package/lib/core/processor/sequence-msg/synchronizer.js

@@ -32,7 +32,9 @@ var AgoraRteSynchronizer = exports.AgoraRteSynchronizer = /*#__PURE__*/function
       sceneId = _ref.sceneId,
       sequenceType = _ref.sequenceType;
     (0, _classCallCheck2["default"])(this, AgoraRteSynchronizer);
-    (0, _defineProperty2["default"])(this, "logger", (0, _logger.getLogger)());
+    (0, _defineProperty2["default"])(this, "logger", (0, _logger.createLogger)({
+      prefix: 'AgoraRteSynchronizer'
+    }));
     (0, _defineProperty2["default"])(this, "observable", new _imports.AgoraObservable());
     (0, _defineProperty2["default"])(this, "_queueTasks", []);
     (0, _defineProperty2["default"])(this, "_lastSeq", -1);
@@ -48,7 +50,7 @@ var AgoraRteSynchronizer = exports.AgoraRteSynchronizer = /*#__PURE__*/function
         _this.logger.debug("[".concat(_this.sequenceTypeLabel, "] message handle queue clear"));
         return;
       } else {
-        _this.logger.debug("[".concat(_this.sequenceTypeLabel, "] process task, current"), task);
+        _this.logger.debug("[".concat(_this.sequenceTypeLabel, "] process task: ").concat((0, _imports.jsonstring)(task)));
         _this._currentTask = task;
         _this.processTask(_this._currentTask).then(function () {
           _this._currentTask = undefined;
@@ -63,6 +65,7 @@ var AgoraRteSynchronizer = exports.AgoraRteSynchronizer = /*#__PURE__*/function
     this._apiService = apiService;
     this._sceneId = sceneId;
     this._sequenceType = sequenceType;
+    this.logger.info("initialized, sceneId: ".concat(this._sceneId, ", sequenceType: ").concat(this.sequenceTypeLabel));
   }
   return (0, _createClass2["default"])(AgoraRteSynchronizer, [{
     key: "sequenceTypeLabel",
@@ -111,7 +114,7 @@ var AgoraRteSynchronizer = exports.AgoraRteSynchronizer = /*#__PURE__*/function
     value: function addTasks(tasks) {
       var _this$_queueTasks;
       (_this$_queueTasks = this._queueTasks).push.apply(_this$_queueTasks, (0, _toConsumableArray2["default"])(tasks));
-      this.logger.debug("[".concat(this.sequenceTypeLabel, "] addTasks"), this._queueTasks);
+      this.logger.debug("[".concat(this.sequenceTypeLabel, "] addTasks: ").concat((0, _imports.jsonstring)(this._queueTasks)));
       this.sortTasks();
       this.notifyTaskQueueUpdate();
     }
@@ -142,7 +145,6 @@ var AgoraRteSynchronizer = exports.AgoraRteSynchronizer = /*#__PURE__*/function
   }, {
     key: "dequeueTask",
     value: function dequeueTask() {
-      this.logger.debug("[".concat(this.sequenceTypeLabel, "] dequeueTask"), this._queueTasks);
       if (this._queueTasks.length === 0) {
         return null;
       } else {

package/lib/core/processor/struct.d.ts

@@ -1,18 +1,23 @@
-import { AgoraRteRoomData, AgoraRteRoomStateData, AgoraRteStreamData } from './type';
+import { AgoraRteRoomData, AgoraRteRoomStateData, AgoraRteStreamData, AgoraRteUserData } from './type';
 import { AgoraRteAudioSourceType, AgoraRteMediaSourceState, AgoraRteVideoSourceType } from '../../type';
-import { AgoraRteMediaStreamType, AgoraRteRoomConnectorType, AgoraRteUser, AgoraRteUserInfo } from '../scene/type';
-export interface AgoraRteMediaStreamInfo {
-    readonly streamId: string;
-    readonly streamName?: string;
-    readonly owner: AgoraRteUserInfo;
-    readonly streamType: AgoraRteMediaStreamType;
-    readonly videoSourceType: AgoraRteVideoSourceType;
-    readonly audioSourceType: AgoraRteAudioSourceType;
-    readonly videoSourceState: AgoraRteMediaSourceState;
-    readonly audioSourceState: AgoraRteMediaSourceState;
-    readonly videoSourceId?: string;
-    readonly audioSourceId?: string;
-    readonly connectorType: AgoraRteRoomConnectorType;
+import { AgoraRteMediaStreamInfo, AgoraRteMediaStreamType, AgoraRteRoomConnectorType, AgoraRteUserInfo } from '../scene/type';
+export declare class AgoraRteUser implements AgoraRteUserInfo {
+    static fromSeqData(data: AgoraRteUserData): AgoraRteUser;
+    userId: string;
+    userName: string;
+    userRole: string;
+    userProperties: Record<string, unknown>;
+    connectorType: AgoraRteRoomConnectorType;
+    constructor(data: {
+        userId: string;
+        userName: string;
+        userRole: string;
+        userProperties?: Record<string, unknown>;
+        connectorType: AgoraRteRoomConnectorType;
+    });
+    setUserProperties(properties: Record<string, unknown>): void;
+    toInfo(): AgoraRteUserInfo;
+    toString(): string;
 }
 export declare class AgoraRteMediaStream implements AgoraRteMediaStreamInfo {
     static fromData(data: AgoraRteStreamData, owner: AgoraRteUserInfo): AgoraRteMediaStream;
@@ -28,8 +33,8 @@ export declare class AgoraRteMediaStream implements AgoraRteMediaStreamInfo {
     audioSourceId?: string;
     connectorType: AgoraRteRoomConnectorType;
     constructor(data: AgoraRteMediaStreamInfo);
-    toString(): string;
     toInfo(): AgoraRteMediaStreamInfo;
+    toString(): string;
 }
 export declare class AgoraRteRoom {
     static fromData(data: AgoraRteRoomData): AgoraRteRoom;
@@ -42,6 +47,7 @@ export declare class AgoraRteRoomState {
     static fromData(data: AgoraRteRoomStateData): AgoraRteRoomState;
     total: number;
     constructor(data: AgoraRteRoomStateData);
+    toString(): string;
 }
 export declare class AgoraRteSyncSnapshotData {
     static fromData(data: AgoraRteSyncSnapshotInitData): AgoraRteSyncSnapshotData;
@@ -52,6 +58,7 @@ export declare class AgoraRteSyncSnapshotData {
     room: AgoraRteRoom;
     roomState: AgoraRteRoomState;
     constructor(data: AgoraRteSyncSnapshotInitData);
+    toString(): string;
 }
 export type AgoraRteSyncSnapshotInitData = {
     users: {