@volcengine/veplayer 1.10.0-rc.12 → 1.10.0-rc.14

package/index.d.ts

@@ -2872,12 +2872,12 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	fitVideoSize?: "fixWidth" | "fixHeight" | "fixed";
 	/** {zh}
-	 * @brief 视频画面填充模式。取值如下：
-	 *        - `fillWidth`: 填充宽度，高度溢出则裁剪高度。
-	 *        - `fillHeight`: 填充高度，宽度溢出则裁剪宽度。
-	 *        - `fill`: 拉伸视频以填充容器。
-	 *        - `cover`: 保持视频宽高比的同时填充元素的整个内容框。
-	 *        - `auto`: 使用浏览器默认的视频画面填充模式。
+	 * @brief 视频画面填充模式，等同于设置{@link https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit CSS object-fit}属性。取值如下：
+	 *        - `auto`: 使用浏览器默认的视频画面填充模式，注意设置此值时，在视频的宽高与播放器容器的宽高不匹配时会出现黑边。
+	 *        - `fill`: 拉伸视频以填充播放器容器，等同于设置 CSS `object-fit: fill`，注意设置此值时，视频画面会被被拉伸变形。
+	 *        - `cover`: 保持视频宽高比的同时填充整个播放器容器，等同于设置 CSS `object-fit: cover`，注意设置此值时，视频画面会被被部分裁剪。
+	 *        - `fillWidth`: 填充宽度，高度溢出则裁剪高度，当播放器容器宽高比小于视频的宽高比，等同于设置CSS `object-fit: cover`。
+	 *        - `fillHeight`: 填充高度，宽度溢出则裁剪宽度，当播放器容器宽高比大于视频的宽高比，等同于设置CSS `object-fit: cover`。
 	 * @default auto
 	 */
 	videoFillMode?: "auto" | "fillHeight" | "fillWidth" | "fill" | "cover";
@@ -5891,17 +5891,17 @@ export declare const Events: {
 	 */
 	URL_CHANGE: string;
 	/** {zh}
-	 * @brief 播放器聚焦。
+	 * @brief 播放器聚焦，同时会展示 Control 栏控件，包含播放按钮、进度条等。
 	 */
 	/** {en}
-	 * @brief The player has focus.
+	 * @brief The player is active and the control bar will appear showing options like play button, progress bar, and other controls.
 	 */
 	PLAYER_FOCUS: string;
 	/** {zh}
-	 * @brief 播放器失焦。
+	 * @brief 播放器失焦，同时会隐藏 Control 栏控件，包含播放按钮、进度条等。
 	 */
 	/** {en}
-	 * @brief The player loses focus.
+	 * @brief The player is inactive and the control bar will vanish, hiding options such as the play button, progress bar, and other controls.
 	 */
 	PLAYER_BLUR: string;
 	/** {zh}
@@ -5991,7 +5991,7 @@ export declare const Events: {
 	SHORTCUT: string;
 	/** {zh}
 	 * @deprecated
-	 * @brief SEI 信息解析。
+	 * @brief （已废弃）SEI 信息解析。
 	 */
 	/** {en}
 	 * @deprecated
@@ -6210,17 +6210,17 @@ export declare const Event: {
 		 */
 		URL_CHANGE: string;
 		/** {zh}
-		 * @brief 播放器聚焦。
+		 * @brief 播放器聚焦，同时会展示 Control 栏控件，包含播放按钮、进度条等。
 		 */
 		/** {en}
-		 * @brief The player has focus.
+		 * @brief The player is active and the control bar will appear showing options like play button, progress bar, and other controls.
 		 */
 		PLAYER_FOCUS: string;
 		/** {zh}
-		 * @brief 播放器失焦。
+		 * @brief 播放器失焦，同时会隐藏 Control 栏控件，包含播放按钮、进度条等。
 		 */
 		/** {en}
-		 * @brief The player loses focus.
+		 * @brief The player is inactive and the control bar will vanish, hiding options such as the play button, progress bar, and other controls.
 		 */
 		PLAYER_BLUR: string;
 		/** {zh}
@@ -6310,7 +6310,7 @@ export declare const Event: {
 		SHORTCUT: string;
 		/** {zh}
 		 * @deprecated
-		 * @brief SEI 信息解析。
+		 * @brief （已废弃）SEI 信息解析。
 		 */
 		/** {en}
 		 * @deprecated