trtc-electron-sdk 10.3.8-beta.2 → 10.3.8-beta.21

package/liteav/trtc.js

@@ -19,9 +19,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const events_1 = require("events");
 const Render_1 = __importDefault(require("./Render"));
-const util_1 = require("./Render/util");
 // @ts-ignore
 const yuv_buffer_1 = __importDefault(require("yuv-buffer"));
+const util_1 = require("./Render/util");
 // @ts-ignore
 const YCbCr_1 = __importDefault(require("yuv-canvas/src/YCbCr"));
 const trtc_define_1 = require("./trtc_define");
@@ -33,9 +33,10 @@ __exportStar(require("./trtc_code"), exports);
 const CUSTOM_VIDEO_DATA = 'onVideoData';
 const CAMERA_DEVICE_TEST_VIEW = 'camera_device_test_view';
 const CAMERA_DEVICE_TEST_ID = 'camera_device_test';
-const DEFAULT_VIDEO_WIDTH = 640;
-const DEFAULT_VIDEO_HEIGHT = 360;
+const DEFAULT_VIDEO_WIDTH = 8;
+const DEFAULT_VIDEO_HEIGHT = 8;
 const localVideoBuffer = {
+    id: 0,
     userId: '',
     buffer: null,
     streamType: trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig,
@@ -44,6 +45,7 @@ const localVideoBuffer = {
     pixelFormat: trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420,
 };
 const screenVideoBuffer = {
+    id: 0,
     userId: '',
     buffer: null,
     streamType: trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub,
@@ -52,6 +54,7 @@ const screenVideoBuffer = {
     pixelFormat: trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420,
 };
 const cameraTestVideoBuffer = {
+    id: 0,
     userId: CAMERA_DEVICE_TEST_ID,
     buffer: null,
     streamType: trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig,
@@ -108,6 +111,38 @@ let formatLogParams = function (params) {
     }
     return logParamsStr;
 };
+const getComponentNO = function () {
+    var _a;
+    let componentName = '';
+    // @ts-ignore
+    if (global.__TRTCElectron && global.__TRTCElectron.componentName) {
+        // @ts-ignore
+        componentName = global.__TRTCElectron.componentName;
+    }
+    else {
+        const jsonStr = (_a = global.localStorage) === null || _a === void 0 ? void 0 : _a.getItem('__TRTCElectron');
+        if (jsonStr) {
+            try {
+                const jsonObj = JSON.parse(jsonStr);
+                if (jsonObj.componentName && typeof jsonObj.componentName === 'string') {
+                    componentName = jsonObj.componentName;
+                }
+            }
+            catch (error) {
+                console.warn('trtc: localstorage TRTCElectron parse error.', error);
+            }
+        }
+    }
+    let componentNO = '';
+    switch (componentName) {
+        case 'TUIRoom':
+            componentNO = '5';
+            break;
+        default:
+            break;
+    }
+    return componentNO;
+};
 let trtcCloudInstance = null;
 let oriRtcCloud = null;
 const renderModePixelFormatMap = new Map();
@@ -134,7 +169,8 @@ renderModePixelFormatMap.set(8, trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixe
 class TRTCCloud extends events_1.EventEmitter {
     constructor() {
         super();
-        oriRtcCloud = new trtc.NodeRTCCloud(pkg.version);
+        const componentNO = getComponentNO();
+        oriRtcCloud = new trtc.NodeRTCCloud(pkg.version, componentNO);
         this.rtcCloud = Object.assign({}, oriRtcCloud, {
             onlineLog: undefined
         });
@@ -193,7 +229,17 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
-     * 获取配置对象, 可用来打开 debug 模式
+     * 获取 TRTC 配置对象
+     *
+     * 可以通过 TRTC 配置对象 {@link TRTCConfig} 打开 debug 模式
+     *
+     * @example
+     * // Enable 'debug' mode
+     * const TRTCCloud = require('trtc-electron-sdk');
+     * const rtcCloud = new TRTCCloud();
+     * rtcCloud.getConfigObject().setDebugMode(true);
+     *
+     * @returns {TRTCConfig}
      */
     getConfigObject() {
         return util_1.config;
@@ -377,8 +423,6 @@ class TRTCCloud extends events_1.EventEmitter {
                 case 'onSystemAudioLoopbackError':
                     this.handleOnSystemAudioLoopbackError(int32_1);
                     break;
-                case 'onVideoSizeChange':
-                    this.handleOnVideoSizeChange(string_1, int32_1, int32_2, int32_3);
                 default:
                     break;
             }
@@ -563,11 +607,11 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 3.3 用户是否开启摄像头视频
      *
-     * 当您收到 onUserVideoAvailable(userId, YES) 通知时，代表该路画面已经有可用的视频数据帧到达。
+     * 当您收到 onUserVideoAvailable(userId, 1) 通知时，代表该路画面已经有可用的视频数据帧到达。
      * 之后，您需要调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 接口加载该用户的远程画面。
      * 再之后，您还会收到名为 onFirstVideoFrame(userId) 的首帧画面渲染回调。
      *
-     * 当您收到了 onUserVideoAvailable(userId, NO) 通知时，代表该路远程画面已经被关闭，这可能是
+     * 当您收到了 onUserVideoAvailable(userId, 0) 通知时，代表该路远程画面已经被关闭，这可能是
      * 由于该用户调用了 [muteLocalVideo()]{@link TRTCCloud#muteLocalVideo} 或 [stopLocalPreview()]{@link TRTCCloud#stopLocalPreview} 所致。
      *
      * @event TRTCCallback#onUserVideoAvailable
@@ -581,10 +625,16 @@ class TRTCCloud extends events_1.EventEmitter {
                     return !(userId === item.uid && item.type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub);
                 });
             }
-            const videoBufferInfo = remoteVideoBufferMap.get(userId);
-            if (videoBufferInfo) {
-                this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, 0, 0, videoBufferInfo.pixelFormat);
-                videoBufferInfo.buffer = null;
+            const remoteUserVideoBuffers = remoteVideoBufferMap.get(userId);
+            if (remoteUserVideoBuffers) {
+                if (remoteUserVideoBuffers.big) {
+                    this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.big.buffer, remoteUserVideoBuffers.big.streamType, 0, 0, remoteUserVideoBuffers.big.pixelFormat, remoteUserVideoBuffers.big.id);
+                    remoteUserVideoBuffers.big.buffer = null;
+                }
+                if (remoteUserVideoBuffers.small) {
+                    this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.small.buffer, remoteUserVideoBuffers.small.streamType, 0, 0, remoteUserVideoBuffers.small.pixelFormat, remoteUserVideoBuffers.small.id);
+                    remoteUserVideoBuffers.small.buffer = null;
+                }
                 remoteVideoBufferMap.delete(userId);
             }
         }
@@ -593,7 +643,7 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 3.4 用户是否开启了辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）
      *
-     * 注意：显示辅路画面使用的函数是 [startRemoteSubStreamView()]{@link TRTCCloud#startRemoteSubStreamView} 而非 [startRemoteView()]{@link TRTCCloud#startRemoteView}。
+     * 注意：显示辅路画面使用的函数是[startRemoteView()]{@link TRTCCloud#startRemoteView},  从 8.0 版本开始已不再推荐使用 [startRemoteSubStreamView()]{@link TRTCCloud#startRemoteSubStreamView}。
      *
      * @event TRTCCallback#onUserSubStreamAvailable
      * @param {String}  userId    - 用户标识
@@ -607,8 +657,9 @@ class TRTCCloud extends events_1.EventEmitter {
                 });
             }
             if (screenVideoBuffer.buffer && screenVideoBuffer.userId === userId) {
-                this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat);
+                this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
                 screenVideoBuffer.buffer = null;
+                screenVideoBuffer.id = 0;
                 screenVideoBuffer.userId = '';
             }
         }
