@agora-js/media 4.19.1 → 4.19.3

package/media.d.ts

@@ -762,7 +762,10 @@ export declare interface CameraVideoTrackInitConfig {
     /**
      * 控制视频的编码配置。
      *
-     * 你可以通过 [[VideoEncoderConfigurationPreset]] 传入 SDK 内置的编码配置；也可以通过传入一个 [[VideoEncoderConfiguration]] 来自定义视频编码配置。
+     * 你可以通过以下方式设置该属性：
+     * - 通过 [[VideoEncoderConfigurationPreset]] 传入 SDK 内置的编码配置。
+     * - 通过传入一个 [[VideoEncoderConfiguration]] 对象来自定义视频编码配置。
+     * - 不传或留空，使用 SDK 的默认值 `"480p_1"`（分辨率 640 × 480、帧率 15 fps、码率 500 Kbps）。
      */
     /** @en
      * The video encoder configurations.
@@ -770,6 +773,7 @@ export declare interface CameraVideoTrackInitConfig {
      * You can set the video encoder configurations in either of the following ways:
      * - Pass the preset video encoder configurations by using [[VideoEncoderConfigurationPreset]].
      * - Pass your customized video encoder configurations by using [[VideoEncoderConfiguration]].
+     * - Leave this property empty to use the SDK's default value, `"480p_1"` (resolution: 640 × 480, frame rate: 15 fps, bitrate: 500 Kbps).
      */
     encoderConfig?: VideoEncoderConfiguration | VideoEncoderConfigurationPreset;
     /**
@@ -2222,7 +2226,7 @@ export declare interface ILocalTrack extends ITrack {
      *
      * 如果该轨道已发布，调用 `setMuted(true)` 后，远端会触发 [user-unpublished]{@link IAgoraRTCClient.event_user_unpublished} 事件。再调用 `setMuted(false)` 后，远端会触发 [user-published]{@link IAgoraRTCClient.event_user_published} 事件。
      *
-     * > - 与 {@link setEnabled} 相比，调用该方法响应速度更快且不影响视频采集状态，详见 [setEnabled 和 setMuted 有什么区别？](https://docs.agora.io/cn/Interactive%20Broadcast/faq/differences_between_setenabled_and_setmuted)。
+     * > - 与 {@link setEnabled} 相比，调用该方法响应速度更快且不影响视频采集状态，详见 [setEnabled 和 setMuted 有什么区别？](http://doc.shengwang.cn/faq/integration-issues/diff-setenabled-setmuted)。
      * > - `setEnabled` 和 `setMuted` 不能同时调用。
      *
      * @param muted 是否发送该轨道的媒体数据:
@@ -3187,9 +3191,11 @@ export declare interface ITrack extends EventEmitter {
     /**
      * 获取当前轨道的 [RTCRtpTransceiver](https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver) 实例。
      *
-     * 该方法目前主要用于视频流的端到端加密（Beta）。
+     * 该方法目前主要用于视频流的[端到端加密（Beta）](https://doc.shengwang.cn/doc/rtc/javascript/advanced-features/e2e-encryption)。
      *
-     * > 如果 SDK 发生断线重连，当前轨道对应的 `RTCRtpTransceiver` 实例可能会发生变化。你可以通过当前轨道的 "transceiver-updated" {@link event_transceiver_updated} 事件来获取新的 `RTCRtpTransceiver` 实例。
+     * > 如果 SDK 发生断线重连，当前轨道对应的 `RTCRtpTransceiver` 实例可能会发生变化。你可以通过以下回调来获取新的 `RTCRtpTransceiver` 实例：
+     * >  - 本地轨道：["transceiver-updated"]{@link ILocalTrack.event_transceiver_updated}
+     * >  - 远端轨道：["transceiver-updated-2"]{@link IRemoteTrack.event_transceiver_updated_2}
      *
      * @param type 视频流的类型。详见 {@link StreamType}。
      * @returns 当前轨道的 `RTCRtpTransceiver` 实例。
@@ -3199,7 +3205,9 @@ export declare interface ITrack extends EventEmitter {
      *
      * This method is currently mainly used for end-to-end encryption of video streams (Beta).
      *
-     * > If the SDK experiences a reconnection, the `RTCRtpTransceiver` instance corresponding to the current track might change. You can use the "transceiver-updated" {@link event_transceiver_updated} event of the current track to obtain the new `RTCRtpTransceiver` instance.
+     * > If the SDK experiences a reconnection, the `RTCRtpTransceiver` instance corresponding to the current track might change. You can obtain the new `RTCRtpTransceiver` instance through the following callbacks:
+     * >  - For a local track: ["transceiver-updated"]{@link ILocalTrack.event_transceiver_updated}
+     * >  - For a remote track: ["transceiver-updated-2"]{@link IRemoteTrack.event_transceiver_updated_2}
      *
      * @param type The type of the video stream. See {@link StreamType}.
      * @returns The [RTCRtpTransceiver](https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver) instance of the current track.
@@ -3419,7 +3427,12 @@ export declare enum LocalTrackEvents {
 export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTrack {
     readonly trackMediaType: "audio" | "video";
     _player?: AgoraRTCPlayer | VideoPlayer;
+    isUseScaleResolutionDownBy: boolean;
     private _videoVisibleTimer;
+    /**
+     * 轮询监听stats
+     */
+    protected _statsTimer: number | null;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
     _encoderConfig?: Partial<VideoEncoderConfiguration>;
@@ -3457,6 +3470,7 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     updateMediaStreamTrackResolution(): void;
     protected _updatePlayerSource(): void;
     protected _getDefaultPlayerConfig(): Partial<VideoPlayerConfig>;
+    protected setSenderConfiguration(config: VideoEncoderConfiguration | VideoEncoderConfigurationPreset): Promise<void>;
     updateBitrateFromProfile(): void;
     getVideoElementVisibleStatus(): CheckVideoVisibleResult | undefined;
     renewMediaStreamTrack(newConstraints?: MediaTrackConstraints): Promise<void>;
@@ -3465,6 +3479,7 @@ 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;
     private bindProcessorDestinationEvents;
     private unbindProcessorDestinationEvents;
     private unbindProcessorContextEvents;
@@ -3484,7 +3499,7 @@ export declare interface LocalVideoTrackStats {
      * - `"H264"`: 视频编码格式为 H.264。
      * - `"H265"`: 视频编码格式为 H.265。
      * - `"VP8"`: 视频编码格式为 VP8。
-     * - `"VP9"`: (Beta) 视频编码格式为 VP9。
+     * - `"VP9"`: 视频编码格式为 VP9。
      * - `"AV1X"`: 预留参数，暂不支持。
      * - `"AV1"`: 预留参数，暂不支持。
      *
@@ -3496,7 +3511,7 @@ export declare interface LocalVideoTrackStats {
      * - `"H264"`: The video codec is H.264.
      * - `"H265"`: The video codec is H.265.
      * - `"VP8"`: The video codec is VP8.
-     * - `"VP9"`: (Beta) The video codec is VP9.
+     * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
      * - `"AV1"`: Reserved for future use.
      *
@@ -4283,7 +4298,7 @@ export declare interface RemoteVideoTrackStats {
      * - `"H264"`: 视频编码格式为 H.264。
      * - `"H265"`: 视频编码格式为 H.265。
      * - `"VP8"`: 视频编码格式为 VP8。
-     * - `"VP9"`: (Beta) 视频编码格式为 VP9。
+     * - `"VP9"`: 视频编码格式为 VP9。
      * - `"AV1X"`: 视频编码格式为 AV1，在 Chrome M96 版本之前。
      * - `"AV1"`: 视频编码格式为 AV1。
      *
@@ -4295,7 +4310,7 @@ export declare interface RemoteVideoTrackStats {
      * - `"H264"`: The video codec is H.264.
      * - `"H265"`: The video codec is H.265.
      * - `"VP8"`: The video codec is VP8.
-     * - `"VP9"`: (Beta) The video codec is VP9.
+     * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
      * - `"AV1"`: Reserved for future use.
      *
@@ -4500,10 +4515,14 @@ export declare interface ScreenConstraintsWithElectron extends MediaTrackConstra
  * | "720p_1"   | 1280 × 720      | 5           |
  * | "720p_2"   | 1280 × 720      | 30          |
  * | "720p_3"   | 1280 × 720      | 15          |
+ * | "720p_auto" <sup>①</sup>  | 1280 × 720       | 30          |
  * | "1080p"    | 1920 × 1080     | 5           |
  * | "1080p_1"  | 1920 × 1080     | 5           |
  * | "1080p_2"  | 1920 × 1080     | 30          |
  * | "1080p_3"  | 1920 × 1080     | 15          |
+ *
+ * > <sup>①</sup> `"720p_auto"` 仅推荐在 Safari 上设置，用于确保能够动态调整编码分辨率，详见[发版说明](https://doc.shengwang.cn/doc/rtc/javascript/overview/release-notes)。
+ *
  */
 /** @en
  * The preset video encoder configurations for screen sharing.
@@ -4522,10 +4541,13 @@ export declare interface ScreenConstraintsWithElectron extends MediaTrackConstra
  * | "720p_1"   | 1280 × 720      | 5           |
  * | "720p_2"   | 1280 × 720      | 30          |
  * | "720p_3"   | 1280 × 720      | 15          |
+ * | "720p_auto" <sup>①</sup>  | 1280 × 720       | 30          |
  * | "1080p"    | 1920 × 1080     | 5           |
  * | "1080p_1"  | 1920 × 1080     | 5           |
  * | "1080p_2"  | 1920 × 1080     | 30          |
  * | "1080p_3"  | 1920 × 1080     | 15          |
+ *
+ * > <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.
  */
 export declare type ScreenEncoderConfigurationPreset = keyof typeof SUPPORT_SCREEN_ENCODER_CONFIG_LIST;
 
@@ -4554,7 +4576,10 @@ export declare interface ScreenVideoTrackInitConfig {
     /**
      * 控制屏幕共享视频的编码配置。
      *
-     * 你可以通过 [[ScreenEncoderConfigurationPreset]] 传入 SDK 内置的编码配置；也可以通过传入一个 [[VideoEncoderConfiguration]] 来自定义视频编码配置。
+     * 你可以通过以下方式设置该属性：
+     * - 通过 [[ScreenEncoderConfigurationPreset]] 传入 SDK 内置的编码配置。
+     * - 通过传入一个 [[VideoEncoderConfiguration]] 对象来自定义视频编码配置。
+     * - 不传或留空，使用 SDK 的默认值 `"1080p_2"`（分辨率 1920 × 1080、帧率 30 fps、码率 	3000 Kbps）。
      */
     /** @en
      * The video encoder configurations for screen sharing.
@@ -4562,6 +4587,7 @@ export declare interface ScreenVideoTrackInitConfig {
      * You can set the video encoder configurations in either of the following ways:
      * - Pass the preset video encoder configurations by using [[ScreenEncoderConfigurationPreset]].
      * - Pass your customized video encoder configurations by using [[VideoEncoderConfiguration]].
+     * - Leave this property empty to use the SDK's default value, `"1080p_2"` (resolution: 1920 × 1080, frame rate: 30 fps, bitrate: 3000 Kbps).
      */
     encoderConfig?: VideoEncoderConfiguration | ScreenEncoderConfigurationPreset;
     /**
@@ -4868,6 +4894,15 @@ export declare interface SubscribeVideoUploadStats {
     A_ifdsd?: string;
 }
 
+export declare const SUPPORT_720P_AUTO_CONFIG_LIST: Required<{
+    scaleResolutionDownBy: number;
+    width: number;
+    height: number;
+    frameRate: number;
+    bitrateMin: number;
+    bitrateMax: number;
+}>[];
+
 /** @en
  * @ignore
  */
@@ -5012,6 +5047,7 @@ export declare enum TrackInternalEvent {
     NEED_SESSION_ID = "@need_sid",
     SET_OPTIMIZATION_MODE = "@set_optimization_mode",
     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_UPDATE_VIDEO_ENCODER = "@need_update_video_encoder",
@@ -5164,6 +5200,7 @@ export declare interface VideoEncoderConfiguration {
  * | 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         | ✓      |         | ✓      |
@@ -5171,6 +5208,9 @@ export declare interface VideoEncoderConfiguration {
  * | 1080p_2  | 1920 × 1080     | 30          | 3000         | ✓      |         | ✓      |
  * | 1080p_3  | 1920 × 1080     | 30          | 3150         | ✓      |         | ✓      |
  * | 1080p_5  | 1920 × 1080     | 60          | 4780         | ✓      |         | ✓      |
+ *
+ * > <sup>①</sup> `"720p_auto"` 仅推荐在 Safari 上设置，用于确保能够动态调整编码分辨率，详见[发版说明](https://doc.shengwang.cn/doc/rtc/javascript/overview/release-notes)。
+ *
  * @public
  */
 /** @en
@@ -5217,6 +5257,7 @@ export declare interface VideoEncoderConfiguration {
  * | 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         | ✓      |         | ✓      |
@@ -5224,6 +5265,8 @@ export declare interface VideoEncoderConfiguration {
  * | 1080p_2  | 1920 × 1080     | 30          | 3000         | ✓      |         | ✓      |
  * | 1080p_3  | 1920 × 1080     | 30          | 3150         | ✓      |         | ✓      |
  * | 1080p_5  | 1920 × 1080     | 60          | 4780         | ✓      |         | ✓      |
+ *
+ * > <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.
  */
 export declare type VideoEncoderConfigurationPreset = keyof typeof SUPPORT_VIDEO_ENCODER_CONFIG_LIST;
 

package/package.json

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

package/rtc-sdk-media_en.d.ts

@@ -515,6 +515,7 @@ export declare interface CameraVideoTrackInitConfig {
      * You can set the video encoder configurations in either of the following ways:
      * - Pass the preset video encoder configurations by using [[VideoEncoderConfigurationPreset]].
      * - Pass your customized video encoder configurations by using [[VideoEncoderConfiguration]].
+     * - Leave this property empty to use the SDK's default value, `"480p_1"` (resolution: 640 × 480, frame rate: 15 fps, bitrate: 500 Kbps).
      */
     encoderConfig?: VideoEncoderConfiguration | VideoEncoderConfigurationPreset;
     /**
@@ -1948,7 +1949,9 @@ export declare interface ITrack extends EventEmitter {
      *
      * This method is currently mainly used for end-to-end encryption of video streams (Beta).
      *
-     * > If the SDK experiences a reconnection, the `RTCRtpTransceiver` instance corresponding to the current track might change. You can use the "transceiver-updated" {@link event_transceiver_updated} event of the current track to obtain the new `RTCRtpTransceiver` instance.
+     * > If the SDK experiences a reconnection, the `RTCRtpTransceiver` instance corresponding to the current track might change. You can obtain the new `RTCRtpTransceiver` instance through the following callbacks:
+     * >  - For a local track: ["transceiver-updated"]{@link ILocalTrack.event_transceiver_updated}
+     * >  - For a remote track: ["transceiver-updated-2"]{@link IRemoteTrack.event_transceiver_updated_2}
      *
      * @param type The type of the video stream. See {@link StreamType}.
      * @returns The [RTCRtpTransceiver](https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver) instance of the current track.
@@ -2111,7 +2114,9 @@ export declare enum LocalTrackEvents {
 export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTrack {
     readonly trackMediaType: "audio" | "video";
     _player?: AgoraRTCPlayer | VideoPlayer;
+    isUseScaleResolutionDownBy: boolean;
     private _videoVisibleTimer;
+    protected _statsTimer: number | null;
     private _previousVideoVisibleStatus;
     private _clearPreviousVideoVisibleStatus;
     _encoderConfig?: Partial<VideoEncoderConfiguration>;
@@ -2149,6 +2154,7 @@ export declare class LocalVideoTrack extends LocalTrack implements ILocalVideoTr
     updateMediaStreamTrackResolution(): void;
     protected _updatePlayerSource(): void;
     protected _getDefaultPlayerConfig(): Partial<VideoPlayerConfig>;
+    protected setSenderConfiguration(config: VideoEncoderConfiguration | VideoEncoderConfigurationPreset): Promise<void>;
     updateBitrateFromProfile(): void;
     getVideoElementVisibleStatus(): CheckVideoVisibleResult | undefined;
     renewMediaStreamTrack(newConstraints?: MediaTrackConstraints): Promise<void>;
@@ -2157,6 +2163,7 @@ 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;
     private bindProcessorDestinationEvents;
     private unbindProcessorDestinationEvents;
     private unbindProcessorContextEvents;
@@ -2172,7 +2179,7 @@ export declare interface LocalVideoTrackStats {
      * - `"H264"`: The video codec is H.264.
      * - `"H265"`: The video codec is H.265.
      * - `"VP8"`: The video codec is VP8.
-     * - `"VP9"`: (Beta) The video codec is VP9.
+     * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
      * - `"AV1"`: Reserved for future use.
      *
@@ -2701,7 +2708,7 @@ export declare interface RemoteVideoTrackStats {
      * - `"H264"`: The video codec is H.264.
      * - `"H265"`: The video codec is H.265.
      * - `"VP8"`: The video codec is VP8.
-     * - `"VP9"`: (Beta) The video codec is VP9.
+     * - `"VP9"`: The video codec is VP9.
      * - `"AV1X"`: Reserved for future use.
      * - `"AV1"`: Reserved for future use.
      *
@@ -2821,10 +2828,13 @@ export declare interface ScreenConstraintsWithElectron extends MediaTrackConstra
  * | "720p_1"   | 1280 × 720      | 5           |
  * | "720p_2"   | 1280 × 720      | 30          |
  * | "720p_3"   | 1280 × 720      | 15          |
+ * | "720p_auto" <sup>①</sup>  | 1280 × 720       | 30          |
  * | "1080p"    | 1920 × 1080     | 5           |
  * | "1080p_1"  | 1920 × 1080     | 5           |
  * | "1080p_2"  | 1920 × 1080     | 30          |
  * | "1080p_3"  | 1920 × 1080     | 15          |
+ *
+ * > <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.
  */
 export declare type ScreenEncoderConfigurationPreset = keyof typeof SUPPORT_SCREEN_ENCODER_CONFIG_LIST;
 
@@ -2846,6 +2856,7 @@ export declare interface ScreenVideoTrackInitConfig {
      * You can set the video encoder configurations in either of the following ways:
      * - Pass the preset video encoder configurations by using [[ScreenEncoderConfigurationPreset]].
      * - Pass your customized video encoder configurations by using [[VideoEncoderConfiguration]].
+     * - Leave this property empty to use the SDK's default value, `"1080p_2"` (resolution: 1920 × 1080, frame rate: 30 fps, bitrate: 3000 Kbps).
      */
     encoderConfig?: VideoEncoderConfiguration | ScreenEncoderConfigurationPreset;
     /**
@@ -3038,6 +3049,15 @@ export declare interface SubscribeVideoUploadStats {
     A_ifdsd?: string;
 }
 
+export declare const SUPPORT_720P_AUTO_CONFIG_LIST: Required<{
+    scaleResolutionDownBy: number;
+    width: number;
+    height: number;
+    frameRate: number;
+    bitrateMin: number;
+    bitrateMax: number;
+}>[];
+
 /**
  * @ignore
  */
@@ -3137,6 +3157,7 @@ export declare enum TrackInternalEvent {
     NEED_SESSION_ID = "@need_sid",
     SET_OPTIMIZATION_MODE = "@set_optimization_mode",
     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_UPDATE_VIDEO_ENCODER = "@need_update_video_encoder",
@@ -3249,6 +3270,7 @@ export declare interface VideoEncoderConfiguration {
  * | 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         | ✓      |         | ✓      |
@@ -3256,6 +3278,8 @@ export declare interface VideoEncoderConfiguration {
  * | 1080p_2  | 1920 × 1080     | 30          | 3000         | ✓      |         | ✓      |
  * | 1080p_3  | 1920 × 1080     | 30          | 3150         | ✓      |         | ✓      |
  * | 1080p_5  | 1920 × 1080     | 60          | 4780         | ✓      |         | ✓      |
+ *
+ * > <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.
  */
 export declare type VideoEncoderConfigurationPreset = keyof typeof SUPPORT_VIDEO_ENCODER_CONFIG_LIST;