trtc-electron-sdk 12.1.608 → 12.2.701

package/liteav/trtc.js

@@ -37,11 +37,19 @@ const validate_util_1 = require("./validate-util");
 const logger_1 = __importStar(require("./logger"));
 const LocalVideoRenderController_1 = __importDefault(require("./VideoRenderControl/LocalVideoRenderController"));
 const VideoRenderFPSMonitor_1 = require("./VideoRenderControl/VideoRenderFPSMonitor");
+const DeviceManager_1 = __importDefault(require("./extensions/DeviceManager"));
+const AudioEffectManager_1 = __importDefault(require("./extensions/AudioEffectManager"));
+const MediaMixingManager_1 = __importDefault(require("./extensions/MediaMixingManager"));
+const PluginManager_1 = __importDefault(require("./extensions/PluginManager"));
 const NodeTRTCEngine = require('../build/Release/trtc_electron_sdk.node');
 const pkg = require('../package.json');
 __exportStar(require("./trtc_define"), exports);
 __exportStar(require("./trtc_code"), exports);
 __exportStar(require("./vod_player"), exports);
+__exportStar(require("./extensions/DeviceManager"), exports);
+__exportStar(require("./extensions/AudioEffectManager"), exports);
+__exportStar(require("./extensions/MediaMixingManager"), exports);
+__exportStar(require("./extensions/PluginManager"), exports);
 // 监听该事件，返回自定义视频渲染数据 ( bgra 格式)
 const CUSTOM_VIDEO_DATA = 'onVideoData';
 const LOCAL_VIDEO_DATA = 'onLocalVideoData';
