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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volcengine/veplayer",
-  "version": "2.6.0-rc.4",
+  "version": "2.6.0-rc.5",
   "main": "./umd/veplayer.production.js",
   "module": "./esm/veplayer.production.js",
   "browser": "./umd/veplayer.production.js",

package/umd/index.d.ts

@@ -419,7 +419,14 @@ declare enum Level {
     /** {en}
      * @brief Error.
      */
-    Error = "Error"
+    Error = "Error",
+    /** {zh}
+     * @brief 提示。
+     */
+    /** {en}
+     * @brief Warn.
+     */
+    Warn = "Warn"
 }
 declare enum ErrorCode {
     /** {zh}
@@ -1399,13 +1406,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
@@ -1501,15 +1508,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}
@@ -2147,16 +2155,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 {
@@ -2184,6 +2193,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",
@@ -2196,6 +2206,7 @@ type ModulesMap = {
     [DynamicModule.PluginFlv]: Exports;
     [DynamicModule.PluginMp4]: Exports;
     [DynamicModule.PluginHls]: Exports;
+    [DynamicModule.PluginHlsJs]: Exports;
     [DynamicModule.PluginShaka]: Exports;
     [DynamicModule.PluginRtm]: Exports;
     [DynamicModule.PluginXgvideo]: Exports;
@@ -2679,7 +2690,14 @@ declare namespace strategy {
         /** {en}
          * @brief Error.
          */
-        Error = "Error"
+        Error = "Error",
+        /** {zh}
+         * @brief 提示。
+         */
+        /** {en}
+         * @brief Warn.
+         */
+        Warn = "Warn"
     }
     enum ErrorCode {
         /** {zh}
@@ -3722,13 +3740,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
@@ -3824,15 +3842,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}
@@ -3909,6 +3928,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]";
@@ -3940,6 +3960,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",
@@ -3952,6 +3973,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;
@@ -3992,22 +4014,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;
@@ -4178,7 +4194,14 @@ declare namespace error {
         /** {en}
          * @brief Error.
          */
-        Error = "Error"
+        Error = "Error",
+        /** {zh}
+         * @brief 提示。
+         */
+        /** {en}
+         * @brief Warn.
+         */
+        Warn = "Warn"
     }
     enum ErrorCode {
         /** {zh}
@@ -4624,6 +4647,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;
@@ -4652,6 +4689,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;