@agora-js/media 4.20.2 → 4.21.0-200

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,16 +219,20 @@ 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;
 
+export declare interface AudioMetadata {
+    value: Uint8Array;
+}
+
 export declare interface AudioPlaybackOptions {
     origin?: boolean;
     mixing?: boolean;
@@ -487,7 +493,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;
@@ -547,7 +553,7 @@ export declare interface CameraVideoTrackInitConfig {
      *
      * > Note: This method is only supported on Chrome.
      */
-    optimizationMode?: "motion" | "detail";
+    optimizationMode?: OptimizationMode;
     /**
      * @ignore
      *
@@ -794,6 +800,8 @@ export declare interface DenoiserStats {
     vl: number;
 }
 
+export declare function detectSupportAudioElementSetSinkId(): boolean;
+
 /**
  * Information of the media input device.
  *
@@ -939,6 +947,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 +1079,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 +1097,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;
@@ -1390,6 +1415,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 +1499,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;
     /**
@@ -1702,11 +1737,21 @@ export declare interface IMicrophoneAudioTrack extends ILocalAudioTrack {
     setEnabled(enabled: boolean): Promise<void>;
 }
 
-export declare function interceptLocalAudioFrame(sender: RTCRtpSender): Promise<void>;
+declare interface InterceptAudioFrameOptions {
+    enableTopn?: boolean;
+    enableMetadata?: boolean;
+    onMetadata?: (metadata: Uint8Array) => void;
+}
+
+declare interface InterceptAudioFrameOptions_2 {
+    metadata?: () => Uint8Array | undefined;
+}
+
+export declare function interceptLocalAudioFrame(sender: RTCRtpSender, options?: InterceptAudioFrameOptions_2): Promise<void>;
 
 export declare function interceptLocalVideoFrame(sender: RTCRtpSender, localVideoTrack: LocalVideoTrack): Promise<void>;
 
-export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver): Promise<void>;
+export declare function interceptRemoteAudioFrame(receiver: RTCRtpReceiver, options?: InterceptAudioFrameOptions): Promise<void>;
 
 export declare function interceptRemoteVideoFrame(receiver: RTCRtpReceiver, options?: InterceptVideoFrameOptions): Promise<void>;
 
@@ -1738,7 +1783,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
      *
      * Sets the audio playback device, for example, the speaker.
      *
-     * > This method supports Chrome and Edge on desktop devices only. Other browsers throw a `NOT_SUPPORTED` error when calling this method.
+     * > > This method is only supported on desktop Chrome and Edge browsers. If you call it on other browsers, you need to set `RESTRICTION_SET_PLAYBACK_DEVICE` to `false` first, and calling it directly will throw a `NOT_SUPPORTED` error.
      * @param deviceId Device ID, which can be retrieved by calling [[getPlaybackDevices]].
      */
     setPlaybackDevice(deviceId: string): Promise<void>;
@@ -1825,6 +1870,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 +1907,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 +1974,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.
      */
@@ -2023,6 +2078,7 @@ export declare class LocalAudioTrack extends LocalTrack implements ILocalAudioTr
     readonly trackMediaType: "audio" | "video";
     _encoderConfig?: AudioEncoderConfiguration;
     _trackSource: AudioTrackSource | FakeTrackSource;
+    metadata: AudioMetadata[];
     get _source(): AudioTrackSource;
     set _source(source: AudioTrackSource | FakeTrackSource);
     _enabled: boolean;
@@ -2134,7 +2190,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>;
@@ -2170,21 +2226,24 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     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 +2257,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;
@@ -2450,6 +2509,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;
@@ -2941,6 +3002,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 +3103,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 +3122,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,6 +3146,7 @@ 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"
 }
@@ -3144,50 +3215,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 +3280,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;