@agora-js/media 4.21.0 → 4.22.0

package/media.d.ts

@@ -808,33 +808,39 @@ export declare interface CameraVideoTrackInitConfig {
     cameraId?: string;
     /**
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * 设置视频传输优化模式。
+     *
+     * 你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 `"detail"` 切换为 `"motion"`，确保视频画面在网络波动时不会出现卡顿。
      *
-     * 传输优化模式。设置该值后，SDK 会自动调整码率配置以及使用不同的回退策略。
+     * > 注意事项：该方法只支持 Chrome 浏览器。
+     *
+     * @param mode 视频传输优化模式：
      * - `"detail"`: 清晰优先。
      *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
      *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 流畅优先。
+     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
      *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
      *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
-     * - 留空: 默认优化策略，兼顾清晰和流畅，也就是说弱网条件下，帧率和分辨率都会被调整。
-     *
-     * > 注意事项：该方法只支持 Chrome 浏览器。
      */
     /** @en
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * Sets the video transmission optimization mode.
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
+     *
+     * > Note: This method supports Chrome only.
+     *
+     * @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"`: Prioritizes video smoothness.
+     * -  `"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.
-     * - Empty: Uses the default transmission optimization mode. The SDK may reduce the frame rate or the sending resolution in poor network conditions.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: OptimizationMode;
     /**
@@ -871,7 +877,7 @@ export declare function checkTrackState(): (target: any, propertyKey: any, descr
  * 可通过以下方法或事件获取：
  * - [localVideoTrack.on("video-element-visible-status")]{@link ILocalVideoTrack.event_video_element_visible_status}
  * - [localVideoTrack.getVideoElementVisibleStatus]{@link ILocalVideoTrack.getVideoElementVisibleStatus}
- * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status}
+ * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status_2}
  * - [remoteVideoTrack.getVideoElementVisibleStatus]{@link IRemoteVideoTrack.getVideoElementVisibleStatus}
  *
  * 包含以下字段：
@@ -888,7 +894,7 @@ export declare function checkTrackState(): (target: any, propertyKey: any, descr
  * Get the visibility of the `<video>` tag through the following methods and events:
  * - [localVideoTrack.on("video-element-visible-status")]{@link ILocalVideoTrack.event_video_element_visible_status}
  * - [localVideoTrack.getVideoElementVisibleStatus]{@link ILocalVideoTrack.getVideoElementVisibleStatus}
- * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status}
+ * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status_2}
  * - [remoteVideoTrack.getVideoElementVisibleStatus]{@link IRemoteVideoTrack.getVideoElementVisibleStatus}
  *
  * This object contains the following parameters:
@@ -1084,33 +1090,45 @@ export declare interface CustomVideoTrackInitConfig {
     bitrateMax?: number;
     /**
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
      *
-     * 传输优化模式。设置该值后，SDK 会自动调整码率配置以及使用不同的回退策略。
+     * 设置视频传输优化模式。
+     *
+     * 你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 `"detail"` 切换为 `"motion"`，确保视频画面在网络波动时不会出现卡顿。
+     *
+     * > 注意事项：该方法只支持 Chrome 浏览器。
+     *
+     * @param mode 视频传输优化模式：
+     * - `"balanced"`: 使用默认的传输优化模式：
+     *   - 对于屏幕共享视频流，SDK 默认的优化策略为清晰优先。
+     *   - 对于其他视频流，SDK 默认的优化策略为兼顾清晰和流畅，弱网条件下，帧率和分辨率都会被调整。
      * - `"detail"`: 清晰优先。
      *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
      *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 流畅优先。
+     * - `"motion"`: 自 4.21.0开始，SDK 默认开启流畅优先模式
      *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
      *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
-     * - 留空: 默认优化策略，兼顾清晰和流畅，也就是说弱网条件下，帧率和分辨率都会被调整。
-     *
-     * > 注意事项：该方法只支持 Chrome 浏览器。
      */
     /** @en
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * Sets the video transmission optimization mode.
+     *
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
+     * > Note: This method supports Chrome only.
+     *
+     * @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.
      * - `"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"`: Prioritizes video smoothness.
+     * -  `"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.
-     * - Empty: Uses the default transmission optimization mode. The SDK may reduce the frame rate or the sending resolution in poor network conditions.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: "motion" | "detail";
     /**
@@ -1138,15 +1156,17 @@ export declare interface CustomVideoTrackInitConfig {
 }
 
 export declare abstract class DataChannel extends EventEmitter implements IDataChannel {
+    readonly trackMediaType: TrackMediaType.DATA;
     private _version;
     private _type;
     _config: IDataChannelConfig;
     /** 原始的 DataChannel 对象 */
     _originDataChannel?: RTCDataChannel;
     protected _dataStreamPacketHeader: ArrayBuffer;
-    protected _dataStreamPacketHandler: DataStream;
+    protected _dataStreamPacketHandler: IDataStream;
     private _datachannelEventMap;
     constructor(config: IDataChannelConfig, datachannel?: RTCDataChannel);
+    useDataStream(dataStream: IDataStream): void;
     get id(): number;
     get ordered(): boolean;
     get maxRetransmits(): number;
@@ -1171,20 +1191,6 @@ export declare enum DataChannelEvents {
     ERROR = "error"
 }
 
-declare class DataStream {
-    private _sequence;
-    private _startTime;
-    private isUseOneByte;
-    private get startTime();
-    private get sequence();
-    serialize(payload: ArrayBuffer): ArrayBuffer;
-    deserialize(packet: ArrayBuffer): ArrayBuffer;
-    private serializeExtension;
-    private deserializeExtension;
-    private decompress;
-    private compress;
-}
-
 export declare function decodeAudioData(buffer: ArrayBuffer): Promise<AudioBuffer>;
 
 export declare const DEFAULT_LOCAL_AUDIO_TRACK_STATS: LocalAudioTrackStats;
@@ -2010,6 +2016,11 @@ export declare interface IDataChannelConfig {
     metadata: string;
 }
 
+declare interface IDataStream {
+    serialize: (payload: ArrayBuffer) => ArrayBuffer;
+    deserialize: (packet: ArrayBuffer) => ArrayBuffer;
+}
+
 /**
  * 基础本地音频轨道，提供了本地音频轨道的主要功能。
  *
@@ -2557,7 +2568,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * - `"detail"`: 清晰优先。
      *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
      *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 流畅优先。
+     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
      *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
      *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
      */
@@ -2578,7 +2589,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * - `"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"`: Prioritizes video smoothness.
+     * -  `"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.
      */
@@ -2871,7 +2882,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      *
      * 设置音频播放设备，比如扬声器。
      *
-     * > 该方法只支持桌面端的 Chrome 和 Edge 浏览器。如果在其他浏览器上需要先设置`RESTRICTION_SET_PLAYBACK_DEVICE`为`false`，直接调用将会抛出 `NOT_SUPPORTED` 错误。
+     * > 该方法只支持桌面端的 Chrome 和 Edge 浏览器，其他浏览器调用将会抛出 `NOT_SUPPORTED` 错误。
      * @param deviceId 设备 ID，可以通过 [[getPlaybackDevices]] 方法获取。
      */
     /** @en
@@ -2880,7 +2891,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      *
      * Sets the audio playback device, for example, the speaker.
      *
-     * > > This method is only supported on desktop Chrome and Edge browsers. If you call it on other browsers, you need to set `RESTRICTION_SET_PLAYBACK_DEVICE` to `false` first, and calling it directly will throw a `NOT_SUPPORTED` error.
+     * > This method supports Chrome and Edge on desktop devices only. Other browsers throw a `NOT_SUPPORTED` error when calling this method.
      * @param deviceId Device ID, which can be retrieved by calling [[getPlaybackDevices]].
      */
     setPlaybackDevice(deviceId: string): Promise<void>;
@@ -3291,6 +3302,8 @@ export { isElectron }
 
 export declare function isLowStreamParameter(streamParameter: any): streamParameter is LowStreamParameter;
 
+export declare function isPlanB(): boolean;
+
 export declare function isScreenSourceType(mediaSource: any): mediaSource is ScreenSourceType;
 
 export declare function isVideoEncoderConfiguration(config: VideoEncoderConfiguration): config is VideoEncoderConfiguration;
@@ -3593,10 +3606,6 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     _player?: AgoraRTCPlayer | VideoPlayer;
     isUseScaleResolutionDownBy: boolean;
     private _videoVisibleTimer;
-    /**
-     * 轮询监听stats
-     */
-    protected _statsTimer: number | null;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
     _encoderConfig?: Partial<VideoEncoderConfiguration>;
@@ -3646,7 +3655,6 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     close(): void;
     clone(config?: VideoEncoderConfiguration | VideoEncoderConfigurationPreset, cloneTrack?: boolean): LocalVideoTrack;
     replaceTrack(track: MediaStreamTrack, stopOldTrack: boolean): Promise<void>;
-    startMonitorStats(): void;
     sendSeiData(sei: Uint8Array): never;
     private bindProcessorDestinationEvents;
     private unbindProcessorDestinationEvents;
@@ -3668,7 +3676,7 @@ export declare interface LocalVideoTrackStats {
      * - `"VP8"`: 视频编码格式为 VP8。
      * - `"VP9"`: 视频编码格式为 VP9。
      * - `"AV1X"`: 预留参数，暂不支持。
-     * - `"AV1"`: 预留参数，暂不支持。
+     * - `"AV1"`: 视频编码格式为 AV1。
      *
      * > Firefox 上无法获取该值。
      */
@@ -3679,7 +3687,7 @@ export declare interface LocalVideoTrackStats {
      * - `"VP8"`: The video codec is VP8.
      * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
-     * - `"AV1"`: Reserved for future use.
+     * - `"AV1"`: The video codec is AV1.
      *
      * > You can not get this property on Firefox.
      */
@@ -4057,7 +4065,7 @@ export declare interface ProcessorUsageStats {
 }
 
 export declare class RemoteAudioTrack extends RemoteTrack implements IRemoteAudioTrack {
-    readonly trackMediaType: "audio" | "video";
+    readonly trackMediaType: TrackMediaType.AUDIO;
     _source: AudioTrackSource | FakeTrackSource;
     _useAudioElement: boolean;
     private _volume;
@@ -4192,6 +4200,13 @@ export declare interface RemoteAudioTrackStats {
      * The total number of lost audio packets that should be received.
      */
     receivePacketsLost: number;
+    /**
+     * 因过早或过晚到达抖动缓冲器而被丢弃的数据包数量。
+     */
+    /** @en
+     * The number of packets discarded by the jitter buffer due to early or late arrival.
+     */
+    receivePacketsDiscarded: number;
     /**
      * 接收的音频总丢包率。
      */
@@ -4315,7 +4330,7 @@ export declare class RemoteVideoTrack extends RemoteTrack implements IRemoteVide
     private _videoVisibleTimer;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
-    readonly trackMediaType: "audio" | "video";
+    readonly trackMediaType: TrackMediaType.VIDEO;
     _videoWidth?: number;
     _videoHeight?: number;
     _player?: AgoraRTCPlayer | VideoPlayer;
@@ -4376,7 +4391,7 @@ export declare interface RemoteVideoTrackStats {
      * - `"VP8"`: The video codec is VP8.
      * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
-     * - `"AV1"`: Reserved for future use.
+     * - `"AV1"`: The video codec is AV1.
      *
      * > You can not get this property on Firefox.
      */
@@ -4684,31 +4699,39 @@ export declare interface ScreenVideoTrackInitConfig {
     screenSourceType?: ScreenSourceType;
     /**
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
      *
-     * 传输优化模式。设置该值后，SDK 会自动调整码率配置以及使用不同的回退策略。
-     * - `"motion"`: 流畅优先。
-     *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
-     *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
-     * - `"detail"`: （默认）清晰优先。
-     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
-     *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
+     * 设置视频传输优化模式。
+     *
+     * 你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 `"detail"` 切换为 `"motion"`，确保视频画面在网络波动时不会出现卡顿。
      *
      * > 注意事项：该方法只支持 Chrome 浏览器。
+     *
+     * @param mode 视频传输优化模式：
+     * - `"detail"`: 清晰优先。
+     *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
+     *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
+     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
+     *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
+     *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
      */
     /** @en
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
-     * - `"detail"`: (Default) Prioritizes video quality.
+     * Sets the video transmission optimization mode.
+     *
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
+     *
+     * > Note: This method supports Chrome only.
+     *
+     * @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"`: Prioritizes video smoothness.
+     * -  `"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.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: "motion" | "detail";
     /**
@@ -5038,6 +5061,12 @@ export declare enum TrackInternalEvent {
     NEED_UNMUTE_TRACK = "@need_unmute_track"
 }
 
+export declare enum TrackMediaType {
+    AUDIO = "audio",
+    VIDEO = "video",
+    DATA = "data"
+}
+
 export declare function updateAgoraRTCCompatibility(): void;
 
 export declare interface UsageRegistry {

package/package.json

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

package/rtc-sdk-media_en.d.ts

@@ -536,18 +536,21 @@ export declare interface CameraVideoTrackInitConfig {
     cameraId?: string;
     /**
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * Sets the video transmission optimization mode.
+     *
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
+     * > Note: This method supports Chrome only.
+     *
+     * @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"`: Prioritizes video smoothness.
+     * -  `"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.
-     * - Empty: Uses the default transmission optimization mode. The SDK may reduce the frame rate or the sending resolution in poor network conditions.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: OptimizationMode;
     /**
@@ -575,7 +578,7 @@ export declare function checkTrackState(): (target: any, propertyKey: any, descr
  * Get the visibility of the `<video>` tag through the following methods and events:
  * - [localVideoTrack.on("video-element-visible-status")]{@link ILocalVideoTrack.event_video_element_visible_status}
  * - [localVideoTrack.getVideoElementVisibleStatus]{@link ILocalVideoTrack.getVideoElementVisibleStatus}
- * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status}
+ * - [remoteVideoTrack.on("video-element-visible-status")]{@link IRemoteVideoTrack.event_video_element_visible_status_2}
  * - [remoteVideoTrack.getVideoElementVisibleStatus]{@link IRemoteVideoTrack.getVideoElementVisibleStatus}
  *
  * This object contains the following parameters:
@@ -701,18 +704,24 @@ export declare interface CustomVideoTrackInitConfig {
     bitrateMax?: number;
     /**
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
+     * Sets the video transmission optimization mode.
+     *
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
+     *
+     * > Note: This method supports Chrome only.
+     *
+     * @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.
      * - `"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"`: Prioritizes video smoothness.
+     * -  `"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.
-     * - Empty: Uses the default transmission optimization mode. The SDK may reduce the frame rate or the sending resolution in poor network conditions.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: "motion" | "detail";
     /**
@@ -731,14 +740,16 @@ export declare interface CustomVideoTrackInitConfig {
 }
 
 export declare abstract class DataChannel extends EventEmitter implements IDataChannel {
+    readonly trackMediaType: TrackMediaType.DATA;
     private _version;
     private _type;
     _config: IDataChannelConfig;
     _originDataChannel?: RTCDataChannel;
     protected _dataStreamPacketHeader: ArrayBuffer;
-    protected _dataStreamPacketHandler: DataStream;
+    protected _dataStreamPacketHandler: IDataStream;
     private _datachannelEventMap;
     constructor(config: IDataChannelConfig, datachannel?: RTCDataChannel);
+    useDataStream(dataStream: IDataStream): void;
     get id(): number;
     get ordered(): boolean;
     get maxRetransmits(): number;
@@ -763,20 +774,6 @@ export declare enum DataChannelEvents {
     ERROR = "error"
 }
 
-declare class DataStream {
-    private _sequence;
-    private _startTime;
-    private isUseOneByte;
-    private get startTime();
-    private get sequence();
-    serialize(payload: ArrayBuffer): ArrayBuffer;
-    deserialize(packet: ArrayBuffer): ArrayBuffer;
-    private serializeExtension;
-    private deserializeExtension;
-    private decompress;
-    private compress;
-}
-
 export declare function decodeAudioData(buffer: ArrayBuffer): Promise<AudioBuffer>;
 
 export declare const DEFAULT_LOCAL_AUDIO_TRACK_STATS: LocalAudioTrackStats;
@@ -1297,6 +1294,11 @@ export declare interface IDataChannelConfig {
     metadata: string;
 }
 
+declare interface IDataStream {
+    serialize: (payload: ArrayBuffer) => ArrayBuffer;
+    deserialize: (packet: ArrayBuffer) => ArrayBuffer;
+}
+
 /**
  * `LocalAudioTrack` is the basic interface for local audio tracks, providing main methods of local audio tracks.
  *
@@ -1601,7 +1603,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * - `"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"`: Prioritizes video smoothness.
+     * -  `"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.
      */
@@ -1769,7 +1771,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      *
      * Sets the audio playback device, for example, the speaker.
      *
-     * > > This method is only supported on desktop Chrome and Edge browsers. If you call it on other browsers, you need to set `RESTRICTION_SET_PLAYBACK_DEVICE` to `false` first, and calling it directly will throw a `NOT_SUPPORTED` error.
+     * > This method supports Chrome and Edge on desktop devices only. Other browsers throw a `NOT_SUPPORTED` error when calling this method.
      * @param deviceId Device ID, which can be retrieved by calling [[getPlaybackDevices]].
      */
     setPlaybackDevice(deviceId: string): Promise<void>;
@@ -2002,6 +2004,8 @@ export { isElectron }
 
 export declare function isLowStreamParameter(streamParameter: any): streamParameter is LowStreamParameter;
 
+export declare function isPlanB(): boolean;
+
 export declare function isScreenSourceType(mediaSource: any): mediaSource is ScreenSourceType;
 
 export declare function isVideoEncoderConfiguration(config: VideoEncoderConfiguration): config is VideoEncoderConfiguration;
@@ -2206,7 +2210,6 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     _player?: AgoraRTCPlayer | VideoPlayer;
     isUseScaleResolutionDownBy: boolean;
     private _videoVisibleTimer;
-    protected _statsTimer: number | null;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
     _encoderConfig?: Partial<VideoEncoderConfiguration>;
@@ -2256,7 +2259,6 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     close(): void;
     clone(config?: VideoEncoderConfiguration | VideoEncoderConfigurationPreset, cloneTrack?: boolean): LocalVideoTrack;
     replaceTrack(track: MediaStreamTrack, stopOldTrack: boolean): Promise<void>;
-    startMonitorStats(): void;
     sendSeiData(sei: Uint8Array): never;
     private bindProcessorDestinationEvents;
     private unbindProcessorDestinationEvents;
@@ -2274,7 +2276,7 @@ export declare interface LocalVideoTrackStats {
      * - `"VP8"`: The video codec is VP8.
      * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
-     * - `"AV1"`: Reserved for future use.
+     * - `"AV1"`: The video codec is AV1.
      *
      * > You can not get this property on Firefox.
      */
@@ -2521,7 +2523,7 @@ export declare interface ProcessorUsageStats {
 }
 
 export declare class RemoteAudioTrack extends RemoteTrack implements IRemoteAudioTrack {
-    readonly trackMediaType: "audio" | "video";
+    readonly trackMediaType: TrackMediaType.AUDIO;
     _source: AudioTrackSource | FakeTrackSource;
     _useAudioElement: boolean;
     private _volume;
@@ -2607,6 +2609,10 @@ export declare interface RemoteAudioTrackStats {
      * The total number of lost audio packets that should be received.
      */
     receivePacketsLost: number;
+    /**
+     * The number of packets discarded by the jitter buffer due to early or late arrival.
+     */
+    receivePacketsDiscarded: number;
     /**
      * The packet loss rate of the received audio.
      */
@@ -2698,7 +2704,7 @@ export declare class RemoteVideoTrack extends RemoteTrack implements IRemoteVide
     private _videoVisibleTimer;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
-    readonly trackMediaType: "audio" | "video";
+    readonly trackMediaType: TrackMediaType.VIDEO;
     _videoWidth?: number;
     _videoHeight?: number;
     _player?: AgoraRTCPlayer | VideoPlayer;
@@ -2739,7 +2745,7 @@ export declare interface RemoteVideoTrackStats {
      * - `"VP8"`: The video codec is VP8.
      * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
-     * - `"AV1"`: Reserved for future use.
+     * - `"AV1"`: The video codec is AV1.
      *
      * > You can not get this property on Firefox.
      */
@@ -2905,17 +2911,21 @@ export declare interface ScreenVideoTrackInitConfig {
     screenSourceType?: ScreenSourceType;
     /**
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
-     * - `"detail"`: (Default) Prioritizes video quality.
+     * Sets the video transmission optimization mode.
+     *
+     * You can call this method during a video call, a live streaming or screen sharing to dynamically change the optimization mode. For example, during the screen sharing, before you change the shared content from text to video, you can change the optimization mode from `"detail"` to `"motion"` to ensure smoothness in poor network conditions.
+     *
+     * > Note: This method supports Chrome only.
+     *
+     * @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"`: Prioritizes video smoothness.
+     * -  `"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.
-     *
-     * > Note: This method is only supported on Chrome.
      */
     optimizationMode?: "motion" | "detail";
     /**
@@ -3136,6 +3146,12 @@ export declare enum TrackInternalEvent {
     NEED_UNMUTE_TRACK = "@need_unmute_track"
 }
 
+export declare enum TrackMediaType {
+    AUDIO = "audio",
+    VIDEO = "video",
+    DATA = "data"
+}
+
 export declare function updateAgoraRTCCompatibility(): void;
 
 export declare interface UsageRegistry {