trtc-electron-sdk 11.7.602-beta.0 → 11.7.602

package/liteav/trtc.d.ts

@@ -890,7 +890,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number}  config.mixUsersArray[].zOrder      - 图层层次（1 - 15）不可重复
      * @param {Boolean} config.mixUsersArray[].pureAudio   - 是否纯音频
      * @param {TRTCVideoStreamType} config.mixUsersArray[].streamType  - TRTCVideoStreamTypeBig：主路画面，一般用于摄像头；TRTCVideoStreamTypeSub：辅路画面，一般用于屏幕分享。
-     * @param {TRTCMixInputType} config.mixUsersArray[].inputType   - 指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。TRTCMixInputTypePureAudio：只混音频； TRTCMixInputTypeAudioVideo：混合音视频；TRTCMixInputTypeWatermark：混入水印。
+     * @param {TRTCMixInputType} config.mixUsersArray[].inputType   - 指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。TRTCMixInputTypePureAudio：只混音频；TRTCMixInputTypePureVideo：只混视频； TRTCMixInputTypeAudioVideo：混合音视频；TRTCMixInputTypeWatermark：混入水印。
      * @param {Number}  config.mixUsersArray[].renderMode  - 该画面在输出时的显示模式。视频流默认为0。0为裁剪，1为缩放，2为缩放并显示黑底。
      * @param {Number}  config.mixUsersArray[].soundLevel  - 该路音频参与混音时的音量等级（取值范围：0 - 100）,默认值：100。
      * @param {String}  config.mixUsersArray[].image       - 占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。当指定 inputType 为 TRTCMixInputTypePureAudio 时，image 为占位图，此时需要您指定 userId。当指定 inputType 为 TRTCMixInputTypeWatermark 时，image 为水印图，此时不需要您指定 userId。
