@agora-js/media 4.20.2 → 4.22.0

package/media.d.ts

@@ -56,6 +56,10 @@ export declare interface AgoraRTCCompatibility {
     supportWebRTCEncodedTransform: boolean;
     /** 是否支持WebRTC Insertable Stream */
     supportWebRTCInsertableStream: boolean;
+    /** 是否支持requestVideoFrameCallback, 用于计算卡顿率 */
+    supportRequestVideoFrameCallback: boolean;
+    /** 是否支持WebCrypto */
+    supportWebCrypto: boolean;
 }
 
 /**
@@ -331,7 +335,7 @@ export declare interface AudioEncoderConfiguration {
  * | -------- | --------------- |
  * |`"speech_low_quality"`|16 kHz 采样率，单声道，编码码率约 24 Kbps|
  * |`"speech_standard"`|32 kHz 采样率，单声道，编码码率约 24 Kbps|
- * |`"music_standard"`|48 kHz 采样率，单声道，编码码率约 40 Kbps|
+ * |`"music_standard"`|48 kHz 采样率，单声道，编码码率约 32 Kbps|
  * |`"standard_stereo"`|48 kHz 采样率，双声道，编码码率约 64 Kbps|
  * |`"high_quality"`|48 kHz 采样率，单声道， 编码码率约 128 Kbps|
  * |`"high_quality_stereo"`|48 kHz 采样率，双声道，编码码率约 192 Kbps|
@@ -349,12 +353,12 @@ export declare interface AudioEncoderConfiguration {
  *
  * | Audio Profile | Configurations |
  * | -------- | --------------- |
- * |`"speech_low_quality"`|Sample rate 16 kHz, mono, encoding rate 24 Kbps|
- * |`"speech_standard"`|Sample rate 32 kHz, mono, encoding rate 24 Kbps|
- * |`"music_standard"`|Sample rate 48 kHz, mono, encoding rate 40 Kbps|
- * |`"standard_stereo"`|Sample rate 48 kHz, stereo, encoding rate 64 Kbps|
- * |`"high_quality"`|Sample rate 48 kHz, mono, encoding rate 128 Kbps|
- * |`"high_quality_stereo"`|Sample rate 48 kHz, stereo, encoding rate 192 Kbps| Kbps.
+ * |`"speech_low_quality"`|Sample rate 16 kHz, mono, encoding bitrate 24 Kbps|
+ * |`"speech_standard"`|Sample rate 32 kHz, mono, encoding bitrate 24 Kbps|
+ * |`"music_standard"`|Sample rate 48 kHz, mono, encoding bitrate 32 Kbps|
+ * |`"standard_stereo"`|Sample rate 48 kHz, stereo, encoding bitrate 64 Kbps|
+ * |`"high_quality"`|Sample rate 48 kHz, mono, encoding bitrate 128 Kbps|
+ * |`"high_quality_stereo"`|Sample rate 48 kHz, stereo, encoding bitrate 192 Kbps| Kbps.
  * @public
  */
 export declare type AudioEncoderConfigurationPreset = keyof typeof AUDIO_ENCODER_CONFIG_SETTINGS;
@@ -730,7 +734,7 @@ export declare class CameraVideoTrack extends LocalVideoTrack implements ICamera
     _enabled: boolean;
     _deviceName: string;
     get __className__(): string;
