@volcengine/veplayer 2.5.0-rc.1 → 2.6.0-rc.0

package/esm/veplayer.d.ts

@@ -359,7 +359,7 @@ import MobilePanel = MobilePlayerPanelWrapper.MobilePlayerPanel;
  */
 declare enum ListType {
     /** {zh}
-     * @brief 全屏布局
+     * @brief 全屏布局。
      * @hidden
      */
     /** {en}
@@ -368,21 +368,21 @@ declare enum ListType {
      */
     Middle = "middle",
     /** {zh}
-     * @brief 底部抽屉
+     * @brief 底部抽屉。
      */
     /** {en}
      * @brief Bottom navigation drawer.
      */
     Bottom = "bottom",
     /** {zh}
-     * @brief 右侧抽屉，常用于全屏时展示
+     * @brief 右侧抽屉，常用于全屏时展示。
      */
     /** {en}
      * @brief Right navigation drawer. This is often used for fullscreen display.
      */
     Fullscreen = "fullscreen",
     /** {zh}
-     * @brief 窗口蒙层展示
+     * @brief 窗口蒙层展示。
      */
     /** {en}
      * @brief Overlay.
@@ -470,14 +470,15 @@ declare class OptionsIcon extends Plugin {
 }
 /** {zh}
  * @detail error
+ * @brief 错误等级。
  */
 /** {en}
  * @detail error
+ * @brief Error level.
  */
 declare enum Level {
     /** {zh}
-     * @brief 严重
-     *
+     * @brief 严重。
      */
     /** {en}
      * @brief Fatal.
@@ -485,7 +486,7 @@ declare enum Level {
      */
     Fatal = "Fatal",
     /** {zh}
-     * @brief 报错
+     * @brief 报错。
      */
     /** {en}
      * @brief Error.
@@ -851,7 +852,7 @@ interface ErrorInfo<T = TextKey> {
 /** {zh}
  * @list error
  * @detail error
- * @brief 错误对象
+ * @brief 错误对象。
  * @name VeError
  * @id VeError
  */
@@ -863,11 +864,11 @@ interface ErrorInfo<T = TextKey> {
  * @id VeError
  */
 declare class VeError<T extends string = TextKey> extends Error {
-    /**
+    /** {zh}
      * @brief 错误码。
      */
     /** {en}
-     * @brief The error code.
+     * @brief Error code.
      */
     readonly errorCode: ErrorCode;
     /** {zh}
@@ -1230,11 +1231,9 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     poster?: string;
     /** {zh}
      * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
-     * @default -
      */
     /** {en}
      * @brief The initial display language of the player. If the language pack does not exist, the 'en'language pack will be displayed by default. The default value is `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`.
-     * @default -
      */
     lang?: Lang;
     /** {zh}
@@ -1293,25 +1292,20 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
      * @brief Whether to display the full-screen button.
      * - `true`: Display;
      * - `false`: Do not display.
-     * @default -
      */
     fullscreen?: boolean | Fullscreen;
     /** {zh}
      * @brief 为播放器设置报错信息，支持配置播放异常时，播放器显示的异常文案、图片，以及是否提供刷新按钮等。
-     * @default -
      */
     /** {en}
      * @brief The error message of the player. When a playback error occurs, you can configure the error message and image displayed and whether to display the refresh button.
-     * @default -
      */
     error?: ErrorConfig;
     /** {zh}
      * @brief 为播放器设置清晰度的相关配置。
-     * @default -
      */
     /** {en}
      * @brief Resolution-related configurations.
-     * @default -
      */
     definition?: DefinitionConfig;
     /** {zh}
@@ -1572,8 +1566,7 @@ interface Fullscreen {
      * `true`: Display;
      * `false`: Do not display.
      * @default false
-     * @brief
-     *        Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
+     * @brief Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
      *        - `true`: Display;
      *        - `false`: Do not display.
      */
@@ -1591,7 +1584,7 @@ interface Fullscreen {
  */
 interface CommonStyle {
     /** {zh}
-     * @brief 进度条底色
+     * @brief 进度条底色。
      * @default 无
      */
     /** {en}
@@ -1599,7 +1592,7 @@ interface CommonStyle {
      */
     progressColor?: string;
     /** {zh}
-     * @brief 播放完成部分进度条底色
+     * @brief 播放完成部分进度条底色。
      * @default 无
      */
     /** {en}
@@ -1607,7 +1600,7 @@ interface CommonStyle {
      */
     playedColor?: string;
     /** {zh}
-     * @brief 缓存部分进度条底色
+     * @brief 缓存部分进度条底色。
      * @default 无
      */
     /** {en}
@@ -1616,7 +1609,7 @@ interface CommonStyle {
      */
     cachedColor?: string;
     /** {zh}
-     * @brief 进度条滑块样式
+     * @brief 进度条滑块样式。
      * @default 无
      */
     /** {en}
@@ -1627,7 +1620,7 @@ interface CommonStyle {
         [propName: string]: any;
     };
     /** {zh}
-     * @brief 音量颜色
+     * @brief 音量颜色。
      * @default 无
      */
     /** {en}
@@ -1651,14 +1644,14 @@ type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
  */
 declare enum Codec {
     /** {zh}
-     * @brief H.265 编码格式
+     * @brief H.265 编码格式。
      */
     /** {en}
      * @brief H.265.
      */
     H265 = "h265",
     /** {zh}
-     * @brief H.264 编码格式
+     * @brief H.264 编码格式。
      */
     /** {en}
      * @brief H.264.
@@ -1675,18 +1668,18 @@ declare enum Codec {
  */
 declare enum Degradation {
     /** {zh}
-     * @brief 硬解不支持降级到软解
+     * @brief 硬解不支持时，优先降级到软解。
      */
     /** {en}
-     * @brief The player does not support falling back to software decoding.
+     * @brief When hardware decoding is not supported, prioritize downgrading to software decoding.
      */
     SoftFirst = "soft-first",
     /** {zh}
-     * @brief 硬解不支持降级到h264
+     * @brief 硬解不支持时，优先降级到 H.264 解码。
      * @hidden
      */
     /** {en}
-     * @brief The player does not support falling back to H.264.
+     * @brief When hardware decoding is not supported, prioritize downgrading to H.264 decoding.
      * @hidden
      */
     H264First = "h264-first"
@@ -1703,14 +1696,14 @@ declare enum Degradation {
  */
 declare enum DecodeType {
     /** {zh}
-     * @brief 软解
+     * @brief 软解。
      */
     /** {en}
      * @brief Software decoding.
      */
     Software = "software",
     /** {zh}
-     * @brief 硬解
+     * @brief 硬解。
      */
     /** {en}
      * @brief Hardware decoding.
@@ -1900,6 +1893,11 @@ declare class VePlayerBase {
     /** {zh}
      * 获取播放器版本号
      * @returns
+     * @brief
+     *        获取播放器 SDK 版本号。
+     */
+    /** {en}
+     * @brief Retrieve the player SDK version number.
      */
     get playerVersion(): string;
     /** {zh}
@@ -1987,8 +1985,8 @@ declare class VePlayerBase {
     static create<T extends VePlayerBase>(options?: VePlayerBaseOptions, Constructor?: Constructor<T>): Promise<T>;
     /** {zh}
      * @brief 调用此方法切换拉流地址、线路、清晰度。
-     * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
-     * @param options 更多配置信息
+     * @param target 目标地址，可以是播放地址，也可以是线路和清晰度。
+     * @param options 更多配置信息。
      */
     /** {en}
      * @brief Switches the pull stream address, playback source, or resolution.
@@ -2025,11 +2023,12 @@ declare class VePlayerBase {
          */
         fallbackToFirstDefinition?: boolean;
         /** {zh}
-         * @brief 是否无缝切换
-         * - true: 无缝切换
-         * - false: 非无缝切换
+         * @brief 是否无缝切换，true 为无缝切换，false 为非无缝切换。
          * @default false
          */
+        /** {en}
+         * @brief Whether seamless switching or not. True means seamless switching and false means non-seamless switching.
+         */
         seamless?: boolean;
     }): Promise<ExposedDefinition>;
     /** {zh}
@@ -2065,16 +2064,15 @@ declare class VePlayerBase {
         source?: string;
     }): Promise<void>;
     // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
-    /**
     /** {zh}
      * @brief 调用此方法监听指定事件，事件处理函数只执行一次。
      * @param event 表示事件的名称。
      * @param callback 表示事件的回调函数。
      */
     /** {en}
-     * @brief Add a one-time listener function for the specified event.
-     * @param event The event name.
-     * @param callback The callback function for the event.
+     * @brief Call this method to listen for the specified event. The event handler is executed only once.
+     * @param event The name representing the event.
+     * @param callback Callback functions representing events.
      */
     once(event: string, callback: (data?: any) => any): void;
     /** {zh}
@@ -2200,10 +2198,14 @@ declare class VePlayerBase {
         ignorePaused?: boolean;
     }): void;
     /** {zh}
-     * @brief 判断浏览器是否支持播放格式
-     * @param type 播放格式
+     * @brief 判断浏览器是否支持播放格式。
+     * @param type 播放格式。
      * @returns
      */
+    /** {en}
+     * @brief Determine whether the browser supports the playback format.
+     * @param type The playback format.
+     */
     canPlayType(type: string): boolean;
     /** {zh}
      * @brief 调用此方法进入系统全屏状态。如果该方法调用的时候处于网页全屏状态会自动退出网页全屏，下发事件 `Events.FULLSCREEN_CHANGE`。
@@ -2283,7 +2285,7 @@ declare class VePlayerBase {
     unRegisterPlugin(plugin: any): void;
     /** {zh}
      * @brief 调用此接口显示指定插件图标。
-     * @param pluginNames 插件名称
+     * @param pluginNames 插件名称。
      */
     /** {en}
      * @brief Displays the icon of a specified plugin.
@@ -2292,7 +2294,7 @@ declare class VePlayerBase {
     showIcon(pluginNames: string[]): void;
     /** {zh}
      * @brief 调用此接口隐藏指定插件图标。
-     * @param pluginNames 插件名称
+     * @param pluginNames 插件名称。
      */
     /** {en}
      * @brief Hides the icon of a specified plugin.
@@ -2718,7 +2720,7 @@ declare namespace strategy {
      */
     enum ListType {
         /** {zh}
-         * @brief 全屏布局
+         * @brief 全屏布局。
          * @hidden
          */
         /** {en}
@@ -2727,21 +2729,21 @@ declare namespace strategy {
          */
         Middle = "middle",
         /** {zh}
-         * @brief 底部抽屉
+         * @brief 底部抽屉。
          */
         /** {en}
          * @brief Bottom navigation drawer.
          */
         Bottom = "bottom",
         /** {zh}
-         * @brief 右侧抽屉，常用于全屏时展示
+         * @brief 右侧抽屉，常用于全屏时展示。
          */
         /** {en}
          * @brief Right navigation drawer. This is often used for fullscreen display.
          */
         Fullscreen = "fullscreen",
         /** {zh}
-         * @brief 窗口蒙层展示
+         * @brief 窗口蒙层展示。
          */
         /** {en}
          * @brief Overlay.
@@ -2829,14 +2831,15 @@ declare namespace strategy {
     }
     /** {zh}
      * @detail error
+     * @brief 错误等级。
      */
     /** {en}
      * @detail error
+     * @brief Error level.
      */
     enum Level {
         /** {zh}
-         * @brief 严重
-         *
+         * @brief 严重。
          */
         /** {en}
          * @brief Fatal.
@@ -2844,7 +2847,7 @@ declare namespace strategy {
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错
+         * @brief 报错。
          */
         /** {en}
          * @brief Error.
@@ -3212,7 +3215,7 @@ declare namespace strategy {
     /** {zh}
      * @list error
      * @detail error
-     * @brief 错误对象
+     * @brief 错误对象。
      * @name VeError
      * @id VeError
      */
@@ -3224,11 +3227,11 @@ declare namespace strategy {
      * @id VeError
      */
     class VeError<T extends string = TextKey> extends Error {
-        /**
+        /** {zh}
          * @brief 错误码。
          */
         /** {en}
-         * @brief The error code.
+         * @brief Error code.
          */
         readonly errorCode: ErrorCode;
         /** {zh}
@@ -3593,11 +3596,9 @@ declare namespace strategy {
         poster?: string;
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
-         * @default -
          */
         /** {en}
          * @brief The initial display language of the player. If the language pack does not exist, the 'en'language pack will be displayed by default. The default value is `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`.
-         * @default -
          */
         lang?: Lang;
         /** {zh}
@@ -3656,25 +3657,20 @@ declare namespace strategy {
          * @brief Whether to display the full-screen button.
          * - `true`: Display;
          * - `false`: Do not display.
-         * @default -
          */
         fullscreen?: boolean | Fullscreen;
         /** {zh}
          * @brief 为播放器设置报错信息，支持配置播放异常时，播放器显示的异常文案、图片，以及是否提供刷新按钮等。
-         * @default -
          */
         /** {en}
          * @brief The error message of the player. When a playback error occurs, you can configure the error message and image displayed and whether to display the refresh button.
-         * @default -
          */
         error?: ErrorConfig;
         /** {zh}
          * @brief 为播放器设置清晰度的相关配置。
-         * @default -
          */
         /** {en}
          * @brief Resolution-related configurations.
-         * @default -
          */
         definition?: DefinitionConfig;
         /** {zh}
@@ -3935,8 +3931,7 @@ declare namespace strategy {
          * `true`: Display;
          * `false`: Do not display.
          * @default false
-         * @brief
-         *        Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
+         * @brief Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
          *        - `true`: Display;
          *        - `false`: Do not display.
          */
@@ -3954,7 +3949,7 @@ declare namespace strategy {
      */
     interface CommonStyle {
         /** {zh}
-         * @brief 进度条底色
+         * @brief 进度条底色。
          * @default 无
          */
         /** {en}
@@ -3962,7 +3957,7 @@ declare namespace strategy {
          */
         progressColor?: string;
         /** {zh}
-         * @brief 播放完成部分进度条底色
+         * @brief 播放完成部分进度条底色。
          * @default 无
          */
         /** {en}
@@ -3970,7 +3965,7 @@ declare namespace strategy {
          */
         playedColor?: string;
         /** {zh}
-         * @brief 缓存部分进度条底色
+         * @brief 缓存部分进度条底色。
          * @default 无
          */
         /** {en}
@@ -3979,7 +3974,7 @@ declare namespace strategy {
          */
         cachedColor?: string;
         /** {zh}
-         * @brief 进度条滑块样式
+         * @brief 进度条滑块样式。
          * @default 无
          */
         /** {en}
@@ -3990,7 +3985,7 @@ declare namespace strategy {
             [propName: string]: any;
         };
         /** {zh}
-         * @brief 音量颜色
+         * @brief 音量颜色。
          * @default 无
          */
         /** {en}
@@ -4014,14 +4009,14 @@ declare namespace strategy {
      */
     enum Codec {
         /** {zh}
-         * @brief H.265 编码格式
+         * @brief H.265 编码格式。
          */
         /** {en}
          * @brief H.265.
          */
         H265 = "h265",
         /** {zh}
-         * @brief H.264 编码格式
+         * @brief H.264 编码格式。
          */
         /** {en}
          * @brief H.264.
@@ -4038,18 +4033,18 @@ declare namespace strategy {
      */
     enum Degradation {
         /** {zh}
-         * @brief 硬解不支持降级到软解
+         * @brief 硬解不支持时，优先降级到软解。
          */
         /** {en}
-         * @brief The player does not support falling back to software decoding.
+         * @brief When hardware decoding is not supported, prioritize downgrading to software decoding.
          */
         SoftFirst = "soft-first",
         /** {zh}
-         * @brief 硬解不支持降级到h264
+         * @brief 硬解不支持时，优先降级到 H.264 解码。
          * @hidden
          */
         /** {en}
-         * @brief The player does not support falling back to H.264.
+         * @brief When hardware decoding is not supported, prioritize downgrading to H.264 decoding.
          * @hidden
          */
         H264First = "h264-first"
@@ -4066,14 +4061,14 @@ declare namespace strategy {
      */
     enum DecodeType {
         /** {zh}
-         * @brief 软解
+         * @brief 软解。
          */
         /** {en}
          * @brief Software decoding.
          */
         Software = "software",
         /** {zh}
-         * @brief 硬解
+         * @brief 硬解。
          */
         /** {en}
          * @brief Hardware decoding.
@@ -4199,22 +4194,22 @@ declare function getStreamType(url: string): "unknown" | "hls" | "flv" | "rtm" |
  * @detail api
  * @brief 当前浏览器是否支持播放编码格式。
  * @param codec 编码格式。
- * `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends
- * `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+ *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
+ *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
  * @returns
  */
 /** {en}
  * @detail api
  * @brief Checkes whether the current browser supports the specified encoding format.
  * @param codec The encoding format.
- * `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
- * `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+ *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
+ *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
  * @returns
  */
 declare function isMseSupported(codec?: string): boolean;
 /** {zh}
  * @detail api
- * @brief 当前浏览器是否支持软解
+ * @brief 当前浏览器是否支持软解。
  * @returns
  */
 /** {en}
@@ -4448,14 +4443,15 @@ declare namespace error {
     }
     /** {zh}
      * @detail error
+     * @brief 错误等级。
      */
     /** {en}
      * @detail error
+     * @brief Error level.
      */
     enum Level {
         /** {zh}
-         * @brief 严重
-         *
+         * @brief 严重。
          */
         /** {en}
          * @brief Fatal.
@@ -4463,7 +4459,7 @@ declare namespace error {
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错
+         * @brief 报错。
          */
         /** {en}
          * @brief Error.
@@ -4831,7 +4827,7 @@ declare namespace error {
     /** {zh}
      * @list error
      * @detail error
-     * @brief 错误对象
+     * @brief 错误对象。
      * @name VeError
      * @id VeError
      */
@@ -4843,11 +4839,11 @@ declare namespace error {
      * @id VeError
      */
     class VeError<T extends string = TextKey> extends Error {
-        /**
+        /** {zh}
          * @brief 错误码。
          */
         /** {en}
-         * @brief The error code.
+         * @brief Error code.
          */
         readonly errorCode: ErrorCode;
         /** {zh}
@@ -5234,20 +5230,16 @@ interface LoggerConfig {
 interface LiveVePlayerOptions extends VePlayerBaseOptions {
     /** {zh}
      * @brief 为播放器设置 RTM 拉流配置。
-     * @default -
      */
     /** {en}
      * @brief Configurations for playing an RTM stream.
-     * @default -
      */
     rtm?: Rtm;
     /** {zh}
      * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-     * @default -
      */
     /** {en}
      * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-     * @default -
      */
     flv?: Flv;
     /** {zh}
@@ -5265,29 +5257,30 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
     hls?: Hls;
     /** {zh}
      * @brief 为播放器设置直播信息展示面板配置，支持设置是否显示面板和信息刷新时间间隔。当前直播信息面板支持展示 HLS 和 FLV 格式的直播信息，如果是软解播放，会额外显示软解相关信息。
-     * @default -
      */
     /** {en}
      * @brief Configures the information panel for the player, including options to show/hide the panel and the time interval between each information update. The panel supports displaying information for HLS and FLV addresses. If you opt for software decoding, additional information related to software decoding will be displayed.
-     * @default -
      */
     infoPanel?: InfoPanelConfig;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @brief Configurations for advertising
+     */
+    ad?: AdConfig;
     /** {zh}
      * @brief 为播放器设置直播时移配置，接入方法请参见[功能接入](https://www.volcengine.com/docs/6469/138655#直播时移)。
-     * @default -
      */
     /** {en}
      * @brief Configurations for time shifting.
-     * @default -
      */
     timeShift?: TimeShiftConfig;
     /** {zh}
      * @brief 日志上报配置，支持设置开启/关闭开始日志上报并设置日志参数，接入方法请参见[功能接入](https://www.volcengine.com/docs/6469/138655#日志上报)。
-     * @default -
      */
     /** {en}
      * @brief Configurations for log upload. Supports enabling/disabling log upload and setting log parameters.
-     * @default -
      */
     logger?: LoggerConfig;
     /** {zh}
@@ -5307,13 +5300,10 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      */
     icons?: any;
     /** {zh}
-     * @hidden
      * @brief 商业 DRM 播放配置。
-     * @default -
      */
     /** {en}
      * @brief Digital Rights Management (DRM) configurations.
-     * @default -
      */
     drm?: Drm;
 }
@@ -5327,31 +5317,56 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
  */
 interface Abr {
     /** {zh}
-     * @brief 是否开启 abr
-     * - true: 开启
-     * - false: 关闭
+     * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
+     *        - true: 开启
+     *        - false: 关闭
      * @default true
      */
+    /** {en}
+     * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
+     *        - true: Enable;
+     *        - false: Disable.
+     */
     enable?: boolean;
     /** {zh}
-     * @brief 未开启abr的时候，是否开启降码率建议
-     * - true: 开启
-     * - false: 关闭
+     * @brief 未开启 ABR 时，是否开启码率切换建议事件发送，默认为关闭。
+     *        - true: 开启；
+     *        - false: 关闭。
      * @default false
+     * @hidden
+     */
+    /** {en}
+     * @brief When ABR is disabled, determine whether to enable the bitrate switch suggestion event. The default setting is false.
+     *        - true: Enable;
+     *        - false: Disable.
+     * @hidden
      */
     downTip?: boolean;
     /** {zh}
-     * @brief 是否开始调试模式
-     * - true: 开启
-     * - false: 关闭
+     * @brief 是否开始调试模式，默认为关闭。
+     *        - true: 开启；
+     *        - false: 关闭。
+     * @default false
+     */
+    /** {en}
+     * @brief Whether to start debug mode, default is false.
+     *        - true: Enable,
+     *        - false: Disable.
+     * @default false
      */
     debug?: boolean;
     /** {zh}
-     * @brief url 参数对应的码率
+     * @brief 当前拉流地址 URL 对应的码率。
+     */
+    /** {en}
+     * @brief The bitrate corresponding to the current pull-stream address URL.
      */
     bitrate?: number;
     /** {zh}
-     * @brief 多个码率的拉流地址
+     * @brief 自适应码率流信息。
+     */
+    /** {en}
+     * @brief Adaptive bitrate (ABR) stream information.
      */
     urls?: {
         [bitrate: number]: string;
@@ -5360,35 +5375,53 @@ interface Abr {
 /** {zh}
  * @list option
  * @kind property
+ * @hidden
  */
 /** {en}
  * @list option
  * @kind property
+ * @hidden
  */
 interface HlsAbr {
     /** {zh}
-     * @brief 是否开启 abr
-     * - true: 开启
-     * - false: 关闭
+     * @brief 是否开启 HLS 拉流自适应码率（ABR）功能，默认为开启。
+     *        - true: 开启；
+     *        - false: 关闭。
      * @default true
      */
+    /** {en}
+     * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
+     *        - true: Enable;
+     *        - false: Disable.
+     */
     enable?: boolean;
     /** {zh}
-     * @brief 未开启abr的时候，是否开启降码率建议
-     * - true: 开启
-     * - false: 关闭
+     * @brief 未开启 ABR 时，是否开启码率切换建议事件发送，默认为关闭。
+     *        - true: 开启；
+     *        - false: 关闭。
      * @default false
      */
+    /** {en}
+     * @brief When ABR is disabled, determine whether to enable the bitrate switch suggestion event. The default setting is false.
+     *        - true: Enable;
+     *        - false: Disable.
+     */
     downTip?: boolean;
     /** {zh}
-     * @brief 是否开始调试模式
-     * - true: 开启
-     * - false: 关闭
+     * @brief 是否开始调试模式，默认为关闭。
+     *        - true: 开启；
+     *        - false: 关闭。
+     * @default false
+     */
+    /** {en}
+     * @brief Whether to start debug mode, default is false.
+     *        - true: Enable,
+     *        - false: Disable.
+     * @default false
      */
     debug?: boolean;
 }
 /** {zh}
- * @hidden
  * @list option
  * @kind property
  */
@@ -5398,15 +5431,14 @@ interface HlsAbr {
  */
 interface Drm {
     /** {zh}
-     * @brief FairPlay DRM 配置
+     * @brief FairPlay DRM 配置。
      */
     /** {en}
-     * @brief FairPlay DRM configurations
+     * @brief FairPlay DRM configurations.
      */
     fairplay?: FairplayDrm;
 }
 /** {zh}
- * @hidden
  * @list option
  * @kind property
  */
@@ -5416,7 +5448,6 @@ interface Drm {
  */
 interface FairplayDrm extends FairplayDrmConfig {
     /** {zh}
-     * @hidden
      * @brief 获取 DRM 配置的方法，用于更新 DRM 配置。
      * @param config
      * @returns 证书的请求地址和内容密钥许可证的请求地址。
@@ -5431,7 +5462,6 @@ interface FairplayDrm extends FairplayDrmConfig {
     }) => Promise<FairplayDrmConfig>;
 }
 /** {zh}
- * @hidden
  * @list option
  * @kind property
  */
@@ -5441,17 +5471,17 @@ interface FairplayDrm extends FairplayDrmConfig {
  */
 interface FairplayDrmConfig {
     /** {zh}
-     * @brief 获取证书的请求地址
+     * @brief 获取证书的请求地址。
      */
     /** {en}
-     * @brief URL used to acquire the FairPlay certificate
+     * @brief URL used to acquire the FairPlay certificate.
      */
     serverCertificatePath?: string;
     /** {zh}
-     * @brief 获取内容密钥许可证的请求地址
+     * @brief 获取内容密钥许可证的请求地址。
      */
     /** {en}
-     * @brief URL used to acquire the DRM license
+     * @brief URL used to acquire the DRM license.
      */
     serverProcessSPCPath?: string;
 }
@@ -5500,6 +5530,76 @@ interface TimeShiftConfig {
      */
     position?: string;
 }
+/** {zh}
+ * @hidden
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Advertising schedule for a single ad break
+ */
+interface AdRule {
+    /** {en}
+     * @brief When to play the configured ad tag
+     *        - `pre`:  Ad plays as a preroll
+     *        - `post`:  Ad plays as a postroll
+     *        - (timecode): Ad plays at a specific time, in HH:MM:SS or HH:MM:SS.sss format
+     */
+    offset: string;
+    /** {en}
+     * @brief URL of the ad tag for IMA plugins, must be a VAST xml
+     */
+    tag: string;
+}
+/** {zh}
+ * @hidden
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Configurations for Google IMA SDK
+ */
+interface ImaConfig {
+    /** {en}
+     * @brief URL of the ad tag for IMA plugins
+     */
+    adTagUrl?: string;
+    /** {en}
+     * @brief URL of the ad tag for IMA plugins when enableSCTE35 is `true`, must be a VAST xml
+     */
+    adTagUrlForSCTE35?: string;
+    /** {en}
+     * @brief The entire advertising schedule, containing multiple ad breaks
+     */
+    schedule?: AdRule[];
+}
+/** {zh}
+ * @hidden
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Configurations for advertising
+ */
+interface AdConfig {
+    /** {en}
+     * @brief Ad client that will be used to display advertisements
+     *        - `google-ima`：Use the Google IMA SDK
+     */
+    adType: "google-ima";
+    /** {en}
+     * @brief Property enabling SCTE-35 tag in hls manifest
+     * - false: SCTE-35 disabled
+     * - true: SCTE-35 enabled
+     * @default false
+     */
+    enableSCTE35?: boolean;
+    /** {en}
+     * @brief Configurations for Google IMA SDK
+     * @listtip Required when adType is `google-ima`
+     */
+    ima?: ImaConfig;
+}
 /** {zh}
  * @list option
  * @kind property
@@ -5575,9 +5675,12 @@ interface Rtm {
      */
     enableRTMAutoTranscode?: boolean;
     /** {zh}
-     * @brief 评估当前网络情况的间隔
+     * @brief 指定进行网络评估的最近时间长度，单位为毫秒，默认为 1000，表示对最近 1000 毫秒内的网络情况进行评估。
      * @default 1000
      */
+    /** {en}
+     * @brief Specify the recent time length for network evaluation in milliseconds. The default is 1000, which means evaluating the network conditions over the last 1000 milliseconds.
+     */
     networkEvaluateInterval?: number;
 }
 /** {zh}
@@ -5630,28 +5733,55 @@ interface Flv {
      */
     enableLowLatency?: boolean;
     /** {zh}
-     * @brief 播放器发起 FLV 拉流请求时，开启低延时的详细配置。。
-     * @default -
+     * @brief 低延时的详细配置。
      */
     /** {en}
-     * @brief
-     * @default -
+     * @brief Detailed configuration for low latency.
      */
     lowLatency?: LowLatency;
     /** {zh}
-     * @brief 为播放器设置 FLV Abr 配置。
-     * @default -
+     * @brief 为播放器设置 FLV 拉流时的 自适应码率（ABR）配置。
+     */
+    /** {en}
+     * @brief Set the Adaptive Bitrate (ABR) configuration for FLV streaming in the player.
      */
     abr?: Abr;
     /** {zh}
      * @hidden
      */
+    /** {en}
+     * @hidden
+     */
     mseLowLatency?: boolean;
     /** {zh}
-     * @brief 超过 maxReaderInterval 时间还没有新数据返回视为断流，播放器触发 ended 事件, 单位 s。
-     * @default 5
+     * @brief 设置无数据返回最大时长，单位为毫秒，默认值为 5000，超过最大时长将被判断为断流，并触发 ended 事件。
+     * @default 5000
+     */
+    /** {en}
+     * @brief Set the maximum duration for no data return in milliseconds. The default value is 5. If this duration is exceeded, it will be considered a stream interruption and trigger an ended event.
      */
     maxReaderInterval?: number;
+    /** {zh}
+     * @brief
+     *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+     * @default 0
+     */
+    /** {en}
+     * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+     * @default 0
+     */
+    disconnectTime?: number;
+    /** {zh}
+     * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
+     *        - `true`：是；
+     *        - `false`：否。
+     * @default false
+     */
+    /** {en}
+     * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+     * @default false
+     */
+    seamlesslyReload?: boolean;
 }
 /** {zh}
  * @list option
@@ -5670,15 +5800,15 @@ interface LowLatency {
      */
     abrPts?: string | number;
     /** {zh}
-     * @brief FLV 低延时模式下，是否允许追帧
-     * - true：开启
-     * - false：关闭
+     * @brief FLV 低延时模式下，是否开启倍速追帧。
+     *        - true：开启；
+     *        - false：关闭。
      * @default true
      */
     /** {en}
-     * @brief
-     * - true: Enable
-     * - false: Disable
+     * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
+     *        - true: enabled;
+     *        - false: disabled.
      * @default true
      */
     enableFrameChasing?: boolean;
@@ -5733,8 +5863,12 @@ interface Hls {
      */
     enableMSE?: boolean;
     /** {zh}
-     * @brief 为播放器设置 HLS Abr 配置。
-     * @default -
+     * @brief 为播放器设置 HLS 拉流时的 自适应码率（ABR）配置。
+     * @hidden
+     */
+    /** {en}
+     * @brief Set the Adaptive Bitrate (ABR) configuration for HLS streaming in the player.
+     * @hidden
      */
     abr?: HlsAbr;
     /**
@@ -5742,83 +5876,415 @@ interface Hls {
      */
     mseLowLatency?: boolean;
 }
+/** {zh}
+ * @list option
+ * @kind property
+ * @brief 在 RTM 拉流场景下，获取到的网络情况。
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Network conditions obtained in the RTM pull stream scenario.
+ */
 interface RTMNetWorkInfo {
     /** {zh}
-     * @brief 当前下载速度
+     * @brief 最近一次网络评估周期内的下载速度, 单位为 bps。
+     */
+    /** {en}
+     * @brief The download speed within the latest network evaluation period, in units of bps.
      */
     speed?: number;
     /** {zh}
-     * @brief 当前平均下载速度
+     * @brief 最近 5 次网络评估周期内下载速度平均值，单位为 bps。
+     */
+    /** {en}
+     * @brief The average download speed within the recent 5 network evaluation cycles, with the unit of bps.
      */
     avgSpeed?: number;
     /** {zh}
-     * @brief 当前丢包率
+     * @brief 最近一次网络评估周期内的网络丢包率。
+     */
+    /** {en}
+     * @brief The packet loss rate of the network within the latest network evaluation cycle.
      */
     lostRate?: number;
     /** {zh}
-     * @brief 当前平均丢包率
+     * @brief 最近 5 次网络评估周期内的网络丢包率平均值。
+     */
+    /** {en}
+     * @brief The average network packet loss rate within the recent 5 network evaluation cycles.
      */
     avgLostRate?: number;
 }
 /** {zh}
- * @brief RTM 信息
+ * @list option
+ * @kind property
+ * @brief RTM 直播流播放信息。
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief RTM live stream information.
  */
 interface StatsSnapShoot {
+    /** {en}
+     * @brief Video information.
+     */
+    /** {zh}
+     * @brief 视频信息。
+     */
     video?: {
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         codec: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         payloadType: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         sdpFmtpLine: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         bytesReceived: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         firCount: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         pliCount: number;
+        /** {zh}
+         * @brief 视频高度
+         */
+        /** {en}
+         * @brief 视频高度
+         */
         frameHeight: number;
+        /** {zh}
+         * @brief 视频宽度
+         */
+        /** {en}
+         * @brief 视频宽度
+         */
         frameWidth: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         framesDecoded: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         framesDropped: number;
+        /** {zh}
+         * @brief 视频帧率
+         */
+        /** {en}
+         * @brief 视频帧率
+         */
         framesPerSecond: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         framesReceived: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         jitter: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         jitterBufferDelay: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         keyFramesDecoded: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         nackCount: number;
-        packetsLost: number;
-        packetsReceived: number;
+        /** {zh}
+         * @brief 视频丢包总数
+         */
+        /** {en}
+         * @brief 视频丢包总数
+         */
+        packetsLost: number;
+        /** {zh}
+         * @brief 视频收包总数
+         */
+        /** {en}
+         * @brief 视频收包总数
+         */
+        packetsReceived: number;
     };
+    /** {en}
+     * @brief Audio information.
+     */
+    /** {zh}
+     * @brief 音频信息。
+     */
     audio?: {
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         codec: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         payloadType: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         sdpFmtpLine: string;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         audioLevel: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         bytesReceived: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         jitter: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         jitterBufferDelay: number;
+        /** {zh}
+         * @brief 音频丢包总数
+         */
+        /** {en}
+         * @brief 音频丢包总数
+         */
         packetsLost: number;
+        /** {zh}
+         * @brief 音频收包总数
+         */
+        /** {en}
+         * @brief 音频收包总数
+         */
         packetsReceived: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         totalSamplesDuration: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         totalSamplesReceived: number;
     };
 }
 /** {zh}
- * @brief FLV 信息
+ * @list option
+ * @kind property
+ * @brief FLV 直播流播放信息。
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief FLV live stream information.
  */
 interface FlvStats {
+    /** {zh}
+     * @brief 音频格式。
+     * @hidden
+     */
+    /** {en}
+     * @brief Audio format.
+     * @hidden
+     */
     audioCodec: string;
+    /** {zh}
+     * @brief 平均下载速度。
+     */
+    /** {en}
+     * @brief Average download speed.
+     */
     avgSpeed: number;
+    /** {zh}
+     * @brief 码率。
+     */
+    /** {en}
+     * @brief bitrate.
+     */
     bitrate: number;
+    /** {zh}
+     * @brief 剩余缓冲时间。
+     */
+    /** {en}
+     * @brief Remaining buffer time.
+     */
     bufferEnd: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     channelCount: number;
+    /** {zh}
+     * @brief 当前播放时间。
+     */
+    /** {en}
+     * @brief The current playing time.
+     */
     currentTime: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     decodeFps: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     domain: string;
+    /** {zh}
+     * @brief 当前下载速度。
+     */
+    /** {en}
+     * @brief Current download speed.
+     */
     downloadSpeed: number;
+    /** {zh}
+     * @brief 编码方式。
+     */
+    /** {en}
+     * @brief Encoding method.
+     */
     encodeType: string;
+    /** {zh}
+     * @brief 帧率。
+     */
+    /** {en}
+     * @brief Frame rate.
+     */
     fps: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     gop: number;
+    /** {zh}
+     * @brief 视频高度。
+     */
+    /** {en}
+     * @brief Video height.
+     */
     height: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     samplerate: number;
+    /** {zh}
+     * @brief 总共收到的字节数。
+     */
+    /** {en}
+     * @brief The total number of bytes received.
+     */
     totalReceivedByte: number;
+    /** {zh}
+     * @brief 接收所有字节消耗时长。
+     */
+    /** {en}
+     * @brief The time consumed for receiving all bytes.
+     */
     totalReceivedCost: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
     videoCodec: string;
+    /** {zh}
+     * @brief 视频宽度。
+     */
+    /** {en}
+     * @brief Video wight.
+     */
     width: number;
 }
 /** {zh}
@@ -5842,7 +6308,10 @@ declare class VePlayerLive extends VePlayerBase {
      */
     constructor(options: LiveVePlayerOptions);
     /** {zh}
-     * @brief 获取已经播放的时间
+     * @brief 获取已经播放的时长，不包含暂停和等待时间，单位为秒。
+     */
+    /** {en}
+     * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
      */
     get playTime(): number;
     /** {zh}
@@ -5876,49 +6345,80 @@ declare class VePlayerLive extends VePlayerBase {
      */
     closeInfoPanel(): void;
     /** {zh}
-     * @brief 打开 Abr
+     * @brief 打开码率自适应（ABR）切换功能。
+     */
+    /** {en}
+     * @brief Enable the Adaptive Bitrate Streaming (ABR) switching feature.
      */
     openAbr(): void;
     /** {zh}
-     * @brief 关闭 Abr
+     * @brief 关闭码率自适应（ABR）切换功能。
+     */
+    /** {en}
+     * @brief Disable the Adaptive Bitrate Streaming (ABR) switching feature.
      */
     closeAbr(): void;
     /** {zh}
-     * @brief 调用此方法更新 DRM 鉴权配置。
-     * @hidden
+     * @brief 调用此方法更新 DRM 配置。
+     */
+    /** {en}
+     * @brief Use this method to update DRM configuration.
+     * @param config
      */
     updateDrmConfig(config: FairplayDrmConfig): void;
     /** {zh}
-     * @brief 切换 flv Abr
-     * @param options 切换 Abr 的配置。
+     * @brief 修改 ABR 配置，包含修改是否开启 ABR 功能，和修改其他清晰度。
+     * @param options ABR 的配置。
      * @returns
      */
+    /** {en}
+     * @brief Modify ABR configuration, including enabling or disabling the ABR feature and adjusting other resolutions.
+     * @param options Configuration of ABR.
+     */
     switchAbr(options: {
         /** {zh}
-         * @brief 是否开启 Abr
-         * - true: 开启
-         * - false: 关闭
+         * @brief 是否开启 ABR 功能。
+         *        - true：开启
+         *        - false：关闭
+         */
+        /** {en}
+         * @brief Whether to enable the ABR function.
+         *        - true: Enabled ;
+         *        - false: Disabled
+         * @default -
          */
         enable: boolean;
         /** {zh}
-         * @brief 切换 Abr 的码率
+         * @brief 切换自适应码率直播流对应的码率。
+         */
+        /** {en}
+         * @brief Switch the bitrate corresponding to the Adaptive Bitrate (ABR) live stream.
          */
         bitrate: number;
     }): void;
     /** {zh}
-     * @brief 获取 RTM 的网络相关信息
+     * @brief 获取 RTM 拉流的网络评估信息。
      * @returns
      */
+    /** {en}
+     * @brief Obtain the network assessment information of RTM pull streaming.
+     */
     getRTMNetWorkInfo(): RTMNetWorkInfo;
     /** {zh}
-     * @brief 获取 RTM 播放信息
+     * @brief 获取 RTM 拉流的播放信息。
      * @returns
      */
+    /** {en}
+     * @brief Obtain the playback information of RTM pull stream.
+     */
     getRTMStats(): Promise<StatsSnapShoot>;
     /** {zh}
-     * @brief 获取 FLV 播放信息
+     * @brief 获取 FLV 拉流的播放信息。
      * @returns
      */
+    /** {en}
+     * @brief Obtain the playback information of FLV pull streaming.
+     */
     getFLVStats(): FlvStats;
 }
 /** {zh}
@@ -5976,7 +6476,7 @@ declare function isRTMSupported(): Promise<boolean>;
 /** {zh}
  * @detail api
  * @brief 当前浏览器是否支持 H264 RTM 流播放。
- * @param codec 播放格式，目前只支持 `H264`
+ * @param codec 播放格式，目前只支持 `H264`。
  * @returns
  */
 /** {en}
@@ -6130,14 +6630,15 @@ declare namespace live {
     }
     /** {zh}
      * @detail error
+     * @brief 错误等级。
      */
     /** {en}
      * @detail error
+     * @brief Error level.
      */
     enum Level {
         /** {zh}
-         * @brief 严重
-         *
+         * @brief 严重。
          */
         /** {en}
          * @brief Fatal.
@@ -6145,7 +6646,7 @@ declare namespace live {
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错
+         * @brief 报错。
          */
         /** {en}
          * @brief Error.
@@ -6513,7 +7014,7 @@ declare namespace live {
     /** {zh}
      * @list error
      * @detail error
-     * @brief 错误对象
+     * @brief 错误对象。
      * @name VeError
      * @id VeError
      */
@@ -6525,11 +7026,11 @@ declare namespace live {
      * @id VeError
      */
     class VeError<T extends string = TextKey> extends Error {
-        /**
+        /** {zh}
          * @brief 错误码。
          */
         /** {en}
-         * @brief The error code.
+         * @brief Error code.
          */
         readonly errorCode: ErrorCode;
         /** {zh}
@@ -7025,20 +7526,32 @@ declare namespace live {
         REFRESH_CLICK = "refreshClick",
         /** {zh}
          * Abr 切换码率
+         * @brief 切换自适应码率流
+         */
+        /** {en}
+         * @brief Event for switching Adaptive Bitrate (ABR) streams.
          */
         ABR_SWITCH_START = "abrSwitchStart",
         /** {zh}
          * Abr 切换码率成功
+         * @brief 成功切换自适应码率直播流
+         */
+        /** {en}
+         * @brief Event of successfully switching Adaptive Bitrate (ABR) live stream.
          */
         ABR_SWITCH_SUCCESS = "abrSwitchedSuccess",
         /** {zh}
          * Abr 切换码率失败
+         * @brief 切换自适应码率直播流失败
+         */
+        /** {en}
+         * @brief Event of failing to switch Adaptive Bitrate (ABR) live stream.
          */
         ABR_SWITCH_FAILED = "abrSwitchFailed"
     }
     /** {zh}
      * @detail events
-     * @brief 事件回调
+     * @brief 事件回调。
      * @hiddenDefault
      * @example
      * ```js
@@ -7181,6 +7694,8 @@ declare namespace live {
         /** {en}
          * The player has focus.
          * @param data Information about the event.
+         * @brief
+         *        The player has focus.
          */
         [LiveEvents.PLAYER_FOCUS]: (data: {
             /** {zh}
@@ -7568,53 +8083,77 @@ declare namespace live {
             };
         }) => void;
         /** {zh}
-         * 时移状态切换。
+         * @brief 时移状态切换。
          * @param isTimeShift 是否是时移状态。
          */
         /** {en}
-         * The time-shift state changes.
+         * @brief The time-shift state changes.
          * @param isTimeShift Whether the live stream is time-shifted.
          */
         [LiveEvents.TIME_SHIFT_CHANGE]: (isTimeShift: boolean) => void;
         /** {zh}
-         * 点击刷新按钮。
+         * @brief 点击刷新按钮。
          */
         /** {en}
-         * The user clicks the Refresh button.
+         * @brief The user clicks the Refresh button.
          */
         [LiveEvents.REFRESH_CLICK]: () => void;
         /** {zh}
-         * Abr 切换码率
+         * @brief 切换自适应码率流的事件回调。
+         */
+        /** {en}
+         * @brief Event callback for switching Adaptive Bitrate (ABR) streams.
          */
         [LiveEvents.ABR_SWITCH_START]: (data: {
             /** {zh}
-             * 切换的码率
+             * @brief 切换后的码率。
+             */
+            /** {en}
+             * @brief Bitrate after switching.
              */
             bitrate: number;
         }) => void;
         /** {zh}
-         * Abr 切换码率成功
+         * @brief 成功切换自适应码率流的事件回调。
+         */
+        /** {en}
+         * @brief Event callback of successfully switching Adaptive Bitrate (ABR) live stream.
          */
         [LiveEvents.ABR_SWITCH_SUCCESS]: (data: {
             /** {zh}
-             * 切换的码率
+             * @brief 切换后的码率。
+             */
+            /** {en}
+             * @brief Bitrate after switching.
              */
             bitrate: number;
-            /**
-             * 切换的地址
+            /** {zh}
+             * @brief 切换后的播放地址。
+             */
+            /** {en}
+             * @brief The playback address after the switch.
              */
             url: string;
         }) => void;
         /** {zh}
-         * Abr 切换码率失败
+         * @brief 切换自适应码率直播流失败的事件回调。
+         */
+        /** {en}
+         * @brief Event callback of failing to switch Adaptive Bitrate (ABR) live stream.
          */
         [LiveEvents.ABR_SWITCH_FAILED]: (data: {
             /** {zh}
-             * 切换的码率
+             * @brief 切换的码率。
+             */
+            /** {en}
+             * @brief Bitrate after switching.
              */
             bitrate: number;
-            /**
-             * 切换的地址
+            /** {zh}
+             * @brief 切换后的播放地址。
+             */
+            /** {en}
+             * @brief The playback address after the switch.
              */
             url: string;
         }) => void;
@@ -7759,7 +8298,7 @@ declare namespace live {
      */
     enum ListType {
         /** {zh}
-         * @brief 全屏布局
+         * @brief 全屏布局。
          * @hidden
          */
         /** {en}
@@ -7768,21 +8307,21 @@ declare namespace live {
          */
         Middle = "middle",
         /** {zh}
-         * @brief 底部抽屉
+         * @brief 底部抽屉。
          */
         /** {en}
          * @brief Bottom navigation drawer.
          */
         Bottom = "bottom",
         /** {zh}
-         * @brief 右侧抽屉，常用于全屏时展示
+         * @brief 右侧抽屉，常用于全屏时展示。
          */
         /** {en}
          * @brief Right navigation drawer. This is often used for fullscreen display.
          */
         Fullscreen = "fullscreen",
         /** {zh}
-         * @brief 窗口蒙层展示
+         * @brief 窗口蒙层展示。
          */
         /** {en}
          * @brief Overlay.
@@ -8195,11 +8734,9 @@ declare namespace live {
         poster?: string;
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
-         * @default -
          */
         /** {en}
          * @brief The initial display language of the player. If the language pack does not exist, the 'en'language pack will be displayed by default. The default value is `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`.
-         * @default -
          */
         lang?: Lang;
         /** {zh}
@@ -8258,25 +8795,20 @@ declare namespace live {
          * @brief Whether to display the full-screen button.
          * - `true`: Display;
          * - `false`: Do not display.
-         * @default -
          */
         fullscreen?: boolean | Fullscreen;
         /** {zh}
          * @brief 为播放器设置报错信息，支持配置播放异常时，播放器显示的异常文案、图片，以及是否提供刷新按钮等。
-         * @default -
          */
         /** {en}
          * @brief The error message of the player. When a playback error occurs, you can configure the error message and image displayed and whether to display the refresh button.
-         * @default -
          */
         error?: ErrorConfig;
         /** {zh}
          * @brief 为播放器设置清晰度的相关配置。
-         * @default -
          */
         /** {en}
          * @brief Resolution-related configurations.
-         * @default -
          */
         definition?: DefinitionConfig;
         /** {zh}
@@ -8537,8 +9069,7 @@ declare namespace live {
          * `true`: Display;
          * `false`: Do not display.
          * @default false
-         * @brief
-         *        Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
+         * @brief Whether to display a return button at the top-right corner when the player is in full-screen mode. This feature is usually turned on on mobile devices.
          *        - `true`: Display;
          *        - `false`: Do not display.
          */
@@ -8556,7 +9087,7 @@ declare namespace live {
      */
     interface CommonStyle {
         /** {zh}
-         * @brief 进度条底色
+         * @brief 进度条底色。
          * @default 无
          */
         /** {en}
@@ -8564,7 +9095,7 @@ declare namespace live {
          */
         progressColor?: string;
         /** {zh}
-         * @brief 播放完成部分进度条底色
+         * @brief 播放完成部分进度条底色。
          * @default 无
          */
         /** {en}
@@ -8572,7 +9103,7 @@ declare namespace live {
          */
         playedColor?: string;
         /** {zh}
-         * @brief 缓存部分进度条底色
+         * @brief 缓存部分进度条底色。
          * @default 无
          */
         /** {en}
@@ -8581,7 +9112,7 @@ declare namespace live {
          */
         cachedColor?: string;
         /** {zh}
-         * @brief 进度条滑块样式
+         * @brief 进度条滑块样式。
          * @default 无
          */
         /** {en}
@@ -8592,7 +9123,7 @@ declare namespace live {
             [propName: string]: any;
         };
         /** {zh}
-         * @brief 音量颜色
+         * @brief 音量颜色。
          * @default 无
          */
         /** {en}
@@ -8616,14 +9147,14 @@ declare namespace live {
      */
     enum Codec {
         /** {zh}
-         * @brief H.265 编码格式
+         * @brief H.265 编码格式。
          */
         /** {en}
          * @brief H.265.
          */
         H265 = "h265",
         /** {zh}
-         * @brief H.264 编码格式
+         * @brief H.264 编码格式。
          */
         /** {en}
          * @brief H.264.
@@ -8640,18 +9171,18 @@ declare namespace live {
      */
     enum Degradation {
         /** {zh}
-         * @brief 硬解不支持降级到软解
+         * @brief 硬解不支持时，优先降级到软解。
          */
         /** {en}
-         * @brief The player does not support falling back to software decoding.
+         * @brief When hardware decoding is not supported, prioritize downgrading to software decoding.
          */
         SoftFirst = "soft-first",
         /** {zh}
-         * @brief 硬解不支持降级到h264
+         * @brief 硬解不支持时，优先降级到 H.264 解码。
          * @hidden
          */
         /** {en}
-         * @brief The player does not support falling back to H.264.
+         * @brief When hardware decoding is not supported, prioritize downgrading to H.264 decoding.
          * @hidden
          */
         H264First = "h264-first"
@@ -8668,14 +9199,14 @@ declare namespace live {
      */
     enum DecodeType {
         /** {zh}
-         * @brief 软解
+         * @brief 软解。
          */
         /** {en}
          * @brief Software decoding.
          */
         Software = "software",
         /** {zh}
-         * @brief 硬解
+         * @brief 硬解。
          */
         /** {en}
          * @brief Hardware decoding.
@@ -8866,6 +9397,11 @@ declare namespace live {
         /** {zh}
          * 获取播放器版本号
          * @returns
+         * @brief
+         *        获取播放器 SDK 版本号。
+         */
+        /** {en}
+         * @brief Retrieve the player SDK version number.
          */
         get playerVersion(): string;
         /** {zh}
@@ -8953,8 +9489,8 @@ declare namespace live {
         static create<T extends VePlayerBase>(options?: VePlayerBaseOptions, Constructor?: Constructor<T>): Promise<T>;
         /** {zh}
          * @brief 调用此方法切换拉流地址、线路、清晰度。
-         * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
-         * @param options 更多配置信息
+         * @param target 目标地址，可以是播放地址，也可以是线路和清晰度。
+         * @param options 更多配置信息。
          */
         /** {en}
          * @brief Switches the pull stream address, playback source, or resolution.
@@ -8991,11 +9527,12 @@ declare namespace live {
              */
             fallbackToFirstDefinition?: boolean;
             /** {zh}
-             * @brief 是否无缝切换
-             * - true: 无缝切换
-             * - false: 非无缝切换
+             * @brief 是否无缝切换，true 为无缝切换，false 为非无缝切换。
              * @default false
              */
+            /** {en}
+             * @brief Whether seamless switching or not. True means seamless switching and false means non-seamless switching.
+             */
             seamless?: boolean;
         }): Promise<ExposedDefinition>;
         /** {zh}
@@ -9031,16 +9568,15 @@ declare namespace live {
             source?: string;
         }): Promise<void>;
         // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
-        /**
         /** {zh}
          * @brief 调用此方法监听指定事件，事件处理函数只执行一次。
          * @param event 表示事件的名称。
          * @param callback 表示事件的回调函数。
          */
         /** {en}
-         * @brief Add a one-time listener function for the specified event.
-         * @param event The event name.
-         * @param callback The callback function for the event.
+         * @brief Call this method to listen for the specified event. The event handler is executed only once.
+         * @param event The name representing the event.
+         * @param callback Callback functions representing events.
          */
         once(event: string, callback: (data?: any) => any): void;
         /** {zh}
@@ -9166,10 +9702,14 @@ declare namespace live {
             ignorePaused?: boolean;
         }): void;
         /** {zh}
-         * @brief 判断浏览器是否支持播放格式
-         * @param type 播放格式
+         * @brief 判断浏览器是否支持播放格式。
+         * @param type 播放格式。
          * @returns
          */
+        /** {en}
+         * @brief Determine whether the browser supports the playback format.
+         * @param type The playback format.
+         */
         canPlayType(type: string): boolean;
         /** {zh}
          * @brief 调用此方法进入系统全屏状态。如果该方法调用的时候处于网页全屏状态会自动退出网页全屏，下发事件 `Events.FULLSCREEN_CHANGE`。
@@ -9249,7 +9789,7 @@ declare namespace live {
         unRegisterPlugin(plugin: any): void;
         /** {zh}
          * @brief 调用此接口显示指定插件图标。
-         * @param pluginNames 插件名称
+         * @param pluginNames 插件名称。
          */
         /** {en}
          * @brief Displays the icon of a specified plugin.
@@ -9258,7 +9798,7 @@ declare namespace live {
         showIcon(pluginNames: string[]): void;
         /** {zh}
          * @brief 调用此接口隐藏指定插件图标。
-         * @param pluginNames 插件名称
+         * @param pluginNames 插件名称。
          */
         /** {en}
          * @brief Hides the icon of a specified plugin.
@@ -9386,22 +9926,22 @@ declare namespace live {
      * @detail api
      * @brief 当前浏览器是否支持播放编码格式。
      * @param codec 编码格式。
-     * `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends
-     * `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+     *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
+     *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
      * @returns
      */
     /** {en}
      * @detail api
      * @brief Checkes whether the current browser supports the specified encoding format.
      * @param codec The encoding format.
-     * `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
-     * `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+     *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
+     *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
      * @returns
      */
     function isMseSupported(codec?: string): boolean;
     /** {zh}
      * @detail api
-     * @brief 当前浏览器是否支持软解
+     * @brief 当前浏览器是否支持软解。
      * @returns
      */
     /** {en}
@@ -10044,20 +10584,16 @@ declare namespace live {
     interface LiveVePlayerOptions extends VePlayerBaseOptions {
         /** {zh}
          * @brief 为播放器设置 RTM 拉流配置。
-         * @default -
          */
         /** {en}
          * @brief Configurations for playing an RTM stream.
-         * @default -
          */
         rtm?: Rtm;
         /** {zh}
          * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-         * @default -
          */
         /** {en}
          * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-         * @default -
          */
         flv?: Flv;
         /** {zh}
@@ -10075,29 +10611,30 @@ declare namespace live {
         hls?: Hls;
         /** {zh}
          * @brief 为播放器设置直播信息展示面板配置，支持设置是否显示面板和信息刷新时间间隔。当前直播信息面板支持展示 HLS 和 FLV 格式的直播信息，如果是软解播放，会额外显示软解相关信息。
-         * @default -
          */
         /** {en}
          * @brief Configures the information panel for the player, including options to show/hide the panel and the time interval between each information update. The panel supports displaying information for HLS and FLV addresses. If you opt for software decoding, additional information related to software decoding will be displayed.
-         * @default -
          */
         infoPanel?: InfoPanelConfig;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @brief Configurations for advertising
+         */
+        ad?: AdConfig;
         /** {zh}
          * @brief 为播放器设置直播时移配置，接入方法请参见[功能接入](https://www.volcengine.com/docs/6469/138655#直播时移)。
-         * @default -
          */
         /** {en}
          * @brief Configurations for time shifting.
-         * @default -
          */
         timeShift?: TimeShiftConfig;
         /** {zh}
          * @brief 日志上报配置，支持设置开启/关闭开始日志上报并设置日志参数，接入方法请参见[功能接入](https://www.volcengine.com/docs/6469/138655#日志上报)。
-         * @default -
          */
         /** {en}
          * @brief Configurations for log upload. Supports enabling/disabling log upload and setting log parameters.
-         * @default -
          */
         logger?: LoggerConfig;
         /** {zh}
@@ -10117,13 +10654,10 @@ declare namespace live {
          */
         icons?: any;
         /** {zh}
-         * @hidden
          * @brief 商业 DRM 播放配置。
-         * @default -
          */
         /** {en}
          * @brief Digital Rights Management (DRM) configurations.
-         * @default -
          */
         drm?: Drm;
     }
@@ -10137,31 +10671,56 @@ declare namespace live {
      */
     interface Abr {
         /** {zh}
-         * @brief 是否开启 abr
-         * - true: 开启
-         * - false: 关闭
+         * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
+         *        - true: 开启
+         *        - false: 关闭
          * @default true
          */
+        /** {en}
+         * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
+         *        - true: Enable;
+         *        - false: Disable.
+         */
         enable?: boolean;
         /** {zh}
-         * @brief 未开启abr的时候，是否开启降码率建议
-         * - true: 开启
-         * - false: 关闭
+         * @brief 未开启 ABR 时，是否开启码率切换建议事件发送，默认为关闭。
+         *        - true: 开启；
+         *        - false: 关闭。
          * @default false
+         * @hidden
+         */
+        /** {en}
+         * @brief When ABR is disabled, determine whether to enable the bitrate switch suggestion event. The default setting is false.
+         *        - true: Enable;
+         *        - false: Disable.
+         * @hidden
          */
         downTip?: boolean;
         /** {zh}
-         * @brief 是否开始调试模式
-         * - true: 开启
-         * - false: 关闭
+         * @brief 是否开始调试模式，默认为关闭。
+         *        - true: 开启；
+         *        - false: 关闭。
+         * @default false
+         */
+        /** {en}
+         * @brief Whether to start debug mode, default is false.
+         *        - true: Enable,
+         *        - false: Disable.
+         * @default false
          */
         debug?: boolean;
         /** {zh}
-         * @brief url 参数对应的码率
+         * @brief 当前拉流地址 URL 对应的码率。
+         */
+        /** {en}
+         * @brief The bitrate corresponding to the current pull-stream address URL.
          */
         bitrate?: number;
         /** {zh}
-         * @brief 多个码率的拉流地址
+         * @brief 自适应码率流信息。
+         */
+        /** {en}
+         * @brief Adaptive bitrate (ABR) stream information.
          */
         urls?: {
             [bitrate: number]: string;
@@ -10170,35 +10729,53 @@ declare namespace live {
     /** {zh}
      * @list option
      * @kind property
+     * @hidden
      */
     /** {en}
      * @list option
      * @kind property
+     * @hidden
      */
     interface HlsAbr {
         /** {zh}
-         * @brief 是否开启 abr
-         * - true: 开启
-         * - false: 关闭
+         * @brief 是否开启 HLS 拉流自适应码率（ABR）功能，默认为开启。
+         *        - true: 开启；
+         *        - false: 关闭。
          * @default true
          */
+        /** {en}
+         * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
+         *        - true: Enable;
+         *        - false: Disable.
+         */
         enable?: boolean;
         /** {zh}
-         * @brief 未开启abr的时候，是否开启降码率建议
-         * - true: 开启
-         * - false: 关闭
+         * @brief 未开启 ABR 时，是否开启码率切换建议事件发送，默认为关闭。
+         *        - true: 开启；
+         *        - false: 关闭。
          * @default false
          */
+        /** {en}
+         * @brief When ABR is disabled, determine whether to enable the bitrate switch suggestion event. The default setting is false.
+         *        - true: Enable;
+         *        - false: Disable.
+         */
         downTip?: boolean;
         /** {zh}
-         * @brief 是否开始调试模式
-         * - true: 开启
-         * - false: 关闭
+         * @brief 是否开始调试模式，默认为关闭。
+         *        - true: 开启；
+         *        - false: 关闭。
+         * @default false
+         */
+        /** {en}
+         * @brief Whether to start debug mode, default is false.
+         *        - true: Enable,
+         *        - false: Disable.
+         * @default false
          */
         debug?: boolean;
     }
     /** {zh}
-     * @hidden
      * @list option
      * @kind property
      */
@@ -10208,15 +10785,14 @@ declare namespace live {
      */
     interface Drm {
         /** {zh}
-         * @brief FairPlay DRM 配置
+         * @brief FairPlay DRM 配置。
          */
         /** {en}
-         * @brief FairPlay DRM configurations
+         * @brief FairPlay DRM configurations.
          */
         fairplay?: FairplayDrm;
     }
     /** {zh}
-     * @hidden
      * @list option
      * @kind property
      */
@@ -10226,7 +10802,6 @@ declare namespace live {
      */
     interface FairplayDrm extends FairplayDrmConfig {
         /** {zh}
-         * @hidden
          * @brief 获取 DRM 配置的方法，用于更新 DRM 配置。
          * @param config
          * @returns 证书的请求地址和内容密钥许可证的请求地址。
@@ -10241,7 +10816,6 @@ declare namespace live {
         }) => Promise<FairplayDrmConfig>;
     }
     /** {zh}
-     * @hidden
      * @list option
      * @kind property
      */
@@ -10251,17 +10825,17 @@ declare namespace live {
      */
     interface FairplayDrmConfig {
         /** {zh}
-         * @brief 获取证书的请求地址
+         * @brief 获取证书的请求地址。
          */
         /** {en}
-         * @brief URL used to acquire the FairPlay certificate
+         * @brief URL used to acquire the FairPlay certificate.
          */
         serverCertificatePath?: string;
         /** {zh}
-         * @brief 获取内容密钥许可证的请求地址
+         * @brief 获取内容密钥许可证的请求地址。
          */
         /** {en}
-         * @brief URL used to acquire the DRM license
+         * @brief URL used to acquire the DRM license.
          */
         serverProcessSPCPath?: string;
     }
@@ -10310,6 +10884,76 @@ declare namespace live {
          */
         position?: string;
     }
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Advertising schedule for a single ad break
+     */
+    interface AdRule {
+        /** {en}
+         * @brief When to play the configured ad tag
+         *        - `pre`:  Ad plays as a preroll
+         *        - `post`:  Ad plays as a postroll
+         *        - (timecode): Ad plays at a specific time, in HH:MM:SS or HH:MM:SS.sss format
+         */
+        offset: string;
+        /** {en}
+         * @brief URL of the ad tag for IMA plugins, must be a VAST xml
+         */
+        tag: string;
+    }
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Configurations for Google IMA SDK
+     */
+    interface ImaConfig {
+        /** {en}
+         * @brief URL of the ad tag for IMA plugins
+         */
+        adTagUrl?: string;
+        /** {en}
+         * @brief URL of the ad tag for IMA plugins when enableSCTE35 is `true`, must be a VAST xml
+         */
+        adTagUrlForSCTE35?: string;
+        /** {en}
+         * @brief The entire advertising schedule, containing multiple ad breaks
+         */
+        schedule?: AdRule[];
+    }
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Configurations for advertising
+     */
+    interface AdConfig {
+        /** {en}
+         * @brief Ad client that will be used to display advertisements
+         *        - `google-ima`：Use the Google IMA SDK
+         */
+        adType: "google-ima";
+        /** {en}
+         * @brief Property enabling SCTE-35 tag in hls manifest
+         * - false: SCTE-35 disabled
+         * - true: SCTE-35 enabled
+         * @default false
+         */
+        enableSCTE35?: boolean;
+        /** {en}
+         * @brief Configurations for Google IMA SDK
+         * @listtip Required when adType is `google-ima`
+         */
+        ima?: ImaConfig;
+    }
     /** {zh}
      * @list option
      * @kind property
@@ -10385,9 +11029,12 @@ declare namespace live {
          */
         enableRTMAutoTranscode?: boolean;
         /** {zh}
-         * @brief 评估当前网络情况的间隔
+         * @brief 指定进行网络评估的最近时间长度，单位为毫秒，默认为 1000，表示对最近 1000 毫秒内的网络情况进行评估。
          * @default 1000
          */
+        /** {en}
+         * @brief Specify the recent time length for network evaluation in milliseconds. The default is 1000, which means evaluating the network conditions over the last 1000 milliseconds.
+         */
         networkEvaluateInterval?: number;
     }
     /** {zh}
@@ -10440,28 +11087,55 @@ declare namespace live {
          */
         enableLowLatency?: boolean;
         /** {zh}
-         * @brief 播放器发起 FLV 拉流请求时，开启低延时的详细配置。。
-         * @default -
+         * @brief 低延时的详细配置。
          */
         /** {en}
-         * @brief
-         * @default -
+         * @brief Detailed configuration for low latency.
          */
         lowLatency?: LowLatency;
         /** {zh}
-         * @brief 为播放器设置 FLV Abr 配置。
-         * @default -
+         * @brief 为播放器设置 FLV 拉流时的 自适应码率（ABR）配置。
+         */
+        /** {en}
+         * @brief Set the Adaptive Bitrate (ABR) configuration for FLV streaming in the player.
          */
         abr?: Abr;
         /** {zh}
          * @hidden
          */
+        /** {en}
+         * @hidden
+         */
         mseLowLatency?: boolean;
         /** {zh}
-         * @brief 超过 maxReaderInterval 时间还没有新数据返回视为断流，播放器触发 ended 事件, 单位 s。
-         * @default 5
+         * @brief 设置无数据返回最大时长，单位为毫秒，默认值为 5000，超过最大时长将被判断为断流，并触发 ended 事件。
+         * @default 5000
+         */
+        /** {en}
+         * @brief Set the maximum duration for no data return in milliseconds. The default value is 5. If this duration is exceeded, it will be considered a stream interruption and trigger an ended event.
          */
         maxReaderInterval?: number;
+        /** {zh}
+         * @brief
+         *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+         * @default 0
+         */
+        /** {en}
+         * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+         * @default 0
+         */
+        disconnectTime?: number;
+        /** {zh}
+         * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
+         *        - `true`：是；
+         *        - `false`：否。
+         * @default false
+         */
+        /** {en}
+         * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+         * @default false
+         */
+        seamlesslyReload?: boolean;
     }
     /** {zh}
      * @list option
@@ -10480,15 +11154,15 @@ declare namespace live {
          */
         abrPts?: string | number;
         /** {zh}
-         * @brief FLV 低延时模式下，是否允许追帧
-         * - true：开启
-         * - false：关闭
+         * @brief FLV 低延时模式下，是否开启倍速追帧。
+         *        - true：开启；
+         *        - false：关闭。
          * @default true
          */
         /** {en}
-         * @brief
-         * - true: Enable
-         * - false: Disable
+         * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
+         *        - true: enabled;
+         *        - false: disabled.
          * @default true
          */
         enableFrameChasing?: boolean;
@@ -10543,8 +11217,12 @@ declare namespace live {
          */
         enableMSE?: boolean;
         /** {zh}
-         * @brief 为播放器设置 HLS Abr 配置。
-         * @default -
+         * @brief 为播放器设置 HLS 拉流时的 自适应码率（ABR）配置。
+         * @hidden
+         */
+        /** {en}
+         * @brief Set the Adaptive Bitrate (ABR) configuration for HLS streaming in the player.
+         * @hidden
          */
         abr?: HlsAbr;
         /**
@@ -10552,83 +11230,415 @@ declare namespace live {
          */
         mseLowLatency?: boolean;
     }
+    /** {zh}
+     * @list option
+     * @kind property
+     * @brief 在 RTM 拉流场景下，获取到的网络情况。
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Network conditions obtained in the RTM pull stream scenario.
+     */
     interface RTMNetWorkInfo {
         /** {zh}
-         * @brief 当前下载速度
+         * @brief 最近一次网络评估周期内的下载速度, 单位为 bps。
+         */
+        /** {en}
+         * @brief The download speed within the latest network evaluation period, in units of bps.
          */
         speed?: number;
         /** {zh}
-         * @brief 当前平均下载速度
+         * @brief 最近 5 次网络评估周期内下载速度平均值，单位为 bps。
+         */
+        /** {en}
+         * @brief The average download speed within the recent 5 network evaluation cycles, with the unit of bps.
          */
         avgSpeed?: number;
         /** {zh}
-         * @brief 当前丢包率
+         * @brief 最近一次网络评估周期内的网络丢包率。
+         */
+        /** {en}
+         * @brief The packet loss rate of the network within the latest network evaluation cycle.
          */
         lostRate?: number;
         /** {zh}
-         * @brief 当前平均丢包率
+         * @brief 最近 5 次网络评估周期内的网络丢包率平均值。
+         */
+        /** {en}
+         * @brief The average network packet loss rate within the recent 5 network evaluation cycles.
          */
         avgLostRate?: number;
     }
     /** {zh}
-     * @brief RTM 信息
+     * @list option
+     * @kind property
+     * @brief RTM 直播流播放信息。
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief RTM live stream information.
      */
     interface StatsSnapShoot {
+        /** {en}
+         * @brief Video information.
+         */
+        /** {zh}
+         * @brief 视频信息。
+         */
         video?: {
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             codec: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             payloadType: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             sdpFmtpLine: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             bytesReceived: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             firCount: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             pliCount: number;
+            /** {zh}
+             * @brief 视频高度
+             */
+            /** {en}
+             * @brief 视频高度
+             */
             frameHeight: number;
+            /** {zh}
+             * @brief 视频宽度
+             */
+            /** {en}
+             * @brief 视频宽度
+             */
             frameWidth: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             framesDecoded: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             framesDropped: number;
+            /** {zh}
+             * @brief 视频帧率
+             */
+            /** {en}
+             * @brief 视频帧率
+             */
             framesPerSecond: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             framesReceived: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             jitter: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             jitterBufferDelay: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             keyFramesDecoded: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             nackCount: number;
+            /** {zh}
+             * @brief 视频丢包总数
+             */
+            /** {en}
+             * @brief 视频丢包总数
+             */
             packetsLost: number;
+            /** {zh}
+             * @brief 视频收包总数
+             */
+            /** {en}
+             * @brief 视频收包总数
+             */
             packetsReceived: number;
         };
+        /** {en}
+         * @brief Audio information.
+         */
+        /** {zh}
+         * @brief 音频信息。
+         */
         audio?: {
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             codec: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             payloadType: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             sdpFmtpLine: string;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             audioLevel: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             bytesReceived: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             jitter: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             jitterBufferDelay: number;
+            /** {zh}
+             * @brief 音频丢包总数
+             */
+            /** {en}
+             * @brief 音频丢包总数
+             */
             packetsLost: number;
+            /** {zh}
+             * @brief 音频收包总数
+             */
+            /** {en}
+             * @brief 音频收包总数
+             */
             packetsReceived: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             totalSamplesDuration: number;
+            /** {zh}
+             * @hidden
+             */
+            /** {en}
+             * @hidden
+             */
             totalSamplesReceived: number;
         };
     }
     /** {zh}
-     * @brief FLV 信息
+     * @list option
+     * @kind property
+     * @brief FLV 直播流播放信息。
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief FLV live stream information.
      */
     interface FlvStats {
+        /** {zh}
+         * @brief 音频格式。
+         * @hidden
+         */
+        /** {en}
+         * @brief Audio format.
+         * @hidden
+         */
         audioCodec: string;
+        /** {zh}
+         * @brief 平均下载速度。
+         */
+        /** {en}
+         * @brief Average download speed.
+         */
         avgSpeed: number;
+        /** {zh}
+         * @brief 码率。
+         */
+        /** {en}
+         * @brief bitrate.
+         */
         bitrate: number;
+        /** {zh}
+         * @brief 剩余缓冲时间。
+         */
+        /** {en}
+         * @brief Remaining buffer time.
+         */
         bufferEnd: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         channelCount: number;
+        /** {zh}
+         * @brief 当前播放时间。
+         */
+        /** {en}
+         * @brief The current playing time.
+         */
         currentTime: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         decodeFps: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         domain: string;
+        /** {zh}
+         * @brief 当前下载速度。
+         */
+        /** {en}
+         * @brief Current download speed.
+         */
         downloadSpeed: number;
+        /** {zh}
+         * @brief 编码方式。
+         */
+        /** {en}
+         * @brief Encoding method.
+         */
         encodeType: string;
+        /** {zh}
+         * @brief 帧率。
+         */
+        /** {en}
+         * @brief Frame rate.
+         */
         fps: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         gop: number;
+        /** {zh}
+         * @brief 视频高度。
+         */
+        /** {en}
+         * @brief Video height.
+         */
         height: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         samplerate: number;
+        /** {zh}
+         * @brief 总共收到的字节数。
+         */
+        /** {en}
+         * @brief The total number of bytes received.
+         */
         totalReceivedByte: number;
+        /** {zh}
+         * @brief 接收所有字节消耗时长。
+         */
+        /** {en}
+         * @brief The time consumed for receiving all bytes.
+         */
         totalReceivedCost: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
         videoCodec: string;
+        /** {zh}
+         * @brief 视频宽度。
+         */
+        /** {en}
+         * @brief Video wight.
+         */
         width: number;
     }
     /** {zh}
@@ -10652,7 +11662,10 @@ declare namespace live {
          */
         constructor(options: LiveVePlayerOptions);
         /** {zh}
-         * @brief 获取已经播放的时间
+         * @brief 获取已经播放的时长，不包含暂停和等待时间，单位为秒。
+         */
+        /** {en}
+         * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
          */
         get playTime(): number;
         /** {zh}
@@ -10686,49 +11699,80 @@ declare namespace live {
          */
         closeInfoPanel(): void;
         /** {zh}
-         * @brief 打开 Abr
+         * @brief 打开码率自适应（ABR）切换功能。
+         */
+        /** {en}
+         * @brief Enable the Adaptive Bitrate Streaming (ABR) switching feature.
          */
         openAbr(): void;
         /** {zh}
-         * @brief 关闭 Abr
+         * @brief 关闭码率自适应（ABR）切换功能。
+         */
+        /** {en}
+         * @brief Disable the Adaptive Bitrate Streaming (ABR) switching feature.
          */
         closeAbr(): void;
         /** {zh}
-         * @brief 调用此方法更新 DRM 鉴权配置。
-         * @hidden
+         * @brief 调用此方法更新 DRM 配置。
+         */
+        /** {en}
+         * @brief Use this method to update DRM configuration.
+         * @param config
          */
         updateDrmConfig(config: FairplayDrmConfig): void;
         /** {zh}
-         * @brief 切换 flv Abr
-         * @param options 切换 Abr 的配置。
+         * @brief 修改 ABR 配置，包含修改是否开启 ABR 功能，和修改其他清晰度。
+         * @param options ABR 的配置。
          * @returns
          */
+        /** {en}
+         * @brief Modify ABR configuration, including enabling or disabling the ABR feature and adjusting other resolutions.
+         * @param options Configuration of ABR.
+         */
         switchAbr(options: {
             /** {zh}
-             * @brief 是否开启 Abr
-             * - true: 开启
-             * - false: 关闭
+             * @brief 是否开启 ABR 功能。
+             *        - true：开启
+             *        - false：关闭
+             */
+            /** {en}
+             * @brief Whether to enable the ABR function.
+             *        - true: Enabled ;
+             *        - false: Disabled
+             * @default -
              */
             enable: boolean;
             /** {zh}
-             * @brief 切换 Abr 的码率
+             * @brief 切换自适应码率直播流对应的码率。
+             */
+            /** {en}
+             * @brief Switch the bitrate corresponding to the Adaptive Bitrate (ABR) live stream.
              */
             bitrate: number;
         }): void;
         /** {zh}
-         * @brief 获取 RTM 的网络相关信息
+         * @brief 获取 RTM 拉流的网络评估信息。
          * @returns
          */
+        /** {en}
+         * @brief Obtain the network assessment information of RTM pull streaming.
+         */
         getRTMNetWorkInfo(): RTMNetWorkInfo;
         /** {zh}
-         * @brief 获取 RTM 播放信息
+         * @brief 获取 RTM 拉流的播放信息。
          * @returns
          */
+        /** {en}
+         * @brief Obtain the playback information of RTM pull stream.
+         */
         getRTMStats(): Promise<StatsSnapShoot>;
         /** {zh}
-         * @brief 获取 FLV 播放信息
+         * @brief 获取 FLV 拉流的播放信息。
          * @returns
          */
+        /** {en}
+         * @brief Obtain the playback information of FLV pull streaming.
+         */
         getFLVStats(): FlvStats;
     }
     /** {zh}