trtc-electron-sdk 13.4.802-beta.2 → 13.4.802-beta.4

package/liteav/MediaMixingDesigner/index.d.ts

@@ -3,6 +3,7 @@ export declare type TRTCMediaInfo = {
     id: string;
     rect: Rect;
     isSelected: boolean;
+    isLocked?: boolean;
     zOrder: number;
     origin: any;
 };

package/liteav/MediaMixingDesigner/index.js

@@ -272,12 +272,16 @@ class TRTCMediaMixingDesigner {
         }
     }
     updateOverlay() {
+        var _a;
         if (this.moveAndResizeOverlay) {
             let left = this.absoluteWorkingArea.left + this.previewLeft;
             let top = this.absoluteWorkingArea.top + this.previewTop;
             let width = 0;
             let height = 0;
-            if (this.selectedMediaIndex >= 0) {
+            // Even if a locked media source is forced into "selected" state (e.g. via
+            // an external list panel selection), the move/resize overlay must stay
+            // hidden so it cannot be dragged or resized from the canvas.
+            if (this.selectedMediaIndex >= 0 && !((_a = this.mediaList[this.selectedMediaIndex]) === null || _a === void 0 ? void 0 : _a.isLocked)) {
                 this.moveAndResizeOverlay.style.display = 'block';
                 const selectedPreviewRect = {
                     left: this.mediaList[this.selectedMediaIndex].rect.left * this.previewScale,
@@ -415,6 +419,10 @@ class TRTCMediaMixingDesigner {
                 for (let i = 0; i < this.mediaList.length; i++) {
                     const item = this.mediaList[i];
                     if (item.rect &&
+                        // Locked media sources are excluded from hit test, so a click on a
+                        // locked source falls through to the next (lower zOrder) hit, and
+                        // it can never be selected/dragged/resized via canvas interaction.
+                        !item.isLocked &&
                         xInImage >= item.rect.left &&
                         xInImage <= item.rect.right &&
                         yInImage >= item.rect.top &&

package/liteav/VideoRenderControl/LocalVideoRenderController.d.ts

@@ -17,7 +17,7 @@ declare class LocalVideoRenderController {
     startLocalPreview(views: Array<HTMLElement> | HTMLElement | null): void;
     stopLocalPreview(): void;
     updateLocalView(views: Array<HTMLElement> | HTMLElement | null): void;
-    startScreenCapture(view?: HTMLElement | null): void;
+    startScreenCapture(views?: Array<HTMLElement> | HTMLElement | null): void;
     stopScreenCapture(): void;
     setCustomRenderCallback(hasCallback: boolean): void;
     setExternalRenderEnabled(enabled: boolean): void;

package/liteav/VideoRenderControl/LocalVideoRenderController.js

@@ -53,10 +53,10 @@ class LocalVideoRenderController {
             throw error;
         }
     }
-    startScreenCapture(view = null) {
+    startScreenCapture(views = null) {
         try {
             this.isLocalSharingStarted = true;
-            this.hasLocalSharingView = view !== null && view !== undefined;
+            this.hasLocalSharingView = this.validateViews(views);
             this.update();
         }
         catch (error) {
@@ -139,6 +139,10 @@ class LocalVideoRenderController {
         if (this.isLocalSharingStarted && this.hasLocalSharingView) {
             return type_1.LocalVideoRenderCallbackState.Listening;
         }
+        // 屏幕共享已启动且有自定义渲染回调，需要监听回调
+        if (this.isLocalSharingStarted && this.hasCustomRenderCallback) {
+            return type_1.LocalVideoRenderCallbackState.Listening;
+        }
         // 默认不监听回调
         return type_1.LocalVideoRenderCallbackState.NotListening;
     }

package/liteav/extensions/MediaMixingManager/MediaMixingManager.d.ts

@@ -278,6 +278,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * 设置摄像头采集参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param cameraID {string} - 摄像头 ID
      * @param params {TRTCCameraCaptureParams} - 摄像头采集参数
@@ -296,6 +297,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * 设置屏幕采集参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param screenOrWindowID {String} - 屏幕 ID 或 窗口 ID
      * @param property {TRTCScreenCaptureProperty} - 屏幕采集属性
@@ -305,6 +307,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * 设置在线视频源播放参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param url {string} - 在线视频源 URL
      * @param param {TRTCOnlineVideoParam} - 在线视频源播放参数
@@ -314,6 +317,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * 设置视频文件播放参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param videoFilePath {string} - 视频文件路径
      * @param param {TRTCVideoFileParam} - 视频文件播放参数
@@ -335,6 +339,7 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * @returns {Promise<void>}
      */
     updatePublishParams(params: TRTCMediaMixingEncParam): Promise<void>;
+    private updatePublishParamsWithExperimentalAPI;
     /**
      * 设置连麦视频流布局
      *
@@ -535,6 +540,8 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      * setter call.
      */
     private _isSameCaptureParams;
+    private _omitIsPaused;
+    private _setVideoFilePaused;
     private previewInNativeWindow;
     private previewInWebElement;
     private previewInNone;

package/liteav/extensions/MediaMixingManager/MediaMixingManager.js

@@ -8,12 +8,24 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRTCMediaMixingManager = exports.TRTCMediaMixingEvent = void 0;
 const events_1 = require("events");
+const lodash_isequal_1 = __importDefault(require("lodash.isequal"));
 const trtc_define_1 = require("../../trtc_define");
 const types_1 = require("./types");
 const utils_1 = require("../../utils");
@@ -644,6 +656,7 @@ class TRTCMediaMixingManager {
                     id: `${newMediaSource.sourceType}__${newMediaSource.sourceId}`,
                     rect: newMediaSource.rect,
                     isSelected: newMediaSource.isSelected || false,
+                    isLocked: newMediaSource.isLocked || false,
                     zOrder: newMediaSource.zOrder,
                     origin: newMediaSource
                 });
@@ -657,6 +670,8 @@ class TRTCMediaMixingManager {
                 return 11000;
             case types_1.TRTCMediaSourceType.kVideoFile:
                 return 6000;
+            case types_1.TRTCMediaSourceType.kCamera:
+                return 8000; // camera maybe very slow
             default:
                 return 5000;
         }
@@ -706,6 +721,7 @@ class TRTCMediaMixingManager {
             id: `${mediaSource.sourceType}__${mediaSource.sourceId}`,
             rect: mediaSource.rect,
             isSelected: mediaSource.isSelected || false,
+            isLocked: mediaSource.isLocked || false,
             zOrder: mediaSource.zOrder,
             origin: (0, utils_1.safelyParse)(JSON.stringify(mediaSource))
         });
@@ -740,6 +756,7 @@ class TRTCMediaMixingManager {
                 id: `${mediaSource.sourceType}__${mediaSource.sourceId}`,
                 rect: mediaSource.rect,
                 isSelected: mediaSource.isSelected || false,
+                isLocked: mediaSource.isLocked || false,
                 zOrder: mediaSource.zOrder,
                 origin: (0, utils_1.safelyParse)(JSON.stringify(mediaSource))
             });
@@ -750,6 +767,7 @@ class TRTCMediaMixingManager {
      * 设置摄像头采集参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param cameraID {string} - 摄像头 ID
      * @param params {TRTCCameraCaptureParams} - 摄像头采集参数
@@ -782,6 +800,7 @@ class TRTCMediaMixingManager {
      * 设置屏幕采集参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param screenOrWindowID {String} - 屏幕 ID 或 窗口 ID
      * @param property {TRTCScreenCaptureProperty} - 屏幕采集属性
@@ -793,6 +812,7 @@ class TRTCMediaMixingManager {
      * 设置在线视频源播放参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param url {string} - 在线视频源 URL
      * @param param {TRTCOnlineVideoParam} - 在线视频源播放参数
@@ -804,6 +824,7 @@ class TRTCMediaMixingManager {
      * 设置视频文件播放参数
      *
      * @deprecated 请使用 `addMediaSource` 或 `updateMediaSource` 代替
+     * @private
      *
      * @param videoFilePath {string} - 视频文件路径
      * @param param {TRTCVideoFileParam} - 视频文件播放参数
@@ -851,6 +872,11 @@ class TRTCMediaMixingManager {
                 width: this.mixingVideoWidth,
                 height: this.mixingVideoHeight
             });
+            return this.updatePublishParamsWithExperimentalAPI(params);
+        });
+    }
+    updatePublishParamsWithExperimentalAPI(params) {
+        return __awaiter(this, void 0, void 0, function* () {
             const result = yield this.nodeMediaMixingPlugin.updatePublishParams(Object.assign(Object.assign({}, params), { videoEncoderParams: {
                     videoResolution: 0,
                     resMode: 0,
@@ -1159,6 +1185,7 @@ class TRTCMediaMixingManager {
                         id: `${mediaSource.sourceType}__${mediaSource.sourceId}`,
                         rect: mediaSource.rect,
                         isSelected: mediaSource.isSelected || false,
+                        isLocked: mediaSource.isLocked || false,
                         zOrder: mediaSource.zOrder,
                         origin: mediaSource
                     });
@@ -1299,6 +1326,7 @@ class TRTCMediaMixingManager {
                 id: `${this.sourceList[index].sourceType}__${this.sourceList[index].sourceId}`,
                 rect: this.sourceList[index].rect,
                 isSelected: this.sourceList[index].isSelected || false,
+                isLocked: this.sourceList[index].isLocked || false,
                 zOrder: this.sourceList[index].zOrder,
                 origin: (0, utils_1.safelyParse)(JSON.stringify(this.sourceList[index]))
             });
@@ -1526,7 +1554,7 @@ class TRTCMediaMixingManager {
                 yield this.startMediaMixingServer('', recoverMode);
                 yield this.bindPreviewArea(this.windowID, this.view);
                 yield this.startPublish();
-                yield this.nodeMediaMixingPlugin.updatePublishParams(this.publishParams);
+                yield this.updatePublishParamsWithExperimentalAPI(this.publishParams);
                 // 混流服务崩溃重启后，底层 NodeRemoteVideoPluginManager 为全新初始状态，
                 // 需要重放之前通过 setPluginParams 设置的插件参数。
                 const pluginManager = this.pluginManager;
@@ -1620,6 +1648,7 @@ class TRTCMediaMixingManager {
      *                         setter is always invoked when params are present).
      */
     _applyMediaSourceParams(mediaSource, oldMediaSource) {
+        var _a;
         switch (mediaSource.sourceType) {
             case types_1.TRTCMediaSourceType.kCamera:
                 // Skip kCamera on the add path to avoid an extra camera restart;
@@ -1639,10 +1668,22 @@ class TRTCMediaMixingManager {
                 }
                 break;
             case types_1.TRTCMediaSourceType.kVideoFile:
-                if (mediaSource.localVideo && !this._isSameCaptureParams(mediaSource.localVideo, oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.localVideo)) {
-                    this.setVideoFileParam(mediaSource.sourceId, mediaSource.localVideo);
+                if (mediaSource.localVideo) {
+                    const nextParam = this._omitIsPaused(mediaSource.localVideo);
+                    const prevParam = this._omitIsPaused(oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.localVideo);
+                    if (!this._isSameCaptureParams(nextParam, prevParam)) {
+                        this.setVideoFileParam(mediaSource.sourceId, mediaSource.localVideo);
+                    }
+                    const nextIsPaused = !!mediaSource.localVideo.isPaused;
+                    const prevIsPaused = !!((_a = oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.localVideo) === null || _a === void 0 ? void 0 : _a.isPaused);
+                    if (nextIsPaused !== prevIsPaused) {
+                        this._setVideoFilePaused(mediaSource.sourceId, nextIsPaused);
+                    }
                 }
                 break;
+            default:
+                logger_1.default.warn(`[TRTC] Unknown media source type: ${mediaSource.sourceType}`);
+                break;
         }
     }
     /**
@@ -1674,12 +1715,21 @@ class TRTCMediaMixingManager {
         if (nextEmpty || prevEmpty) {
             return false;
         }
-        try {
-            return JSON.stringify(next) === JSON.stringify(prev);
+        return (0, lodash_isequal_1.default)(next, prev);
+    }
+    _omitIsPaused(param) {
+        if (!param) {
+            return undefined;
         }
-        catch (err) {
-            logger_1.default.warn(`${this.logPrefix}_isSameCaptureParams: stringify failed, treat as different.`, err);
-            return false;
+        const { isPaused } = param, rest = __rest(param, ["isPaused"]);
+        return rest;
+    }
+    _setVideoFilePaused(sourceId, isPaused) {
+        if (isPaused) {
+            this.nodeMediaMixingPlugin.pauseVideoFileSource(sourceId);
+        }
+        else {
+            this.nodeMediaMixingPlugin.resumeVideoFileSource(sourceId);
         }
     }
     previewInNativeWindow(viewOrRegion) {

package/liteav/extensions/MediaMixingManager/types.d.ts

@@ -46,6 +46,9 @@ export declare type TRTCOnlineVideoParam = {
 export declare type TRTCVideoFileParam = {
     playoutVolume: number;
 };
+export declare type TRTCMediaMixingLocalVideoParam = TRTCVideoFileParam & {
+    isPaused?: boolean;
+};
 export declare type TRTCMediaSource = {
     sourceType: TRTCMediaSourceType;
     sourceId: string;
@@ -53,12 +56,13 @@ export declare type TRTCMediaSource = {
     enableGreenScreen?: boolean;
     rect: Rect;
     isSelected?: boolean;
+    isLocked?: boolean;
     rotation?: TRTCVideoRotation;
     fillMode?: TRTCVideoFillMode;
     mirrorType?: TRTCVideoMirrorType;
     camera?: TRTCCameraCaptureParams;
     screen?: TRTCScreenCaptureProperty;
-    localVideo?: TRTCVideoFileParam;
+    localVideo?: TRTCMediaMixingLocalVideoParam;
     onlineVideo?: TRTCOnlineVideoParam;
 };
 export declare type TRTCMediaMixingEncParam = {

package/liteav/trtc.d.ts

@@ -2,7 +2,7 @@
 import { EventEmitter } from 'events';
 import { TRTCConfig } from './Renderer/util';
 import TRTCLocalMediaTranscoder from './LocalMediaTranscoder';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCAudioFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoEncParam, TRTCVideoFillMode, TRTCAudioFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig } from './trtc_define';
 import { ITRTCCloud, TRTCVideoRenderCallback } from './types';
 import TRTCMediaMixingManager, { TRTCMediaMixingService } from './extensions/MediaMixingManager';
 /**
@@ -112,6 +112,10 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     static destroyTRTCShareInstance(): void;
     private onFPSChanged;
+    /**
+     * 销毁当前实例，释放资源
+     */
+    destroy(): void;
     /**
      * 创建子实例
      *
@@ -130,6 +134,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     createSubCloud(config?: TRTCInitConfig): TRTCCloud | null;
     /**
+     * @private
      * 获取 TRTC 配置对象
      *
      * 可以通过 TRTC 配置对象 {@link TRTCConfig} 打开 debug 模式
@@ -144,17 +149,15 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     getConfigObject(): TRTCConfig;
     /**
+     * @private
      * @deprecated
      */
     setExternalRenderEnabled(enabled: boolean): void;
     /**
+     * @private
      * @deprecated
      */
     setCaptureLocalVideoEnabled(enabled: boolean): void;
-    /**
-     * 销毁当前实例，释放资源
-     */
-    destroy(): void;
     /**
      * 设置 TRTCCloud 回调
      *
@@ -1154,11 +1157,13 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * @param {String} streamId - 自定义流 ID。
      * @param {TRTCVideoStreamType} type - 仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub。
      * @deprecated
+     * @private
      */
     startPublishing(streamId: string, type: TRTCVideoStreamType): void;
     /**
      * 停止向腾讯云的直播 CDN 推流
      * @deprecated
+     * @private
      */
     stopPublishing(): void;
     /**
@@ -1175,11 +1180,13 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * @param {String} param.url   - 指定该路音视频流在第三方直播服务商的推流地址，推流 URL 必须为 RTMP 格式，必须符合您的目标直播服务商的规范要求，否则目标服务商会拒绝来自 TRTC 后台服务的推流请求。
      * @param {String} param.streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
      * @deprecated
+     * @private
      */
     startPublishCDNStream(param: any): void;
     /**
      * 停止向非腾讯云的直播 CDN 推流
      * @deprecated
+     * @private
      */
     stopPublishCDNStream(): void;
     /**
@@ -1249,6 +1256,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * @param {Number}  config.mixUsersArray[].soundLevel  - 该路音频参与混音时的音量等级（取值范围：0 - 100）,默认值：100。
      * @param {String}  config.mixUsersArray[].image       - 占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。当指定 inputType 为 TRTCMixInputTypePureAudio 时，image 为占位图，此时需要您指定 userId。当指定 inputType 为 TRTCMixInputTypeWatermark 时，image 为水印图，此时不需要您指定 userId。
      * @deprecated
+     * @private
      */
     setMixTranscodingConfig(config: Record<string, any>): void;
     private _startLocalPreview;
@@ -1333,6 +1341,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
     stopRemoteView(userId: string, streamType?: TRTCVideoStreamType): void;
     /**
      * 修改远端视频渲染的 HTML 元素
+     *
      * 本接口用于切换显示区域的交互场景中，修改远端视频渲染的 HTML 元素。
      *
      * 注意：必须调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 订阅了远端视频流之后，调用此接口才会生效。
@@ -1406,6 +1415,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setLocalRenderParams(params: TRTCRenderParams): void;
     /**
+     * @private
      * 废弃接口： 设置本地图像的渲染模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -1426,6 +1436,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setRemoteRenderParams(userId: string, streamType: TRTCVideoStreamType, params: TRTCRenderParams): void;
     /**
+     * @private
      * 废弃接口： 设置远端图像的渲染模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setRemoteRenderParams 接口替代。
@@ -1436,6 +1447,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setRemoteViewFillMode(userId: string, mode: TRTCVideoFillMode): void;
     /**
+     * @private
      * 废弃接口： 设置本地图像的顺时针旋转角度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -1447,6 +1459,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setLocalViewRotation(rotation: TRTCVideoRotation): void;
     /**
+     * @private
      * 废弃接口： 设置远端图像的顺时针旋转角度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setRemoteRenderParams 接口替代。
@@ -1467,6 +1480,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setVideoEncoderRotation(rotation: TRTCVideoRotation): void;
     /**
+     * @private
      * 废弃接口： 设置本地摄像头预览画面的镜像模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -1527,6 +1541,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     snapshotVideo(userId: string, type: TRTCVideoStreamType): void;
     /**
+     * @private
      * 废弃接口： 设定观看方优先选择的视频质量
      *
      * 低端设备推荐优先选择低清晰度的小画面。
@@ -1742,6 +1757,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setAudioQuality(quality: TRTCAudioQuality): void;
     /**
+     * @private
      * 废弃接口：设置麦克风的音量大小
      *
      * @deprecated 从 TRTCSDK6.9 后该接口已被废弃，请使用 setAudioCaptureVolume 接口替代。
@@ -1923,6 +1939,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setWaterMark(streamType: TRTCVideoStreamType, srcData: ArrayBuffer | string | null, srcType: TRTCWaterMarkSrcType, nWidth: number, nHeight: number, xOffset: number, yOffset: number, fWidthRatio: number): void;
     /**
+     * @private
      * 废弃接口： 开始显示远端用户的辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）
      *
      * - startRemoteView() 用于显示主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）。
@@ -1937,6 +1954,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     startRemoteSubStreamView(userId: string, view: HTMLElement): void;
     /**
+     * @private
      * 废弃接口： 停止显示远端用户的辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）。
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopRemoteView 接口替代。
@@ -1945,6 +1963,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     stopRemoteSubStreamView(userId: string): void;
     /**
+     * @private
      * 废弃接口： 设置辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的显示模式。
      *
      * - setRemoteViewFillMode() 用于设置远端主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的显示模式。
@@ -1959,6 +1978,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setRemoteSubStreamViewFillMode(userId: string, mode: TRTCVideoFillMode): void;
     /**
+     * @private
      * 废弃接口： 设置辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的顺时针旋转角度
      *
      * - setRemoteViewRotation() 用于设置远端主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的旋转角度。
@@ -2067,7 +2087,10 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
      * 默认情况下，屏幕分享使用辅路画面，如果使用主路画面，建议您提前停止摄像头采集（stopLocalPreview）避免相互冲突。
      *
-     * @param {HTMLElement} view - 承载预览画面的 DOM
+     * @param {Array<HTMLElement>|HTMLElement|null} views - 承载预览画面的单个 HTML 块节点或者 HTML 块节点数组
+     * - 传入单个 HTML 块节点：在该节点上预览屏幕分享画面。
+     * - 传入 HTML 块节点数组：在多个节点上同时预览同一路屏幕分享画面（多路预览），适用于双屏/多窗口场景。
+     * - 传入 `null`：不预览屏幕分享画面，但不影响屏幕分享的采集与上行；此时若设置了 [setLocalVideoRenderCallback()]{@link TRTCCloud#setLocalVideoRenderCallback} 自定义渲染回调，可通过回调获取屏幕分享的视频帧自行渲染。
      * @param {TRTCVideoStreamType} type 屏幕分享使用的线路，可以设置为主路（TRTCVideoStreamTypeBig）或者辅路（TRTCVideoStreamTypeSub），默认使用辅路。
      * @param {TRTCVideoEncParam} params 屏幕分享的画面编码参数，可以设置为 null，表示让 SDK 选择最佳的编码参数（分辨率、码率等）。即使在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig，依然可以使用此接口更新屏幕分享的编码参数。
      *
@@ -2113,12 +2136,20 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * );
      *
      * rtcCloud.startScreenCapture(
-     *  view, // HTML Element
+     *  view, // 单个 HTML Element
+     *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
+     *  screenShareEncParam,
+     * );
+     *
+     * @example
+     * // 屏幕分享多路预览：同一路屏幕分享画面同时渲染到多个 HTML 元素上
+     * rtcCloud.startScreenCapture(
+     *  [viewOnCurrentScreen, viewOnExtendedScreen], // HTML Element 数组
      *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
      *  screenShareEncParam,
      * );
      */
-    startScreenCapture(view?: HTMLElement | null, type?: TRTCVideoStreamType, params?: any): void;
+    startScreenCapture(views?: Array<HTMLElement> | HTMLElement | null, type?: TRTCVideoStreamType, params?: TRTCVideoEncParam | undefined | null): void;
     /**
      * 暂停屏幕分享
      */
@@ -2355,7 +2386,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * import TRTCCloud from 'trtc-electron-sdk';
      * const trtcCloud = TRTCCloud.getTRTCShareInstance();
      * trtc.setLocalVideoRenderCallback(TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
-     *   onRenderVideoFrame(userId, streamType, frame) {
+     *   onRenderVideoFrame: function(userId, streamType, frame) {
      *     // 处理本地视频帧的回调
      *   }
      * });
@@ -2380,7 +2411,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * import TRTCCloud from 'trtc-electron-sdk';
      * const trtcCloud = TRTCCloud.getTRTCShareInstance();
      * trtc.setRemoteVideoRenderCallback('remoteUserId', TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
-     *   onRenderVideoFrame(userId, streamType, frame) {
+     *   onRenderVideoFrame: function(userId, streamType, frame) {
      *     // 处理远端视频帧的回调
      *   }
      * });
@@ -2430,6 +2461,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     sendSEIMsg(msg: ArrayBuffer | ArrayBufferView, repeatCount: number): boolean;
     /**
+     * @private
      * 废弃接口： 启动播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 startPlayMusic 接口替代。
@@ -2438,6 +2470,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     playBGM(path: string): void;
     /**
+     * @private
      * 废弃接口： 停止播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopPlayMusic 接口替代。
@@ -2445,6 +2478,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     stopBGM(): void;
     /**
+     * @private
      * 废弃接口： 暂停播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 pausePlayMusic 接口替代。
@@ -2452,6 +2486,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     pauseBGM(): void;
     /**
+     * @private
      * 废弃接口： 继续播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 resumePlayMusic 接口替代。
@@ -2459,6 +2494,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     resumeBGM(): void;
     /**
+     * @private
      * 废弃接口： 获取背景音乐文件总时长，单位毫秒
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 getMusicDurationInMS 接口替代。
@@ -2468,6 +2504,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     getBGMDuration(path: string): number;
     /**
+     * @private
      * 废弃接口： 设置背景音乐播放进度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 seekMusicToPosInTime 接口替代。
@@ -2476,6 +2513,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setBGMPosition(pos: number): void;
     /**
+     * @private
      * 废弃接口： 设置背景音乐的音量大小，播放背景音乐混音时使用，用来控制背景音音量大小
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setAllMusicVolume 接口替代。
@@ -2484,6 +2522,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setBGMVolume(volume: number): void;
     /**
+     * @private
      * 废弃接口： 设置背景音乐本地播放音量的大小
      *
      * 播放背景音乐混音时使用，用来控制背景音乐在本地播放时的音量大小。
@@ -2494,6 +2533,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setBGMPlayoutVolume(volume: number): void;
     /**
+     * @private
      * 废弃接口： 设置背景音乐远端播放音量的大小
      *
      * 播放背景音乐混音时使用，用来控制背景音乐在远端播放时的音量大小。
@@ -2694,6 +2734,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setVoiceChangerType(type: TRTCVoiceChangerType): void;
     /**
+     * @private
      * 废弃接口： 播放音效
      *
      * 每个音效都需要您指定具体的 ID，您可以通过该 ID 对音效的开始、停止、音量等进行设置。
@@ -2706,6 +2747,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     playAudioEffect(effect: TRTCAudioEffectParam): void;
     /**
+     * @private
      * 废弃接口： 设置音效音量
      *
      * 注意：会覆盖通过 setAllAudioEffectsVolume 指定的整体音效音量。
@@ -2717,6 +2759,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setAudioEffectVolume(effectId: number, volume: number): void;
     /**
+     * @private
      * 废弃接口： 停止音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopPlayMusic 接口替代。
@@ -2725,6 +2768,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     stopAudioEffect(effectId: number): void;
     /**
+     * @private
      * 废弃接口： 停止所有音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃
@@ -2732,6 +2776,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     stopAllAudioEffects(): void;
     /**
+     * @private
      * 废弃接口： 设置所有音效的音量
      *
      * 注意：该操作会覆盖通过 setAudioEffectVolume 指定的单独音效音量。
@@ -2742,6 +2787,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setAllAudioEffectsVolume(volume: number): void;
     /**
+     * @private
      * 废弃接口： 暂停音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 pausePlayMusic 接口替代。
@@ -2750,6 +2796,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     pauseAudioEffect(effectId: number): void;
     /**
+     * @private
      * 废弃接口： 恢复音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 resumePlayMusic 接口替代。
@@ -2893,6 +2940,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
     private addRemoteVideoRenderCallback;
     private removeRemoteVideoRenderCallback;
     /**
+     * @private
      * 废弃接口：选择绘制的模式 (webgl/yuvcanvs/)
      *
      * @deprecated 从 10.3.403 版本该接口被废弃。SDK 内部会根据视频流数据，自动选择合适的渲染方式，可能的渲染方式有 WebGL、Canvas 2D、video 标签。调用该接口不再修改视频的渲染方式。
@@ -2954,6 +3002,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     setPluginCallback(pluginCallback: (pluginId: string, errorCode: number, msg: string) => void): void;
     /**
+     * @private
      * 初始化插件管理器
      *
      * @deprecated 请使用 [setPluginParams]{@link TRTCCloud#setPluginParams} 接口<br/>
@@ -2971,6 +3020,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
         bufferType?: TRTCVideoBufferType;
     }): void;
     /**
+     * @private
      * 销毁插件管理
      *
      * @deprecated 请使用 [setPluginParams]{@link TRTCCloud#setPluginParams} 接口
@@ -2978,6 +3028,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     destroyPluginManager(): void;
     /**
+     * @private
      * 获取插件列表
      * @returns TRTCPluginInfo[]|null
      *
@@ -2987,10 +3038,12 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
     getPluginList(): TRTCPluginInfo[] | null;
     private _getKey;
     /**
+     * @private
      * @deprecated
      */
     setEnableRenderFrame(enable: boolean): void;
     /**
+     * @private
      * @deprecated
      */
     log(info: string): void;
@@ -3047,6 +3100,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     private disableLocalRenderFPSOptimization;
     /**
+     * @private
      * @deprecated
      * 创建本地多媒体合图实例
      *
@@ -3060,6 +3114,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
         pixelFormat: TRTCVideoPixelFormat;
     }): TRTCLocalMediaTranscoder | null;
     /**
+     * @private
      * @deprecated
      * 销毁本地多媒体合图实例
      */
@@ -3096,6 +3151,7 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      */
     getMediaMixingManager(): TRTCMediaMixingManager | null;
     /**
+     * @private
      * 获取本地混流服务对象
      *
      * 本地混流服务对象管理底层服务对象的启动、关闭，并可监听服务丢失事件，用来实现服务重启、恢复

package/liteav/trtc.js

@@ -320,6 +320,44 @@ class TRTCCloud extends events_1.EventEmitter {
             this.rtcCloud.setVideoRenderFPS(this.videoRenderFPS);
         }
     }
+    /**
+     * 销毁当前实例，释放资源
+     */
+    destroy() {
+        var _a, _b;
+        if (TRTCCloud.isIPCMode) {
+            TRTCCloud.ipcModeReferenceCount = TRTCCloud.ipcModeReferenceCount - 1;
+            if (TRTCCloud.ipcModeReferenceCount > 0) {
+                return;
+            }
+        }
+        if (this === TRTCCloud.sharedTRTCCloudInstance) {
+            if (TRTCCloud.subInstances) {
+                TRTCCloud.subInstances.forEach(sub => {
+                    this.logger.log('destroy sub cloud');
+                    sub.destroy();
+                });
+                TRTCCloud.subInstances = [];
+            }
+        }
+        else {
+            TRTCCloud.subInstances = TRTCCloud.subInstances.filter((item) => { return item != this; });
+        }
+        VideoRenderFPSMonitor_1.videoRenderFPSMonitor.off('videoRenderFPS', this.onFPSChanged);
+        this.playAudioEffectIdList = [];
+        this.remoteFillModeMap.clear();
+        this.destroyLocalMediaTranscoder();
+        this.rtcCloud.destroy();
+        this.rtcCloud = null;
+        this.deviceManager.destroy();
+        this.audioEffectManager.destroy();
+        this.pluginManager.destroy();
+        (_a = this.mediaMixingService) === null || _a === void 0 ? void 0 : _a.destroy();
+        (_b = this.mediaMixingManager) === null || _b === void 0 ? void 0 : _b.destroy();
+        Object.keys(this.paramsStore).forEach(key => {
+            delete this.paramsStore[key];
+        });
+    }
     /**
      * 创建子实例
      *
@@ -348,6 +386,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return new TRTCCloud(config);
     }
     /**
+     * @private
      * 获取 TRTC 配置对象
      *
      * 可以通过 TRTC 配置对象 {@link TRTCConfig} 打开 debug 模式
@@ -364,6 +403,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return util_1.config;
     }
     /**
+     * @private
      * @deprecated
      */
     setExternalRenderEnabled(enabled) {
@@ -379,49 +419,12 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * @deprecated
      */
     setCaptureLocalVideoEnabled(enabled) {
         this.isCaptureLocalVideoEnabled = enabled;
     }
-    /**
-     * 销毁当前实例，释放资源
-     */
-    destroy() {
-        var _a, _b;
-        if (TRTCCloud.isIPCMode) {
-            TRTCCloud.ipcModeReferenceCount = TRTCCloud.ipcModeReferenceCount - 1;
-            if (TRTCCloud.ipcModeReferenceCount > 0) {
-                return;
-            }
-        }
-        if (this === TRTCCloud.sharedTRTCCloudInstance) {
-            if (TRTCCloud.subInstances) {
-                TRTCCloud.subInstances.forEach(sub => {
-                    this.logger.log('destroy sub cloud');
-                    sub.destroy();
-                });
-                TRTCCloud.subInstances = [];
-            }
-        }
-        else {
-            TRTCCloud.subInstances = TRTCCloud.subInstances.filter((item) => { return item != this; });
-        }
-        VideoRenderFPSMonitor_1.videoRenderFPSMonitor.off('videoRenderFPS', this.onFPSChanged);
-        this.playAudioEffectIdList = [];
-        this.remoteFillModeMap.clear();
-        this.destroyLocalMediaTranscoder();
-        this.rtcCloud.destroy();
-        this.rtcCloud = null;
-        this.deviceManager.destroy();
-        this.audioEffectManager.destroy();
-        this.pluginManager.destroy();
-        (_a = this.mediaMixingService) === null || _a === void 0 ? void 0 : _a.destroy();
-        (_b = this.mediaMixingManager) === null || _b === void 0 ? void 0 : _b.destroy();
-        Object.keys(this.paramsStore).forEach(key => {
-            delete this.paramsStore[key];
-        });
-    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                       设置 TRTCCallback 回调
@@ -2080,6 +2083,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} streamId - 自定义流 ID。
      * @param {TRTCVideoStreamType} type - 仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub。
      * @deprecated
+     * @private
      */
     startPublishing(streamId, type) {
         this.rtcCloud.startPublishing(streamId, type);
@@ -2087,6 +2091,7 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 停止向腾讯云的直播 CDN 推流
      * @deprecated
+     * @private
      */
     stopPublishing() {
         this.rtcCloud.stopPublishing();
@@ -2105,6 +2110,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} param.url   - 指定该路音视频流在第三方直播服务商的推流地址，推流 URL 必须为 RTMP 格式，必须符合您的目标直播服务商的规范要求，否则目标服务商会拒绝来自 TRTC 后台服务的推流请求。
      * @param {String} param.streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
      * @deprecated
+     * @private
      */
     startPublishCDNStream(param) {
         const streamId = param.streamId ? param.streamId.trim() : "";
@@ -2118,6 +2124,7 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 停止向非腾讯云的直播 CDN 推流
      * @deprecated
+     * @private
      */
     stopPublishCDNStream() {
         this.rtcCloud.stopPublishCDNStream();
@@ -2189,6 +2196,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number}  config.mixUsersArray[].soundLevel  - 该路音频参与混音时的音量等级（取值范围：0 - 100）,默认值：100。
      * @param {String}  config.mixUsersArray[].image       - 占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。当指定 inputType 为 TRTCMixInputTypePureAudio 时，image 为占位图，此时需要您指定 userId。当指定 inputType 为 TRTCMixInputTypeWatermark 时，image 为水印图，此时不需要您指定 userId。
      * @deprecated
+     * @private
      */
     setMixTranscodingConfig(config) {
         if (config === null) {
@@ -2475,6 +2483,7 @@ class TRTCCloud extends events_1.EventEmitter {
     }
     /**
      * 修改远端视频渲染的 HTML 元素
+     *
      * 本接口用于切换显示区域的交互场景中，修改远端视频渲染的 HTML 元素。
      *
      * 注意：必须调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 订阅了远端视频流之后，调用此接口才会生效。
@@ -2618,6 +2627,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.setLocalRenderParams(params);
     }
     /**
+     * @private
      * 废弃接口： 设置本地图像的渲染模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -2661,6 +2671,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.setRemoteRenderParams(userId, streamType, params);
     }
     /**
+     * @private
      * 废弃接口： 设置远端图像的渲染模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setRemoteRenderParams 接口替代。
@@ -2681,6 +2692,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * 废弃接口： 设置本地图像的顺时针旋转角度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -2699,6 +2711,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.setLocalRenderParams(params);
     }
     /**
+     * @private
      * 废弃接口： 设置远端图像的顺时针旋转角度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setRemoteRenderParams 接口替代。
@@ -2729,6 +2742,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.setVideoEncoderRotation(rotation);
     }
     /**
+     * @private
      * 废弃接口： 设置本地摄像头预览画面的镜像模式
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setLocalRenderParams 接口替代。
@@ -2811,6 +2825,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.snapshotVideo(userId, type, snapshotSourceTypeStream);
     }
     /**
+     * @private
      * 废弃接口： 设定观看方优先选择的视频质量
      *
      * 低端设备推荐优先选择低清晰度的小画面。
@@ -3137,6 +3152,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.setAudioQuality(quality);
     }
     /**
+     * @private
      * 废弃接口：设置麦克风的音量大小
      *
      * @deprecated 从 TRTCSDK6.9 后该接口已被废弃，请使用 setAudioCaptureVolume 接口替代。
@@ -3426,6 +3442,7 @@ class TRTCCloud extends events_1.EventEmitter {
     //
     /////////////////////////////////////////////////////////////////////////////////
     /**
+     * @private
      * 废弃接口： 开始显示远端用户的辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）
      *
      * - startRemoteView() 用于显示主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）。
@@ -3442,6 +3459,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.startRemoteView(userId, view, trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub);
     }
     /**
+     * @private
      * 废弃接口： 停止显示远端用户的辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）。
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopRemoteView 接口替代。
@@ -3452,6 +3470,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.stopRemoteView(userId, trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub);
     }
     /**
+     * @private
      * 废弃接口： 设置辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的显示模式。
      *
      * - setRemoteViewFillMode() 用于设置远端主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的显示模式。
@@ -3476,6 +3495,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * 废弃接口： 设置辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的顺时针旋转角度
      *
      * - setRemoteViewRotation() 用于设置远端主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的旋转角度。
@@ -3616,7 +3636,10 @@ class TRTCCloud extends events_1.EventEmitter {
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
      * 默认情况下，屏幕分享使用辅路画面，如果使用主路画面，建议您提前停止摄像头采集（stopLocalPreview）避免相互冲突。
      *
-     * @param {HTMLElement} view - 承载预览画面的 DOM
+     * @param {Array<HTMLElement>|HTMLElement|null} views - 承载预览画面的单个 HTML 块节点或者 HTML 块节点数组
+     * - 传入单个 HTML 块节点：在该节点上预览屏幕分享画面。
+     * - 传入 HTML 块节点数组：在多个节点上同时预览同一路屏幕分享画面（多路预览），适用于双屏/多窗口场景。
+     * - 传入 `null`：不预览屏幕分享画面，但不影响屏幕分享的采集与上行；此时若设置了 [setLocalVideoRenderCallback()]{@link TRTCCloud#setLocalVideoRenderCallback} 自定义渲染回调，可通过回调获取屏幕分享的视频帧自行渲染。
      * @param {TRTCVideoStreamType} type 屏幕分享使用的线路，可以设置为主路（TRTCVideoStreamTypeBig）或者辅路（TRTCVideoStreamTypeSub），默认使用辅路。
      * @param {TRTCVideoEncParam} params 屏幕分享的画面编码参数，可以设置为 null，表示让 SDK 选择最佳的编码参数（分辨率、码率等）。即使在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig，依然可以使用此接口更新屏幕分享的编码参数。
      *
@@ -3662,12 +3685,20 @@ class TRTCCloud extends events_1.EventEmitter {
      * );
      *
      * rtcCloud.startScreenCapture(
-     *  view, // HTML Element
+     *  view, // 单个 HTML Element
+     *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
+     *  screenShareEncParam,
+     * );
+     *
+     * @example
+     * // 屏幕分享多路预览：同一路屏幕分享画面同时渲染到多个 HTML 元素上
+     * rtcCloud.startScreenCapture(
+     *  [viewOnCurrentScreen, viewOnExtendedScreen], // HTML Element 数组
      *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
      *  screenShareEncParam,
      * );
      */
-    startScreenCapture(view = null, type = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub, params = null) {
+    startScreenCapture(views = null, type = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub, params = null) {
         if ((type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub && type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig)) {
             type = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub;
         }
@@ -3680,12 +3711,15 @@ class TRTCCloud extends events_1.EventEmitter {
             this.stopScreenCapture();
         }
         this.screenCaptureStreamType = type;
-        if (view !== undefined) {
-            if (view !== null) {
+        if (views !== undefined) {
+            if (views !== null) {
                 const key = this._getKey(LOCAL_USER_VIDEO_ID, type);
-                this._initRenderer(key, [view]);
+                this._initRenderer(key, Array.isArray(views) ? views : [views]);
             }
-            this.localVideoRenderController.startScreenCapture(view);
+            this.localVideoRenderController.startScreenCapture(views);
+        }
+        else {
+            this.logger.error('startScreenCapture parameter views is undefined, it should be Array<HTMLElement>, HTMLElement or null');
         }
         if (params) {
             this.rtcCloud.startScreenCapture(type, params);
@@ -3996,7 +4030,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * import TRTCCloud from 'trtc-electron-sdk';
      * const trtcCloud = TRTCCloud.getTRTCShareInstance();
      * trtc.setLocalVideoRenderCallback(TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
-     *   onRenderVideoFrame(userId, streamType, frame) {
+     *   onRenderVideoFrame: function(userId, streamType, frame) {
      *     // 处理本地视频帧的回调
      *   }
      * });
@@ -4055,7 +4089,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * import TRTCCloud from 'trtc-electron-sdk';
      * const trtcCloud = TRTCCloud.getTRTCShareInstance();
      * trtc.setRemoteVideoRenderCallback('remoteUserId', TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
-     *   onRenderVideoFrame(userId, streamType, frame) {
+     *   onRenderVideoFrame: function(userId, streamType, frame) {
      *     // 处理远端视频帧的回调
      *   }
      * });
@@ -4160,6 +4194,7 @@ class TRTCCloud extends events_1.EventEmitter {
     //
     /////////////////////////////////////////////////////////////////////////////////
     /**
+     * @private
      * 废弃接口： 启动播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 startPlayMusic 接口替代。
@@ -4174,6 +4209,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.startPlayMusic(musicParam);
     }
     /**
+     * @private
      * 废弃接口： 停止播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopPlayMusic 接口替代。
@@ -4183,6 +4219,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.stopPlayMusic(this.bgmId);
     }
     /**
+     * @private
      * 废弃接口： 暂停播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 pausePlayMusic 接口替代。
@@ -4192,6 +4229,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.pausePlayMusic(this.bgmId);
     }
     /**
+     * @private
      * 废弃接口： 继续播放背景音乐
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 resumePlayMusic 接口替代。
@@ -4201,6 +4239,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.resumePlayMusic(this.bgmId);
     }
     /**
+     * @private
      * 废弃接口： 获取背景音乐文件总时长，单位毫秒
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 getMusicDurationInMS 接口替代。
@@ -4212,6 +4251,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return this.getMusicDurationInMS(path);
     }
     /**
+     * @private
      * 废弃接口： 设置背景音乐播放进度
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 seekMusicToPosInTime 接口替代。
@@ -4222,6 +4262,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.seekMusicToPosInTime(this.bgmId, pos);
     }
     /**
+     * @private
      * 废弃接口： 设置背景音乐的音量大小，播放背景音乐混音时使用，用来控制背景音音量大小
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 setAllMusicVolume 接口替代。
@@ -4232,6 +4273,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.setAllMusicVolume(volume);
     }
     /**
+     * @private
      * 废弃接口： 设置背景音乐本地播放音量的大小
      *
      * 播放背景音乐混音时使用，用来控制背景音乐在本地播放时的音量大小。
@@ -4244,6 +4286,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.setMusicPlayoutVolume(this.bgmId, volume);
     }
     /**
+     * @private
      * 废弃接口： 设置背景音乐远端播放音量的大小
      *
      * 播放背景音乐混音时使用，用来控制背景音乐在远端播放时的音量大小。
@@ -4521,6 +4564,7 @@ class TRTCCloud extends events_1.EventEmitter {
     //
     /////////////////////////////////////////////////////////////////////////////////
     /**
+     * @private
      * 废弃接口： 播放音效
      *
      * 每个音效都需要您指定具体的 ID，您可以通过该 ID 对音效的开始、停止、音量等进行设置。
@@ -4543,6 +4587,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * 废弃接口： 设置音效音量
      *
      * 注意：会覆盖通过 setAllAudioEffectsVolume 指定的整体音效音量。
@@ -4557,6 +4602,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.setMusicPlayoutVolume(effectId, volume);
     }
     /**
+     * @private
      * 废弃接口： 停止音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 stopPlayMusic 接口替代。
@@ -4568,6 +4614,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.playAudioEffectIdList = this.playAudioEffectIdList.filter(id => id !== effectId);
     }
     /**
+     * @private
      * 废弃接口： 停止所有音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃
@@ -4580,6 +4627,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.playAudioEffectIdList = [];
     }
     /**
+     * @private
      * 废弃接口： 设置所有音效的音量
      *
      * 注意：该操作会覆盖通过 setAudioEffectVolume 指定的单独音效音量。
@@ -4592,6 +4640,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.setAllMusicVolume(volume);
     }
     /**
+     * @private
      * 废弃接口： 暂停音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 pausePlayMusic 接口替代。
@@ -4602,6 +4651,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.pausePlayMusic(effectId);
     }
     /**
+     * @private
      * 废弃接口： 恢复音效
      *
      * @deprecated 从 TRTCSDK 8.0 后该接口已被废弃，请使用 resumePlayMusic 接口替代。
@@ -4914,6 +4964,7 @@ class TRTCCloud extends events_1.EventEmitter {
     // Render Mode API
     //----------------------------------//
     /**
+     * @private
      * 废弃接口：选择绘制的模式 (webgl/yuvcanvs/)
      *
      * @deprecated 从 10.3.403 版本该接口被废弃。SDK 内部会根据视频流数据，自动选择合适的渲染方式，可能的渲染方式有 WebGL、Canvas 2D、video 标签。调用该接口不再修改视频的渲染方式。
@@ -4987,6 +5038,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.pluginManager.setCallback(pluginCallback);
     }
     /**
+     * @private
      * 初始化插件管理器
      *
      * @deprecated 请使用 [setPluginParams]{@link TRTCCloud#setPluginParams} 接口<br/>
@@ -5008,6 +5060,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * 销毁插件管理
      *
      * @deprecated 请使用 [setPluginParams]{@link TRTCCloud#setPluginParams} 接口
@@ -5021,6 +5074,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
+     * @private
      * 获取插件列表
      * @returns TRTCPluginInfo[]|null
      *
@@ -5037,6 +5091,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return String(uid) + '_' + String(type);
     }
     /**
+     * @private
      * @deprecated
      */
     setEnableRenderFrame(enable) {
@@ -5044,6 +5099,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.enableRenderFrame = enable;
     }
     /**
+     * @private
      * @deprecated
      */
     log(info) {
@@ -5072,7 +5128,7 @@ class TRTCCloud extends events_1.EventEmitter {
             }
             else {
                 if (uid.length == 0) {
-                    if (this.localVideoCallback !== null && this.localVideoCallback.callback !== null && type == trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig) {
+                    if (this.localVideoCallback !== null && this.localVideoCallback.callback !== null) {
                         this._onUserRenderCallback(this.localVideoCallback.callback, this.localVideoCallback.pixelFormat, uid, type, width, height, timestamp, rotation, data);
                     }
                     else {
@@ -5488,6 +5544,7 @@ class TRTCCloud extends events_1.EventEmitter {
     //
     /////////////////////////////////////////////////////////////////////////////////
     /**
+     * @private
      * @deprecated
      * 创建本地多媒体合图实例
      *
@@ -5514,6 +5571,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return this.localMediaTranscoder;
     }
     /**
+     * @private
      * @deprecated
      * 销毁本地多媒体合图实例
      */
@@ -5581,6 +5639,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return this.mediaMixingManager;
     }
     /**
+     * @private
      * 获取本地混流服务对象
      *
      * 本地混流服务对象管理底层服务对象的启动、关闭，并可监听服务丢失事件，用来实现服务重启、恢复

package/liteav/types.d.ts

@@ -1,5 +1,5 @@
 import TRTCMediaMixingManager, { TRTCMediaMixingService } from './extensions/MediaMixingManager';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCAudioFrame, TRTCVideoFillMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoBufferType } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCAudioFrame, TRTCVideoFillMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoBufferType, TRTCVideoEncParam } from './trtc_define';
 import { TRTCVodPlayerEventMap } from './vod_player';
 export interface TRTCVideoRenderCallback {
     onRenderVideoFrame(userId: string, streamType: TRTCVideoStreamType, frame: TRTCVideoFrame): void;
@@ -112,7 +112,7 @@ export interface ITRTCCloud {
     setWaterMark(streamType: TRTCVideoStreamType, srcData: ArrayBuffer | string | null, srcType: TRTCWaterMarkSrcType, nWidth: number, nHeight: number, xOffset: number, yOffset: number, fWidthRatio: number): void;
     getScreenCaptureSources(thumbWidth: number, thumbHeight: number, iconWidth: number, iconHeight: number): Array<TRTCScreenCaptureSourceInfo>;
     selectScreenCaptureTarget(source: TRTCScreenCaptureSourceInfo | number, captureRect: Rect | string, property: TRTCScreenCaptureProperty | string, deprecatedCaptureRect?: Rect, captureMouse?: boolean, highlightWindow?: boolean): void;
-    startScreenCapture(view?: HTMLElement | null, type?: TRTCVideoStreamType, params?: any): void;
+    startScreenCapture(views: Array<HTMLElement> | HTMLElement | null, type: TRTCVideoStreamType, params: TRTCVideoEncParam | undefined | null): void;
     pauseScreenCapture(): void;
     resumeScreenCapture(): void;
     stopScreenCapture(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "13.4.802-beta.2",
+  "version": "13.4.802-beta.4",
   "description": "trtc electron sdk",
   "main": "./liteav/index.js",
   "types": "./liteav/index.d.ts",