@agora-js/media 4.24.0 → 4.24.1

package/media.d.ts

@@ -60,6 +60,10 @@ export declare interface AgoraRTCCompatibility {
     supportRequestVideoFrameCallback: boolean;
     /** 是否支持WebCrypto */
     supportWebCrypto: boolean;
+    /** 是否支持限制本地音频播放 */
+    supportSuppressLocalAudioPlayback: boolean;
+    /** 是否支持限制本地页面声音采集 */
+    supportRestrictOwnAudio: boolean;
 }
 
 /**
@@ -262,6 +266,7 @@ declare class AudioElementPlayCenter {
     updateTrack(trackId: string, track: MediaStreamTrack): void;
     isPlaying(trackId: string): boolean;
     setVolume(trackId: string, volume: number): void;
+    getVolume(trackId: string): number;
     stop(trackId: string): void;
     private bindAudioElementEvents;
     getPlayerState(trackId: string): string;
@@ -269,7 +274,7 @@ declare class AudioElementPlayCenter {
      * 监听页面事件，自动恢复音频播放
      */
     private autoResumeAudioElement;
-    autoResumeAfterInterruption: (force?: boolean) => void;
+    autoResumeAfterInterruption: (force?: boolean) => Promise<void[]>;
     private autoResumeAfterInterruptionOnIOS15_16;
 }
 
@@ -1287,6 +1292,10 @@ export declare function detectSupportPrePc(store?: SDKStore): boolean;
  */
 export declare function detectSupportPreSub(store?: SDKStore): boolean;
 
