agora-rte-sdk 2.8.21 → 2.8.30

package/lib/core/decorator/handlers/log-handler.d.ts

@@ -0,0 +1,2 @@
+import { InvocationEvent } from '../type';
+export declare const createLogHandler: (level: 'info' | 'warn' | 'error') => (evt: InvocationEvent) => void;

package/lib/core/decorator/handlers/log-handler.js

@@ -0,0 +1,34 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createLogHandler = void 0;
+require("core-js/modules/es.date.to-string.js");
+require("core-js/modules/es.array.concat.js");
+var _logger = require("../../logger");
+var _type = require("../type");
+var noop = function noop() {};
+var createLogHandler = function createLogHandler(level) {
+  var log = _logger.Logger[level] || noop;
+  return function (evt) {
+    if (evt.type === _type.InvocationEventType.pre) {
+      var _evt$arguments;
+      evt.context.start = new Date().getTime();
+      var message = ["[".concat(evt["class"], "] >>> [").concat(evt.method, "]")];
+      ((_evt$arguments = evt.arguments) === null || _evt$arguments === void 0 ? void 0 : _evt$arguments.length) && message.push(', args:', evt.arguments);
+      //@ts-ignore
+      log.apply(void 0, message);
+    } else {
+      var elapsed = new Date().getTime() - evt.context.start;
+      var _message = ["[".concat(evt["class"], "] <<< [").concat(evt.method, "]")];
+      evt["return"] && _message.push(', return:', evt["return"]);
+      evt.error && _message.push(', err:', evt.error);
+      _message.push(", Time elapsed: ".concat(elapsed, "ms"));
+      //@ts-ignore
+      log.apply(void 0, _message);
+    }
+  };
+};
+exports.createLogHandler = createLogHandler;

package/lib/core/decorator/log/log-serializer.d.ts

@@ -0,0 +1,7 @@
+interface Serializer {
+    match(obj: any): boolean;
+    serialize(obj: any): string;
+}
+export declare const addSerializer: (serializer: Serializer) => void;
+export declare const serialize: (data: unknown) => unknown;
+export {};

package/lib/core/decorator/log/log-serializer.js

@@ -0,0 +1,38 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.serialize = exports.addSerializer = void 0;
+require("core-js/modules/es.function.name.js");
+require("core-js/modules/es.array.find.js");
+require("core-js/modules/es.regexp.exec.js");
+require("core-js/modules/es.string.match.js");
+var serializers = [];
+var fileSerializer = {
+  match: function match(obj) {
+    return obj instanceof File;
+  },
+  serialize: function serialize(file) {
+    return JSON.stringify({
+      filename: file.name,
+      size: file.size
+    });
+  }
+};
+serializers.push(fileSerializer);
+var addSerializer = function addSerializer(serializer) {
+  serializers.push(serializer);
+};
+exports.addSerializer = addSerializer;
+var serialize = function serialize(data) {
+  var serializer = serializers.find(function (serializer) {
+    return serializer.match(data);
+  });
+  if (serializer) {
+    return serializer.serialize(data);
+  }
+  return data;
+};
+exports.serialize = serialize;

package/lib/core/decorator/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const addIgnoredMethodsToPrototype: (prototype: any, ignoredMethods: string[]) => void;
+export declare const isIgnoredMethod: (prototype: any, method: string) => any;

package/lib/core/decorator/utils.js

@@ -0,0 +1,19 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isIgnoredMethod = exports.addIgnoredMethodsToPrototype = void 0;
+require("core-js/modules/es.array.concat.js");
+require("core-js/modules/es.array.index-of.js");
+var addIgnoredMethodsToPrototype = function addIgnoredMethodsToPrototype(prototype, ignoredMethods) {
+  var methods = prototype.__$$ignoreMethods || [];
+  methods = methods.concat(ignoredMethods);
+  prototype.__$$ignoreMethods = methods;
+};
+exports.addIgnoredMethodsToPrototype = addIgnoredMethodsToPrototype;
+var isIgnoredMethod = function isIgnoredMethod(prototype, method) {
+  return prototype.__$$ignoreMethods && prototype.__$$ignoreMethods.indexOf(method) > -1;
+};
+exports.isIgnoredMethod = isIgnoredMethod;

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