@@ -1039,16 +1090,19 @@ class TRTCCloud extends events_1.EventEmitter {
      * @event TRTCCallback#onScreenCaptureStarted
      */
     handleOnScreenCaptureStarted() {
+        console.debug('trtc:onScreenCaptureStarted');
         this.isScreenCapturing = true;
-        // 只有在 Buffer 为 null 时才新建，否则只能在 onVideoSizeChange 事件中重新申请 Buffer
+        // 只有在 Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
         if (!screenVideoBuffer.buffer) {
             screenVideoBuffer.userId = '';
             screenVideoBuffer.streamType = this.screenCaptureStreamType;
             screenVideoBuffer.buffer = (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, screenVideoBuffer.userId, screenVideoBuffer.streamType);
+            screenVideoBuffer.id = (0, util_1.generateUniqueId)();
             screenVideoBuffer.pixelFormat = this.pixelformate;
             screenVideoBuffer.width = DEFAULT_VIDEO_WIDTH;
             screenVideoBuffer.height = DEFAULT_VIDEO_HEIGHT;
-            this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, screenVideoBuffer.width, screenVideoBuffer.height, screenVideoBuffer.pixelFormat);
+            this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, screenVideoBuffer.width, screenVideoBuffer.height, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
+            console.debug('trtc:onScreenCaptureStarted alloc add screenVideoBuffer', screenVideoBuffer);
         }
         this.fire('onScreenCaptureStarted');
     }
@@ -1077,10 +1131,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number} reason - 停止原因，0：表示用户主动停止；1：表示屏幕分享窗口被关闭
      */
     handleOnScreenCaptureStopped(reason) {
+        console.debug('trtc:onScreenCaptureStopped', reason);
         if (this.isScreenCapturing) {
             if (screenVideoBuffer.buffer) {
-                this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat);
+                this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
                 screenVideoBuffer.buffer = null;
+                screenVideoBuffer.id = 0;
+                console.debug('trtc:onScreenCaptureStopped delete screenVideoBuffer', screenVideoBuffer);
             }
             this.isScreenCapturing = false;
         }
@@ -1173,31 +1230,46 @@ class TRTCCloud extends events_1.EventEmitter {
     handleOnSystemAudioLoopbackError(errCode) {
         this.fire('onSystemAudioLoopbackError', errCode);
     }
-    handleOnVideoSizeChange(userId, streamType, width, height) {
+    handleVideoSizeChange(userId, streamType, width, height) {
+        console.debug('trtc:handleVideoSizeChange', userId, streamType, width, height);
         if (userId && userId !== CAMERA_DEVICE_TEST_ID) {
             if (streamType !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub) {
-                const videoBufferInfo = remoteVideoBufferMap.get(userId);
-                if (videoBufferInfo) {
-                    if (videoBufferInfo.width !== width || videoBufferInfo.height !== height) {
-                        videoBufferInfo.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, userId, streamType);
-                        videoBufferInfo.width = width;
-                        videoBufferInfo.height = height;
-                        videoBufferInfo.pixelFormat = this.pixelformate;
-                        this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, streamType, width, height, videoBufferInfo.pixelFormat);
+                const remoteUserVideoBuffers = remoteVideoBufferMap.get(userId);
+                if (remoteUserVideoBuffers) {
+                    if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig && remoteUserVideoBuffers.big) {
+                        if (remoteUserVideoBuffers.big.width !== width || remoteUserVideoBuffers.big.height !== height) {
+                            remoteUserVideoBuffers.big.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, userId, streamType);
+                            remoteUserVideoBuffers.big.id = (0, util_1.generateUniqueId)();
+                            remoteUserVideoBuffers.big.width = width;
+                            remoteUserVideoBuffers.big.height = height;
+                            remoteUserVideoBuffers.big.pixelFormat = this.pixelformate;
+                            this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.big.buffer, streamType, width, height, remoteUserVideoBuffers.big.pixelFormat, remoteUserVideoBuffers.big.id);
+                        }
+                    }
+                    else if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall && remoteUserVideoBuffers.small) {
+                        if (remoteUserVideoBuffers.small.width !== width || remoteUserVideoBuffers.small.height !== height) {
+                            remoteUserVideoBuffers.small.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, userId, streamType);
+                            remoteUserVideoBuffers.small.id = (0, util_1.generateUniqueId)();
+                            remoteUserVideoBuffers.small.width = width;
+                            remoteUserVideoBuffers.small.height = height;
+                            remoteUserVideoBuffers.small.pixelFormat = this.pixelformate;
+                            this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.small.buffer, streamType, width, height, remoteUserVideoBuffers.small.pixelFormat, remoteUserVideoBuffers.small.id);
+                        }
                     }
                 }
                 else {
-                    console.error(`trtc:onVideoSizeChange error: ${userId} ${streamType} buffer not exist`);
+                    console.error(`trtc:handleVideoSizeChange error: ${userId} ${streamType} buffer not exist`);
                 }
             }
             else {
                 // 远端用户屏幕分享
                 if (screenVideoBuffer.width !== width || screenVideoBuffer.height !== height) {
                     screenVideoBuffer.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, userId, streamType);
+                    screenVideoBuffer.id = (0, util_1.generateUniqueId)();
                     screenVideoBuffer.width = width;
                     screenVideoBuffer.height = height;
                     screenVideoBuffer.pixelFormat = this.pixelformate;
-                    this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, streamType, width, height, screenVideoBuffer.pixelFormat);
+                    this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, streamType, width, height, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
                 }
             }
         }