+export declare function detectSupportRestrictOwnAudio(): boolean;
+
+export declare function detectSupportSuppressLocalAudioPlayback(): boolean;
+
 /**
  * 音视频采集设备的信息。
  *
@@ -1450,7 +1459,7 @@ declare function event_first_frame_decoded(): void;
  * @自从
  * <br>&emsp;&emsp;&emsp;*4.20.1*
  *
- * 从 H.264 视频流中解析出 SEI 数据时触发，此事件会返回 SEI 数据。
+ * 从 H.264 或 H.265 视频流中解析出 SEI 数据时触发，此事件会返回 SEI 数据。
  *
  * @param sei Uint8Array 类型的 SEI 数据
  * @asMemberOf ILocalVideoTrack
@@ -1460,7 +1469,7 @@ declare function event_first_frame_decoded(): void;
  * @since
  * <br>&emsp;&emsp;&emsp;*4.20.1*
  *
- * Parsing SEI data from the H.264 video stream triggers this event, which returns the SEI data.
+ * Parsing SEI data from the H.264 or H.265 video stream triggers this event, which returns the SEI data.
  *
  * @param sei SEI data in Uint8Array
  * @asMemberOf ILocalVideoTrack
@@ -1710,7 +1719,7 @@ declare class FakeTrackSource extends EventEmitter {
     createMediaStreamSourceNode(): undefined;
 }
 
-export declare const frameData2CryptoBuffer: (imageData: ImageTypedData, appid: string, channelName: string) => Promise<Uint8Array<ArrayBufferLike>>;
+export declare const frameData2CryptoBuffer: (imageData: ImageTypedData, appid: string, channelName: string) => Promise<Uint8Array>;
 
 export declare function getAudioContext(): AudioContext;
 
@@ -1734,7 +1743,10 @@ export declare function getConstraintsFromCameraConfig(config: CameraVideoTrackI
 
 export declare function getConstraintsFromMicrophoneConfig(config: MicrophoneAudioTrackInitConfig): MediaTrackConstraints;
 
-export declare function getConstraintsFromScreenAudioConfig(config: ScreenAudioTrackInitConfig): MediaTrackConstraints;
+export declare function getConstraintsFromScreenAudioConfig(config: ScreenAudioTrackInitConfig): MediaTrackConstraints & {
+    suppressLocalAudioPlayback?: boolean;
+    restrictOwnAudio?: boolean;
+};
 
 export declare function getConstraintsFromScreenConfig(config: ScreenVideoTrackInitConfig): ScreenConstraintsWithElectron;
 
@@ -1820,6 +1832,8 @@ export declare let HAS_GUM_VIDEO: boolean;
 
 export declare function hasAudioContext(): boolean;
 
+export declare function hasMicrophoneTrack(): boolean;
+
 /**
  * 直接通过音频数据源创建的音频轨道，继承于 [LocalAudioTrack]{@link ILocalAudioTrack}, 在此之上提供了控制音频数据处理流程的功能（开始/暂停/跳转等等）。
  *
@@ -2116,6 +2130,15 @@ declare interface IDataStream {
     deserialize: (packet: ArrayBuffer) => ArrayBuffer;
 }
 
+export declare interface IFrameInfo {
+    type: string;
+    rtpTimestamp: number;
+    payloadType: number;
+    ssrc: number;
+    length: number;
+    mimeType?: string;
+}
+
 /**
  * 基础本地音频轨道，提供了本地音频轨道的主要功能。
  *
@@ -2418,7 +2441,7 @@ export declare interface ILocalTrack extends ITrack {
      * 发送或暂停发送该轨道的媒体数据。
      *
      * @自从
-     * <br>&emsp;&emsp;&emsp;*4.6.0*
+     * <br>&emsp;&emsp;&emsp;*4.0.0*
      *
      * 如果该轨道已发布，调用 `setMuted(true)` 后，远端会触发 [user-unpublished]{@link IAgoraRTCClient.event_user_unpublished} 事件。再调用 `setMuted(false)` 后，远端会触发 [user-published]{@link IAgoraRTCClient.event_user_published} 事件。
      *
@@ -2433,11 +2456,11 @@ export declare interface ILocalTrack extends ITrack {
      * Sends or stops sending the media data of the track.
      *
      * @since
-     * <br>&emsp;&emsp;&emsp;*4.6.0*
+     * <br>&emsp;&emsp;&emsp;*4.0.0*
      *
      * If the track is published, a successful call of `setMuted(true)` triggers the [user-unpublished]{@link IAgoraRTCClient.event_user_unpublished} event on the remote client, and a successful call of `setMuted(false)` triggers the [user-published]{@link IAgoraRTCClient.event_user_published} event.
      *
-     * > - Calling `setMuted(true)` does not stop capturing audio or video and takes shorter time to take effect than [[setEnabled]]. For details, see [What are the differences between setEnabled and setMuted?](https://docs.agora.io/en/interactive-live-streaming/develop/product-workflow?platform=web#setenabled-and-setmuted).
+     * > - Calling `setMuted(true)` does not stop capturing audio or video and takes shorter time to take effect than [[setEnabled]]. For details, see [What are the differences between setEnabled and setMuted?](https://docs.agora.io/en/help/integration-issues/set_enabled_set_muted).
      * > - Do not call `setEnabled` and `setMuted` together.
      *
      * @param muted Whether to stop sending the media data of the track:
@@ -2948,6 +2971,7 @@ export declare function interceptRemoteVideoFrame(receiver: RTCRtpReceiver, opti
 
 export declare interface InterceptVideoFrameOptions {
     onSei?: (sei: Uint8Array) => void;
+    onFirstFrame?: (frameInfo: IFrameInfo) => void;
 }
 
 /**
@@ -3061,6 +3085,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      * @param volume The volume. The value ranges from 0 (mute) to 100 (maximum). A value of 100 is the current volume.
      */
     setVolume(volume: number): void;
+    setAmplifiedVolume(volume: number): void;
     /**
      * 获取远端音频轨道的音量等级。
      *
@@ -3073,6 +3098,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      * Usually a user with audio level above 0.6 is a speaking user.
      */
     getVolumeLevel(): number;
+    getVolume(): number;
     /**
      * @自从
      * <br>&emsp;&emsp;&emsp;*4.13.0*
@@ -3394,6 +3420,17 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
      * The destination of the current processing pipeline on the remote video track.
      */
     processorDestination: IBaseProcessor;
+    /**
+     * 停止播放。
+     * @param isKeepLastFrame 是否保留最后一帧。
+     * @internal
+     */
+    /** @en
+     * Stops playing the media track.
+     * @param isKeepLastFrame Whether to keep the last frame.
+     * @internal
+     */
+    stop(isKeepLastFrame?: boolean): void;
 }
 
 export declare function isAudioEncoderConfiguration(config: AudioEncoderConfiguration): config is AudioEncoderConfiguration;
@@ -4182,8 +4219,10 @@ export declare class RemoteAudioTrack extends RemoteTrack implements IRemoteAudi
     constructor(track: MediaStreamTrack, userId: UID, uintId: number, store: SDKStore);
     setAudioFrameCallback(callback: null | ((buffer: AudioBuffer) => void), frameSize?: number): void;
     setVolume(volume: number): void;