@@ -26,6 +26,7 @@ export declare class Logger {
     static info(...args: unknown[]): void;
     static error(...args: unknown[]): void;
     static originConsole: Console;
+    static setMaxRecords(maxRecords: number): void;
     debug(...args: unknown[]): void;
     info(...args: unknown[]): void;
     warn(...args: unknown[]): void;

package/lib/core/logger/index.js

@@ -61,6 +61,7 @@ var _configs = require("../../configs");
 var _db = require("./db");
 var _log2 = _interopRequireDefault(require("worker-loader?inline=no-fallback!./log.worker"));
 var _type = require("../../type");
+var _isNumber = _interopRequireDefault(require("lodash/isNumber"));
 var _logLevelMap;
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) { keys.push(key); } return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, "catch": function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
@@ -176,6 +177,21 @@ var Logger = /*#__PURE__*/function () {
       var _Logger$logger4;
       (_Logger$logger4 = Logger.logger).error.apply(_Logger$logger4, arguments);
     }
+  }, {
+    key: "setMaxRecords",
+    value: function setMaxRecords(maxRecords) {
+      if ((0, _isNumber["default"])(maxRecords)) {
+        console.log("[logger] set maxRecords to ".concat(maxRecords));
+        Logger.thread.postMessage({
+          type: 'setting',
+          data: {
+            maxRecords: maxRecords
+          }
+        });
+      } else {
+        console.warn("[logger] cannot set maxRecords to an invalid number :".concat(maxRecords));
+      }
+    }
   }, {
     key: "setupConsoleHijack",
     value: function setupConsoleHijack() {

package/lib/core/logger/log.worker.js

@@ -34,7 +34,7 @@ function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyri
 console.log("[worker] log worker initialzied");
 var ctx = self;
 var mutex = new _mutex.Mutex();
-var MAX_RECORDS = 50000;
+var maxRecords = 50000;
 var logs = [];
 var log = function log() {
   var _console;
@@ -55,7 +55,7 @@ var debouncedWriting = (0, _debounce["default"])(function () {
             return _db.db.logs.count();
           case 6:
             count = _context.sent;
-            exceedNo = logscopy.length + count - MAX_RECORDS;
+            exceedNo = logscopy.length + count - maxRecords;
             if (!(exceedNo > 0)) {
               _context.next = 12;
               break;
@@ -112,6 +112,8 @@ ctx.onmessage = /*#__PURE__*/function () {
                 timestamp: "".concat(now)
               });
               debouncedWriting();
+            } else if (evt.data && evt.data.type === 'setting') {
+              maxRecords = evt.data.data.maxRecords || 50000;
             }
           case 1:
           case "end":

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

@@ -1,7 +1,8 @@
 import { AGEventEmitter } from '../utils/events';
 import { AGRtcManager } from '../rtc';
 import { AgoraRteCameraVideoTrack, AgoraRteStreamMediaTrack, AgoraRteMicrophoneAudioTrack, AgoraRteScreenShareTrack } from './track';
-import { AGAudioRawDataConfig, AGBeautyEffect, AGRtcDeviceInfo, AGScreenShareDevice } from '../../';
+import { AGBeautyEffect, AGRtcDeviceInfo, AGScreenShareDevice } from '../../';
+import { AgoraRteStreamPlayer } from './player';
 export declare enum AgoraMediaControlEventType {
     cameraListChanged = "camera-list-changed",
     localAudioVolume = "local-audio-volume",
@@ -13,20 +14,25 @@ export declare enum AgoraMediaControlEventType {
     recordingDeviceListChanged = "recording-device-list-changed",
     localAudioPlaybackVolumeIndicator = "start-test-audio-playback-volume-indicator",
     audioPlaybackStateChanged = "audio-playback-state-changed",
-    localAudioFrame = "local-audio-frame",
     localTrackBeforeDestroy = "local-track-before-destroy",
     videoAutoPlayFailed = "video-auto-play-failed"
 }
 export declare class AgoraMediaControl extends AGEventEmitter {
-    camera?: AgoraRteCameraVideoTrack;
-    microphone?: AgoraRteMicrophoneAudioTrack;
-    screen?: AgoraRteScreenShareTrack;
+    private _camera?;
+    private _microphone?;
+    private _screen?;
+    private _player?;
     private _rtc;
     constructor(rtc: AGRtcManager);
+    get camera(): AgoraRteCameraVideoTrack | undefined;
+    get microphone(): AgoraRteMicrophoneAudioTrack | undefined;
+    get screen(): AgoraRteScreenShareTrack | undefined;
+    get player(): AgoraRteStreamPlayer | undefined;
     private _addEventListener;
     createCameraVideoTrack(): AgoraRteCameraVideoTrack;
     createMicrophoneAudioTrack(): AgoraRteMicrophoneAudioTrack;
     createScreenShareTrack(): AgoraRteScreenShareTrack;
+    createStreamPlayer(): AgoraRteStreamPlayer;
     getVideoCameraList(): AGRtcDeviceInfo[];
     getAudioRecordingList(): AGRtcDeviceInfo[];
     getAudioPlaybackList(): AGRtcDeviceInfo[];
@@ -38,10 +44,7 @@ export declare class AgoraMediaControl extends AGEventEmitter {
     stopAudioRecordingDeviceTest(): number;
     startAudioPlaybackDeviceTest(url: string): number;
     stopAudioPlaybackDeviceTest(): number;
-    setAudioFrameCallback(): number;
-    stopAudioFrameCallback(): number;
     setBeautyEffectOptions(enable: boolean, options: AGBeautyEffect): number;
-    setAudioRawDataConfig(config: AGAudioRawDataConfig): number;
     createStreamMediaTrack(): AgoraRteStreamMediaTrack;
     takeSnapshot(channel: string, streamUuid: number, filePath: string): Promise<void | import("../rtc/type").AGSnapshotInfo>;
     getCurrentFrameData(channelName: string, streamUuid: string, isLocal: boolean): ImageData;

package/lib/core/media/control.js

@@ -15,6 +15,7 @@ var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
 var _events = require("../utils/events");
 var _track = require("./track");
+var _player = require("./player");
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2["default"])(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2["default"])(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2["default"])(this, result); }; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 var AgoraMediaControlEventType;
@@ -30,7 +31,6 @@ exports.AgoraMediaControlEventType = AgoraMediaControlEventType;
   AgoraMediaControlEventType["recordingDeviceListChanged"] = "recording-device-list-changed";
   AgoraMediaControlEventType["localAudioPlaybackVolumeIndicator"] = "start-test-audio-playback-volume-indicator";
   AgoraMediaControlEventType["audioPlaybackStateChanged"] = "audio-playback-state-changed";
-  AgoraMediaControlEventType["localAudioFrame"] = "local-audio-frame";
   AgoraMediaControlEventType["localTrackBeforeDestroy"] = "local-track-before-destroy";
   AgoraMediaControlEventType["videoAutoPlayFailed"] = "video-auto-play-failed";
 })(AgoraMediaControlEventType || (exports.AgoraMediaControlEventType = AgoraMediaControlEventType = {}));
@@ -41,15 +41,36 @@ var AgoraMediaControl = /*#__PURE__*/function (_AGEventEmitter) {
     var _this;
     (0, _classCallCheck2["default"])(this, AgoraMediaControl);
     _this = _super.call(this);
-    _this.camera = void 0;
-    _this.microphone = void 0;
-    _this.screen = void 0;
+    _this._camera = void 0;
+    _this._microphone = void 0;
+    _this._screen = void 0;
+    _this._player = void 0;
     _this._rtc = void 0;
     _this._rtc = rtc;
     _this._addEventListener(rtc);
     return _this;
   }
   (0, _createClass2["default"])(AgoraMediaControl, [{
+    key: "camera",
+    get: function get() {
+      return this._camera;
+    }
+  }, {
+    key: "microphone",
+    get: function get() {
+      return this._microphone;
+    }
+  }, {
+    key: "screen",
+    get: function get() {
+      return this._screen;
+    }
+  }, {
+    key: "player",
+    get: function get() {
+      return this._player;
+    }
+  }, {
     key: "_addEventListener",
     value: function _addEventListener(rtc) {
       var _this2 = this;
@@ -100,10 +121,6 @@ var AgoraMediaControl = /*#__PURE__*/function (_AGEventEmitter) {
       rtc.getAudioDeviceManager().onLocalAudioPlaybackTestVolumeChanged(function (volume) {
         _this2.emit(AgoraMediaControlEventType.localAudioPlaybackVolumeIndicator, volume);
       });
-      // 本地原始音频数据（PCM）
-      rtc.getAudioDeviceManager().onAudioFrame(function (buffer) {
-        _this2.emit(AgoraMediaControlEventType.localAudioFrame, buffer);
-      });
       // local screenshare
       rtc.onLocalScreenShareTrackStateChanged(function () {
         for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
@@ -116,26 +133,34 @@ var AgoraMediaControl = /*#__PURE__*/function (_AGEventEmitter) {
   }, {
     key: "createCameraVideoTrack",
     value: function createCameraVideoTrack() {
-      if (!this.camera) {
-        this.camera = new _track.AgoraRteCameraVideoTrack(this._rtc);
+      if (!this._camera) {
+        this._camera = new _track.AgoraRteCameraVideoTrack(this._rtc);
       }
-      return this.camera;
+      return this._camera;
     }
   }, {
     key: "createMicrophoneAudioTrack",
     value: function createMicrophoneAudioTrack() {
-      if (!this.microphone) {
-        this.microphone = new _track.AgoraRteMicrophoneAudioTrack(this._rtc);
+      if (!this._microphone) {
+        this._microphone = new _track.AgoraRteMicrophoneAudioTrack(this._rtc);
       }
-      return this.microphone;
+      return this._microphone;
     }
   }, {
     key: "createScreenShareTrack",
     value: function createScreenShareTrack() {
-      if (!this.screen) {
-        this.screen = new _track.AgoraRteScreenShareTrack(this._rtc);
+      if (!this._screen) {
+        this._screen = new _track.AgoraRteScreenShareTrack(this._rtc);
       }
-      return this.screen;
+      return this._screen;
+    }
+  }, {
+    key: "createStreamPlayer",
+    value: function createStreamPlayer() {
+      if (!this._player) {
+        this._player = new _player.AgoraRteStreamPlayer(this._rtc);
+      }
+      return this._player;
     }
   }, {
     key: "getVideoCameraList",
@@ -192,26 +217,11 @@ var AgoraMediaControl = /*#__PURE__*/function (_AGEventEmitter) {
     value: function stopAudioPlaybackDeviceTest() {
       return this._rtc.stopAudioPlaybackDeviceTest();
     }
-  }, {
-    key: "setAudioFrameCallback",
-    value: function setAudioFrameCallback() {
-      return this._rtc.setAudioFrameCallback();
-    }
-  }, {
-    key: "stopAudioFrameCallback",
-    value: function stopAudioFrameCallback() {
-      return this._rtc.stopAudioFrameCallback();
-    }
   }, {
     key: "setBeautyEffectOptions",
     value: function setBeautyEffectOptions(enable, options) {
       return this._rtc.setBeautyEffectOptions(enable, options);
     }
-  }, {
-    key: "setAudioRawDataConfig",
-    value: function setAudioRawDataConfig(config) {
-      return this._rtc.setAudioRawDataConfig(config);
-    }
   }, {
     key: "createStreamMediaTrack",
     value: function createStreamMediaTrack() {

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

@@ -0,0 +1,9 @@
+import { AGRtcManager } from '../rtc';
+import { AgoraRteAudioRawDataConfig, AgoraRtePlayAudioRawDataObserver } from './type';
+export declare class AgoraRteStreamPlayer {
+    private _rtc;
+    constructor(rtc: AGRtcManager);
+    setAudioRawDataConfig(config: AgoraRteAudioRawDataConfig): void;
+    addAudioRawDataObserver(observer: AgoraRtePlayAudioRawDataObserver): void;
+    removeAudioRawDataObserver(observer: AgoraRtePlayAudioRawDataObserver): void;
+}

package/lib/core/media/player.js

@@ -0,0 +1,36 @@
+"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.AgoraRteStreamPlayer = void 0;
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _type = require("./type");
+var AgoraRteStreamPlayer = /*#__PURE__*/function () {
+  function AgoraRteStreamPlayer(rtc) {
+    (0, _classCallCheck2["default"])(this, AgoraRteStreamPlayer);
+    this._rtc = void 0;
+    this._rtc = rtc;
+  }
+  (0, _createClass2["default"])(AgoraRteStreamPlayer, [{
+    key: "setAudioRawDataConfig",
+    value: function setAudioRawDataConfig(config) {
+      this._rtc.setAudioRawDataConfig(config, _type.AgoraRteAudioRawDataPosition.beforeMixed);
+    }
+  }, {
+    key: "addAudioRawDataObserver",
+    value: function addAudioRawDataObserver(observer) {
+      this._rtc.addAudioRawDataObserver(observer, _type.AgoraRteAudioRawDataPosition.beforeMixed);
+    }
+  }, {
+    key: "removeAudioRawDataObserver",
+    value: function removeAudioRawDataObserver(observer) {
+      this._rtc.removeAudioRawDataObserver(observer, _type.AgoraRteAudioRawDataPosition.beforeMixed);
+    }
+  }]);
+  return AgoraRteStreamPlayer;
+}();
+exports.AgoraRteStreamPlayer = AgoraRteStreamPlayer;

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

@@ -1,8 +1,9 @@
 import { IBaseProcessor } from 'agora-rte-extension';
-import { AgoraRteMediaSourceState, AGScreenShareType } from '../..';
+import { AgoraRteAudioRawDataConfig, AgoraRteMediaSourceState, AGScreenShareType } from '../..';
 import { AGRtcManager } from '../rtc';
 import { AgoraMediaPlayerCanvas, AgoraRtcVideoCanvas } from '../rtc/canvas';
 import { StreamMediaPlayer } from '../media-player';
+import { AgoraRteRecordAudioRawDataObserver } from './type';
 export declare enum AgoraRteVideoSourceType {
     None = 0,
     Camera = 1,
@@ -19,6 +20,9 @@ export declare enum AgoraRteMediaPublishState {
     Unpublished = 0,
     Published = 1
 }
+/**
+ *
+ */
 export declare abstract class AgoraRteMediaTrack {
     videoSourceType: AgoraRteVideoSourceType;
     audioSourceType: AgoraRteAudioSourceType;
@@ -63,6 +67,9 @@ export declare class AgoraRteMicrophoneAudioTrack extends AgoraRteMediaTrack {
     removeProcessors(): number;
     setRecordingDevice(deviceId: string): number;
     setPlaybackDevice(deviceId: string): number;
+    setAudioRawDataConfig(config: AgoraRteAudioRawDataConfig): void;
+    addAudioRawDataObserver(observer: AgoraRteRecordAudioRawDataObserver): void;
+    removeAudioRawDataObserver(observer: AgoraRteRecordAudioRawDataObserver): void;
     start(): number;
     stop(): number;
 }

package/lib/core/media/track.js

@@ -33,6 +33,9 @@ exports.AgoraRteAudioSourceType = AgoraRteAudioSourceType;
   AgoraRteAudioSourceType[AgoraRteAudioSourceType["MediaPlayer"] = 3] = "MediaPlayer";
 })(AgoraRteAudioSourceType || (exports.AgoraRteAudioSourceType = AgoraRteAudioSourceType = {}));
 var AgoraRteMediaPublishState;
+/**
+ *
+ */
 exports.AgoraRteMediaPublishState = AgoraRteMediaPublishState;
 (function (AgoraRteMediaPublishState) {
   AgoraRteMediaPublishState[AgoraRteMediaPublishState["Unpublished"] = 0] = "Unpublished";
@@ -205,6 +208,21 @@ var AgoraRteMicrophoneAudioTrack = /*#__PURE__*/function (_AgoraRteMediaTrack3)
     value: function setPlaybackDevice(deviceId) {
       return this.rtc.setAudioPlaybackDevice(deviceId);
     }
+  }, {
+    key: "setAudioRawDataConfig",
+    value: function setAudioRawDataConfig(config) {
+      this.rtc.setAudioRawDataConfig(config, _.AgoraRteAudioRawDataPosition.record);
+    }
+  }, {
+    key: "addAudioRawDataObserver",
+    value: function addAudioRawDataObserver(observer) {
+      this.rtc.addAudioRawDataObserver(observer, _.AgoraRteAudioRawDataPosition.record);
+    }
+  }, {
+    key: "removeAudioRawDataObserver",
+    value: function removeAudioRawDataObserver(observer) {
+      this.rtc.removeAudioRawDataObserver(observer, _.AgoraRteAudioRawDataPosition.record);
+    }
   }, {
     key: "start",
     value: function start() {

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

@@ -0,0 +1,113 @@
+/**
+ * 音频裸数据回调参数
+ */
+/** @en
+ * Audio raw data callback parameter
+ */
+export interface AgoraRteAudioRawDataConfig {
+    /**
+     * 每次回调返回的音频数据长度
+     */
+    /** @en
+     * The length of audio data returned in each callback
+     */
+    frameSize?: 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384;
+    /**
+     * 音频数据的采样率
+     */
+    /** @en
+     * Sampling rate of audio data
+     */
+    sampleRate?: number;
+    /**
+     * 是否启用立体音
+     */
+    /** @en
+     * Whether to enable stereo.
+     */
+    stereo?: boolean;
+}
+/**
+ * 音频的输出位置
+ */
+/** @en
+ * The audio output position
+ */
+export declare enum AgoraRteAudioRawDataPosition {
+    /**
+     * 录制后
+     */
+    /** @en
+     * After recording
+     */
+    record = 2,
+    /**
+     * 多条音频流混合成一路即将播放的音频流前
+     */
+    /** @en
+     * Before multiple audio streams are blended into one stream to be played
+     */
+    beforeMixed = 8
+}
+/**
+ * 音频录制数据
+ */
+/** @en
+ * Audio recording data
+ */
+export declare type AgoraRteAudioRawData = {
+    /**
+     * 音频裸数据
+     * @param buffer
+     */
+    /** @en
+     * Audio raw data
+     * @param buffer
+     */
+    buffer: AudioBuffer;
+};
+/**
+ * 音频裸数据观察者(本地录音设备)
+ */
+/** @en
+ *  Audio raw data observer(local recording device)
+ */
+export interface AgoraRteRecordAudioRawDataObserver {
+    /**
+     * 本地录制音频裸数据回调
+     * @param rawData
+     */
+    /** @en
+     * Local audio stream raw data callback
+     * @param rawData
+     */
+    onAudioRawDataRecored(rawData: AgoraRteAudioRawData): void;
+}
+/**
+ * 音频裸数据观察者(远端流)
+ */
+/** @en
+ *  Audio raw data observer(remote streams)
+ */
+export interface AgoraRtePlayAudioRawDataObserver {
+    /**
+     * 远端音频流裸数据回调
+     * @param rawData
+     * @param streamUuid
+     * @param sceneId
+     */
+    /** @en
+     * Remote audio stream raw data callback
+     * @param rawData
+     * @param streamUuid
+     * @param sceneId
+     */
+    onAudioRawDataBeforeMixed(rawData: AgoraRteAudioRawData, streamUuid: string, sceneId: string): void;
+}
+/**
+ * 音频裸数据观察者
+ */
+/** @en
+ *  Audio raw data observer
+ */
+export declare type AgoraRteAudioRawDataObserver = AgoraRteRecordAudioRawDataObserver & AgoraRtePlayAudioRawDataObserver;

package/lib/core/media/type.js

@@ -0,0 +1,31 @@
+"use strict";
+
+require("core-js/modules/es.object.define-property.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgoraRteAudioRawDataPosition = void 0;
+/**
+ * 音频裸数据回调参数
+ */
+/** @en
+ * Audio raw data callback parameter
+ */
+/**
+ * 音频的输出位置
+ */
+/** @en
+ * The audio output position
+ */
+var AgoraRteAudioRawDataPosition;
+/**
+ * 音频录制数据
+ */
+/** @en
+ * Audio recording data
+ */
+exports.AgoraRteAudioRawDataPosition = AgoraRteAudioRawDataPosition;
+(function (AgoraRteAudioRawDataPosition) {
+  AgoraRteAudioRawDataPosition[AgoraRteAudioRawDataPosition["record"] = 2] = "record";
+  AgoraRteAudioRawDataPosition[AgoraRteAudioRawDataPosition["beforeMixed"] = 8] = "beforeMixed";
+})(AgoraRteAudioRawDataPosition || (exports.AgoraRteAudioRawDataPosition = AgoraRteAudioRawDataPosition = {}));