@@ -1207,10 +1279,11 @@ class TRTCCloud extends events_1.EventEmitter {
                 // 本地屏幕分享
                 if (screenVideoBuffer.width !== width || screenVideoBuffer.height !== height) {
                     screenVideoBuffer.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, screenVideoBuffer.userId, streamType);
+                    screenVideoBuffer.id = (0, util_1.generateUniqueId)();
                     screenVideoBuffer.width = width;
                     screenVideoBuffer.height = height;
                     screenVideoBuffer.pixelFormat = this.pixelformate;
-                    this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, width, height, screenVideoBuffer.pixelFormat);
+                    this.rtcCloud.setSubVideoBuffer('', screenVideoBuffer.buffer, screenVideoBuffer.streamType, width, height, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
                 }
             }
             else {
@@ -1218,20 +1291,22 @@ class TRTCCloud extends events_1.EventEmitter {
                     // 摄像头检测
                     if (cameraTestVideoBuffer.width !== width || cameraTestVideoBuffer.height !== height) {
                         cameraTestVideoBuffer.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, cameraTestVideoBuffer.userId, streamType);
+                        cameraTestVideoBuffer.id = (0, util_1.generateUniqueId)();
                         cameraTestVideoBuffer.width = width;
                         cameraTestVideoBuffer.height = height;
                         cameraTestVideoBuffer.pixelFormat = this.pixelformate;
-                        this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, width, height, cameraTestVideoBuffer.pixelFormat);
+                        this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, width, height, cameraTestVideoBuffer.pixelFormat, cameraTestVideoBuffer.id);
                     }
                 }
                 else {
                     // 本地摄像头
                     if (localVideoBuffer.width !== width || localVideoBuffer.height !== height) {
                         localVideoBuffer.buffer = (0, util_1.allocBuffer)(width * height * this.pixelLength, localVideoBuffer.userId, streamType);
+                        localVideoBuffer.id = (0, util_1.generateUniqueId)();
                         localVideoBuffer.width = width;
                         localVideoBuffer.height = height;
                         localVideoBuffer.pixelFormat = this.pixelformate;
-                        this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, width, height, localVideoBuffer.pixelFormat);
+                        this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, width, height, localVideoBuffer.pixelFormat, localVideoBuffer.id);
                     }
                 }
             }
@@ -1306,22 +1381,31 @@ class TRTCCloud extends events_1.EventEmitter {
             this._destroyRender(key, null);
         });
         remoteVideoBufferMap.forEach((value, key) => {
-            this.rtcCloud.setRemoteVideoBuffer(key, value.buffer, value.streamType, 0, 0, value.pixelFormat);
-            value.buffer = null;
+            if (value.big) {
+                this.rtcCloud.setRemoteVideoBuffer(key, value.big.buffer, value.big.streamType, 0, 0, value.big.pixelFormat, value.big.id);
+                value.big.buffer = null;
+            }
+            if (value.small) {
+                this.rtcCloud.setRemoteVideoBuffer(key, value.small.buffer, value.small.streamType, 0, 0, value.small.pixelFormat, value.small.id);
+                value.small.buffer = null;
+            }
         });
         remoteVideoBufferMap.clear();
         if (localVideoBuffer.buffer) {
-            this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, 0, 0, localVideoBuffer.pixelFormat);
+            this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, 0, 0, localVideoBuffer.pixelFormat, localVideoBuffer.id);
             localVideoBuffer.buffer = null;
+            localVideoBuffer.id = 0;
         }
         if (screenVideoBuffer.buffer) {
-            this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat);
+            this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
             screenVideoBuffer.buffer = null;
+            screenVideoBuffer.id = 0;
             screenVideoBuffer.userId = '';
         }
         if (cameraTestVideoBuffer.buffer) {
-            this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, 0, 0, cameraTestVideoBuffer.pixelFormat);
+            this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, 0, 0, cameraTestVideoBuffer.pixelFormat, cameraTestVideoBuffer.id);
             cameraTestVideoBuffer.buffer = null;
+            cameraTestVideoBuffer.id = 0;
         }
         this.rtcCloud.exitRoom();
     }
@@ -1334,7 +1418,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      * @param {TRTCSwitchRoomParam} params 房间切换参数，请参考 {@link TRTCSwitchRoomParam}
      *
