@volcengine/veplayer 2.6.1 → 2.7.0-rc.0

package/esm/index.d.ts

@@ -1,7 +1,6 @@
 import Player from "xgplayer";
 import { IXGI18nText, Plugin, IPluginOptions } 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";
@@ -92,8 +91,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;
@@ -101,7 +100,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[];
@@ -127,7 +126,6 @@ declare class Definition implements XGDefinition {
 interface ExposedDefinition {
     /** {zh}
      * @brief 播放地址。
-     * @default 无
      */
     /** {en}
      * @brief The playback address.
@@ -135,17 +133,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'}}`.
@@ -153,14 +148,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
@@ -177,7 +171,6 @@ interface ExposedDefinition {
 interface ExposedSource {
     /** {zh}
      * @brief 线路标识（唯一值）。
-     * @default 无
      */
     /** {en}
      * @brief The playback source ID. This value must be unique.
@@ -185,8 +178,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'}}`.
@@ -195,8 +186,6 @@ interface ExposedSource {
     text?: Record<Lang, string> | string;
     /** {zh}
      * @brief 该线路下清晰度列表。
-     * @default 无
-     *
      */
     /** {en}
      * @brief A list of resolutions of the current source.
@@ -406,25 +395,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"
 }
@@ -877,7 +865,6 @@ type ErrorConfig = {
     showRefresh?: boolean;
     /** {zh}
      * @brief 自定义报错显示。
-     * @default 无
      */
     /** {en}
      * @brief Custom error message.
@@ -886,7 +873,6 @@ type ErrorConfig = {
     errorTipsText?: string | Record<Lang, string>;
     /** {zh}
      * @brief 更多提示信息。
-     * @default 无
      */
     /** {en}
      * @brief More tips.
@@ -987,7 +973,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`.
@@ -1013,7 +998,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.
@@ -1021,7 +1005,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.
@@ -1029,7 +1012,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.
@@ -1037,7 +1019,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.
@@ -1045,7 +1026,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.
@@ -1099,7 +1079,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.
@@ -1115,7 +1094,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' } }}.
@@ -1125,7 +1103,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}
      */
@@ -1231,7 +1209,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.
@@ -1309,7 +1286,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.
@@ -1319,7 +1295,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
      *  @brief 是否启用微信全屏播放模式。
      * - `true`：启用
      * - `false`：停用
-     * @default 无
      */
     /** {en}
      *  @brief Whether to enable full-screen playback in WeChat.
@@ -1332,7 +1307,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:
@@ -1343,7 +1317,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
     /** {zh}
      * @brief 为播放器配置关键点样式。
-     * @default 无
      * @hidden 直播目前没用到
      */
     /** {en}
@@ -1353,7 +1326,6 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     commonStyle?: CommonStyle;
     /** {zh}
      * @brief 自定义插件列表。
-     * @default 无
      */
     /** {en}
      * @brief A list of custom plugins.
@@ -1396,10 +1368,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;
 }
@@ -1468,7 +1440,6 @@ interface Fullscreen {
 interface CommonStyle {
     /** {zh}
      * @brief 进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief The background color of the progress bar.
@@ -1476,7 +1447,6 @@ interface CommonStyle {
     progressColor?: string;
     /** {zh}
      * @brief 播放完成部分进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief The background color of the progress bar for the completed portion of video playback.
@@ -1484,7 +1454,6 @@ interface CommonStyle {
     playedColor?: string;
     /** {zh}
      * @brief 缓存部分进度条底色。
-     * @default 无
      */
     /** {en}
      * @brief
@@ -1493,7 +1462,6 @@ interface CommonStyle {
     cachedColor?: string;
     /** {zh}
      * @brief 进度条滑块样式。
-     * @default 无
      */
     /** {en}
      * @brief The style of the progress bar slider.
@@ -1504,7 +1472,6 @@ interface CommonStyle {
     };
     /** {zh}
      * @brief 音量颜色。
-     * @default 无
      */
     /** {en}
      * @brief The color of the volume slider.
@@ -1515,9 +1482,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 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
@@ -1604,6 +1572,7 @@ declare class VePlayerBase {
     private _events;
     private _customMedia?;
     private _errorCallback;
+    private _beforeFallbackError;
     /** {zh}
      * @hidden
      */
@@ -1643,7 +1612,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.
@@ -1754,7 +1723,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) 属性介绍。
      */
@@ -1844,7 +1813,6 @@ declare class VePlayerBase {
     switch(target: string | {
         /** {zh}
          * @brief 清晰度的唯一标识。
-         * @default 无
          */
         /** {en}
          * @brief The resolution ID.
@@ -1852,7 +1820,6 @@ declare class VePlayerBase {
         definition?: string;
         /** {zh}
          * @brief 线路的唯一标识。
-         * @default 无
          */
         /** {en}
          * @brief The playback source ID.
@@ -1892,8 +1859,6 @@ declare class VePlayerBase {
     updatePlaylist(playlist: ExposedSource[] | string, target?: string | {
         /** {zh}
          * @brief 清晰度唯一标识。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The resolution ID.
@@ -1902,8 +1867,6 @@ declare class VePlayerBase {
         definition?: string;
         /** {zh}
          * @brief 线路的唯一标识。
-         * @default 无
-         *
          */
         /** {en}
          * @brief The playback resource ID.
@@ -2104,7 +2067,6 @@ declare class VePlayerBase {
     Function | {
         /** {zh}
          * @brief 插件构造函数。
-         * @default 无
          */
         /** {en}
          * @brief The plugin constructor.
@@ -2113,7 +2075,6 @@ declare class VePlayerBase {
         plugin: Function;
         /** {zh}
          * @brief 插件配置参数。
-         * @default 无
          */
         /** {en}
          * @brief The plugin configurations.
@@ -2374,8 +2335,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;
@@ -2383,7 +2344,7 @@ declare namespace strategy {
         private _currentUrlRef;
         constructor(definitionSetting: {
             url: string;
-            definition: string;
+            definition?: string;
             source: Source;
             text?: Record<Lang, string> | string;
             fallbackUrls?: string[];
@@ -2409,7 +2370,6 @@ declare namespace strategy {
     interface ExposedDefinition {
         /** {zh}
          * @brief 播放地址。
-         * @default 无
          */
         /** {en}
          * @brief The playback address.
@@ -2417,17 +2377,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'}}`.
@@ -2435,14 +2392,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
@@ -2459,7 +2415,6 @@ declare namespace strategy {
     interface ExposedSource {
         /** {zh}
          * @brief 线路标识（唯一值）。
-         * @default 无
          */
         /** {en}
          * @brief The playback source ID. This value must be unique.
@@ -2467,8 +2422,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'}}`.
@@ -2477,8 +2430,6 @@ declare namespace strategy {
         text?: Record<Lang, string> | string;
         /** {zh}
          * @brief 该线路下清晰度列表。
-         * @default 无
-         *
          */
         /** {en}
          * @brief A list of resolutions of the current source.
@@ -2685,25 +2636,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"
     }
@@ -3160,7 +3110,6 @@ declare namespace strategy {
         showRefresh?: boolean;
         /** {zh}
          * @brief 自定义报错显示。
-         * @default 无
          */
         /** {en}
          * @brief Custom error message.
@@ -3169,7 +3118,6 @@ declare namespace strategy {
         errorTipsText?: string | Record<Lang, string>;
         /** {zh}
          * @brief 更多提示信息。
-         * @default 无
          */
         /** {en}
          * @brief More tips.
@@ -3329,7 +3277,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`.
@@ -3355,7 +3302,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.
@@ -3363,7 +3309,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.
@@ -3371,7 +3316,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.
@@ -3379,7 +3323,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.
@@ -3387,7 +3330,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.
@@ -3441,7 +3383,6 @@ declare namespace strategy {
         degradation?: Degradation | boolean;
         /** {zh}
          * @brief 为播放器设置封面图 URL。
-         * @default 无
          */
         /** {en}
          * @brief The URL of the player's cover image.
@@ -3457,7 +3398,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' } }}.
@@ -3467,7 +3407,7 @@ declare namespace strategy {
             texts: Record<Lang, Record<string, string>>;
         };
         /** {zh}
-         * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
+         * @brief 为播放器设置是否自动播放，`muted` 设置为 `true` 为静音自动播放。
          * @default { muted: true }
          * @type {{ muted: boolean } | boolean}
          */
@@ -3573,7 +3513,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.
@@ -3651,7 +3590,6 @@ declare namespace strategy {
         marginControls?: boolean;
         /** {zh}
          *  @brief 启用微信同层播放。
-         * @default 无
          */
         /** {en}
          *  @brief Enable playing the video on the same player as WeChat.
@@ -3661,7 +3599,6 @@ declare namespace strategy {
          *  @brief 是否启用微信全屏播放模式。
          * - `true`：启用
          * - `false`：停用
-         * @default 无
          */
         /** {en}
          *  @brief Whether to enable full-screen playback in WeChat.
@@ -3674,7 +3611,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:
@@ -3685,7 +3621,6 @@ declare namespace strategy {
         "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
         /** {zh}
          * @brief 为播放器配置关键点样式。
-         * @default 无
          * @hidden 直播目前没用到
          */
         /** {en}
@@ -3695,7 +3630,6 @@ declare namespace strategy {
         commonStyle?: CommonStyle;
         /** {zh}
          * @brief 自定义插件列表。
-         * @default 无
          */
         /** {en}
          * @brief A list of custom plugins.
@@ -3738,10 +3672,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;
     }
@@ -3810,7 +3744,6 @@ declare namespace strategy {
     interface CommonStyle {
         /** {zh}
          * @brief 进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief The background color of the progress bar.
@@ -3818,7 +3751,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.
@@ -3826,7 +3758,6 @@ declare namespace strategy {
         playedColor?: string;
         /** {zh}
          * @brief 缓存部分进度条底色。
-         * @default 无
          */
         /** {en}
          * @brief
@@ -3835,7 +3766,6 @@ declare namespace strategy {
         cachedColor?: string;
         /** {zh}
          * @brief 进度条滑块样式。
-         * @default 无
          */
         /** {en}
          * @brief The style of the progress bar slider.
@@ -3846,7 +3776,6 @@ declare namespace strategy {
         };
         /** {zh}
          * @brief 音量颜色。
-         * @default 无
          */
         /** {en}
          * @brief The color of the volume slider.
@@ -3857,9 +3786,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 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
@@ -4039,13 +3969,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 namespace error {
     const EN: {
@@ -4196,25 +4119,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"
     }