@volcengine/veplayer 2.6.0-rc.4 → 2.6.0-rc.5

package/umd/veplayer.d.ts

@@ -491,7 +491,14 @@ declare enum Level {
     /** {en}
      * @brief Error.
      */
-    Error = "Error"
+    Error = "Error",
+    /** {zh}
+     * @brief 提示。
+     */
+    /** {en}
+     * @brief Warn.
+     */
+    Warn = "Warn"
 }
 declare enum ErrorCode {
     /** {zh}
@@ -1530,13 +1537,13 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
  */
 interface Fullscreen {
     /** {zh}
-     * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-     * - `true`：使用旋转横屏；
-     * - `false`：不使用旋转横屏。
+     * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+     *        - `true`：使用旋转横屏；
+     *        - `false`：不使用旋转横屏。
      * @default false
      */
     /** {en}
-     * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+     * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
      *        - `true`: Enable.
      *        - `false`: Disable.
      * @default false
@@ -1632,15 +1639,16 @@ type PrepareResult = {
     options?: Partial<VePlayerBaseOptions>;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     plugins?: any[];
+    useSrc?: boolean;
 };
 type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
 /** {zh}
  * @detail option
- * @brief 视频的实际编码格式。如果您在degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
+ * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
  */
 /** {en}
  * @detail option
- * @brief The actual codec of the video.
+ * @brief The actual codec of the video. If you set the SoftFirst property in degradation (that is, hard solutions do not support downgrading soft solutions), it is recommended that you pass this parameter to save the operation of probing the actual encoding format.
  */
 declare enum Codec {
     /** {zh}
@@ -2315,16 +2323,17 @@ declare class VePlayerBase {
      * @hidden
      */
     prepare(url: string): Promise<{
-        plugins: any[];
+        plugins: any[] | undefined;
         options: Partial<VePlayerBaseOptions> | undefined;
+        isSameProtocol: boolean | "";
+        useSrc: boolean | undefined;
     }>;
     private _handleFallback;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     private _transformEvent;
     private _switch;
+    private _switchDifferentProtocolUrl;
     private _switchUrl;
-    // 获取需要卸载和需要注册的播放插件
-    private _diffPlugins;
     private _callBeforePlayerInitForUrl;
 }
 declare const enum State {
@@ -2352,6 +2361,7 @@ declare enum DynamicModule {
     PluginFlv = "plugin:flv",
     PluginMp4 = "plugin:mp4",
     PluginHls = "plugin:hls",
+    PluginHlsJs = "plugin:hlsjs",
     PluginShaka = "plugin:shaka",
     PluginRtm = "plugin:rtm",
     PluginXgvideo = "plugin:xgvideo",
@@ -2364,6 +2374,7 @@ type ModulesMap = {
     [DynamicModule.PluginFlv]: Exports;
     [DynamicModule.PluginMp4]: Exports;
     [DynamicModule.PluginHls]: Exports;
+    [DynamicModule.PluginHlsJs]: Exports;
     [DynamicModule.PluginShaka]: Exports;
     [DynamicModule.PluginRtm]: Exports;
     [DynamicModule.PluginXgvideo]: Exports;
@@ -2852,7 +2863,14 @@ declare namespace strategy {
         /** {en}
          * @brief Error.
          */
-        Error = "Error"
+        Error = "Error",
+        /** {zh}
+         * @brief 提示。
+         */
+        /** {en}
+         * @brief Warn.
+         */
+        Warn = "Warn"
     }
     enum ErrorCode {
         /** {zh}
@@ -3895,13 +3913,13 @@ declare namespace strategy {
      */
     interface Fullscreen {
         /** {zh}
-         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-         * - `true`：使用旋转横屏；
-         * - `false`：不使用旋转横屏。
+         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+         *        - `true`：使用旋转横屏；
+         *        - `false`：不使用旋转横屏。
          * @default false
          */
         /** {en}
-         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
          *        - `true`: Enable.
          *        - `false`: Disable.
          * @default false
@@ -3997,15 +4015,16 @@ declare namespace strategy {
         options?: Partial<VePlayerBaseOptions>;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         plugins?: any[];
+        useSrc?: boolean;
     };
     type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
     /** {zh}
      * @detail option
-     * @brief 视频的实际编码格式。如果您在degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
+     * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
      */
     /** {en}
      * @detail option
-     * @brief The actual codec of the video.
+     * @brief The actual codec of the video. If you set the SoftFirst property in degradation (that is, hard solutions do not support downgrading soft solutions), it is recommended that you pass this parameter to save the operation of probing the actual encoding format.
      */
     enum Codec {
         /** {zh}
@@ -4082,6 +4101,7 @@ declare namespace strategy {
         readonly "plugin:flv": "veplayer.plugin.flv.[env].[ext]";
         readonly "plugin:mp4": "veplayer.plugin.mp4.[env].[ext]";
         readonly "plugin:hls": "veplayer.plugin.hls.[env].[ext]";
+        readonly "plugin:hlsjs": "veplayer.plugin.hlsjs.[env].[ext]";
         readonly "plugin:shaka": "veplayer.plugin.shaka.[env].[ext]";
         readonly "plugin:rtm": "veplayer.plugin.rtm.[env].[ext]";
         readonly "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]";
@@ -4113,6 +4133,7 @@ declare namespace strategy {
         PluginFlv = "plugin:flv",
         PluginMp4 = "plugin:mp4",
         PluginHls = "plugin:hls",
+        PluginHlsJs = "plugin:hlsjs",
         PluginShaka = "plugin:shaka",
         PluginRtm = "plugin:rtm",
         PluginXgvideo = "plugin:xgvideo",
@@ -4125,6 +4146,7 @@ declare namespace strategy {
         [DynamicModule.PluginFlv]: Exports;
         [DynamicModule.PluginMp4]: Exports;
         [DynamicModule.PluginHls]: Exports;
+        [DynamicModule.PluginHlsJs]: Exports;
         [DynamicModule.PluginShaka]: Exports;
         [DynamicModule.PluginRtm]: Exports;
         [DynamicModule.PluginXgvideo]: Exports;
@@ -4165,22 +4187,16 @@ declare namespace strategy {
         module: R;
         afterLoad?: (module: ModulesMap[R]) => void;
     }
-    type StrategyCreator<T, R extends keyof ModulesMap = any> = (options?: T) => Strategy<T, R>;
+    type StrategyCreator<T, R extends keyof ModulesMap = any> = (options?: T, ...res: any) => Strategy<T, R>;
     const createFlvMseStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginFlv>;
-    const createHlsMseStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginHls>;
+    const createFlvMssStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginFlv>;
+    const createHlsMseStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginHlsJs | DynamicModule.PluginHls>;
     const createSoftDecodeH264Strategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginXgvideo>;
     const createSoftDecodeH265Strategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginXgvideo>;
     function getCodec(options: VePlayerBaseOptions): Promise<"unknown" | Codec>;
     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 getFlvStrategy: (options: VePlayerBaseOptions) => Promise<{
-        options?: undefined;
-        plugins?: undefined;
-    } | {
-        options: Partial<VePlayerBaseOptions>;
-        plugins: any[];
-    }>;
     const getHlsStrategy: (options: VePlayerBaseOptions) => Promise<{
         options?: undefined;
         plugins?: undefined;
@@ -4192,21 +4208,29 @@ declare namespace strategy {
 declare function getStreamType(url: string): "unknown" | "hls" | "flv" | "rtm" | "mp4" | "dash";
 /** {zh}
  * @detail api
- * @brief 当前浏览器是否支持播放编码格式。
- * @param codec 编码格式。
- *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
- *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+ * @brief 检查当前浏览器是否支持 MSE（MediaSource Extends）API，并检查 MSE API 是否支持传入的视频编码信息（MIME 格式）。
+ *        :::tip
+ *        使用场景：检查 PC 端浏览器和 Android 端浏览器是否支持传入的编码信息。
+ *        :::
+ * @param codec 待检查的媒体类型和编解码信息字符串，使用 MIME 格式表示，例如`video/mp4;codecs="av01.0.01M.08"`。
+ *        您也可以使用如下参数值快速检查是否支持 H.264 和 H.265 视频编码格式。
+ *        - `Codec.H264`（默认值）：检查 MSE 是否支持 H.264 编码格式，如果支持可满足大部分 H.264 视频播放。
+ *        - `Codec.H265`：检查 MSE 是否支持 H.265 编码格式，如果支持可满足大部分 H.265 视频播放。
  * @returns
  */
 /** {en}
  * @detail api
- * @brief Checkes whether the current browser supports the specified encoding format.
- * @param codec The encoding format.
- *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
- *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+ * @brief Check whether the current browser supports the MSE (MediaSource Extends) API and check whether the MSE API supports the incoming video encoding information (MIME format).
+ *        :::tip
+ *        Usage scenario: Check whether the PC-side browser and Android-side browser support the incoming encoding information.
+ *        :::
+ * @param codec The media type and codec information string to be checked is represented in MIME format, for example, `video/mp4;codecs="av01.0.01M.08"`.
+ *        You can also use the following parameter values to quickly check whether the H.264 and H.265 video coding formats are supported.
+ *        - `Codec.H264` (default value): Check if MSE supports the H.264 encoding format. If supported, it can meet the playback requirements of most H.264 videos.
+ *        - `Codec.H265`: Check if MSE supports the H.265 encoding format. If supported, it can meet the playback requirements of most H.265 videos.
  * @returns
  */
-declare function isMseSupported(codec?: string): boolean;
+declare function isMseSupported(codec?: string | undefined): boolean;
 /** {zh}
  * @detail api
  * @brief 当前浏览器是否支持软解。
@@ -4218,10 +4242,38 @@ declare function isMseSupported(codec?: string): boolean;
  * @returns
  */
 declare function isSoftDecodeSupported(): Promise<boolean>;
+/** {zh}
+ * @detail api
+ * @brief 判断当前浏览器是否支持 MMS（ManagedMediaSource） API，并检查 MMS API 是否支持传入的视频编码信息（MIME 格式）。
+ *        :::tip
+ *        - 使用场景：检查 iOS 端 Safari 浏览器和 Chrome 浏览器是否支持传入的编码信息。
+ *        - Safari 17.1 以上版本浏览器开始支持 MMS。
+ *        :::
+ * @returns
+ * @param codec 待检查的媒体类型和编解码信息字符串，使用 MIME 格式表示，例如`video/mp4;codecs="av01.0.01M.08"`。
+ *        您也可以使用如下参数值快速检查是否支持 H.264 和 H.265 视频编码格式。
+ *        - `Codec.H264`（默认值）：检查 MMS 是否支持 H.264 编码格式，如果支持可满足大部分 H.264 视频播放。
+ *        - `Codec.H265`：检查 MMS 是否支持 H.265 编码格式。如果支持可满足大部分 H.265 视频播放。
+ */
+/** {en}
+ * @detail api
+ * @returns
+ * @brief Check whether the current browser supports the MMS (ManagedMediaSource) API and check whether the MMS API supports the incoming video encoding information (MIME format).
+ *        :::tip
+ *        - Usage scenario: Check whether the Safari browser and Chrome browser on the iOS side support the incoming encoding information.
+ *        - Browsers with iOS 17.1 or above start to support MMS.
+ *        :::
+ * @param codec The media type and codec information string to be checked is represented in MIME format, for example, `video/mp4;codecs="av01.0.01M.08"`.
+ *        You can also use the following parameter values to quickly check whether the H.264 and H.265 video coding formats are supported.
+ *        - `Codec.H264` (default value): Check if MMS supports the H.264 encoding format. If supported, it can meet the playback requirements of most H.264 videos.
+ *        - `Codec.H265`: Check if MMS supports the H.265 encoding format. If supported, it can meet the playback requirements of most H.265 videos.
+ */
+declare function isMMSSupported(codec?: string | undefined): any;
 declare const util: {
     getStreamType: typeof getStreamType;
     isMseSupported: typeof isMseSupported;
     isSoftDecodeSupported: typeof isSoftDecodeSupported;
+    isMMSSupported: typeof isMMSSupported;
     appendSearchParams: (url?: string | undefined, searchParams?: Record<string, string> | undefined) => string;
     getUrlObject: (url?: string | undefined) => URL | undefined;
     createDom(el?: string | undefined, tpl?: string | undefined, attrs?: {
@@ -4464,7 +4516,14 @@ declare namespace error {
         /** {en}
          * @brief Error.
          */
-        Error = "Error"
+        Error = "Error",
+        /** {zh}
+         * @brief 提示。
+         */
+        /** {en}
+         * @brief Warn.
+         */
+        Warn = "Warn"
     }
     enum ErrorCode {
         /** {zh}
@@ -4910,6 +4969,20 @@ declare namespace event {
         ABR_SWITCH_START: string;
         ABR_SWITCH_SUCCESS: string;
         ABR_SWITCH_FAILED: string;
+        AD_FIRST_QUARTILE: string;
+        AD_MIDPOINT: string;
+        AD_THIRD_QUARTILE: string;
+        AD_CLICK: string;
+        AD_IMPRESSION: string;
+        AD_RESUME: string;
+        AD_START: string;
+        AD_PLAY: string;
+        AD_PAUSE: string;
+        AD_TIME_UPDATE: string;
+        AD_SKIPPED: string;
+        AD_ERROR: string;
+        AD_COMPLETE: string;
+        AD_ALL_COMPLETED: string;
     };
     const Events: {
         SEI: string;
@@ -4938,6 +5011,20 @@ declare namespace event {
         ABR_SWITCH_START: string;
         ABR_SWITCH_SUCCESS: string;
         ABR_SWITCH_FAILED: string;
+        AD_FIRST_QUARTILE: string;
+        AD_MIDPOINT: string;
+        AD_THIRD_QUARTILE: string;
+        AD_CLICK: string;
+        AD_IMPRESSION: string;
+        AD_RESUME: string;
+        AD_START: string;
+        AD_PLAY: string;
+        AD_PAUSE: string;
+        AD_TIME_UPDATE: string;
+        AD_SKIPPED: string;
+        AD_ERROR: string;
+        AD_COMPLETE: string;
+        AD_ALL_COMPLETED: string;
         REPLAY: string;
         ERROR: string;
         PLAY: string;
@@ -5172,7 +5259,7 @@ interface LoggerConfig {
     /** {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).
      */
-    appId: string;
+    appId?: string;
     /** {zh}
      * @brief 应用名称。
      * @default 无
@@ -5206,7 +5293,7 @@ interface LoggerConfig {
      */
     deviceId?: string;
     /** {zh}
-     * @brief 报错时是否在报错面板显示当前用户id信息。
+     * @brief 报错时是否在报错面板显示当前用户 ID 信息。
      * @default true
      */
     /** {en}
@@ -5236,23 +5323,25 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      */
     rtm?: Rtm;
     /** {zh}
-     * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
+     * @brief 为播放器设置 FLV 拉流配置。
+     * @listtip FLV 拉流格式流相关配置适用于支持 MSE 播放的 PC 端浏览器、安卓端浏览器和支持 MMS API 的 iOS 浏览器。
      */
     /** {en}
-     * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
+     * @brief Configurations for playing an FLV stream.
+     * @listtip FLV pull stream format stream configurations are applicable to PC browsers, Android browsers that support MSE playback, and iOS browsers that support MMS API.
      */
     flv?: Flv;
     /** {zh}
-     * @brief 为播放器设置 HLS 拉流配置。HLS 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-     * @listtip
-     *  - PC 端该配置默认生效；
-     *  - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
+     * @brief 为播放器设置 HLS 拉流配置。
+     * @listtip - HLS 格式流相关配置仅适用于支持 MSE API的 PC 端浏览器和安卓端浏览器。
+     *          - PC 端该配置默认生效；
+     *          - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
      */
     /** {en}
-     * @brief  Configurations for playing an HLS stream. You can only play HLS streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-     * @listtip
-     *  - This configuration takes effect by default on PC;
-     *  - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
+     * @brief Configurations for playing an HLS stream.
+     * @listtip - The HLS format stream configuration is only applicable to PC browsers and Android browsers that support the MSE API.
+     *          - This configuration takes effect by default on PC;
+     *          - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
      */
     hls?: Hls;
     /** {zh}
@@ -5288,7 +5377,7 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      * @default 无
      */
     /** {en}
-     * @brief A list of built-in plug-ins to be disabled.
+     * @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}
@@ -5296,7 +5385,7 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      * @default 无
      */
     /** {en}
-     * @brief The plug-in icon.
+     * @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).
      */
     icons?: any;
     /** {zh}
@@ -5318,14 +5407,14 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
 interface Abr {
     /** {zh}
      * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
-     *        - true: 开启
-     *        - false: 关闭
+     *        - `true`: 开启；
+     *        - `false`: 关闭。
      * @default true
      */
     /** {en}
      * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
-     *        - true: Enable;
-     *        - false: Disable.
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      */
     enable?: boolean;
     /** {zh}
@@ -5344,14 +5433,14 @@ interface Abr {
     downTip?: boolean;
     /** {zh}
      * @brief 是否开始调试模式，默认为关闭。
-     *        - true: 开启；
-     *        - false: 关闭。
+     *        - `true`: 开启；
+     *        - `false`: 关闭。
      * @default false
      */
     /** {en}
      * @brief Whether to start debug mode, default is false.
-     *        - true: Enable,
-     *        - false: Disable.
+     *        - `true`: Enable,
+     *        - `false`: Disable.
      * @default false
      */
     debug?: boolean;
@@ -5586,7 +5675,7 @@ interface AdConfig {
      * @brief Ad client that will be used to display advertisements
      *        - `google-ima`：Use the Google IMA SDK
      */
-    adType: "google-ima";
+    adType: "google-ima" | "ssai";
     /** {en}
      * @brief Property enabling SCTE-35 tag in hls manifest
      * - false: SCTE-35 disabled
@@ -5594,6 +5683,14 @@ interface AdConfig {
      * @default false
      */
     enableSCTE35?: boolean;
+    /**
+     * @hidden
+     */
+    replayForSCTE35?: {
+        enable?: boolean;
+        // duration 剩下超过多久才会重播
+        minDurationOffset?: number;
+    };
     /** {en}
      * @brief Configurations for Google IMA SDK
      * @listtip Required when adType is `google-ima`
@@ -5659,16 +5756,16 @@ interface Rtm {
     retryDelay?: number;
     /** {zh}
      * @brief 播放器发起 RTM 拉流请求时，是否开启自动转码。
-     * - true：开启
-     * - false：关闭
+     *        - `true`：开启；
+     *        - `false`：关闭。
      * @listtip
      * 如有使用 RTM 拉流自动转码的需求，请先创建工单联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)进行配置。
      * @default false
      */
     /** {en}
      * @brief Whether to enable automatic transcoding when the player requests to pull an RTM stream.
-     * - true: Enable
-     * - false: Disable
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      * @listtip
      * If you want to use the automatic transcoding feature when playing an RTM stream, contact your [technical support](https://www.byteplus.com/en/support).
      * @default false
@@ -5682,6 +5779,39 @@ interface Rtm {
      * @brief Specify the recent time length for network evaluation in milliseconds. The default is 1000, which means evaluating the network conditions over the last 1000 milliseconds.
      */
     networkEvaluateInterval?: number;
+    /** {zh}
+     * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+     *        - `true`：是，重新拉流期间不会出现黑屏现象。
+     *        - `false`：否，重新拉流期间会出现黑屏现象。
+     * @default false
+     * @listtip Safari 浏览器在进行 RTM 拉流时不支持使用此配置。
+     */
+    /** {en}
+     * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+     *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+     *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
+     *        :::tip
+     *        Safari browsers do not support using this configuration when performing RTM stream pulling.
+     *        :::
+     * @default false
+     */
+    seamlesslyReload?: boolean;
+    /** {zh}
+     * @brief 暂停播放后的断联时间，单位为秒，默认不断联。
+     * @listtip Safari 浏览器在进行 RTM 拉流时，如果出现断联，重新拉流时会出现短暂黑屏或加载情况。
+     */
+    /** {en}
+     * @brief The disconnection time after pausing playback is in seconds. By default, there is no disconnection.
+     * @listtip When Safari browser performs RTM streaming, if there is a disconnection, there will be a short black screen or loading situation when re-streaming.
+     */
+    disconnectTime?: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
+    enableOriginSdpLogger?: boolean;
 }
 /** {zh}
  * @list option
@@ -5721,15 +5851,17 @@ interface Flv {
     loadTimeout?: number;
     /** {zh}
      * @brief 播放器发起 FLV 拉流请求时，是否开启低延时。例如，当您开启低延时且推流端 GOP 设置为 2s 的情况下，FLV 拉流平均端到端延时约为 2s。
-     * - true：开启
-     * - false：关闭
+     *        - `true`：开启；
+     *        - `false`：关闭
      * @default false
+     * @listtip 低延迟 FLV 拉流仅在 PC 端浏览器中生效。
      */
     /** {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.
-     * - true: Enable
-     * - false: Disable
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      * @default false
+     * @listtip Low-latency FLV pull-streaming is only effective in PC browsers.
      */
     enableLowLatency?: boolean;
     /** {zh}
@@ -5762,23 +5894,24 @@ interface Flv {
      */
     maxReaderInterval?: number;
     /** {zh}
-     * @brief
-     *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+     * @brief 暂停播放后的断联时间，单位为秒，默认值为 0，表示暂停播放后立即断联。
      * @default 0
      */
     /** {en}
-     * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+     * @brief The disconnection time after pausing playback is in seconds. The default value is 0, indicating immediate disconnection after pausing playback.
      * @default 0
      */
     disconnectTime?: number;
     /** {zh}
-     * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
-     *        - `true`：是；
-     *        - `false`：否。
+     * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+     *        - `true`：是，重新拉流期间不会出现黑屏现象。
+     *        - `false`：否，重新拉流期间会出现黑屏现象。
      * @default false
      */
     /** {en}
-     * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+     * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+     *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+     *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
      * @default false
      */
     seamlesslyReload?: boolean;
@@ -5801,14 +5934,14 @@ interface LowLatency {
     abrPts?: string | number;
     /** {zh}
      * @brief FLV 低延时模式下，是否开启倍速追帧。
-     *        - true：开启；
-     *        - false：关闭。
+     *        - `true`：开启；
+     *        - `false`：关闭。
      * @default true
      */
     /** {en}
      * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
-     *        - true: enabled;
-     *        - false: disabled.
+     *        - `true`: enabled;
+     *        - `false`: disabled.
      * @default true
      */
     enableFrameChasing?: boolean;
@@ -5875,6 +6008,10 @@ interface Hls {
      * @hidden
      */
     mseLowLatency?: boolean;
+    /**
+     * @hidden
+     */
+    enableHlsJs?: boolean;
 }
 /** {zh}
  * @list option
@@ -6314,6 +6451,7 @@ 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;
+    get ad(): any;
     /** {zh}
      * @brief 调用此方法开启直播日志上报。
      */
@@ -6486,6 +6624,35 @@ declare function isRTMSupported(): Promise<boolean>;
  * @returns
  */
 declare function isRTMSupportCodec(codec?: string): Promise<boolean>;
+/** {zh}
+ * @detail api
+ * @brief 检查当前浏览器是否支持 FLV 格式流的编码信息。
+ *        :::tip
+ *        - 在 PC 端或 Android 端浏览器调用此方法，实现方法与 isMseSupported 方法实现相同。
+ *        - 在 iOS 端浏览器调用此方法，实现与 isMMSSupported 方法实现相同。
+ *        :::
+ * @kind property
+ * @returns
+ * @param codec 待检查的媒体类型和编解码信息字符串，使用 MIME 格式表示，例如`video/mp4;codecs="av01.0.01M.08"`。
+ *        您也可以使用如下参数值快速检查是否支持 H.264 和 H.265 视频编码格式。
+ *        - `Codec.H264`（默认值）：检查是否支持 H.264 编码格式，如果支持可满足大部分 H.264 视频播放。
+ *        - `Codec.H265`：检查是否支持 H.265 编码格式。如果支持可满足大部分 H.265 视频播放。
+ */
+/** {en}
+ * @detail api
+ * @brief Check whether the current browser supports the encoding information of FLV format streams.
+ *        :::tip
+ *        - When this method is called in a browser on a PC or Android device, it is the same as when the isMseSupported method is called with the default encoding format.
+ *        - When this method is called in a browser on an iOS device, it is the same as when the isMMSSupported method is implemented.
+ *        :::
+ * @kind property
+ * @returns
+ * @param codec The media type and codec information string to be checked is represented in MIME format, for example, `video/mp4;codecs="av01.0.01M.08"`.
+ *        You can also use the following parameter values to quickly check whether the H.264 and H.265 video coding formats are supported.
+ *        - `Codec.H264` (default value): Check if the H.264 encoding format is supported. If supported, it can meet the playback requirements of most H.264 videos.
+ *        - `Codec.H265`: Check if the H.265 encoding format is supported. If supported, it can meet the playback requirements of most H.265 videos.
+ */
+declare function isFLVSupported(codec?: string | undefined): boolean;
 declare module MobilePlayerPanelWrapper {
     export { MobilePlayerPanel };
 }
@@ -6651,7 +6818,14 @@ declare namespace live {
         /** {en}
          * @brief Error.
          */
-        Error = "Error"
+        Error = "Error",
+        /** {zh}
+         * @brief 提示。
+         */
+        /** {en}
+         * @brief Warn.
+         */
+        Warn = "Warn"
     }
     enum ErrorCode {
         /** {zh}
@@ -8187,6 +8361,20 @@ declare namespace live {
         ABR_SWITCH_START: string;
         ABR_SWITCH_SUCCESS: string;
         ABR_SWITCH_FAILED: string;
+        AD_FIRST_QUARTILE: string;
+        AD_MIDPOINT: string;
+        AD_THIRD_QUARTILE: string;
+        AD_CLICK: string;
+        AD_IMPRESSION: string;
+        AD_RESUME: string;
+        AD_START: string;
+        AD_PLAY: string;
+        AD_PAUSE: string;
+        AD_TIME_UPDATE: string;
+        AD_SKIPPED: string;
+        AD_ERROR: string;
+        AD_COMPLETE: string;
+        AD_ALL_COMPLETED: string;
         REPLAY: string;
         ERROR: string;
         PLAY: string;
@@ -9033,13 +9221,13 @@ declare namespace live {
      */
     interface Fullscreen {
         /** {zh}
-         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-         * - `true`：使用旋转横屏；
-         * - `false`：不使用旋转横屏。
+         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+         *        - `true`：使用旋转横屏；
+         *        - `false`：不使用旋转横屏。
          * @default false
          */
         /** {en}
-         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
          *        - `true`: Enable.
          *        - `false`: Disable.
          * @default false
@@ -9135,15 +9323,16 @@ declare namespace live {
         options?: Partial<VePlayerBaseOptions>;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         plugins?: any[];
+        useSrc?: boolean;
     };
     type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
     /** {zh}
      * @detail option
-     * @brief 视频的实际编码格式。如果您在degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
+     * @brief 视频的实际编码格式。如果您在 degradation 设置了 SoftFirst 属性（即硬解不支持降级软解），建议您传入该参数，省去探测实际编码格式的操作。
      */
     /** {en}
      * @detail option
-     * @brief The actual codec of the video.
+     * @brief The actual codec of the video. If you set the SoftFirst property in degradation (that is, hard solutions do not support downgrading soft solutions), it is recommended that you pass this parameter to save the operation of probing the actual encoding format.
      */
     enum Codec {
         /** {zh}
@@ -9819,16 +10008,17 @@ declare namespace live {
          * @hidden
          */
         prepare(url: string): Promise<{
-            plugins: any[];
+            plugins: any[] | undefined;
             options: Partial<VePlayerBaseOptions> | undefined;
+            isSameProtocol: boolean | "";
+            useSrc: boolean | undefined;
         }>;
         private _handleFallback;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         private _transformEvent;
         private _switch;
+        private _switchDifferentProtocolUrl;
         private _switchUrl;
-        // 获取需要卸载和需要注册的播放插件
-        private _diffPlugins;
         private _callBeforePlayerInitForUrl;
     }
     /// <reference types="./loader" />
@@ -9838,6 +10028,7 @@ declare namespace live {
         readonly "plugin:flv": "veplayer.plugin.flv.[env].[ext]";
         readonly "plugin:mp4": "veplayer.plugin.mp4.[env].[ext]";
         readonly "plugin:hls": "veplayer.plugin.hls.[env].[ext]";
+        readonly "plugin:hlsjs": "veplayer.plugin.hlsjs.[env].[ext]";
         readonly "plugin:shaka": "veplayer.plugin.shaka.[env].[ext]";
         readonly "plugin:rtm": "veplayer.plugin.rtm.[env].[ext]";
         readonly "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]";
@@ -9869,6 +10060,7 @@ declare namespace live {
         PluginFlv = "plugin:flv",
         PluginMp4 = "plugin:mp4",
         PluginHls = "plugin:hls",
+        PluginHlsJs = "plugin:hlsjs",
         PluginShaka = "plugin:shaka",
         PluginRtm = "plugin:rtm",
         PluginXgvideo = "plugin:xgvideo",
@@ -9881,6 +10073,7 @@ declare namespace live {
         [DynamicModule.PluginFlv]: Exports;
         [DynamicModule.PluginMp4]: Exports;
         [DynamicModule.PluginHls]: Exports;
+        [DynamicModule.PluginHlsJs]: Exports;
         [DynamicModule.PluginShaka]: Exports;
         [DynamicModule.PluginRtm]: Exports;
         [DynamicModule.PluginXgvideo]: Exports;
@@ -9916,29 +10109,38 @@ declare namespace live {
     function setBaseUrl(url: string): void;
     function getBaseUrl(): string;
     function load<T extends DynamicModule>(name: T, src?: string): Promise<ModulesMap[T]>;
-    const isHls: (url: string) => boolean;
-    const isMp4: (url: string) => boolean;
-    const isFlv: (url: string) => boolean;
-    const isRtm: (url: string) => boolean;
-    const isDash: (url: string) => boolean;
+    const isType: any;
+    const isHls: any;
+    const isMp4: any;
+    const isFlv: any;
+    const isRtm: any;
+    const isDash: any;
     function getStreamType(url: string): "unknown" | "hls" | "flv" | "rtm" | "mp4" | "dash";
     /** {zh}
      * @detail api
-     * @brief 当前浏览器是否支持播放编码格式。
-     * @param codec 编码格式。
-     *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
-     *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+     * @brief 检查当前浏览器是否支持 MSE（MediaSource Extends）API，并检查 MSE API 是否支持传入的视频编码信息（MIME 格式）。
+     *        :::tip
+     *        使用场景：检查 PC 端浏览器和 Android 端浏览器是否支持传入的编码信息。
+     *        :::
+     * @param codec 待检查的媒体类型和编解码信息字符串，使用 MIME 格式表示，例如`video/mp4;codecs="av01.0.01M.08"`。
+     *        您也可以使用如下参数值快速检查是否支持 H.264 和 H.265 视频编码格式。
+     *        - `Codec.H264`（默认值）：检查 MSE 是否支持 H.264 编码格式，如果支持可满足大部分 H.264 视频播放。
+     *        - `Codec.H265`：检查 MSE 是否支持 H.265 编码格式，如果支持可满足大部分 H.265 视频播放。
      * @returns
      */
     /** {en}
      * @detail api
-     * @brief Checkes whether the current browser supports the specified encoding format.
-     * @param codec The encoding format.
-     *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
-     *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+     * @brief Check whether the current browser supports the MSE (MediaSource Extends) API and check whether the MSE API supports the incoming video encoding information (MIME format).
+     *        :::tip
+     *        Usage scenario: Check whether the PC-side browser and Android-side browser support the incoming encoding information.
+     *        :::
+     * @param codec The media type and codec information string to be checked is represented in MIME format, for example, `video/mp4;codecs="av01.0.01M.08"`.
+     *        You can also use the following parameter values to quickly check whether the H.264 and H.265 video coding formats are supported.
+     *        - `Codec.H264` (default value): Check if MSE supports the H.264 encoding format. If supported, it can meet the playback requirements of most H.264 videos.
+     *        - `Codec.H265`: Check if MSE supports the H.265 encoding format. If supported, it can meet the playback requirements of most H.265 videos.
      * @returns
      */
-    function isMseSupported(codec?: string): boolean;
+    function isMseSupported(codec?: string | undefined): boolean;
     /** {zh}
      * @detail api
      * @brief 当前浏览器是否支持软解。
@@ -9950,10 +10152,38 @@ declare namespace live {
      * @returns
      */
     function isSoftDecodeSupported(): Promise<boolean>;
+    /** {zh}
+     * @detail api
+     * @brief 判断当前浏览器是否支持 MMS（ManagedMediaSource） API，并检查 MMS API 是否支持传入的视频编码信息（MIME 格式）。
+     *        :::tip
+     *        - 使用场景：检查 iOS 端 Safari 浏览器和 Chrome 浏览器是否支持传入的编码信息。
+     *        - Safari 17.1 以上版本浏览器开始支持 MMS。
+     *        :::
+     * @returns
+     * @param codec 待检查的媒体类型和编解码信息字符串，使用 MIME 格式表示，例如`video/mp4;codecs="av01.0.01M.08"`。
+     *        您也可以使用如下参数值快速检查是否支持 H.264 和 H.265 视频编码格式。
+     *        - `Codec.H264`（默认值）：检查 MMS 是否支持 H.264 编码格式，如果支持可满足大部分 H.264 视频播放。
+     *        - `Codec.H265`：检查 MMS 是否支持 H.265 编码格式。如果支持可满足大部分 H.265 视频播放。
+     */
+    /** {en}
+     * @detail api
+     * @returns
+     * @brief Check whether the current browser supports the MMS (ManagedMediaSource) API and check whether the MMS API supports the incoming video encoding information (MIME format).
+     *        :::tip
+     *        - Usage scenario: Check whether the Safari browser and Chrome browser on the iOS side support the incoming encoding information.
+     *        - Browsers with iOS 17.1 or above start to support MMS.
+     *        :::
+     * @param codec The media type and codec information string to be checked is represented in MIME format, for example, `video/mp4;codecs="av01.0.01M.08"`.
+     *        You can also use the following parameter values to quickly check whether the H.264 and H.265 video coding formats are supported.
+     *        - `Codec.H264` (default value): Check if MMS supports the H.264 encoding format. If supported, it can meet the playback requirements of most H.264 videos.
+     *        - `Codec.H265`: Check if MMS supports the H.265 encoding format. If supported, it can meet the playback requirements of most H.265 videos.
+     */
+    function isMMSSupported(codec?: string | undefined): any;
     const util: {
         getStreamType: typeof getStreamType;
         isMseSupported: typeof isMseSupported;
         isSoftDecodeSupported: typeof isSoftDecodeSupported;
+        isMMSSupported: typeof isMMSSupported;
         appendSearchParams: (url?: string | undefined, searchParams?: Record<string, string> | undefined) => string;
         getUrlObject: (url?: string | undefined) => URL | undefined;
         createDom(el?: string | undefined, tpl?: string | undefined, attrs?: {
@@ -10190,6 +10420,8 @@ declare namespace live {
     }
     const EN$0: {
         INVALID_PARAMETER: string;
+        INVALID_LOGGER: string;
+        EMPTY_RTM_FALLBACK_PARAMETER: string;
         FORMAT: string;
         FPS: string;
         BITRATE: string;
@@ -10262,6 +10494,8 @@ declare namespace live {
     };
     const ZH_CN$0: {
         INVALID_PARAMETER: string;
+        INVALID_LOGGER: string;
+        EMPTY_RTM_FALLBACK_PARAMETER: string;
         FORMAT: string;
         FPS: string;
         BITRATE: string;
@@ -10334,6 +10568,10 @@ declare namespace live {
     };
     type TextKey$0 = keyof typeof EN$0;
     const VeError$0: typeof error.VeError;
+    // ve 自定义错误码
+    // 第一位: 1 表示点播，2 表示直播
+    // 第二位: 功能粒度，比如 210 中 1 表示入参参数有问题
+    // 第三位: 某功能下细分，如果细拆成地址有问题就可以用 211 表示。
     enum LiveErrorCode {
         /** {zh}
          * @brief 参数错误
@@ -10343,7 +10581,20 @@ declare namespace live {
          * @brief Parameter errors.
          * @solution Please check whether the required parameters `url` and `playlist` are specified.
          */
-        INVALID_PARAMETER = 210
+        INVALID_PARAMETER = 210,
+        /**
+         * @hidden
+         */
+        EMPTY_RTM_FALLBACK_PARAMETER = 211,
+        /** {zh}
+         * @brief 日志错误
+         * @solution 未正确配置质量日志参数, 请参考 https://www.volcengine.com/docs/6469/138655#日志上报 配置。
+         */
+        /** {en}
+         * @brief Log errors.
+         * @solution Log options not configured correctly. Please refer to this document https://docs.byteplus.com/en/docs/byteplus-media-live/docs-feature-implementation#uploading-logs to configure the logs.
+         */
+        INVALID_LOGGER = 220
     }
     const Level$0: typeof error.Level;
     type ErrorInfo$0 = error.ErrorInfo;
@@ -10397,10 +10648,12 @@ declare namespace live {
         MODULE_LOAD_ERROR: error.ErrorCode.MODULE_LOAD_ERROR;
         UNKNOWN: error.ErrorCode.UNKNOWN;
         INVALID_PARAMETER: LiveErrorCode.INVALID_PARAMETER;
+        EMPTY_RTM_FALLBACK_PARAMETER: LiveErrorCode.EMPTY_RTM_FALLBACK_PARAMETER;
+        INVALID_LOGGER: LiveErrorCode.INVALID_LOGGER;
     };
     type ValueOf<T> = T[keyof T];
     const ERRORS: Partial<Record<ValueOf<typeof ErrorCode$0>, error.ErrorInfo<TextKey$0>>>;
-    function create$0(errorCode: ValueOf<typeof ErrorCode$0>, i18n?: VeI18n<TextKey$0>): error.VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP" | "GOP" | "INVALID_PARAMETER" | "FORMAT" | "FPS" | "BITRATE" | "RESOLUTION" | "ENCODE_TYPE" | "BUFFER_END" | "CURRENT_TIME" | "DECODE_EFFICIENCY" | "DECODE_COST" | "DECODE_INFO">;
+    function create$0(errorCode: ValueOf<typeof ErrorCode$0>, i18n?: VeI18n<TextKey$0>): error.VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP" | "GOP" | "INVALID_PARAMETER" | "EMPTY_RTM_FALLBACK_PARAMETER" | "INVALID_LOGGER" | "FORMAT" | "FPS" | "BITRATE" | "RESOLUTION" | "ENCODE_TYPE" | "BUFFER_END" | "CURRENT_TIME" | "DECODE_EFFICIENCY" | "DECODE_COST" | "DECODE_INFO">;
     /** {zh}
      * @list option
      * @kind property
@@ -10506,7 +10759,7 @@ declare namespace live {
         /** {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).
          */
-        appId: string;
+        appId?: string;
         /** {zh}
          * @brief 应用名称。
          * @default 无
@@ -10540,7 +10793,7 @@ declare namespace live {
          */
         deviceId?: string;
         /** {zh}
-         * @brief 报错时是否在报错面板显示当前用户id信息。
+         * @brief 报错时是否在报错面板显示当前用户 ID 信息。
          * @default true
          */
         /** {en}
@@ -10562,6 +10815,7 @@ declare namespace live {
             enable: boolean;
             showUserIdInErrorPanel: boolean;
         };
+        beforeCreate(args: any): void;
         afterCreate(): void;
         destroy(): void;
         close(): void;
@@ -10590,23 +10844,25 @@ declare namespace live {
          */
         rtm?: Rtm;
         /** {zh}
-         * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
+         * @brief 为播放器设置 FLV 拉流配置。
+         * @listtip FLV 拉流格式流相关配置适用于支持 MSE 播放的 PC 端浏览器、安卓端浏览器和支持 MMS API 的 iOS 浏览器。
          */
         /** {en}
-         * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
+         * @brief Configurations for playing an FLV stream.
+         * @listtip FLV pull stream format stream configurations are applicable to PC browsers, Android browsers that support MSE playback, and iOS browsers that support MMS API.
          */
         flv?: Flv;
         /** {zh}
-         * @brief 为播放器设置 HLS 拉流配置。HLS 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-         * @listtip
-         *  - PC 端该配置默认生效；
-         *  - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
+         * @brief 为播放器设置 HLS 拉流配置。
+         * @listtip - HLS 格式流相关配置仅适用于支持 MSE API的 PC 端浏览器和安卓端浏览器。
+         *          - PC 端该配置默认生效；
+         *          - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
          */
         /** {en}
-         * @brief  Configurations for playing an HLS stream. You can only play HLS streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-         * @listtip
-         *  - This configuration takes effect by default on PC;
-         *  - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
+         * @brief Configurations for playing an HLS stream.
+         * @listtip - The HLS format stream configuration is only applicable to PC browsers and Android browsers that support the MSE API.
+         *          - This configuration takes effect by default on PC;
+         *          - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
          */
         hls?: Hls;
         /** {zh}
@@ -10642,7 +10898,7 @@ declare namespace live {
          * @default 无
          */
         /** {en}
-         * @brief A list of built-in plug-ins to be disabled.
+         * @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}
@@ -10650,7 +10906,7 @@ declare namespace live {
          * @default 无
          */
         /** {en}
-         * @brief The plug-in icon.
+         * @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).
          */
         icons?: any;
         /** {zh}
@@ -10672,14 +10928,14 @@ declare namespace live {
     interface Abr {
         /** {zh}
          * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
-         *        - true: 开启
-         *        - false: 关闭
+         *        - `true`: 开启；
+         *        - `false`: 关闭。
          * @default true
          */
         /** {en}
          * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
-         *        - true: Enable;
-         *        - false: Disable.
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          */
         enable?: boolean;
         /** {zh}
@@ -10698,14 +10954,14 @@ declare namespace live {
         downTip?: boolean;
         /** {zh}
          * @brief 是否开始调试模式，默认为关闭。
-         *        - true: 开启；
-         *        - false: 关闭。
+         *        - `true`: 开启；
+         *        - `false`: 关闭。
          * @default false
          */
         /** {en}
          * @brief Whether to start debug mode, default is false.
-         *        - true: Enable,
-         *        - false: Disable.
+         *        - `true`: Enable,
+         *        - `false`: Disable.
          * @default false
          */
         debug?: boolean;
@@ -10940,7 +11196,7 @@ declare namespace live {
          * @brief Ad client that will be used to display advertisements
          *        - `google-ima`：Use the Google IMA SDK
          */
-        adType: "google-ima";
+        adType: "google-ima" | "ssai";
         /** {en}
          * @brief Property enabling SCTE-35 tag in hls manifest
          * - false: SCTE-35 disabled
@@ -10948,6 +11204,14 @@ declare namespace live {
          * @default false
          */
         enableSCTE35?: boolean;
+        /**
+         * @hidden
+         */
+        replayForSCTE35?: {
+            enable?: boolean;
+            // duration 剩下超过多久才会重播
+            minDurationOffset?: number;
+        };
         /** {en}
          * @brief Configurations for Google IMA SDK
          * @listtip Required when adType is `google-ima`
@@ -11013,16 +11277,16 @@ declare namespace live {
         retryDelay?: number;
         /** {zh}
          * @brief 播放器发起 RTM 拉流请求时，是否开启自动转码。
-         * - true：开启
-         * - false：关闭
+         *        - `true`：开启；
+         *        - `false`：关闭。
          * @listtip
          * 如有使用 RTM 拉流自动转码的需求，请先创建工单联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)进行配置。
          * @default false
          */
         /** {en}
          * @brief Whether to enable automatic transcoding when the player requests to pull an RTM stream.
-         * - true: Enable
-         * - false: Disable
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          * @listtip
          * If you want to use the automatic transcoding feature when playing an RTM stream, contact your [technical support](https://www.byteplus.com/en/support).
          * @default false
@@ -11036,6 +11300,39 @@ declare namespace live {
          * @brief Specify the recent time length for network evaluation in milliseconds. The default is 1000, which means evaluating the network conditions over the last 1000 milliseconds.
          */
         networkEvaluateInterval?: number;
+        /** {zh}
+         * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+         *        - `true`：是，重新拉流期间不会出现黑屏现象。
+         *        - `false`：否，重新拉流期间会出现黑屏现象。
+         * @default false
+         * @listtip Safari 浏览器在进行 RTM 拉流时不支持使用此配置。
+         */
+        /** {en}
+         * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+         *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+         *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
+         *        :::tip
+         *        Safari browsers do not support using this configuration when performing RTM stream pulling.
+         *        :::
+         * @default false
+         */
+        seamlesslyReload?: boolean;
+        /** {zh}
+         * @brief 暂停播放后的断联时间，单位为秒，默认不断联。
+         * @listtip Safari 浏览器在进行 RTM 拉流时，如果出现断联，重新拉流时会出现短暂黑屏或加载情况。
+         */
+        /** {en}
+         * @brief The disconnection time after pausing playback is in seconds. By default, there is no disconnection.
+         * @listtip When Safari browser performs RTM streaming, if there is a disconnection, there will be a short black screen or loading situation when re-streaming.
+         */
+        disconnectTime?: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
+        enableOriginSdpLogger?: boolean;
     }
     /** {zh}
      * @list option
@@ -11075,15 +11372,17 @@ declare namespace live {
         loadTimeout?: number;
         /** {zh}
          * @brief 播放器发起 FLV 拉流请求时，是否开启低延时。例如，当您开启低延时且推流端 GOP 设置为 2s 的情况下，FLV 拉流平均端到端延时约为 2s。
-         * - true：开启
-         * - false：关闭
+         *        - `true`：开启；
+         *        - `false`：关闭
          * @default false
+         * @listtip 低延迟 FLV 拉流仅在 PC 端浏览器中生效。
          */
         /** {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.
-         * - true: Enable
-         * - false: Disable
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          * @default false
+         * @listtip Low-latency FLV pull-streaming is only effective in PC browsers.
          */
         enableLowLatency?: boolean;
         /** {zh}
@@ -11116,23 +11415,24 @@ declare namespace live {
          */
         maxReaderInterval?: number;
         /** {zh}
-         * @brief
-         *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+         * @brief 暂停播放后的断联时间，单位为秒，默认值为 0，表示暂停播放后立即断联。
          * @default 0
          */
         /** {en}
-         * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+         * @brief The disconnection time after pausing playback is in seconds. The default value is 0, indicating immediate disconnection after pausing playback.
          * @default 0
          */
         disconnectTime?: number;
         /** {zh}
-         * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
-         *        - `true`：是；
-         *        - `false`：否。
+         * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+         *        - `true`：是，重新拉流期间不会出现黑屏现象。
+         *        - `false`：否，重新拉流期间会出现黑屏现象。
          * @default false
          */
         /** {en}
-         * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+         * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+         *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+         *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
          * @default false
          */
         seamlesslyReload?: boolean;
@@ -11155,14 +11455,14 @@ declare namespace live {
         abrPts?: string | number;
         /** {zh}
          * @brief FLV 低延时模式下，是否开启倍速追帧。
-         *        - true：开启；
-         *        - false：关闭。
+         *        - `true`：开启；
+         *        - `false`：关闭。
          * @default true
          */
         /** {en}
          * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
-         *        - true: enabled;
-         *        - false: disabled.
+         *        - `true`: enabled;
+         *        - `false`: disabled.
          * @default true
          */
         enableFrameChasing?: boolean;
@@ -11229,6 +11529,10 @@ declare namespace live {
          * @hidden
          */
         mseLowLatency?: boolean;
+        /**
+         * @hidden
+         */
+        enableHlsJs?: boolean;
     }
     /** {zh}
      * @list option
@@ -11668,6 +11972,7 @@ declare namespace live {
          * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
          */
         get playTime(): number;
+        get ad(): any;
         /** {zh}
          * @brief 调用此方法开启直播日志上报。
          */
@@ -11815,4 +12120,4 @@ declare namespace live {
      */
     function createLivePlayer(options?: LiveVePlayerOptions): Promise<VePlayerLive>;
 }
-export { Codec, DecodeType, Degradation, DynamicModule, RTMCodec, ListType, Plugin, ExposedSource, VePlayerLive, util, register, registerPlugin, createLivePlayer, isMseSupported, isSoftDecodeSupported, isRTMSupported, isRTMSupportCodec, load, POSITIONS, EN, ZH_CN, Sniffer, live };
+export { Codec, DecodeType, Degradation, DynamicModule, RTMCodec, ListType, Plugin, ExposedSource, VePlayerLive, util, register, registerPlugin, createLivePlayer, isMseSupported, isSoftDecodeSupported, isRTMSupported, isFLVSupported, isRTMSupportCodec, isMMSSupported, load, POSITIONS, EN, ZH_CN, Sniffer, live };