-     * 接口调用结果会通过 TRTCCloudListener 中的 onSwitchRoom(errCode, errMsg) 回调通知给您。
+     * 接口调用结果会通过 onSwitchRoom(errCode, errMsg) 事件回调通知给您。
      */
     switchRoom(params) {
         this.rtcCloud.switchRoom(params.roomId, params.strRoomId, params.userSig, params.privateMapKey);
@@ -1367,13 +1451,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * <pre>
      *                 房间 001                     房间 002
      *               -------------               ------------
-     *  跨房连麦前：| 主播 A      |             | 主播 B     |
+     *  跨房连麦前：  | 主播 A      |             | 主播 B     |
      *              | 观众 U V W  |             | 观众 X Y Z |
      *               -------------               ------------
      *
      *                 房间 001                     房间 002
      *               -------------               ------------
-     *  跨房连麦后：| 主播 A B    |             | 主播 B A   |
+     *  跨房连麦后：  | 主播 A B    |             | 主播 B A   |
      *              | 观众 U V W  |             | 观众 X Y Z |
      *               -------------               ------------
      * </pre>
@@ -1510,6 +1594,8 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      * 参考文档：[云端混流转码](https://cloud.tencent.com/document/product/647/16827)。
      *
+     * 注意：混流转码为收费功能，调用接口将产生云端混流转码费用，详见 [云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。
+     *
      * @note 关于云端混流的注意事项：
      *  - 云端转码会引入一定的 CDN 观看延时，大概会增加1 - 2秒。
      *  - 调用该函数的用户，会将连麦中的多路画面混合到自己当前这路画面中。
@@ -1531,7 +1617,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {String} config.streamId          - 输出到 CDN 上的直播流 ID
      * @param {TRTCMixUser[]} config.mixUsersArray - 每一路子画面的位置信息
      * @param {String}  config.mixUsersArray[].userId      - 参与混流的 userId
-     * @param {String}  config.mixUsersArray[].roomId      - 参与混流的 roomId，跨房流传入的实际 roomId，当前房间流传入 roomId = null
+     * @param {String}  config.mixUsersArray[].roomId      - 参与混流的 roomId，跨房流传入的实际 roomId。当前房间流，请传入空字符串（roomId = ''）。
      * @param {Rect}  config.mixUsersArray[].rect        - 图层位置坐标以及大小，左上角为坐标原点(0,0) （绝对像素值）
      * @param {Number}  config.mixUsersArray[].rect.left   - 图层位置的左坐标
      * @param {Number}  config.mixUsersArray[].rect.top    - 图层位置的上坐标
@@ -1600,14 +1686,15 @@ class TRTCCloud extends events_1.EventEmitter {
             }
             // view 为 null 时，可能启动了自定义渲染，所以 Buffer 还是要创建，否则自定义渲染就拿不到数据；
             // view 非 null 时，当然必须创建 Buffer
-            // 只有在 Buffer 为 null 时才新建，否则只能在 onVideoSizeChange 事件中重新申请 Buffer
+            // 只有在 Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
             if (!localVideoBuffer.buffer) {
                 localVideoBuffer.streamType = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig;
                 localVideoBuffer.buffer = (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, localVideoBuffer.userId, localVideoBuffer.streamType);
+                localVideoBuffer.id = (0, util_1.generateUniqueId)();
                 localVideoBuffer.pixelFormat = this.pixelformate;
                 localVideoBuffer.width = DEFAULT_VIDEO_WIDTH;
                 localVideoBuffer.height = DEFAULT_VIDEO_HEIGHT;
-                this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, localVideoBuffer.width, localVideoBuffer.height, localVideoBuffer.pixelFormat);
+                this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, localVideoBuffer.width, localVideoBuffer.height, localVideoBuffer.pixelFormat, localVideoBuffer.id);
             }
             this.rtcCloud.startLocalPreview();
             this.addLocalVideoRenderCallback();
@@ -1627,15 +1714,49 @@ class TRTCCloud extends events_1.EventEmitter {
             return !('' === item.uid && item.type === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
         });
         if (localVideoBuffer.buffer) {
-            this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, 0, 0, localVideoBuffer.pixelFormat);
+            this.rtcCloud.setLocalVideoBuffer(localVideoBuffer.buffer, 0, 0, localVideoBuffer.pixelFormat, localVideoBuffer.id);
             localVideoBuffer.buffer = null;
+            localVideoBuffer.id = 0;
         }
     }
     /**
-     * 3.3 是否屏蔽自己的视频画面
+     * 3.3 修改本地摄像头预览的 HTML 元素
      *
-     * 当屏蔽本地视频后，房间里的其它成员将会收到 onUserVideoAvailable 回调通知
-     * @param {Boolean} mute - true：屏蔽；false：开启，默认值：false
+     * 本接口用于切换显示区域的交互场景中，修改本地摄像头预览的 HTML 元素。
+     *
+     * 注意：必须在调用 [startLocalPreview()]{@link TRTCCloud#startLocalPreview} 接口开启本地摄像头采集后，调用本接口才会生效。
+     * - 如果用户调用 `startLocalPreview(view)` 接口开启了摄像头采集，则通过此接口可以修改摄像头采集视频渲染的 HTML 元素。
+     * - 如果用户调用 `startLocalPreview(null)` 接口开启了摄像头采集，但未开启本地预览，支持调用此接口开启预览。
+     *
+     * @param {HTMLElement|null} view - 接收本地摄像头采集视频渲染的 HTML 元素，传入 `null` 结束本地摄像头采集视频的预览。
+     *  - 传入的 HTML 元素必须是块元素，比如：`div`
+     */
+    updateLocalView(view) {
+        let key = this.getKey('local_video', trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
+        if (view !== null && view instanceof HTMLElement) {
+            this._initRender(key, view);
+        }
+        else if (view === null) {
+            if (this.streams.has(String(key))) {
+                this._destroyRender(key, null);
+            }
+        }
+        else {
+            console.error('trtc:updateLocalView() called with wrong parameter', view);
+        }
+    }
+    /**
+     * 3.3 暂停/恢复发布本地的视频流
+     *
+     * 该接口可以暂停（或恢复）发布本地的视频画面，暂停之后，同一房间中的其他用户将无法继续看到自己画面。
+     * 该接口在指定 TRTCVideoStreamTypeBig 时等效于 start/stopLocalPreview 这两个接口，但具有更好的响应速度。
+     * 因为 start/stopLocalPreview 需要打开和关闭摄像头，而打开和关闭摄像头都是硬件设备相关的操作，非常耗时。
+     * 相比之下，muteLocalVideo 只需要在软件层面对数据流进行暂停或者放行即可，因此效率更高，也更适合需要频繁打开关闭的场景。
+     * 当暂停/恢复发布指定 TRTCVideoStreamTypeBig 后，同一房间中的其他用户将会收到 onUserVideoAvailable 回调通知。
+     * 当暂停/恢复发布指定 TRTCVideoStreamTypeSub 后，同一房间中的其他用户将会收到 onUserSubStreamAvailable 回调通知。
+     *
+     * @param {Boolean}             mute        - true：屏蔽；false：开启，默认值：false
+     * @param {TRTCVideoStreamType} streamType  - 要暂停/恢复的视频流类型, 仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub
      */
     muteLocalVideo(mute, streamType) {
         let newStreamType = streamType;
@@ -1647,7 +1768,7 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 3.4 开始显示远端视频画面
      *
-     * 在收到 SDK 的 onUserVideoAvailable(userId, true) 通知时，可以获知该远程用户开启了视频，
+     * 在收到 SDK 的 onUserVideoAvailable(userId, 1) 通知时，可以获知该远程用户开启了视频，
      * 此后调用 startRemoteView(userId) 接口加载该用户的远程画面时，可以用 loading 动画优化加载过程中的等待体验。
      * 待该用户的首帧画面开始显示时，您会收到 onFirstVideoFrame(userId) 事件回调。
      *
@@ -1675,24 +1796,41 @@ class TRTCCloud extends events_1.EventEmitter {
             const videoBufferInfo = {
                 userId: userId,
                 buffer: (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, userId, streamType),
+                id: (0, util_1.generateUniqueId)(),
                 streamType: streamType,
                 width: DEFAULT_VIDEO_WIDTH,
                 height: DEFAULT_VIDEO_HEIGHT,
                 pixelFormat: this.pixelformate,
             };
             if (streamType !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub) {
-                if (!remoteVideoBufferMap.get(userId)) {
-                    // Buffer 不存在时才新建，否则只能在 onVideoSizeChange 事件中重新申请 Buffer
-                    remoteVideoBufferMap.set(userId, videoBufferInfo);
-                    this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat);
+                const remoteUserVideoBuffers = remoteVideoBufferMap.get(userId);
+                if (!remoteUserVideoBuffers) {
+                    // Buffer 不存在时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
+                    if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig) {
+                        remoteVideoBufferMap.set(userId, { big: videoBufferInfo });
+                    }
+                    else if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall) {
+                        remoteVideoBufferMap.set(userId, { small: videoBufferInfo });
+                    }
+                    this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
+                }
+                else {
+                    if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig && !remoteUserVideoBuffers.big) {
+                        remoteUserVideoBuffers.big = videoBufferInfo;
+                        this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
+                    }
+                    else if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall && !remoteUserVideoBuffers.small) {
+                        remoteUserVideoBuffers.small = videoBufferInfo;
+                        this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
+                    }
                 }
             }
             else {
                 // 远端屏幕分享
-                // Buffer 为 null 时才新建，否则只能在 onVideoSizeChange 事件中重新申请 Buffer
+                // Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
                 if (!screenVideoBuffer.buffer) {
                     Object.assign(screenVideoBuffer, videoBufferInfo);
-                    this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, screenVideoBuffer.width, screenVideoBuffer.height, screenVideoBuffer.pixelFormat);
+                    this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, screenVideoBuffer.width, screenVideoBuffer.height, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
                 }
             }
             this.addRemoteVideoRenderCallback(userId);
