trtc-cloud-js-sdk 2.12.1 → 2.12.2-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-cloud-js-sdk",
-  "version": "2.12.1",
+  "version": "2.12.2-beta.0",
   "description": "Tencent Cloud RTC SDK for Web And Electron",
   "main": "trtc-cloud-js-sdk.js",
   "module": "trtc-cloud-js-sdk.esm.js",

package/trtc-cloud-js-sdk.d.ts

@@ -58,6 +58,20 @@ declare enum TRTCAudioQuality {
     TRTCAudioQualityDefault = 2,
     TRTCAudioQualityMusic = 3
 }
+/**
+ * 音频场景增强枚举（实验接口配套类型）
+ *
+ * 用于 `callExperimentalAPI` 的 `setAudioQualityEx` 接口，与 `TRTCAudioQuality`
+ *
+ * - `default` (0)：普通场景，关闭 AI 降噪
+ * - `silent`  (8)：安静场景，开启 AI 降噪（mode 由 audioQuality 决定）
+ * - `hifi2`   (18)：高保真 v2 场景，开启 AI 降噪（mode 由 audioQuality 决定）
+ */
+declare enum TRTCAudioSceneEx {
+    default = 0,
+    silent = 8,
+    hifi2 = 18
+}
 /**
  * 设备信息<br>
  * @param {String} deviceId   - 设备PID，字符编码格式是UTF-8
@@ -1101,6 +1115,14 @@ declare class TRTC_Cloud extends EventEmitter {
     private _isBeautyEnabled;
     private _isTestBeautyEnabled;
     private _enableAutoPlayDialog;
+    private _sdkAppId;
+    private _userId;
+    private _userSig;
+    private _currentAudioQuality;
+    private _lastAudioScene;
+    private _isAIDenoiserEnabled;
+    private _currentAIDenoiserMode;
+    private _pendingAIDenoiserApply;
     private _remoteStatisticsUserIdList;
     private _hasJoinedRoom;
     private _isExitingRoom;
@@ -1749,6 +1771,28 @@ declare class TRTC_Cloud extends EventEmitter {
     setBeautyStyle(style: TRTCBeautyStyle, beautyLevel: number, whitenessLevel: number, ruddinessLevel: number): Promise<void>;
     setTestBeautyStyle(style: TRTCBeautyStyle, beautyLevel: number, whitenessLevel: number, ruddinessLevel: number): Promise<void>;
     useBeautyStyle(assetsPath?: string): Promise<void>;
+    /**
+     * 设置音频质量增强（AI 降噪）。仅缓存 audioScene 并触发一次状态机决策，
+     * 真实开关由 _applyAIDenoiserDecision 完成。
+     *
+     * 约束：必须在 enterRoom 成功之后调用；之前调用会被 pending 并等待成功进房后调用。
+     *
+     * @param params.audioScene - 见 TRTCAudioSceneEx
+     */
+    private _setAudioQualityEx;
+    /**
+     * AI 降噪状态机：基于当前 _currentAudioQuality + _lastAudioScene 决定开/关/切 mode。
+     * 被 _setAudioQualityEx 和 startLocalAudio（主动模式）共用。
+     */
+    private _applyAIDenoiserDecision;
+    /**
+     * 决策矩阵：
+     * - audioScene === default                                       -> 关闭
+     * - audioQuality === TRTCAudioQualityMusic                       -> 关闭
+     * - audioQuality === TRTCAudioQualitySpeech + audioScene 非 default -> 1 (远场)
+     * - 其它（Default + 非 default scene）                              -> 0 (基础)
+     */
+    private _resolveAIDenoiserMode;
     private _handleBeautyStyleParam;
     private _resetBeautyStyle;
     /**
@@ -1999,4 +2043,4 @@ declare class TRTC_Cloud extends EventEmitter {
     getAITranscriberManager(): AITranscriberManager;
 }
 
-export { AITranscriberListener, AudioMuteType, IAITranscriberManager, ITRTCMediaMixingEvent, ITRTCMediaMixingManager, InteractionOption, Rect, TRTCAppScene, TRTCAudioQuality, TRTCBeautyStyle, TRTCCameraCaptureMode, TRTCCameraCaptureParams, TRTCDeviceInfo, TRTCDeviceState, TRTCDeviceType, TRTCImageBuffer, TRTCLocalStatistics, TRTCLogLevel, TRTCMediaMixingEncParam, TRTCMediaMixingErrorCode, TRTCMediaMixingEvent, TRTCMediaSource, TRTCMediaSourceType, TRTCMixInputType, TRTCMixUser, TRTCNetworkQosParam, TRTCParams, TRTCPublishCDNParam, TRTCQosControlMode, TRTCQuality, TRTCQualityInfo, TRTCRemoteStatistics, TRTCRenderParams, TRTCRoleType, TRTCScreenCaptureProperty, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureSourceType, TRTCStatistics, TRTCTranscodingConfig, TRTCTranscodingConfigMode, TRTCVideoEncParam, TRTCVideoFillMode, TRTCVideoMirrorType, TRTCVideoQosPreference, TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TranscriberMessage, TranscriberParams, TRTC_Cloud as default };
+export { AITranscriberListener, AudioMuteType, IAITranscriberManager, ITRTCMediaMixingEvent, ITRTCMediaMixingManager, InteractionOption, Rect, TRTCAppScene, TRTCAudioQuality, TRTCAudioSceneEx, TRTCBeautyStyle, TRTCCameraCaptureMode, TRTCCameraCaptureParams, TRTCDeviceInfo, TRTCDeviceState, TRTCDeviceType, TRTCImageBuffer, TRTCLocalStatistics, TRTCLogLevel, TRTCMediaMixingEncParam, TRTCMediaMixingErrorCode, TRTCMediaMixingEvent, TRTCMediaSource, TRTCMediaSourceType, TRTCMixInputType, TRTCMixUser, TRTCNetworkQosParam, TRTCParams, TRTCPublishCDNParam, TRTCQosControlMode, TRTCQuality, TRTCQualityInfo, TRTCRemoteStatistics, TRTCRenderParams, TRTCRoleType, TRTCScreenCaptureProperty, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureSourceType, TRTCStatistics, TRTCTranscodingConfig, TRTCTranscodingConfigMode, TRTCVideoEncParam, TRTCVideoFillMode, TRTCVideoMirrorType, TRTCVideoQosPreference, TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCVolumeInfo, TranscriberMessage, TranscriberParams, TRTC_Cloud as default };