agora-rte-sdk 3.9.1 → 3.10.0-beta

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

@@ -15,6 +15,11 @@ export interface AgoraRteMonitor {
      * @returns A promise that resolves when the log files have been uploaded.
      */
     uploadLog(meta: object, logBasePath?: string): Promise<void>;
+    /**
+     * Queries the device score.
+     * @returns The device score.
+     */
+    queryDeviceScore(): number;
     /**
      * Releases all resources used by the AgoraRteMonitor.
      */

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

@@ -39,7 +39,8 @@ export declare class AgoraRteMessageHandle {
         onRemoteStreamUpdated: (streams: AgoraRteMediaStreamInfo[], operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
         onRemoteStreamRemoved: (streams: AgoraRteMediaStreamInfo[], operator: AgoraRteUserInfo, cause?: import("./type").AgoraRteOperatCause) => void;
         onTimeStampGapUpdate: (gap: number) => void;
-        onCustomChannelMessageRecieved: (message: import("../..").AgoraRteMessage) => void;
+        onCustomChannelMessageRecieved: (message: import("../../type").AgoraRteMessage) => void;
+        onPublishStreamLayerChanged(sceneId: string, events: import("./type").AgoraRteMessageHandlerStreamLayerEvent[]): void;
     }>>;
     private _dataStore;
     private _timestampGap;
@@ -105,6 +106,7 @@ export declare class AgoraRteMessageHandle {
     private _processStreamEvent;
     private _handleStreamInOut;
     private _handleStreamsInOut;
+    private _handleStreamLayerEvent;
     private _handleCustomMessage;
     private _syncTsGapWithServerAndLocal;
     syncSnapshot(snapshot: AgoraRteSyncSnapshotData, channelSequence: number, peerSequence: number): void;

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

@@ -91,6 +91,7 @@ var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/creat
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _imports = require("../../imports");
 var _type = require("../rtm/type");
+var _type2 = require("../../type");
 var _clone = require("../utilities/clone");
 var _diff = require("../utilities/diff");
 var _logger = require("../utilities/logger");
@@ -98,7 +99,7 @@ var _data = require("./sequence-msg/data");
 var _messageParser = require("./sequence-msg/message-parser");
 var _struct = require("./struct");
 var _synchronizer = require("./synchronizer");
-var _type2 = require("./type");
+var _type3 = require("./type");
 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; }
@@ -131,13 +132,13 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
     this._channelMessageSynchronizer = new _synchronizer.AgoraRteSynchronizerManager({
       apiService: apiService,
       sceneId: sceneId,
-      sequenceType: _type2.AgoraRteSequenceType.CHANNEL_SEQUENCE,
+      sequenceType: _type3.AgoraRteSequenceType.CHANNEL_SEQUENCE,
       userId: userId
     });
     this._peerMessageSynchronizer = new _synchronizer.AgoraRteSynchronizerManager({
       apiService: apiService,
       sceneId: sceneId,
-      sequenceType: _type2.AgoraRteSequenceType.PEER_SEQUENCE,
+      sequenceType: _type3.AgoraRteSequenceType.PEER_SEQUENCE,
       userId: userId
     });
 
@@ -290,6 +291,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       this._dataStore.setStreams(snapshot.streams);
       this._dataStore.setRoomProperties(snapshot.roomProperties);
       this._dataStore.setUserCount(snapshot.roomState.total);
+      this._dataStore.setStreamLayerConfigs(snapshot.streamLayerConfigs);
       this.observable.notifyObservers('onSnapshotUpdated', snapshot);
     }
   }, {
@@ -302,7 +304,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         messageSynchronizer.addTasks(tasks);
       } else {
         tasks.forEach(function (task) {
-          if (task.cmd === _type2.AgoraRteServerMessageCmd.MESSAGE_EXTENSION) {
+          if (task.cmd === _type3.AgoraRteServerMessageCmd.MESSAGE_EXTENSION) {
             _this2._handleCustomMessage(task);
           }
         });
@@ -344,36 +346,39 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
     key: "_handleSimpleMessage",
     value: function _handleSimpleMessage(task, cmd) {
       switch (cmd) {
-        case _type2.AgoraRteServerMessageCmd.ROOM_PROPERTY:
+        case _type3.AgoraRteServerMessageCmd.ROOM_PROPERTY:
           // room property change struct aligns with properties so use the same handling func
           this._handleRoomProperties(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.ROOM_PROPERTIES:
+        case _type3.AgoraRteServerMessageCmd.ROOM_PROPERTIES:
           this._handleRoomProperties(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.USER_IN_OUT:
+        case _type3.AgoraRteServerMessageCmd.USER_IN_OUT:
           this._handleUserInOut(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.USER_INFO:
+        case _type3.AgoraRteServerMessageCmd.USER_INFO:
           this._handleUserInfo(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.USER_PROPERTY:
+        case _type3.AgoraRteServerMessageCmd.USER_PROPERTY:
           this._handleUserProperty(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.USER_PROPERTIES:
-        case _type2.AgoraRteServerMessageCmd.USER_PRIVATE_PROPERTIES:
+        case _type3.AgoraRteServerMessageCmd.USER_PROPERTIES:
+        case _type3.AgoraRteServerMessageCmd.USER_PRIVATE_PROPERTIES:
           this._handleUserProperties(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.USER_SUBSCRIBE:
+        case _type3.AgoraRteServerMessageCmd.USER_SUBSCRIBE:
           this._handleUserSubscribe(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.STREAM_IN_OUT:
+        case _type3.AgoraRteServerMessageCmd.STREAM_IN_OUT:
           this._handleStreamInOut(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.STREAMS_IN_OUT:
+        case _type3.AgoraRteServerMessageCmd.STREAMS_IN_OUT:
           this._handleStreamsInOut(task);
           break;
-        case _type2.AgoraRteServerMessageCmd.MESSAGE_EXTENSION:
+        case _type3.AgoraRteServerMessageCmd.STREAM_LAYER:
+          this._handleStreamLayerEvent(task);
+          break;
+        case _type3.AgoraRteServerMessageCmd.MESSAGE_EXTENSION:
           this._handleCustomMessage(task);
           break;
         default:
@@ -384,7 +389,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
     key: "_handleBatchMessage",
     value: function _handleBatchMessage(task, cmd) {
       switch (cmd) {
-        case _type2.AgoraRteServerMessageCmd.USER_PROPERTIES:
+        case _type3.AgoraRteServerMessageCmd.USER_PROPERTIES:
           this._handleUserPropertyList(task);
           break;
       }
@@ -478,7 +483,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       var changedKeys = Array.from(new Set(Object.keys(changeProperties).map(function (k) {
         return k.split('.')[0];
       })));
-      if (action === _type2.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
+      if (action === _type3.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
         this.observable.notifyObservers('onRoomPropertyUpdated', changeProperties, changedKeys,
         // FIXME: get real connector
         _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
@@ -511,7 +516,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         } else {
           user = _struct.AgoraRteUser.fromSeqData(u);
         }
-        if (u.subscribe === _type2.AgoraRteSequenceMessageSubscribeUserState.SUBSCRIBE) {
+        if (u.subscribe === _type3.AgoraRteSequenceMessageSubscribeUserState.SUBSCRIBE) {
           _this4._dataStore.setUser(user.userId, user);
           var _u$streams = u.streams,
             streams = _u$streams === void 0 ? [] : _u$streams;
@@ -523,7 +528,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
             _this4._dataStore.setStream(stream.streamId, stream);
           });
           subscribeUsersData.push(user);
-        } else if (u.subscribe === _type2.AgoraRteSequenceMessageSubscribeUserState.UNSUBSCRIBE) {
+        } else if (u.subscribe === _type3.AgoraRteSequenceMessageSubscribeUserState.UNSUBSCRIBE) {
           var _streams = _this4._dataStore.findUserStreams(u.userUuid);
           var streamUuids = _streams.map(function (stream) {
             return stream.streamId;
@@ -766,7 +771,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
       }
       var mergedProperties = this._mergeProperties((_user$userProperties2 = user.userProperties) !== null && _user$userProperties2 !== void 0 ? _user$userProperties2 : {}, changeProperties);
       user.setUserProperties(mergedProperties);
-      if (action === _type2.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
+      if (action === _type3.AgoraRteSequenceMessagePropertiesAction.UPSERT) {
         this.observable.notifyObservers('onUserPropertyUpdated', userUuid, changeProperties,
         // FIXME: get real connector
         _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
@@ -839,6 +844,26 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
         _this9.observable.notifyObservers(key, value, operator && _struct.AgoraRteUser.fromSeqData(_objectSpread({}, operator)), cause);
       });
     }
+  }, {
+    key: "_handleStreamLayerEvent",
+    value: function _handleStreamLayerEvent(tast) {
+      var data = tast.data;
+      var streamUuid = data.streamUuid,
+        streamLayer = data.streamLayer,
+        cause = data.cause;
+      var newMask;
+      if (streamLayer === 0) {
+        newMask = _type2.AgoraRteStreamLayer.LOW;
+      } else {
+        newMask = streamLayer;
+      }
+      this._dataStore.setStreamLayerConfig(streamUuid, newMask);
+      this.observable.notifyObservers('onPublishStreamLayerChanged', this.sceneId, [{
+        streamId: streamUuid,
+        streamLayersBitMask: newMask,
+        cause: cause
+      }]);
+    }
   }, {
     key: "_handleCustomMessage",
     value: function _handleCustomMessage(task) {
@@ -858,7 +883,7 @@ var AgoraRteMessageHandle = exports.AgoraRteMessageHandle = /*#__PURE__*/functio
     key: "_syncTsGapWithServerAndLocal",
     value: function _syncTsGapWithServerAndLocal(task) {
       var gap = task.ts - Date.now();
-      if (this._timestampGap !== gap && Math.abs(this._timestampGap - gap) > 800) {
+      if (this._timestampGap !== gap) {
         // 🕛 时间间隔大于800ms就更新
         this._timestampGap = gap;
         // emit upper

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

@@ -1,10 +1,13 @@
 import { AgoraRteMediaStream, AgoraRteUser } from '../struct';
 import { Immutable } from '../../../imports';
+import { AgoraRteReturnCode } from '../../../constant';
+import { AgoraRteStreamLayer } from '../../../type';
 export declare class AgoraRteSyncDataStore {
     protected logger: import("agora-foundation/lib/logger/type").Logger;
     private _userCount;
     private _users;
     private _streams;
+    private _streamLayerConfigs;
     private _roomProperties;
     get users(): Immutable.Map<string, AgoraRteUser>;
     setUsers(users: Record<string, AgoraRteUser>): number;
@@ -20,6 +23,10 @@ export declare class AgoraRteSyncDataStore {
     deleteStream(key: string): number;
     deleteStreams(keys: string[]): number;
     findStream(streamUuid: string): AgoraRteMediaStream | undefined;
+    setStreamLayerConfigs(streamLayerConfigs: Record<string, AgoraRteStreamLayer>): AgoraRteReturnCode;
+    setStreamLayerConfig(key: string, streamLayerConfig: AgoraRteStreamLayer): AgoraRteReturnCode;
+    deleteStreamLayerConfig(key: string): AgoraRteReturnCode;
+    getPublishStreamLayersByStreamId(key: string): number;
     get userCount(): number;
     setUserCount(userCount: number): void;
     getRoomPropertiesDeepCloneByKeyPath(keyPath: string): unknown;

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

@@ -53,14 +53,15 @@ var _imports = require("../../../imports");
 var _logger = require("../../utilities/logger");
 var _constant = require("../../../constant");
 var _propertyExtract = require("../../utilities/property-extract");
+var _type = require("../../../type");
 var _AgoraRteSyncDataStore;
-var _initProto, _setUsersDecs, _setUserDecs, _deleteUserDecs, _setStreamsDecs, _setStreamDecs, _deleteStreamDecs, _deleteStreamsDecs, _ref;
+var _initProto, _setUsersDecs, _setUserDecs, _deleteUserDecs, _setStreamsDecs, _setStreamDecs, _deleteStreamDecs, _deleteStreamsDecs, _setStreamLayerConfigsDecs, _setStreamLayerConfigDecs, _deleteStreamLayerConfigDecs, _getPublishStreamLayersByStreamIdDecs, _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; }
-_ref = (_setUsersDecs = (0, _imports.trace)(['users']), _setUserDecs = (0, _imports.trace)(['key', 'user']), _deleteUserDecs = (0, _imports.trace)(['key']), _setStreamsDecs = (0, _imports.trace)(['streams']), _setStreamDecs = (0, _imports.trace)(['key', 'stream']), _deleteStreamDecs = (0, _imports.trace)(['key']), _deleteStreamsDecs = (0, _imports.trace)(['keys']), "logger");
+_ref = (_setUsersDecs = (0, _imports.trace)(['users']), _setUserDecs = (0, _imports.trace)(['key', 'user']), _deleteUserDecs = (0, _imports.trace)(['key']), _setStreamsDecs = (0, _imports.trace)(['streams']), _setStreamDecs = (0, _imports.trace)(['key', 'stream']), _deleteStreamDecs = (0, _imports.trace)(['key']), _deleteStreamsDecs = (0, _imports.trace)(['keys']), _setStreamLayerConfigsDecs = (0, _imports.trace)(['streamLayerConfigs']), _setStreamLayerConfigDecs = (0, _imports.trace)(['key', 'streamLayerConfig']), _deleteStreamLayerConfigDecs = (0, _imports.trace)(['key']), _getPublishStreamLayersByStreamIdDecs = (0, _imports.trace)(['key']), "logger");
 var AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/function () {
   function AgoraRteSyncDataStore() {
     (0, _classCallCheck2["default"])(this, AgoraRteSyncDataStore);
@@ -70,6 +71,7 @@ var AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/functio
     (0, _defineProperty2["default"])(this, "_userCount", 0);
     (0, _defineProperty2["default"])(this, "_users", _imports.Immutable.Map());
     (0, _defineProperty2["default"])(this, "_streams", _imports.Immutable.Map());
+    (0, _defineProperty2["default"])(this, "_streamLayerConfigs", _imports.Immutable.Map());
     (0, _defineProperty2["default"])(this, "_roomProperties", {});
   }
   return (0, _createClass2["default"])(AgoraRteSyncDataStore, [{
@@ -151,6 +153,35 @@ var AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/functio
     value: function findStream(streamUuid) {
       return this._streams.get(streamUuid);
     }
+  }, {
+    key: "setStreamLayerConfigs",
+    value: function setStreamLayerConfigs(streamLayerConfigs) {
+      this._streamLayerConfigs = _imports.Immutable.Map(streamLayerConfigs);
+      return _constant.AgoraRteReturnCode.SUCCESS;
+    }
+  }, {
+    key: "setStreamLayerConfig",
+    value: function setStreamLayerConfig(key, streamLayerConfig) {
+      this._streamLayerConfigs = this._streamLayerConfigs.set(key, streamLayerConfig);
+      return _constant.AgoraRteReturnCode.SUCCESS;
+    }
+  }, {
+    key: "deleteStreamLayerConfig",
+    value: function deleteStreamLayerConfig(key) {
+      this._streamLayerConfigs = this._streamLayerConfigs["delete"](key);
+      return _constant.AgoraRteReturnCode.SUCCESS;
+    }
+  }, {
+    key: "getPublishStreamLayersByStreamId",
+    value: function getPublishStreamLayersByStreamId(key) {
+      var streamLayer = this._streamLayerConfigs.get(key);
+      if (streamLayer !== undefined) {
+        return streamLayer;
+      }
+      this.logger.info("stream layer config not found for stream ".concat(key, ", return low layer as default"));
+      this.setStreamLayerConfig(key, _type.AgoraRteStreamLayer.LOW);
+      return _type.AgoraRteStreamLayer.LOW;
+    }
   }, {
     key: "userCount",
     get: function get() {
@@ -177,7 +208,7 @@ var AgoraRteSyncDataStore = exports.AgoraRteSyncDataStore = /*#__PURE__*/functio
   }]);
 }();
 _AgoraRteSyncDataStore = AgoraRteSyncDataStore;
-var _applyDecs$e = _applyDecs(_AgoraRteSyncDataStore, [[_setUsersDecs, 2, "setUsers"], [_setUserDecs, 2, "setUser"], [_deleteUserDecs, 2, "deleteUser"], [_setStreamsDecs, 2, "setStreams"], [_setStreamDecs, 2, "setStream"], [_deleteStreamDecs, 2, "deleteStream"], [_deleteStreamsDecs, 2, "deleteStreams"]], []).e;
+var _applyDecs$e = _applyDecs(_AgoraRteSyncDataStore, [[_setUsersDecs, 2, "setUsers"], [_setUserDecs, 2, "setUser"], [_deleteUserDecs, 2, "deleteUser"], [_setStreamsDecs, 2, "setStreams"], [_setStreamDecs, 2, "setStream"], [_deleteStreamDecs, 2, "deleteStream"], [_deleteStreamsDecs, 2, "deleteStreams"], [_setStreamLayerConfigsDecs, 2, "setStreamLayerConfigs"], [_setStreamLayerConfigDecs, 2, "setStreamLayerConfig"], [_deleteStreamLayerConfigDecs, 2, "deleteStreamLayerConfig"], [_getPublishStreamLayersByStreamIdDecs, 2, "getPublishStreamLayersByStreamId"]], []).e;
 var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
 _initProto = _applyDecs$e2[0];
 _applyDecs$e;

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

@@ -1,5 +1,5 @@
 import { AgoraRteRoomData, AgoraRteRoomStateData, AgoraRteStreamData, AgoraRteUserData } from './type';
-import { AgoraRteAudioSourceType, AgoraRteMediaSourceState, AgoraRteVideoSourceType } from '../../type';
+import { AgoraRteAudioSourceType, AgoraRteMediaSourceState, AgoraRteStreamLayer, AgoraRteVideoSourceType } from '../../type';
 import { AgoraRteMediaStreamInfo, AgoraRteMediaStreamType, AgoraRteRoomConnectorType, AgoraRteUserInfo } from '../scene/type';
 export declare class AgoraRteUser implements AgoraRteUserInfo {
     static fromSeqData(data: AgoraRteUserData): AgoraRteUser;
@@ -57,6 +57,7 @@ export declare class AgoraRteSyncSnapshotData {
     roomProperties: Record<string, unknown>;
     room: AgoraRteRoom;
     roomState: AgoraRteRoomState;
+    streamLayerConfigs: Record<string, AgoraRteStreamLayer>;
     constructor(data: AgoraRteSyncSnapshotInitData);
     toString(): string;
 }

package/lib/core/processor/struct.js

@@ -23,7 +23,8 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
-var _type = require("../scene/type");
+var _type = require("../../type");
+var _type2 = require("../scene/type");
 var _streamType = require("../scene/helpers/stream-type");
 var _imports = require("../../imports");
 var AgoraRteUser = exports.AgoraRteUser = /*#__PURE__*/function () {
@@ -60,9 +61,9 @@ var AgoraRteUser = exports.AgoraRteUser = /*#__PURE__*/function () {
     key: "fromSeqData",
     value: function fromSeqData(data) {
       var _data$connectorType;
-      var connectorType = (_data$connectorType = data.connectorType) !== null && _data$connectorType !== void 0 ? _data$connectorType : _type.AgoraRteRoomConnectorType.NONE;
-      var isValidConnectorType = connectorType in _type.AgoraRteRoomConnectorType;
-      connectorType = isValidConnectorType ? connectorType : _type.AgoraRteRoomConnectorType.NONE;
+      var connectorType = (_data$connectorType = data.connectorType) !== null && _data$connectorType !== void 0 ? _data$connectorType : _type2.AgoraRteRoomConnectorType.NONE;
+      var isValidConnectorType = connectorType in _type2.AgoraRteRoomConnectorType;
+      connectorType = isValidConnectorType ? connectorType : _type2.AgoraRteRoomConnectorType.NONE;
       return new AgoraRteUser({
         userId: data.userUuid,
         userName: data.userName,
@@ -130,7 +131,7 @@ var AgoraRteMediaStream = exports.AgoraRteMediaStream = /*#__PURE__*/function ()
         videoSourceId: data.videoSourceUuid,
         audioSourceId: data.audioSourceUuid,
         streamType: (0, _streamType.convertPublishStateToStreamType)(data.audioState, data.videoState),
-        connectorType: (_data$connectorType2 = data.connectorType) !== null && _data$connectorType2 !== void 0 ? _data$connectorType2 : _type.AgoraRteRoomConnectorType.NONE
+        connectorType: (_data$connectorType2 = data.connectorType) !== null && _data$connectorType2 !== void 0 ? _data$connectorType2 : _type2.AgoraRteRoomConnectorType.NONE
       });
     }
   }]);
@@ -175,6 +176,7 @@ var AgoraRteSyncSnapshotData = exports.AgoraRteSyncSnapshotData = /*#__PURE__*/f
     (0, _defineProperty2["default"])(this, "users", {});
     (0, _defineProperty2["default"])(this, "streams", {});
     (0, _defineProperty2["default"])(this, "roomProperties", {});
+    (0, _defineProperty2["default"])(this, "streamLayerConfigs", {});
     var sequence = data.sequence,
       users = data.users,
       roomProperties = data.roomProperties,
@@ -187,6 +189,7 @@ var AgoraRteSyncSnapshotData = exports.AgoraRteSyncSnapshotData = /*#__PURE__*/f
         streams = _u$streams === void 0 ? [] : _u$streams;
       streams.forEach(function (s) {
         _this.streams[s.streamUuid] = AgoraRteMediaStream.fromData(s, user);
+        _this.streamLayerConfigs[s.streamUuid] = s.streamLayer || _type.AgoraRteStreamLayer.LOW;
       });
       _this.users[u.userUuid] = user;
     });
@@ -215,7 +218,8 @@ var AgoraRteSyncSnapshotData = exports.AgoraRteSyncSnapshotData = /*#__PURE__*/f
         })),
         roomProperties: this.roomProperties,
         room: this.room,
-        roomState: this.roomState.toString()
+        roomState: this.roomState.toString(),
+        streamLayerConfigs: this.streamLayerConfigs
       });
     }
   }], [{

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

@@ -1,4 +1,4 @@
-import { AgoraRteAudioSourceType, AgoraRteMediaPublishState, AgoraRteMediaSourceState, AgoraRteMessage, AgoraRteVideoSourceType } from '../../type';
+import { AgoraRteAudioSourceType, AgoraRteMediaPublishState, AgoraRteMediaSourceState, AgoraRteMessage, AgoraRteStreamLayer, AgoraRteVideoSourceType } from '../../type';
 import { AgoraRteMediaStreamInfo, AgoraRteMediaStreamType, AgoraRteRoomConnectorType, AgoraRteUserInfo } from '../scene/type';
 import { AgoraRteSyncSnapshotData } from './struct';
 export type MessageExt = {
@@ -26,6 +26,7 @@ export interface AgoraRteStreamData {
     connectorType: AgoraRteRoomConnectorType;
     audioSourceUuid?: string;
     videoSourceUuid?: string;
+    streamLayer?: AgoraRteStreamLayer;
     playUrl?: string;
     flvPlayUrl?: string;
     rtmpPlayUrl?: string;
@@ -89,6 +90,7 @@ export declare enum AgoraRteServerMessageCmd {
     USER_PRIVATE_PROPERTIES = 26,
     STREAM_IN_OUT = 40,
     STREAMS_IN_OUT = 41,
+    STREAM_LAYER = 43,
     MESSAGE_EXTENSION = 99,
     MOCK_RTM = 101
 }
@@ -149,6 +151,7 @@ export type AgoraRteMessageHandlerObserver = Partial<{
     onRemoteStreamRemoved: (streams: AgoraRteMediaStreamInfo[], operator: AgoraRteUserInfo, cause?: AgoraRteOperatCause) => void;
     onTimeStampGapUpdate: (gap: number) => void;
     onCustomChannelMessageRecieved: (message: AgoraRteMessage) => void;
+    onPublishStreamLayerChanged(sceneId: string, events: AgoraRteMessageHandlerStreamLayerEvent[]): void;
 }>;
 export interface AgoraRteSequenceMessageStreamInfo {
     streamUuid: string;
@@ -262,3 +265,15 @@ export type AgoraRteSequenceMessageCustomMessage = {
     };
     payload: unknown;
 };
+export type AgoraRteSequenceMessageStreamLayer = {
+    streamUuid: string;
+    streamLayer: number;
+    addStreamLayer: number;
+    removeStreamLayer: number;
+    cause: Record<string, unknown>;
+};
+export type AgoraRteMessageHandlerStreamLayerEvent = {
+    streamId: string;
+    streamLayersBitMask: number;
+    cause: Record<string, unknown>;
+};

package/lib/core/processor/type.js

@@ -16,6 +16,7 @@ var AgoraRteServerMessageCmd = exports.AgoraRteServerMessageCmd = /*#__PURE__*/f
   AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["USER_PRIVATE_PROPERTIES"] = 26] = "USER_PRIVATE_PROPERTIES";
   AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["STREAM_IN_OUT"] = 40] = "STREAM_IN_OUT";
   AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["STREAMS_IN_OUT"] = 41] = "STREAMS_IN_OUT";
+  AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["STREAM_LAYER"] = 43] = "STREAM_LAYER";
   AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["MESSAGE_EXTENSION"] = 99] = "MESSAGE_EXTENSION";
   AgoraRteServerMessageCmd[AgoraRteServerMessageCmd["MOCK_RTM"] = 101] = "MOCK_RTM";
   return AgoraRteServerMessageCmd;

package/lib/core/rtc/channel.d.ts

@@ -1,5 +1,5 @@
 import { AgoraObservable, AgoraRteRenderView } from '../../imports';
-import { AgoraRtcVideoSnapshot, AgoraRtcEncryptionConfig, AgoraRtcVideoStreamType, AgoraRtcChannelClientObserver, AgoraRtcVideoEncoderConfiguration, AgoraRtcRenderMode } from './type';
+import { AgoraRtcVideoSnapshot, AgoraRtcEncryptionConfig, AgoraRtcChannelClientObserver, AgoraRtcVideoEncoderConfiguration, AgoraRtcRenderMode, AgoraRtcStreamLayer } from './type';
 import { AgoraRtcCanvasHelper } from './canvas';
 import { AgoraRtcChannelPublisher } from './publisher';
 import { AgoraRtcChannelSubscriber } from './subscriber';
@@ -54,7 +54,7 @@ export declare abstract class AgoraRtcChannelClient {
      * @param streamId The ID of the stream.
      * @returns The result of the operation.
      */
-    abstract setVideoEncoderConfig(config: AgoraRtcVideoEncoderConfiguration, streamType: AgoraRtcVideoStreamType, streamId: string): number;
+    abstract setVideoEncoderConfig(config: AgoraRtcVideoEncoderConfiguration, streamLayer: AgoraRtcStreamLayer, streamId: string): number;
     /**
      * Sets the dual stream mode for a local stream.
      * @param streamId The ID of the stream.

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

@@ -43,6 +43,11 @@ export declare abstract class AgoraRtcClient {
      * @param enable
      */
     abstract observeSystemSelectedSpeakerChanged(enable: boolean): number;
+    /**
+     * queryDeviceScore
+     * @returns device score
+     */
+    abstract queryDeviceScore(): number;
     /**
      * Observe the system selected microphone
      * @param enable

package/lib/core/rtc/publisher.d.ts

@@ -1,7 +1,7 @@
 import { AgoraObservable } from '../../imports';
 import { AgoraRtcStreamPublishPool } from './publish-pool';
 import { AgoraRtcSourceManager } from './source-manager';
-import { AgoraRtcAudioSourceType, AgoraRtcChannelPublisherObserver, AgoraRtcLatencyLevelType, AgoraRtcMediaSourceState, AgoraRtcScreenScenarioType, AgoraRtcVideoEncoderConfiguration, AgoraRtcVideoSourceType, AgoraRtcVideoStreamType } from './type';
+import { AgoraRtcAudioSourceType, AgoraRtcChannelPublisherObserver, AgoraRtcLatencyLevelType, AgoraRtcMediaSourceState, AgoraRtcScreenScenarioType, AgoraRtcStreamLayer, AgoraRtcVideoEncoderConfiguration, AgoraRtcVideoSourceType } from './type';
 export declare abstract class AgoraRtcChannelPublisher {
     protected abstract publishPool: AgoraRtcStreamPublishPool;
     protected abstract sourceManager: AgoraRtcSourceManager;
@@ -10,6 +10,7 @@ export declare abstract class AgoraRtcChannelPublisher {
     protected videoEncoderConfigs: Map<string, AgoraRtcVideoEncoderConfiguration>;
     protected screenScenario: AgoraRtcScreenScenarioType;
     protected latencyLevel: AgoraRtcLatencyLevelType;
+    protected streamLayerBitMaskMap: Map<string, number>;
     protected abstract _getCameraState(sourceId: string): AgoraRtcMediaSourceState;
     protected abstract _getScreenCaptureState(sourceId: string): AgoraRtcMediaSourceState;
     protected abstract _getMicrophoneState(sourceId: string): AgoraRtcMediaSourceState;
@@ -22,7 +23,7 @@ export declare abstract class AgoraRtcChannelPublisher {
      * @param type The type of the stream.
      * @returns The result of the operation.
      */
-    publishLocalVideoStream(token: string | undefined, streamId: string, sourceId: string, type: AgoraRtcVideoSourceType): number;
+    publishLocalVideoStream(token: string | undefined, streamId: string, sourceId: string, type: AgoraRtcVideoSourceType, streamLayerBitMask: number): number;
     /**
      * Unpublishes a local video stream.
      * @param streamId The ID of the stream.
@@ -30,6 +31,7 @@ export declare abstract class AgoraRtcChannelPublisher {
      * @returns The result of the operation.
      */
     unpublishLocalVideoStream(streamId: string, type: AgoraRtcVideoSourceType): number;
+    adjustVideoProfileByStreamLayer(streamId: string): void;
     /**
      * Publishes a local audio stream.
      * @param token The token for authentication.
@@ -61,7 +63,9 @@ export declare abstract class AgoraRtcChannelPublisher {
      * @param streamId
      * @returns number
      */
-    abstract setVideoEncoderConfig(config: AgoraRtcVideoEncoderConfiguration, streamType: AgoraRtcVideoStreamType, streamId: string): number;
+    abstract setVideoEncoderConfig(config: AgoraRtcVideoEncoderConfiguration, streamLayer: AgoraRtcStreamLayer, streamId: string): number;
+    protected abstract _internalSetVideoEncoderConfig(config: AgoraRtcVideoEncoderConfiguration, streamLayer: AgoraRtcStreamLayer, streamId: string): number;
+    abstract getVideoEncoderConfig(streamLayer: AgoraRtcStreamLayer, streamId: string): AgoraRtcVideoEncoderConfiguration;
     /**
      * set dual stream mode
      * @param streamId The ID of the stream.

package/lib/core/rtc/publisher.js

@@ -66,6 +66,7 @@ var AgoraRtcChannelPublisher = exports.AgoraRtcChannelPublisher = /*#__PURE__*/f
     (0, _defineProperty2["default"])(this, "videoEncoderConfigs", new Map());
     (0, _defineProperty2["default"])(this, "screenScenario", _type.AgoraRtcScreenScenarioType.CLEARITY);
     (0, _defineProperty2["default"])(this, "latencyLevel", _type.AgoraRtcLatencyLevelType.LOW);
+    (0, _defineProperty2["default"])(this, "streamLayerBitMaskMap", new Map());
   }
   return (0, _createClass2["default"])(AgoraRtcChannelPublisher, [{
     key: "publishLocalVideoStream",
@@ -78,7 +79,7 @@ var AgoraRtcChannelPublisher = exports.AgoraRtcChannelPublisher = /*#__PURE__*/f
      * @param type The type of the stream.
      * @returns The result of the operation.
      */
-    function publishLocalVideoStream(token, streamId, sourceId, type) {
+    function publishLocalVideoStream(token, streamId, sourceId, type, streamLayerBitMask) {
       var state = _type.AgoraRtcMediaSourceState.CLOSE;
       if (type === _type.AgoraRtcVideoSourceType.SCREEN) {
         state = this._getScreenCaptureState(sourceId);
@@ -88,6 +89,8 @@ var AgoraRtcChannelPublisher = exports.AgoraRtcChannelPublisher = /*#__PURE__*/f
       if (state == _type.AgoraRtcMediaSourceState.ERROR) {
         return _constant.AgoraRtcErrorCode.CANNOT_PUBLISH_LOCAL_VIDEO_STREAM;
       }
+      this.streamLayerBitMaskMap.set(streamId, streamLayerBitMask);
+      this.adjustVideoProfileByStreamLayer(streamId);
       return this.publishPool.publishVideo(token, streamId, sourceId, type, state);
     }
 
@@ -100,8 +103,37 @@ var AgoraRtcChannelPublisher = exports.AgoraRtcChannelPublisher = /*#__PURE__*/f
   }, {
     key: "unpublishLocalVideoStream",
     value: function unpublishLocalVideoStream(streamId, type) {
+      this.streamLayerBitMaskMap["delete"](streamId);
       return this.publishPool.unpublishVideo(streamId, type);
     }
+  }, {
+    key: "adjustVideoProfileByStreamLayer",
+    value: function adjustVideoProfileByStreamLayer(streamId) {
+      var bitmask = this.streamLayerBitMaskMap.get(streamId);
+      if (bitmask === undefined) {
+        this.logger.error("no stream layer bit mask found for streamId: ".concat(streamId));
+        return;
+      }
+
+      // 仅开启小流
+      if (bitmask === _type.AgoraRtcStreamLayer.LOW) {
+        // 用大流承载小流 profile，并禁用低流
+        this._internalSetVideoEncoderConfig(this.getVideoEncoderConfig(_type.AgoraRtcStreamLayer.LOW, streamId), _type.AgoraRtcStreamLayer.HIGH, streamId);
+        this.setDualStreamMode(streamId, false);
+      }
+      // 大小流同时开启
+      else if ((bitmask & _type.AgoraRtcStreamLayer.HIGH) !== 0 && (bitmask & _type.AgoraRtcStreamLayer.LOW) !== 0) {
+        this._internalSetVideoEncoderConfig(this.getVideoEncoderConfig(_type.AgoraRtcStreamLayer.HIGH, streamId), _type.AgoraRtcStreamLayer.HIGH, streamId);
+        this._internalSetVideoEncoderConfig(this.getVideoEncoderConfig(_type.AgoraRtcStreamLayer.LOW, streamId), _type.AgoraRtcStreamLayer.LOW, streamId);
+        this.setDualStreamMode(streamId, true);
+      }
+      // 仅开启大流或未开启小流（回退到仅大流）
+      else {
+        // 使用高 profile 设置大流，禁用低流
+        this._internalSetVideoEncoderConfig(this.getVideoEncoderConfig(_type.AgoraRtcStreamLayer.HIGH, streamId), _type.AgoraRtcStreamLayer.HIGH, streamId);
+        this.setDualStreamMode(streamId, false);
+      }
+    }
     /**
      * Publishes a local audio stream.
      * @param token The token for authentication.

package/lib/core/rtc/subscriber.d.ts

@@ -1,16 +1,20 @@
-import { AgoraRtcVideoStreamType } from './type';
+import { AgoraRtcVideoStreamType, AgoraRtcStreamLayer } from './type';
 export declare abstract class AgoraRtcChannelSubscriber {
     protected logger: import("agora-foundation/lib/logger/type").Logger;
-    protected _videoMapping: Map<string, AgoraRtcVideoStreamType>;
+    /**
+     * 记录每个视频流最近一次订阅的层（high/low 等），用于断线重连时恢复订阅
+     * 多次订阅将覆盖 value，unsubscribe 时直接删除对应 key，避免旧层被恢复
+     */
+    protected _videoMapping: Map<string, AgoraRtcStreamLayer>;
     protected _audioMapping: Map<string, boolean>;
     protected _isPause: boolean;
     /**
      * Subscribes to a remote video stream.
      * @param streamId The ID of the stream.
-     * @param streamType The type of the stream.
+     * @param streamLayer The layer to subscribe (low/high, later calls overwrite earlier records).
      * @returns The result of the operation.
      */
-    subscribeRemoteVideoStream(streamId: string, streamType: AgoraRtcVideoStreamType): number;
+    subscribeRemoteVideoStream(streamId: string, streamLayer: AgoraRtcStreamLayer): number;
     /**
      * Unsubscribes from a remote video stream.
      * @param streamId The ID of the stream.