+    setAmplifiedVolume(volume: number): void;
     setPlaybackDevice(deviceId: string): Promise<void>;
     getVolumeLevel(): number;
+    getVolume(): number;
     getStats(): RemoteAudioTrackStats;
     play(): void;
     stop(): void;
@@ -4471,7 +4510,7 @@ export declare class RemoteVideoTrack extends RemoteTrack implements IRemoteVide
     constructor(track: MediaStreamTrack, userId: UID, uintId: number, store: SDKStore, player?: AgoraRTCPlayer);
     getStats(): RemoteVideoTrackStats;
     play(element: string | HTMLElement | HTMLVideoElement, config?: VideoPlayerConfig): void;
-    stop(): void;
+    stop(isKeepLastFrame?: boolean): void;
     getCurrentFrameData(): ImageData;
     updateMediaStreamTrackResolution(): void;
     protected _updatePlayerSource(): void;
@@ -4665,6 +4704,8 @@ export declare interface Resolution {
     height: number;
 }
 
+export declare function restartBackgroundTag(): void;
+
 /**
  * 全局 getUserMedia 锁，确保每次 GUM 时上一个 GUM 已经完成
  *
@@ -4680,7 +4721,90 @@ export declare const SAFARI_GLOBAL_GUM_LOCK: PromiseMutex;
 /** @en
  * Configurations for the audio track of screen sharing. Set these configurations when calling [AgoraRTC.createScreenVideoTrack]{@link IAgoraRTC.createScreenVideoTrack} to enable audio during screen sharing.
  */
-export declare type ScreenAudioTrackInitConfig = AudioTrackInitConfig;
+export declare type ScreenAudioTrackInitConfig = {
+    /**
+     * 是否开启回声消除：
+     * - `true`: 开启回声消除。
+     * - `false`: 不开启回声消除。
+     */
+    /** @en
+     * Whether to enable acoustic echo cancellation:
+     * - `true`: Enable acoustic echo cancellation.
+     * - `false`: Do not enable acoustic echo cancellation.
+     */
+    AEC?: boolean;
+    /**
+     * 是否开启自动增益：
+     * - `true`: 开启自动增益。
+     * - `false`: 不开启自动增益。
+     */
+    /** @en
+     * Whether to enable audio gain control:
+     * - `true`: Enable audio gain control.
+     * - `false`: Do not enable audio gain control.
+     */
+    AGC?: boolean;
+    /**
+     * 是否开启噪声抑制：
+     * - `true`: 开启噪声抑制。
+     * - `false`: 不开启噪声抑制。
+     */
+    /** @en
+     * Whether to enable automatic noise suppression:
+     * - `true`: Enable automatic noise suppression.
+     * - `false`: Do not enable automatic noise suppression.
+     */
+    ANS?: boolean;
+    /**
+     * @自从
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * 是否禁止本地播放音频。
+     * - `true`：禁止本地播放音频。
+     * - `false`：(默认) 允许本地播放音频。
+     *
+     * 详见 [suppressLocalAudioPlayback](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSupportedConstraints/suppressLocalAudioPlayback)。
+     *
+     * > 该参数仅支持 Chrome 109 及以上、Edge 109 及以上和 Opera 95 及以上。
+     */
+    /** @en
+     * @since
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * Whether to suppress local audio playback.
+     * - `true`: Suppress local audio playback.
+     * - `false`: (Default) Do not suppress local audio playback.
+     *
+     * See [suppressLocalAudioPlayback](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSupportedConstraints/suppressLocalAudioPlayback) for details.
+     *
+     * > This parameter is supported on Chrome 109 and later, Edge 109 and later, and Opera 95 and later.
+     */
+    suppressLocalAudioPlayback?: boolean;
+    /**
+     * @自从
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * 是否禁止本地页面声音采集。
+     * - `true`：禁止本地页面声音采集。
+     * - `false`：(默认) 允许本地页面声音采集。
+     * 详见 [restrictOwnAudio](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSupportedConstraints/restrictOwnAudio)。
+     *
+     * > 该参数仅支持 Chrome 141 及以上、Edge 141 及以上和 Opera 125 及以上。
+     */
+    /** @en
+     * @since
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * Whether to restrict local audio capture.
+     * - `true`: Restrict local audio capture.
+     * - `false`: (Default) Do not restrict local audio capture.
+     *
+     * See [restrictOwnAudio](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSupportedConstraints/restrictOwnAudio) for details.
+     *
+     * > This parameter is supported on Chrome 141 and later, Edge 141 and later, and Opera 125 and later.
+     */
+    restrictOwnAudio?: boolean;
+};
 
 export declare interface ScreenConstraintsWithElectron extends MediaTrackConstraints {
     /**
@@ -4711,10 +4835,23 @@ export declare interface ScreenConstraintsWithElectron extends MediaTrackConstra
     selfBrowserSurface?: "include" | "exclude";
     /** 是否允许tag切换分享, 默认允许include, Chrome 107以上 Opera 93以上*/
     surfaceSwitching?: "include" | "exclude";
-    /** 是否开启系统音频，默认开启include, Chrome 105以上, Opera 91以上 */
+    /** 是否开启系统音频，默认开启include, Chrome 105以上, Opera 91以上
+     */
     systemAudio?: "include" | "exclude";
     /** 是否默认分享当前页面，默认为false, Chrome 94以上, Opera 80以上 */
     preferCurrentTab?: boolean;
+    /**
+     * link https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#monitortypesurfaces
+     * 决定 是否 允许分享整个屏幕。默认include, 允许分享整个屏幕， Chrome 119 以上支持
+     */
+    monitorTypeSurfaces?: "exclude" | "include";
+    /**
+     * 决定 是否 允许分享窗口音频, window 表示分享窗口音频，system 表示分享系统音频，
+     * 注意:
+     *  1. window 这个选项暂时不支持，所以 对外，只支持 exclude / system
+     *  2. Chrome 141 以上支持此字段，但表现不一，Chrome 141 设置 window，实际展示 systemAudio， 142+ 设置 window，实际展示 exclude
+     */
+    windowAudio?: "exclude" | "system";
 }
 
 /**
@@ -5025,6 +5162,55 @@ export declare interface ScreenVideoTrackInitConfig {
      * > Note: This property is only supported in Chrome 94 and above, and Opera 80 and above..
      */
     preferCurrentTab?: boolean;
