@volcengine/veplayer 2.6.1 → 2.7.0-rc.0

package/veplayer.d.ts

@@ -1,7 +1,6 @@
 import Player from "xgplayer";
 import { IXGI18nText, Plugin, IPluginOptions, Sniffer } from "xgplayer";
 import { IPlayerOptions as PlayerOptions } from "xgplayer";
-import { IDefinition as XGDefinition } from "xgplayer";
 import { default as Player$0 } from "xgplayer";
 import { IError as XGError } from "xgplayer";
 import { IBasePluginOptions as XGPluginOptions } from "xgplayer";
@@ -164,8 +163,8 @@ interface DefinitionUrl {
     url: string;
     next: DefinitionUrl | null;
 }
-declare class Definition implements XGDefinition {
-    readonly definition: string;
+declare class Definition {
+    readonly definition?: string;
     readonly source: Source;
     readonly text?: Record<Lang, string> | string;
     readonly fallbackUrl: DefinitionUrl;
@@ -173,7 +172,7 @@ declare class Definition implements XGDefinition {
     private _currentUrlRef;
     constructor(definitionSetting: {
         url: string;
-        definition: string;
+        definition?: string;
         source: Source;
         text?: Record<Lang, string> | string;
         fallbackUrls?: string[];
@@ -199,7 +198,6 @@ declare class Definition implements XGDefinition {
 interface ExposedDefinition {
     /** {zh}
      * @brief 播放地址。
-     * @default 无
      */
     /** {en}
      * @brief The playback address.
@@ -207,17 +205,14 @@ interface ExposedDefinition {
     url: string;
     /** {zh}
      * @brief 清晰度标识（唯一值）。
-     * @default 无
-     *
      */
     /** {en}
      * @brief The resolution ID. This value must be unique.
      *
      */
-    definition: string;
+    definition?: string;
     /** {zh}
      * @brief 清晰度展示名称。可设置多语言 `{text: {'zh-cn': '高清', 'en': 'HD'}}`。
-     * @default 无
      */
     /** {en}
      * @brief The display name of the resolution. Multiple languages are supported, such as `{text: {'zh-cn': '高清', 'en': 'HD'}}`.
@@ -225,14 +220,13 @@ interface ExposedDefinition {
     text?: Record<Lang, string> | string;
     /** {zh}
      * @brief 为当前清晰度地址设置备路拉流地址，支持设置多个备路拉流地址。当前清晰度地址拉流失败时，会在当前清晰度地址和备路直播地址之间循环拉流，直到拉流成功。
-     * @default 无
-     *
      */
     /** {en}
      * @brief The backup pull stream address for the current resolution. You can set multiple backup addresses. When the player fails to pull a stream from the current address, it will loop between the current and the backup addresses until it successfully pulls a stream.
      *
      */
     fallbackUrls?: string[];
+    type?: string;
 }
 /** {zh}
  * @list option
@@ -249,7 +243,6 @@ interface ExposedDefinition {
 interface ExposedSource {
     /** {zh}
      * @brief 线路标识（唯一值）。
-     * @default 无
      */
     /** {en}
      * @brief The playback source ID. This value must be unique.
@@ -257,8 +250,6 @@ interface ExposedSource {
     name?: string;
     /** {zh}
      * @brief 线路展示名称。可设置多语言 `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`。
-     * @default 无
-     *
      */
     /** {en}
      * @brief The display name of the live stream source. Multiple languages are supported. For example, you set it to `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`.
@@ -267,8 +258,6 @@ interface ExposedSource {
     text?: Record<Lang, string> | string;
     /** {zh}
      * @brief 该线路下清晰度列表。
-     * @default 无
-     *
      */
     /** {en}
      * @brief A list of resolutions of the current source.
@@ -478,25 +467,24 @@ declare class OptionsIcon extends Plugin {
  */
 declare enum Level {
     /** {zh}
-     * @brief 严重。
+     * @brief 发生严重错误，可能由于 CDN 拉取失败或 DRM 权限验证未通过，导致无法播放。
      */
     /** {en}
-     * @brief Fatal.
-     *
+     * @brief A critical error occurs, typically due to CDN fetching failure or DRM permission verification failure, resulting in playback inability.
      */
     Fatal = "Fatal",
     /** {zh}
-     * @brief 报错。
+     * @brief 流异常或处于离线状态，致使播放失败。
      */
     /** {en}
-     * @brief Error.
+     * @brief A stream anomaly or offline state causes playback to fail.
      */
     Error = "Error",
     /** {zh}
-     * @brief 提示。
+     * @brief 出现警告信息，通常由日志配置错误或缺少 RTM 降级地址引起。
      */
     /** {en}
-     * @brief Warn.
+     * @brief A warning is issued, usually due to incorrect log configuration or a missing RTM fallback address.
      */
     Warn = "Warn"
 }
@@ -949,7 +937,6 @@ type ErrorConfig = {
     showRefresh?: boolean;
     /** {zh}
      * @brief 自定义报错显示。
-     * @default 无
      */
     /** {en}
      * @brief Custom error message.
@@ -958,7 +945,6 @@ type ErrorConfig = {
     errorTipsText?: string | Record<Lang, string>;
     /** {zh}
      * @brief 更多提示信息。
-     * @default 无
      */
     /** {en}
      * @brief More tips.
@@ -1118,7 +1104,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     id?: string;
     /** {zh}
      * @brief 指定播放器容器元素，VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入，则优先将播放器插入 id 容器中。
-     * @default 无
      */
     /** {en}
      * @brief The container element of the player. You should specify either `id` or `el`, or both. If both are specified, the `VePlayer` object will be inserted in the container specified by `id`.
@@ -1144,7 +1129,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     height?: number | string;
     /** {zh}
      * @brief 为播放器配置直播拉流地址。您可手动拼接或使用地址生成器生成拉流地址，生成方法请参见[生成直播地址](https://www.volcengine.com/docs/6469/107759)。url 和 playList 需至少传入 1 个。
-     * @default 无
      */
     /** {en}
      * @brief The pull stream address. You can manually construct the address or use the address generator to generate one. To see how to generate an address, refer to [Generate live-stream addresses](https://docs.byteplus.com/en/byteplus-media-live/docs/generating-live-stream-addresses). You should specify either `url` or `playList`, or both.
@@ -1152,7 +1136,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     url?: string;
     /** {zh}
      * @brief 为播放器配置直播拉流地址列表。url 和 playlist 需至少传入 1 个。
-     * @default 无
      */
     /** {en}
      * @brief A list of live stream sources for the player. You should specify either `url` or `playList`, or both.
@@ -1160,7 +1143,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     playlist?: ExposedSource[];
     /** {zh}
      * @brief 当存在多个直播线路时，为播放器设置默认直播线路，不传则默认列表第一个。
-     * @default 无
      */
     /** {en}
      * @brief The default pull stream address for the player when there are multiple addresses available. If this parameter is not specified, the first address in the playlist will become the default address.
@@ -1168,7 +1150,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     defaultSource?: string;
     /** {zh}
      * @brief 为播放器设置默认直播清晰度，不传则默认列表第一个。
-     * @default 无
      */
     /** {en}
      * @brief The default resolution for the player when there are multiple resolutions available. If this parameter is not specified, the first resolution in the list will become the default resolution.
@@ -1176,7 +1157,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     defaultDefinition?: string;
     /** {zh}
      * @brief 为播放器设置备路拉流地址，支持设置多个备路拉流地址，在 `maxFallbackRound` 大于 `0` 时有效。当您使用配置的直播拉流地址拉流失败时，会在直播地址和备路直播地址之间循环拉流，直到拉流成功。
-     * @default 无
      */
     /** {en}
      * @brief The backup pull stream address(es) for the player. You can enter multiple backup addresses. If `maxFallbackRound` is greater than `0`, when an error occurs in the main address, the player automatically switches to the backup address.
@@ -1230,7 +1210,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     degradation?: Degradation | boolean;
     /** {zh}
      * @brief 为播放器设置封面图 URL。
-     * @default 无
      */
     /** {en}
      * @brief The URL of the player's cover image.
@@ -1246,7 +1225,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     /** {zh}
      * @brief 为播放器设置自定义的多语言词典，可设置每个语种的词典，格式为 { texts: { [key: string]: Object; } }。
      * 例如，{ texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }} ，格式请参考[默认词典](https://www.volcengine.com/docs/6469/127529)。
-     * @default 无
      */
     /** {en}
      * @brief Configures a custom multilingual dictionary for the player. You can set the dictionary for each language in the format  { texts: { [key: string]: Object; } }. For example, { texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }}.
@@ -1256,7 +1234,7 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
         texts: Record<Lang, Record<string, string>>;
     };
     /** {zh}
-     * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
+     * @brief 为播放器设置是否自动播放，`muted` 设置为 `true` 为静音自动播放。
      * @default { muted: true }
      * @type {{ muted: boolean } | boolean}
      */
@@ -1362,7 +1340,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     playsinline?: boolean;
     /** {zh}
      * @brief 为播放器设置 video 标签扩展属性，初始化时会设置在 videoElement 或 audioElement 对象上，请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
-     * @default 无
      */
     /** {en}
      * @brief Additional properties for the `video` element that will be applied when the `videoElement` or `audioElement` objects are initialized. Refer to [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) for supported properties.
@@ -1440,7 +1417,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     marginControls?: boolean;
     /** {zh}
      *  @brief 启用微信同层播放。
-     * @default 无
      */
     /** {en}
      *  @brief Enable playing the video on the same player as WeChat.
@@ -1450,7 +1426,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
      *  @brief 是否启用微信全屏播放模式。
      * - `true`：启用
      * - `false`：停用
-     * @default 无
      */
     /** {en}
      *  @brief Whether to enable full-screen playback in WeChat.
@@ -1463,7 +1438,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
      * - `landscape`：横屏
      * - `portrait`：竖屏
      * - `landscape|portrait`：跟随手机自动旋转
-     * @default 无
      */
     /** {en}
      *  @brief The orientation of the video when played on WeChat. The following values are supported:
@@ -1474,7 +1448,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
     /** {zh}
      * @brief 为播放器配置关键点样式。
-     * @default 无
      * @hidden 直播目前没用到
      */
     /** {en}
@@ -1484,7 +1457,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     commonStyle?: CommonStyle;
     /** {zh}
      * @brief 自定义插件列表。
-     * @default 无
      */
     /** {en}
      * @brief A list of custom plugins.
@@ -1527,10 +1499,10 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
      */
     closeVideoDblclick?: boolean;
     /** {zh}
-     * @brief 支持传入 video dom，常应用于多播放器复用同一 video 场景。
+     * @brief 支持传入 `video` DOM 元素，适用于多个播放器共享同一视频场景。
      */
     /** {en}
-     * @brief Supports passing in video DOM, commonly used for reusing the same video scene across multiple players.
+     * @brief Supports passing in a `video` DOM element, suitable for scenarios where multiple players share the same video.
      */
     mediaElement?: HTMLVideoElement | null;
 }
@@ -1599,7 +1571,6 @@ interface Fullscreen {
 interface CommonStyle {
     /** {zh}
      * @brief 进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief The background color of the progress bar.
@@ -1607,7 +1578,6 @@ interface CommonStyle {
     progressColor?: string;
     /** {zh}
      * @brief 播放完成部分进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief The background color of the progress bar for the completed portion of video playback.
@@ -1615,7 +1585,6 @@ interface CommonStyle {
     playedColor?: string;
     /** {zh}
      * @brief 缓存部分进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief
@@ -1624,7 +1593,6 @@ interface CommonStyle {
     cachedColor?: string;
     /** {zh}
      * @brief 进度条滑块样式。
-     * @default 无
      */
     /** {en}
      * @brief The style of the progress bar slider.
@@ -1635,7 +1603,6 @@ interface CommonStyle {
     };
     /** {zh}
      * @brief 音量颜色。
-     * @default 无
      */
     /** {en}
      * @brief The color of the volume slider.
@@ -1646,9 +1613,10 @@ type PrepareResult = {
     options?: Partial<VePlayerBaseOptions>;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     plugins?: any[];
+    protocol?: string;
     useSrc?: boolean;
 };
-type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
+type PreparePlugins = (url?: string) => Promise<PrepareResult | undefined> | undefined;
 /** {zh}
  * @detail option
  * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
@@ -1772,6 +1740,7 @@ declare class VePlayerBase {
     private _events;
     private _customMedia?;
     private _errorCallback;
+    private _beforeFallbackError;
     /** {zh}
      * @hidden
      */
@@ -1811,7 +1780,7 @@ declare class VePlayerBase {
      */
     get played(): TimeRanges;
     /** {zh}
-     * @brief 设置/获取视频当前的播放时间, 单位为 s。
+     * @brief 设置/获取视频当前的播放时间，单位为 s。
      */
     /** {en}
      * @brief Sets or gets the current playback position of the video, in seconds.
@@ -1922,7 +1891,7 @@ declare class VePlayerBase {
     /** {en}
      * @brief Gets the current resolution ID.
      */
-    get definition(): string;
+    get definition(): string | undefined;
     /** {zh}
      * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
      */
@@ -2012,7 +1981,6 @@ declare class VePlayerBase {
     switch(target: string | {
         /** {zh}
          * @brief 清晰度的唯一标识。
-         * @default 无
          */
         /** {en}
          * @brief The resolution ID.
@@ -2020,7 +1988,6 @@ declare class VePlayerBase {
         definition?: string;
         /** {zh}
          * @brief 线路的唯一标识。
-         * @default 无
          */
         /** {en}
          * @brief The playback source ID.
@@ -2060,8 +2027,6 @@ declare class VePlayerBase {
     updatePlaylist(playlist: ExposedSource[] | string, target?: string | {
         /** {zh}
          * @brief 清晰度唯一标识。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The resolution ID.
@@ -2070,8 +2035,6 @@ declare class VePlayerBase {
         definition?: string;
         /** {zh}
          * @brief 线路的唯一标识。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The playback resource ID.
@@ -2272,7 +2235,6 @@ declare class VePlayerBase {
     Function | {
         /** {zh}
          * @brief 插件构造函数。
-         * @default 无
          */
         /** {en}
          * @brief The plugin constructor.
@@ -2281,7 +2243,6 @@ declare class VePlayerBase {
         plugin: Function;
         /** {zh}
          * @brief 插件配置参数。
-         * @default 无
          */
         /** {en}
          * @brief The plugin configurations.
@@ -2547,8 +2508,8 @@ declare namespace strategy {
         next: DefinitionUrl | null;
     }
     function arrayToList(urls?: string[]): DefinitionUrl;
-    class Definition implements XGDefinition {
-        readonly definition: string;
+    class Definition {
+        readonly definition?: string;
         readonly source: Source;
         readonly text?: Record<Lang, string> | string;
         readonly fallbackUrl: DefinitionUrl;
@@ -2556,7 +2517,7 @@ declare namespace strategy {
         private _currentUrlRef;
         constructor(definitionSetting: {
             url: string;
-            definition: string;
+            definition?: string;
             source: Source;
             text?: Record<Lang, string> | string;
             fallbackUrls?: string[];
@@ -2582,7 +2543,6 @@ declare namespace strategy {
     interface ExposedDefinition {
         /** {zh}
          * @brief 播放地址。
-         * @default 无
          */
         /** {en}
          * @brief The playback address.
@@ -2590,17 +2550,14 @@ declare namespace strategy {
         url: string;
         /** {zh}
          * @brief 清晰度标识（唯一值）。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The resolution ID. This value must be unique.
          *
          */
-        definition: string;
+        definition?: string;
         /** {zh}
          * @brief 清晰度展示名称。可设置多语言 `{text: {'zh-cn': '高清', 'en': 'HD'}}`。
-         * @default 无
          */
         /** {en}
          * @brief The display name of the resolution. Multiple languages are supported, such as `{text: {'zh-cn': '高清', 'en': 'HD'}}`.
@@ -2608,14 +2565,13 @@ declare namespace strategy {
         text?: Record<Lang, string> | string;
         /** {zh}
          * @brief 为当前清晰度地址设置备路拉流地址，支持设置多个备路拉流地址。当前清晰度地址拉流失败时，会在当前清晰度地址和备路直播地址之间循环拉流，直到拉流成功。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The backup pull stream address for the current resolution. You can set multiple backup addresses. When the player fails to pull a stream from the current address, it will loop between the current and the backup addresses until it successfully pulls a stream.
          *
          */
         fallbackUrls?: string[];
+        type?: string;
     }
     /** {zh}
      * @list option
@@ -2632,7 +2588,6 @@ declare namespace strategy {
     interface ExposedSource {
         /** {zh}
          * @brief 线路标识（唯一值）。
-         * @default 无
          */
         /** {en}
          * @brief The playback source ID. This value must be unique.
@@ -2640,8 +2595,6 @@ declare namespace strategy {
         name?: string;
         /** {zh}
          * @brief 线路展示名称。可设置多语言 `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The display name of the live stream source. Multiple languages are supported. For example, you set it to `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`.
@@ -2650,8 +2603,6 @@ declare namespace strategy {
         text?: Record<Lang, string> | string;
         /** {zh}
          * @brief 该线路下清晰度列表。
-         * @default 无
-         *
          */
         /** {en}
          * @brief A list of resolutions of the current source.
@@ -2858,25 +2809,24 @@ declare namespace strategy {
      */
     enum Level {
         /** {zh}
-         * @brief 严重。
+         * @brief 发生严重错误，可能由于 CDN 拉取失败或 DRM 权限验证未通过，导致无法播放。
          */
         /** {en}
-         * @brief Fatal.
-         *
+         * @brief A critical error occurs, typically due to CDN fetching failure or DRM permission verification failure, resulting in playback inability.
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错。
+         * @brief 流异常或处于离线状态，致使播放失败。
          */
         /** {en}
-         * @brief Error.
+         * @brief A stream anomaly or offline state causes playback to fail.
          */
         Error = "Error",
         /** {zh}
-         * @brief 提示。
+         * @brief 出现警告信息，通常由日志配置错误或缺少 RTM 降级地址引起。
          */
         /** {en}
-         * @brief Warn.
+         * @brief A warning is issued, usually due to incorrect log configuration or a missing RTM fallback address.
          */
         Warn = "Warn"
     }
@@ -3333,7 +3283,6 @@ declare namespace strategy {
         showRefresh?: boolean;
         /** {zh}
          * @brief 自定义报错显示。
-         * @default 无
          */
         /** {en}
          * @brief Custom error message.
@@ -3342,7 +3291,6 @@ declare namespace strategy {
         errorTipsText?: string | Record<Lang, string>;
         /** {zh}
          * @brief 更多提示信息。
-         * @default 无
          */
         /** {en}
          * @brief More tips.
@@ -3502,7 +3450,6 @@ declare namespace strategy {
         id?: string;
         /** {zh}
          * @brief 指定播放器容器元素，VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入，则优先将播放器插入 id 容器中。
-         * @default 无
          */
         /** {en}
          * @brief The container element of the player. You should specify either `id` or `el`, or both. If both are specified, the `VePlayer` object will be inserted in the container specified by `id`.
@@ -3528,7 +3475,6 @@ declare namespace strategy {
         height?: number | string;
         /** {zh}
          * @brief 为播放器配置直播拉流地址。您可手动拼接或使用地址生成器生成拉流地址，生成方法请参见[生成直播地址](https://www.volcengine.com/docs/6469/107759)。url 和 playList 需至少传入 1 个。
-         * @default 无
          */
         /** {en}
          * @brief The pull stream address. You can manually construct the address or use the address generator to generate one. To see how to generate an address, refer to [Generate live-stream addresses](https://docs.byteplus.com/en/byteplus-media-live/docs/generating-live-stream-addresses). You should specify either `url` or `playList`, or both.
@@ -3536,7 +3482,6 @@ declare namespace strategy {
         url?: string;
         /** {zh}
          * @brief 为播放器配置直播拉流地址列表。url 和 playlist 需至少传入 1 个。
-         * @default 无
          */
         /** {en}
          * @brief A list of live stream sources for the player. You should specify either `url` or `playList`, or both.
@@ -3544,7 +3489,6 @@ declare namespace strategy {
         playlist?: ExposedSource[];
         /** {zh}
          * @brief 当存在多个直播线路时，为播放器设置默认直播线路，不传则默认列表第一个。
-         * @default 无
          */
         /** {en}
          * @brief The default pull stream address for the player when there are multiple addresses available. If this parameter is not specified, the first address in the playlist will become the default address.
@@ -3552,7 +3496,6 @@ declare namespace strategy {
         defaultSource?: string;
         /** {zh}
          * @brief 为播放器设置默认直播清晰度，不传则默认列表第一个。
-         * @default 无
          */
         /** {en}
          * @brief The default resolution for the player when there are multiple resolutions available. If this parameter is not specified, the first resolution in the list will become the default resolution.
@@ -3560,7 +3503,6 @@ declare namespace strategy {
         defaultDefinition?: string;
         /** {zh}
          * @brief 为播放器设置备路拉流地址，支持设置多个备路拉流地址，在 `maxFallbackRound` 大于 `0` 时有效。当您使用配置的直播拉流地址拉流失败时，会在直播地址和备路直播地址之间循环拉流，直到拉流成功。
-         * @default 无
          */
         /** {en}
          * @brief The backup pull stream address(es) for the player. You can enter multiple backup addresses. If `maxFallbackRound` is greater than `0`, when an error occurs in the main address, the player automatically switches to the backup address.
@@ -3614,7 +3556,6 @@ declare namespace strategy {
         degradation?: Degradation | boolean;
         /** {zh}
          * @brief 为播放器设置封面图 URL。
-         * @default 无
          */
         /** {en}
          * @brief The URL of the player's cover image.
@@ -3630,7 +3571,6 @@ declare namespace strategy {
         /** {zh}
          * @brief 为播放器设置自定义的多语言词典，可设置每个语种的词典，格式为 { texts: { [key: string]: Object; } }。
          * 例如，{ texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }} ，格式请参考[默认词典](https://www.volcengine.com/docs/6469/127529)。
-         * @default 无
          */
         /** {en}
          * @brief Configures a custom multilingual dictionary for the player. You can set the dictionary for each language in the format  { texts: { [key: string]: Object; } }. For example, { texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }}.
@@ -3640,7 +3580,7 @@ declare namespace strategy {
             texts: Record<Lang, Record<string, string>>;
         };
         /** {zh}
-         * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
+         * @brief 为播放器设置是否自动播放，`muted` 设置为 `true` 为静音自动播放。
          * @default { muted: true }
          * @type {{ muted: boolean } | boolean}
          */
@@ -3746,7 +3686,6 @@ declare namespace strategy {
         playsinline?: boolean;
         /** {zh}
          * @brief 为播放器设置 video 标签扩展属性，初始化时会设置在 videoElement 或 audioElement 对象上，请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
-         * @default 无
          */
         /** {en}
          * @brief Additional properties for the `video` element that will be applied when the `videoElement` or `audioElement` objects are initialized. Refer to [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) for supported properties.
@@ -3824,7 +3763,6 @@ declare namespace strategy {
         marginControls?: boolean;
         /** {zh}
          *  @brief 启用微信同层播放。
-         * @default 无
          */
         /** {en}
          *  @brief Enable playing the video on the same player as WeChat.
@@ -3834,7 +3772,6 @@ declare namespace strategy {
          *  @brief 是否启用微信全屏播放模式。
          * - `true`：启用
          * - `false`：停用
-         * @default 无
          */
         /** {en}
          *  @brief Whether to enable full-screen playback in WeChat.
@@ -3847,7 +3784,6 @@ declare namespace strategy {
          * - `landscape`：横屏
          * - `portrait`：竖屏
          * - `landscape|portrait`：跟随手机自动旋转
-         * @default 无
          */
         /** {en}
          *  @brief The orientation of the video when played on WeChat. The following values are supported:
@@ -3858,7 +3794,6 @@ declare namespace strategy {
         "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
         /** {zh}
          * @brief 为播放器配置关键点样式。
-         * @default 无
          * @hidden 直播目前没用到
          */
         /** {en}
@@ -3868,7 +3803,6 @@ declare namespace strategy {
         commonStyle?: CommonStyle;
         /** {zh}
          * @brief 自定义插件列表。
-         * @default 无
          */
         /** {en}
          * @brief A list of custom plugins.
@@ -3911,10 +3845,10 @@ declare namespace strategy {
          */
         closeVideoDblclick?: boolean;
         /** {zh}
-         * @brief 支持传入 video dom，常应用于多播放器复用同一 video 场景。
+         * @brief 支持传入 `video` DOM 元素，适用于多个播放器共享同一视频场景。
          */
         /** {en}
-         * @brief Supports passing in video DOM, commonly used for reusing the same video scene across multiple players.
+         * @brief Supports passing in a `video` DOM element, suitable for scenarios where multiple players share the same video.
          */
         mediaElement?: HTMLVideoElement | null;
     }
@@ -3983,7 +3917,6 @@ declare namespace strategy {
     interface CommonStyle {
         /** {zh}
          * @brief 进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief The background color of the progress bar.
@@ -3991,7 +3924,6 @@ declare namespace strategy {
         progressColor?: string;
         /** {zh}
          * @brief 播放完成部分进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief The background color of the progress bar for the completed portion of video playback.
@@ -3999,7 +3931,6 @@ declare namespace strategy {
         playedColor?: string;
         /** {zh}
          * @brief 缓存部分进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief
@@ -4008,7 +3939,6 @@ declare namespace strategy {
         cachedColor?: string;
         /** {zh}
          * @brief 进度条滑块样式。
-         * @default 无
          */
         /** {en}
          * @brief The style of the progress bar slider.
@@ -4019,7 +3949,6 @@ declare namespace strategy {
         };
         /** {zh}
          * @brief 音量颜色。
-         * @default 无
          */
         /** {en}
          * @brief The color of the volume slider.
@@ -4030,9 +3959,10 @@ declare namespace strategy {
         options?: Partial<VePlayerBaseOptions>;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         plugins?: any[];
+        protocol?: string;
         useSrc?: boolean;
     };
-    type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
+    type PreparePlugins = (url?: string) => Promise<PrepareResult | undefined> | undefined;
     /** {zh}
      * @detail option
      * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
@@ -4212,13 +4142,6 @@ declare namespace strategy {
     function detectCodec(url: string): Promise<"unknown" | Codec>;
     function isSoftDecode(options: VePlayerBaseOptions, currentCodec?: Codec | "unknown"): Promise<boolean>;
     function combineOptions<T = VePlayerBaseOptions>(strategyList: (Strategy<T> | undefined)[]): Partial<T>;
-    const getHlsStrategy: (options: VePlayerBaseOptions) => Promise<{
-        options?: undefined;
-        plugins?: undefined;
-    } | {
-        options: Partial<VePlayerBaseOptions>;
-        plugins: any[];
-    }>;
 }
 declare function getStreamType(url: string): "unknown" | "hls" | "flv" | "rtm" | "mp4" | "dash";
 /** {zh}
@@ -4521,25 +4444,24 @@ declare namespace error {
      */
     enum Level {
         /** {zh}
-         * @brief 严重。
+         * @brief 发生严重错误，可能由于 CDN 拉取失败或 DRM 权限验证未通过，导致无法播放。
          */
         /** {en}
-         * @brief Fatal.
-         *
+         * @brief A critical error occurs, typically due to CDN fetching failure or DRM permission verification failure, resulting in playback inability.
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错。
+         * @brief 流异常或处于离线状态，致使播放失败。
          */
         /** {en}
-         * @brief Error.
+         * @brief A stream anomaly or offline state causes playback to fail.
          */
         Error = "Error",
         /** {zh}
-         * @brief 提示。
+         * @brief 出现警告信息，通常由日志配置错误或缺少 RTM 降级地址引起。
          */
         /** {en}
-         * @brief Warn.
+         * @brief A warning is issued, usually due to incorrect log configuration or a missing RTM fallback address.
          */
         Warn = "Warn"
     }
@@ -5143,7 +5065,6 @@ declare class Sources extends OptionsIcon {
     };
     updateLang(): void;
     beforeCreate(args: XGPluginOptions): void;
-    afterCreate(): void;
     registerIcons(): {
         source: {
             icon: any;
@@ -5272,7 +5193,6 @@ interface LoggerConfig {
     enable?: boolean;
     /** {zh}
      * @brief 应用 ID，登录[视频直播控制台 > SDK 管理](https://console.volcengine.com/live/main/sdk)查询。
-     * @default 无
      */
     /** {en}
      * @brief The SDK application ID. You can access it by logging in to the BytePlus MediaLive console and navigating to [SDK Management](https://console.byteplus.com/live/main/sdk).
@@ -5280,7 +5200,6 @@ interface LoggerConfig {
     appId?: string;
     /** {zh}
      * @brief 应用名称。
-     * @default 无
      */
     /** {en}
      * @brief The application name.
@@ -5290,7 +5209,6 @@ interface LoggerConfig {
      * @brief 用于识别单一用户的 ID，如不设置，会随机生成一个用户 ID 存在浏览器缓存中。
      * @listtip
      * 建议您使用与业务相关的用户 ID，以便在发生播放错误时快速定位排查问题。
-     * @default 无
      */
     /** {en}
      * @brief The ID used to identify a single user. If not set, a random user ID will be generated and stored in the browser cache.
@@ -5302,7 +5220,6 @@ interface LoggerConfig {
      * @brief 用于识别用户设备的 ID，如不设置，会随机生成一个用户 ID 存在浏览器缓存中。
      * @listtip
      * 建议您使用与业务相关的用户设备 ID，以便在发生播放错误时快速定位排查问题。
-     * @default 无
      */
     /** {en}
      * @brief The ID used to identify a user's device. If not set, a random device ID will be generated and stored in the browser cache.
@@ -5320,6 +5237,88 @@ interface LoggerConfig {
      */
     showUserIdInErrorPanel?: boolean;
 }
+declare enum FallbackKind {
+    Error = "Error",
+    Stall = "Stall"
+}
+interface ErrorFallbackStrategy {
+    type?: FallbackKind;
+    excludeList?: ErrorCode[];
+    shouldFallback?: (type: string, params: {
+        error: VeError;
+    }) => boolean;
+}
+interface StallFallbackStrategy {
+    type?: FallbackKind;
+    shouldFallback?: (type: string) => boolean;
+}
+// 播放类型抽象类 （BaseProtocol）
+declare abstract class BaseProtocol {
+    // 下一个 protocol 类
+    nextProtocol?: BaseProtocol;
+    preProtocol?: BaseProtocol;
+    protocolStrategy?: Strategy;
+    private _fallback;
+    constructor(options: VePlayerBaseOptions);
+    // 当前播放类型
+    abstract get protocolType(): string;
+    abstract get defaultFallbackStrategy(): Partial<Record<FallbackKind, StallFallbackStrategy | ErrorFallbackStrategy>>;
+    private _getKindFallbackStrategy;
+    // eslint-disable-next-line @typescript-eslint/member-ordering
+    get errorFallbackStrategy(): any;
+    // eslint-disable-next-line @typescript-eslint/member-ordering
+    get stallFallbackStrategy(): any;
+    abstract shouldFallbackWhenStall(): boolean;
+    // eslint-disable-next-line @typescript-eslint/member-ordering
+    shouldFallbackWhenError(params: {
+        error: VeError;
+    }): any;
+    // 是否支持播放
+    abstract canPlay(): Promise<{
+        canPlay: boolean;
+    }>;
+    abstract getProtocolStrategy(options: VePlayerBaseOptions, config?: {
+        player?: VePlayerBase;
+        i18n?: VeI18n;
+        enableSelector?: boolean;
+    }): Promise<Strategy> | undefined;
+    abstract getDrmStrategy(options: VePlayerBaseOptions, player?: VePlayerBase): Promise<Strategy> | undefined;
+    abstract getAbrStrategy(options: VePlayerBaseOptions): Promise<Strategy> | undefined;
+}
+type Strategy = {
+    options?: undefined;
+    plugins?: undefined;
+} | {
+    options: Partial<VePlayerBaseOptions>;
+    plugins: any[];
+};
+declare class ProtocolManager {
+    private static _protocolMap;
+    private _options;
+    private _selector?;
+    private _protocol;
+    private _playlistMap;
+    constructor(options: LiveVePlayerOptions);
+    get enableSelector(): boolean;
+    get protocol(): BaseProtocol | undefined;
+    get playlist(): ExposedSource[] | undefined;
+    static create(options: LiveVePlayerOptions): Promise<ProtocolManager>;
+    private static _generateProtocolMap;
+    getProtocol(): Promise<BaseProtocol | undefined>;
+    update({ url, playlist }: {
+        url?: string;
+        playlist?: VePlayerBaseOptions["playlist"];
+    }): Promise<void>;
+    next(): Promise<BaseProtocol | undefined>;
+    getStrategy(player: VePlayerBase | undefined, i18n: VeI18n): Promise<{
+        options: Partial<VePlayerBaseOptions>;
+        plugins: any[];
+        useSrc: boolean;
+        protocol: string | undefined;
+    }>;
+    private _init;
+    private _initSingleProtocol;
+}
 /** {zh}
  * @list option
  * @kind property
@@ -5374,6 +5373,7 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      */
     /** {en}
      * @brief Configurations for advertising
+     * @hidden
      */
     ad?: AdConfig;
     /** {zh}
@@ -5392,15 +5392,13 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
     logger?: LoggerConfig;
     /** {zh}
      * @brief 为播放器禁用内置插件列表，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826#禁用插件)。
-     * @default 无
      */
     /** {en}
      * @brief A list of built-in plug-ins to be disabled. For the access method, please refer to [Plugin descriptions](https://docs.byteplus.com/en/docs/byteplus-media-live/docs-d8idjfeza4#disabling-plugins).
      */
     ignores?: string[];
     /** {zh}
-     * @brief 为播放器替换插件图标，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826#替换插件图标)。
-     * @default 无
+     * @brief 为播放器替换插件图标，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826)。
      */
     /** {en}
      * @brief The plug-in icon. For the access method, please refer to [Plugin descriptions](https://docs.byteplus.com/en/docs/byteplus-media-live/docs-d8idjfeza4#replacing-plugin-icons).
@@ -5413,6 +5411,16 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      * @brief Digital Rights Management (DRM) configurations.
      */
     drm?: Drm;
+    latencyMode?: "standard" | "low";
+    fallback?: Fallback;
+}
+interface Fallback {
+    enableFallback?: boolean;
+    fallbackOrder?: string[];
+    fallbackStrategy?: Record<string | "all", {
+        [FallbackKind.Error]?: ErrorFallbackStrategy;
+        [FallbackKind.Stall]?: StallFallbackStrategy;
+    }>;
 }
 /** {zh}
  * @list option
@@ -5644,6 +5652,7 @@ interface TimeShiftConfig {
  * @list option
  * @kind property
  * @brief Advertising schedule for a single ad break
+ * @hidden
  */
 interface AdRule {
     /** {en}
@@ -5665,6 +5674,7 @@ interface AdRule {
  * @list option
  * @kind property
  * @brief Configurations for Google IMA SDK
+ * @hidden
  */
 interface ImaConfig {
     /** {en}
@@ -5687,6 +5697,7 @@ interface ImaConfig {
  * @list option
  * @kind property
  * @brief Configurations for advertising
+ * @hidden
  */
 interface AdConfig {
     /** {en}
@@ -5737,7 +5748,8 @@ interface Rtm {
      * @brief 配置 RTM 拉流失败降级地址，可配置 FLV 拉流地址或 HLS 的拉流地址。`enableFallback` 为 `true` 时生效。
      *  - 指定 `fallbackUrl`：当前环境不支持播放 RTM 或 RTM 拉流建联失败时，降级到 `fallbackUrl` 拉流地址。
      *  - 未指定 `fallbackUrl`：当前环境不支持播放 RTM 或 RTM 拉流建联失败时，根据当前 RTM 地址降级到对应的 FLV 或者 HLS 地址。
-     * @default 无
+     * @listtip - v2.5.2 版本后未指定 `fallbackUrl` 且未开启自动转码的情况下，不会自动降级到 FLV 或者 HLS 地址。
+     *          - 多线路和多清晰禁止插件内部自动降级, 具体降级方式查看 [RTM 拉流](https://www.volcengine.com/docs/6469/138655#rtm-%E6%8B%89%E6%B5%81)。
      */
     /** {en}
      * @brief The FLV or HLS addresses the player uses when failing to pull an RTM stream. This parameter takes effect when `enableFallback` is set to `true`.
@@ -5830,6 +5842,13 @@ interface Rtm {
      * @hidden
      */
     enableOriginSdpLogger?: boolean;
+    /** {zh}
+     * @brief RTM 协议缓冲区延迟，单位为秒。
+     */
+    /** {en}
+     * @brief buffer delay to handle network jitter, in seconds。
+     */
+    delayHint?: number;
 }
 /** {zh}
  * @list option
@@ -5872,7 +5891,7 @@ interface Flv {
      *        - `true`：开启；
      *        - `false`：关闭
      * @default false
-     * @listtip 低延迟 FLV 拉流仅在 PC 端浏览器中生效。
+     * @listtip v2.5.2 版本后支持 FLV H5 端低延迟拉流。
      */
     /** {en}
      * @brief Whether to enable low latency when playing an FLV address. For example, if you have enabled low latency, and set GOP to 2 seconds, the average latency will be around 2 seconds.
@@ -6043,7 +6062,7 @@ interface Hls {
  */
 interface RTMNetWorkInfo {
     /** {zh}
-     * @brief 最近一次网络评估周期内的下载速度, 单位为 bps。
+     * @brief 最近一次网络评估周期内的下载速度，单位为 bps。
      */
     /** {en}
      * @brief The download speed within the latest network evaluation period, in units of bps.
@@ -6453,6 +6472,7 @@ interface FlvStats {
  * @inheritdoc
  */
 declare class VePlayerLive extends VePlayerBase {
+    _protocolManager?: ProtocolManager;
     /** {zh}
      * @hidden
      * @param options
@@ -6469,6 +6489,12 @@ declare class VePlayerLive extends VePlayerBase {
      * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
      */
     get playTime(): number;
+    /** {en}
+     * @hidden
+     */
+    /** {zh}
+     * @hidden
+     */
     get ad(): any;
     /** {zh}
      * @brief 调用此方法开启直播日志上报。
@@ -6576,6 +6602,28 @@ declare class VePlayerLive extends VePlayerBase {
      * @brief Obtain the playback information of FLV pull streaming.
      */
     getFLVStats(): FlvStats;
+    updatePlaylist(playlist: ExposedSource[], target?: string | {
+        /** {zh}
+         * @brief 清晰度唯一标识。
+         * @default 无
+         *
+         */
+        /** {en}
+         * @brief The resolution ID.
+         *
+         */
+        definition?: string;
+        /** {zh}
+         * @brief 线路的唯一标识。
+         * @default 无
+         *
+         */
+        /** {en}
+         * @brief The playback resource ID.
+         *
+         */
+        source?: string;
+    }, needUpdateProtocol?: boolean): Promise<void>;
 }
 /** {zh}
  * @detail api
@@ -6823,25 +6871,24 @@ declare namespace live {
      */
     enum Level {
         /** {zh}
-         * @brief 严重。
+         * @brief 发生严重错误，可能由于 CDN 拉取失败或 DRM 权限验证未通过，导致无法播放。
          */
         /** {en}
-         * @brief Fatal.
-         *
+         * @brief A critical error occurs, typically due to CDN fetching failure or DRM permission verification failure, resulting in playback inability.
          */
         Fatal = "Fatal",
         /** {zh}
-         * @brief 报错。
+         * @brief 流异常或处于离线状态，致使播放失败。
          */
         /** {en}
-         * @brief Error.
+         * @brief A stream anomaly or offline state causes playback to fail.
          */
         Error = "Error",
         /** {zh}
-         * @brief 提示。
+         * @brief 出现警告信息，通常由日志配置错误或缺少 RTM 降级地址引起。
          */
         /** {en}
-         * @brief Warn.
+         * @brief A warning is issued, usually due to incorrect log configuration or a missing RTM fallback address.
          */
         Warn = "Warn"
     }
@@ -7265,8 +7312,8 @@ declare namespace live {
         next: DefinitionUrl | null;
     }
     function arrayToList(urls?: string[]): DefinitionUrl;
-    class Definition implements XGDefinition {
-        readonly definition: string;
+    class Definition {
+        readonly definition?: string;
         readonly source: Source;
         readonly text?: Record<Lang, string> | string;
         readonly fallbackUrl: DefinitionUrl;
@@ -7274,7 +7321,7 @@ declare namespace live {
         private _currentUrlRef;
         constructor(definitionSetting: {
             url: string;
-            definition: string;
+            definition?: string;
             source: Source;
             text?: Record<Lang, string> | string;
             fallbackUrls?: string[];
@@ -7300,7 +7347,6 @@ declare namespace live {
     interface ExposedDefinition {
         /** {zh}
          * @brief 播放地址。
-         * @default 无
          */
         /** {en}
          * @brief The playback address.
@@ -7308,17 +7354,14 @@ declare namespace live {
         url: string;
         /** {zh}
          * @brief 清晰度标识（唯一值）。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The resolution ID. This value must be unique.
          *
          */
-        definition: string;
+        definition?: string;
         /** {zh}
          * @brief 清晰度展示名称。可设置多语言 `{text: {'zh-cn': '高清', 'en': 'HD'}}`。
-         * @default 无
          */
         /** {en}
          * @brief The display name of the resolution. Multiple languages are supported, such as `{text: {'zh-cn': '高清', 'en': 'HD'}}`.
@@ -7326,14 +7369,13 @@ declare namespace live {
         text?: Record<Lang, string> | string;
         /** {zh}
          * @brief 为当前清晰度地址设置备路拉流地址，支持设置多个备路拉流地址。当前清晰度地址拉流失败时，会在当前清晰度地址和备路直播地址之间循环拉流，直到拉流成功。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The backup pull stream address for the current resolution. You can set multiple backup addresses. When the player fails to pull a stream from the current address, it will loop between the current and the backup addresses until it successfully pulls a stream.
          *
          */
         fallbackUrls?: string[];
+        type?: string;
     }
     /** {zh}
      * @list option
@@ -7350,7 +7392,6 @@ declare namespace live {
     interface ExposedSource {
         /** {zh}
          * @brief 线路标识（唯一值）。
-         * @default 无
          */
         /** {en}
          * @brief The playback source ID. This value must be unique.
@@ -7358,8 +7399,6 @@ declare namespace live {
         name?: string;
         /** {zh}
          * @brief 线路展示名称。可设置多语言 `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The display name of the live stream source. Multiple languages are supported. For example, you set it to `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`.
@@ -7368,8 +7407,6 @@ declare namespace live {
         text?: Record<Lang, string> | string;
         /** {zh}
          * @brief 该线路下清晰度列表。
-         * @default 无
-         *
          */
         /** {en}
          * @brief A list of resolutions of the current source.
@@ -7912,7 +7949,7 @@ declare namespace live {
              */
             autoHide: boolean;
             /** {zh}
-             * @brief 自动隐藏的延迟时间, 单位为 ms。
+             * @brief 自动隐藏的延迟时间，单位为 ms。
              */
             /** {en}
              * @brief The latency of auto hiding, in milliseconds.
@@ -8651,7 +8688,6 @@ declare namespace live {
         showRefresh?: boolean;
         /** {zh}
          * @brief 自定义报错显示。
-         * @default 无
          */
         /** {en}
          * @brief Custom error message.
@@ -8660,7 +8696,6 @@ declare namespace live {
         errorTipsText?: string | Record<Lang, string>;
         /** {zh}
          * @brief 更多提示信息。
-         * @default 无
          */
         /** {en}
          * @brief More tips.
@@ -8820,7 +8855,6 @@ declare namespace live {
         id?: string;
         /** {zh}
          * @brief 指定播放器容器元素，VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入，则优先将播放器插入 id 容器中。
-         * @default 无
          */
         /** {en}
          * @brief The container element of the player. You should specify either `id` or `el`, or both. If both are specified, the `VePlayer` object will be inserted in the container specified by `id`.
@@ -8846,7 +8880,6 @@ declare namespace live {
         height?: number | string;
         /** {zh}
          * @brief 为播放器配置直播拉流地址。您可手动拼接或使用地址生成器生成拉流地址，生成方法请参见[生成直播地址](https://www.volcengine.com/docs/6469/107759)。url 和 playList 需至少传入 1 个。
-         * @default 无
          */
         /** {en}
          * @brief The pull stream address. You can manually construct the address or use the address generator to generate one. To see how to generate an address, refer to [Generate live-stream addresses](https://docs.byteplus.com/en/byteplus-media-live/docs/generating-live-stream-addresses). You should specify either `url` or `playList`, or both.
@@ -8854,7 +8887,6 @@ declare namespace live {
         url?: string;
         /** {zh}
          * @brief 为播放器配置直播拉流地址列表。url 和 playlist 需至少传入 1 个。
-         * @default 无
          */
         /** {en}
          * @brief A list of live stream sources for the player. You should specify either `url` or `playList`, or both.
@@ -8862,7 +8894,6 @@ declare namespace live {
         playlist?: ExposedSource[];
         /** {zh}
          * @brief 当存在多个直播线路时，为播放器设置默认直播线路，不传则默认列表第一个。
-         * @default 无
          */
         /** {en}
          * @brief The default pull stream address for the player when there are multiple addresses available. If this parameter is not specified, the first address in the playlist will become the default address.
@@ -8870,7 +8901,6 @@ declare namespace live {
         defaultSource?: string;
         /** {zh}
          * @brief 为播放器设置默认直播清晰度，不传则默认列表第一个。
-         * @default 无
          */
         /** {en}
          * @brief The default resolution for the player when there are multiple resolutions available. If this parameter is not specified, the first resolution in the list will become the default resolution.
@@ -8878,7 +8908,6 @@ declare namespace live {
         defaultDefinition?: string;
         /** {zh}
          * @brief 为播放器设置备路拉流地址，支持设置多个备路拉流地址，在 `maxFallbackRound` 大于 `0` 时有效。当您使用配置的直播拉流地址拉流失败时，会在直播地址和备路直播地址之间循环拉流，直到拉流成功。
-         * @default 无
          */
         /** {en}
          * @brief The backup pull stream address(es) for the player. You can enter multiple backup addresses. If `maxFallbackRound` is greater than `0`, when an error occurs in the main address, the player automatically switches to the backup address.
@@ -8932,7 +8961,6 @@ declare namespace live {
         degradation?: Degradation | boolean;
         /** {zh}
          * @brief 为播放器设置封面图 URL。
-         * @default 无
          */
         /** {en}
          * @brief The URL of the player's cover image.
@@ -8948,7 +8976,6 @@ declare namespace live {
         /** {zh}
          * @brief 为播放器设置自定义的多语言词典，可设置每个语种的词典，格式为 { texts: { [key: string]: Object; } }。
          * 例如，{ texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }} ，格式请参考[默认词典](https://www.volcengine.com/docs/6469/127529)。
-         * @default 无
          */
         /** {en}
          * @brief Configures a custom multilingual dictionary for the player. You can set the dictionary for each language in the format  { texts: { [key: string]: Object; } }. For example, { texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }}.
@@ -8958,7 +8985,7 @@ declare namespace live {
             texts: Record<Lang, Record<string, string>>;
         };
         /** {zh}
-         * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
+         * @brief 为播放器设置是否自动播放，`muted` 设置为 `true` 为静音自动播放。
          * @default { muted: true }
          * @type {{ muted: boolean } | boolean}
          */
@@ -9064,7 +9091,6 @@ declare namespace live {
         playsinline?: boolean;
         /** {zh}
          * @brief 为播放器设置 video 标签扩展属性，初始化时会设置在 videoElement 或 audioElement 对象上，请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
-         * @default 无
          */
         /** {en}
          * @brief Additional properties for the `video` element that will be applied when the `videoElement` or `audioElement` objects are initialized. Refer to [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) for supported properties.
@@ -9142,7 +9168,6 @@ declare namespace live {
         marginControls?: boolean;
         /** {zh}
          *  @brief 启用微信同层播放。
-         * @default 无
          */
         /** {en}
          *  @brief Enable playing the video on the same player as WeChat.
@@ -9152,7 +9177,6 @@ declare namespace live {
          *  @brief 是否启用微信全屏播放模式。
          * - `true`：启用
          * - `false`：停用
-         * @default 无
          */
         /** {en}
          *  @brief Whether to enable full-screen playback in WeChat.
@@ -9165,7 +9189,6 @@ declare namespace live {
          * - `landscape`：横屏
          * - `portrait`：竖屏
          * - `landscape|portrait`：跟随手机自动旋转
-         * @default 无
          */
         /** {en}
          *  @brief The orientation of the video when played on WeChat. The following values are supported:
@@ -9176,7 +9199,6 @@ declare namespace live {
         "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
         /** {zh}
          * @brief 为播放器配置关键点样式。
-         * @default 无
          * @hidden 直播目前没用到
          */
         /** {en}
@@ -9186,7 +9208,6 @@ declare namespace live {
         commonStyle?: CommonStyle;
         /** {zh}
          * @brief 自定义插件列表。
-         * @default 无
          */
         /** {en}
          * @brief A list of custom plugins.
@@ -9229,10 +9250,10 @@ declare namespace live {
          */
         closeVideoDblclick?: boolean;
         /** {zh}
-         * @brief 支持传入 video dom，常应用于多播放器复用同一 video 场景。
+         * @brief 支持传入 `video` DOM 元素，适用于多个播放器共享同一视频场景。
          */
         /** {en}
-         * @brief Supports passing in video DOM, commonly used for reusing the same video scene across multiple players.
+         * @brief Supports passing in a `video` DOM element, suitable for scenarios where multiple players share the same video.
          */
         mediaElement?: HTMLVideoElement | null;
     }
@@ -9301,7 +9322,6 @@ declare namespace live {
     interface CommonStyle {
         /** {zh}
          * @brief 进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief The background color of the progress bar.
@@ -9309,7 +9329,6 @@ declare namespace live {
         progressColor?: string;
         /** {zh}
          * @brief 播放完成部分进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief The background color of the progress bar for the completed portion of video playback.
@@ -9317,7 +9336,6 @@ declare namespace live {
         playedColor?: string;
         /** {zh}
          * @brief 缓存部分进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief
@@ -9326,7 +9344,6 @@ declare namespace live {
         cachedColor?: string;
         /** {zh}
          * @brief 进度条滑块样式。
-         * @default 无
          */
         /** {en}
          * @brief The style of the progress bar slider.
@@ -9337,7 +9354,6 @@ declare namespace live {
         };
         /** {zh}
          * @brief 音量颜色。
-         * @default 无
          */
         /** {en}
          * @brief The color of the volume slider.
@@ -9348,9 +9364,10 @@ declare namespace live {
         options?: Partial<VePlayerBaseOptions>;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         plugins?: any[];
+        protocol?: string;
         useSrc?: boolean;
     };
-    type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
+    type PreparePlugins = (url?: string) => Promise<PrepareResult | undefined> | undefined;
     /** {zh}
      * @detail option
      * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
@@ -9475,6 +9492,7 @@ declare namespace live {
         private _events;
         private _customMedia?;
         private _errorCallback;
+        private _beforeFallbackError;
         /** {zh}
          * @hidden
          */
@@ -9514,7 +9532,7 @@ declare namespace live {
          */
         get played(): TimeRanges;
         /** {zh}
-         * @brief 设置/获取视频当前的播放时间, 单位为 s。
+         * @brief 设置/获取视频当前的播放时间，单位为 s。
          */
         /** {en}
          * @brief Sets or gets the current playback position of the video, in seconds.
@@ -9625,7 +9643,7 @@ declare namespace live {
         /** {en}
          * @brief Gets the current resolution ID.
          */
-        get definition(): string;
+        get definition(): string | undefined;
         /** {zh}
          * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
          */
@@ -9715,7 +9733,6 @@ declare namespace live {
         switch(target: string | {
             /** {zh}
              * @brief 清晰度的唯一标识。
-             * @default 无
              */
             /** {en}
              * @brief The resolution ID.
@@ -9723,7 +9740,6 @@ declare namespace live {
             definition?: string;
             /** {zh}
              * @brief 线路的唯一标识。
-             * @default 无
              */
             /** {en}
              * @brief The playback source ID.
@@ -9763,8 +9779,6 @@ declare namespace live {
         updatePlaylist(playlist: ExposedSource[] | string, target?: string | {
             /** {zh}
              * @brief 清晰度唯一标识。
-             * @default 无
-             *
              */
             /** {en}
              * @brief The resolution ID.
@@ -9773,8 +9787,6 @@ declare namespace live {
             definition?: string;
             /** {zh}
              * @brief 线路的唯一标识。
-             * @default 无
-             *
              */
             /** {en}
              * @brief The playback resource ID.
@@ -9975,7 +9987,6 @@ declare namespace live {
         Function | {
             /** {zh}
              * @brief 插件构造函数。
-             * @default 无
              */
             /** {en}
              * @brief The plugin constructor.
@@ -9984,7 +9995,6 @@ declare namespace live {
             plugin: Function;
             /** {zh}
              * @brief 插件配置参数。
-             * @default 无
              */
             /** {en}
              * @brief The plugin configurations.
@@ -10339,7 +10349,6 @@ declare namespace live {
         };
         updateLang(): void;
         beforeCreate(args: XGPluginOptions): void;
-        afterCreate(): void;
         registerIcons(): {
             source: {
                 icon: any;
@@ -10617,7 +10626,7 @@ declare namespace live {
         EMPTY_RTM_FALLBACK_PARAMETER = 211,
         /** {zh}
          * @brief 日志错误
-         * @solution 未正确配置质量日志参数, 请参考 https://www.volcengine.com/docs/6469/138655#日志上报 配置。
+         * @solution 未正确配置质量日志参数，请参考 https://www.volcengine.com/docs/6469/138655#日志上报 配置。
          */
         /** {en}
          * @brief Log errors.
@@ -10783,7 +10792,6 @@ declare namespace live {
         enable?: boolean;
         /** {zh}
          * @brief 应用 ID，登录[视频直播控制台 > SDK 管理](https://console.volcengine.com/live/main/sdk)查询。
-         * @default 无
          */
         /** {en}
          * @brief The SDK application ID. You can access it by logging in to the BytePlus MediaLive console and navigating to [SDK Management](https://console.byteplus.com/live/main/sdk).
@@ -10791,7 +10799,6 @@ declare namespace live {
         appId?: string;
         /** {zh}
          * @brief 应用名称。
-         * @default 无
          */
         /** {en}
          * @brief The application name.
@@ -10801,7 +10808,6 @@ declare namespace live {
          * @brief 用于识别单一用户的 ID，如不设置，会随机生成一个用户 ID 存在浏览器缓存中。
          * @listtip
          * 建议您使用与业务相关的用户 ID，以便在发生播放错误时快速定位排查问题。
-         * @default 无
          */
         /** {en}
          * @brief The ID used to identify a single user. If not set, a random user ID will be generated and stored in the browser cache.
@@ -10813,7 +10819,6 @@ declare namespace live {
          * @brief 用于识别用户设备的 ID，如不设置，会随机生成一个用户 ID 存在浏览器缓存中。
          * @listtip
          * 建议您使用与业务相关的用户设备 ID，以便在发生播放错误时快速定位排查问题。
-         * @default 无
          */
         /** {en}
          * @brief The ID used to identify a user's device. If not set, a random device ID will be generated and stored in the browser cache.
@@ -10852,6 +10857,88 @@ declare namespace live {
         private _createTea;
         private _start;
     }
+    enum FallbackKind {
+        Error = "Error",
+        Stall = "Stall"
+    }
+    interface ErrorFallbackStrategy {
+        type?: FallbackKind;
+        excludeList?: ErrorCode$0[];
+        shouldFallback?: (type: string, params: {
+            error: VeError$1;
+        }) => boolean;
+    }
+    interface StallFallbackStrategy {
+        type?: FallbackKind;
+        shouldFallback?: (type: string) => boolean;
+    }
+    // 播放类型抽象类 （BaseProtocol）
+    abstract class BaseProtocol {
+        // 下一个 protocol 类
+        nextProtocol?: BaseProtocol;
+        preProtocol?: BaseProtocol;
+        protocolStrategy?: Strategy;
+        private _fallback;
+        constructor(options: VePlayerBaseOptions);
+        // 当前播放类型
+        abstract get protocolType(): string;
+        abstract get defaultFallbackStrategy(): Partial<Record<FallbackKind, StallFallbackStrategy | ErrorFallbackStrategy>>;
+        private _getKindFallbackStrategy;
+        // eslint-disable-next-line @typescript-eslint/member-ordering
+        get errorFallbackStrategy(): any;
+        // eslint-disable-next-line @typescript-eslint/member-ordering
+        get stallFallbackStrategy(): any;
+        abstract shouldFallbackWhenStall(): boolean;
+        // eslint-disable-next-line @typescript-eslint/member-ordering
+        shouldFallbackWhenError(params: {
+            error: VeError$1;
+        }): any;
+        // 是否支持播放
+        abstract canPlay(): Promise<{
+            canPlay: boolean;
+        }>;
+        abstract getProtocolStrategy(options: VePlayerBaseOptions, config?: {
+            player?: VePlayerBase;
+            i18n?: VeI18n;
+            enableSelector?: boolean;
+        }): Promise<Strategy> | undefined;
+        abstract getDrmStrategy(options: VePlayerBaseOptions, player?: VePlayerBase): Promise<Strategy> | undefined;
+        abstract getAbrStrategy(options: VePlayerBaseOptions): Promise<Strategy> | undefined;
+    }
+    type Strategy = {
+        options?: undefined;
+        plugins?: undefined;
+    } | {
+        options: Partial<VePlayerBaseOptions>;
+        plugins: any[];
+    };
+    class ProtocolManager {
+        private static _protocolMap;
+        private _options;
+        private _selector?;
+        private _protocol;
+        private _playlistMap;
+        constructor(options: LiveVePlayerOptions);
+        get enableSelector(): boolean;
+        get protocol(): BaseProtocol | undefined;
+        get playlist(): ExposedSource[] | undefined;
+        static create(options: LiveVePlayerOptions): Promise<ProtocolManager>;
+        private static _generateProtocolMap;
+        getProtocol(): Promise<BaseProtocol | undefined>;
+        update({ url, playlist }: {
+            url?: string;
+            playlist?: VePlayerBaseOptions["playlist"];
+        }): Promise<void>;
+        next(): Promise<BaseProtocol | undefined>;
+        getStrategy(player: VePlayerBase | undefined, i18n: VeI18n): Promise<{
+            options: Partial<VePlayerBaseOptions>;
+            plugins: any[];
+            useSrc: boolean;
+            protocol: string | undefined;
+        }>;
+        private _init;
+        private _initSingleProtocol;
+    }
     /** {zh}
      * @list option
      * @kind property
@@ -10906,6 +10993,7 @@ declare namespace live {
          */
         /** {en}
          * @brief Configurations for advertising
+         * @hidden
          */
         ad?: AdConfig;
         /** {zh}
@@ -10924,15 +11012,13 @@ declare namespace live {
         logger?: LoggerConfig;
         /** {zh}
          * @brief 为播放器禁用内置插件列表，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826#禁用插件)。
-         * @default 无
          */
         /** {en}
          * @brief A list of built-in plug-ins to be disabled. For the access method, please refer to [Plugin descriptions](https://docs.byteplus.com/en/docs/byteplus-media-live/docs-d8idjfeza4#disabling-plugins).
          */
         ignores?: string[];
         /** {zh}
-         * @brief 为播放器替换插件图标，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826#替换插件图标)。
-         * @default 无
+         * @brief 为播放器替换插件图标，接入方法请参见[插件说明](https://www.volcengine.com/docs/6469/192826)。
          */
         /** {en}
          * @brief The plug-in icon. For the access method, please refer to [Plugin descriptions](https://docs.byteplus.com/en/docs/byteplus-media-live/docs-d8idjfeza4#replacing-plugin-icons).
@@ -10945,6 +11031,16 @@ declare namespace live {
          * @brief Digital Rights Management (DRM) configurations.
          */
         drm?: Drm;
+        latencyMode?: "standard" | "low";
+        fallback?: Fallback;
+    }
+    interface Fallback {
+        enableFallback?: boolean;
+        fallbackOrder?: string[];
+        fallbackStrategy?: Record<string | "all", {
+            [FallbackKind.Error]?: ErrorFallbackStrategy;
+            [FallbackKind.Stall]?: StallFallbackStrategy;
+        }>;
     }
     /** {zh}
      * @list option
@@ -11176,6 +11272,7 @@ declare namespace live {
      * @list option
      * @kind property
      * @brief Advertising schedule for a single ad break
+     * @hidden
      */
     interface AdRule {
         /** {en}
@@ -11197,6 +11294,7 @@ declare namespace live {
      * @list option
      * @kind property
      * @brief Configurations for Google IMA SDK
+     * @hidden
      */
     interface ImaConfig {
         /** {en}
@@ -11219,6 +11317,7 @@ declare namespace live {
      * @list option
      * @kind property
      * @brief Configurations for advertising
+     * @hidden
      */
     interface AdConfig {
         /** {en}
@@ -11269,7 +11368,8 @@ declare namespace live {
          * @brief 配置 RTM 拉流失败降级地址，可配置 FLV 拉流地址或 HLS 的拉流地址。`enableFallback` 为 `true` 时生效。
          *  - 指定 `fallbackUrl`：当前环境不支持播放 RTM 或 RTM 拉流建联失败时，降级到 `fallbackUrl` 拉流地址。
          *  - 未指定 `fallbackUrl`：当前环境不支持播放 RTM 或 RTM 拉流建联失败时，根据当前 RTM 地址降级到对应的 FLV 或者 HLS 地址。
-         * @default 无
+         * @listtip - v2.5.2 版本后未指定 `fallbackUrl` 且未开启自动转码的情况下，不会自动降级到 FLV 或者 HLS 地址。
+         *          - 多线路和多清晰禁止插件内部自动降级, 具体降级方式查看 [RTM 拉流](https://www.volcengine.com/docs/6469/138655#rtm-%E6%8B%89%E6%B5%81)。
          */
         /** {en}
          * @brief The FLV or HLS addresses the player uses when failing to pull an RTM stream. This parameter takes effect when `enableFallback` is set to `true`.
@@ -11362,6 +11462,13 @@ declare namespace live {
          * @hidden
          */
         enableOriginSdpLogger?: boolean;
+        /** {zh}
+         * @brief RTM 协议缓冲区延迟，单位为秒。
+         */
+        /** {en}
+         * @brief buffer delay to handle network jitter, in seconds。
+         */
+        delayHint?: number;
     }
     /** {zh}
      * @list option
@@ -11404,7 +11511,7 @@ declare namespace live {
          *        - `true`：开启；
          *        - `false`：关闭
          * @default false
-         * @listtip 低延迟 FLV 拉流仅在 PC 端浏览器中生效。
+         * @listtip v2.5.2 版本后支持 FLV H5 端低延迟拉流。
          */
         /** {en}
          * @brief Whether to enable low latency when playing an FLV address. For example, if you have enabled low latency, and set GOP to 2 seconds, the average latency will be around 2 seconds.
@@ -11575,7 +11682,7 @@ declare namespace live {
      */
     interface RTMNetWorkInfo {
         /** {zh}
-         * @brief 最近一次网络评估周期内的下载速度, 单位为 bps。
+         * @brief 最近一次网络评估周期内的下载速度，单位为 bps。
          */
         /** {en}
          * @brief The download speed within the latest network evaluation period, in units of bps.
@@ -11985,6 +12092,7 @@ declare namespace live {
      * @inheritdoc
      */
     class VePlayerLive extends VePlayerBase {
+        _protocolManager?: ProtocolManager;
         /** {zh}
          * @hidden
          * @param options
@@ -12001,6 +12109,12 @@ declare namespace live {
          * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
          */
         get playTime(): number;
+        /** {en}
+         * @hidden
+         */
+        /** {zh}
+         * @hidden
+         */
         get ad(): any;
         /** {zh}
          * @brief 调用此方法开启直播日志上报。
@@ -12108,6 +12222,28 @@ declare namespace live {
          * @brief Obtain the playback information of FLV pull streaming.
          */
         getFLVStats(): FlvStats;
+        updatePlaylist(playlist: ExposedSource[], target?: string | {
+            /** {zh}
+             * @brief 清晰度唯一标识。
+             * @default 无
+             *
+             */
+            /** {en}
+             * @brief The resolution ID.
+             *
+             */
+            definition?: string;
+            /** {zh}
+             * @brief 线路的唯一标识。
+             * @default 无
+             *
+             */
+            /** {en}
+             * @brief The playback resource ID.
+             *
+             */
+            source?: string;
+        }, needUpdateProtocol?: boolean): Promise<void>;
     }
     /** {zh}
      * @detail api