@@ -1717,18 +1855,65 @@ class TRTCCloud extends events_1.EventEmitter {
         let key = this.getKey(userId, streamType);
         this._destroyRender(key, null);
         this.rtcCloud.stopRemoteView(userId, streamType);
-        const videoBufferInfo = remoteVideoBufferMap.get(userId);
-        if (videoBufferInfo && videoBufferInfo.streamType === streamType) {
-            this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, 0, 0, videoBufferInfo.pixelFormat);
-            videoBufferInfo.buffer = null;
-            remoteVideoBufferMap.delete(userId);
+        const remoteUserVideoBuffers = remoteVideoBufferMap.get(userId);
+        if (remoteUserVideoBuffers && streamType !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub) {
+            if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig && remoteUserVideoBuffers.big) {
+                this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.big.buffer, remoteUserVideoBuffers.big.streamType, 0, 0, remoteUserVideoBuffers.big.pixelFormat, remoteUserVideoBuffers.big.id);
+                remoteUserVideoBuffers.big.buffer = null;
+                remoteUserVideoBuffers.big = undefined;
+            }
+            else if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall && remoteUserVideoBuffers.small) {
+                this.rtcCloud.setRemoteVideoBuffer(userId, remoteUserVideoBuffers.small.buffer, remoteUserVideoBuffers.small.streamType, 0, 0, remoteUserVideoBuffers.small.pixelFormat, remoteUserVideoBuffers.small.id);
+                remoteUserVideoBuffers.small.buffer = null;
+                remoteUserVideoBuffers.small = undefined;
+            }
+            if (!remoteUserVideoBuffers.big && !remoteUserVideoBuffers.small) {
+                remoteVideoBufferMap.delete(userId);
+            }
         }
         else if (screenVideoBuffer.userId === userId && screenVideoBuffer.streamType === streamType) {
-            this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat);
+            this.rtcCloud.setSubVideoBuffer(userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
             screenVideoBuffer.buffer = null;
+            screenVideoBuffer.id = 0;
             screenVideoBuffer.userId = '';
         }
     }
+    /**
+     * 3.7 修改远端视频渲染的 HTML 元素
+     *
+     * 本接口用于切换显示区域的交互场景中，修改远端视频渲染的 HTML 元素。
+     *
+     * 注意：必须调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 订阅了远端视频流之后，调用此接口才会生效。
+     *
+     * @param {String} userId - 远端视频流的用户 ID
+     * @param {HTMLElement|null} view - 接受远端视频流渲染的 HTML 元素，传入 null 结束远端视频的渲染
+     *  - 传入的 HTML 元素必须时块元素，例如：div
+     * @param {TRTCVideoStreamType} streamType - 视频流类型
+     *
+     */
+    updateRemoteView(userId, view, streamType) {
+        if (streamType === undefined) {
+            streamType = this.priorRemoteVideoStreamType;
+        }
+        let bindStreamType = streamType;
+        if (bindStreamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall) {
+            // 如果拉取小流, 绑定 render 时也采用大流， 防止大小流切换后无法找到对应 render 进行渲染
+            // 这里的逻辑和 _onRenderFrame 里, 获取 render 是不论小流还是大流， 都采用大流取获取 render 有关
+            bindStreamType = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig;
+        }
+        const key = this.getKey(userId, bindStreamType);
+        if (view !== null && view instanceof HTMLElement) {
+            this._initRender(key, view);
+        }
+        else if (view === null) {
+            if (this.streams.has(String(key))) {
+                this._destroyRender(key, null);
+            }
+        }
+        else {
+            console.error('trtc:updateRemoteView() called with wrong view parameter', view);
+        }
+    }
     /**
      * 3.6 停止显示所有远端视频画面，同时不再拉取该远端用户的视频数据流
      *
@@ -1743,13 +1928,20 @@ class TRTCCloud extends events_1.EventEmitter {
         });
         this.rtcCloud.stopAllRemoteView();
         remoteVideoBufferMap.forEach((value, key) => {
-            this.rtcCloud.setRemoteVideoBuffer(key, value.buffer, value.streamType, 0, 0, value.pixelFormat);
-            value.buffer = null;
+            if (value.big) {
+                this.rtcCloud.setRemoteVideoBuffer(key, value.big.buffer, value.big.streamType, 0, 0, value.big.pixelFormat, value.big.id);
+                value.big.buffer = null;
+            }
+            if (value.small) {
+                this.rtcCloud.setRemoteVideoBuffer(key, value.small.buffer, value.small.streamType, 0, 0, value.small.pixelFormat, value.small.id);
+                value.small.buffer = null;
+            }
         });
         remoteVideoBufferMap.clear();
         if (screenVideoBuffer.buffer && !this.isScreenCapturing) {
-            this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat);
+            this.rtcCloud.setSubVideoBuffer(screenVideoBuffer.userId, screenVideoBuffer.buffer, screenVideoBuffer.streamType, 0, 0, screenVideoBuffer.pixelFormat, screenVideoBuffer.id);
             screenVideoBuffer.buffer = null;
+            screenVideoBuffer.id = 0;
             screenVideoBuffer.userId = '';
         }
     }
@@ -1855,7 +2047,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
-     * 3.13 设置远端图像的渲染模式
+     * 3.13 设置远端画面的渲染模式
      *
      * @param {String} userId - 用户 ID
      * @param {TRTCVideoStreamType} streamType - 视频流类型
@@ -2007,12 +2199,36 @@ class TRTCCloud extends events_1.EventEmitter {
      * 如果该 userId 没有开启双路编码模式，则此操作无效。
      *
      * @param {String} userId - 用户 ID
-     * @param {TRTCVideoStreamType} type - 视频流类型，即选择看大画面还是小画面，默认为 TRTCVideoStreamTypeBig
+     * @param {TRTCVideoStreamType} streamType - 视频流类型，即选择看大画面还是小画面，默认为 TRTCVideoStreamTypeBig
      * - TRTCVideoStreamTypeBig  : 大画面视频流
      * - TRTCVideoStreamTypeSmall: 小画面视频流
      */
-    setRemoteVideoStreamType(userId, type) {
-        this.rtcCloud.setRemoteVideoStreamType(userId, type);
+    setRemoteVideoStreamType(userId, streamType) {
+        const remoteUserVideoBuffers = remoteVideoBufferMap.get(userId);
+        if (remoteUserVideoBuffers) {
+            const videoBufferInfo = {
+                userId: userId,
+                buffer: (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, userId, streamType),
+                id: (0, util_1.generateUniqueId)(),
+                streamType: streamType,
+                width: DEFAULT_VIDEO_WIDTH,
+                height: DEFAULT_VIDEO_HEIGHT,
+                pixelFormat: this.pixelformate,
+            };
+            if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig && !remoteUserVideoBuffers.big) {
+                remoteUserVideoBuffers.big = videoBufferInfo;
+                this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
+            }
+            else if (streamType === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall && !remoteUserVideoBuffers.small) {
+                remoteUserVideoBuffers.small = videoBufferInfo;
+                this.rtcCloud.setRemoteVideoBuffer(userId, videoBufferInfo.buffer, videoBufferInfo.streamType, videoBufferInfo.width, videoBufferInfo.height, videoBufferInfo.pixelFormat, videoBufferInfo.id);
+            }
+            else {
+                videoBufferInfo.buffer = null;
+                videoBufferInfo.id = 0;
+            }
+        }
+        this.rtcCloud.setRemoteVideoStreamType(userId, streamType);
     }
     /**
      * 3.22 视频画面截图
@@ -2097,7 +2313,11 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.muteRemoteAudio(userId, mute);
     }
     /**
-     * 4.5 静音掉所有用户的声音，同时不再拉取该远端用户的音频数据流
+     * 4.5  静音/取消静音所有远端用户的音频流
+     *
+     * 当您静音所有用户的远端音频时，SDK 会停止播放所有来自远端的音频流，同时也会停止拉取所有用户的音频数据。
+     *
+     * 注意：该接口支持您在进入房间（enterRoom）前调用，暂停状态会在退出房间（exitRoom）在之后会被重置。
      *
      * @param {Boolean} mute - true：静音；false：非静音
      */
