trtc-electron-sdk 12.0.606 → 12.1.608

package/README.md

@@ -23,7 +23,7 @@ Tencent Real-Time Communication (TRTC) is a set of low-latency, high-quality rea
 ## ⏬ Install
 By default, it will install the SDK compatible with your device Operation System platform and node.js CPU architecture. If you want to install SDK for specific Operating System or CPU architecture. You can configure the `platform` and `arch` you want in `package.json` or `.npmrc` file as following code. If you configure both, the configuration in `package.json` will work and override that in `.npmrc`.
 
-```json
+```js
 // package.json
 {
     ...
@@ -65,7 +65,7 @@ const version = rtcCloud.getSDKVersion();
 ## 📦 Build
 Taking webpack and electron-builder as example.
 
-```json
+```js
 // webpack config
 module.exports = {
     ...

package/liteav/VideoRenderControl/VideoRenderFPSMonitor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @class RenderFPSMonitor
+ */
+declare class VideoRenderFPSMonitor {
+    private logPrefix;
+    private emitter;
+    private nextAnimationFrame;
+    private lastTimestamp;
+    private refreshCount;
+    private pageRefreshFPS;
+    private lastPageRefreshFPS;
+    private videoRenderFPS;
+    private lastVideoRenderFPS;
+    private statisticDuration;
+    constructor();
+    private initPageRefreshFPSStatistic;
+    private statisticPageRefreshFPS;
+    /**
+     * 规则：
+     * 页面刷新帧率低于 10 时，设置渲染帧率为 5
+     * 页面刷新帧率低于 20 时，设置渲染帧率为 15
+     * 页面刷新帧率低于 30 时，设置渲染帧率为 25
+     * 页面刷新帧率高于 30 时，设置渲染帧率为 -1，负数表示关闭渲染帧率限制
+     * 页面刷新帧率从低于 10 到 30+ 时，持续 2 秒后，设置渲染帧率为 15
+     * 页面刷新帧率从低于 20 到 30+ 时，持续 2 秒后，设置渲染帧率为 25
+     * 页面刷新帧率从低于 30 到 30+ 时，持续 2 秒后，设置渲染帧率为 -1，负数表示关闭渲染帧率限制
+     */
+    private statisticVideoRenderFPS;
+    private onVisibilityChange;
+    private notifyFPS;
+    destroy(): void;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+    emit(event: string, ...args: any[]): void;
+}
+export declare const videoRenderFPSMonitor: VideoRenderFPSMonitor;
+export default VideoRenderFPSMonitor;

package/liteav/VideoRenderControl/VideoRenderFPSMonitor.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.videoRenderFPSMonitor = void 0;
+const events_1 = require("events");
+const logger_1 = __importDefault(require("../logger"));
+/**
+ * @class RenderFPSMonitor
+ */
+class VideoRenderFPSMonitor {
+    constructor() {
+        this.logPrefix = '[RenderFPSMonitor]';
+        this.emitter = new events_1.EventEmitter();
+        this.nextAnimationFrame = 0;
+        this.lastTimestamp = 0;
+        this.refreshCount = 0;
+        this.pageRefreshFPS = 0;
+        this.lastPageRefreshFPS = 60;
+        this.videoRenderFPS = 0;
+        this.lastVideoRenderFPS = -1;
+        this.statisticDuration = 2000;
+        this.statisticPageRefreshFPS = this.statisticPageRefreshFPS.bind(this);
+        this.onVisibilityChange = this.onVisibilityChange.bind(this);
+        this.initPageRefreshFPSStatistic();
+        document.addEventListener('visibilitychange', this.onVisibilityChange);
+    }
+    initPageRefreshFPSStatistic() {
+        if (window.requestAnimationFrame) {
+            this.nextAnimationFrame = window.requestAnimationFrame(this.statisticPageRefreshFPS);
+        }
+    }
+    statisticPageRefreshFPS(timestamp) {
+        if (this.lastTimestamp === 0) {
+            this.lastTimestamp = timestamp;
+        }
+        this.refreshCount++;
+        const duration = timestamp - this.lastTimestamp;
+        if (duration >= this.statisticDuration) {
+            this.lastPageRefreshFPS = this.pageRefreshFPS;
+            this.pageRefreshFPS = Math.round(this.refreshCount * 1000 / duration);
+            setTimeout(() => {
+                this.statisticVideoRenderFPS();
+            }, 0);
+            this.lastTimestamp = timestamp;
+            this.refreshCount = 0;
+        }
+        this.nextAnimationFrame = window.requestAnimationFrame(this.statisticPageRefreshFPS);
+    }
+    /**
+     * 规则：
+     * 页面刷新帧率低于 10 时，设置渲染帧率为 5
+     * 页面刷新帧率低于 20 时，设置渲染帧率为 15
+     * 页面刷新帧率低于 30 时，设置渲染帧率为 25
+     * 页面刷新帧率高于 30 时，设置渲染帧率为 -1，负数表示关闭渲染帧率限制
+     * 页面刷新帧率从低于 10 到 30+ 时，持续 2 秒后，设置渲染帧率为 15
+     * 页面刷新帧率从低于 20 到 30+ 时，持续 2 秒后，设置渲染帧率为 25
+     * 页面刷新帧率从低于 30 到 30+ 时，持续 2 秒后，设置渲染帧率为 -1，负数表示关闭渲染帧率限制
+     */
+    statisticVideoRenderFPS() {
+        if (this.pageRefreshFPS <= 10) {
+            this.videoRenderFPS = this.pageRefreshFPS < 5 ? this.pageRefreshFPS : 5;
+        }
+        else if (this.pageRefreshFPS <= 20) {
+            this.videoRenderFPS = this.pageRefreshFPS < 15 ? this.pageRefreshFPS : 15;
+        }
+        else if (this.pageRefreshFPS <= 30) {
+            this.videoRenderFPS = this.pageRefreshFPS < 25 ? this.pageRefreshFPS : 25;
+        }
+        else if (this.pageRefreshFPS > 30 && this.lastPageRefreshFPS <= 10) {
+            this.videoRenderFPS = 15;
+        }
+        else if (this.pageRefreshFPS > 30 && this.lastPageRefreshFPS <= 20) {
+            this.videoRenderFPS = 25;
+        }
+        else {
+            this.videoRenderFPS = -1;
+        }
+        if (this.lastVideoRenderFPS !== this.videoRenderFPS) {
+            this.lastVideoRenderFPS = this.videoRenderFPS;
+            this.notifyFPS();
+        }
+    }
+    onVisibilityChange() {
+        if (document.hidden) {
+            logger_1.default.info(`${this.logPrefix} document hidden`);
+            this.videoRenderFPS = 1;
+            this.pageRefreshFPS = 1;
+        }
+        else {
+            logger_1.default.info(`${this.logPrefix} document show`);
+            this.videoRenderFPS = 5; // 慢启动
+            this.pageRefreshFPS = 5;
+        }
+        this.lastVideoRenderFPS = this.videoRenderFPS;
+        this.lastTimestamp = 0;
+        this.refreshCount = 0;
+        this.notifyFPS();
+    }
+    notifyFPS() {
+        logger_1.default.debug(`${this.logPrefix} pageRefreshFPS:${this.pageRefreshFPS} videoRenderFPS: ${this.videoRenderFPS}`);
+        this.emit('videoRenderFPS', {
+            pageFPS: this.pageRefreshFPS,
+            videoFPS: this.videoRenderFPS,
+        });
+    }
+    destroy() {
+        if (this.nextAnimationFrame) {
+            window.cancelAnimationFrame(this.nextAnimationFrame);
+            this.nextAnimationFrame = 0;
+        }
+        this.emitter.removeAllListeners();
+        document.removeEventListener('visibilitychange', this.onVisibilityChange);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    emit(event, ...args) {
+        this.emitter.emit(event, ...args);
+    }
+}
+exports.videoRenderFPSMonitor = new VideoRenderFPSMonitor();
+exports.default = VideoRenderFPSMonitor;

package/liteav/trtc.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
 import { TRTCConfig } from './Renderer/util';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSpeedTestResult, TRTCStatistics, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCAudioFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TRTCWaterMarkSrcType, TRTCQualityInfo, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSpeedTestResult, TRTCStatistics, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCAudioFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TRTCWaterMarkSrcType, TRTCQualityInfo, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions } from './trtc_define';
 export * from './trtc_define';
 export * from './trtc_code';
 export * from './vod_player';
@@ -67,6 +67,7 @@ declare class TRTCCloud extends EventEmitter {
      * 注释：会同时销毁所有子实例
      */
     static destroyTRTCShareInstance(): void;
+    private onFPSChanged;
     /**
      * 创建子实例
      *
@@ -1209,7 +1210,6 @@ declare class TRTCCloud extends EventEmitter {
      * 如果录制任务在退出房间前尚未通过本接口停止，则退出房间后录音任务会自动被停止。
      */
     stopLocalRecording(): void;
-    setVideoRenderFPS(fps: number): void;
     /**
      * 开启本地音频的采集和上行
      *
@@ -2205,16 +2205,59 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} volume - 音量大小，100为正常音量，取值范围为0 - 100；默认值：100
      */
     setMusicPublishVolume(id: number, volume: number): void;
+    /**
+     * 开启耳返
+     *
+     * 主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。
+     *
+     * 需要您注意的是，由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。同时也需要注意，并非所有的手机开启此特效后都能达到优秀的耳返效果，我们已经对部分耳返效果不佳的手机屏蔽了该特效。
+     * @param {Boolean} enable - 是否开启耳返。
+     */
+    enableVoiceEarMonitor(enable: boolean): void;
+    /**
+     * 设置耳返音量
+     *
+     * 通过该接口您可以设置耳返特效中声音的音量大小。
+     *
+     * 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+     * @param {Number} volumn - 音量大小，取值范围为0 - 100，默认值：100。
+     */
+    setVoiceEarMonitorVolume(volumn: number): void;
+    /**
+     * 设置语音音量
+     *
+     * 该接口可以设置语音音量的大小，一般配合音乐音量的设置接口 setAllMusicVolume 协同使用，用于调谐语音和音乐在混音前各自的音量占比。
+     *
+     * 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+     * @param {Number} volume - 音量大小，取值范围为0 - 100，默认值：100。
+     */
+    setVoiceCaptureVolume(volume: number): void;
+    /**
+     * 设置语音音调
+     *
+     * 该接口可以设置语音音调，用于实现变调不变速的目的。
+     * @param {Number} pitch - 音调，取值范围为-1.0f~1.0f，默认值：0.0f。
+     */
+    setVoicePitch(pitch: number): void;
     /**
      * 设置人声的混响效果
      *
-     * 通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义
+     * 通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义。
      *
      * 注意：设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
      *
-     * @param {TRTCVoiceReverbType} type - 人声的混响效果类型
+     * @param {TRTCVoiceReverbType} type - 人声的混响效果类型。
      */
     setVoiceReverbType(type: TRTCVoiceReverbType): void;
+    /**
+     * 设置人声的变声效果
+     *
+     * 通过该接口您可以设置人声的变声效果，具体特效请参见枚举定义
+     *
+     * 注意：设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置
+     * @param {TRTCVoiceChangerType} type - 人声的变声效果类型 。
+     */
+    setVoiceChangerType(type: TRTCVoiceChangerType): void;
     /**
      * 废弃接口： 播放音效
      *
@@ -2385,18 +2428,23 @@ declare class TRTCCloud extends EventEmitter {
     /**
      * 设置日志保存路径
      *
-     * 注意：
-     * - windows 日志文件默认保存在 C:/Users/[系统用户名]/AppData/Roaming/Tencent/liteav/log，即 %appdata%/Tencent/liteav/log 下，如需修改，必须在所有方法前调用。
+     * 通过该接口您可以更改 SDK 本地日志的默认存储路径，SDK 默认的本地日志的存储位置：
+     * - windows 日志文件默认保存在 C:/Users/[系统用户名]/AppData/Roaming/liteav/log，即 %appdata%/liteav/log 下，如需修改，必须在所有方法前调用。
      * - mac 日志文件默认保存在 sandbox Documents/log 下，如需修改，必须在所有方法前调用。
      *
+     * 注意：请务必在所有其他接口之前调用，并且保证您指定的目录是存在的，并且您的应用程序拥有对该目录的读写权限。
+     *
      * @param {String} path - 存储日志的文件夹，例如 "D:\\Log"，UTF-8 编码
      */
     setLogDirPath(path: string): void;
     /**
      * 设置日志回调
-     * @param {Function} callback - 日志回调
+     *
+     * 注意: 如何您设置了日志回调，SDK的日志信息将会回调给您，您需要自行在代码中处理。当 callback 为 null 时取消日志回调，SDK 将不会再回调日志。
+     *
+     * @param {Function | null} callback - 日志回调。 Function 的参数格式为 (log:string, level:TRTCLogLevel, module:string) => void。
      */
-    setLogCallback(callback?: () => void): void;
+    setLogCallback(callback?: (log: string, level: TRTCLogLevel, module: string) => void | null): void;
     /**
      * 调用实验性 API 接口
      *
@@ -2466,7 +2514,7 @@ declare class TRTCCloud extends EventEmitter {
      *  - pluginId - 插件ID
      *  - errorCode - 错误码。0、-1、-2、-3、-4、-5 是 SDK 内部定义错误码，其它错误码是插件自定义错误码。
      *     - 0 表示 addPlugin 成功
-     *     - -1 插件库错误
+     *     - -1 插件库加载失败
      *     - -2 插件库缺少插件创建函数
      *     - -3 创建函数执行失败
      *     - -4 插件初始化函数执行失败

package/liteav/trtc.js

@@ -36,6 +36,7 @@ const trtc_define_1 = require("./trtc_define");
 const validate_util_1 = require("./validate-util");
 const logger_1 = __importStar(require("./logger"));
 const LocalVideoRenderController_1 = __importDefault(require("./VideoRenderControl/LocalVideoRenderController"));
+const VideoRenderFPSMonitor_1 = require("./VideoRenderControl/VideoRenderFPSMonitor");
 const NodeTRTCEngine = require('../build/Release/trtc_electron_sdk.node');
 const pkg = require('../package.json');
 __exportStar(require("./trtc_define"), exports);
@@ -204,8 +205,9 @@ class TRTCCloud extends events_1.EventEmitter {
         };
         // 本地合图插件
         // this.localMediaTranscoder = null;
-        this.videoRenderFPS = 15;
-        this.setVideoRenderFPS(this.videoRenderFPS);
+        this.videoRenderFPS = 60;
+        this.onFPSChanged = this.onFPSChanged.bind(this);
+        VideoRenderFPSMonitor_1.videoRenderFPSMonitor.on('videoRenderFPS', this.onFPSChanged);
         this.callExperimentalAPI("{\"api\":\"setCurrentEnvironment\",\"params\" :{\"electron\":true}}");
         this._localVideoRenderCallback = this._localVideoRenderCallback.bind(this);
         this._remoteVideoRenderCallback = this._remoteVideoRenderCallback.bind(this);
@@ -241,6 +243,10 @@ class TRTCCloud extends events_1.EventEmitter {
             TRTCCloud.sharedTRTCCloudInstance = null;
         }
     }
+    onFPSChanged(options) {
+        this.videoRenderFPS = options.videoFPS !== -1 ? options.videoFPS : 60;
+        this.rtcCloud.setVideoRenderFPS(this.videoRenderFPS);
+    }
     /**
      * 创建子实例
      *
@@ -310,6 +316,7 @@ class TRTCCloud extends events_1.EventEmitter {
         else {
             TRTCCloud.subInstances = TRTCCloud.subInstances.filter((item) => { return item != this; });
         }
+        VideoRenderFPSMonitor_1.videoRenderFPSMonitor.off('videoRenderFPS', this.onFPSChanged);
         this.playAudioEffectIdList = [];
         this.remoteFillModeMap.clear();
         this.rtcCloud.destroy();
@@ -863,17 +870,6 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {TRTCStatistics} statis - 统计数据，包括本地和远程的
      */
     handleOnStatistics(statis) {
-        if (statis.systemCpu >= 95 && this.videoRenderFPS !== 5) {
-            this.setVideoRenderFPS(5);
-        }
-        else if (statis.systemCpu >= 80 && this.videoRenderFPS !== 10) {
-            this.setVideoRenderFPS(10);
-        }
-        else {
-            if (this.videoRenderFPS < 15) {
-                this.setVideoRenderFPS(15);
-            }
-        }
         this.fire('onStatistics', statis);
     }
     /////////////////////////////////////////////////////////////////////////////////
@@ -2407,11 +2403,6 @@ class TRTCCloud extends events_1.EventEmitter {
     stopLocalRecording() {
         this.rtcCloud.stopLocalRecording();
     }
-    setVideoRenderFPS(fps) {
-        const valid_fps = fps >= 5 ? fps : 5;
-        this.videoRenderFPS = valid_fps;
-        this.rtcCloud.setVideoRenderFPS(this.videoRenderFPS);
-    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （四）音频相关接口函数
@@ -3812,18 +3803,74 @@ class TRTCCloud extends events_1.EventEmitter {
     setMusicPublishVolume(id, volume) {
         this.rtcCloud.setMusicPublishVolume(id, volume);
     }
+    /**
+     * 开启耳返
+     *
+     * 主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。
+     *
+     * 需要您注意的是，由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。同时也需要注意，并非所有的手机开启此特效后都能达到优秀的耳返效果，我们已经对部分耳返效果不佳的手机屏蔽了该特效。
+     * @param {Boolean} enable - 是否开启耳返。
+     */
+    enableVoiceEarMonitor(enable) {
+        this.rtcCloud.enableVoiceEarMonitor(enable);
+    }
+    /**
+     * 设置耳返音量
+     *
+     * 通过该接口您可以设置耳返特效中声音的音量大小。
+     *
+     * 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+     * @param {Number} volumn - 音量大小，取值范围为0 - 100，默认值：100。
+     */
+    setVoiceEarMonitorVolume(volumn) {
+        this.rtcCloud.setVoiceEarMonitorVolume(volumn);
+    }
+    /**
+     * 设置语音音量
+     *
+     * 该接口可以设置语音音量的大小，一般配合音乐音量的设置接口 setAllMusicVolume 协同使用，用于调谐语音和音乐在混音前各自的音量占比。
+     *
+     * 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
+     * @param {Number} volume - 音量大小，取值范围为0 - 100，默认值：100。
+     */
+    setVoiceCaptureVolume(volume) {
+        this.rtcCloud.setVoiceCaptureVolume(volume);
+    }
+    /**
+     * 设置语音音调
+     *
+     * 该接口可以设置语音音调，用于实现变调不变速的目的。
+     * @param {Number} pitch - 音调，取值范围为-1.0f~1.0f，默认值：0.0f。
+     */
+    setVoicePitch(pitch) {
+        if (pitch < -1.0 || pitch > 1.0) {
+            throw new Error('pitch is out of range [-1.0, 1.0]');
+        }
+        this.rtcCloud.setVoicePitch(pitch);
+    }
     /**
      * 设置人声的混响效果
      *
-     * 通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义
+     * 通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义。
      *
      * 注意：设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
      *
-     * @param {TRTCVoiceReverbType} type - 人声的混响效果类型
+     * @param {TRTCVoiceReverbType} type - 人声的混响效果类型。
      */
     setVoiceReverbType(type) {
         this.rtcCloud.setVoiceReverbType(type);
     }
+    /**
+     * 设置人声的变声效果
+     *
+     * 通过该接口您可以设置人声的变声效果，具体特效请参见枚举定义
+     *
+     * 注意：设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置
+     * @param {TRTCVoiceChangerType} type - 人声的变声效果类型 。
+     */
+    setVoiceChangerType(type) {
+        this.rtcCloud.setVoiceChangerType(type);
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （十二）音效相关接口函数
@@ -4097,6 +4144,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * - TRTCLogLevelFatal  : 只输出 FATAL 级别的 Log
      */
     setLogLevel(level) {
+        logger_1.default.setLogLevel(level);
         this.logger.setLogLevel(level);
         this.rtcCloud.setLogLevel(level);
     }
@@ -4122,10 +4170,12 @@ class TRTCCloud extends events_1.EventEmitter {
     /**
      * 设置日志保存路径
      *
-     * 注意：
-     * - windows 日志文件默认保存在 C:/Users/[系统用户名]/AppData/Roaming/Tencent/liteav/log，即 %appdata%/Tencent/liteav/log 下，如需修改，必须在所有方法前调用。
+     * 通过该接口您可以更改 SDK 本地日志的默认存储路径，SDK 默认的本地日志的存储位置：
+     * - windows 日志文件默认保存在 C:/Users/[系统用户名]/AppData/Roaming/liteav/log，即 %appdata%/liteav/log 下，如需修改，必须在所有方法前调用。
      * - mac 日志文件默认保存在 sandbox Documents/log 下，如需修改，必须在所有方法前调用。
      *
+     * 注意：请务必在所有其他接口之前调用，并且保证您指定的目录是存在的，并且您的应用程序拥有对该目录的读写权限。
+     *
      * @param {String} path - 存储日志的文件夹，例如 "D:\\Log"，UTF-8 编码
      */
     setLogDirPath(path) {
@@ -4134,12 +4184,13 @@ class TRTCCloud extends events_1.EventEmitter {
     }
     /**
      * 设置日志回调
-     * @param {Function} callback - 日志回调
+     *
+     * 注意: 如何您设置了日志回调，SDK的日志信息将会回调给您，您需要自行在代码中处理。当 callback 为 null 时取消日志回调，SDK 将不会再回调日志。
+     *
+     * @param {Function | null} callback - 日志回调。 Function 的参数格式为 (log:string, level:TRTCLogLevel, module:string) => void。
      */
     setLogCallback(callback) {
-        if (callback !== undefined) {
-            this.rtcCloud.setLogCallback(callback);
-        }
+        this.rtcCloud.setLogCallback(callback);
     }
     /**
      * 调用实验性 API 接口
@@ -4342,7 +4393,7 @@ class TRTCCloud extends events_1.EventEmitter {
      *  - pluginId - 插件ID
      *  - errorCode - 错误码。0、-1、-2、-3、-4、-5 是 SDK 内部定义错误码，其它错误码是插件自定义错误码。
      *     - 0 表示 addPlugin 成功
-     *     - -1 插件库错误
+     *     - -1 插件库加载失败
      *     - -2 插件库缺少插件创建函数
      *     - -3 创建函数执行失败
      *     - -4 插件初始化函数执行失败

package/liteav/trtc_define.d.ts

@@ -595,6 +595,20 @@ export declare enum TRTCVoiceReverbType {
     TRTCLiveVoiceReverbType_10 = 10,
     TRTCLiveVoiceReverbType_11 = 11
 }
+export declare enum TRTCVoiceChangerType {
+    TRTCLiveVoiceChangerType_0 = 0,
+    TRTCLiveVoiceChangerType_1 = 1,
+    TRTCLiveVoiceChangerType_2 = 2,
+    TRTCLiveVoiceChangerType_3 = 3,
+    TRTCLiveVoiceChangerType_4 = 4,
+    TRTCLiveVoiceChangerType_5 = 5,
+    TRTCLiveVoiceChangerType_6 = 6,
+    TRTCLiveVoiceChangerType_7 = 7,
+    TRTCLiveVoiceChangerType_8 = 8,
+    TRTCLiveVoiceChangerType_9 = 9,
+    TRTCLiveVoiceChangerType_10 = 10,
+    TRTCLiveVoiceChangerType_11 = 11
+}
 export declare enum TRTCPluginType {
     TRTCPluginTypeUnknown = 0,
     TRTCPluginTypeVideoProcess = 1,

package/liteav/trtc_define.js

@@ -6,8 +6,8 @@
  *
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCPluginType = exports.TRTCVoiceReverbType = 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 = void 0;
+exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = exports.TRTCTranscodingConfig = exports.TRTCPluginType = exports.TRTCVoiceChangerType = exports.TRTCVoiceReverbType = 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 = void 0;
 const util_1 = require("./Renderer/util");
 /////////////////////////////////////////////////////////////////////////////////
 //
@@ -1282,6 +1282,54 @@ var TRTCVoiceReverbType;
     TRTCVoiceReverbType[TRTCVoiceReverbType["TRTCLiveVoiceReverbType_10"] = 10] = "TRTCLiveVoiceReverbType_10";
     TRTCVoiceReverbType[TRTCVoiceReverbType["TRTCLiveVoiceReverbType_11"] = 11] = "TRTCLiveVoiceReverbType_11";
 })(TRTCVoiceReverbType = exports.TRTCVoiceReverbType || (exports.TRTCVoiceReverbType = {}));
+/**
+ * 变声特效
+ *
+ * 变声特效可以作用于人声之上，通过声学算法对人声进行二次处理，以获得与原始声音所不同的音色，目前支持如下几种变声特效
+ *
+ * @enum {Number}
+ */
+const TRTCVoiceChangerType_HACK_JSDOC = {
+    /** 关闭特效 */
+    TRTCLiveVoiceChangerType_0: 0,
+    /** 熊孩子 */
+    TRTCLiveVoiceChangerType_1: 1,
+    /** 萝莉*/
+    TRTCLiveVoiceChangerType_2: 2,
+    /** 大叔 */
+    TRTCLiveVoiceChangerType_3: 3,
+    /** 重金属 */
+    TRTCLiveVoiceChangerType_4: 4,
+    /** 感冒 */
+    TRTCLiveVoiceChangerType_5: 5,
+    /** 外语腔 */
+    TRTCLiveVoiceChangerType_6: 6,
+    /** 困兽 */
+    TRTCLiveVoiceChangerType_7: 7,
+    /** 肥宅 */
+    TRTCLiveVoiceChangerType_8: 8,
+    /** 强电流 */
+    TRTCLiveVoiceChangerType_9: 9,
+    /** 重机械 */
+    TRTCLiveVoiceChangerType_10: 10,
+    /** 空灵 */
+    TRTCLiveVoiceChangerType_11: 11,
+};
+var TRTCVoiceChangerType;
+(function (TRTCVoiceChangerType) {
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_0"] = 0] = "TRTCLiveVoiceChangerType_0";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_1"] = 1] = "TRTCLiveVoiceChangerType_1";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_2"] = 2] = "TRTCLiveVoiceChangerType_2";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_3"] = 3] = "TRTCLiveVoiceChangerType_3";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_4"] = 4] = "TRTCLiveVoiceChangerType_4";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_5"] = 5] = "TRTCLiveVoiceChangerType_5";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_6"] = 6] = "TRTCLiveVoiceChangerType_6";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_7"] = 7] = "TRTCLiveVoiceChangerType_7";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_8"] = 8] = "TRTCLiveVoiceChangerType_8";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_9"] = 9] = "TRTCLiveVoiceChangerType_9";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_10"] = 10] = "TRTCLiveVoiceChangerType_10";
+    TRTCVoiceChangerType[TRTCVoiceChangerType["TRTCLiveVoiceChangerType_11"] = 11] = "TRTCLiveVoiceChangerType_11";
+})(TRTCVoiceChangerType = exports.TRTCVoiceChangerType || (exports.TRTCVoiceChangerType = {}));
 /**
  * 插件类型
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "12.0.606",
+  "version": "12.1.608",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",

package/scripts/copy-sdk.js

@@ -31,6 +31,10 @@ if (process.platform === "win32") {
     path.resolve(SDK_CPP_PATH, `src/remote-liteav/sdk/win/${dllPrefix}/lib/`),
     path.resolve(SDK_JS_PATH, "build/Release/")
   );
+  copySync(
+    path.resolve(SDK_CPP_PATH, `src/remote-liteav/sdk/remote_liteav/${dllPrefix}/`),
+    path.resolve(SDK_JS_PATH, "build/Release/")
+  );
   copySync(
     path.resolve(SDK_CPP_PATH, "build/Release/trtc_electron_sdk.pdb"),
     path.resolve(SDK_JS_PATH, "build/Release/trtc_electron_sdk.pdb")