trtc-electron-sdk 9.3.301 → 9.4.105-beta.2

package/liteav/Render/SoftwareRenderer/index.js

@@ -74,7 +74,6 @@ class Renderer {
         this.yuv = null;
         this.element = null;
         this.canvas = null;
-        this.view = null;
     }
     refreshCanvas() {
     }
@@ -109,11 +108,49 @@ class Renderer {
             this.canvas.style.transform = 'rotateY(180deg)';
         }
     }
+    _adjustImageData(imageData) {
+        const { width, height, yUint8Array, uUint8Array, vUint8Array } = imageData;
+        const widthBase = 8;
+        const w8Modulo = width % widthBase;
+        if (w8Modulo !== 0) {
+            const newWidth = width - w8Modulo;
+            const newYSize = newWidth * height;
+            const newYArrayBuffer = new ArrayBuffer(newYSize);
+            const newYUint8Array = new Uint8Array(newYArrayBuffer);
+            let oldIndex = -1, newIndex = -1;
+            for (let h = 0; h < height; h += 1) {
+                for (let w = 0; w < newWidth; w += 1) {
+                    oldIndex = width * h + w;
+                    newIndex = newWidth * h + w;
+                    newYUint8Array[newIndex] = yUint8Array[oldIndex];
+                }
+            }
+            const oldChromaWidth = width / 2;
+            const newChromaWidth = newWidth / 2;
+            const chromaHeight = height / 2;
+            const newChromaSize = newChromaWidth * chromaHeight;
+            const newUArrayBuffer = new ArrayBuffer(newChromaSize);
+            const newUInt8Array = new Uint8Array(newUArrayBuffer);
+            const newVArrayBuffer = new ArrayBuffer(newChromaSize);
+            const newVInt8Array = new Uint8Array(newVArrayBuffer);
+            for (let h = 0; h < chromaHeight; h += 1) {
+                for (let w = 0; w < newChromaWidth; w += 1) {
+                    oldIndex = oldChromaWidth * h + w;
+                    newIndex = newChromaWidth * h + w;
+                    newUInt8Array[newIndex] = uUint8Array[oldIndex];
+                    newVInt8Array[newIndex] = vUint8Array[oldIndex];
+                }
+            }
+            return Object.assign(Object.assign({}, imageData), { width: newWidth, height, yUint8Array: newYUint8Array, uUint8Array: newUInt8Array, vUint8Array: newVInt8Array });
+        }
+        return imageData;
+    }
     drawFrame(imageData) {
         if (!this.ready) {
             this.ready = true;
             this.event.emit('ready');
         }
+        imageData = this._adjustImageData(imageData);
         const mirror = 0;
         const contentWidth = imageData.width;
         const contentHeight = imageData.height;

package/liteav/trtc.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo, TRTCCameraCaptureMode } from './trtc_define';
 export * from './trtc_define';
 export * from './trtc_code';
 /**
@@ -39,7 +39,6 @@ declare class TRTCCloud extends EventEmitter {
     private audioQuality;
     private bgmId;
     private playAudioEffectIdList;
-    private enableRenderFrame;
     constructor();
     /**
      * 创建 TRTCCloud 对象单例
@@ -794,6 +793,8 @@ declare class TRTCCloud extends EventEmitter {
      *
      * 参考文档：[云端混流转码](https://cloud.tencent.com/document/product/647/16827)。
      *
+     * 注意：混流转码为收费功能，调用接口将产生云端混流转码费用，详见 [云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。
+     *
      * @note 关于云端混流的注意事项：
      *  - 云端转码会引入一定的 CDN 观看延时，大概会增加1 - 2秒。
      *  - 调用该函数的用户，会将连麦中的多路画面混合到自己当前这路画面中。
@@ -1061,6 +1062,19 @@ declare class TRTCCloud extends EventEmitter {
      * - TRTCVideoStreamTypeSmall: 小画面视频流
      */
     setPriorRemoteVideoStreamType(type: TRTCVideoStreamType): void;
