agora-rte-sdk 3.8.2 → 3.9.0-alpha

package/lib/core/rtc/subscriber.js

@@ -1,13 +1,180 @@
 "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.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.symbol.metadata.js");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.AgoraRtcChannelSubscriber = void 0;
-var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+require("core-js/modules/es.array.from.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.string.iterator.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/web.dom-collections.iterator.js");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
-var AgoraRtcChannelSubscriber = exports.AgoraRtcChannelSubscriber = /*#__PURE__*/(0, _createClass2["default"])(function AgoraRtcChannelSubscriber() {
-  (0, _classCallCheck2["default"])(this, AgoraRtcChannelSubscriber);
-});
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _logger = require("../utilities/logger");
+var _imports = require("../../imports");
+var _AgoraRtcChannelSubscriber;
+var _initProto, _subscribeRemoteVideoStreamDecs, _unsubscribeRemoteVideoStreamDecs, _subscribeRemoteAudioStreamDecs, _unsubscribeRemoteAudioStreamDecs, _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 = (_subscribeRemoteVideoStreamDecs = (0, _imports.trace)(['streamId', 'streamType']), _unsubscribeRemoteVideoStreamDecs = (0, _imports.trace)(['streamId']), _subscribeRemoteAudioStreamDecs = (0, _imports.trace)(['streamId']), _unsubscribeRemoteAudioStreamDecs = (0, _imports.trace)(['streamId']), "logger");
+var AgoraRtcChannelSubscriber = exports.AgoraRtcChannelSubscriber = /*#__PURE__*/function () {
+  function AgoraRtcChannelSubscriber() {
+    (0, _classCallCheck2["default"])(this, AgoraRtcChannelSubscriber);
+    (0, _defineProperty2["default"])(this, _ref, (_initProto(this), (0, _logger.createLogger)({
+      prefix: 'AgoraRtcChannelSubscriber'
+    })));
+    (0, _defineProperty2["default"])(this, "_videoMapping", new Map());
+    (0, _defineProperty2["default"])(this, "_audioMapping", new Map());
+    (0, _defineProperty2["default"])(this, "_isPause", false);
+  }
+  return (0, _createClass2["default"])(AgoraRtcChannelSubscriber, [{
+    key: "subscribeRemoteVideoStream",
+    value:
+    /**
+     * Subscribes to a remote video stream.
+     * @param streamId The ID of the stream.
+     * @param streamType The type of the stream.
+     * @returns The result of the operation.
+     */
+    function subscribeRemoteVideoStream(streamId, streamType) {
+      this._videoMapping.set(streamId, streamType);
+      if (this._isPause) {
+        return 0;
+      }
+      return this._subscribeRemoteVideoStream(streamId, streamType);
+    }
+
+    /**
+     * Unsubscribes from a remote video stream.
+     * @param streamId The ID of the stream.
+     * @returns The result of the operation.
+     */
+  }, {
+    key: "unsubscribeRemoteVideoStream",
+    value: function unsubscribeRemoteVideoStream(streamId) {
+      this._videoMapping["delete"](streamId);
+      return this._unsubscribeRemoteVideoStream(streamId);
+    }
+
+    /**
+     * Subscribes to a remote audio stream.
+     * @param streamId The ID of the stream.
+     * @returns The result of the operation.
+     */
+  }, {
+    key: "subscribeRemoteAudioStream",
+    value: function subscribeRemoteAudioStream(streamId) {
+      this._audioMapping.set(streamId, true);
+      if (this._isPause) {
+        return 0;
+      }
+      return this._subscribeRemoteAudioStream(streamId);
+    }
+
+    /**
+     * Unsubscribes from a remote audio stream.
+     * @param streamId The ID of the stream.
+     * @returns The result of the operation.
+     */
+  }, {
+    key: "unsubscribeRemoteAudioStream",
+    value: function unsubscribeRemoteAudioStream(streamId) {
+      this._audioMapping["delete"](streamId);
+      return this._unsubscribeRemoteAudioStream(streamId);
+    }
+
+    /**
+     * resubscribe all remote streams
+     * @returns The result of the operation.
+     */
+  }, {
+    key: "resume",
+    value: function resume() {
+      if (this._isPause === false) {
+        return 0;
+      }
+      this._isPause = false;
+      var audioSubscribeStateMapKeys = Array.from(this._audioMapping.keys());
+      this.logger.info('resume all remote audio streams', Array.from(audioSubscribeStateMapKeys).length);
+      for (var i = 0; i < audioSubscribeStateMapKeys.length; i++) {
+        var _streamId = audioSubscribeStateMapKeys[i];
+        this._subscribeRemoteAudioStream(_streamId);
+      }
+      var videoSubscribeStateMapKeys = Array.from(this._videoMapping.keys());
+      this.logger.info('resume all remote video streams', videoSubscribeStateMapKeys.length);
+      for (var _i = 0; _i < videoSubscribeStateMapKeys.length; _i++) {
+        var _streamId2 = videoSubscribeStateMapKeys[_i];
+        var _streamType = this._videoMapping.get(_streamId2);
+        if ((0, _imports.isNumber)(_streamType)) {
+          this._subscribeRemoteVideoStream(_streamId2, _streamType);
+        }
+      }
+      return 0;
+    }
+  }, {
+    key: "pause",
+    value: function pause() {
+      if (this._isPause === true) {
+        return 0;
+      }
+      this._isPause = true;
+      var audioSubscribeStateMapKeys = Array.from(this._audioMapping.keys());
+      this.logger.info('pause all remote audio streams', audioSubscribeStateMapKeys.length);
+      for (var i = 0; i < audioSubscribeStateMapKeys.length; i++) {
+        var _streamId3 = audioSubscribeStateMapKeys[i];
+        this._unsubscribeRemoteAudioStream(_streamId3);
+      }
+      var videoSubscribeStateMapKeys = Array.from(this._videoMapping.keys());
+      this.logger.info('pause all remote video streams', videoSubscribeStateMapKeys.length);
+      for (var _i2 = 0; _i2 < videoSubscribeStateMapKeys.length; _i2++) {
+        var _streamId4 = videoSubscribeStateMapKeys[_i2];
+        this._unsubscribeRemoteVideoStream(_streamId4);
+      }
+      return 0;
+    }
+  }]);
+}();
+_AgoraRtcChannelSubscriber = AgoraRtcChannelSubscriber;
+var _applyDecs$e = _applyDecs(_AgoraRtcChannelSubscriber, [[_subscribeRemoteVideoStreamDecs, 2, "subscribeRemoteVideoStream"], [_unsubscribeRemoteVideoStreamDecs, 2, "unsubscribeRemoteVideoStream"], [_subscribeRemoteAudioStreamDecs, 2, "subscribeRemoteAudioStream"], [_unsubscribeRemoteAudioStreamDecs, 2, "unsubscribeRemoteAudioStream"], [_imports.bound, 2, "resume"], [_imports.bound, 2, "pause"]], []).e;
+var _applyDecs$e2 = (0, _slicedToArray2["default"])(_applyDecs$e, 1);
+_initProto = _applyDecs$e2[0];
+_applyDecs$e;

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