-    constructor(track: MediaStreamTrack, config: CameraVideoTrackInitConfig, constraints: MediaTrackConstraints, scalabilityConfig?: SVCConfiguration, optimizationMode?: "motion" | "detail" | "balanced", trackId?: string);
+    constructor(track: MediaStreamTrack, config: CameraVideoTrackInitConfig, constraints: MediaTrackConstraints, scalabilityConfig?: SVCConfiguration, optimizationMode?: OptimizationMode | "balanced", trackId?: string);
     setDevice(deviceId: string | RequiredOnlyOneOf<{
         facingMode: VideoFacingModeEnum;
         deviceId: string;
@@ -804,35 +808,41 @@ export declare interface CameraVideoTrackInitConfig {
     cameraId?: string;
     /**
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * 设置视频传输优化模式。
+     *
+     * 你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 `"detail"` 切换为 `"motion"`，确保视频画面在网络波动时不会出现卡顿。
+     *
+     * > 注意事项：该方法只支持 Chrome 浏览器。
      *
-     * 传输优化模式。设置该值后，SDK 会自动调整码率配置以及使用不同的回退策略。
+     * @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.
+     *
+     * 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.
      *
-     * Transmission optimization mode. Whether to prioritize video quality or smoothness:
+     * @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?: "motion" | "detail";
+    optimizationMode?: OptimizationMode;
     /**
      * @ignore
      * @自从
@@ -867,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}
  *
  * 包含以下字段：
@@ -884,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:
@@ -1080,33 +1090,45 @@ export declare interface CustomVideoTrackInitConfig {
     bitrateMax?: number;
     /**
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.0.0*
+     * <br>&emsp;&emsp;&emsp;*4.2.0*
+     *
+     * 设置视频传输优化模式。
+     *
+     * 你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 `"detail"` 切换为 `"motion"`，确保视频画面在网络波动时不会出现卡顿。
      *
-     * 传输优化模式。设置该值后，SDK 会自动调整码率配置以及使用不同的回退策略。
+     * > 注意事项：该方法只支持 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";
     /**
@@ -1134,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;
@@ -1167,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;
@@ -1200,6 +1210,13 @@ export declare interface DenoiserStats {
     vl: number;
 }
 
+/**
+ * 是否支持Audio标签 setSinkId
+ * Firefox 116 以上也支持此接口，但是会出现回声问题
+ * 仅支持PC 端 Chrome / Edge，且不支持移动端
+ */
+export declare function detectSupportAudioElementSetSinkId(): boolean;
+
 /**
  * 音视频采集设备的信息。
  *
@@ -1430,6 +1447,18 @@ declare function event_source_state_change(currentState: AudioSourceState): void
  */
 declare function event_track_ended(): void;
 
+/**
+ * 媒体轨道有更新时触发。
+ * @param track 媒体轨道。详见 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack)。
+ * @event
+ */
+/** @en
+ * Triggers when a media track is updated.
+ * @param track The media stream track. See [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack).
+ * @event
+ */
+export declare function event_track_updated(track: MediaStreamTrack): void;
+
 /**
  * 当前轨道的 `RTCRtpTransceiver` 实例更新回调。
  *
@@ -1614,6 +1643,14 @@ export declare function getAudioEncoderConfiguration(profile: AudioEncoderConfig
 
 export declare function getBitrateConstrainRange(width: number, height: number, frameRate: number, bitrateMin?: number, bitrateMax?: number): DoubleRange;
 
+/**
+ * get bitrate, use STANDARD_BITRATE to make sure the response
+ * @param width
+ * @param height
+ * @param fps
+ */
+export declare function getBitrateFromResAndFps(width: number, height: number, fps: number): Required<DoubleRange>;
+
 export declare function getCompatibility(): AgoraRTCCompatibility;
 
 export declare function getConstraintsFromCameraConfig(config: CameraVideoTrackInitConfig): MediaTrackConstraints;
@@ -1630,6 +1667,22 @@ export declare function getElectronScreenStreamByUserSelect(config: ScreenConstr
 
 export declare function getLocalStream(config: GetUserMediaConfig, id: string): Promise<MediaStream>;
 
+/**
+ * 获取初始配置
+ * 分辨率：track.getMediaStreamTrackSettings > 客户设置
+ * 帧率: track.getMediaStreamTrackSettings > 客户设置
+ * 码率： 客户设置 > 根据分辨率计算
+ *
+ * ⚠️：理论上不存在没有分辨率的情况，如果出现不足任何处理
+ */
+export declare const getOriginSenderConfig: (track: LocalVideoTrack) => {
+    frameRate: number;
+    bitrateMax: number;
+    bitrateMin: number;
+    scaleResolutionDownBy: number;
+    scale: number;
+};
+
 export declare function getScalabilityConfiguration(profile: SVCConfiguration | SVCConfigurationPreset): SVCConfiguration;
 
 export declare function getScreenEncoderConfiguration(profile: VideoEncoderConfiguration | ScreenEncoderConfigurationPreset | string): VideoEncoderConfiguration;
@@ -1963,6 +2016,11 @@ export declare interface IDataChannelConfig {
     metadata: string;
 }
 
+declare interface IDataStream {
+    serialize: (payload: ArrayBuffer) => ArrayBuffer;
+    deserialize: (packet: ArrayBuffer) => ArrayBuffer;
+}
+
 /**
  * 基础本地音频轨道，提供了本地音频轨道的主要功能。
  *
@@ -2166,6 +2224,15 @@ export declare interface ILocalDataChannel extends IDataChannel {
  * `LocalTrack` is the basic interface for local tracks, providing public methods for [LocalAudioTrack]{@link ILocalAudioTrack} and [LocalVideoTrack]{@link ILocalVideoTrack}.
  */
 export declare interface ILocalTrack extends ITrack {
+    /**
+     * @param event 事件名称。
+     * @param listener 详见 [track-updated]{@link event_track_updated}。
+     */
+    /** @en
+     * @param event The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event 事件名称。
      * @param listener 详见 [track-ended]{@link event_track_ended}。
@@ -2319,6 +2386,15 @@ export declare interface ILocalTrack extends ITrack {
  * Inherited from `LocalVideoTrack`, [CameraVideoTrack]{@link ICameraVideoTrack} is an interface for the video captured by a local camera and adds several camera-related functions.
  */
 export declare interface ILocalVideoTrack extends ILocalTrack {
+    /**
+     * @param event 事件名称。
+     * @param listener 详见 [track-updated]{@link event_track_updated}。
+     */
+    /** @en
+     * @param event The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /** @internal */
     on(event: "beauty-effect-overload", listener: typeof event_beauty_effect_overload): void;
     /**
@@ -2492,7 +2568,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
      * - `"detail"`: 清晰优先。
      *   - SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
      *   - 大部分情况下，SDK 不会降低发送分辨率，但是可能会降低帧率。
-     * - `"motion"`: 流畅优先。
+     * - `"motion"`: 自 4.21.0 开始，SDK 默认开启流畅优先模式。
      *   - SDK 不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
      *   - 大部分情况下，SDK 不会降低帧率，但是可能会降低发送分辨率。
      */
@@ -2513,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.
      */
@@ -2961,6 +3037,15 @@ export declare interface IRemoteDataChannel extends IDataChannel {
  * `RemoteTrack` is the basic interface for remote tracks, providing public methods for [RemoteAudioTrack]{@link IRemoteAudioTrack} and [RemoteVideoTrack]{@link IRemoteVideoTrack}.
  */
 export declare interface IRemoteTrack extends ITrack {
+    /**
+     * @param event 事件名称。
+     * @param listener 详见 [track-updated]{@link event_track_updated}。
+     */
+    /** @en
+     * @param event The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event 事件名称。
      * @param listener 详见 [first-frame-decoded]{@link event_first_frame_decoded}。
@@ -3020,6 +3105,15 @@ export declare interface IRemoteTrack extends ITrack {
  * You can get create a remote video track by the [AgoraRTCRemoteUser.videoTrack]{@link IAgoraRTCRemoteUser.videoTrack} object after calling [subscribe]{@link IAgoraRTCClient.subscribe}.
  */
 export declare interface IRemoteVideoTrack extends IRemoteTrack {
+    /**
+     * @param event 事件名称。
+     * @param listener 详见 [track-updated]{@link event_track_updated}。
+     */
+    /** @en
+     * @param event The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event 事件名称。
      * @param listener 详见 [video-state-changed]{@link event_video_state_changed}。
@@ -3128,7 +3222,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
      * 调用 `remoteVideoTrack.play` 后 SDK 会创建 [HTML `<video>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video) 标签用于播放视频轨道。当 `remoteVideoTrack.isPlaying` 为 `true` 却看不到图像时，你可调用该方法进行问题排查。
      *
      * @return [[CheckVideoVisibleResult]] 对象。如果该方法返回 `undefined`，可能为以下原因：
-     * - `localRemoteTrack.isPlaying` 为 `false`。
+     * - `remoteVideoTrack.isPlaying` 为 `false`。
      * - `<video>` 标签不存在。
      * - `<video>` 标签不是通过 `play` 方法调用产生的。
      */
@@ -3141,7 +3235,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
      * After you call `remoteVideoTrack.play`, the SDK creates an [`<video>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video) tag for playing video tracks. When `remoteVideoTrack.isPlaying` is `true` but you cannot see any video, call this method to check whether the `<video>` tag is visible or not and learn the reason when the `<video>` tag is invisible.
      *
      * @returns The [[CheckVideoVisibleResult]] object. If this method returns `undefined`, it may be due to the following reasons:
-     * - `localRemoteTrack.isPlaying` is `false`.
+     * - `remoteVideoTrack.isPlaying` is `false`.
      * - The `<video>` tag does not exist.
      * - The `<video>` tag is not created by calling the `play` method.
      */
@@ -3208,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;
@@ -3478,7 +3574,7 @@ export declare abstract class LocalTrack extends Track implements ILocalTrack {
     protected processor?: IBaseProcessor;
     protected abstract _processorContext: IProcessorContext | undefined;
     protected get processorContext(): IProcessorContext | undefined;
-    abstract processorDestination: IBaseProcessor;
+    abstract get processorDestination(): IBaseProcessor;
     constructor(track: MediaStreamTrack, trackId?: string);
     abstract getStats(): LocalVideoTrackStats | LocalAudioTrackStats;
     abstract setMuted(enabled: boolean): Promise<void>;
@@ -3510,29 +3606,28 @@ 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>;
     _scalabilityMode?: SVCConfiguration;
-    _optimizationMode?: "motion" | "detail" | "balanced";
-    _videoHeight?: number;
-    _videoWidth?: number;
+    _optimizationMode?: OptimizationMode | "balanced";
+    private _videoHeight?;
+    private _videoWidth?;
+    get videoHeight(): number | undefined;
+    get videoWidth(): number | undefined;
     _forceBitrateLimit?: {
         max_bitrate: number;
         min_bitrate: number;
     };
     _enabled: boolean;
     get isPlaying(): boolean;
-    processorDestination: VideoProcessorDestination;
+    protected _processorDestination: VideoProcessorDestination;
+    get processorDestination(): VideoProcessorDestination;
     protected _processorContext: VideoProcessorContext;
     protected get processorContext(): VideoProcessorContext;
     protected set processorContext(ctx: VideoProcessorContext);
     get __className__(): string;
-    constructor(track: MediaStreamTrack, encoderConfig?: Partial<VideoEncoderConfiguration>, scalabilityConfig?: SVCConfiguration, optimizationMode?: "motion" | "detail" | "balanced", trackId?: string, hints?: TrackHint[]);
+    constructor(track: MediaStreamTrack, encoderConfig?: Partial<VideoEncoderConfiguration>, scalabilityConfig?: SVCConfiguration, optimizationMode?: OptimizationMode | "balanced", trackId?: string, hints?: TrackHint[]);
     play(element: HTMLElement | HTMLVideoElement | string, config?: VideoPlayerConfig): void;
     stop(): void;
     setEnabled(enabled: boolean, skipChangeState?: boolean): Promise<void>;
@@ -3546,7 +3641,7 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
         max_bitrate: number;
         min_bitrate: number;
     }): Promise<void>;
-    setOptimizationMode(mode: "motion" | "detail" | "balanced"): Promise<void>;
+    setOptimizationMode(mode: OptimizationMode | "balanced"): Promise<void>;
     setScalabiltyMode(mode: SVCConfiguration): void;
     updateMediaStreamTrackResolution(): void;
     protected _updatePlayerSource(): void;
@@ -3560,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;
@@ -3582,7 +3676,7 @@ export declare interface LocalVideoTrackStats {
      * - `"VP8"`: 视频编码格式为 VP8。
      * - `"VP9"`: 视频编码格式为 VP9。
      * - `"AV1X"`: 预留参数，暂不支持。
-     * - `"AV1"`: 预留参数，暂不支持。
+     * - `"AV1"`: 视频编码格式为 AV1。
      *
      * > Firefox 上无法获取该值。
      */
@@ -3593,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.
      */
@@ -3936,6 +4030,8 @@ export declare class MixingAudioTrack extends LocalAudioTrack {
     _updateRtpTransceiver(transceiver: RTCRtpTransceiver): void;
 }
 
+export declare type OptimizationMode = "motion" | "detail";
+
 /**
  * @internal
  */
@@ -3969,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;
@@ -4104,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;
     /**
      * 接收的音频总丢包率。
      */
@@ -4227,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;
@@ -4288,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.
      */
@@ -4596,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*
+     *
+     * 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:
-     * - `"detail"`: (Default) Prioritizes video quality.
+     * > 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";
     /**
@@ -4751,6 +4862,12 @@ export declare interface ScreenVideoTrackInitConfig {
     systemAudio?: "include" | "exclude";
 }
 
+export declare type SenderConfig = {
+    bitrateMax: number;
+    bitrateMin: number;
+    scaleResolutionDownBy: number;
+};
+
 /**
  * 将节点输入的 AudioBuffer 返回，将节点输出的 AudioBuffer 设置成 silence
  */
@@ -4889,7 +5006,9 @@ export declare abstract class Track extends EventEmitter implements ITrack {
     /** 原始的 Track 对象，来自于采集/用户传入/订阅返回 */
     _originMediaStreamTrack: MediaStreamTrack;
     /** 用于播放和发布的 Track 对象，可能被各种模块修改，一般来说等于 `_originMediaStreamTrack` */
-    _mediaStreamTrack: MediaStreamTrack;
+    mediaStreamTrack: MediaStreamTrack;
+    set _mediaStreamTrack(track: MediaStreamTrack);
+    get _mediaStreamTrack(): MediaStreamTrack;
     /** 提供给外部插件以同步数据 */
     _external: ExternalMethods;
     constructor(track: MediaStreamTrack, trackId?: string);
@@ -4907,7 +5026,8 @@ export declare abstract class Track extends EventEmitter implements ITrack {
 export declare enum TrackEvents {
     TRANSCEIVER_UPDATED = "transceiver-updated",
     SEI_TO_SEND = "sei-to-send",
-    SEI_RECEIVED = "sei-received"
+    SEI_RECEIVED = "sei-received",
+    TRACK_UPDATED = "track-updated"
 }
 
 /**
@@ -4923,7 +5043,7 @@ export declare enum TrackHint {
 }
 
 export declare enum TrackInternalEvent {
-    NEED_RENEGOTIATE = "@need_renegotiate",
+    NEED_RENEGOTIATE = "@need_renegotiate",//deprecated
     NEED_REPLACE_TRACK = "@need_replace_track",
     NEED_REPLACE_MIXING_TRACK = "@need_replace_mixing_track",
     NEED_CLOSE = "@need_close",
@@ -4934,12 +5054,19 @@ export declare enum TrackInternalEvent {
     GET_STATS = "@get_stats",
     GET_RTC_STATS = "@get_rtc_stats",
     GET_LOW_VIDEO_TRACK = "@get_low_video_track",
-    NEED_RESET_REMOTE_SDP = "@need_reset_remote_sdp",
+    NEED_RESET_REMOTE_SDP = "@need_reset_remote_sdp",//deprecated
     NEED_UPDATE_VIDEO_ENCODER = "@need_update_video_encoder",
+    NEED_UPDATE_VIDEO_SEND_PARAMETERS = "@need_update_video_send_parameters",
     NEED_MUTE_TRACK = "@need_mute_track",
     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 {
@@ -5044,50 +5171,50 @@ export declare interface VideoEncoderConfiguration {
  *
  * 下表列出了 SDK 所有内置的视频属性配置，SDK 默认使用 `"480p_1"`。
  *
- * | 视频属性 | 分辨率（宽×高） | 帧率（fps） | 码率（Kbps） | Chrome | Firefox | Safari |
- * | -------- | --------------- | ----------- | ------------ | ------ | ------- | ------ |
- * | 120p     | 160 × 120       | 15          | 65           | ✓      |         |        |
- * | 120p_1   | 160 × 120       | 15          | 65           | ✓      |         |        |
- * | 120p_3   | 120 × 120       | 15          | 50           | ✓      |         |        |
- * | 180p     | 320 × 180       | 15          | 140          | ✓      |         |        |
- * | 180p_1   | 320 × 180       | 15          | 140          | ✓      |         |        |
- * | 180p_3   | 180 × 180       | 15          | 100          | ✓      |         |        |
- * | 180p_4   | 240 × 180       | 15          | 120          | ✓      |         |        |
- * | 240p     | 320 × 240       | 15          | 200          | ✓      |         |        |
- * | 240p_1   | 320 × 240       | 15          | 200          | ✓      |         |        |
- * | 240p_3   | 240 × 240       | 15          | 140          | ✓      |         |        |
- * | 240p_4   | 424 × 240       | 15          | 220          | ✓      |         |        |
- * | 360p     | 640 × 360       | 15          | 400          | ✓      |         |        |
- * | 360p_1   | 640 × 360       | 15          | 400          | ✓      |         |        |
- * | 360p_3   | 360 × 360       | 15          | 260          | ✓      |         |        |
- * | 360p_4   | 640 × 360       | 30          | 600          | ✓      |         |        |
- * | 360p_6   | 360 × 360       | 30          | 400          | ✓      |         |        |
- * | 360p_7   | 480 × 360       | 15          | 320          | ✓      |         |        |
- * | 360p_8   | 480 × 360       | 30          | 490          | ✓      |         |        |
- * | 360p_9   | 640 × 360       | 15          | 800          | ✓      |         |        |
- * | 360p_10  | 640 × 360       | 24          | 800          | ✓      |         |        |
- * | 360p_11  | 640 × 360       | 24          | 1000         | ✓      |         |        |
- * | 480p     | 640 × 480       | 15          | 500          | ✓      | ✓       | ✓      |
- * | 480p_1   | 640 × 480       | 15          | 500          | ✓      | ✓       | ✓      |
- * | 480p_2   | 640 × 480       | 30          | 1000         | ✓      | ✓       | ✓      |
- * | 480p_3   | 480 × 480       | 15          | 400          | ✓      | ✓       | ✓      |
- * | 480p_4   | 640 × 480       | 30          | 750          | ✓      | ✓       | ✓      |
- * | 480p_6   | 480 × 480       | 30          | 600          | ✓      | ✓       | ✓      |
- * | 480p_8   | 848 × 480       | 15          | 610          | ✓      | ✓       | ✓      |
- * | 480p_9   | 848 × 480       | 30          | 930          | ✓      | ✓       | ✓      |
- * | 480p_10  | 640 × 480       | 10          | 400          | ✓      | ✓       | ✓      |
- * | 720p     | 1280 × 720      | 15          | 1130         | ✓      | ✓       | ✓      |
- * | 720p_1   | 1280 × 720      | 15          | 1130         | ✓      | ✓       | ✓      |
- * | 720p_2   | 1280 × 720      | 30          | 2000         | ✓      | ✓       | ✓      |
- * | 720p_3   | 1280 × 720      | 30          | 1710         | ✓      | ✓       | ✓      |
- * | 720p_auto <sup>①</sup>  | 1280 × 720       | 30          | 3000        | ✓      | ✓       | ✓      |
- * | 720p_5   | 960 × 720       | 15          | 910          | ✓      | ✓       | ✓      |
- * | 720p_6   | 960 × 720       | 30          | 1380         | ✓      | ✓       | ✓      |
- * | 1080p    | 1920 × 1080     | 15          | 2080         | ✓      |         | ✓      |
- * | 1080p_1  | 1920 × 1080     | 15          | 2080         | ✓      |         | ✓      |
- * | 1080p_2  | 1920 × 1080     | 30          | 3000         | ✓      |         | ✓      |
- * | 1080p_3  | 1920 × 1080     | 30          | 3150         | ✓      |         | ✓      |
- * | 1080p_5  | 1920 × 1080     | 60          | 4780         | ✓      |         | ✓      |
+ * | 视频属性 | 分辨率（宽×高） | 帧率（fps） | Chrome | Firefox | Safari |
+ * | -------- | --------------- | ----------- | ------ | ------- | ------ |
+ * | 120p     | 160 × 120       | 15          | ✓      |         |        |
+ * | 120p_1   | 160 × 120       | 15          | ✓      |         |        |
+ * | 120p_3   | 120 × 120       | 15          | ✓      |         |        |
+ * | 180p     | 320 × 180       | 15          | ✓      |         |        |
+ * | 180p_1   | 320 × 180       | 15          | ✓      |         |        |
+ * | 180p_3   | 180 × 180       | 15          | ✓      |         |        |
+ * | 180p_4   | 240 × 180       | 15          | ✓      |         |        |
+ * | 240p     | 320 × 240       | 15          | ✓      |         |        |
+ * | 240p_1   | 320 × 240       | 15          | ✓      |         |        |
+ * | 240p_3   | 240 × 240       | 15          | ✓      |         |        |
+ * | 240p_4   | 424 × 240       | 15          | ✓      |         |        |
+ * | 360p     | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_1   | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_3   | 360 × 360       | 15          | ✓      |         |        |
+ * | 360p_4   | 640 × 360       | 30          | ✓      |         |        |
+ * | 360p_6   | 360 × 360       | 30          | ✓      |         |        |
+ * | 360p_7   | 480 × 360       | 15          | ✓      |         |        |
+ * | 360p_8   | 480 × 360       | 30          | ✓      |         |        |
+ * | 360p_9   | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_10  | 640 × 360       | 24          | ✓      |         |        |
+ * | 360p_11  | 640 × 360       | 24          | ✓      |         |        |
+ * | 480p     | 640 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_1   | 640 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_2   | 640 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_3   | 480 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_4   | 640 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_6   | 480 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_8   | 848 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_9   | 848 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_10  | 640 × 480       | 10          | ✓      | ✓       | ✓      |
+ * | 720p     | 1280 × 720      | 15          | ✓      | ✓       | ✓      |
+ * | 720p_1   | 1280 × 720      | 15          | ✓      | ✓       | ✓      |
+ * | 720p_2   | 1280 × 720      | 30          | ✓      | ✓       | ✓      |
+ * | 720p_3   | 1280 × 720      | 30          | ✓      | ✓       | ✓      |
+ * | 720p_auto <sup>①</sup>  | 1280 × 720       | 30          |✓      | ✓       | ✓      |
+ * | 720p_5   | 960 × 720       | 15          | ✓      | ✓       | ✓      |
+ * | 720p_6   | 960 × 720       | 30          | ✓      | ✓       | ✓      |
+ * | 1080p    | 1920 × 1080     | 15          | ✓      |         | ✓      |
+ * | 1080p_1  | 1920 × 1080     | 15          | ✓      |         | ✓      |
+ * | 1080p_2  | 1920 × 1080     | 30          | ✓      |         | ✓      |
+ * | 1080p_3  | 1920 × 1080     | 30          | ✓      |         | ✓      |
+ * | 1080p_5  | 1920 × 1080     | 60          | ✓      |         | ✓      |
  *
  * > <sup>①</sup> `"720p_auto"` 仅推荐在 Safari 上设置，用于确保能够动态调整编码分辨率，详见[发版说明](https://doc.shengwang.cn/doc/rtc/javascript/overview/release-notes)。
  *
@@ -5101,50 +5228,50 @@ export declare interface VideoEncoderConfiguration {
  *
  * The following table lists all the preset video profiles. The SDK uses `"480p_1"` by default.
  *
- * | Video Profile | Resolution (Width×Height) | Frame Rate (fps) | Bitrate (Kbps） | Chrome | Firefox | Safari |
- * | -------- | --------------- | ----------- | ------------ | ------ | ------- | ------ |
- * | 120p     | 160 × 120       | 15          | 65           | ✓      |         |        |
- * | 120p_1   | 160 × 120       | 15          | 65           | ✓      |         |        |
- * | 120p_3   | 120 × 120       | 15          | 50           | ✓      |         |        |
- * | 180p     | 320 × 180       | 15          | 140          | ✓      |         |        |
- * | 180p_1   | 320 × 180       | 15          | 140          | ✓      |         |        |
- * | 180p_3   | 180 × 180       | 15          | 100          | ✓      |         |        |
- * | 180p_4   | 240 × 180       | 15          | 120          | ✓      |         |        |
- * | 240p     | 320 × 240       | 15          | 200          | ✓      |         |        |
- * | 240p_1   | 320 × 240       | 15          | 200          | ✓      |         |        |
- * | 240p_3   | 240 × 240       | 15          | 140          | ✓      |         |        |
- * | 240p_4   | 424 × 240       | 15          | 220          | ✓      |         |        |
- * | 360p     | 640 × 360       | 15          | 400          | ✓      |         |        |
- * | 360p_1   | 640 × 360       | 15          | 400          | ✓      |         |        |
- * | 360p_3   | 360 × 360       | 15          | 260          | ✓      |         |        |
- * | 360p_4   | 640 × 360       | 30          | 600          | ✓      |         |        |
- * | 360p_6   | 360 × 360       | 30          | 400          | ✓      |         |        |
- * | 360p_7   | 480 × 360       | 15          | 320          | ✓      |         |        |
- * | 360p_8   | 480 × 360       | 30          | 490          | ✓      |         |        |
- * | 360p_9   | 640 × 360       | 15          | 800          | ✓      |         |        |
- * | 360p_10  | 640 × 360       | 24          | 800          | ✓      |         |        |
- * | 360p_11  | 640 × 360       | 24          | 1000         | ✓      |         |        |
- * | 480p     | 640 × 480       | 15          | 500          | ✓      | ✓       | ✓      |
- * | 480p_1   | 640 × 480       | 15          | 500          | ✓      | ✓       | ✓      |
- * | 480p_2   | 640 × 480       | 30          | 1000         | ✓      | ✓       | ✓      |
- * | 480p_3   | 480 × 480       | 15          | 400          | ✓      | ✓       | ✓      |
- * | 480p_4   | 640 × 480       | 30          | 750          | ✓      | ✓       | ✓      |
- * | 480p_6   | 480 × 480       | 30          | 600          | ✓      | ✓       | ✓      |
- * | 480p_8   | 848 × 480       | 15          | 610          | ✓      | ✓       | ✓      |
- * | 480p_9   | 848 × 480       | 30          | 930          | ✓      | ✓       | ✓      |
- * | 480p_10  | 640 × 480       | 10          | 400          | ✓      | ✓       | ✓      |
- * | 720p     | 1280 × 720      | 15          | 1130         | ✓      | ✓       | ✓      |
- * | 720p_1   | 1280 × 720      | 15          | 1130         | ✓      | ✓       | ✓      |
- * | 720p_2   | 1280 × 720      | 30          | 2000         | ✓      | ✓       | ✓      |
- * | 720p_3   | 1280 × 720      | 30          | 1710         | ✓      | ✓       | ✓      |
- * | 720p_auto <sup>①</sup>  | 1280 × 720       | 30          | 3000        | ✓      | ✓       | ✓      |
- * | 720p_5   | 960 × 720       | 15          | 910          | ✓      | ✓       | ✓      |
- * | 720p_6   | 960 × 720       | 30          | 1380         | ✓      | ✓       | ✓      |
- * | 1080p    | 1920 × 1080     | 15          | 2080         | ✓      |         | ✓      |
- * | 1080p_1  | 1920 × 1080     | 15          | 2080         | ✓      |         | ✓      |
- * | 1080p_2  | 1920 × 1080     | 30          | 3000         | ✓      |         | ✓      |
- * | 1080p_3  | 1920 × 1080     | 30          | 3150         | ✓      |         | ✓      |
- * | 1080p_5  | 1920 × 1080     | 60          | 4780         | ✓      |         | ✓      |
+ * | Video Profile | Resolution (Width×Height) | Frame Rate (fps) | Chrome | Firefox | Safari |
+ * | -------- | --------------- | ----------- | ------ | ------- | ------ |
+ * | 120p     | 160 × 120       | 15          | ✓      |         |        |
+ * | 120p_1   | 160 × 120       | 15          | ✓      |         |        |
+ * | 120p_3   | 120 × 120       | 15          | ✓      |         |        |
+ * | 180p     | 320 × 180       | 15          | ✓      |         |        |
+ * | 180p_1   | 320 × 180       | 15          | ✓      |         |        |
+ * | 180p_3   | 180 × 180       | 15          | ✓      |         |        |
+ * | 180p_4   | 240 × 180       | 15          | ✓      |         |        |
+ * | 240p     | 320 × 240       | 15          | ✓      |         |        |
+ * | 240p_1   | 320 × 240       | 15          | ✓      |         |        |
+ * | 240p_3   | 240 × 240       | 15          | ✓      |         |        |
+ * | 240p_4   | 424 × 240       | 15          | ✓      |         |        |
+ * | 360p     | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_1   | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_3   | 360 × 360       | 15          | ✓      |         |        |
+ * | 360p_4   | 640 × 360       | 30          | ✓      |         |        |
+ * | 360p_6   | 360 × 360       | 30          | ✓      |         |        |
+ * | 360p_7   | 480 × 360       | 15          | ✓      |         |        |
+ * | 360p_8   | 480 × 360       | 30          | ✓      |         |        |
+ * | 360p_9   | 640 × 360       | 15          | ✓      |         |        |
+ * | 360p_10  | 640 × 360       | 24          | ✓      |         |        |
+ * | 360p_11  | 640 × 360       | 24          | ✓      |         |        |
+ * | 480p     | 640 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_1   | 640 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_2   | 640 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_3   | 480 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_4   | 640 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_6   | 480 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_8   | 848 × 480       | 15          | ✓      | ✓       | ✓      |
+ * | 480p_9   | 848 × 480       | 30          | ✓      | ✓       | ✓      |
+ * | 480p_10  | 640 × 480       | 10          | ✓      | ✓       | ✓      |
+ * | 720p     | 1280 × 720      | 15          | ✓      | ✓       | ✓      |
+ * | 720p_1   | 1280 × 720      | 15          | ✓      | ✓       | ✓      |
+ * | 720p_2   | 1280 × 720      | 30          | ✓      | ✓       | ✓      |
+ * | 720p_3   | 1280 × 720      | 30          | ✓      | ✓       | ✓      |
+ * | 720p_auto <sup>①</sup>  | 1280 × 720       | 30          | ✓      | ✓       | ✓      |
+ * | 720p_5   | 960 × 720       | 15          | ✓      | ✓       | ✓      |
+ * | 720p_6   | 960 × 720       | 30          | ✓      | ✓       | ✓      |
+ * | 1080p    | 1920 × 1080     | 15          | ✓      |         | ✓      |
+ * | 1080p_1  | 1920 × 1080     | 15          | ✓      |         | ✓      |
+ * | 1080p_2  | 1920 × 1080     | 30          | ✓      |         | ✓      |
+ * | 1080p_3  | 1920 × 1080     | 30          | ✓      |         | ✓      |
+ * | 1080p_5  | 1920 × 1080     | 60          | ✓      |         | ✓      |
  *
  * > <sup>①</sup> `"720p_auto"` is only recommended to be set on Safari to ensure dynamic adjustment of the encoding resolution. For details, see the release notes.
  */
@@ -5171,6 +5298,8 @@ declare class VideoPlayer {
     protected videoTrack?: MediaStreamTrack;
     protected videoElement: HTMLVideoElement;
     protected cacheVideoElement?: HTMLVideoElement;
+    private renderStats?;
+    get rendFrameRate(): number;
     get videoElementStatus(): MediaElementStatus;
     set videoElementStatus(status: MediaElementStatus);
     get videoState(): VideoState;