+    /**
+     * 3.24 设置摄像头采集偏好
+     *
+     * @param options {Object} - 参数
+     * @param options.mode {TRTCCameraCaptureMode} - 采集偏好模式
+     * @param options.width {number}- 宽度
+     * @param options.height {number} - 高度
+     */
+    setCameraCapturerParam(options: {
+        mode: TRTCCameraCaptureMode;
+        width: number;
+        height: number;
+    }): void;
     /**
      * 4.1 开启本地音频的采集和上行
      *
@@ -1445,7 +1459,7 @@ declare class TRTCCloud extends EventEmitter {
      */
     selectScreenCaptureTarget(type: number, sourceId: string, sourcename: string, captureRect: Rect, captureMouse: boolean, highlightWindow: boolean): any;
     /**
-     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。（暂不支持 mac 平台预览界面）
+     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。
      *
      * 注意:
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
@@ -1517,6 +1531,28 @@ declare class TRTCCloud extends EventEmitter {
      * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeScreen 时生效，即分享屏幕时生效
      */
     removeAllExcludedShareWindow(): void;
+    /**
+     * 8.16 将指定窗口加入屏幕分享的包含列表中（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Windows 平台下为窗口句柄： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     * - 您在 startScreenCapture 之前和之后调用均可。
+     * - 通过该方法添加到包含列表中的窗口，会在退出房间后被 SDK 自动清除。
+     */
+    addIncludedShareWindow(win: string): void;
+    /**
+     * 8.17 将指定窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Mac 平台: 窗口 ID；Windows 平台： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeIncludedShareWindow(win: string): void;
+    /**
+     * 8.18 将全部窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeAllIncludedShareWindow(): void;
     /**
      * @private
      * 9.5 设置本地视频自定义渲染（Electron 平台下不可用）
@@ -1840,7 +1876,7 @@ declare class TRTCCloud extends EventEmitter {
      * 测速结果将会用于优化 SDK 接下来的服务器选择策略，因此推荐您在用户首次通话前先进行一次测速，这将有助于我们选择最佳的服务器。
      * 同时，如果测试结果非常不理想，您可以通过醒目的 UI 提示用户选择更好的网络。
      *
-     * 注意：测速本身会消耗一定的流量，所以也会产生少量额外的流量费用。
+     * 注意：测速过程将产生少量的基础服务费用，详见 [计费概述 > 基础服务](https://cloud.tencent.com/document/product/647/17157#.E5.9F.BA.E7.A1.80.E6.9C.8D.E5.8A.A1) 文档说明。
      *
      * @param {Number} sdkAppId - 应用标识
      * @param {String} userId   - 用户标识
@@ -1976,9 +2012,7 @@ declare class TRTCCloud extends EventEmitter {
     removePlugin(id: string): void;
     getPluginList(): PluginInfo[];
     createPlugin(pluginId: string): PluginInfo;
-    setPluginCallback(pluginCb: (pluginId: string, errorCode: number, msg: string) => void): void;
     getKey(uid: string, type: TRTCVideoStreamType): string;
-    setEnableRenderFrame(enable: boolean): void;
     /**
      * 判断是否支持webGL
      * @returns {boolean}

package/liteav/trtc.js

@@ -120,7 +120,6 @@ class TRTCCloud extends events_1.EventEmitter {
         // 生成一个足够大, 不会与用户输入重复的 id
         this.bgmId = 1 << 29;
         this.playAudioEffectIdList = [];
-        this.enableRenderFrame = true;
         this.initEventHandler();
         console.log('constructor render:' + this.renderMode + '|sdk version:' + pkg.version +
             '|native sdk version:' + this.rtcCloud.getSDKVersion());
@@ -1340,6 +1339,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秒。
      *  - 调用该函数的用户，会将连麦中的多路画面混合到自己当前这路画面中。
@@ -1802,6 +1803,22 @@ class TRTCCloud extends events_1.EventEmitter {
     setPriorRemoteVideoStreamType(type) {
         this.priorRemoteVideoStreamType = type;
     }
+    /**
+     * 3.24 设置摄像头采集偏好
+     *
+     * @param options {Object} - 参数
+     * @param options.mode {TRTCCameraCaptureMode} - 采集偏好模式
+     * @param options.width {number}- 宽度
+     * @param options.height {number} - 高度
+     */
+    setCameraCapturerParam(options) {
+        if (options.mode !== undefined && options.width !== undefined && options.height !== undefined) {
+            this.rtcCloud.setCameraCapturerParam(options);
+        }
+        else {
+            console.error('call setCameraCapturerParam() with wrong parameter.');
+        }
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （四）音频相关接口函数
@@ -2313,7 +2330,7 @@ class TRTCCloud extends events_1.EventEmitter {
         }
     }
     /**
-     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。（暂不支持 mac 平台预览界面）
+     * 8.7 启动屏幕分享，支持选择使用主路或辅路进行屏幕分享。
      *
      * 注意:
      * 一个用户同时最多只能上传一条主路（TRTCVideoStreamTypeBig）画面和一条辅路（TRTCVideoStreamTypeSub）画面，
@@ -2429,6 +2446,34 @@ class TRTCCloud extends events_1.EventEmitter {
     removeAllExcludedShareWindow() {
         this.rtcCloud.removeAllExcludedShareWindow();
     }
+    /**
+     * 8.16 将指定窗口加入屏幕分享的包含列表中（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Windows 平台下为窗口句柄： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     * - 您在 startScreenCapture 之前和之后调用均可。
+     * - 通过该方法添加到包含列表中的窗口，会在退出房间后被 SDK 自动清除。
+     */
+    addIncludedShareWindow(win) {
+        this.rtcCloud.addIncludedShareWindow(win);
+    }
+    /**
+     * 8.17 将指定窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Mac 平台: 窗口 ID；Windows 平台： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeIncludedShareWindow(win) {
+        this.rtcCloud.removeIncludedShareWindow(win);
+    }
+    /**
+     * 8.18 将全部窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeAllIncludedShareWindow() {
+        this.rtcCloud.removeAllIncludedShareWindow();
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （九）自定义采集和渲染
@@ -2914,7 +2959,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 测速结果将会用于优化 SDK 接下来的服务器选择策略，因此推荐您在用户首次通话前先进行一次测速，这将有助于我们选择最佳的服务器。
      * 同时，如果测试结果非常不理想，您可以通过醒目的 UI 提示用户选择更好的网络。
      *
-     * 注意：测速本身会消耗一定的流量，所以也会产生少量额外的流量费用。
+     * 注意：测速过程将产生少量的基础服务费用，详见 [计费概述 > 基础服务](https://cloud.tencent.com/document/product/647/17157#.E5.9F.BA.E7.A1.80.E6.9C.8D.E5.8A.A1) 文档说明。
      *
      * @param {Number} sdkAppId - 应用标识
      * @param {String} userId   - 用户标识
@@ -3103,9 +3148,7 @@ class TRTCCloud extends events_1.EventEmitter {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
         }
         this.rtcCloud.addLocalVideoRenderCallback((id, type, width, height, timestamp, rotation, data) => {
-            if (this.enableRenderFrame) {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, data);
-            }
+            this._onRenderFrame(id, type, width, height, timestamp, rotation, data);
         }, this.pixelformate);
     }
     addRemoteVideoRenderCallback(userid) {
@@ -3116,9 +3159,7 @@ class TRTCCloud extends events_1.EventEmitter {
             this.pixelformate = trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420;
         }
         this.rtcCloud.addRemoteVideoRenderCallback(userid, (id, type, width, height, timestamp, rotation, data) => {
-            if (this.enableRenderFrame) {
-                this._onRenderFrame(id, type, width, height, timestamp, rotation, data);
-            }
+            this._onRenderFrame(id, type, width, height, timestamp, rotation, data);
         }, this.pixelformate);
     }
     //----------------------------------//
@@ -3177,22 +3218,12 @@ class TRTCCloud extends events_1.EventEmitter {
             },
             setParameter: (param) => {
                 return this.rtcCloud.setPluginParameter(pluginId, param);
-            },
-            getParameter: () => {
-                return this.rtcCloud.getPluginParameter(pluginId);
             }
         };
     }
-    setPluginCallback(pluginCb) {
-        this.rtcCloud.setPluginCallback(pluginCb);
-    }
     getKey(uid, type) {
         return String(uid) + '_' + String(type);
     }
-    setEnableRenderFrame(enable) {
-        console.log('setEnableRenderFrame:' + enable);
-        this.enableRenderFrame = enable;
-    }
     /**
      * 判断是否支持webGL
      * @returns {boolean}
@@ -3322,7 +3353,7 @@ class TRTCCloud extends events_1.EventEmitter {
             let ulen = width * height / 4;
             let ydata = new Uint8Array(data, 0, ylen);
             let udata = new Uint8Array(data, ylen, ulen);
-            let vdata = new Uint8Array(data, ylen + ulen, data.le);
+            let vdata = new Uint8Array(data, ylen + ulen, ulen);
             renderer.drawFrame({
                 width: width,
                 height: height,

package/liteav/trtc_define.d.ts

@@ -616,6 +616,9 @@ export declare class TRTCRemoteStatistics {
  * @param {Number} rtt       - 延迟（毫秒），代表 SDK 跟服务器一来一回之间所消耗的时间，这个值越小越好。
  *                             一般低于50ms的 rtt 是比较理想的情况，而高于100ms的 rtt 会引入较大的通话延时。
  *                             由于数据上下行共享一条网络连接，所以 local 和 remote 的 rtt 相同。
+ * @param {Number} gatewayRtt  - 延迟（毫秒），指 SDK 到本地路由器网关一次网络往返时间，该值越小越好。
+ *                               一般低于 50ms 的 gatewayRtt 相对理想，而高于 200ms 的 gatewayRtt 会引入较大的通话延时。
+ *                               当网络为蜂窝网非 WiFi 类型时，该值无效。
  * @param {Number} receivedBytes - 总接收字节数（包含信令和音视频）
  * @param {Number} sentBytes     - 总发送字节总数（包含信令和音视频）
  * @param {TRTCLocalStatistics[]} localStatisticsArray - 自己本地的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
@@ -630,13 +633,14 @@ export declare class TRTCStatistics {
     appCpu: number;
     systemCpu: number;
     rtt: number;
+    gatewayRtt: number;
     receivedBytes: number;
     sentBytes: number;
     localStatisticsArray: TRTCLocalStatistics[];
     localStatisticsArraySize: number;
     remoteStatisticsArray: TRTCRemoteStatistics[];
     remoteStatisticsArraySize: number;
-    constructor(upLoss?: number, downLoss?: number, appCpu?: number, systemCpu?: number, rtt?: number, receivedBytes?: number, sentBytes?: number, localStatisticsArray?: TRTCLocalStatistics[], localStatisticsArraySize?: number, remoteStatisticsArray?: TRTCRemoteStatistics[], remoteStatisticsArraySize?: number);
+    constructor(upLoss?: number, downLoss?: number, appCpu?: number, systemCpu?: number, rtt?: number, gatewayRtt?: number, receivedBytes?: number, sentBytes?: number, localStatisticsArray?: TRTCLocalStatistics[], localStatisticsArraySize?: number, remoteStatisticsArray?: TRTCRemoteStatistics[], remoteStatisticsArraySize?: number);
 }
 /**
  * 音乐参数
@@ -693,5 +697,10 @@ export interface PluginInfo {
     enable: () => number;
     disable: () => number;
     setParameter: (param: string) => number;
-    getParameter: (paramKey: string) => string;
+}
+export declare enum TRTCCameraCaptureMode {
+    TRTCCameraResolutionStrategyAuto = 0,
+    TRTCCameraResolutionStrategyPerformance = 1,
+    TRTCCameraResolutionStrategyHighQuality = 2,
+    TRTCCameraCaptureManual = 3
 }

package/liteav/trtc_define.js

@@ -6,7 +6,7 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
+exports.TRTCCameraCaptureMode = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
 /////////////////////////////////////////////////////////////////////////////////
 //
 //                    【（一）视频相关枚举值定义】
@@ -1194,6 +1194,9 @@ exports.TRTCRemoteStatistics = TRTCRemoteStatistics;
  * @param {Number} rtt       - 延迟（毫秒），代表 SDK 跟服务器一来一回之间所消耗的时间，这个值越小越好。
  *                             一般低于50ms的 rtt 是比较理想的情况，而高于100ms的 rtt 会引入较大的通话延时。
  *                             由于数据上下行共享一条网络连接，所以 local 和 remote 的 rtt 相同。
+ * @param {Number} gatewayRtt  - 延迟（毫秒），指 SDK 到本地路由器网关一次网络往返时间，该值越小越好。
+ *                               一般低于 50ms 的 gatewayRtt 相对理想，而高于 200ms 的 gatewayRtt 会引入较大的通话延时。
+ *                               当网络为蜂窝网非 WiFi 类型时，该值无效。
  * @param {Number} receivedBytes - 总接收字节数（包含信令和音视频）
  * @param {Number} sentBytes     - 总发送字节总数（包含信令和音视频）
  * @param {TRTCLocalStatistics[]} localStatisticsArray - 自己本地的音视频统计信息，由于可能有大画面、小画面以及辅路画面等多路的情况，所以是一个数组
@@ -1203,12 +1206,13 @@ exports.TRTCRemoteStatistics = TRTCRemoteStatistics;
  *
  */
 class TRTCStatistics {
-    constructor(upLoss = 0, downLoss = 0, appCpu = 0, systemCpu = 0, rtt = 0, receivedBytes = 0, sentBytes = 0, localStatisticsArray = [], localStatisticsArraySize = 0, remoteStatisticsArray = [], remoteStatisticsArraySize = 0) {
+    constructor(upLoss = 0, downLoss = 0, appCpu = 0, systemCpu = 0, rtt = 0, gatewayRtt = 0, receivedBytes = 0, sentBytes = 0, localStatisticsArray = [], localStatisticsArraySize = 0, remoteStatisticsArray = [], remoteStatisticsArraySize = 0) {
         this.upLoss = upLoss;
         this.downLoss = downLoss;
         this.appCpu = appCpu;
         this.systemCpu = systemCpu;
         this.rtt = rtt;
+        this.gatewayRtt = gatewayRtt;
         this.receivedBytes = receivedBytes;
         this.sentBytes = sentBytes;
         this.localStatisticsArray = localStatisticsArray;
@@ -1262,3 +1266,26 @@ class TRTCSwitchRoomParam {
     }
 }
 exports.TRTCSwitchRoomParam = TRTCSwitchRoomParam;
+/**
+ * 摄像头采集偏好
+ *
+ * @enum {Number}
+ */
+const TRTCCameraCaptureMode_HACK_JSDOC = {
+    /** 自动调整采集参数。SDK 根据实际的采集设备性能及网络情况，选择合适的摄像头输出参数，在设备性能及视频预览质量之间，维持平衡。 **/
+    TRTCCameraResolutionStrategyAuto: 0,
+    /** 优先保证设备性能。SDK 根据用户设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。 **/
+    TRTCCameraResolutionStrategyPerformance: 1,
+    /** 优先保证视频预览质量。SDK选择较高的摄像头输出参数，从而提高预览视频的质量。在这种情况下，会消耗更多的 CPU 及内存做视频前处理。 **/
+    TRTCCameraResolutionStrategyHighQuality: 2,
+    /** 允许用户设置本地摄像头采集的视频宽高。 **/
+    TRTCCameraCaptureManual: 3,
+};
+var TRTCCameraCaptureMode;
+(function (TRTCCameraCaptureMode) {
+    TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraResolutionStrategyAuto"] = 0] = "TRTCCameraResolutionStrategyAuto";
+    TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraResolutionStrategyPerformance"] = 1] = "TRTCCameraResolutionStrategyPerformance";
+    TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraResolutionStrategyHighQuality"] = 2] = "TRTCCameraResolutionStrategyHighQuality";
+    TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraCaptureManual"] = 3] = "TRTCCameraCaptureManual";
+})(TRTCCameraCaptureMode = exports.TRTCCameraCaptureMode || (exports.TRTCCameraCaptureMode = {}));
+;

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "9.3.301",
+  "version": "9.4.105-beta.2",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",
   "dependencies": {
     "cos-nodejs-sdk-v5": "^2.8.2",
-    "events": "^3.2.0",
-    "lodash.isequal": "^4.5.0",
-    "yuv-buffer": "^1.0.0",
-    "yuv-canvas": "^1.2.6",
     "download": "^8.0.0",
-    "fs-sync": "^1.0.6",
+    "events": "^3.2.0",
     "fs-extra": "^9.0.1",
-    "signale": "^1.4.0",
+    "fs-sync": "^1.0.6",
+    "lodash.isequal": "^4.5.0",
     "rimraf": "^3.0.2",
-    "semver": "^6.0.0"
+    "semver": "^6.0.0",
+    "signale": "^1.4.0",
+    "yuv-buffer": "^1.0.0",
+    "yuv-canvas": "^1.2.9"
   },
   "devDependencies": {
     "@babel/cli": "^7.11.6",