@agora-js/media 4.20.2 → 4.22.0

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@agora-js/media",
-	"version": "4.20.2",
+	"version": "4.22.0",
 	"description": "media module across @agora-js packages",
 	"main": "AgoraRTC_N-media.js",
 	"module": "AgoraRTC_N-media.esm.mjs",
-	"types": "media.d.ts",
+	"types": "rtc-sdk-media_en.d.ts",
 	"declaration": true,
 	"author": "Agora WebRTC Team",
 	"keywords": [
@@ -23,11 +23,10 @@
 	"homepage": "https://api-ref.agora.io/en/voice-sdk/web/4.x/index.html",
 	"peerDependencies": {},
 	"dependencies": {
-		"@agora-js/shared": "4.20.2",
-		"@agora-js/report": "4.20.2",
-		"axios": "^1.6.7",
+		"@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

@@ -39,6 +39,8 @@ export declare interface AgoraRTCCompatibility {
     supportPCSetConfiguration: boolean;
     supportWebRTCEncodedTransform: boolean;
     supportWebRTCInsertableStream: boolean;
+    supportRequestVideoFrameCallback: boolean;
+    supportWebCrypto: boolean;
 }
 
 declare class AgoraRTCPlayer extends VideoPlayer {
@@ -217,12 +219,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;
@@ -487,7 +489,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;
@@ -534,20 +536,23 @@ 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.
+     *
+     * > 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
      *
@@ -573,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:
@@ -699,18 +704,24 @@ export declare interface CustomVideoTrackInitConfig {
     bitrateMax?: number;
     /**
      * @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:
+     * - `"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";
     /**
@@ -729,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;
@@ -761,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;
@@ -794,6 +793,8 @@ export declare interface DenoiserStats {
     vl: number;
 }
 
+export declare function detectSupportAudioElementSetSinkId(): boolean;
+
 /**
  * Information of the media input device.
  *
@@ -939,6 +940,13 @@ declare function event_source_state_change(currentState: AudioSourceState): void
  */
 declare function event_track_ended(): void;
 
+/**
+ * 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;
+
 /**
  * Occurs when the `RTCRtpTransceiver` instance of the current track is updated.
  *
@@ -1064,6 +1072,8 @@ export declare function getAudioEncoderConfiguration(profile: AudioEncoderConfig
 
 export declare function getBitrateConstrainRange(width: number, height: number, frameRate: number, bitrateMin?: number, bitrateMax?: number): DoubleRange;
 
+export declare function getBitrateFromResAndFps(width: number, height: number, fps: number): Required<DoubleRange>;
+
 export declare function getCompatibility(): AgoraRTCCompatibility;
 
 export declare function getConstraintsFromCameraConfig(config: CameraVideoTrackInitConfig): MediaTrackConstraints;
@@ -1080,6 +1090,14 @@ export declare function getElectronScreenStreamByUserSelect(config: ScreenConstr
 
 export declare function getLocalStream(config: GetUserMediaConfig, id: string): Promise<MediaStream>;
 
+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;
@@ -1276,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.
  *
@@ -1390,6 +1413,11 @@ 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 The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event The event name.
      * @param listener See [track-ended]{@link event_track_ended}.
@@ -1469,6 +1497,11 @@ 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 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;
     /**
@@ -1570,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.
      */
@@ -1825,6 +1858,11 @@ 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 The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event The event name.
      * @param listener See [first-frame-decoded]{@link event_first_frame_decoded}.
@@ -1857,6 +1895,11 @@ 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 The event name.
+     * @param listener See [track-updated]{@link event_track_updated}.
+     */
+    on(event: "track-updated", listener: typeof event_track_updated): void;
     /**
      * @param event The event name.
      * @param listener See [video-state-changed]{@link event_video_state_changed}.
@@ -1919,7 +1962,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.
      */
@@ -1961,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;
@@ -2134,7 +2179,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>;
@@ -2165,26 +2210,28 @@ 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>;
     _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>;
@@ -2198,7 +2245,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;
@@ -2212,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;
@@ -2230,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.
      */
@@ -2450,6 +2496,8 @@ export declare class MixingAudioTrack extends LocalAudioTrack {
     _updateRtpTransceiver(transceiver: RTCRtpTransceiver): void;
 }
 
+export declare type OptimizationMode = "motion" | "detail";
+
 export declare interface PlayerConfig extends VideoPlayerConfig {
     trackId: string;
     element: HTMLElement;
@@ -2475,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;
@@ -2561,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.
      */
@@ -2652,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;
@@ -2693,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.
      */
@@ -2859,17 +2911,21 @@ export declare interface ScreenVideoTrackInitConfig {
     screenSourceType?: ScreenSourceType;
     /**
      * @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:
-     * - `"detail"`: (Default) Prioritizes video quality.
+     * 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";
     /**
@@ -2941,6 +2997,12 @@ export declare interface ScreenVideoTrackInitConfig {
     systemAudio?: "include" | "exclude";
 }
 
+export declare type SenderConfig = {
+    bitrateMax: number;
+    bitrateMin: number;
+    scaleResolutionDownBy: number;
+};
+
 export declare function silenceScriptProcessHandler(e: AudioProcessingEvent): AudioBuffer;
 
 export declare interface StatsRegistry {
@@ -3036,7 +3098,9 @@ export declare abstract class Track extends EventEmitter implements ITrack {
     _hints: TrackHint[];
     _isClosed: boolean;
     _originMediaStreamTrack: MediaStreamTrack;
-    _mediaStreamTrack: MediaStreamTrack;
+    mediaStreamTrack: MediaStreamTrack;
+    set _mediaStreamTrack(track: MediaStreamTrack);
+    get _mediaStreamTrack(): MediaStreamTrack;
     _external: ExternalMethods;
     constructor(track: MediaStreamTrack, trackId?: string);
     toString(): string;
@@ -3053,7 +3117,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"
 }
 
 export declare enum TrackHint {
@@ -3076,10 +3141,17 @@ export declare enum TrackInternalEvent {
     GET_LOW_VIDEO_TRACK = "@get_low_video_track",
     NEED_RESET_REMOTE_SDP = "@need_reset_remote_sdp",
     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 {
@@ -3144,50 +3216,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.
  */
@@ -3209,6 +3281,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;