@volcengine/veplayer 2.7.0 → 2.7.1-rc.0

package/umd/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/umd/veplayer.development.js

@@ -14193,10 +14193,15 @@ var __publicField = (obj, key, value) => {
      * @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,
@@ -14448,7 +14453,7 @@ var __publicField = (obj, key, value) => {
      * @brief Retrieve the player SDK version number.
      */
     get playerVersion() {
-      return "2.7.0";
+      return "2.7.1-rc.0";
     }
     /** {zh}
      * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -22591,7 +22596,7 @@ var __publicField = (obj, key, value) => {
         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/umd/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/umd/veplayer.live.development.js

@@ -14193,10 +14193,15 @@ var __publicField = (obj, key, value) => {
      * @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,
@@ -14448,7 +14453,7 @@ var __publicField = (obj, key, value) => {
      * @brief Retrieve the player SDK version number.
      */
     get playerVersion() {
-      return "2.7.0";
+      return "2.7.1-rc.0";
     }
     /** {zh}
      * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -22591,7 +22596,7 @@ var __publicField = (obj, key, value) => {
         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"