@@ -2157,10 +2377,11 @@ class TRTCCloud extends events_1.EventEmitter {
      * 我们在 Demo 中有一个音量大小的提示条，就是基于这个接口实现的。
      * 如希望打开此功能，请在 startLocalAudio() 之前调用。
      *
-     * @param {Number} interval - 设置 onUserVoiceVolume 回调的触发间隔，单位为ms，最小间隔为100ms，如果小于等于0则会关闭回调，建议设置为300ms
+     * @param {Number} interval   - 设置 onUserVoiceVolume 回调的触发间隔，单位为ms，最小间隔为100ms，如果小于等于0则会关闭回调，建议设置为300ms
+     * @param {Boolean} enableVad - true: 打开人声检测；false: 关闭人声检测。目前仅 windows 支持。
      */
-    enableAudioVolumeEvaluation(interval) {
-        this.rtcCloud.enableAudioVolumeEvaluation(interval);
+    enableAudioVolumeEvaluation(interval, enableVad = false) {
+        this.rtcCloud.enableAudioVolumeEvaluation(interval, enableVad);
     }
     /**
      * 4.12 开始录音
@@ -2215,6 +2436,15 @@ class TRTCCloud extends events_1.EventEmitter {
     setAudioQuality(quality) {
         this.audioQuality = quality;
     }
+    /**
+     * 4.15 废弃接口：设置麦克风的音量大小
+     *
+     * @deprecated 从 TRTCSDK6.9 后该接口已被废弃，请使用 setAudioCaptureVolume 接口替代。
+     * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 200。
+     */
+    setMicVolumeOnMixing(volume) {
+        this.setAudioCaptureVolume(volume);
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （五）摄像头相关接口函数
@@ -2224,7 +2454,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 5.1 获取摄像头设备列表
      *
      * @example
-     * var cameralist = this.rtcCloud.getCameraDevicesList();
+     * var cameralist = rtcCloud.getCameraDevicesList();
      * for (i=0;i<cameralist.length;i++) {
      *    var camera = cameralist[i];
      *    console.info("camera deviceName: " + camera.deviceName + " deviceId:" + camera.deviceId);
@@ -2259,7 +2489,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 6.1 获取麦克风设备列表
      *
      * @example
-     *   var miclist = this.rtcCloud.getMicDevicesList();
+     *   var miclist = rtcCloud.getMicDevicesList();
      *   for (i=0;i<miclist.length;i++) {
      *     var mic = miclist[i];
      *     console.info("mic deviceName: " + mic.deviceName + " deviceId:" + mic.deviceId);
@@ -2325,7 +2555,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 6.8 获取扬声器设备列表
      *
      * @example
-     *   var speakerlist = this.rtcCloud.getSpeakerDevicesList();
+     *   var speakerlist = rtcCloud.getSpeakerDevicesList();
      *   for (i=0;i<speakerlist.length;i++) {
      *     var speaker = speakerlist[i];
      *     console.info("mic deviceName: " + speaker.deviceName + " deviceId:" + speaker.deviceId);
@@ -2354,10 +2584,6 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 6.11 获取系统当前扬声器设备音量
      *
-     * 注意：
-     * - SDK6.7 及以下版本，windows 查询的不是系统扬声器的音量大小，mac 是查询系统扬声器音量大小
-     * - SDK6.8 及以上版本，windows 和 mac 查询的都是系统扬声器的音量大小
-     *
      * @return {Number} 扬声器音量，范围0 - 100
      */
     getCurrentSpeakerVolume() {
@@ -2367,8 +2593,6 @@ class TRTCCloud extends events_1.EventEmitter {
      * 6.12 设置系统当前扬声器设备音量
      *
      * 注意：该接口的功能是调节系统播放音量，如果用户直接调节系统设置的播放音量时，该接口的设置结果会被用户的操作所覆盖。
-     * - SDK6.7 及以下版本，windows 设置的不是系统扬声器的音量大小，mac 是设置系统扬声器音量大小
-     * - SDK6.8 及以上版本，windows 和 mac 设置的都是系统扬声器的音量大小
      *
      * @param {Number} volume - 设置的扬声器音量，范围0 - 100
      */
@@ -2518,7 +2742,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 8.5 枚举可共享的窗口列表
      *
      * 如果您要给您的 App 增加屏幕分享功能，一般需要先显示一个窗口选择界面，这样用户可以选择希望分享的窗口。
-     * 通过如下函数，您可以获得可分享窗口的 ID、类型、窗口名称以及缩略图。
+     * 通过此函数，您可以获得可分享窗口的 ID、类型、窗口名称以及缩略图。
      * 拿到这些信息后，您就可以实现一个窗口选择界面，当然，您也可以使用我们在 Demo 源码中已经实现好的一个界面。
      *
      * 注意：返回的列表中包括屏幕和应用窗口，屏幕会在列表的前面几个元素中。
@@ -2564,6 +2788,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Boolean} highlightWindow - 指定是否高亮正在共享的窗口，以及当捕获图像被遮挡时高亮遮挡窗口提示用户移走遮挡
      */
     selectScreenCaptureTarget(source, captureRect, property, deprecatedCaptureRect, captureMouse, highlightWindow) {
+        console.debug('trtc:selectScreenCaptureTarget:', source, captureRect, property, deprecatedCaptureRect, captureMouse, highlightWindow);
         if (source.sourceId && captureRect instanceof trtc_define_1.Rect && property instanceof trtc_define_1.TRTCScreenCaptureProperty) {
             const realSource = source;
             return this.rtcCloud.selectScreenCaptureTarget(realSource.type, realSource.sourceId, realSource.sourceName, realSource.isMinimizeWindow, captureRect.left, captureRect.top, captureRect.right, captureRect.bottom, property.enableCaptureMouse, property.enableHighLight, property.enableHighPerformance, property.highLightColor, property.highLightWidth, property.enableCaptureChildWindow);
@@ -2583,7 +2808,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
-     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。（暂不支持 mac 平台预览界面）
+     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。
      *
      * 注意:
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
@@ -2601,6 +2826,10 @@ class TRTCCloud extends events_1.EventEmitter {
             console.error('trtc:startScreenCapture, params is not instanceof TRTCVideoEncParam!');
             return;
         }
+        if (this.isScreenCapturing && this.screenCaptureStreamType !== type && screenVideoBuffer.buffer) {
+            // 已经在分享中，切换分享流类型，停止当前正在进行的分享
+            this.stopScreenCapture();
+        }
         this.screenCaptureStreamType = type;
         if (view !== undefined) {
             if (view !== null) {
@@ -2638,12 +2867,14 @@ class TRTCCloud extends events_1.EventEmitter {
         this.screenCaptureStreamType = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub;
     }
     /**
-     * 8.11 设置辅流（屏幕分享）的编码器参数
+     * 8.11 设置屏幕分享（即辅路）的视频编码参数
      *
-     * - setVideoEncoderParam() 用于设置远端主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的编码参数。
-     * - setSubStreamEncoderParam() 用于设置远端辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的编码参数。
+     * 该接口可以设定远端用户所看到的屏幕分享（即辅路）的画面质量，同时也能决定云端录制出的视频文件中屏幕分享的画面质量。 请注意如下两个接口的差异：
+     * - setVideoEncoderParam() 用于设置主路画面（TRTCVideoStreamTypeBig，一般用于摄像头）的视频编码参数。
+     * - setSubStreamEncoderParam() 用于设置辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）的视频编码参数。
      *
-     * 该设置决定了远端用户看到的画面质量，同时也是云端录制出的视频文件的画面质量。
+     * 注意：
+     * 即使您使用主路传输屏幕分享（在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig），依然要使用 setSubStreamEncoderParam 设定屏幕分享的编码参数，而不要使用 setVideoEncoderParam 。
      *
      * @param {TRTCVideoEncParam} params - 辅流（屏幕分享）编码参数
      * @param {TRTCVideoResolution} params.videoResolution - 视频分辨率
@@ -3058,7 +3289,13 @@ class TRTCCloud extends events_1.EventEmitter {
         return this.rtcCloud.seekMusicToPosInTime(id, pts);
     }
     /**
-     * 11.19 设置背景音乐的音量大小，播放背景音乐混音时使用，用来控制背景音音量大小
+     * 11.19 设置所有背景音乐的本地音量和远端音量的大小
+     *
+     * 该接口可以设置所有背景音乐的本地音量和远端音量。
+     *  - 本地音量：即主播本地可以听到的背景音乐的音量大小。
+     *  - 远端音量：即观众端可以听到的背景音乐的音量大小。
+     *
+     * 注意：如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
      *
      * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 200。
      */
@@ -3227,17 +3464,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.stopSpeedTest();
     }
     /**
-     * 13.3 设置 SDK 使用的音频设备根据跟随系统默认设备
-     *
-     * @param {TRTCDeviceType} deviceType - 设备类型
-     * @param {Boolean} enable - 是否跟随系统默认的音频设备。 true：跟随, 当系统默认音频设备发生改变时，SDK 立即切换音频设备; false：不跟随, 只有当 SDK 使用的音频设备被移除后或插入新的音频设备为系统默认设备时，SDK 才切换至系统默认的音频设备。
-     *
-     */
-    enableFollowingDefaultAudioDevice(deviceType, enable) {
-        this.rtcCloud.enableFollowingDefaultAudioDevice(deviceType, enable);
-    }
-    /**
-     * 13.4 开始进行摄像头测试
+     * 13.3 开始进行摄像头测试
      *
      * 会触发 onFirstVideoFrame 回调接口
      *
@@ -3248,24 +3475,35 @@ class TRTCCloud extends events_1.EventEmitter {
     startCameraDeviceTest(view) {
         if (view !== undefined) {
             if (view !== null) {
-                let key = this.getKey(CAMERA_DEVICE_TEST_VIEW, trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
+                const key = this.getKey(CAMERA_DEVICE_TEST_VIEW, trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
                 this._initRender(key, view);
                 const renderer = this.streams.get(key);
                 renderer.setContentMode(trtc_define_1.TRTCVideoFillMode.TRTCVideoFillMode_Fill);
             }
-            // Buffer 为 null 时才新建，否则只能在 onVideoSizeChange 事件中重新申请 Buffer
+            // Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
             if (!cameraTestVideoBuffer.buffer) {
                 const streamType = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig;
                 cameraTestVideoBuffer.streamType = streamType;
                 cameraTestVideoBuffer.pixelFormat = this.pixelformate;
                 cameraTestVideoBuffer.buffer = (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, cameraTestVideoBuffer.userId, streamType);
+                cameraTestVideoBuffer.id = (0, util_1.generateUniqueId)();
                 cameraTestVideoBuffer.width = DEFAULT_VIDEO_WIDTH;
                 cameraTestVideoBuffer.height = DEFAULT_VIDEO_HEIGHT;
-                this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, cameraTestVideoBuffer.width, cameraTestVideoBuffer.height, cameraTestVideoBuffer.pixelFormat);
+                this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, cameraTestVideoBuffer.width, cameraTestVideoBuffer.height, cameraTestVideoBuffer.pixelFormat, cameraTestVideoBuffer.id);
             }
-            this.rtcCloud.startCameraDeviceTest((id, type, width, height, timestamp, rotation) => {
+            this.rtcCloud.startCameraDeviceTest((id, type, width, height, timestamp, rotation, valid, bufferId) => {
                 if (this.enableRenderFrame) {
-                    this._onRenderFrame(id, type, width, height, timestamp, rotation, cameraTestVideoBuffer.buffer);
+                    if (valid === 1) {
+                        if (cameraTestVideoBuffer.id === bufferId) {
+                            this._onRenderFrame(id, type, width, height, timestamp, rotation, cameraTestVideoBuffer.buffer);
+                        }
+                        else {
+                            console.log('trtc:camera video buffer reallocated');
+                        }
+                    }
+                    else {
+                        this.handleVideoSizeChange(id, type, width, height);
+                    }
                 }
             });
         }
@@ -3274,7 +3512,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
-     * 13.5 停止摄像头测试
+     * 13.4 停止摄像头测试
      */
     stopCameraDeviceTest() {
         let key = this.getKey(CAMERA_DEVICE_TEST_VIEW, trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
@@ -3284,30 +3522,32 @@ class TRTCCloud extends events_1.EventEmitter {
             return !('' === item.uid && item.type === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
         });
         if (cameraTestVideoBuffer.buffer) {
-            this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, 0, 0, cameraTestVideoBuffer.pixelFormat);
+            this.rtcCloud.setCameraTestVideoBuffer(cameraTestVideoBuffer.buffer, 0, 0, cameraTestVideoBuffer.pixelFormat, cameraTestVideoBuffer.id);
             cameraTestVideoBuffer.buffer = null;
+            cameraTestVideoBuffer.id = 0;
         }
     }
     /**
-     * 13.6 开始进行麦克风测试
+     * 13.5 开始进行麦克风测试
      *
      * 回调接口 onTestMicVolume 获取测试数据
      *
      * 该方法测试麦克风是否能正常工作，volume 的取值范围为0 - 100。
      *
      * @param {Number} interval - 反馈音量提示的时间间隔（ms），建议设置到大于 200 毫秒
+     * @param {Boolean} playback - 是否开启回播麦克风声音，开启后用户测试麦克风时会听到自己的声音。默认值 true
      */
-    startMicDeviceTest(interval) {
-        this.rtcCloud.startMicDeviceTest(interval);
+    startMicDeviceTest(interval, playback = true) {
+        this.rtcCloud.startMicDeviceTest(interval, playback);
     }
     /**
-     * 13.7 停止麦克风测试
+     * 13.6 停止麦克风测试
      */
     stopMicDeviceTest() {
         this.rtcCloud.stopMicDeviceTest();
     }
     /**
-     * 13.8 开始进行扬声器测试
+     * 13.7 开始进行扬声器测试
      *
      * 回调接口 onTestSpeakerVolume 获取测试数据
      *
@@ -3320,7 +3560,7 @@ class TRTCCloud extends events_1.EventEmitter {
         this.rtcCloud.startSpeakerDeviceTest(testAudioFilePath);
     }
     /**
-     * 13.9 停止扬声器测试
+     * 13.8 停止扬声器测试
      */
     stopSpeakerDeviceTest() {
         this.rtcCloud.stopSpeakerDeviceTest();
@@ -3409,25 +3649,16 @@ class TRTCCloud extends events_1.EventEmitter {
     //                      （十五） 废弃接口函数
     //
     /////////////////////////////////////////////////////////////////////////////////
-    /**
-     * 从 TRTCSDK6.9 后该接口已被废弃
-     *
-     * @deprecated 从 TRTCSDK6.9 后该接口已被废弃，请使用 setAudioCaptureVolume 接口替代。
-     * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 200。
-     */
-    setMicVolumeOnMixing(volume) {
-        this.setAudioCaptureVolume(volume);
-    }
     ///------------------------内部方法-----------------------------
     addLocalVideoRenderCallback() {
-        if ([1, 2, 5].indexOf(this.renderMode) !== -1) {
-            this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
-            this.pixelLength = 1.5;
-        }
-        else if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(this.renderMode) !== -1) {
+        if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(this.renderMode) !== -1) {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_RGBA32;
             this.pixelLength = 4;
         }
+        else if ([1, 2, 5].indexOf(this.renderMode) !== -1) {
+            this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
+            this.pixelLength = 1.5;
+        }
         else if ([7, 8].indexOf(this.renderMode) !== -1) {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32;
             this.pixelLength = 4;
@@ -3436,24 +3667,34 @@ class TRTCCloud extends events_1.EventEmitter {
             console.error('trtc: not supported renderMode:', this.renderMode);
             return;
         }
-        this.rtcCloud.addLocalVideoRenderCallback((id, type, width, height, timestamp, rotation) => {
-            if (this.isScreenCapturing && this.screenCaptureStreamType === type) {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, screenVideoBuffer.buffer);
-            }
-            else {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, localVideoBuffer.buffer);
+        this.rtcCloud.addLocalVideoRenderCallback((id, type, width, height, timestamp, rotation, valid, bufferId) => {
+            if (this.enableRenderFrame) {
+                if (valid === 1) {
+                    if (this.isScreenCapturing && this.screenCaptureStreamType === type && screenVideoBuffer.id === bufferId) {
+                        this._onRenderFrame(id, type, width, height, timestamp, rotation, screenVideoBuffer.buffer);
+                    }
+                    else if (localVideoBuffer.id === bufferId) {
+                        this._onRenderFrame(id, type, width, height, timestamp, rotation, localVideoBuffer.buffer);
+                    }
+                    else {
+                        console.log(`trtc: ${id} ${type} video buffer reallocated`);
+                    }
+                }
+                else {
+                    this.handleVideoSizeChange(id, type, width, height);
+                }
             }
         }, this.pixelformate);
     }
     addRemoteVideoRenderCallback(userId) {
-        if ([1, 2, 5].indexOf(this.renderMode) !== -1) {
-            this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
-            this.pixelLength = 1.5;
-        }
-        else if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(this.renderMode) !== -1) {
+        if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(this.renderMode) !== -1) {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_RGBA32;
             this.pixelLength = 4;
         }
+        else if ([1, 2, 5].indexOf(this.renderMode) !== -1) {
+            this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
+            this.pixelLength = 1.5;
+        }
         else if ([7, 8].indexOf(this.renderMode) !== -1) {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32;
             this.pixelLength = 4;
@@ -3462,13 +3703,30 @@ class TRTCCloud extends events_1.EventEmitter {
             console.error('trtc: not supported renderMode:', this.renderMode);
             return;
         }
-        this.rtcCloud.addRemoteVideoRenderCallback(userId, (id, type, width, height, timestamp, rotation) => {
-            const videoBufferInfo = remoteVideoBufferMap.get(id);
-            if (videoBufferInfo && videoBufferInfo.streamType === type) {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, videoBufferInfo.buffer);
-            }
-            else {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, screenVideoBuffer.buffer);
+        this.rtcCloud.addRemoteVideoRenderCallback(userId, (id, type, width, height, timestamp, rotation, valid, bufferId) => {
+            if (this.enableRenderFrame) {
+                if (valid === 1) {
+                    const remoteUserVideoBuffers = remoteVideoBufferMap.get(id);
+                    if (remoteUserVideoBuffers && type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub) {
+                        // 大流和小流
+                        if (type === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig && remoteUserVideoBuffers.big && remoteUserVideoBuffers.big.id === bufferId) {
+                            this._onRenderFrame(id, type, width, height, timestamp, rotation, remoteUserVideoBuffers.big.buffer);
+                        }
+                        else if (type === trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSmall && remoteUserVideoBuffers.small && remoteUserVideoBuffers.small.id === bufferId) {
+                            this._onRenderFrame(id, type, width, height, timestamp, rotation, remoteUserVideoBuffers.small.buffer);
+                        }
+                    }
+                    else if (screenVideoBuffer.id === bufferId) {
+                        // 辅流
+                        this._onRenderFrame(id, type, width, height, timestamp, rotation, screenVideoBuffer.buffer);
+                    }
+                    else {
+                        console.log(`trtc: ${id} ${type} video buffer reallocated`);
+                    }
+                }
+                else {
+                    this.handleVideoSizeChange(id, type, width, height);
+                }
             }
         }, this.pixelformate);
     }
@@ -3496,14 +3754,14 @@ class TRTCCloud extends events_1.EventEmitter {
             this.streams.forEach((value, key, map) => {
                 oldStreams.set(key, value);
             });
-            if ([1, 2, 5].indexOf(mode) !== -1) {
-                this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
-                this.pixelLength = 1.5;
-            }
-            else if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(mode) !== -1) {
+            if (this.isExternalRenderEnabled || [3, 4, 6].indexOf(mode) !== -1) {
                 this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_RGBA32;
                 this.pixelLength = 4;
             }
+            else if ([1, 2, 5].indexOf(mode) !== -1) {
+                this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
+                this.pixelLength = 1.5;
+            }
             else {
                 // 7,8
                 this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32;
@@ -3867,7 +4125,7 @@ class TRTCCloud extends events_1.EventEmitter {
             }
             else if (format == trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32) {
                 if (this.renderMode !== 3) {
-                    videoframe.data = this._YUV2RGBA(width, height, data);
+                    videoframe.data = this._YUV2RGBA(width, height, data.buffer || data);
                     videoframe.length = width * height * 4;
                     callback(userid, streamType, videoframe);
                 }