+    /**
+     * @自从
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * 共享窗口时是否允许分享窗口音频。
+     * - `"exclude"`：不分享任何音频。
+     * - `"system"`：（默认）分享所有系统音频。
+     *
+     * 详见 [withAudio](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#windowAudio)。
+     */
+    /** @en
+     * @since
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * Whether to allow sharing window audio.
+     * - `"exclude"`: Do not share any audio.
+     * - `"system"`: (Default) Share system audio.
+     *
+     * See [withAudio](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#windowAudio) for details.
+     */
+    windowAudio?: "exclude" | "system";
+    /**
+     * @自从
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * 是否允许分享整个屏幕，包括浏览器页签和窗口选项。
+     * - `"exclude"`: 不分享整个屏幕。
+     * - `"include"`: （默认）分享整个屏幕。
+     *
+     * 详见 [monitorTypeSurfaces](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#monitortypesurfaces)。
+     *
+     * > - 该参数仅支持 Chrome 119 及以上。
+     * > - 如果将 `monitorTypeSurface` 设为 `exclude`，则无法将 `displaySurface` 设为 `monitor`，否则会报错。
+     *
+     */
+    /** @en
+     * @since
+     * <br>&emsp;&emsp;&emsp;*4.24.1*</br>
+     *
+     * Whether to allow sharing the entire screen, including the browser tab and window options.
+     * - `"exclude"`: Do not share the entire screen.
+     * - `"include"`: Share the entire screen.
+     *
+     * See [monitorTypeSurfaces](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#monitortypesurfaces) for details.
+     *
+     * > - This parameter is supported on Chrome 119 and later.
+     * > - If you set `monitorTypeSurface` to `exclude`, you cannot set `displaySurface` to `monitor`; otherwise, an error will occur.
+     */
+    monitorTypeSurfaces?: "exclude" | "include";
 }
 
 export declare type SenderConfig = {
@@ -5327,54 +5513,7 @@ export declare interface VideoEncoderConfiguration {
  *
  * 你可以在 [AgoraRTC.createCameraVideoTrack]{@link IAgoraRTC.createCameraVideoTrack} 方法中传入预设的视频编码配置。
  *
- * 下表列出了 SDK 所有内置的视频属性配置，SDK 默认使用 `"480p_1"`。
- *
- * | 视频属性 | 分辨率（宽×高） | 帧率（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)。
+ * SDK 支持预设的视频属性，以及在各浏览器上的支持情况，请参考[设置视频编码属性](https://doc.shengwang.cn/doc/rtc/javascript/basic-features/video-profile#preset-video-profiles)。
  *
  * @public
  */
@@ -5389,14 +5528,14 @@ export declare interface VideoEncoderConfiguration {
  * | Video Profile | Resolution (Width×Height) | Frame Rate (fps) | Chrome | Firefox | Safari |
  * | -------- | --------------- | ----------- | ------ | ------- | ------ |
  * | 120p     | 160 × 120       | 15          | ✓      |         |        |
- * | 120p_1   | 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          | ✓      |         |        |
+ * | 180p_4   | 240 × 180       | 15          | ✓      |         | ✓      |
  * | 240p     | 320 × 240       | 15          | ✓      |         |        |
- * | 240p_1   | 320 × 240       | 15          | ✓      |         |        |
+ * | 240p_1   | 320 × 240       | 15          | ✓      |         | ✓      |
  * | 240p_3   | 240 × 240       | 15          | ✓      |         |        |
  * | 240p_4   | 424 × 240       | 15          | ✓      |         |        |
  * | 360p     | 640 × 360       | 15          | ✓      |         |        |
@@ -5404,7 +5543,7 @@ export declare interface VideoEncoderConfiguration {
  * | 360p_3   | 360 × 360       | 15          | ✓      |         |        |
  * | 360p_4   | 640 × 360       | 30          | ✓      |         |        |
  * | 360p_6   | 360 × 360       | 30          | ✓      |         |        |
- * | 360p_7   | 480 × 360       | 15          | ✓      |         |        |
+ * | 360p_7   | 480 × 360       | 15          | ✓      |         | ✓      |
  * | 360p_8   | 480 × 360       | 30          | ✓      |         |        |
  * | 360p_9   | 640 × 360       | 15          | ✓      |         |        |
  * | 360p_10  | 640 × 360       | 24          | ✓      |         |        |
@@ -5443,6 +5582,7 @@ declare class VideoPlayer {
     config: PlayerConfig;
     onFirstVideoFrameDecoded?: () => void;
     onFirstVideoFrameRender?: () => void;
+    onVideoBufferReady?: () => void;
     onVideoStateChanged?: (state: VideoState) => void;
     freezeTimeCounterList: number[];
     renderFreezeAccTime: number;
@@ -5459,6 +5599,7 @@ declare class VideoPlayer {
     protected videoTrack?: MediaStreamTrack;
     protected videoElement: HTMLVideoElement;
     protected cacheVideoElement?: HTMLVideoElement;
+    protected cancelRVFId?: number;
     protected internal: boolean;
     get rendFrameRate(): number;
     get videoElementStatus(): MediaElementStatus;
@@ -5481,7 +5622,7 @@ declare class VideoPlayer {
     play(sessionId?: string): void;
     getCurrentFrame(): ImageData;
     getCurrentFrameToUint8Array(type: string, quality?: number): Promise<ImageTypedData>;
-    destroy(): void;
+    destroy(isKeepLastFrame?: boolean): void;
     protected initVideoElement(): void;
     protected resetVideoElement(): void;
     private startGetVideoDimensions;
@@ -5539,6 +5680,15 @@ export declare interface VideoPlayerConfig {
      * > - When playing the remote video track, the SDK uses cover mode by default.
      */
     fit?: "cover" | "contain" | "fill";
+    /**
+     * 是否不使用样式
+     * @ignore
+     */
+    /** @en
+     * Whether to use the style
+     * @ignore
+     */
+    noStyle?: boolean;
 }
 
 export declare class VideoProcessorContext extends EventEmitter implements IProcessorContext {
@@ -5617,10 +5767,14 @@ export declare enum VideoState {
 declare class VisibilityWatcher extends EventEmitter {
     private _lastHiddenTime;
     private _lastVisibleTime;
+    needUploadStats: number[];
+    isCollectingStats: boolean;
     get visibility(): DocumentVisibilityState;
     get lastHiddenTime(): DOMHighResTimeStamp;
     get lastVisibleTime(): DOMHighResTimeStamp;
     constructor();
+    startCollectStats(): void;
+    stopCollectStats(): void;
 }
 
 export declare const visibilityWatcher: VisibilityWatcher;

package/package.json

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