@volcengine/veplayer 2.7.0 → 2.7.1-rc.0

package/esm/veplayer.d.ts

@@ -1214,7 +1214,38 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     /** {en}
      * @brief The URL of the player's cover image.
      */
-    poster?: string;
+    poster?: string | {
+        /** {zh}
+         * @brief 封面图 URL 地址。
+         * @default -
+         */
+        poster: string;
+        /** {zh}
+         * @brief 是否在播放结束之后显示封面图。
+         * @default true
+         */
+        isEndedShow?: boolean;
+        /** {zh}
+         * @brief 是否播放后再隐藏封面图。
+         *        - `true`：播放后隐藏，未启播时一直显示封面图。
+         *        - `false`：在 `play` 事件触发后隐藏封面图。
+         * @default false
+         */
+        hideCanplay?: boolean;
+        /** {zh}
+         * @brief 是否一直显示封面图。
+         * @default false
+         */
+        notHidden?: boolean;
+        /** {zh}
+         * @brief 封面图填充方式。取值如下：
+         *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+         *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+         *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+         *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+         */
+        fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+    };
     /** {zh}
      * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
      */
@@ -3560,7 +3591,38 @@ declare namespace strategy {
         /** {en}
          * @brief The URL of the player's cover image.
          */
-        poster?: string;
+        poster?: string | {
+            /** {zh}
+             * @brief 封面图 URL 地址。
+             * @default -
+             */
+            poster: string;
+            /** {zh}
+             * @brief 是否在播放结束之后显示封面图。
+             * @default true
+             */
+            isEndedShow?: boolean;
+            /** {zh}
+             * @brief 是否播放后再隐藏封面图。
+             *        - `true`：播放后隐藏，未启播时一直显示封面图。
+             *        - `false`：在 `play` 事件触发后隐藏封面图。
+             * @default false
+             */
+            hideCanplay?: boolean;
+            /** {zh}
+             * @brief 是否一直显示封面图。
+             * @default false
+             */
+            notHidden?: boolean;
+            /** {zh}
+             * @brief 封面图填充方式。取值如下：
+             *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+             *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+             *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+             *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+             */
+            fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+        };
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
          */
@@ -8983,7 +9045,38 @@ declare namespace live {
         /** {en}
          * @brief The URL of the player's cover image.
          */
-        poster?: string;
+        poster?: string | {
+            /** {zh}
+             * @brief 封面图 URL 地址。
+             * @default -
+             */
+            poster: string;
+            /** {zh}
+             * @brief 是否在播放结束之后显示封面图。
+             * @default true
+             */
+            isEndedShow?: boolean;
+            /** {zh}
+             * @brief 是否播放后再隐藏封面图。
+             *        - `true`：播放后隐藏，未启播时一直显示封面图。
+             *        - `false`：在 `play` 事件触发后隐藏封面图。
+             * @default false
+             */
+            hideCanplay?: boolean;
+            /** {zh}
+             * @brief 是否一直显示封面图。
+             * @default false
+             */
+            notHidden?: boolean;
+            /** {zh}
+             * @brief 封面图填充方式。取值如下：
+             *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+             *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+             *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+             *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+             */
+            fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+        };
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
          */

package/esm/veplayer.development.js

@@ -14189,10 +14189,15 @@ const transformOption = (
    * @param options 更多配置信息。
    */
   (options) => {
+    var _a, _b;
     const { autoplay: autoplay2, ...rest } = options;
     const xgOptions = rest;
     if (xgOptions.poster) {
-      xgOptions.poster = escapeHtml(xgOptions.poster);
+      if (typeof xgOptions.poster === "string") {
+        xgOptions.poster = escapeHtml(xgOptions.poster);
+      } else if (typeof ((_a = xgOptions.poster) == null ? void 0 : _a.poster) === "string") {
+        xgOptions.poster.poster = escapeHtml((_b = xgOptions.poster) == null ? void 0 : _b.poster);
+      }
     }
     xgOptions.icons = {
       ...DEFAULT_ICONS,
@@ -14444,7 +14449,7 @@ class VePlayerBase {
    * @brief Retrieve the player SDK version number.
    */
   get playerVersion() {
-    return "2.7.0";
+    return "2.7.1-rc.0";
   }
   /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -22587,7 +22592,7 @@ class Logger extends Plugin {
       device_id: this._deviceId,
       error_report_stop: true,
       ext: {
-        veplayer_version: "2.7.0",
+        veplayer_version: "2.7.1-rc.0",
         flv_version: "3.0.21-rc.21",
         hls_version: "3.0.21-rc.21",
         rts_version: "0.2.1-alpha.14"

package/esm/veplayer.live.d.ts

@@ -1214,7 +1214,38 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
     /** {en}
      * @brief The URL of the player's cover image.
      */
-    poster?: string;
+    poster?: string | {
+        /** {zh}
+         * @brief 封面图 URL 地址。
+         * @default -
+         */
+        poster: string;
+        /** {zh}
+         * @brief 是否在播放结束之后显示封面图。
+         * @default true
+         */
+        isEndedShow?: boolean;
+        /** {zh}
+         * @brief 是否播放后再隐藏封面图。
+         *        - `true`：播放后隐藏，未启播时一直显示封面图。
+         *        - `false`：在 `play` 事件触发后隐藏封面图。
+         * @default false
+         */
+        hideCanplay?: boolean;
+        /** {zh}
+         * @brief 是否一直显示封面图。
+         * @default false
+         */
+        notHidden?: boolean;
+        /** {zh}
+         * @brief 封面图填充方式。取值如下：
+         *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+         *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+         *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+         *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+         */
+        fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+    };
     /** {zh}
      * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
      */
@@ -3560,7 +3591,38 @@ declare namespace strategy {
         /** {en}
          * @brief The URL of the player's cover image.
          */
-        poster?: string;
+        poster?: string | {
+            /** {zh}
+             * @brief 封面图 URL 地址。
+             * @default -
+             */
+            poster: string;
+            /** {zh}
+             * @brief 是否在播放结束之后显示封面图。
+             * @default true
+             */
+            isEndedShow?: boolean;
+            /** {zh}
+             * @brief 是否播放后再隐藏封面图。
+             *        - `true`：播放后隐藏，未启播时一直显示封面图。
+             *        - `false`：在 `play` 事件触发后隐藏封面图。
+             * @default false
+             */
+            hideCanplay?: boolean;
+            /** {zh}
+             * @brief 是否一直显示封面图。
+             * @default false
+             */
+            notHidden?: boolean;
+            /** {zh}
+             * @brief 封面图填充方式。取值如下：
+             *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+             *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+             *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+             *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+             */
+            fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+        };
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
          */
@@ -8983,7 +9045,38 @@ declare namespace live {
         /** {en}
          * @brief The URL of the player's cover image.
          */
-        poster?: string;
+        poster?: string | {
+            /** {zh}
+             * @brief 封面图 URL 地址。
+             * @default -
+             */
+            poster: string;
+            /** {zh}
+             * @brief 是否在播放结束之后显示封面图。
+             * @default true
+             */
+            isEndedShow?: boolean;
+            /** {zh}
+             * @brief 是否播放后再隐藏封面图。
+             *        - `true`：播放后隐藏，未启播时一直显示封面图。
+             *        - `false`：在 `play` 事件触发后隐藏封面图。
+             * @default false
+             */
+            hideCanplay?: boolean;
+            /** {zh}
+             * @brief 是否一直显示封面图。
+             * @default false
+             */
+            notHidden?: boolean;
+            /** {zh}
+             * @brief 封面图填充方式。取值如下：
+             *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+             *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+             *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+             *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
+             */
+            fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
+        };
         /** {zh}
          * @brief 为播放器设置初始显示语言，语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
          */

package/esm/veplayer.live.development.js

@@ -14189,10 +14189,15 @@ const transformOption = (
    * @param options 更多配置信息。
    */
   (options) => {
+    var _a, _b;
     const { autoplay: autoplay2, ...rest } = options;
     const xgOptions = rest;
     if (xgOptions.poster) {
-      xgOptions.poster = escapeHtml(xgOptions.poster);
+      if (typeof xgOptions.poster === "string") {
+        xgOptions.poster = escapeHtml(xgOptions.poster);
+      } else if (typeof ((_a = xgOptions.poster) == null ? void 0 : _a.poster) === "string") {
+        xgOptions.poster.poster = escapeHtml((_b = xgOptions.poster) == null ? void 0 : _b.poster);
+      }
     }
     xgOptions.icons = {
       ...DEFAULT_ICONS,
@@ -14444,7 +14449,7 @@ class VePlayerBase {
    * @brief Retrieve the player SDK version number.
    */
   get playerVersion() {
-    return "2.7.0";
+    return "2.7.1-rc.0";
   }
   /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -22587,7 +22592,7 @@ class Logger extends Plugin {
       device_id: this._deviceId,
       error_report_stop: true,
       ext: {
-        veplayer_version: "2.7.0",
+        veplayer_version: "2.7.1-rc.0",
         flv_version: "3.0.21-rc.21",
         hls_version: "3.0.21-rc.21",
         rts_version: "0.2.1-alpha.14"