@@ -154,13 +162,33 @@ const getComponentNO = function () {
  *
  */
 class TRTCCloud extends events_1.EventEmitter {
+    /**
+     * 构造函数
+     * @param config {TRTCInitConfig} - 初始化参数，可选
+     * @param config.networkProxy {Record<string, any>} - 网络代理参数，可选。为空时，默认不开启网络代理。
+     * @param config.isIPCMode {Boolean} - 是否跨进程模式，跨进程模式支持本地混流且混流视频采用原生窗口渲染。默认：false，不开启。
+     */
     constructor(config) {
         var _a;
         super();
         this.id = !TRTCCloud.sharedTRTCCloudInstance ? 1 : (2 + (((_a = TRTCCloud.subInstances) === null || _a === void 0 ? void 0 : _a.length) || 0));
         this.logger = new logger_1.Logger(`TRTC_${this.id}`);
         const componentNO = getComponentNO();
-        this.rtcCloud = new NodeTRTCEngine.NodeTRTCCloud(Object.assign({ jsVersion: pkg.version, componentNO }, config));
+        if (TRTCCloud.isIPCMode === null || TRTCCloud.isIPCMode === undefined) {
+            TRTCCloud.isIPCMode = (config === null || config === void 0 ? void 0 : config.isIPCMode) || false;
+            if (TRTCCloud.isIPCMode) {
+                NodeTRTCEngine.setRemoteTrtcWithAcrossProcessMode(TRTCCloud.isIPCMode);
+            }
+            logger_1.default.log(`TRTC use mode:${TRTCCloud.isIPCMode}`);
+        }
+        const newConfig = Object.assign({ jsVersion: pkg.version, componentNO }, config);
+        if (!TRTCCloud.isIPCMode) {
+            this.rtcCloud = new NodeTRTCEngine.NodeTRTCCloud(newConfig);
+        }
+        else {
+            this.rtcCloud = new NodeTRTCEngine.NodeRemoteTRTCCloud(newConfig);
+        }
+        this.stateStore = new Map();
         this.videoRendererMap = new Map();
         this.pixelFormat = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
         this.pixelLength = 1.5;
@@ -245,7 +273,9 @@ class TRTCCloud extends events_1.EventEmitter {
     }
     onFPSChanged(options) {
         this.videoRenderFPS = options.videoFPS !== -1 ? options.videoFPS : 60;
-        this.rtcCloud.setVideoRenderFPS(this.videoRenderFPS);
+        if (!TRTCCloud.isIPCMode) {
+            this.rtcCloud.setVideoRenderFPS(this.videoRenderFPS);
+        }
     }
     /**
      * 创建子实例
@@ -319,6 +349,7 @@ class TRTCCloud extends events_1.EventEmitter {
         VideoRenderFPSMonitor_1.videoRenderFPSMonitor.off('videoRenderFPS', this.onFPSChanged);
         this.playAudioEffectIdList = [];
         this.remoteFillModeMap.clear();
+        // this.destroyLocalMediaTranscoder();
         this.rtcCloud.destroy();
         this.rtcCloud = null;
     }
@@ -1296,7 +1327,11 @@ class TRTCCloud extends events_1.EventEmitter {
      * 当您调用 [stopLocalRecording]{@link TRTCCloud#stopLocalRecording} 停止本地媒体录制任务时，SDK 会抛出该事件回调，用于通知您录制任务的最终结果。
      *
      * @event TRTCCallback#onLocalRecordComplete
-     * @param {number} errCode - 错误码 0：录制成功；-1：录制失败；-2：切换分辨率或横竖屏导致录制结束。
+     * @param {number} errCode - 错误码
+     *   - 0：录制成功；
+     *   - -1：录制失败；
+     *   - -2：切换分辨率或横竖屏导致录制结束；
+     *   - -3：录制时间太短，或未采集到任何视频或音频数据，请检查录制时长，或是否已开启音、视频采集。
      * @param {string} storagePath - 录制文件存储路径
      */
     handleOnLocalRecordComplete(errCode, storagePath) {
@@ -1878,7 +1913,7 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     setCameraCaptureParams(params) {
         if (params && (0, validate_util_1.isNumber)(params.mode) && (0, validate_util_1.isNumber)(params.width) && (0, validate_util_1.isNumber)(params.height)) {
-            this.rtcCloud.setCameraCaptureParam(params);
+            this.getDeviceManager().setCameraCaptureParam(params);
         }
         else {
             this.logger.error('setCameraCaptureParams invalid params:', params);
@@ -2639,27 +2674,10 @@ class TRTCCloud extends events_1.EventEmitter {
      *    var camera = cameralist[i];
      *    console.info("camera deviceName: " + camera.deviceName + " deviceId:" + camera.deviceId);
      * }
-     * @return {TRTCDeviceInfo[]} 摄像头管理器列表
+     * @return {Array<TRTCDeviceInfo>} 摄像头管理器列表
      */
     getCameraDevicesList() {
-        const deviceInfos = this.rtcCloud.getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera);
-        deviceInfos.forEach(item => {
-            try {
-                if (item.deviceProperties) {
-                    const properties = JSON.parse(item.deviceProperties);
-                    item.deviceProperties = properties;
-                }
-                else {
-                    // 虚拟摄像头可能没有 deviceProperties 字段
-                    item.deviceProperties = {};
-                }
-            }
-            catch (e) {
-                this.logger.warn('camera device properties parse error.', JSON.stringify(item));
-                item.deviceProperties = {};
-            }
-        });
-        return deviceInfos;
+        return this.getDeviceManager().getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera);
     }
     /**
      * 设置要使用的摄像头
@@ -2667,7 +2685,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} deviceId - 从 getCameraDevicesList 中得到的设备 ID
      */
     setCurrentCameraDevice(deviceId) {
-        this.rtcCloud.setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera, deviceId);
+        this.getDeviceManager().setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera, deviceId);
     }
     /**
      * 获取当前使用的摄像头
@@ -2675,7 +2693,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {TRTCDeviceInfo} 设备信息，能获取设备 ID 和设备名称
      */
     getCurrentCameraDevice() {
-        return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera);
+            return this.stateStore.get('currentCamera');
+        }
+        else {
+            return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeCamera);
+        }
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -2691,10 +2715,10 @@ class TRTCCloud extends events_1.EventEmitter {
      *     var mic = miclist[i];
      *     console.info("mic deviceName: " + mic.deviceName + " deviceId:" + mic.deviceId);
      *   }
