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

package/liteav/trtc_define.js

@@ -6,8 +6,8 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCPluginType = exports.TRTCVoiceChangerType = exports.TRTCVoiceReverbType = exports.TRTCPublishMode = exports.TRTCAudioRecordingContent = exports.TRTCMixInputType = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCSpeedTestParams = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCCameraCaptureMode = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCAudioFrame = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureProperty = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCRecordType = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
-exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = void 0;
+exports.TRTCTranscodingConfig = exports.TRTCPluginType = exports.TRTCVoiceChangerType = exports.TRTCVoiceReverbType = exports.TRTCPublishMode = exports.TRTCAudioRecordingContent = exports.TRTCMixInputType = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCSpeedTestParams = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCVideoEncodeComplexity = exports.TRTCVideoColorSpace = exports.TRTCVideoColorRange = exports.TRTCCameraCaptureMode = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCAudioFrame = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureProperty = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCRecordType = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
+exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = void 0;
 const util_1 = require("./Renderer/util");
 /////////////////////////////////////////////////////////////////////////////////
 //
@@ -22,52 +22,48 @@ const util_1 = require("./Renderer/util");
  * @enum {Number}
  */
 const TRTCVideoResolution_HACK_JSDOC = {
-    /// 宽高比1:1
-    /** [C] 建议码率80kbps */
+    /** 宽高比 1:1；分辨率 120x120；建议码率（VideoCall）80kbps; 建议码率（LIVE）120kbps。 */
     TRTCVideoResolution_120_120: 1,
-    /** [C] 建议码率100kbps */
+    /** 宽高比 1:1 分辨率 160x160；建议码率（VideoCall）100kbps; 建议码率（LIVE）150kbps。 */
     TRTCVideoResolution_160_160: 3,
-    /** [C] 建议码率200kbps */
+    /** 宽高比 1:1；分辨率 270x270；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps。 */
     TRTCVideoResolution_270_270: 5,
-    /** [C] 建议码率350kbps */
+    /** 宽高比 1:1；分辨率 480x480；建议码率（VideoCall）350kbps; 建议码率（LIVE）500kbps。 */
     TRTCVideoResolution_480_480: 7,
-    /// 宽高比4:3
-    /** [C] 建议码率100kbps */
+    /** 宽高比4:3；分辨率 160x120；建议码率（VideoCall）100kbps; 建议码率（LIVE）150kbps。 */
     TRTCVideoResolution_160_120: 50,
-    /** [C] 建议码率150kbps */
+    /** 宽高比 4:3；分辨率 240x180；建议码率（VideoCall）150kbps; 建议码率（LIVE）250kbps。 */
     TRTCVideoResolution_240_180: 52,
-    /** [C] 建议码率200kbps */
+    /** 宽高比 4:3；分辨率 280x210；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps。 */
     TRTCVideoResolution_280_210: 54,
-    /** [C] 建议码率250kbps */
+    /** 宽高比 4:3；分辨率 320x240；建议码率（VideoCall）250kbps; 建议码率（LIVE）375kbps。 */
     TRTCVideoResolution_320_240: 56,
-    /** [C] 建议码率300kbps */
+    /** 宽高比 4:3；分辨率 400x300；建议码率（VideoCall）300kbps; 建议码率（LIVE）450kbps。 */
     TRTCVideoResolution_400_300: 58,
-    /** [C] 建议码率400kbps */
+    /** 宽高比 4:3；分辨率 480x360；建议码率（VideoCall）400kbps; 建议码率（LIVE）600kbps。 */
     TRTCVideoResolution_480_360: 60,
-    /** [C] 建议码率600kbps */
+    /** 宽高比 4:3；分辨率 640x480；建议码率（VideoCall）600kbps; 建议码率（LIVE）900kbps。 */
     TRTCVideoResolution_640_480: 62,
-    /** [C] 建议码率1000kbps */
+    /** 宽高比 4:3；分辨率 960x720；建议码率（VideoCall）1000kbps; 建议码率（LIVE）1500kbps。 */
     TRTCVideoResolution_960_720: 64,
-    /// 宽高比16:9
-    /** [C] 建议码率150kbps */
+    /** 宽高比 16:9；分辨率 160x90；建议码率（VideoCall）150kbps; 建议码率（LIVE）250kbps。*/
     TRTCVideoResolution_160_90: 100,
-    /** [C] 建议码率200kbps */
+    /** 宽高比 16:9；分辨率 256x144；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps。 */
     TRTCVideoResolution_256_144: 102,
-    /** [C] 建议码率250kbps */
+    /** 宽高比 16:9；分辨率 320x180；建议码率（VideoCall）250kbps; 建议码率（LIVE）400kbps。 */
     TRTCVideoResolution_320_180: 104,
-    /** [C] 建议码率350kbps */
+    /**宽高比 16:9；分辨率 480x270；建议码率（VideoCall）350kbps; 建议码率（LIVE）550kbps。 */
     TRTCVideoResolution_480_270: 106,
-    /** [C] 建议码率550kbps */
+    /** 宽高比 16:9；分辨率 640x360；建议码率（VideoCall）500kbps; 建议码率（LIVE）900kbps。 */
     TRTCVideoResolution_640_360: 108,
-    /** [C] 建议码率850kbps */
+    /** 宽高比 16:9；分辨率 960x540；建议码率（VideoCall）850kbps; 建议码率（LIVE）1300kbps。 */
     TRTCVideoResolution_960_540: 110,
-    /**
-     * [C] 摄像头采集 - 建议码率1200kbps<br>
-     * [S] 屏幕分享   - 建议码率 低清：1000kbps 高清：1600kbps
-     */
+    /** 宽高比 16:9；分辨率 1280x720；建议码率（VideoCall）1200kbps; 建议码率（LIVE）1800kbps。 */
     TRTCVideoResolution_1280_720: 112,
-    /** [S] 屏幕分享   - 建议码率2000kbps */
+    /** 宽高比 16:9；分辨率 1920x1080；建议码率（VideoCall）2000kbps; 建议码率（LIVE）3000kbps。 */
     TRTCVideoResolution_1920_1080: 114,
+    /** 宽高比 16:9；分辨率 2560x1440；建议码率（VideoCall）4000kbps; 建议码率（LIVE）6000kbps。 */
+    TRTCVideoResolution_2560_1440: 116,
 };
 var TRTCVideoResolution;
 (function (TRTCVideoResolution) {
@@ -91,6 +87,7 @@ var TRTCVideoResolution;
     TRTCVideoResolution[TRTCVideoResolution["TRTCVideoResolution_960_540"] = 110] = "TRTCVideoResolution_960_540";
     TRTCVideoResolution[TRTCVideoResolution["TRTCVideoResolution_1280_720"] = 112] = "TRTCVideoResolution_1280_720";
     TRTCVideoResolution[TRTCVideoResolution["TRTCVideoResolution_1920_1080"] = 114] = "TRTCVideoResolution_1920_1080";
+    TRTCVideoResolution[TRTCVideoResolution["TRTCVideoResolution_2560_1440"] = 116] = "TRTCVideoResolution_2560_1440";
 })(TRTCVideoResolution = exports.TRTCVideoResolution || (exports.TRTCVideoResolution = {}));
 /**
  * 视频分辨率模式
@@ -651,7 +648,7 @@ exports.TRTCVideoFrame = TRTCVideoFrame;
  * 音频帧数据
  *
  * @param {TRTCAudioFrameFormat} audioFormat - 音频帧的格式
- * @param {ArrayBuffer} data - 音频数据
+ * @param {Buffer|ArrayBuffer} data - 音频数据
  * @param {Number} length - 音频数据的长度
  * @param {Number} sampleRate - 采样率
  * @param {Number} channel - 声道数
@@ -779,6 +776,69 @@ var TRTCCameraCaptureMode;
     TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraResolutionStrategyHighQuality"] = 2] = "TRTCCameraResolutionStrategyHighQuality";
     TRTCCameraCaptureMode[TRTCCameraCaptureMode["TRTCCameraCaptureManual"] = 3] = "TRTCCameraCaptureManual";
 })(TRTCCameraCaptureMode = exports.TRTCCameraCaptureMode || (exports.TRTCCameraCaptureMode = {}));
+/**
+ * 视频颜色范围
+ *
+ * @enum {Number}
+ */
+const TRTCVideoColorRange_HACK_JSDOC = {
+    /** SDK 内部自动渲染合适范围 */
+    TRTCVideoColorRange_Auto: 0,
+    /** 限制范围 16-235 */
+    TRTCVideoColorRange_Limited: 1,
+    /** 完整范围 0-255 */
+    TRTCVideoColorRange_Full: 2
+};
+var TRTCVideoColorRange;
+(function (TRTCVideoColorRange) {
+    TRTCVideoColorRange[TRTCVideoColorRange["TRTCVideoColorRange_Auto"] = 0] = "TRTCVideoColorRange_Auto";
+    TRTCVideoColorRange[TRTCVideoColorRange["TRTCVideoColorRange_Limited"] = 1] = "TRTCVideoColorRange_Limited";
+    TRTCVideoColorRange[TRTCVideoColorRange["TRTCVideoColorRange_Full"] = 2] = "TRTCVideoColorRange_Full";
+})(TRTCVideoColorRange = exports.TRTCVideoColorRange || (exports.TRTCVideoColorRange = {}));
+/**
+ * 视频颜色空间
+ *
+ * @enum {Number}
+ */
+const TRTCVideoColorSpace_HACK_JSDOC = {
+    /** SDK 内部自动渲染合适颜色空间 */
+    TRTCVideoColorSpace_Auto: 0,
+    /** BT.601 */
+    TRTCVideoColorSpace_BT601: 1,
+    /** BT.709 */
+    TRTCVideoColorSpace_BT709: 2,
+};
+var TRTCVideoColorSpace;
+(function (TRTCVideoColorSpace) {
+    TRTCVideoColorSpace[TRTCVideoColorSpace["TRTCVideoColorSpace_Auto"] = 0] = "TRTCVideoColorSpace_Auto";
+    TRTCVideoColorSpace[TRTCVideoColorSpace["TRTCVideoColorSpace_BT601"] = 1] = "TRTCVideoColorSpace_BT601";
+    TRTCVideoColorSpace[TRTCVideoColorSpace["TRTCVideoColorSpace_BT709"] = 2] = "TRTCVideoColorSpace_BT709";
+})(TRTCVideoColorSpace = exports.TRTCVideoColorSpace || (exports.TRTCVideoColorSpace = {}));
+/**
+ * 视频编码复杂度
+ *
+ * @enum {Number}
+ */
+const TRTCVideoEncodeComplexity_Hack_JSDOC = {
+    /** 最快 */
+    TRTCVideoEncodeComplexity_Fastest: 0,
+    /** 快 */
+    TRTCVideoEncodeComplexity_Fast: 1,
+    /** 中 */
+    TRTCVideoEncodeComplexity_Medium: 2,
+    /** 慢 */
+    TRTCVideoEncodeComplexity_Slow: 3,
+    /** 最慢 */
+    TRTCVideoEncodeComplexity_Slowest: 4,
+};
+var TRTCVideoEncodeComplexity;
+(function (TRTCVideoEncodeComplexity) {
+    TRTCVideoEncodeComplexity[TRTCVideoEncodeComplexity["TRTCVideoEncodeComplexity_Fastest"] = 0] = "TRTCVideoEncodeComplexity_Fastest";
+    TRTCVideoEncodeComplexity[TRTCVideoEncodeComplexity["TRTCVideoEncodeComplexity_Fast"] = 1] = "TRTCVideoEncodeComplexity_Fast";
+    TRTCVideoEncodeComplexity[TRTCVideoEncodeComplexity["TRTCVideoEncodeComplexity_Medium"] = 2] = "TRTCVideoEncodeComplexity_Medium";
+    TRTCVideoEncodeComplexity[TRTCVideoEncodeComplexity["TRTCVideoEncodeComplexity_Slow"] = 3] = "TRTCVideoEncodeComplexity_Slow";
+    TRTCVideoEncodeComplexity[TRTCVideoEncodeComplexity["TRTCVideoEncodeComplexity_Slowest"] = 4] = "TRTCVideoEncodeComplexity_Slowest";
+})(TRTCVideoEncodeComplexity = exports.TRTCVideoEncodeComplexity || (exports.TRTCVideoEncodeComplexity = {}));
 /**
  * 摄像头采集参数
  *
@@ -788,6 +848,8 @@ var TRTCCameraCaptureMode;
  * @property {TRTCCameraCaptureMode} mode - 摄像头采集偏好
  * @property {Number} width - 采集图像宽度
  * @property {Number} height - 采集图像高度
+ * @property {TRTCVideoColorSpace} [colorSpace] - 可选，颜色空间
+ * @property {TRTCVideoColorRange} [colorRange] - 可选，颜色范围
  */
 const TRTCCameraCaptureParams_HACK_JSDOC = null;
 /**
@@ -892,6 +954,9 @@ exports.TRTCParams = TRTCParams;
  * @param {Boolean}                 enableAdjustRes - 【字段含义】是否允许动态调整分辨率（开启后会对云端录制产生影响）<br>
  *                                                    【推荐取值】该功能适用于不需要云端录制的场景，开启后 SDK 会根据当前网络情况，智能选择出一个合适的分辨率，避免出现“大分辨率+小码率”的低效编码模式。<br>
  *                                                    【特别说明】默认值：关闭。如有云端录制的需求，请不要开启此功能，因为如果视频分辨率发生变化后，云端录制出的 MP4 在普通的播放器上无法正常播放。<br>
+ * @param {TRTCVideoColorSpace}     [colorSpace]    - 编码色彩空间
+ * @param {TRTCVideoColorRange}     [colorRange]    - 编码色彩范围
+ * @param {TRTCVideoEncodeComplexity} [complexity]  - 编码复杂度
  */
 class TRTCVideoEncParam {
     constructor(videoResolution = TRTCVideoResolution.TRTCVideoResolution_640_360, resMode = TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape, videoFps = 15, videoBitrate = 550, minVideoBitrate = 0, enableAdjustRes = false) {
@@ -901,6 +966,9 @@ class TRTCVideoEncParam {
         this.videoBitrate = videoBitrate;
         this.minVideoBitrate = minVideoBitrate;
         this.enableAdjustRes = enableAdjustRes;
+        this.colorRange = TRTCVideoColorRange.TRTCVideoColorRange_Auto;
+        this.colorSpace = TRTCVideoColorSpace.TRTCVideoColorSpace_Auto;
+        this.complexity = TRTCVideoEncodeComplexity.TRTCVideoEncodeComplexity_Fastest;
     }
 }
 exports.TRTCVideoEncParam = TRTCVideoEncParam;

package/liteav/utils.d.ts

@@ -8,3 +8,30 @@ export declare function isNullOrUndefined(val: unknown): boolean;
  */
 export declare function safelyParse(data: string): unknown | Array<any> | Record<string, any>;
 export declare function convertUint8ArrayToNumber(value: Uint8Array): number;
+/**
+ * 防抖函数 (debounce)
+ *
+ * 适用场景：搜索框输入联想、窗口resize结束事件
+ *
+ * @param func 需要防抖的函数
+ * @param wait 等待时间（毫秒）
+ * @param immediate 是否立即执行第一次调用（true=立即执行，false=等待后执行）
+ * @returns 包装后的防抖函数
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number, immediate?: boolean): (...args: Parameters<T>) => void;
+/**
+ * 节流函数 (throttle)
+ *
+ * 适用场景：滚动事件、按钮防重复点击、鼠标移动事件
+ *
+ * @param func 需要节流的函数
+ * @param wait 等待时间（毫秒）
+ * @param options 配置选项
+ *        leading: 是否执行第一次调用（true=执行，false=跳过）
+ *        trailing: 是否执行最后一次调用（true=执行，false=跳过）
+ * @returns 包装后的节流函数
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, wait: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): (...args: Parameters<T>) => void;

package/liteav/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertUint8ArrayToNumber = exports.safelyParse = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = void 0;
+exports.throttle = exports.debounce = exports.convertUint8ArrayToNumber = exports.safelyParse = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = void 0;
 function isNull(val) {
     return val === null;
 }
@@ -47,3 +47,87 @@ function convertUint8ArrayToNumber(value) {
     return result;
 }
 exports.convertUint8ArrayToNumber = convertUint8ArrayToNumber;
+/**
+ * 防抖函数 (debounce)
+ *
+ * 适用场景：搜索框输入联想、窗口resize结束事件
+ *
+ * @param func 需要防抖的函数
+ * @param wait 等待时间（毫秒）
+ * @param immediate 是否立即执行第一次调用（true=立即执行，false=等待后执行）
+ * @returns 包装后的防抖函数
+ */
+function debounce(func, wait, immediate = false) {
+    let timeout = null;
+    let inWait = false; // 是否处于等待周期
+    return function (...args) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const context = this;
+        // 每次调用都清除现有定时器
+        if (timeout)
+            clearTimeout(timeout);
+        if (immediate && !inWait) {
+            // 立即执行模式且不在等待期
+            func.apply(context, args);
+            inWait = true;
+        }
+        // 设置新定时器
+        timeout = setTimeout(() => {
+            inWait = false;
+            if (!immediate) {
+                // 非立即执行模式：执行最后一次调用
+                func.apply(context, args);
+            }
+        }, wait);
+    };
+}
+exports.debounce = debounce;
+/**
+ * 节流函数 (throttle)
+ *
+ * 适用场景：滚动事件、按钮防重复点击、鼠标移动事件
+ *
+ * @param func 需要节流的函数
+ * @param wait 等待时间（毫秒）
+ * @param options 配置选项
+ *        leading: 是否执行第一次调用（true=执行，false=跳过）
+ *        trailing: 是否执行最后一次调用（true=执行，false=跳过）
+ * @returns 包装后的节流函数
+ */
+function throttle(func, wait, options = {}) {
+    const { leading = true, trailing = true } = options;
+    let lastExecTime = 0;
+    let timer = null;
+    let savedContext = null, savedArgs = null;
+    // 实际执行函数
+    const execute = () => {
+        lastExecTime = Date.now();
+        timer = null;
+        if (savedContext !== null && savedArgs !== null) {
+            func.apply(savedContext, savedArgs);
+        }
+    };
+    return function (...args) {
+        savedContext = this;
+        savedArgs = args;
+        const now = Date.now();
+        // 计算距离上次执行的时间差
+        const sinceLast = now - lastExecTime;
+        const remaining = wait - sinceLast;
+        // 超时情况：立即执行（无论是否在等待期）
+        if (remaining <= 0 || remaining > wait) {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            if (leading) {
+                execute();
+            }
+        }
+        else if (!timer && trailing) {
+            // 设置定时器执行尾部调用
+            timer = setTimeout(execute, remaining);
+        }
+    };
+}
+exports.throttle = throttle;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "12.2.115-beta.2",
+  "version": "12.2.115-beta.21",
   "description": "trtc electron sdk",
   "main": "./liteav/index.js",
   "types": "./liteav/index.d.ts",
@@ -55,7 +55,7 @@
     "doc:build": "npm run doc:build-zh && npm run doc:build-en ",
     "doc:build-zh": "jsdoc -c ./jsdoc/jsdoc_zh.json && node ./jsdoc/fix-doc_zh.js",
     "doc:build-en": "jsdoc -c ./jsdoc/jsdoc_en.json && node ./jsdoc/fix-doc_en.js",
-    "doc:clean": "node ./jsdoc/clean-doc.js",
+    "doc:clean": "rimraf ./_doc",
     "prerelease": "npm run build && npm run doc && node ./scripts/prerelase.js ",
     "publish_npm": "node scripts/publish-npm.js"
   },