@@ -67,7 +67,7 @@ export declare enum AgoraRtcMediaSourceState {
     OPEN = 1
 }
 export declare enum AgoraRtcConnectionState {
-    IDLE = 0,
+    DISCONNECTED = 0,
     CONNECTING = 1,
     CONNECTED = 2,
     RECONNECTING = 3,
@@ -252,7 +252,7 @@ export declare enum AgoraRtcLatencyLevelType {
  * AI denoise level
  */
 export declare enum AgoraRtcAiDenoiseLevel {
-    AUTO = 0,
+    NONE = 0,
     LOW = 1,
     MEDIUM = 2,
     HIGH = 3
@@ -383,6 +383,9 @@ export type AgoraRtcStreamPublishPoolObserver = {
     onConnectionJoinChannel?(item: AgoraRtcStreamPublishPoolItem): void;
     onUpdateChannelOptions?(item: AgoraRtcStreamPublishPoolItem): void;
     onConnectionLeaveChannel?(item: AgoraRtcStreamPublishPoolItem): void;
+    onConnectionSetVideoEncoderConfig?(item: AgoraRtcStreamPublishPoolItem): void;
+    onConnectionEnableLoopback?(item: AgoraRtcStreamPublishPoolItem): void;
+    onConnectionDisableLoopback?(item: AgoraRtcStreamPublishPoolItem): void;
 };
 export interface AgoraRtcStreamPublishPoolItem {
     videoHasPublished: boolean;
@@ -409,21 +412,7 @@ export declare enum AgoraRtcRenderSourceType {
     REMOTE_STREAM = 3,
     LOCAL_WINDOW = 4
 }
-export declare enum AgoraRtcCameraSourceIndex {
-    UNDEFINED = -1,
-    PRIMARY = 0,
-    SECONDARY = 1,
-    THIRD = 2,
-    FOURTH = 3
-}
-export declare enum AgoraRtcScreenSourceIndex {
-    UNDEFINED = -1,
-    PRIMARY = 0,
-    SECONDARY = 1,
-    THIRD = 2,
-    FOURTH = 3
-}
-export declare enum AgoraRtcWindowSourceIndex {
+export declare enum AgoraRtcMediaSourceIndex {
     UNDEFINED = -1,
     PRIMARY = 0,
     SECONDARY = 1,

package/lib/core/rtc/type.js

@@ -4,7 +4,7 @@ require("core-js/modules/es.object.define-property.js");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AgoraRteVideoOutputOrientationMode = exports.AgoraRtcWindowSourceIndex = exports.AgoraRtcVideoStreamType = exports.AgoraRtcVideoSourceType = exports.AgoraRtcVideoOrientation = exports.AgoraRtcScreenSourceIndex = exports.AgoraRtcScreenScenarioType = exports.AgoraRtcScreenCaptureType = exports.AgoraRtcRenderSourceType = exports.AgoraRtcRenderResultType = exports.AgoraRtcRenderMode = exports.AgoraRtcRegion = exports.AgoraRtcNetworkQuality = exports.AgoraRtcMediaSourceState = exports.AgoraRtcLatencyLevelType = exports.AgoraRtcEncryptionMode = exports.AgoraRtcDeviceType = exports.AgoraRtcDegradationPreference = exports.AgoraRtcConnectionState = exports.AgoraRtcChannelProfile = exports.AgoraRtcCapability = exports.AgoraRtcCameraSourceIndex = exports.AgoraRtcCameraPosition = exports.AgoraRtcAudioSourceType = exports.AgoraRtcAudioOutputRouting = exports.AgoraRtcAiDenoiseLevel = void 0;
+exports.AgoraRteVideoOutputOrientationMode = exports.AgoraRtcVideoStreamType = exports.AgoraRtcVideoSourceType = exports.AgoraRtcVideoOrientation = exports.AgoraRtcScreenScenarioType = exports.AgoraRtcScreenCaptureType = exports.AgoraRtcRenderSourceType = exports.AgoraRtcRenderResultType = exports.AgoraRtcRenderMode = exports.AgoraRtcRegion = exports.AgoraRtcNetworkQuality = exports.AgoraRtcMediaSourceState = exports.AgoraRtcMediaSourceIndex = exports.AgoraRtcLatencyLevelType = exports.AgoraRtcEncryptionMode = exports.AgoraRtcDeviceType = exports.AgoraRtcDegradationPreference = exports.AgoraRtcConnectionState = exports.AgoraRtcChannelProfile = exports.AgoraRtcCapability = exports.AgoraRtcCameraPosition = exports.AgoraRtcAudioSourceType = exports.AgoraRtcAudioOutputRouting = exports.AgoraRtcAiDenoiseLevel = void 0;
 // todo
 // export type { IBaseProcessor, IExtension } from 'agora-rte-extension';
 var AgoraRtcRenderMode = exports.AgoraRtcRenderMode = /*#__PURE__*/function (AgoraRtcRenderMode) {
@@ -50,7 +50,7 @@ var AgoraRtcMediaSourceState = exports.AgoraRtcMediaSourceState = /*#__PURE__*/f
   return AgoraRtcMediaSourceState;
 }({});
 var AgoraRtcConnectionState = exports.AgoraRtcConnectionState = /*#__PURE__*/function (AgoraRtcConnectionState) {
-  AgoraRtcConnectionState[AgoraRtcConnectionState["IDLE"] = 0] = "IDLE";
+  AgoraRtcConnectionState[AgoraRtcConnectionState["DISCONNECTED"] = 0] = "DISCONNECTED";
   AgoraRtcConnectionState[AgoraRtcConnectionState["CONNECTING"] = 1] = "CONNECTING";
   AgoraRtcConnectionState[AgoraRtcConnectionState["CONNECTED"] = 2] = "CONNECTED";
   AgoraRtcConnectionState[AgoraRtcConnectionState["RECONNECTING"] = 3] = "RECONNECTING";
@@ -107,7 +107,7 @@ var AgoraRtcLatencyLevelType = exports.AgoraRtcLatencyLevelType = /*#__PURE__*/f
  * AI denoise level
  */
 var AgoraRtcAiDenoiseLevel = exports.AgoraRtcAiDenoiseLevel = /*#__PURE__*/function (AgoraRtcAiDenoiseLevel) {
-  AgoraRtcAiDenoiseLevel[AgoraRtcAiDenoiseLevel["AUTO"] = 0] = "AUTO";
+  AgoraRtcAiDenoiseLevel[AgoraRtcAiDenoiseLevel["NONE"] = 0] = "NONE";
   AgoraRtcAiDenoiseLevel[AgoraRtcAiDenoiseLevel["LOW"] = 1] = "LOW";
   AgoraRtcAiDenoiseLevel[AgoraRtcAiDenoiseLevel["MEDIUM"] = 2] = "MEDIUM";
   AgoraRtcAiDenoiseLevel[AgoraRtcAiDenoiseLevel["HIGH"] = 3] = "HIGH";
@@ -160,29 +160,13 @@ var AgoraRtcRenderSourceType = exports.AgoraRtcRenderSourceType = /*#__PURE__*/f
   AgoraRtcRenderSourceType[AgoraRtcRenderSourceType["LOCAL_WINDOW"] = 4] = "LOCAL_WINDOW";
   return AgoraRtcRenderSourceType;
 }({});
-var AgoraRtcCameraSourceIndex = exports.AgoraRtcCameraSourceIndex = /*#__PURE__*/function (AgoraRtcCameraSourceIndex) {
-  AgoraRtcCameraSourceIndex[AgoraRtcCameraSourceIndex["UNDEFINED"] = -1] = "UNDEFINED";
-  AgoraRtcCameraSourceIndex[AgoraRtcCameraSourceIndex["PRIMARY"] = 0] = "PRIMARY";
-  AgoraRtcCameraSourceIndex[AgoraRtcCameraSourceIndex["SECONDARY"] = 1] = "SECONDARY";
-  AgoraRtcCameraSourceIndex[AgoraRtcCameraSourceIndex["THIRD"] = 2] = "THIRD";
-  AgoraRtcCameraSourceIndex[AgoraRtcCameraSourceIndex["FOURTH"] = 3] = "FOURTH";
-  return AgoraRtcCameraSourceIndex;
-}({});
-var AgoraRtcScreenSourceIndex = exports.AgoraRtcScreenSourceIndex = /*#__PURE__*/function (AgoraRtcScreenSourceIndex) {
-  AgoraRtcScreenSourceIndex[AgoraRtcScreenSourceIndex["UNDEFINED"] = -1] = "UNDEFINED";
-  AgoraRtcScreenSourceIndex[AgoraRtcScreenSourceIndex["PRIMARY"] = 0] = "PRIMARY";
-  AgoraRtcScreenSourceIndex[AgoraRtcScreenSourceIndex["SECONDARY"] = 1] = "SECONDARY";
-  AgoraRtcScreenSourceIndex[AgoraRtcScreenSourceIndex["THIRD"] = 2] = "THIRD";
-  AgoraRtcScreenSourceIndex[AgoraRtcScreenSourceIndex["FOURTH"] = 3] = "FOURTH";
-  return AgoraRtcScreenSourceIndex;
-}({});
-var AgoraRtcWindowSourceIndex = exports.AgoraRtcWindowSourceIndex = /*#__PURE__*/function (AgoraRtcWindowSourceIndex) {
-  AgoraRtcWindowSourceIndex[AgoraRtcWindowSourceIndex["UNDEFINED"] = -1] = "UNDEFINED";
-  AgoraRtcWindowSourceIndex[AgoraRtcWindowSourceIndex["PRIMARY"] = 0] = "PRIMARY";
-  AgoraRtcWindowSourceIndex[AgoraRtcWindowSourceIndex["SECONDARY"] = 1] = "SECONDARY";
-  AgoraRtcWindowSourceIndex[AgoraRtcWindowSourceIndex["THIRD"] = 2] = "THIRD";
-  AgoraRtcWindowSourceIndex[AgoraRtcWindowSourceIndex["FOURTH"] = 3] = "FOURTH";
-  return AgoraRtcWindowSourceIndex;
+var AgoraRtcMediaSourceIndex = exports.AgoraRtcMediaSourceIndex = /*#__PURE__*/function (AgoraRtcMediaSourceIndex) {
+  AgoraRtcMediaSourceIndex[AgoraRtcMediaSourceIndex["UNDEFINED"] = -1] = "UNDEFINED";
+  AgoraRtcMediaSourceIndex[AgoraRtcMediaSourceIndex["PRIMARY"] = 0] = "PRIMARY";
+  AgoraRtcMediaSourceIndex[AgoraRtcMediaSourceIndex["SECONDARY"] = 1] = "SECONDARY";
+  AgoraRtcMediaSourceIndex[AgoraRtcMediaSourceIndex["THIRD"] = 2] = "THIRD";
+  AgoraRtcMediaSourceIndex[AgoraRtcMediaSourceIndex["FOURTH"] = 3] = "FOURTH";
+  return AgoraRtcMediaSourceIndex;
 }({});
 var AgoraRteVideoOutputOrientationMode = exports.AgoraRteVideoOutputOrientationMode = /*#__PURE__*/function (AgoraRteVideoOutputOrientationMode) {
   AgoraRteVideoOutputOrientationMode[AgoraRteVideoOutputOrientationMode["ADAPTIVE"] = 0] = "ADAPTIVE";

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

@@ -7,18 +7,18 @@ export declare abstract class AgoraRtmChannelClient {
      * Joins the channel.
      * @returns A promise that resolves when the channel has been joined.
      */
-    abstract join(): Promise<void>;
+    abstract join(): Promise<number>;
     /**
      * Sends a message to the channel.
      * @param content - The content of the message to send.
      * @returns A promise that resolves when the message has been sent.
      */
-    abstract sendMessage(content: string): Promise<void>;
+    abstract sendMessage(content: string): Promise<number>;
     /**
      * Leaves the channel.
      * @returns A promise that resolves when the channel has been left.
      */
-    abstract leave(): Promise<void>;
+    abstract leave(): Promise<number>;
     /**
      * Adds an observer to the channel.
      * @param observer - The observer to add.

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

@@ -18,12 +18,12 @@ export declare abstract class AgoraRtmClient {
      * @param uid The user ID.
      * @returns A promise that resolves when the login is successful.
      */
-    abstract login(token: string, uid: string): Promise<void>;
+    abstract login(token: string, uid: string): Promise<number>;
     /**
      * Logs out of the Agora RTM system.
      * @returns A promise that resolves when the logout is successful.
      */
-    abstract logout(): Promise<void>;
+    abstract logout(): Promise<number>;
     /**
      * Creates a channel client.
      * @param channelId The ID of the channel.
@@ -47,13 +47,13 @@ export declare abstract class AgoraRtmClient {
      * @param receiverId The ID of the peer to send the message to.
      * @returns A promise that resolves when the message has been sent.
      */
-    abstract sendPeerMessage(message: string, guaranteedDelivery: boolean, receiverId: string): Promise<void>;
+    abstract sendPeerMessage(message: string, guaranteedDelivery: boolean, receiverId: string): Promise<number>;
     /**
      * Renews the user token.
      * @param token The token to renew.
      * @returns A promise that resolves when the token has been renewed.
      */
-    abstract renewToken(token: string): void;
+    abstract renewToken(token: string): Promise<number>;
     /**
      * Sets the parameters for the RTM client.
      * @param parameters The parameters to set.

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

@@ -5,9 +5,8 @@ export declare enum AgoraRtmConnectionState {
     CONNECTED = 3,
     ABORTED = 4
 }
-export type AgoraRtmConnectionChangeReason = string;
 export interface AgoraRtmClientObserver {
-    onConnectionStateUpdated?(state: AgoraRtmConnectionState, reason: AgoraRtmConnectionChangeReason): void;
+    onConnectionStateUpdated?(state: AgoraRtmConnectionState): void;
     onPeerMessageReceived?(peerId: string, message: string): void;
     onTokenWillExpire?(): void;
 }

package/lib/core/scene/helpers/ap-detect.d.ts

@@ -0,0 +1,5 @@
+import type { Logger } from '../../../imports';
+import { AgoraRteApDetector } from '../../engine/ap-detector';
+export declare function maybeDetectAp(apDetector: AgoraRteApDetector): Promise<void>;
+export declare function maybeRedetectAp(apDetector: AgoraRteApDetector): Promise<void>;
+export declare const detectAp: (logger: Logger, apDetector: AgoraRteApDetector) => Promise<void>;

package/lib/core/scene/helpers/ap-detect.js

@@ -0,0 +1,153 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.detectAp = void 0;
+exports.maybeDetectAp = maybeDetectAp;
+exports.maybeRedetectAp = maybeRedetectAp;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+require("core-js/modules/es.array.concat.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.promise.js");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _imports = require("../../../imports");
+var _error = require("../../utilities/error");
+var createDetectError = function createDetectError() {
+  return (0, _error.generateRteClientErrorNew)(_imports.ErrorModuleCode.RTE_AP_DETECTOR, _imports.DetailErrorCode.AP_DETECT_FAILED, 'failed to detect AP');
+};
+function runDetection(_x, _x2) {
+  return _runDetection.apply(this, arguments);
+}
+function _runDetection() {
+  _runDetection = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee2(apDetector, mode) {
+    return _regenerator["default"].wrap(function (_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          return _context2.abrupt("return", new Promise(function (resolve, reject) {
+            var observer = mode === 'start' ? {
+              onDetectionSuccess: function onDetectionSuccess() {
+                apDetector.removeObserver(observer);
+                resolve();
+              },
+              onDetectionFailure: function onDetectionFailure() {
+                apDetector.removeObserver(observer);
+                reject(createDetectError());
+              }
+            } : {
+              onRedetectionSuccess: function onRedetectionSuccess() {
+                apDetector.removeObserver(observer);
+                resolve();
+              },
+              onRedetectionFailure: function onRedetectionFailure() {
+                apDetector.removeObserver(observer);
+                reject(createDetectError());
+              }
+            };
+            apDetector.addObserver(observer);
+            if (mode === 'start') {
+              apDetector.start()["catch"](function (err) {
+                apDetector.removeObserver(observer);
+                reject(err !== null && err !== void 0 ? err : createDetectError());
+              });
+            } else {
+              apDetector.restart()["catch"](function (err) {
+                apDetector.removeObserver(observer);
+                reject(err !== null && err !== void 0 ? err : createDetectError());
+              });
+            }
+          }));
+        case 1:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return _runDetection.apply(this, arguments);
+}
+function maybeDetectAp(_x3) {
+  return _maybeDetectAp.apply(this, arguments);
+}
+function _maybeDetectAp() {
+  _maybeDetectAp = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee3(apDetector) {
+    return _regenerator["default"].wrap(function (_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          if (!(!apDetector.isDetectRequired() || apDetector.isFinished())) {
+            _context3.next = 1;
+            break;
+          }
+          return _context3.abrupt("return");
+        case 1:
+          _context3.next = 2;
+          return runDetection(apDetector, 'start');
+        case 2:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  }));
+  return _maybeDetectAp.apply(this, arguments);
+}
+function maybeRedetectAp(_x4) {
+  return _maybeRedetectAp.apply(this, arguments);
+}
+function _maybeRedetectAp() {
+  _maybeRedetectAp = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee4(apDetector) {
+    return _regenerator["default"].wrap(function (_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          if (!(!apDetector.isDetectRequired() || apDetector.isDetecting())) {
+            _context4.next = 1;
+            break;
+          }
+          return _context4.abrupt("return");
+        case 1:
+          _context4.next = 2;
+          return runDetection(apDetector, 'restart');
+        case 2:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return _maybeRedetectAp.apply(this, arguments);
+}
+var detectAp = exports.detectAp = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(logger, apDetector) {
+    var isApDetectRequired, isApDetectFinished, _yield$to, _yield$to2, error;
+    return _regenerator["default"].wrap(function (_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          isApDetectRequired = apDetector.isDetectRequired();
+          isApDetectFinished = apDetector.isFinished();
+          logger.info("check ap detect required: ".concat(isApDetectRequired, ", finished detect: ").concat(isApDetectFinished));
+          if (!(isApDetectRequired && !isApDetectFinished)) {
+            _context.next = 2;
+            break;
+          }
+          _context.next = 1;
+          return (0, _imports.to)(maybeDetectAp(apDetector));
+        case 1:
+          _yield$to = _context.sent;
+          _yield$to2 = (0, _slicedToArray2["default"])(_yield$to, 1);
+          error = _yield$to2[0];
+          if (!error) {
+            _context.next = 2;
+            break;
+          }
+          logger.error("join scene failed, ap detect failed");
+          throw error;
+        case 2:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function detectAp(_x5, _x6) {
+    return _ref.apply(this, arguments);
+  };
+}();

package/lib/core/scene/helpers/join.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from '../../../imports';
+import type { AgoraRteApDetector } from '../../engine/ap-detector';
+import type { AgoraRtcChannelClient, AgoraRtcClient } from '../../rtc';
+import { AgoraRtcChannelClientObserver } from '../../rtc/type';
+import { AgoraRtmChannelClient } from '../../rtm/channel';
+import type { AgoraRteJoinRtcOptions } from '../type';
+export declare const joinRTCChannel: (logger: Logger, options: AgoraRteJoinRtcOptions, rtcClient: AgoraRtcClient, rtcChannelClient: AgoraRtcChannelClient, rtcChannelObserver: AgoraRtcChannelClientObserver, apDetector: AgoraRteApDetector) => Promise<AgoraRtcChannelClient>;
+export declare const joinRTMChannel: (logger: Logger, rtmChannelClient: AgoraRtmChannelClient) => Promise<AgoraRtmChannelClient>;

package/lib/core/scene/helpers/join.js

@@ -0,0 +1,105 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.joinRTMChannel = exports.joinRTCChannel = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+require("core-js/modules/es.array.join.js");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _imports = require("../../../imports");
+var _error = require("../../utilities/error");
+var joinRTCChannel = exports.joinRTCChannel = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee2(logger, options, rtcClient, rtcChannelClient, rtcChannelObserver, apDetector) {
+    var cfg, _yield$to, _yield$to2, error;
+    return _regenerator["default"].wrap(function (_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          cfg = apDetector.getAvailableRtcAccessPointConfig();
+          logger.info("get available rtc access point config: ".concat((0, _imports.jsonstring)(cfg)));
+          if (cfg) {
+            rtcClient.setAccessPointConfig(cfg);
+          }
+          if (options.encryptionConfig) {
+            rtcChannelClient.setEncryptionConfig(options.encryptionConfig);
+          }
+          rtcChannelClient.addObserver(rtcChannelObserver);
+          _context2.next = 1;
+          return (0, _imports.to)((0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee() {
+            return _regenerator["default"].wrap(function (_context) {
+              while (1) switch (_context.prev = _context.next) {
+                case 0:
+                  _context.next = 1;
+                  return rtcChannelClient.join(options.streamId, options.token);
+                case 1:
+                case "end":
+                  return _context.stop();
+              }
+            }, _callee);
+          }))());
+        case 1:
+          _yield$to = _context2.sent;
+          _yield$to2 = (0, _slicedToArray2["default"])(_yield$to, 1);
+          error = _yield$to2[0];
+          if (!(error instanceof _error.AgoraRteError)) {
+            _context2.next = 2;
+            break;
+          }
+          logger.error("join rtc channel failed,  ".concat((0, _imports.jsonstring)(error)));
+          throw error;
+        case 2:
+          return _context2.abrupt("return", rtcChannelClient);
+        case 3:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return function joinRTCChannel(_x, _x2, _x3, _x4, _x5, _x6) {
+    return _ref.apply(this, arguments);
+  };
+}();
+var joinRTMChannel = exports.joinRTMChannel = /*#__PURE__*/function () {
+  var _ref3 = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee4(logger, rtmChannelClient) {
+    var _yield$to3, _yield$to4, error;
+    return _regenerator["default"].wrap(function (_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          _context4.next = 1;
+          return (0, _imports.to)((0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee3() {
+            return _regenerator["default"].wrap(function (_context3) {
+              while (1) switch (_context3.prev = _context3.next) {
+                case 0:
+                  _context3.next = 1;
+                  return rtmChannelClient.join();
+                case 1:
+                case "end":
+                  return _context3.stop();
+              }
+            }, _callee3);
+          }))());
+        case 1:
+          _yield$to3 = _context4.sent;
+          _yield$to4 = (0, _slicedToArray2["default"])(_yield$to3, 1);
+          error = _yield$to4[0];
+          if (!error) {
+            _context4.next = 2;
+            break;
+          }
+          logger.error("join rtm channel failed, ".concat(error.message));
+          throw error;
+        case 2:
+          return _context4.abrupt("return", rtmChannelClient);
+        case 3:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return function joinRTMChannel(_x7, _x8) {
+    return _ref3.apply(this, arguments);
+  };
+}();

package/lib/core/scene/helpers/rtc-event.d.ts

@@ -0,0 +1,4 @@
+import type { AgoraObservable } from '../../../imports';
+import { AgoraRtcChannelClient } from '../../rtc/channel';
+import { AgoraRteSceneObserver } from '../type';
+export declare const relayRtcChannelEvents: (rtcChannelClient: AgoraRtcChannelClient, observable: AgoraObservable<AgoraRteSceneObserver>) => void;