-     * @return {TRTCDeviceInfo[]} 麦克风管理器列表
+     * @return {Array<TRTCDeviceInfo>} 麦克风管理器列表
      */
     getMicDevicesList() {
-        return this.rtcCloud.getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        return this.getDeviceManager().getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
     }
     /**
      * 获取当前选择的麦克风
@@ -2702,7 +2726,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {TRTCDeviceInfo} 设备信息，能获取设备 ID 和设备名称
      */
     getCurrentMicDevice() {
-        return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+            return this.stateStore.get('currentMic');
+        }
+        else {
+            return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        }
     }
     /**
      * 设置要使用的麦克风
@@ -2712,7 +2742,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} micId - 从 getMicDevicesList 中得到的设备 ID
      */
     setCurrentMicDevice(micId) {
-        this.rtcCloud.setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, micId);
+        this.getDeviceManager().setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, micId);
     }
     /**
      * 获取系统当前麦克风设备音量
@@ -2721,7 +2751,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {Number} 音量值，范围是0 - 100
      */
     getCurrentMicDeviceVolume() {
-        return this.rtcCloud.getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+            return this.stateStore.get('currentMicVolume');
+        }
+        else {
+            return this.getDeviceManager().getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        }
     }
     /**
      * 设置系统当前麦克风设备的音量
@@ -2730,7 +2766,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 麦克风音量值，范围0 - 100
      */
     setCurrentMicDeviceVolume(volume) {
-        this.rtcCloud.setCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, volume);
+        this.getDeviceManager().setCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, volume);
     }
     /**
      * 设置系统当前麦克风设备的静音状态
@@ -2738,7 +2774,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Boolean} mute 设置为 true 时，麦克风设备静音；设置为 false时，麦克风设备取消静音
      */
     setCurrentMicDeviceMute(mute) {
-        this.rtcCloud.setCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, mute);
+        this.getDeviceManager().setCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic, mute);
     }
     /**
      * 获取系统当前麦克风设备是否静音
@@ -2746,7 +2782,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {Boolean} 静音状态
      */
     getCurrentMicDeviceMute() {
-        return this.rtcCloud.getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+            return this.stateStore.get('isCurrentMicMute');
+        }
+        else {
+            return this.rtcCloud.getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeMic);
+        }
     }
     /**
      * 获取扬声器设备列表
@@ -2757,10 +2799,10 @@ class TRTCCloud extends events_1.EventEmitter {
      *     var speaker = speakerlist[i];
      *     console.info("mic deviceName: " + speaker.deviceName + " deviceId:" + speaker.deviceId);
      *   }
-     * @return {TRTCDeviceInfo[]} 扬声器管理器列表
+     * @return {Array<TRTCDeviceInfo>} 扬声器管理器列表
      */
     getSpeakerDevicesList() {
-        return this.rtcCloud.getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        return this.getDeviceManager().getDevicesList(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
     }
     /**
      * 获取当前的扬声器设备
@@ -2768,7 +2810,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {TRTCDeviceInfo} 设备信息，能获取设备 ID 和设备名称
      */
     getCurrentSpeakerDevice() {
-        return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+            return this.stateStore.get('currentSpeaker');
+        }
+        else {
+            return this.rtcCloud.getCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        }
     }
     /**
      * 设置要使用的扬声器
@@ -2776,7 +2824,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} speakerId - 从 getSpeakerDevicesList 中得到的设备 ID
      */
     setCurrentSpeakerDevice(speakerId) {
-        this.rtcCloud.setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, speakerId);
+        this.getDeviceManager().setCurrentDevice(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, speakerId);
     }
     /**
      * 获取系统当前扬声器设备音量
@@ -2784,7 +2832,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {Number} 扬声器音量，范围0 - 100
      */
     getCurrentSpeakerVolume() {
-        return this.rtcCloud.getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+            return this.stateStore.get('currentSpeakerVolume');
+        }
+        else {
+            return this.getDeviceManager().getCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        }
     }
     /**
      * 设置系统当前扬声器设备音量
@@ -2794,7 +2848,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 设置的扬声器音量，范围0 - 100
      */
     setCurrentSpeakerVolume(volume) {
-        this.rtcCloud.setCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, volume);
+        this.getDeviceManager().setCurrentDeviceVolume(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, volume);
     }
     /**
      * 设置系统当前扬声器设备的静音状态
@@ -2802,7 +2856,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Boolean} mute 设置为 true 时，扬声器设备静音；设置为 false时，扬声器设备取消静音
      */
     setCurrentSpeakerDeviceMute(mute) {
-        this.rtcCloud.setCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, mute);
+        this.getDeviceManager().setCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker, mute);
     }
     /**
      * 获取系统当前扬声器设备是否静音
@@ -2810,7 +2864,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @return {Boolean} 静音状态
      */
     getCurrentSpeakerDeviceMute() {
-        return this.rtcCloud.getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        if (TRTCCloud.isIPCMode) {
+            this.getDeviceManager().getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+            return this.stateStore.get('isCurrentSpeakerMute');
+        }
+        else {
+            return this.rtcCloud.getCurrentDeviceMute(trtc_define_1.TRTCDeviceType.TRTCDeviceTypeSpeaker);
+        }
     }
     /**
      * 设置 SDK 使用的音频设备自动跟随系统默认设备
@@ -2823,7 +2883,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *  - false: 不跟随。只有当 SDK 使用的音频设备被移除后或插入新的音频设备为系统默认设备时，SDK 才切换至系统默认的音频设备。
      */
     enableFollowingDefaultAudioDevice(deviceType, enable) {
-        this.rtcCloud.enableFollowingDefaultAudioDevice(deviceType, enable);
+        this.getDeviceManager().enableFollowingDefaultAudioDevice(deviceType, enable);
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -3686,7 +3746,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      */
     setMusicObserver(observer) {
-        this.rtcCloud.setMusicObserver(observer.onStart, observer.onPlayProgress, observer.onComplete);
+        this.getAudioEffectManager().setMusicObserver(observer);
     }
     /**
      * 开始播放背景音乐
@@ -3720,17 +3780,17 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     startPlayMusic(musicParam, callbackMap) {
         if ((callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onStart) || (callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onPlayProgress) || (callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onComplete)) {
-            this.rtcCloud.setMusicObserver((callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onStart) || null, (callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onPlayProgress) || null, (callbackMap === null || callbackMap === void 0 ? void 0 : callbackMap.onComplete) || null);
+            this.getAudioEffectManager().setMusicObserver(callbackMap);
         }
-        this.rtcCloud.startPlayMusic(musicParam);
+        this.getAudioEffectManager().startPlayMusic(musicParam);
     }
     /**
      * 停止播放背景音乐
      *
-     * @param {Number} id 音乐 ID
+     * @param {Number} id - 音乐 ID
      */
     stopPlayMusic(id) {
-        this.rtcCloud.stopPlayMusic(id);
+        this.getAudioEffectManager().stopPlayMusic(id);
     }
     /**
      * 暂停播放背景音乐
@@ -3738,7 +3798,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} id 音乐 ID
      */
     pausePlayMusic(id) {
-        this.rtcCloud.pausePlayMusic(id);
+        this.getAudioEffectManager().pausePlayMusic(id);
     }
     /**
      * 恢复播放背景音乐
@@ -3746,7 +3806,16 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} id 音乐 ID
      */
     resumePlayMusic(id) {
-        this.rtcCloud.resumePlayMusic(id);
+        this.getAudioEffectManager().resumePlayMusic(id);
+    }
+    /**
+   * 获取背景音乐的播放进度（单位：毫秒）
+   *
+   * @param {Number} id - 音乐 ID。
+   * @return {Promise<number>|Number} 成功返回当前播放时间，单位：毫秒，失败返回 -1。
+   */
+    getMusicCurrentPosInMS(id) {
+        return this.getAudioEffectManager().getMusicCurrentPosInMS(id);
     }
     /**
      * 获取背景音乐文件总时长，单位毫秒
@@ -3756,7 +3825,13 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     getMusicDurationInMS(path) {
         path = path.replace('file:///', '');
-        return this.rtcCloud.getMusicDurationInMS(path);
+        if (TRTCCloud.isIPCMode) {
+            this.getAudioEffectManager().getMusicDurationInMS(path);
+            return this.stateStore.get(`musicDuration-{path}`);
+        }
+        else {
+            return this.getAudioEffectManager().getMusicDurationInMS(path);
+        }
     }
     /**
      * 设置背景音乐播放进度
@@ -3765,7 +3840,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} pts - 单位: 毫秒
      */
     seekMusicToPosInTime(id, pts) {
-        return this.rtcCloud.seekMusicToPosInTime(id, pts);
+        this.getAudioEffectManager().seekMusicToPosInTime(id, pts);
     }
     /**
      * 设置所有背景音乐的本地音量和远端音量的大小
@@ -3779,7 +3854,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 200。
      */
     setAllMusicVolume(volume) {
-        return this.rtcCloud.setAllMusicVolume(volume);
+        this.getAudioEffectManager().setAllMusicVolume(volume);
     }
     /**
      * 设置背景音乐本地播放音量的大小
@@ -3790,7 +3865,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 100；默认值：100
      */
     setMusicPlayoutVolume(id, volume) {
-        this.rtcCloud.setMusicPlayoutVolume(id, volume);
+        this.getAudioEffectManager().setMusicPlayoutVolume(id, volume);
     }
     /**
      * 设置背景音乐远端播放音量的大小
@@ -3801,7 +3876,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 100；默认值：100
      */
     setMusicPublishVolume(id, volume) {
-        this.rtcCloud.setMusicPublishVolume(id, volume);
+        this.getAudioEffectManager().setMusicPublishVolume(id, volume);
     }
     /**
      * 开启耳返
@@ -3812,7 +3887,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Boolean} enable - 是否开启耳返。
      */
     enableVoiceEarMonitor(enable) {
-        this.rtcCloud.enableVoiceEarMonitor(enable);
+        this.getAudioEffectManager().enableVoiceEarMonitor(enable);
     }
     /**
      * 设置耳返音量
@@ -3823,7 +3898,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volumn - 音量大小，取值范围为0 - 100，默认值：100。
      */
     setVoiceEarMonitorVolume(volumn) {
-        this.rtcCloud.setVoiceEarMonitorVolume(volumn);
+        this.getAudioEffectManager().setVoiceEarMonitorVolume(volumn);
     }
     /**
      * 设置语音音量
@@ -3834,7 +3909,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} volume - 音量大小，取值范围为0 - 100，默认值：100。
      */
     setVoiceCaptureVolume(volume) {
-        this.rtcCloud.setVoiceCaptureVolume(volume);
+        this.getAudioEffectManager().setVoiceCaptureVolume(volume);
     }
     /**
      * 设置语音音调
@@ -3846,7 +3921,7 @@ class TRTCCloud extends events_1.EventEmitter {
         if (pitch < -1.0 || pitch > 1.0) {
             throw new Error('pitch is out of range [-1.0, 1.0]');
         }
-        this.rtcCloud.setVoicePitch(pitch);
+        this.getAudioEffectManager().setVoicePitch(pitch);
     }
     /**
      * 设置人声的混响效果
@@ -3858,7 +3933,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {TRTCVoiceReverbType} type - 人声的混响效果类型。
      */
     setVoiceReverbType(type) {
-        this.rtcCloud.setVoiceReverbType(type);
+        this.getAudioEffectManager().setVoiceReverbType(type);
     }
     /**
      * 设置人声的变声效果
@@ -3869,7 +3944,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {TRTCVoiceChangerType} type - 人声的变声效果类型 。
      */
     setVoiceChangerType(type) {
-        this.rtcCloud.setVoiceChangerType(type);
+        this.getAudioEffectManager().setVoiceChangerType(type);
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -4091,13 +4166,13 @@ class TRTCCloud extends events_1.EventEmitter {
         if (playback === undefined || playback === null) {
             playback = false;
         }
-        this.rtcCloud.startMicDeviceTest(interval, playback);
+        this.getDeviceManager().startMicDeviceTest(interval, playback);
     }
     /**
      * 停止麦克风测试
      */
     stopMicDeviceTest() {
-        this.rtcCloud.stopMicDeviceTest();
+        this.getDeviceManager().stopMicDeviceTest();
     }
     /**
      * 开始进行扬声器测试
@@ -4110,13 +4185,13 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     startSpeakerDeviceTest(testAudioFilePath) {
         testAudioFilePath = testAudioFilePath.replace('file:///', '');
-        this.rtcCloud.startSpeakerDeviceTest(testAudioFilePath);
+        this.getDeviceManager().startSpeakerDeviceTest(testAudioFilePath);
     }
     /**
      * 停止扬声器测试
      */
     stopSpeakerDeviceTest() {
-        this.rtcCloud.stopSpeakerDeviceTest();
+        this.getDeviceManager().stopSpeakerDeviceTest();
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -4298,51 +4373,7 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     setPluginParams(type, options) {
         this.logger.log(`setPluginParams params:`, type, options);
-        switch (type) {
-            case trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess:
-                this._setVideoProcessPluginParams(options);
-                break;
-            case trtc_define_1.TRTCPluginType.TRTCPluginTypeMediaEncryptDecrypt:
-                this._setMediaEncryptDecryptPluginParams(options);
-                break;
-            case trtc_define_1.TRTCPluginType.TRTCPluginTypeAudioProcess:
-                this._setAudioProcessPluginParams(options);
-                break;
-            default:
-                this.logger.log(`setPluginConfigParams invalid type:${type}`);
-                break;
-        }
-    }
-    _setVideoProcessPluginParams(options) {
-        if (options.pixelFormat !== undefined) {
-            switch (options.pixelFormat) {
-                case trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420:
-                case trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_RGBA32:
-                case trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32:
-                    this.videoProcessBufferType = trtc_define_1.TRTCVideoBufferType.TRTCVideoBufferType_Buffer;
-                    break;
-                case trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_Texture_2D:
-                    this.videoProcessBufferType = trtc_define_1.TRTCVideoBufferType.TRTCVideoBufferType_Texture;
-                    break;
-                default:
-                    console.error(`setPluginParams() unspported pixelFormat: ${options.pixelFormat}`);
-                    return;
-            }
-            this.videoProcessPixelFormat = options.pixelFormat;
-        }
-        if (options.enable !== undefined) {
-            this.rtcCloud.enableLocalVideoCustomProcess(!!options.enable, this.videoProcessPixelFormat, this.videoProcessBufferType);
-        }
-    }
-    _setMediaEncryptDecryptPluginParams(options) {
-        if (options.enable !== undefined) {
-            this.rtcCloud.enableEncodedDataCustomProcess(!!options.enable);
-        }
-    }
-    _setAudioProcessPluginParams(options) {
-        if (options.enable !== undefined) {
-            this.rtcCloud.enableAudioFrameCustomProcess(!!options.enable);
-        }
+        this.getPluginManager().setPluginParams(type, options);
     }
     /**
      * 添加插件
@@ -4357,10 +4388,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      */
     addPlugin(options) {
-        const pluginType = options.type || trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess;
-        const realDeviceId = options.deviceId || "";
-        this.rtcCloud.registerPlugin(options.id, options.path, pluginType, realDeviceId);
-        return this._createPlugin(options.id, realDeviceId);
+        return this.getPluginManager().addPlugin(options);
     }
     /**
      * 删除插件
@@ -4370,26 +4398,11 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param [deviceId] {String} - 摄像头设备 ID，开启多个摄像头美颜时必填。
      */
     removePlugin(id, deviceId) {
-        this.rtcCloud.unregisterPlugin(id, deviceId || "");
-    }
-    _createPlugin(pluginId, deviceId) {
-        return {
-            id: pluginId,
-            deviceId: deviceId || "",
-            enable: () => {
-                return this.rtcCloud.enablePlugin(pluginId, true, deviceId || "");
-            },
-            disable: () => {
-                return this.rtcCloud.enablePlugin(pluginId, false, deviceId || "");
-            },
-            setParameter: (param) => {
-                return this.rtcCloud.setPluginParameter(pluginId, param, deviceId || "");
-            }
-        };
+        this.getPluginManager().removePlugin(id, deviceId || "");
     }
     /**
      * 注册插件事件监听，全局只需要调用一次
-     * @param {Function} pluginCb - 插件事件回调函数
+     * @param {Function} pluginCallback - 插件事件回调函数
      *  - pluginId - 插件ID
      *  - errorCode - 错误码。0、-1、-2、-3、-4、-5 是 SDK 内部定义错误码，其它错误码是插件自定义错误码。
      *     - 0 表示 addPlugin 成功
@@ -4402,8 +4415,8 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      *  注意：错误码：-1000 到 1000 是 SDK 预留错误码，用户自定义插件中，请使用这个范围以外的错误码。
      */
-    setPluginCallback(pluginCb) {
-        this.rtcCloud.setPluginCallback(pluginCb);
+    setPluginCallback(pluginCallback) {
+        this.getPluginManager().setCallback(pluginCallback);
     }
     /**
      * 初始化插件管理器
@@ -4419,10 +4432,12 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      */
     initPluginManager(options) {
-        this.setPluginParams(trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess, {
-            enable: true,
-            pixelFormat: (options === null || options === void 0 ? void 0 : options.pixelFormat) || trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420
-        });
+        if (!TRTCCloud.isIPCMode) {
+            this.setPluginParams(trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess, {
+                enable: true,
+                pixelFormat: (options === null || options === void 0 ? void 0 : options.pixelFormat) || trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420
+            });
+        }
     }
     /**
      * 销毁插件管理
@@ -4431,22 +4446,21 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      */
     destroyPluginManager() {
-        this.setPluginParams(trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess, {
-            enable: false,
-        });
+        if (!TRTCCloud.isIPCMode) {
+            this.setPluginParams(trtc_define_1.TRTCPluginType.TRTCPluginTypeVideoProcess, {
+                enable: false,
+            });
+        }
     }
     /**
      * 获取插件列表
-     * @returns TRTCPluginInfo[]
+     * @returns TRTCPluginInfo[]|null
      *
      * @ignore
      * @deprecated
      */
     getPluginList() {
-        return this.rtcCloud.getPluginIds().map((item) => {
-            const ids = item.split('__');
-            return this._createPlugin(ids[0], ids[1]);
-        });
+        return this.getPluginManager().getPluginList();
     }
     //----------------------------------//
     // plugin API -- end
@@ -4454,6 +4468,22 @@ class TRTCCloud extends events_1.EventEmitter {
     //----------------------------------//
     // Vod API -- start
     //----------------------------------//
+    // createVodPlayer(mediaFilePath: string, repeat: boolean) {
+    //     const nativeVodPlayer = this.rtcCloud.createVodPlayer(mediaFilePath, repeat);
+    //     if (nativeVodPlayer) {
+    //         const vodPlayer = new VodPlayer(nativeVodPlayer, mediaFilePath, repeat);
+    //         vodPlayer.setVodPlayerRenderCallback();
+    //         vodPlayer.setVodEventCallback();
+    //         this.vodPlayers[vodPlayer.key] = vodPlayer;
+    //         return vodPlayer;
+    //     }
+    //     return null;
+    // }
+    // destroyVodPlayer(vodPlayer: VodPlayer) {
+    //     vodPlayer.destroyRender();
+    //     this.rtcCloud.destroyVodPlayer(vodPlayer.key);
+    //     delete this.vodPlayers[vodPlayer.key];
+    // }
     //----------------------------------//
     // Vod API -- end
     //----------------------------------//
@@ -4464,6 +4494,9 @@ class TRTCCloud extends events_1.EventEmitter {
         this.logger.debug('setEnableRenderFrame:' + enable);
         this.enableRenderFrame = enable;
     }
+    log(info) {
+        this.rtcCloud.log(info);
+    }
     _getRendererMap(uid, streamType) {
         const key = this._getKey(uid, streamType);
         return this.videoRendererMap.get(key);
@@ -4859,6 +4892,101 @@ class TRTCCloud extends events_1.EventEmitter {
         }
         videoBufferInfo.buffer && this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
     }
+    // //-------------------------------------------------//
+    // // Local media transcoding API begin
+    // //-------------------------------------------------//
+    // /**
+    //  * 创建本地多媒体合图实例
+    //  *
+    //  * 注意：单例模式，多次调用返回的是同一个对象
+    //  *
+    //  * @param {Object} config - 配置参数
+    //  * @param {TRTCVideoPixelFormat} config.pixelFormat - 视频数据的像素格式
+    //  * @returns {TRTCLocalMediaTranscoder}
+    //  */
+    // createLocalMediaTranscoder(config?: {
+    //     pixelFormat: TRTCVideoPixelFormat
+    // }): TRTCLocalMediaTranscoder | null {
+    //     if (this.localMediaTranscoder === null) {
+    //         let pixelFormat = TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
+    //         if (config && config.pixelFormat) {
+    //             pixelFormat = config.pixelFormat;
+    //         }
+    //         const nativeLocalMediaTranscoding = this.rtcCloud.createLocalMediaTranscoding();
+    //         if (nativeLocalMediaTranscoding) {
+    //             this.localMediaTranscoder = new TRTCLocalMediaTranscoder(nativeLocalMediaTranscoding, pixelFormat);
+    //         } else {
+    //             console.warn('TRTCLocalMediaTranscoder create error. Currently only support "Windows" operation system.')
+    //         }
+    //     }
+    //     return this.localMediaTranscoder;
+    // }
+    // /**
+    //  * 销毁本地多媒体合图实例
+    //  */
+    // destroyLocalMediaTranscoder(): void {
+    //     if (this.localMediaTranscoder) {
+    //         try {
+    //             this.localMediaTranscoder.destroy();
+    //             this.localMediaTranscoder = null;
+    //             this.rtcCloud.destroyLocalMediaTranscoding();
+    //         } catch (e: any) {
+    //             // 重复销毁会有报错提示
+    //             console.warn(`trtc:destroyLocalMediaTranscoder warning:`, e.message);
+    //         }
+    //     }
+    // }
+    // //-------------------------------------------------//
+    // // Local media transocoding API end
+    // //-------------------------------------------------//
+    /**
+     * 获取设备管理器
+     *
+     * @returns {TRTCDeviceManager}
+     */
+    getDeviceManager() {
+        return DeviceManager_1.default.getInstance({
+            isIPCMode: TRTCCloud.isIPCMode,
+            nodeTRTCCloud: this.rtcCloud,
+        });
+    }
+    /**
+     * 获取音效管理器
+     *
+     * @returns {TRTCAudioEffectManager}
+     */
+    getAudioEffectManager() {
+        return AudioEffectManager_1.default.getInstance({
+            isIPCMode: TRTCCloud.isIPCMode,
+            nodeTRTCCloud: this.rtcCloud,
+        });
+    }
+    /**
+     * 获取本地混流管理器
+     *
+     * @returns {TRTCMediaMixingManager | null}
+     */
+    getMediaMixingManager() {
+        if (TRTCCloud.isIPCMode) {
+            return MediaMixingManager_1.default.getInstance({
+                deviceManager: this.getDeviceManager()
+            });
+        }
+        else {
+            return null;
+        }
+    }
+    /**
+     * 获取插件管理器
+     *
+     * @returns {TRTCPluginManager}
+     */
+    getPluginManager() {
+        return PluginManager_1.default.getInstance({
+            isIPCMode: TRTCCloud.isIPCMode,
+            nodeTRTCCloud: this.rtcCloud,
+        });
+    }
 }
 class VideoRenderCallback {
     constructor() {