@@ -2285,8 +2285,9 @@ declare class TRTCCloud extends EventEmitter {
      * 该方法测试麦克风是否能正常工作，volume 的取值范围为0 - 100。
      *
      * @param {Number} interval - 反馈音量提示的时间间隔（ms），建议设置到大于 200 毫秒
+     * @param {Boolean} [playback] - 是否开启回播麦克风声音，开启后用户测试麦克风时会听到自己的声音，如果不传递playback参数，则默认为false。
      */
-    startMicDeviceTest(interval: number): void;
+    startMicDeviceTest(interval: number, playback?: boolean): void;
     /**
      * 停止麦克风测试
      */
@@ -2420,10 +2421,12 @@ declare class TRTCCloud extends EventEmitter {
      *     - 0 表示 addPlugin 成功
      *     - -1 插件库错误
      *     - -2 插件库缺少插件创建函数
-     *     - -3 创建创建失败
-     *     - -4 插件初始化失败
-     *     - -5 插件加载资源失败
+     *     - -3 创建函数执行失败
+     *     - -4 插件初始化函数执行失败
+     *     - -5 插件加载资源函数执行失败
      *  - msg - 错误信息
+     *
+     *  注意：错误码：-1000 到 1000 是 SDK 预留错误码，用户自定义插件中，请使用这个范围以外的错误码。
      */
     setPluginCallback(pluginCb: (pluginId: string, errorCode: number, msg: string) => void): void;
     /**

package/liteav/trtc.js

@@ -1728,7 +1728,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Number}  config.mixUsersArray[].zOrder      - 图层层次（1 - 15）不可重复
      * @param {Boolean} config.mixUsersArray[].pureAudio   - 是否纯音频
      * @param {TRTCVideoStreamType} config.mixUsersArray[].streamType  - TRTCVideoStreamTypeBig：主路画面，一般用于摄像头；TRTCVideoStreamTypeSub：辅路画面，一般用于屏幕分享。
-     * @param {TRTCMixInputType} config.mixUsersArray[].inputType   - 指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。TRTCMixInputTypePureAudio：只混音频； TRTCMixInputTypeAudioVideo：混合音视频；TRTCMixInputTypeWatermark：混入水印。
+     * @param {TRTCMixInputType} config.mixUsersArray[].inputType   - 指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。TRTCMixInputTypePureAudio：只混音频；TRTCMixInputTypePureVideo：只混视频； TRTCMixInputTypeAudioVideo：混合音视频；TRTCMixInputTypeWatermark：混入水印。
      * @param {Number}  config.mixUsersArray[].renderMode  - 该画面在输出时的显示模式。视频流默认为0。0为裁剪，1为缩放，2为缩放并显示黑底。
      * @param {Number}  config.mixUsersArray[].soundLevel  - 该路音频参与混音时的音量等级（取值范围：0 - 100）,默认值：100。
      * @param {String}  config.mixUsersArray[].image       - 占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。当指定 inputType 为 TRTCMixInputTypePureAudio 时，image 为占位图，此时需要您指定 userId。当指定 inputType 为 TRTCMixInputTypeWatermark 时，image 为水印图，此时不需要您指定 userId。
@@ -2620,6 +2620,7 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     setAudioQuality(quality) {
         this.audioQuality = quality;
+        this.rtcCloud.setAudioQuality(quality);
     }
     /**
      * 废弃接口：设置麦克风的音量大小
@@ -3986,9 +3987,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * 该方法测试麦克风是否能正常工作，volume 的取值范围为0 - 100。
      *
      * @param {Number} interval - 反馈音量提示的时间间隔（ms），建议设置到大于 200 毫秒
+     * @param {Boolean} [playback] - 是否开启回播麦克风声音，开启后用户测试麦克风时会听到自己的声音，如果不传递playback参数，则默认为false。
      */
-    startMicDeviceTest(interval) {
-        this.rtcCloud.startMicDeviceTest(interval);
+    startMicDeviceTest(interval, playback) {
+        if (playback === undefined || playback === null) {
+            playback = false;
+        }
+        this.rtcCloud.startMicDeviceTest(interval, playback);
     }
     /**
      * 停止麦克风测试
@@ -4269,10 +4274,12 @@ class TRTCCloud extends events_1.EventEmitter {
      *     - 0 表示 addPlugin 成功
      *     - -1 插件库错误
      *     - -2 插件库缺少插件创建函数
-     *     - -3 创建创建失败
-     *     - -4 插件初始化失败
-     *     - -5 插件加载资源失败
+     *     - -3 创建函数执行失败
+     *     - -4 插件初始化函数执行失败
+     *     - -5 插件加载资源函数执行失败
      *  - msg - 错误信息
+     *
+     *  注意：错误码：-1000 到 1000 是 SDK 预留错误码，用户自定义插件中，请使用这个范围以外的错误码。
      */
     setPluginCallback(pluginCb) {
         this.rtcCloud.setPluginCallback(pluginCb);

package/liteav/trtc_define.d.ts

@@ -567,7 +567,8 @@ export declare enum TRTCMixInputType {
     TRTCMixInputTypeUndefined = 0,
     TRTCMixInputTypeAudioVideo = 1,
     TRTCMixInputTypePureVideo = 2,
-    TRTCMixInputTypePureAudio = 3
+    TRTCMixInputTypePureAudio = 3,
+    TRTCMixInputTypeWatermark = 4
 }
 export declare enum TRTCAudioRecordingContent {
     TRTCAudioRecordingContentAll = 0,

package/liteav/trtc_define.js

@@ -1194,7 +1194,9 @@ const TRTCMixInputType_HACK_JSDOC = {
     /** 只混入视频 */
     TRTCMixInputTypePureVideo: 2,
     /** 只混入音频 */
-    TRTCMixInputTypePureAudio: 3
+    TRTCMixInputTypePureAudio: 3,
+    /** 混入水印，此时您无需指定 userId 字段，但需要指定 image 字段，推荐使用 png 格式的图片 */
+    TRTCMixInputTypeWatermark: 4,
 };
 var TRTCMixInputType;
 (function (TRTCMixInputType) {
@@ -1202,6 +1204,7 @@ var TRTCMixInputType;
     TRTCMixInputType[TRTCMixInputType["TRTCMixInputTypeAudioVideo"] = 1] = "TRTCMixInputTypeAudioVideo";
     TRTCMixInputType[TRTCMixInputType["TRTCMixInputTypePureVideo"] = 2] = "TRTCMixInputTypePureVideo";
     TRTCMixInputType[TRTCMixInputType["TRTCMixInputTypePureAudio"] = 3] = "TRTCMixInputTypePureAudio";
+    TRTCMixInputType[TRTCMixInputType["TRTCMixInputTypeWatermark"] = 4] = "TRTCMixInputTypeWatermark";
 })(TRTCMixInputType = exports.TRTCMixInputType || (exports.TRTCMixInputType = {}));
 /**
  * 音频录制内容类型, 9.3 版本开始支持

package/package.json

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