@volcengine/veplayer 2.7.0 → 2.7.1-rc.1

package/esm/index.d.ts

@@ -1083,7 +1083,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'`
      */
@@ -3387,7 +3418,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'`
          */