@agora-js/media 4.22.1-100 → 4.22.2

package/media.d.ts

@@ -559,6 +559,48 @@ declare class AudioState extends EventEmitter {
 
 export declare function audioTimerLoop(callback: (time: number) => any, frequency: number): () => void;
 
+/**
+ * 创建音频轨道时的配置参数。
+ */
+/** @en
+ * Configurations for the audio track of screen sharing.
+ */
+export declare interface AudioTrackInitConfig {
+    /**
+     * 是否开启回声消除：
+     * - `true`: 开启回声消除。
+     * - `false`: 不开启回声消除。
+     */
+    /** @en
+     * Whether to enable acoustic echo cancellation:
+     * - `true`: Enable acoustic echo cancellation.
+     * - `false`: Do not enable acoustic echo cancellation.
+     */
+    AEC?: boolean;
+    /**
+     * 是否开启自动增益：
+     * - `true`: 开启自动增益。
+     * - `false`: 不开启自动增益。
+     */
+    /** @en
+     * Whether to enable audio gain control:
+     * - `true`: Enable audio gain control.
+     * - `false`: Do not enable audio gain control.
+     */
+    AGC?: boolean;
+    /**
+     * 是否开启噪声抑制：
+     * - `true`: 开启噪声抑制。
+     * - `false`: 不开启噪声抑制。
+     */
+    /** @en
+     * Whether to enable automatic noise suppression:
+     * - `true`: Enable automatic noise suppression.
+     * - `false`: Do not automatic noise suppression.
+     */
+    ANS?: boolean;
+}
+
 declare class AudioTrackSource extends AudioSource {
     protected sourceNode: MediaStreamAudioSourceNode;
     track: MediaStreamTrack;
@@ -818,11 +860,11 @@ export declare interface CameraVideoTrackInitConfig {
      *
      * @param mode 视频传输优化模式：
      * - `"detail"`: 清晰优先。
-     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
-     *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
-     *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
-     *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
+     *   - 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+     *   - 大部分情况下，浏览器不会降低发送分辨率，但是可能会降低帧率。
+     * - `"motion"`: 自 4.21.0 开始，浏览器默认开启流畅优先模式。
+     *   - 浏览器不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
+     *   - 大部分情况下，浏览器不会降低帧率，但是可能会降低发送分辨率。
      */
     /** @en
      * @since
@@ -836,11 +878,11 @@ export declare interface CameraVideoTrackInitConfig {
      *
      * @param mode The video transmission optimization mode:
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     optimizationMode?: OptimizationMode;
     /**
@@ -962,7 +1004,7 @@ export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfi
 
 export declare function createScreenVideoTrack(config?: ScreenVideoTrackInitConfig, withAudio?: "disable"): Promise<LocalVideoTrack>;
 
-export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfig, withAudio: "auto"): Promise<[LocalVideoTrack, LocalAudioTrack] | LocalVideoTrack>;
+export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfig, withAudio: "auto" | ScreenAudioTrackInitConfig): Promise<[LocalVideoTrack, LocalAudioTrack] | LocalVideoTrack>;
 
 /**
  * 创建自定义音频轨道时的配置参数，用于 [AgoraRTC.createCustomAudioTrack]{@link IAgoraRTC.createCustomAudioTrack}。
@@ -1100,12 +1142,12 @@ export declare interface CustomVideoTrackInitConfig {
      *
      * @param mode 视频传输优化模式：
      * - `"balanced"`: 使用默认的传输优化模式：
-     *   - 对于屏幕共享视频流，SDK 默认的优化策略为清晰优先。
-     *   - 对于其他视频流，SDK 默认的优化策略为兼顾清晰和流畅，弱网条件下，帧率和分辨率都会被调整。
+     *   - 对于屏幕共享视频流，浏览器默认的优化策略为清晰优先。
+     *   - 对于其他视频流，浏览器默认的优化策略为兼顾清晰和流畅，弱网条件下，帧率和分辨率都会被调整。
      * - `"detail"`: 清晰优先。
-     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
-     *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 自 4.21.0开始，SDK 默认开启流畅优先模式
+     *   - 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+     *   - 大部分情况下，浏览器不会降低发送分辨率，但是可能会降低帧率。
+     * - `"motion"`: 自 4.21.0 开始，浏览器默认开启流畅优先模式
      *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
      *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
      */
@@ -1653,10 +1695,14 @@ export declare function getBitrateFromResAndFps(width: number, height: number, f
 
 export declare function getCompatibility(): AgoraRTCCompatibility;
 
+export declare function getConstraintsFromAudioConfig(config: AudioTrackInitConfig): MediaTrackConstraints;
+
 export declare function getConstraintsFromCameraConfig(config: CameraVideoTrackInitConfig): MediaTrackConstraints;
 
 export declare function getConstraintsFromMicrophoneConfig(config: MicrophoneAudioTrackInitConfig): MediaTrackConstraints;
 
+export declare function getConstraintsFromScreenAudioConfig(config: ScreenAudioTrackInitConfig): MediaTrackConstraints;
+
 export declare function getConstraintsFromScreenConfig(config: ScreenVideoTrackInitConfig): ScreenConstraintsWithElectron;
 
 export declare function getElectronScreenSources(type?: ScreenSourceType): Promise<ElectronDesktopCapturerSource[]>;
@@ -1708,8 +1754,7 @@ export declare interface GetUserMediaConfig {
     screen?: ScreenConstraintsWithElectron;
     videoSource?: MediaStreamTrack;
     audioSource?: MediaStreamTrack;
-    /** 是否采集屏幕共享的音频 */
-    screenAudio?: boolean;
+    screenAudio?: boolean | MediaTrackConstraints;
 }
 
 export declare function getVideoEncoderConfiguration(profile: VideoEncoderConfigurationPreset | VideoEncoderConfiguration | undefined): VideoEncoderConfiguration;
@@ -2566,11 +2611,11 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      *   - 对于屏幕共享视频流，SDK 默认的优化策略为清晰优先。
      *   - 对于其他视频流，SDK 默认的优化策略为兼顾清晰和流畅，弱网条件下，帧率和分辨率都会被调整。
      * - `"detail"`: 清晰优先。
-     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+     *   - 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
      *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
-     *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
-     *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
+     * - `"motion"`: 自 4.21.0 开始，浏览器默认开启流畅优先模式。
+     *   - 浏览器不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
+     *   - 大部分情况下，浏览器不会降低帧率，但是可能会降低发送分辨率。
      */
     /** @en
      * @since
@@ -2585,13 +2630,13 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * @param mode The video transmission optimization mode:
      * - `"balanced"`: Uses the default optimization mode.
      *   - For a screen-sharing video track, the default transmission optimization strategy is to prioritizes clarity.
-     *   - For the other types of video tracks, the SDK may reduce the frame rate or the sending resolution in poor network conditions.
+     *   - For the other types of video tracks, the browser may reduce the frame rate or the sending resolution in poor network conditions.
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     setOptimizationMode(mode: "balanced" | "motion" | "detail"): Promise<void>;
     /**
@@ -3937,7 +3982,7 @@ export declare class MicrophoneAudioTrack extends LocalAudioTrack implements IMi
 /** @en
  * Configurations for the audio track from the audio captured by a microphone. Set these configurations when calling [AgoraRTC.createMicrophoneAudioTrack]{@link IAgoraRTC.createMicrophoneAudioTrack}.
  */
-export declare interface MicrophoneAudioTrackInitConfig {
+export declare interface MicrophoneAudioTrackInitConfig extends AudioTrackInitConfig {
     /**
      * 控制音频的编码配置。
      *
@@ -3955,39 +4000,6 @@ export declare interface MicrophoneAudioTrackInitConfig {
      * > Firefox does not support setting the audio encoding rate.
      */
     encoderConfig?: AudioEncoderConfiguration | AudioEncoderConfigurationPreset;
-    /**
-     * 是否开启回声消除：
-     * - `true`: 开启回声消除。
-     * - `false`: 不开启回声消除。
-     */
-    /** @en
-     * Whether to enable acoustic echo cancellation:
-     * - `true`: Enable acoustic echo cancellation.
-     * - `false`: Do not enable acoustic echo cancellation.
-     */
-    AEC?: boolean;
-    /**
-     * 是否开启自动增益：
-     * - `true`: 开启自动增益。
-     * - `false`: 不开启自动增益。
-     */
-    /** @en
-     * Whether to enable audio gain control:
-     * - `true`: Enable audio gain control.
-     * - `false`: Do not enable audio gain control.
-     */
-    AGC?: boolean;
-    /**
-     * 是否开启噪声抑制：
-     * - `true`: 开启噪声抑制。
-     * - `false`: 不开启噪声抑制。
-     */
-    /** @en
-     * Whether to enable automatic noise suppression:
-     * - `true`: Enable automatic noise suppression.
-     * - `false`: Do not automatic noise suppression.
-     */
-    ANS?: boolean;
     /**
      * @ignore
      */
@@ -4030,6 +4042,25 @@ export declare class MixingAudioTrack extends LocalAudioTrack {
     _updateRtpTransceiver(transceiver: RTCRtpTransceiver): void;
 }
 
+/**
+ * 视频传输优化模式：
+ * - `"detail"`: 清晰优先。
+ *   - 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+ *   - 大部分情况下，浏览器不会降低发送分辨率，但是可能会降低帧率。
+ * - `"motion"`: 自 4.21.0 开始，浏览器默认开启流畅优先模式。
+ *   - 浏览器不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
+ *   - 大部分情况下，浏览器不会降低帧率，但是可能会降低发送分辨率。
+ * @public
+ */
+/** @en
+ * The video transmission optimization mode:
+ * - `"detail"`: Prioritizes video quality.
+ *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+ *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+ * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+ *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+ *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
+ */
 export declare type OptimizationMode = "motion" | "detail";
 
 /**
@@ -4563,6 +4594,14 @@ export declare interface Resolution {
  */
 export declare const SAFARI_GLOBAL_GUM_LOCK: PromiseMutex;
 
+/**
+ * 创建屏幕共享音频轨道时的配置参数。当使用 [AgoraRTC.createScreenVideoTrack]{@link IAgoraRTC.createScreenVideoTrack} 创建屏幕共享视频轨道时，可以通过此配置共享音频轨道。
+ */
+/** @en
+ * Configurations for the audio track of screen sharing. Set these configurations when calling [AgoraRTC.createScreenVideoTrack]{@link IAgoraRTC.createScreenVideoTrack} to enable audio during screen sharing.
+ */
+export declare type ScreenAudioTrackInitConfig = AudioTrackInitConfig;
+
 export declare interface ScreenConstraintsWithElectron extends MediaTrackConstraints {
     /**
      * Electron 屏幕共享时用户传入的 sourceID。
@@ -4728,11 +4767,11 @@ export declare interface ScreenVideoTrackInitConfig {
      *
      * @param mode 视频传输优化模式：
      * - `"detail"`: 清晰优先。
-     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
-     *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
-     *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
-     *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
+     *   - 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+     *   - 大部分情况下，浏览器不会降低发送分辨率，但是可能会降低帧率。
+     * - `"motion"`: 自 4.21.0 开始，浏览器默认开启流畅优先模式。
+     *   - 浏览器不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
+     *   - 大部分情况下，浏览器不会降低帧率，但是可能会降低发送分辨率。
      */
     /** @en
      * @since
@@ -4746,11 +4785,11 @@ export declare interface ScreenVideoTrackInitConfig {
      *
      * @param mode The video transmission optimization mode:
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     optimizationMode?: "motion" | "detail";
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agora-js/media",
-	"version": "4.22.1-100",
+	"version": "4.22.2",
 	"description": "media module across @agora-js packages",
 	"main": "AgoraRTC_N-media.js",
 	"module": "AgoraRTC_N-media.esm.mjs",
@@ -23,8 +23,8 @@
 	"homepage": "https://api-ref.agora.io/en/voice-sdk/web/4.x/index.html",
 	"peerDependencies": {},
 	"dependencies": {
-		"@agora-js/shared": "4.22.1-100",
-		"@agora-js/report": "4.22.1-100",
+		"@agora-js/shared": "4.22.2",
+		"@agora-js/report": "4.22.2",
 		"axios": "^1.7.7",
 		"agora-rte-extension": "^1.2.4",
 		"webrtc-adapter": "8.2.0"

package/rtc-sdk-media_en.d.ts

@@ -367,6 +367,30 @@ declare class AudioState extends EventEmitter {
 
 export declare function audioTimerLoop(callback: (time: number) => any, frequency: number): () => void;
 
+/**
+ * Configurations for the audio track of screen sharing.
+ */
+export declare interface AudioTrackInitConfig {
+    /**
+     * Whether to enable acoustic echo cancellation:
+     * - `true`: Enable acoustic echo cancellation.
+     * - `false`: Do not enable acoustic echo cancellation.
+     */
+    AEC?: boolean;
+    /**
+     * Whether to enable audio gain control:
+     * - `true`: Enable audio gain control.
+     * - `false`: Do not enable audio gain control.
+     */
+    AGC?: boolean;
+    /**
+     * Whether to enable automatic noise suppression:
+     * - `true`: Enable automatic noise suppression.
+     * - `false`: Do not automatic noise suppression.
+     */
+    ANS?: boolean;
+}
+
 declare class AudioTrackSource extends AudioSource {
     protected sourceNode: MediaStreamAudioSourceNode;
     track: MediaStreamTrack;
@@ -546,11 +570,11 @@ export declare interface CameraVideoTrackInitConfig {
      *
      * @param mode The video transmission optimization mode:
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     optimizationMode?: OptimizationMode;
     /**
@@ -631,7 +655,7 @@ export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfi
 
 export declare function createScreenVideoTrack(config?: ScreenVideoTrackInitConfig, withAudio?: "disable"): Promise<LocalVideoTrack>;
 
-export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfig, withAudio: "auto"): Promise<[LocalVideoTrack, LocalAudioTrack] | LocalVideoTrack>;
+export declare function createScreenVideoTrack(config: ScreenVideoTrackInitConfig, withAudio: "auto" | ScreenAudioTrackInitConfig): Promise<[LocalVideoTrack, LocalAudioTrack] | LocalVideoTrack>;
 
 /**
  * Configurations for the custom audio track. Set these configurations when calling [AgoraRTC.createCustomAudioTrack]{@link IAgoraRTC.createCustomAudioTrack}.
@@ -1076,10 +1100,14 @@ export declare function getBitrateFromResAndFps(width: number, height: number, f
 
 export declare function getCompatibility(): AgoraRTCCompatibility;
 
+export declare function getConstraintsFromAudioConfig(config: AudioTrackInitConfig): MediaTrackConstraints;
+
 export declare function getConstraintsFromCameraConfig(config: CameraVideoTrackInitConfig): MediaTrackConstraints;
 
 export declare function getConstraintsFromMicrophoneConfig(config: MicrophoneAudioTrackInitConfig): MediaTrackConstraints;
 
+export declare function getConstraintsFromScreenAudioConfig(config: ScreenAudioTrackInitConfig): MediaTrackConstraints;
+
 export declare function getConstraintsFromScreenConfig(config: ScreenVideoTrackInitConfig): ScreenConstraintsWithElectron;
 
 export declare function getElectronScreenSources(type?: ScreenSourceType): Promise<ElectronDesktopCapturerSource[]>;
@@ -1114,7 +1142,7 @@ export declare interface GetUserMediaConfig {
     screen?: ScreenConstraintsWithElectron;
     videoSource?: MediaStreamTrack;
     audioSource?: MediaStreamTrack;
-    screenAudio?: boolean;
+    screenAudio?: boolean | MediaTrackConstraints;
 }
 
 export declare function getVideoEncoderConfiguration(profile: VideoEncoderConfigurationPreset | VideoEncoderConfiguration | undefined): VideoEncoderConfiguration;
@@ -1599,13 +1627,13 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * @param mode The video transmission optimization mode:
      * - `"balanced"`: Uses the default optimization mode.
      *   - For a screen-sharing video track, the default transmission optimization strategy is to prioritizes clarity.
-     *   - For the other types of video tracks, the SDK may reduce the frame rate or the sending resolution in poor network conditions.
+     *   - For the other types of video tracks, the browser may reduce the frame rate or the sending resolution in poor network conditions.
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     setOptimizationMode(mode: "balanced" | "motion" | "detail"): Promise<void>;
     /**
@@ -2437,7 +2465,7 @@ export declare class MicrophoneAudioTrack extends LocalAudioTrack implements IMi
 /**
  * Configurations for the audio track from the audio captured by a microphone. Set these configurations when calling [AgoraRTC.createMicrophoneAudioTrack]{@link IAgoraRTC.createMicrophoneAudioTrack}.
  */
-export declare interface MicrophoneAudioTrackInitConfig {
+export declare interface MicrophoneAudioTrackInitConfig extends AudioTrackInitConfig {
     /**
      * The audio encoder configurations.
      *
@@ -2448,24 +2476,6 @@ export declare interface MicrophoneAudioTrackInitConfig {
      * > Firefox does not support setting the audio encoding rate.
      */
     encoderConfig?: AudioEncoderConfiguration | AudioEncoderConfigurationPreset;
-    /**
-     * Whether to enable acoustic echo cancellation:
-     * - `true`: Enable acoustic echo cancellation.
-     * - `false`: Do not enable acoustic echo cancellation.
-     */
-    AEC?: boolean;
-    /**
-     * Whether to enable audio gain control:
-     * - `true`: Enable audio gain control.
-     * - `false`: Do not enable audio gain control.
-     */
-    AGC?: boolean;
-    /**
-     * Whether to enable automatic noise suppression:
-     * - `true`: Enable automatic noise suppression.
-     * - `false`: Do not automatic noise suppression.
-     */
-    ANS?: boolean;
     /**
      * @ignore
      */
@@ -2496,6 +2506,15 @@ export declare class MixingAudioTrack extends LocalAudioTrack {
     _updateRtpTransceiver(transceiver: RTCRtpTransceiver): void;
 }
 
+/**
+ * The video transmission optimization mode:
+ * - `"detail"`: Prioritizes video quality.
+ *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+ *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+ * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+ *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+ *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
+ */
 export declare type OptimizationMode = "motion" | "detail";
 
 export declare interface PlayerConfig extends VideoPlayerConfig {
@@ -2845,6 +2864,11 @@ export declare interface Resolution {
 
 export declare const SAFARI_GLOBAL_GUM_LOCK: PromiseMutex;
 
+/**
+ * Configurations for the audio track of screen sharing. Set these configurations when calling [AgoraRTC.createScreenVideoTrack]{@link IAgoraRTC.createScreenVideoTrack} to enable audio during screen sharing.
+ */
+export declare type ScreenAudioTrackInitConfig = AudioTrackInitConfig;
+
 export declare interface ScreenConstraintsWithElectron extends MediaTrackConstraints {
     sourceId?: string;
     extensionId?: string;
@@ -2933,11 +2957,11 @@ export declare interface ScreenVideoTrackInitConfig {
      *
      * @param mode The video transmission optimization mode:
      * - `"detail"`: Prioritizes video quality.
-     *   - The SDK ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
-     *   - In most cases, the SDK does not reduce the sending resolution, but may reduce the frame rate.
-     * -  `"motion"`: Since 4.21.0, the SDK prioritizes video smoothness.
-     *   - In poor network conditions, the SDK reduces the sending bitrate to minimize video freezes.
-     *   - In most cases, the SDK does not reduce the frame rate, but may reduce the sending resolution.
+     *   - The browser ensures high-quality images by automatically calculating a minimum bitrate based on the capturing resolution and frame rate. No matter how poor the network condition is, the sending bitrate will never be lower than the minimum value.
+     *   - In most cases, the browser does not reduce the sending resolution, but may reduce the frame rate.
+     * -  `"motion"`: Since v4.21.0, the browser prioritizes video smoothness.
+     *   - In poor network conditions, the browser reduces the sending bitrate to minimize video freezes.
+     *   - In most cases, the browser does not reduce the frame rate, but may reduce the sending resolution.
      */
     optimizationMode?: "motion" | "detail";
     /**