@volcengine/veplayer 1.8.6-rc.1 → 1.8.6-rc.11

package/index.d.ts

@@ -48,23 +48,26 @@ export declare const enum POSITIONS {
 	CONTROLS = "controls"
 }
 /**
- * @brief 发错错误时的UI表现配置
+ * @brief 播放器发生错误时的 UI 配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 发错错误时的UI表现配置
+ */
 export interface ISdkErrorConfig {
 	/** {zh}
-	 * @brief 报错时是否显示提示图片
+	 * @brief 报错时是否展示提示图片。
 	 * @default true
 	 */
 	errorImg?: boolean;
 	/** {zh}
-	 * @brief 报错时是否展示
+	 * @brief 报错时是否展示报错文案。
 	 * @default true
 	 */
 	errorTips?: boolean;
 	/** {zh}
-	 * @brief 报错时是否展示“刷新”按钮
+	 * @brief 报错时是否展示刷新按钮。
 	 * @default ture
 	 */
 	isNeedRefreshButton?: boolean;
@@ -75,12 +78,12 @@ export interface ISdkErrorConfig {
 	 */
 	isNeedDemoteBack?: boolean;
 	/** {zh}
-	 * @brief 报错后重试次数
+	 * @brief 报错后重试次数。
 	 * @default 1
 	 */
 	retryLoopNum?: number;
 	/** {zh}
-	 * @brief 报错后提示文案
+	 * @brief 不同语言对应的报错提示文案。
 	 * @default 播放发生错误，点击刷新试试吧
 	 */
 	/** {en}
@@ -96,24 +99,36 @@ export interface ISdkErrorConfig {
 }
 /**
  * @list Options
- * @brief 错误文案配置
+ * @brief 报错文案配置。
  * @kind property
  */
+/** {en}
+ * @brief 错误文案配置
+ */
 export interface TipsTextConfig {
 	/**
-	 * @brief 中文错误文案
+	 * @brief 中文错误文案。
 	 * @default 播放发生错误，点击刷新试试吧
 	 */
+	/** {en}
+	 * @brief 中文错误文案
+	 */
 	zh?: HTMLElement | string;
 	/**
-	 * @brief 英文错误文案
+	 * @brief 英文错误文案。
 	 * @default An error occurred while playing, click refresh to try
 	 */
+	/** {en}
+	 * @brief 英文错误文案
+	 */
 	en?: HTMLElement | string;
 	/**
-	 * @brief 日文错误文案
+	 * @brief 日文错误文案。
 	 * @default 再生中にエラーが発生しました。[更新]をクリックして試してください
 	 */
+	/** {en}
+	 * @brief 日文错误文案
+	 */
 	jp?: HTMLElement | string;
 	/**
 	 * @brief 香港繁体中文错误文案。
@@ -178,45 +193,97 @@ export interface IRtmConfig {
 	backupStreamType: "hls" | "flv";
 }
 /**
- * @brief 弹幕相关设置
+ * @brief 弹幕配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 弹幕相关设置
+ */
 export interface IDanmuConfig {
 	/**
-	 * @brief 透明度, 枚举值[0, 33, 66, 99], 实际对应0, 0.33, 0.66, 1
+	 * @brief 弹幕透明度。取值如下：
+	 *
+	 *        - `0`：透明度 0。
+	 *        - `33`：透明度 33%。
+	 *        - `66`：透明度 66%。
+	 *        - `99`：透明度 100%。
 	 * @default 99
 	 */
+	/** {en}
+	 * @brief 透明度, 枚举值[0, 33, 66, 99], 实际对应0, 0.33, 0.66, 1
+	 */
 	opacity?: number;
 	/**
-	 * @brief 枚举值[0, 33, 66, 99] 实际对应1/4, 1/2, 3/4, 1
+	 * @brief 弹幕区域大小。取值如下：
+	 *
+	 *        - `0`：弹幕区域占全屏的 1/4。
+	 *        - `33`：弹幕区域占全屏的 1/2。
+	 *        - `66`：弹幕区域占全屏的 3/4。
+	 *        - `99`：弹幕区域占满全屏。
 	 * @default 99
 	 */
+	/** {en}
+	 * @brief 枚举值[0, 33, 66, 99] 实际对应1/4, 1/2, 3/4, 1
+	 */
 	area?: number;
 	/**
-	 * @brief 速度, 枚举值[0, 20, 40, 60, 80, 100]， 实际对应1/4, 1/2,1,5/4,3/2,2
+	 * @brief 弹幕滚动速度。取值如下：
+	 *
+	 *        - `0`：弹幕速度为 1/4。
+	 *        - `20`：弹幕速度为 1/2。
+	 *        - `40`：弹幕速度为 1。
+	 *        - `60`：弹幕速度为 5/4。
+	 *        - `80`：弹幕速度为 3/2。
+	 *        - `100`：弹幕速度为 2。
 	 * @default 40
 	 */
+	/** {en}
+	 * @brief 速度, 枚举值[0, 20, 40, 60, 80, 100]， 实际对应1/4, 1/2,1,5/4,3/2,2
+	 */
 	speed?: number;
 	/**
-	 * @brief 字体大小， 枚举值[0, 50, 100]，实际对应14px 16px 20px
+	 * @brief 弹幕字体大小。取值如下：
+	 *
+	 *        - `0`：字体大小为 14 px。
+	 *        - `50`：字体大小为 16 px。
+	 *        - `100`：字体大小为 20 px。
 	 * @default 50
 	 */
+	/** {en}
+	 * @brief 字体大小， 枚举值[0, 50, 100]，实际对应14px 16px 20px
+	 */
 	fontSize?: number;
 	/**
-	 * @brief 是否打开面板
+	 * @brief 是否打开面板。取值如下：
+	 *
+	 *        - `false`：关闭面板。
+	 *        - `true`：打开面板。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief 是否打开面板
+	 */
 	active?: boolean;
 	/**
-	 * @brief 是否展示弹幕设置面板
+	 * @brief 是否展示弹幕设置面板。取值如下：
+	 *
+	 *        - `false`：不展示弹幕设置面板。
+	 *        - `true`：展示弹幕设置面板。
 	 * @default true
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief 是否展示弹幕设置面板
 	 */
 	usePanel?: boolean;
 	/**
-	 * @brief 弹幕列表
+	 * @brief 弹幕列表。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 弹幕列表
+	 */
 	danmuItems?: DanmuItem[];
 	/**
 	 * @hidden
@@ -248,18 +315,25 @@ export interface Lang {
 	[props: string]: string;
 }
 /**
- * @brief 弹幕项配置
+ * @brief 弹幕项
  * @list Options
  * @kind property
  * @export
  * @interface DanmuItem
  */
+/** {en}
+ * @brief 弹幕项配置
+ */
 export interface DanmuItem {
 	/**
 	 * 弹幕唯一id
 	 *
 	 * @type {string}
 	 * @memberof DanmuItem
+	 * @brief 弹幕唯一 ID。
+	 */
+	/** {en}
+	 * @brief 弹幕唯一id
 	 */
 	id: string;
 	/**
@@ -267,11 +341,19 @@ export interface DanmuItem {
 	 *
 	 * @type {string}
 	 * @memberof DanmuItem
+	 * @brief 弹幕文案。
+	 */
+	/** {en}
+	 * @brief 弹幕文案
 	 */
 	txt: string;
 	/**
 	 * 弹幕出现时间, 单位为ms
 	 * @default 0
+	 * @brief 弹幕出现时间，单位为毫秒。
+	 */
+	/** {en}
+	 * @brief 弹幕出现时间, 单位为ms
 	 */
 	start?: number;
 	/**
@@ -287,10 +369,14 @@ export interface DanmuItem {
 	 *
 	 * @type {number}
 	 * @memberof DanmuItem
+	 * @brief 弹幕持续显示时长，单位为毫秒。
+	 */
+	/** {en}
+	 * @brief 弹幕持续显示时间, 单位为ms
 	 */
 	duration?: number;
 	/**
-	 * @brief 弹幕样式
+	 * @brief 弹幕样式。示例如下：`style : { color: '#ff9500', fontSize: '20px', padding: '2px 11px'}`
 	 * @example
 	 * ``` javascript
 	 * {
@@ -302,6 +388,9 @@ export interface DanmuItem {
 	 * @type {Partial<Record<Property, string>>}
 	 * @memberof DanmuItem
 	 */
+	/** {en}
+	 * @brief 弹幕样式
+	 */
 	style?: CSSStyleDeclaration;
 }
 export interface ExternalItem {
@@ -311,10 +400,13 @@ export interface ExternalItem {
 	lang?: Lang;
 }
 /**
- * @brief 外挂字幕配置
+ * @brief 外挂字幕配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 外挂字幕配置
+ */
 export interface ISubtitleConfig {
 	/**
 	 *
@@ -322,57 +414,88 @@ export interface ISubtitleConfig {
 	 */
 	[propName: string]: any;
 	/**
-	 * @brief 图标位置
+	 * @brief 图标位置。
 	 * @default controlsRight
 	 */
+	/** {en}
+	 * @brief 图标位置
+	 */
 	position?: string;
 	/**
-	 * @brief 图标排列权重
+	 * @brief 图标排列权重。
 	 * @default 6
 	 */
+	/** {en}
+	 * @brief 图标排列权重
+	 */
 	index?: number;
 	/**
-	 * @brief 字幕列表
+	 * @brief 字幕列表。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 字幕列表
+	 */
 	list?: Array<ISubTitleItem>;
 	/**
-	 * @brief 是否默认打开
+	 * @brief 是否默认打开字幕。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief 是否默认打开
+	 */
 	isDefaultOpen?: boolean;
 	/**
-	 * @brief 是否显示图标
+	 * @brief 是否显示图标。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief 是否显示图标
+	 */
 	isShowIcon?: boolean;
 	/**
-	 * @brief 字幕渲染模式，外挂字幕或原生字幕
+	 * @brief 字幕渲染模式，取值如下：
+	 *        - `"external"`：外挂字幕
+	 *        - `"native"`：原生字幕
 	 * @default external
 	 */
+	/** {en}
+	 * @brief 字幕渲染模式，外挂字幕或原生字幕
+	 */
 	mode?: "external" | "native";
 	/**
 	 * @brief 字幕更新模式，默认vod
 	 * @default vod
+	 * @hidden
 	 */
 	updateMode?: "vod" | "live";
 	/**
-	 * @brief 字幕样式
+	 * @brief 字幕样式。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 字幕样式
+	 */
 	style?: ISubtitleStyle;
 }
 /**
  * @list Options
- * @brief 字幕样式配置
+ * @brief 字幕样式配置。
  * @kind property
  */
+/** {en}
+ * @brief 字幕样式配置
+ */
 export interface ISubtitleStyle {
 	/**
 	 * 是否跟随控制栏调整位置
 	 * @default true
 	 * @type {boolean | null}
 	 * @memberof ISubtitleStyle
+	 * @brief 是否跟随控制栏调整位置。
+	 */
+	/** {en}
+	 * @brief 是否跟随控制栏调整位置
 	 */
 	follow: boolean | null;
 	/**
@@ -380,6 +503,12 @@ export interface ISubtitleStyle {
 	 * @default 'stroke'
 	 * @type {'stroke' | 'bg'}
 	 * @memberof ISubtitleStyle
+	 * @brief 字体显示模式，默认如下；
+	 *        - `"stroke"`：空心字体。
+	 *        - `"bg"`：实心字体。
+	 */
+	/** {en}
+	 * @brief 字体显示模式，默认是描边
 	 */
 	mode?: "stroke" | "bg";
 	/**
@@ -387,6 +516,10 @@ export interface ISubtitleStyle {
 	 * @default 50
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief 是否跟随底部控制栏的高度。
+	 */
+	/** {en}
+	 * @brief 跟随底部控制栏的高度
 	 */
 	followBottom?: number;
 	/**
@@ -394,6 +527,10 @@ export interface ISubtitleStyle {
 	 * @default true
 	 * @type {boolean}
 	 * @memberof ISubtitleStyle
+	 * @brief 是否跟随视频自动调整字号。
+	 */
+	/** {en}
+	 * @brief 是否跟随视频自动调整字号
 	 */
 	fitVideo?: boolean;
 	/**
@@ -401,6 +538,10 @@ export interface ISubtitleStyle {
 	 * @default 4
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief 字幕距离画面底部百分比。
+	 */
+	/** {en}
+	 * @brief 字幕距离画面底部百分比
 	 */
 	offsetBottom?: number;
 	/**
@@ -408,6 +549,10 @@ export interface ISubtitleStyle {
 	 * @default 49
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief 横屏视频适配基准字号。
+	 */
+	/** {en}
+	 * @brief 横屏视频适配基准字号
 	 */
 	baseSizeX?: number;
 	/**
@@ -415,6 +560,10 @@ export interface ISubtitleStyle {
 	 * @default 28
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief 竖屏视频适配基准字号。
+	 */
+	/** {en}
+	 * @brief 竖屏视频适配基准字号
 	 */
 	baseSizeY?: number;
 	/**
@@ -422,6 +571,10 @@ export interface ISubtitleStyle {
 	 * @default 16
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief PC 端最小字号.
+	 */
+	/** {en}
+	 * @brief pc端最小字号
 	 */
 	minSize?: number;
 	/**
@@ -429,6 +582,10 @@ export interface ISubtitleStyle {
 	 * @default 13
 	 * @type {number}
 	 * @memberof ISubtitleStyle
+	 * @brief 移动端最小字号。
+	 */
+	/** {en}
+	 * @brief 移动端最小字号
 	 */
 	minMobileSize?: number;
 	/**
@@ -436,6 +593,13 @@ export interface ISubtitleStyle {
 	 * @default double
 	 * @type {'double' | 'single' | 'three'}
 	 * @memberof ISubtitleStyle
+	 * @brief 最大显示行数。取值如下：
+	 *        - `"double"`：两行
+	 *        - `"single"`：一行
+	 *        - `"three"`：三行
+	 */
+	/** {en}
+	 * @brief 最大显示行数
 	 */
 	line?: "double" | "single" | "three";
 	/**
@@ -443,39 +607,61 @@ export interface ISubtitleStyle {
 	 * @default #fff
 	 * @type {string}
 	 * @memberof ISubtitleStyle
+	 * @brief 字体颜色。可设为 16 位颜色值或 RGB 值。
+	 */
+	/** {en}
+	 * @brief 字体颜色, 16位颜色值或rgb值
 	 */
 	fontColor?: string;
 }
 /**
  * @list Options
- * @brief 字幕项配置
+ * @brief 字幕项。
  * @kind property
  */
+/** {en}
+ * @brief 字幕项配置
+ */
 export interface ISubTitleItem {
 	/**
-	 * @brief 字幕语言
+	 * @brief 字幕语言。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 字幕语言
+	 */
 	language?: string | number;
 	/**
-	 * @brief 字幕id
+	 * @brief 字幕 ID。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 字幕id
+	 */
 	id?: number | string;
 	/**
-	 * @brief 是否是默认选择的字幕
+	 * @brief 是否为默认选择的字幕。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief 是否是默认选择的字幕
+	 */
 	isDefault?: boolean;
 	/**
-	 * @brief 字幕名称
+	 * @brief 字幕名称。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 字幕名称
+	 */
 	text?: string;
 	/**
-	 * @brief 外挂字幕地址
+	 * @brief 外挂字幕 URL 地址。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 外挂字幕地址
+	 */
 	url?: string;
 	/**
 	 * stringContent
@@ -490,30 +676,49 @@ export interface ISubTitleItem {
 	 * @default 无
 	 * @type {Array<Object>}
 	 * @memberof ISubTitleItem
+	 * @brief 字幕内容列表。非 `url` 形式时使用。
+	 */
+	/** {en}
+	 * @brief 字幕内容列表，非url形式时使用
 	 */
 	list?: IListItem[];
 }
 /**
- * @brief 字幕内容项配置
+ * @brief 字幕内容项。
  * @list Options
  * @kind property
  * @export
  * @interface IListItem
  */
+/** {en}
+ * @brief 字幕内容项配置
+ */
 export interface IListItem {
 	/**
 	 * 开始时间
 	 * @type {number}
+	 * @brief 开始时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 开始时间
 	 */
 	start: number;
 	/**
 	 * 结束时间
 	 * @type {number}
+	 * @brief 结束时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 结束时间
 	 */
 	end: number;
 	/**
 	 * 字幕数据列表
 	 * @type {Array<ITextItem>}
+	 * @brief 字幕数据列表。
+	 */
+	/** {en}
+	 * @brief 字幕数据列表
 	 */
 	list: Array<ITextItem>;
 	/**
@@ -538,21 +743,37 @@ export interface ITextItem {
 	/**
 	 * 开始时间
 	 * @type {number}
+	 * @brief 开始时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 开始时间
 	 */
 	start: number;
 	/**
 	 * 结束时间
 	 * @type {number}
+	 * @brief 结束时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 结束时间
 	 */
 	end: number;
 	/**
 	 * 字幕文案数组
 	 * @type {string[]}
+	 * @brief 字幕文案数组。
+	 */
+	/** {en}
+	 * @brief 字幕文案数组
 	 */
 	text: string[];
 	/**
 	 * 字幕顺序
 	 * @type {number}
+	 * @brief 字幕顺序。
+	 */
+	/** {en}
+	 * @brief 字幕顺序
 	 */
 	index?: number;
 }
@@ -608,16 +829,22 @@ export interface IDefinitionDemotePlugin {
 	demotePriority?: string[];
 }
 /**
- * @brief DASH 播放配置项
+ * @brief DASH 播放配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief DASH 播放配置项
+ */
 export interface IDashPluginConfig {
 	/**
-	 * @brief 视频vid
+	 * @brief 视频 ID。
 	 * @default -
 	 * @notice 播放加密视频时必选
 	 */
+	/** {en}
+	 * @brief 视频vid
+	 */
 	vid?: string;
 	/**
 	 * @hidden
@@ -626,7 +853,7 @@ export interface IDashPluginConfig {
 	 */
 	playInfoType: "TOP";
 	/**
-	 * @brief 清晰度映射文案
+	 * @brief 清晰度映射文案。
 	 * @default -
 	 * @example
 	 * ``` javascript
@@ -638,11 +865,17 @@ export interface IDashPluginConfig {
 	 * }
 	 * ```
 	 */
+	/** {en}
+	 * @brief 清晰度映射文案
+	 */
 	definitionText: Record<string, string>;
 	/**
-	 * @brief 默认清晰度
+	 * @brief 默认清晰度。
 	 * @default 列表第一个
 	 */
+	/** {en}
+	 * @brief 默认清晰度
+	 */
 	defaultDefinition?: string;
 	/**
 	 * @hidden
@@ -671,6 +904,10 @@ export interface IDashPluginConfig {
 	/**
 	 * 预加载时间，单位ms
 	 * @default 50
+	 * @brief 预加载时间，单位为毫秒。
+	 */
+	/** {en}
+	 * @brief 预加载时间，单位ms
 	 */
 	preloadTime?: number;
 	/**
@@ -717,10 +954,13 @@ export interface mp4OptsItem {
 	url: string;
 }
 /**
- * @brief HLS加密播放配置
+ * @brief HLS 加密播放配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief HLS加密播放配置
+ */
 export interface IEncryptHlsPluginConfig {
 	/** {zh}
 	 * @brief 获取播放地址的请求域名。
@@ -755,10 +995,13 @@ export interface IEncryptHlsPluginConfig {
 	keyToken: string;
 }
 /**
- * @brief 质量日志配置
+ * @brief 质量日志上报配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 质量日志配置
+ */
 export interface IVodLogOptsConfig {
 	/**
 	 * @brief 视频点播应用 ID。您可在视频{@link https://console.volcengine.com/vod/region:vod+cn-north-1/sdk/app/ 点播控制台 > 点播SDK > 应用管理}页面获取应用 ID（App ID）。
@@ -788,6 +1031,9 @@ export interface IVodLogOptsConfig {
 	 * @brief 自定义子标签。对应于质量平台上的自定义标签维度，与 `tag` 配合使用，可用于区分同一业务类型下更为细分的音视频类型，比如加密视频、非加密视频、音频等。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 自定义子标签。对应于质量平台上的自定义标签维度，与 `tag` 配合使用，可用于区分同一业务类型下更为细分的音视频类型，比如加密视频、非加密视频、音频等。
+	 */
 	subtag?: string;
 	/**
 	 * @brief 视频编码类型，取值如下
@@ -1058,34 +1304,52 @@ export declare type IPlayerOptions = {
 	};
 };
 /**
- * @brief 自动播放配置
+ * @brief 自动播放配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 自动播放配置
+ */
 export interface IAutoplayPluginConfig {
 	/**
 	 * @hidden
 	 */
 	position?: string;
 	/**
-	 * @brief 有声音自动播放失败时是否降级成静音自动播放
+	 * @brief 是否开启降级静音自动播放。开启后，如果当前浏览器环境不支持有声音自动播放，则降级为静音自动播放。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief 有声音自动播放失败时是否降级成静音自动播放
+	 */
 	enableDegradeMuteAutoplay?: boolean;
 	/**
 	 * @brief 启用微信jsBridge方式的自动播放
 	 * @default false
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
 	 */
 	enableWxJsBridgeAutoplay?: boolean;
 	/**
-	 * @brief 用户触发自动播放的目标dom
+	 * @brief 用户触发自动播放的目标 dom。
 	 * @default window.document.body
 	 */
+	/** {en}
+	 * @brief 用户触发自动播放的目标dom
+	 */
 	userActionDom?: Node;
 	/**
-	 * @brief 开启任意点击/触摸的用户行为触发自动播放
+	 * @brief 是否开启任意用户行为触发自动播放。开启后，第一次用户的任意点击可以触发播放器的自动播放。取值如下：
+	 *        - `true`：开启
+	 *        - `false`：不开启
 	 * @default false
 	 */
+	/** {en}
+	 * @brief 开启任意点击/触摸的用户行为触发自动播放
+	 */
 	enableUserActionAutoplay?: boolean;
 }
 declare class PlayList {
@@ -1108,15 +1372,23 @@ declare class PlayList {
 	destroy(): void;
 }
 /**
+ * @brief 播放列表展示面板触发动作类型。
+ */
+/** {en}
  * @brief 播放列表展示面板触发动作类型
- *
  */
 export declare const enum TOGGLE_MODES {
 	/**
+	 * @brief 鼠标点击。
+	 */
+	/** {en}
 	 * @brief 鼠标点击
 	 */
 	CLICK = "click",
 	/**
+	 * @brief 鼠标悬浮。
+	 */
+	/** {en}
 	 * @brief 鼠标悬浮
 	 */
 	HOVER = "hover"
@@ -1129,96 +1401,155 @@ export declare const enum TOGGLE_MODES {
  */
 export interface IPlayListItem {
 	/**
-	 * @brief 视频地址
 	 * @notice `playAuthToken` 为空时，此参数必传。
 	 * @default -
+	 * @listtip `playAuthToken` 为空时，此参数必传。
+	 * @brief 视频地址。
+	 */
+	/** {en}
 	 */
 	url?: string;
 	/**
-	 * @brief 播放临时安全凭证，由业务的 AppServer 签发。
 	 * @notice `url` 为空时，此参数必传。
 	 * @default -
+	 * @listtip `url` 为空时，此参数必传。
+	 * @brief 播放临时安全凭证，由业务的 AppServer 签发。
+	 */
+	/** {en}
 	 */
 	playAuthToken?: string;
 	/**
-	 * @brief 视频的唯一 ID。不传则取视频所在列表数组的序号。
 	 * @default -
+	 * @brief 视频的唯一 ID。不传则取视频所在列表数组的序号。
+	 */
+	/** {en}
 	 */
 	vid: string;
 	/**
-	 * @brief 封面图地址。
 	 * @default -
+	 * @brief 视频封面图地址。
+	 */
+	/** {en}
 	 */
 	poster?: string;
 	/**
-	 * @brief 视频标题。
 	 * @default -
+	 * @brief 视频标题。
+	 */
+	/** {en}
 	 */
 	title?: string;
 	/**
-	 * @brief 视频时长，单位s
+	 * @brief 视频时长，单位为秒。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 视频时长，单位s
+	 */
 	duration?: number;
 }
 declare enum EPlayMode {
 	/**
+	 * @brief 顺序播放。
+	 */
+	/** {en}
 	 * @brief 顺序播放
 	 */
 	ORDER = "order",
 	/**
+	 * @brief 列表循环。
+	 */
+	/** {en}
 	 * @brief 列表循环
 	 */
 	LOOP = "loop"
 }
 /**
  * @list Options
- * @brief 播放列表插件配置项
+ * @brief 播放列表插件配置。
  * @kind property
  */
+/** {en}
+ * @brief 播放列表插件配置项
+ */
 export interface IPlayListConfig {
 	/**
-	 * @brief 图标位置
+	 * @brief 按钮位置。取值如下：
+	 *
+	 *        - `controlsLeft`: 播控栏左侧
+	 *        - `controlsRight`: 播控栏右侧
+	 *        - `controlsCenter`: 播控栏中间
+	 *        - `rootLeft`：播放器根节点左侧
+	 *        - `rootRight`：播放器根节点右侧
+	 *        - `rootTop`：播放器根节点顶部
+	 *        - `root`：播放器根节点
 	 * @notice 此参数同时影响“打开/关闭播放列表”和“播放下一个”两个按钮的位置。
+	 * @default controlsLeft
+	 */
+	/** {en}
+	 * @brief 图标位置
 	 * @default controlsLeft 控制栏左侧
 	 */
 	position?: string;
 	/**
-	 * @brief 图标位置权重
+	 * @brief 按钮在所在区域的次序。默认值为 `2`，表示在播放按钮后。
 	 * @default 20
 	 */
+	/** {en}
+	 * @brief 图标位置权重
+	 */
 	index?: number;
 	/**
-	 * @brief 列表数据
+	 * @brief 播放列表数据。
 	 * @default []
 	 */
+	/** {en}
+	 * @brief 列表数据
+	 */
 	list: IPlayListItem[];
 	/**
-	 * @brief 循环模式
-	 * - order：不循环播放，即列表中最后一个视频播放完成后就停止播放。
-	 * - loop：列表循环，即列表中最后一个视频播放完成后将自动开始重新播放列表中的第一个视频。
+	 * @brief 循环模式，取值如下：
+	 *
+	 *        - `order`: 不循环播放，即列表中最后一个视频播放完成后就停止播放。
+	 *        - `loop`: 列表循环，即列表中最后一个视频播放完成后将自动开始重新播放列表中的第一个视频。
 	 * @default order
 	 */
+	/** {en}
+	 * @brief 循环模式
+	 */
 	mode?: EPlayMode;
 	/**
-	 * @brief 默认起始播放序号
+	 * @brief 默认起始的播放次序。
 	 * @default order
 	 */
+	/** {en}
+	 * @brief 默认起始播放序号
+	 */
 	defaultIndex?: number;
 	/**
-	 * @brief 列表点击之后是否隐藏列表
+	 * @brief 列表点击之后是否隐藏。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief 列表点击之后是否隐藏列表
+	 */
 	isItemClickHide?: boolean;
 	/**
+	 * @brief 列表行为触发模式。
+	 * @default click
+	 */
+	/** {en}
+	 * @default click
 	 * @brief 列表行为触发模式
-	 * @default click 点击
 	 */
 	toggleMode?: TOGGLE_MODES;
 	/**
-	 * @brief 是否显示图标
+	 * @brief 是否显示播放列表按钮。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief 是否显示图标
+	 */
 	isShowIcon?: boolean;
 }
 export declare class PlayListPlugin extends Plugin {
@@ -1328,95 +1659,94 @@ export interface IPlayInfoList {
 	Width: number;
 }
 declare enum CodecType {
-	/**
+	/** {zh}
 	 * @brief H.265
 	 */
 	H265 = "h265",
-	/**
+	/** {zh}
 	 * @brief H.264
 	 */
 	H264 = "h264",
-	/**
-	 * @brief 未知编码
+	/** {zh}
+	 * @brief 未知编码格式
 	 */
 	UNKNOWN = "unknown"
 }
 declare enum RTMCodec {
 	H264 = "h264"
 }
-/**
- * @brief region 类型
+/** {zh}
+ * @brief 区域类型：
+ *        - `'cn'`：中国内地
+ *        - `'mya'`：马来西亚
+ *        - `'sg'`：暂不生效
+ *        - `'va'`：暂不生效
  */
 export declare type TRegionType = "cn" | "mya" | "va" | "sg";
-/**
- * @brief 音乐循环模式
- * - order 顺序播放
- * - sloop 单曲循环
- * - loop 列表循环
- * - random 列表随机
+/** {zh}
+ * @brief 音乐循环模式：
+ *        - `'order'`：顺序播放
+ *        - `'sloop'`：单曲循环
+ *        - `'loop'`：列表循环
+ *        - `'random'`：列表随机
  */
 export declare type PlayModeType = "order" | "sloop" | "loop" | "random";
 export interface IMusicListItem {
-	/**
-	 * 音乐地址
-	 *
+	/** {zh}
 	 * @type {string}
+	 * @brief 音乐播放地址。
 	 */
 	src: string;
-	/**
-	 * 音乐唯一vid
-	 *
+	/** {zh}
 	 * @type {string | number}
 	 * @memberof IMusicListItem
+	 * @brief 音乐唯一 ID。
 	 */
 	vid: string | number;
-	/**
-	 * 音乐封面
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof IMusicListItem
+	 * @brief 音乐封面 URL 地址。
 	 */
 	poster?: string;
-	/**
-	 * 音乐标题
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof IMusicListItem
+	 * @brief 音乐标题。
 	 */
 	title?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	[propName: string]: any;
 }
-/**
- * @brief 循环播放配置
+/** {zh}
+ * @brief AB 循环播放配置。
  * @list Options
  * @kind property
  */
 export interface IABCycle {
-	/**
-	 * AB循环段开始时间
+	/** {zh}
 	 * @default 0
 	 *
 	 * @type {boolean}
 	 * @memberof IABCycle
+	 * @brief AB 循环段开始时间，单位为秒。
 	 */
 	start: number;
-	/**
-	 * AB循环段结束时间
+	/** {zh}
 	 * @default 音乐结束时间点
 	 *
 	 * @type {boolean}
 	 * @memberof IABCycle
+	 * @brief AB 循环段开始时间，单位为秒。
 	 */
 	end: number;
-	/**
-	 * AB段是否循环播放
+	/** {zh}
 	 * @default false
-	 *
 	 * @type {boolean}
 	 * @memberof IABCycle
+	 * @brief AB 段是否循环播放。
 	 */
 	loop?: boolean;
 	/**
@@ -1424,113 +1754,105 @@ export interface IABCycle {
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
  * @list Options
- * @brief 音乐播放模式配置
+ * @brief 音乐播放模式配置。
  * @kind property
  */
 export interface IMusicConfig {
-	/**
-	 * 是否启用离线下载播放
+	/** {zh}
 	 * @default false
 	 *
 	 * @type {boolean}
 	 * @memberof IMusicConfig
+	 * @brief 是否启用离线下载播放。
 	 */
 	offline?: boolean;
-	/**
-	 * AB循环设置
+	/** {zh}
 	 * @default null
 	 *
 	 * @type {IABCycle}
 	 * @memberof IMusicConfig
+	 * @brief AB 循环播放配置。
 	 */
 	abCycle?: IABCycle | null;
-	/**
-	 * 快进快退时间跨度
+	/** {zh}
 	 * @default 15
 	 *
 	 * @type {number}
 	 * @memberof IMusicConfig
+	 * @brief 快进快退时间跨度，单位为秒。
 	 */
 	timeScale?: number;
-	/**
-	 * 循环模式
+	/** {zh}
 	 * @default order
 	 *
 	 * @type {('order' | 'sloop' | 'loop' | 'random')}
 	 * @memberof IMusicConfig
+	 * @brief 循环模式。
 	 */
 	mode?: PlayModeType;
-	/**
-	 * 播放列表
+	/** {zh}
 	 * @default []
 	 *
 	 * @type {Array<IMusicListItem>}
 	 * @memberof IMusicConfig
+	 * @brief 播放列表。
 	 */
 	list?: Array<IMusicListItem>;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
  * @list Options
- * @brief 播放地址列表， 可配置多线路和多清晰度
+ * @brief 播放地址列表，可配置多线路和多清晰度。
  * @kind property
  *
  * @export
  * @interface Stream
  */
 export interface Stream extends Partial<IPlayInfoList> {
-	/**
-	 * url类型，可以选值为“rtm”/“flv”/“mp4”/“hls”
-	 *
+	/** {zh}
 	 * @type {('rtm' | 'flv' | 'mp4' | 'hls')}
 	 * @memberof IPlayerConfig
+	 * @brief URL 类型，取值为：
+	 *        - `"rtm"`
+	 *        - `"flv"`
+	 *        - `"mp4"`
+	 *        - `"hls"`
 	 */
 	streamType?: string;
-	/**
-	 * 播放地址
+	/** {zh}
+	 * @brief 播放地址
 	 *
 	 * @type {string}
 	 * @memberof IPlayerConfig
 	 */
 	url: string;
-	/**
-	 * 清晰度key
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
+	 * @brief 清晰度 key
 	 */
 	definition?: string;
-	/**
-	 * 多语言词典中对应的key, 比如 definitionTextKey: HD_TEXT_KEY
-	 *
-	 * languages: {
-	 *    zh: {
-	 *        HD_TEXT_KEY: '高清'
-	 *    }
-	 * }
-	 *
-	 * 则清晰度切换选项显示“高清”， 不设置则显示definition的值
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
+	 * @brief 多语言词典中对应的 key。比如设置 `definitionTextKey: HD_TEXT_KEY` 以及 `languages: {zh: {HD_TEXT_KEY: '高清'}}`，则清晰度切换选项显示 “高清”。不设置则显示 `definition` 的值。
 	 */
 	definitionTextKey?: string;
-	/**
+	/** {zh}
 	 * @brief 编码格式
 	 * @default unknown
 	 */
 	codec?: CodecType;
-	/**
-	 * 线路唯一id
+	/** {zh}
+	 * @brief 线路唯一 ID
 	 */
 	lineId?: number | string;
-	/**
-	 * 多语言词典中对应的key, 比如 lineTextKey: LINE_ONE
+	/** {zh}
 	 * @example
 	 * ```
 	 * languages: {
@@ -1543,14 +1865,15 @@ export interface Stream extends Partial<IPlayInfoList> {
 	 *
 	 * @type {string}
 	 * @memberof Stream
+	 * @brief 多语言词典中对应的 key。比如 `lineTextKey: LINE_ONE`。
 	 */
 	lineTextKey?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
  * @hidden
  */
 export interface Condition {
@@ -1561,9 +1884,8 @@ export interface Condition {
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
  * @hidden
- * @description 播放器当前状态
  */
 export interface Current {
 	definition: string;
@@ -1576,10 +1898,13 @@ export interface Current {
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
  * @list Options
  * @kind property
- * @brief 实例化参数配置项
+ * @brief 播放器实例化配置。
+ */
+/** {en}
+ * @brief Player Instance Configuration
  */
 export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
@@ -1589,79 +1914,86 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	isLive?: boolean;
 	/** {zh}
-	 * @brief 播放器容器id，VePlayer将被插入在该容器中
-	 * @notes `id`和`root`参数至少传入 1 个。
+	 * @brief 播放器容器 ID。播放器将被插入在该容器中。
 	 * @default -
+	 * @listtip `id` 和 `root` 参数需至少传入 1 个。如果都传入，则优先使用 `root` 参数。
 	 */
 	id?: string;
 	/** {zh}
-	 * @brief 播放器容器DOM元素，VePlayer将被插入在该容器中
+	 * @brief 播放器容器 DOM 元素。VePlayer 将被插入该容器中。
 	 * @notes `id`和`root`参数至少传入 1 个。
 	 * @default -
+	 * @listtip `id` 和 `root` 参数需至少传入 1 个。如果都传入，则优先使用 `root` 参数。
 	 */
 	root?: HTMLElement;
 	/** {zh}
-	 * @brief 视频地址
+	 * @brief 视频播放地址。
 	 * @default -
 	 */
 	url?: string;
-	/**
-	 * @brief 视频点播媒资中的视频vid，推荐填写，以方便跟踪播放质量
+	/** {zh}
+	 * @brief 视频点播服务中的视频 ID。推荐填写，以方便跟踪该视频的播放质量。您将音视频上传至视频点播服务后，可通过以下方式获取 `Vid`：
+	 *
+	 *        - 在视频点播控制台获取。
+	 *        - 通过 [GetMediaList](https://www.volcengine.com/docs/4/69205) 接口获取 `Vid`。
+	 *        - 如果您设置了媒资上传完成的回调事件，会在 [FileUploadComplete](https://www.volcengine.com/docs/4/4655) 中返回 `Vid`。
 	 * @default -
 	 */
 	vid?: string;
 	/** {zh}
-	 * @brief vid播放配置项
-	 * @notes 需要业务方服务端通过vid生成临时playAuthToken
-	 *
+	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时 `playAuthToken`，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
 	 * @memberof IPlayerConfig
 	 */
 	getVideoByToken?: IPlayAuthTokenConfig;
 	/** {zh}
-	 * @brief 视频格式/协议类型。取值如下：
-	 *  - `mp4`
-	 *  - `hls`
-	 *  - `dash`
-	 *  - `flv`
-	 * @notes 如果`url`参数视频地址不包含文件格式后缀，则`streamType`必传。
+	 * @brief 视频格式。取值如下：
+	 *        - `mp4`
+	 *        - `hls`
+	 *        - `dash`
+	 *        - `flv`
+	 * @listtip 如果 `url` 参数取值中不包含文件格式后缀，则 `streamType` 必填。
 	 */
 	streamType?: "mp4" | "hls" | "dash" | "rtm" | "flv";
 	/** {zh}
-	 * @brief 播放器宽度，可以是数字或者css width 属性值，是数字时单位是`px`
+	 * @brief 播放器宽度。可传入数字或者 CSS `width` 属性值。如为数字，单位为 px。
 	 * @default 100%
 	 */
 	width?: number | string;
 	/** {zh}
-	 * @brief 播放器高度，可以是数字或者css width 属性值，是数字时单位是`px`
+	 * @brief 播放器高度。可传入数字或者 CSS `width` 属性值。如为数字，单位为 px。
 	 * @default 100%
 	 */
 	height?: number | string;
 	/** {zh}
-	 * @brief 默认音量
+	 * @brief 默认起播音量。取值范围为 [0,1]。
 	 * @default 0.6
 	 */
 	volume?: number;
 	/** {zh}
-	 * @brief 是否自动播放。取值如下：
-	 *  - `true`：是
-	 *  - `false`：否
+	 * @brief 是否开启自动播放。取值如下：
+	 *        - `true`：是
+	 *        - `false`：否
 	 * @default false
 	 * @notice 受限制于浏览器策略，自动播放不一定能成功，取决于浏览器环境、用户行为、浏览器配置等，详细参考自动播放 @link https://www.volcengine.com/docs/4/68693#%E8%87%AA%E5%8A%A8%E6%92%AD%E6%94%BE
+	 * @listtip 受限于浏览器策略，自动播放不一定能成功，取决于浏览器环境、用户行为、浏览器配置等。详情请参考[自动播放](https://www.volcengine.com/docs/4/68693#%E8%87%AA%E5%8A%A8%E6%92%AD%E6%94%BE)。
 	 */
 	autoplay?: boolean;
+	/** {zh}
+	 * @brief 视频封面图片的 URL。
+	 */
 	poster?: string | IPoster;
 	/** {zh}
 	 * @brief 是否开启静音自动播放。取值如下：
-	 *  - `true`：是
-	 *  - `false`：否
+	 *        - `true`：开启静音自动播放。
+	 *        - `false`：关闭静音自动播放。
 	 *  @default false
 	 */
 	autoplayMuted?: boolean;
 	/** {zh}
-	 * @brief 有声音自动播放失败时是否降级成静音自动播放，默认不降级
-	 *  - `true`：是，降级
-	 *  - `false`：否，不降级
+	 * @brief 是否开启降级静音自动播放。开启后，有声音自动播放失败时，会降级成静音自动播放。取值如下：
+	 *        - `true`：开启降级静音自动播放
+	 *        - `false`：关闭降级静音自动播放
 	 * @default false
 	 */
 	enableDegradeMuteAutoplay?: boolean;
@@ -1670,84 +2002,88 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *  - `true`：是，降级
 	 *  - `false`：否，不降级
 	 * @default false
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
 	 */
 	enableWxJsBridgeAutoplay?: boolean;
 	/** {zh}
-	 * @brief 开启任意点击的用户行为触发自动播放，默认不开启
-	 *  - `true`：是，开启
-	 *  - `false`：否，不开启
+	 * @brief 是否开启任意用户行为触发自动播放。开启后，第一次用户的任意点击可以触发播放器的自动播放。取值如下：
+	 *        - `true`：开启
+	 *        - `false`：不开启
 	 * @default false
 	 */
 	enableUserActionAutoplay?: boolean;
 	/** {zh}
-	 * @brief 是否开启循环播放。
-	 *  - `true`：是，开启
-	 *  - `false`：否，不开启
+	 * @brief 是否开启循环播放。取值如下：
+	 *        - `true`：开启循环播放。
+	 *        - `false`：关闭循环播放。
 	 *  @default false
 	 */
 	loop?: boolean;
 	/** {zh}
-	 * @brief 默认起播倍速。参考值 0.5/0.75/1/1.5/2
+	 * @brief 默认起播倍速。可设为 `0.5`、`0.75`、`1`、`1.5`、`2`。
 	 * @default 1
 	 */
 	defaultPlaybackRate?: number;
 	/** {zh}
-	 * @brief 国际化语言。支持自定义，默认语言类型包括：
-	 * - `zh` 或 `zh-cn`
-	 * - `en`
-	 * - `jp`
-	 * - `zh-hk`
+	 * @brief 界面语言。取值如下：
+	 *        - `zh` 或 `zh-cn`
+	 *        - `en`
+	 *        - `jp`
+	 *        - `zh-hk`
 	 * @default zh
 	 */
 	lang?: "zh" | "zh-cn" | "en" | "jp" | "zh-hk";
 	/** {zh}
-	 * @brief 自定义多语言词典。可设置每个语种的词典 `{ [key: string]: Object; }`。例如：
-	 * ```javascript
-	 * {
-	 *    zh: {
-	 *        PIP: '画中画'
-	 *    },
-	 *    en: {
-	 *        PIP: 'pip'
-	 *    }
-	 * }
-	 * ```
+	 * @brief 多语言词典。可设置每个语种的词典，例如：
+	 *        ```javascript
+	 *        { zh: { PIP: '画中画' }, en: { PIP: 'pip' }}
+	 *        ```
 	 * @notice
 	 * @see 了解更多，请参见{@link https://www.volcengine.com/docs/6469/127529 默认词典}。
+	 * @listtip 了解更多，请参见[默认词典](https://www.volcengine.com/docs/6469/127529)。
 	 */
 	languages?: {
 		[key: string]: Record<string, any>;
 	};
 	/** {zh}
-	 * @brief 画中画配置
+	 * @brief 画中画配置。
 	 * @default PC: {position: 'controlsRight', index: 2.5, showIcon: true}; mobile：false
 	 * @notice 画中画功能由浏览器提供，如果本身浏览器不支持，即使有该配置也不显示画中画按钮
+	 * @listtip 画中画功能由浏览器提供。如果浏览器不支持，即使传入此配置也不会显示画中画按钮。
 	 */
 	pip?: IPIPConfig | boolean;
 	/** {zh}
-	 * @brief 全屏相关配置
+	 * @brief 全屏配置。
 	 * @default {position: 'controlsRight', index: 0, rotateFullscreen: false, useCssFullscreen: false, target: null, switchCallback: null, disable: false, needBackIcon: false }
 	 */
 	fullscreen?: IFullscreenConfig;
 	/** {zh}
 	 * @breif 是否总是显示清晰度切换控件，即只有一个清晰度时也显示清晰度切换控件
 	 * @default false
+	 * @brief 是否总是显示清晰度切换控件，即只有单个清晰度时也显示清晰度切换控件。
 	 */
 	alwaysShowDefinition?: boolean;
 	/** {zh}
 	 * @breif url对应视频的清晰度文案，仅`alwaysShowDefinition`为`true`时有效
 	 * @default HD
+	 * @listtip 仅 `alwaysShowDefinition` 为 `true` 时有效。
+	 * @brief `url` 参数对应视频的清晰度文案。
 	 */
 	definitionText?: string;
 	/** {zh}
-	 * @brief url对应视频的清晰度文案的多语言key，对应参数 languages 中相对应的文案，仅alwaysShowDefinition为true时有效，优先级高于definitionText
+	 * @brief `url` 参数对应视频的清晰度文案的多语言 key，对应参数 `languages` 中的文案。
 	 * @default -
+	 * @listtip 仅 `alwaysShowDefinition` 为 `true` 时有效，优先级高于 `definitionText`。
 	 */
 	definitionTextKey?: string;
 	/** {zh}
-	 * @brief 视频编码方式
-	 * 软解useSoftDecoding设置为true时，提供codec可提升软解初始效率
+	 * @brief 视频编码格式。
 	 * @notice 在已知视频编码方式的情况下推荐传入，以方便日志分析
+	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
+	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
 	codec?: `${CodecType}`;
 	/** {zh}
@@ -1763,7 +2099,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	region?: TRegionType;
 	/** {zh}
-	 * @brief 插件加载公共路径，用于指定插件的加载路径，或者本地文件服务加载插件
+	 * @brief 插件加载的路径。您可从 [SDK 离线包](https://www.volcengine.com/docs/4/67077#%E5%BC%95%E5%85%A5%E4%BE%9D%E8%B5%96)中获取插件，然后将插件文件放置于应用服务器上，再在初始化播放器时指定插件地址。
 	 * @default https://lf-unpkg.volccdn.com/obj/vcloudfe/sdk/@volcengine/veplayer/${version}/plugin
 	 * @notice 可将插件文件夹置于业务方服务器上，指定插件的地址即可
 	 */
@@ -1774,84 +2110,78 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	pluginPublicPath?: string;
 	/**
-	 * @brief 开始播放时间
-	 * @default -
+	 * @brief 起播时间，单位为秒。
+	 * @default 0
 	 */
 	startTime?: number;
 	/** {zh}
-	 * @brief 为播放器设置是否启用内联播放模式。playsinline 属性是 HTML5 视频标签的一个属性，用于指定视频是否应在页面文档内播放。
-	 * - `true`：启用，表示视频将在页面文档内播放；
-	 * - `false`：停用，默认浏览器播放行为。</br>
-	 *
-	 * 该配置项只在移动端生效，当取值为 true 的时候，会在初始化 video 或 audio 对象的时候，将 playsinline、webkit-playsinline、x5-playsinline 三个属性设置为 true，请参考 [New Policies for iOS](https://webkit.org/blog/6784/new-video-policies-for-ios/) 了解内联模式相关知识。
-	 * @listtip
-	 * - iOS 10 及以上系统 Safari 浏览器支持配置内联播放模式；
-	 * - iOS 10 以下系统 Safari 浏览器不支持配置内联播放模式 ，默认播放即进入系统全屏。
+	 * @brief 是否启用内联播放模式。`playsinline` 属性是 HTML5 视频标签的一个属性，用于指定视频是否应在页面文档内播放。
+	 *        - `true`：启用内联播放模式，表示视频将在页面文档内播放。
+	 *        - `false`：禁用内联播放模式。</br>
+	 * @listtip 此参数仅在在移动端生效。此参数取值为 `true` 时，会在初始化 `video` 或 `audio` 对象的时候，将 `playsinline`、`webkit-playsinline`、`x5-playsinline` 三个属性设置为 `true`，请参考 [New Policies for iOS](https://webkit.org/blog/6784/new-video-policies-for-ios/) 了解内联播放模式相关知识。iOS 上内联播放模式的支持情况如下：
+	 *          - iOS 10 及以上系统 Safari 浏览器支持配置内联播放模式。
+	 *          - iOS 10 以下系统 Safari 浏览器不支持配置内联播放模式，默认播放即进入系统全屏。
 	 * @default true
 	 */
 	playsinline?: boolean;
 	/** {zh}
-	 * @brief 为播放器设置 video 标签扩展属性，初始化时会设置在 videoElement 或 audioElement 对象上，请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
+	 * @brief `video` 标签扩展属性。播放器初始化时会设置在 `videoElement` 或 `audioElement` 对象上。请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看支持的属性。
 	 * @default 无
 	 */
 	videoAttributes?: Partial<HTMLVideoElement>;
 	/** {zh}
-	 * @brief 为播放器设置是否启用流式布局，启用流式布局后播放器会根据屏幕的宽度进行调整，保持在不同屏幕尺寸上都有良好的显示效果。
-	 * - `true`：启用
-	 * - `false`：停用
-	 * @listtip
-	 * 启用流式布局时：
-	 * - 如果 `width` 和 `height` 是 `Number` 类型，则按照其数值计算播放器宽高比；
-	 * - 如果 `width` 和 `height` 不是 `Number` 类型，默认使用 16:9 比例。
+	 * @brief 是否启用流式布局。启用流式布局后，播放器会根据屏幕宽度进行自适应调整，以确保在不同屏幕尺寸上都能呈现良好的显示效果。取值如下：
+	 *        - `true`：启用流式布局
+	 *        - `false`：停用流式布局
+	 * @listtip 启用流式布局时，播放器的宽高比与 `width` 和 `height` 的取值有关，具体如下：
+	 *          - 如果 `width` 和 `height` 是 `Number` 类型，则按照其数值计算播放器宽高比。
+	 *          - 如果 `width` 和 `height` 不是 `Number` 类型，默认使用 16:9 比例。
 	 * @default false
 	 */
 	fluid?: boolean;
 	/** {zh}
-	 * @brief 为播放器设置尺寸适配方式，在视频资源初始化之后，根据获取到的 videoWidth 和 videoHeight 值对播放器容器宽高比例进行调整，可选项有：
-	 * - `fixed`: 保持容器宽/高，不做适配；
-	 * - `fixWidth`: 保持容器宽度，适配高度；
-	 * - `fixHeight`: 保持容器高度，适配宽度。
-	 *
+	 * @brief 尺寸适配方式。在视频资源初始化之后，根据获取到的 `videoWidth` 和 `videoHeight` 的值对播放器容器宽高比进行调整。取值如下：
+	 *        - `fixed`: 保持容器宽高比，不进行适配。
+	 *        - `fixWidth`: 保持容器宽度，仅适配高度。
+	 *        - `fixHeight`: 保持容器高度，仅适配宽度。
 	 * @default fixed
 	 */
 	fitVideoSize?: "fixWidth" | "fixHeight" | "fixed";
 	/** {zh}
-	 * @brief 为播放器设置视频画面填充模式，可选项有：
-	 * - `fillwidth`: 填充宽度，高度溢出则裁剪高度；
-	 * - `fillHeight`: 填充高度，宽度溢出则裁剪宽度；
-	 * - `fill`: 拉伸视频以填充容器；
-	 * - `cover`: 保持其宽高比的同时填充元素的整个内容框；
-	 * - `auto`: 使用浏览器默认的视频画面填充模式。
+	 * @brief 视频画面填充模式。取值如下：
+	 *        - `fillwidth`: 填充宽度，高度溢出则裁剪高度。
+	 *        - `fillHeight`: 填充高度，宽度溢出则裁剪宽度。
+	 *        - `fill`: 拉伸视频以填充容器。
+	 *        - `cover`: 保持视频宽高比的同时填充元素的整个内容框。
+	 *        - `auto`: 使用浏览器默认的视频画面填充模式。
 	 * @default auto
 	 */
 	videoFillMode?: "auto" | "fillHeight" | "fillWidth" | "fill" | "cover";
 	/** {zh}
-	 * @brief 是否开启画面和控制栏分离模式。设置为开启时，控制栏将会常驻，与视频画面不重叠。
-	 * - `true`：开启
-	 * - `false`：关闭
+	 * @brief 是否开启画面和控制栏分离模式。开启时，控制栏将会常驻，与视频画面不重叠。
+	 *        - `true`：开启
+	 *        - `false`：关闭
 	 * @default false
 	 */
 	marginControls?: boolean;
 	/** {zh}
-	 *  @brief 启用x5内核浏览器的同层播放。
+	 * @brief 是否启用 X5 内核浏览器的同层播放。
 	 * @default 无
 	 */
 	"x5-video-player-type"?: string;
 	/** {zh}
-	 *  @brief 是否启用x5内核浏览器的全屏播放模式。
-	 * - `true`：启用
-	 * - `false`：停用
+	 * @brief 是否启用 X5 内核浏览器的全屏播放模式。
+	 *        - `true`：启用
+	 *        - `false`：停用
 	 * @default 无
 	 */
 	"x5-video-player-fullscreen"?: boolean;
 	/** {zh}
-	 *  @brief x5内核浏览器的横竖屏控制，支持如下取值：
-	 * - `landscape`：横屏
-	 * - `portrait`：竖屏
-	 * - `landscape|portrait`：跟随手机自动旋转
-	 * @default
-	 * - mobile：`landscape|portrait`
-	 * - pc：-
+	 * @brief X5 内核浏览器的横竖屏控制。取值如下：
+	 *        - `landscape`：横屏
+	 *        - `portrait`：竖屏
+	 *        - `landscape|portrait`：跟随手机自动旋转
+	 * @default `landscape|portrait`（移动端）
 	 */
 	"x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
 	/** {zh}
@@ -1861,8 +2191,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	commonStyle?: ICommonStyle;
 	/** {zh}
-	 * @brief 是否启用音乐播放器模式
-	 * @default `false`
+	 * @brief 是否开启音乐播放模式。开启后，您可还通过 `music` 参数对音乐播放器进行配置。取值如下：
+	 *        - `true`：开启音乐播放模式
+	 *        - `false`：停用音乐播放模式
+	 * @default false
 	 */
 	isMusic?: boolean;
 	/** {zh}
@@ -1875,36 +2207,39 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	enableContextmenu?: boolean;
 	/** {zh}
-	 * @brief 是否关闭video上的阻止事件传播
-	 * @default `false`
+	 * @brief 是否关闭 `video` 标签的事件冒泡。取值如下：
+	 *
+	 *        - `true`：关闭。
+	 *        - `false`：开启。
+	 * @default false
 	 */
 	closeVideoStopPropagation?: boolean;
 	/** {zh}
-	 * @brief 右键菜单是否可用
-	 * @default `false`
+	 * @brief 是否开启右键菜单。取值如下：
+	 *        - `true`：是。
+	 *        - `false`：否。
+	 * @default false
 	 */
 	enableMenu?: boolean;
 	/** {zh}
-	 * @brief 是否开启hls的MSE模式，
+	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生`video 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
 	 * @notice 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
 	 */
 	enableHlsMSE?: boolean;
 	/** {zh}
-	 * @brief 在PC Safari上是否使用hls插件播放
-	 * - true: 使用；
-	 * - false: 不使用
-	 * @default `true`
+	 * @brief 在 PC Safari 上是否 HLS 插件播放视频。取值如下：
+	 *        - `true`：使用 HLS 插件。SDK 会自动加载 HLS 插件。
+	 *        - `false`：不使用 HLS 插件。
+	 * @default true
 	 */
 	useHlsPluginForSafari?: boolean;
 	/** {zh}
-	 * @brief 是否开启mp4的MSE模式，开启后采用MSE方式播放MP4，
-	 * mp4的MSE模式具有精确的seek加载、视频的无缝切换、流量节省等功能
-	 * @default `false`
+	 * @brief 是否开启 MP4 视频的 MSE 模式。开启后，将采用 MSE 方式播放 MP4，实现精确的 Seek 加载、视频的无缝切换、流量节省等功能。
+	 * @default false
 	 */
 	enableMp4MSE?: boolean;
 	/** {zh}
-	 * @brief 播放列表
-	 * @notes url和playList必填一个，二者都传入时， url必须在playList中。
+	 * @brief 播放地址列表。
 	 * @default -
 	 */
 	playList?: Stream[];
@@ -1914,7 +2249,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	plugins?: any[];
 	/** {zh}
-	 * @brief 忽略加载的插件，用于禁用默认加载的插件，传入插件名称数组，名称不区分大小写
+	 * @brief 用于禁用插件。VePlayer 内置了一些常用的功能插件。如需禁用某一内置插件，可传入插件名称（不区分大小写）。
 	 * @default []
 	 */
 	ignores?: string[];
@@ -1929,9 +2264,17 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	isMobile?: boolean;
 	/** {zh}
-	 * @brief umd插件依赖备用地址
-	 * 用于依赖的插件所在CDN发生网络错误时的进行安全降级的备用地址，可以是相对地址
-	 * 支持的依赖有hls（非加密hls播放）、flv（flv播放）、XGVideo（软解播放）、hlsEncrypt（加密hls播放）、dash（dash播放）、mp4Encrypt（加密np4播放）、danmujs（弹幕）、danmuMask（蒙版弹幕）、subtitle（外挂字幕）
+	 * @brief UMD 依赖备用地址。用于依赖的 CDN 发生网络错误时的降级备用地址。支持的依赖如下：
+	 *
+	 *        - `hls`：非加密 HLS 播放。
+	 *        - `flv`：FLV 播放。
+	 *        - `XGVideo`：软解播放。
+	 *        - `hlsEncrypt`：加密 HLS 播放。
+	 *        - `dash`：DASH 播放。
+	 *        - `mp4Encrypt`：加密 MP4 播放。
+	 *        - `danmujs`：弹幕。
+	 *        - `danmuMask`：蒙版弹幕。
+	 *        - `subtitle`：外挂字幕。
 	 * @example 以配置hls插件的备用地址为例
 	 * ```
 	 * const playerSdkIns = new VePlayer({
@@ -1947,18 +2290,28 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	umdUrlMap?: Record<string, string>;
 	/**
-	 * @brief 唯一id，用于私有DRM加密
+	 * @brief 唯一 ID，用于[私有加密方案](https://www.volcengine.com/docs/4/106524)。
 	 * @default -
 	 */
+	/** {en}
+	 */
 	unionId?: string;
 	/** {zh}
-	 * @brief 是否启用软解
-	 * @default `false`
+	 * @brief 是否启用软解。取值如下：
+	 *
+	 *        - `true`：启用。
+	 *        - `false`：不启用。
+	 * @default false
+	 * @listtip - 移动端浏览器不支持 FLV 格式，如果需要播放该格式的视频，请开启软解。
+	 *          - 软解播放的解码操作依赖设备 CPU，播放高码率、高分辨率的视频时，对 CPU 占用率较高。
 	 */
 	useSoftDecoding?: boolean;
 	/** {zh}
-	 * @brief 是否开H265播放降级，即H.265硬解不支持时自动降级为软解
-	 * @default `false`
+	 * @brief 是否开启 H.265 自动降级模式。开启 H.265 兼容模式后，VePlayer 会在不支持 H.265 硬解的浏览器环境下，自动降级为兼容模式。取值如下：
+	 *
+	 *        - `true`：开启 H.265 自动降级模式。
+	 *        - `false`：不开启 H.265 自动降级模式。
+	 * @default false
 	 */
 	enableH265Degrade?: boolean;
 	/** {zh}
@@ -1968,7 +2321,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	onMediaExpired?: () => Promise<IPlayerConfig>;
 	/** {zh}
-	 * @brief playAuthToken过期时的回调函数，用来更新playAuthToken
+	 * @brief `playAuthToken` 过期时的回调函数，可用来更新 `playAuthToken`。
 	 * @default -
 	 */
 	onTokenExpired?: () => Promise<IPlayAuthTokenConfig>;
@@ -1993,7 +2346,13 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	disableVodLogOptsCheck?: boolean;
 	/** {zh}
-	 * @brief 播放器报错展示配置, 可以配置播放异常时的播放器显示的异常文案、图片，以及是否提供刷新按钮等
+	 * @hidden
+	 * @brief 是否打开日志打印
+	 * @default false
+	 */
+	debug?: boolean;
+	/** {zh}
+	 * @brief 播放器报错信息。支持配置播放异常时显示的异常文案、图片以及是否提供刷新按钮等。
 	 * @default -
 	 */
 	sdkErrorPlugin?: ISdkErrorConfig;
@@ -2001,188 +2360,201 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief rtm配置，配置rtm拉流参数
 	 * @notes 传入rtm流url时才生效
 	 * @default -
+	 * @hidden
 	 */
 	rtm?: IRtmConfig;
-	/**
-	 * @brief 弹幕及面板配置，可配置弹幕的一些参数，如弹幕文字大小、透明度、展示区域等
+	/** {zh}
+	 * @brief 弹幕及面板配置。支持配置弹幕文字大小、透明度、展示区域等参数。
 	 * @default -
 	 */
 	DanmuPlugin?: IDanmuConfig | boolean;
-	/**
+	/** {zh}
 	 * @brief 清晰度自动降级配置
 	 * @hidden
 	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
 	 */
 	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief DASH 播放配置项
 	 * @default -
 	 */
 	DASHPlugin?: Partial<IDashPluginConfig>;
-	/**
-	 * @brief HLS 加密播放配置项
+	/** {zh}
+	 * @brief HLS 加密播放配置。
 	 * @default -
 	 */
 	EncryptHlsPlugin?: Partial<IEncryptHlsPluginConfig> | boolean;
-	/**
-	 * @brief 质量日志配置项
+	/** {zh}
+	 * @brief 质量日志上报配置
 	 * @default -
 	 */
 	vodLogOpts?: Partial<IVodLogOptsConfig>;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief mp4加密播放配置项
 	 * @default -
 	 */
 	Mp4EncryptPlayer?: Partial<IMp4EncryptPlayerConfig> | boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 自适应码率配置项
 	 * @default -
 	 */
 	autoBitrateOpts?: IAutoBitrateOptsConfig;
-	/**
-	 * @brief 外挂字幕配置项
+	/** {zh}
+	 * @brief 外挂字幕配置。
 	 * @default -
 	 */
 	Subtitle?: ISubtitleConfig;
-	/**
-	 * 记忆播放配置项
+	/** {zh}
 	 * @type {IMemoryPlayConfig}
 	 * @memberof IPlayerConfig
+	 * @brief 记忆播放配置。
 	 */
 	MemoryPlay?: IMemoryPlayConfig | boolean;
-	/**
-	 * 音乐播放器配置项
+	/** {zh}
 	 * @type {IMusicConfig}
 	 * @memberof IPlayerConfig
+	 * @brief 音乐播放器配置。
 	 */
 	music?: IMusicConfig;
-	/**
-	 * 自动播放配置
+	/** {zh}
 	 * @type {IMusicConfig}
 	 * @memberof IPlayerConfig
+	 * @brief 自动播放配置。
 	 */
 	AutoplayPlugin?: IAutoplayPluginConfig;
-	/**
-	 * 播放列表配置
+	/** {zh}
 	 * @type { IPlayListConfig }
 	 * @memberof IPlayerConfig
+	 * @brief 播放列表配置。
 	 */
 	playListPlugin?: IPlayListConfig;
 }
-/**
- * @brief初始配置
+/** {zh}
  * @hidden
  */
 export interface IDefaultConfig {
-	/**
-	 * “点播”还是“直播”
+	/** {zh}
+	 * @brief “点播”还是“直播”
 	 *
 	 * @type {('live' | 'vod')}
 	 * @memberof IPlayerConfig
 	 */
 	type?: "live" | "vod";
-	/**
-	 * 是否是直播
+	/** {zh}
+	 * @brief 是否是直播
 	 *
 	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
 	isLive?: boolean;
-	/**
-	 * 线路唯一key
+	/** {zh}
+	 * @brief 线路唯一key
 	 *
 	 * @type {(number | string)}
 	 * @memberof Stream
 	 */
 	lineId?: number | string;
-	/**
-	 * 清晰度选择
+	/** {zh}
+	 * @brief 清晰度选择
 	 *
 	 * @type {string}
 	 * @memberof Stream
 	 */
 	definition?: string;
-	/**
-	 * 开始播放时间
+	/** {zh}
+	 * @brief 开始播放时间
 	 *
 	 * @type {number}
 	 * @memberof IDefaultConfig
 	 */
 	startTime?: number;
-	/**
-	 * 音量
+	/** {zh}
+	 * @brief 音量
 	 *
 	 * @type {number}
 	 * @memberof IDefaultConfig
 	 */
 	volume?: number;
-	/**
-	 * 弹幕插件配置
+	/** {zh}
+	 * @brief 弹幕插件配置
 	 *
 	 * @type {*}
 	 * @memberof IDefaultConfig
 	 */
 	DanmuPlugin?: any;
-	/**
-	 * 字幕插件配置
+	/** {zh}
+	 * @brief 字幕插件配置
 	 *
 	 * @type {*}
 	 * @memberof IDefaultConfig
 	 */
 	LiveSubtitlesIconPlugin?: any;
 }
-/**
- * @brief vid播放配置信息
+/** {zh}
+ * @brief Vid 播放配置。
  * @list Options
  * @kind property
  */
 export interface IPlayAuthTokenConfig {
 	/** {zh}
-	 * @brief 服务端生成的临时播放凭证。
+	 * @brief 应用服务端生成的临时播放凭证。
 	 * @default -
 	 */
 	playAuthToken: string;
 	/** {zh}
-	 * @brief 默认清晰度
+	 * @brief 默认清晰度。对应 [GetPlayInfo](https://www.volcengine.com/docs/4/2918) 接口返回的 `Definition`。为空时默认为接口返回的最高清晰度。
 	 * @default -
-	 * @notes 为空时默认为最大码率的清晰度
 	 */
 	defaultDefinition?: string;
 	/** {zh}
 	 * @brief 获取播放地址的请求域名。
 	 * @default`https://vod.volcengineapi.com`
+	 * @default https://vod.volcengineapi.com
 	 */
 	/** {en}
 	 * @brief Get the requested domain name of the playback address
-	 * @default `https://vod.byteplusapi.com`
+	 * @default https://vod.byteplusapi.com
 	 */
 	playDomain?: string;
 	/** {zh}
-	 * @brief 是否启用控制台设置的封面图
-	 * @default `false`
+	 * @brief 是否使用您在视频点播控制台上设置的封面图。 取值如下：
+	 *
+	 *        - `false`：否。
+	 *        - `true`：是。
+	 * @default false
+	 * @listtip 请确保您已在视频点播控制台中生成和设置封面图，详见[封面图和封面候选](https://www.volcengine.com/docs/4/5335)。
 	 */
 	needPoster?: boolean;
 	/** {zh}
-	 * @brief 是否启用控制台设置的截图中的雪碧图
-	 * @default `false`
+	 * @brief 是否使用您在视频点播控制台上生成的雪碧图。取值如下：
+	 *
+	 *        - `false`：否。
+	 *        - `true`：是。
+	 * @default false
+	 * @listtip 请确保您已通过视频点播媒体处理服务生成雪碧图，详见[雪碧图](https://www.volcengine.com/docs/4/1171758)。
 	 */
 	needThumbs?: boolean;
 	/** {zh}
-	 * @brief 是否启用控制台设置的蒙版弹幕
-	 * @default `false`
+	 * @brief 是否使用您在视频点播控制台上生成的蒙版弹幕。取值如下：
+	 *
+	 *        - `false`：否。
+	 *        - `true`：是。
+	 * @default false
+	 * @listtip 请确保您已通过视频点播媒体处理服务生成蒙版弹幕。
 	 */
 	needBarrageMask?: boolean;
 	/** {zh}
-	 * @brief 是否需要多清晰度
-	 * @default `true`
+	 * @brief 是否需要获取展示多个清晰度。
+	 * @default true
 	 */
 	needDefinitionList?: boolean;
 	/** {zh}
 	 * @briefhls标准加密播放所需要的keyToken
 	 * @default -
+	 * @brief 用于 HLS 标准加密播放的 keyToken。
 	 */
 	keyToken?: string;
 	/** {zh}
@@ -2192,11 +2564,10 @@ export interface IPlayAuthTokenConfig {
 	 */
 	getKeyType?: string;
 	/** {zh}
-	 * @brief 获取`PrivateDrmAuthToken`的异步回调，
-	 * 回调入参：
-	 * - `playAuthIds`: 视频的密钥 KeyID，对应OpenAPI GetPlayInfo{@link https://www.volcengine.com/docs/4/2918#%E8%AF%B7%E6%B1%82%E8%AF%B4%E6%98%8E} 返回视频信息中的PlayAuthId，当有多个KeyID时以英文逗号相连
-	 * - `vid`: 视频vid
-	 * - `unionInfo`: 由`unionId`生成的`unionInfo`，以用来加密`PrivateDrmAuthToken`
+	 * @brief 获取 `PrivateDrmAuthToken` 的异步回调，回调入参为：
+	 *        - `playAuthIds`: 视频的密钥 ID，对应 [GetPlayInfo](https://www.volcengine.com/docs/4/2918) 接口返回的 `PlayAuthId`。有多个 Key ID 时以英文逗号隔开。
+	 *        - `vid`: 视频 ID
+	 *        - `unionInfo`: 由 `unionId` 生成的 `unionInfo`，用来加密`PrivateDrmAuthToken`。
 	 * @default -
 	 */
 	getDrmAuthToken?: (playAuthIds: string, vid: string, unionInfo: string) => Promise<string>;
@@ -2208,8 +2579,7 @@ export interface IPlayAuthTokenConfig {
 	 */
 	reqParams?: Record<string, number | string | boolean>;
 	/** {zh}
-	 * @brief 定义清晰度的映射
-	 *
+	 * @brief 定义清晰度的映射。
 	 * @example   如：
 	 * ``` javascript
 	 * {
@@ -2235,78 +2605,73 @@ export interface IPlayAuthTokenConfig {
 	 */
 	definitionMap?: Record<string, string | definitionItem>;
 	/** {zh}
-	 * @brief 点播服务502错误时重试次数
+	 * @brief 点播服务发生 502 错误时的重试次数。
 	 * @default 1
 	 */
 	retryCount?: number;
 }
-/**
- * 清晰度定义
- *
+/** {zh}
  * @list Options
  * @export
  * @interface definitionItem
+ * @brief 清晰度定义。
  */
 export interface definitionItem {
-	/**
-	 * 清晰度
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof definitionItem
+	 * @brief 清晰度。
 	 */
 	definition?: string;
-	/**
-	 * 清晰度多语言key
-	 *
+	/** {zh}
 	 * @type {string}
 	 * @memberof definitionItem
+	 * @brief 清晰度多语言 Key
 	 */
 	definitionTextKey?: string;
 }
 export interface IAutoBitrateOptsConfig {
-	/**
-	 * 是否开启功能,默认为false
-	 *
+	/** {zh}
+	 * @brief 是否开启功能,默认为false
 	 * @type {boolean}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	isOpenAutoDefi?: boolean;
-	/**
-	 * 自动切换清晰度对应显示文案
+	/** {zh}
+	 * @brief 自动切换清晰度对应显示文案
 	 *
 	 * @type {string}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	autoDefiText?: string;
-	/**
-	 * 起播是否调整到自动切换, 默认为false
-	 *
+	/** {zh}
+	 * @brief 起播是否调整到自动切换, 默认为false
 	 * @type {boolean}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	isPlayAutoDefi?: boolean;
-	/**
-	 * 调用算法频率
+	/** {zh}
+	 * @brief 调用算法频率
 	 *
 	 * @type {boolean}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	interval?: number;
-	/**
-	 * 多久后算消费视频，单位秒
+	/** {zh}
+	 * @brief 多久后算消费视频，单位秒
 	 *
 	 * @type {number}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	noStallCheckTime?: number;
-	/**
+	/** {zh}
 	 * 算法 方法选择见文档，默认使用31即可，目前31策略卡顿收益很高
 	 *
 	 * @type {number}
 	 * @memberof IAutoBitrateOptsConfig
 	 */
 	method?: number;
-	/**
+	/** {zh}
 	 * 算法模块, CDN方式为window.DashAbralgo
 	 *
 	 * @type {any}
@@ -2314,14 +2679,14 @@ export interface IAutoBitrateOptsConfig {
 	 */
 	module?: any;
 }
-/**
- * @brief 记忆播放配置项
+/** {zh}
+ * @brief 记忆播放配置。
  * @kind property
  * @list Options
  * @interface IMemoryPlayConfig
  */
 export interface IMemoryPlayConfig {
-	/**
+	/** {zh}
 	 * @brief 存储标识id
 	 * @default options.vid || options.url
 	 *
@@ -2329,57 +2694,68 @@ export interface IMemoryPlayConfig {
 	 * @memberof IMemoryPlayConfig
 	 */
 	memoryId: number | string;
-	/**
+	/** {zh}
 	 * @brief 设置时间函数
 	 * @default -
 	 *
 	 * @type {(id: number | string, time: number) => unknown}
 	 * @memberof IMemoryPlayConfig
 	 */
-	saveTime: (id: number | string, time: number) => unknown;
-	/**
+	saveTime?: (id: number | string, time: number) => unknown;
+	/** {zh}
 	 * @brief 获取最后一次播放时间函数
 	 * @default -
 	 */
-	getTime: (id: number | string) => number | Promise<number>;
+	getTime?: (id: number | string) => number | Promise<number>;
+	/** {zh}
+	 * @brief 判断是否播放了最小时间阈值，即如果播的时长太小，则不算做播放过，存储的时间进度为0
+	 * @default 1
+	 */
+	minStartTime?: number;
+	/** {zh}
+	 * @brief 判断是否播放结束的最小时间阈值，即距离结束多少时间内算作播放结束，播放结束则不存储时间进度,且清空之前的进度为0
+	 * @default 1
+	 */
+	minEndTime?: number;
 }
-/**
+/** {zh}
  * @brief 插件按钮位置
  */
 export declare const enum POSITIONS {
-	/**
+	/** {zh}
 	 * @brief 播放器根节点
 	 */
 	ROOT = "root",
-	/**
+	/** {zh}
 	 * @brief 播放器根节点左侧
 	 */
 	ROOT_LEFT = "rootLeft",
-	/**
+	/** {zh}
 	 * @brief 播放器根节点右侧
 	 */
 	ROOT_RIGHT = "rootRight",
-	/**
+	/** {zh}
 	 * @brief 播放器根节点顶部
 	 */
 	ROOT_TOP = "rootTop",
-	/**
+	/** {zh}
 	 * @brief 播控栏左侧
 	 */
 	CONTROLS_LEFT = "controlsLeft",
-	/**
+	/** {zh}
 	 * @brief 播控栏左侧
 	 */
 	CONTROLS_RIGTH = "controlsRight",
-	/**
+	/** {zh}
 	 * @brief 播控栏右侧
 	 */
 	CONTROLS_RIGHT = "controlsRight",
-	/**
+	/** {zh}
 	 * @brief 播控栏中间
 	 */
 	CONTROLS_CENTER = "controlsCenter",
-	/** @hidden
+	/** {zh}
+	 * @hidden
 	 * @brief 播控栏左侧
 	 */
 	CONTROLS = "controls"
@@ -2388,162 +2764,168 @@ export interface IIconPluginConfig {
 	position?: POSITIONS;
 	index?: number;
 }
-/**
- * @brief 画中画配置项
+/** {zh}
+ * @brief 画中画配置。
  * @list Options
  * @kind property
  */
 export interface IPIPConfig extends IIconPluginConfig {
 	/** {zh}
-	 * @brief 是否显示画中画按钮
-	 *  - `true`：是，显示
-	 *  - `false`：否，不显示
-	 *  @default `false`
+	 * @brief 是否显示画中画按钮。取值如下：
+	 *        - `true`：显示画中画按钮。
+	 *        - `false`：不显示画中画按钮。
+	 * @default false
 	 */
 	showIcon?: boolean;
 	/** {zh}
-	 * @brief 是否优先采用文档画中画，仅浏览器支持 DocumentPictureInPicture 才生效
+	 * @brief 是否优先使用[网页画中画](https://developer.mozilla.org/en-US/docs/Web/API/DocumentPictureInPicture)。
 	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentPictureInPicture DocumentPictureInPicture}
 	 *  - `true`：是，优先使用文档画中画
 	 *  - `false`：否
-	 *  @default `false`
+	 * @default false
+	 * @listtip 仅浏览器支持 `DocumentPictureInPicture` 时才生效。
 	 */
 	preferDocument?: boolean;
 	/** {zh}
-	 * @brief 文档画中画窗口的宽度
+	 * @brief 网页画中画模式下窗口的宽度。
 	 * @default -
 	 */
 	width?: number;
 	/** {zh}
-	 * @brief 文档画中画窗口的高度
+	 * @brief 网页画中画模式下窗口的高度。
 	 * @default -
 	 */
 	height?: number;
 	/** {zh}
-	 * @brief 文档画中画窗口的根节点
+	 * @brief 网页画中画模式下窗口的根节点。
 	 * @default -
 	 */
 	docPiPNode?: HTMLElement;
 	/** {zh}
-	 * @brief 文档画中画窗口的css style
+	 * @brief 文档画中画窗口的 css style
 	 * @default -
 	 */
 	docPiPStyle?: ((...arg: any) => string) | string;
 }
-/**
- * @brief 全屏配置
+/** {zh}
+ * @brief 全屏配置。
  * @list Options
  * @kind property
  */
 export interface IFullscreenConfig {
 	/** {zh}
-	 * @brief 是否使用页面全屏代替全屏功能。取值如下：
-	 - `true`：页面全屏；
-	 - `false`：系统全屏。
-	 * @default `false`
+	 * @brief 是否使用页面全屏代替系统全屏。取值如下：
+	 *        - `true`：页面全屏。
+	 *        - `false`：系统全屏。
+	 * @default false
 	 */
 	useCssFullscreen?: boolean;
 	/** {zh}
 	 * @brief 是否使用旋转横屏。取值如下：
-	 * - `false`：否。
-	 * - `true`：是，即全屏将会在竖屏状态下把 dom 旋转 90 度实现横屏效果。
-	 * @default `false`
+	 *        - `false`：否。
+	 *        - `true`：是，即全屏后，如在竖屏状态下，播放器会把 `dom` 旋转 90 度实现横屏效果。
+	 * @default false
 	 * @notice
 	 * - 该配置优先于 `useCssFullscreen` 配置。
 	 * - 该配置一般在移动端使用。
+	 * @listtip - 该参数的优先级高于 `useCssFullscreen` 参数。
+	 *          - 该参数一般用于移动端。
 	 */
 	rotateFullscreen?: boolean;
 	/** {zh}
-	 * @brief 自定义全屏作用的dom，默认是播放器根节点, 该配置项必须是player.root的父辈节点，使用场景是解决全屏下和player.root同级的dom需要显示的场景
+	 * @brief 自定义全屏功能的 `dom`。默认是播放器根节点。该参数必须是 `player.root` 的父辈节点，适用于解决全屏时和 `player.root` 同级的 `dom`需要显示的场景。
 	 * @default `null`
 	 */
 	target?: HTMLElement;
 	/** {zh}
-	 * @brief 是否禁用全凭按钮功能，禁用后不渲染全屏按钮
-	 * - `true`：禁用；
-	 * - `false`：不禁用。
-	 * @default `false`
+	 * @brief 是否禁用全屏按钮。
+	 *        - `true`：禁用。不渲染全屏按钮。
+	 *        - `false`：不禁用。
+	 * @default false
 	 */
 	disable?: boolean;
 	/** {zh}
-	 * @brief 全屏的时候是否使用右上角返回按钮
-	 * - `true`：显示；
-	 * - `false`：不显示。
-	 * @default `false`
+	 * @brief 全屏的时候是否显示右上角返回按钮。取值如下：
+	 *
+	 *        - `false`：不显示右上角返回按钮。
+	 *        - `true`：显示右上角返回按钮。
+	 * @default false
 	 * @notice 该配置一般在移动端开启
+	 * @listtip 此参数一般用于移动端。
 	 */
 	needBackIcon?: boolean;
 	/** {zh}
-	 * @brief 全屏切换自定义实现，该函数配置相当于完全替代插件内部的切换逻辑
+	 * @brief 全屏切换自定义实现。该函数配置相当于完全替代插件内部的切换逻辑。
 	 * @default `null`
 	 */
 	switchCallback?: (...arg: any) => any;
 }
-/**
+/** {zh}
  * @list Options
  * @kind property
+ * @brief 播放器关键点样式。
  */
 export interface ICommonStyle {
 	/** {zh}
-	 * @brief 进度条底色
+	 * @brief 进度条底色。
 	 * @default 无
 	 */
 	progressColor?: string;
 	/** {zh}
-	 * @brief 播放完成部分进度条底色
+	 * @brief 播放完成部分进度条底色。
 	 * @default 无
 	 */
 	playedColor?: string;
 	/** {zh}
-	 * @brief 缓存部分进度条底色
+	 * @brief 缓存部分进度条底色。
 	 * @default 无
 	 */
 	cachedColor?: string;
 	/** {zh}
-	 * @brief 进度条滑块样式
+	 * @brief 进度条滑块样式。
 	 * @default 无
 	 */
 	sliderBtnStyle?: CSSStyleDeclaration;
 	/** {zh}
-	 * @brief 音量颜色
+	 * @brief 音量颜色。
 	 * @default 无
 	 */
 	volumeColor?: string;
 }
-/**
+/** {zh}
  * @list Options
  * @brief 封面配置
  * @kind property
  */
 export interface IPoster {
 	/** {zh}
-	 * @brief 封面图地址
+	 * @brief 封面图 URL 地址。
 	 * @default -
 	 */
 	poster: string;
-	/**
-	 * @brief 是否在播放结束之后显示
-	 * @default `true`
+	/** {zh}
+	 * @brief 是否在播放结束之后显示封面图。
+	 * @default true
 	 */
 	isEndedShow?: boolean;
-	/**
-	 * @brief 是否播放后隐藏
-	 * - `true`：播放后才隐藏，在视频地址更新后会重新显示poster
-	 * - `false`：在play事件触发后隐藏poster
-	 * @default `false`
+	/** {zh}
+	 * @brief 是否播放后隐藏封面图。
+	 *        - `true`：播放后隐藏，在视频地址更新后会重新显示封面图。
+	 *        - `false`：在 `play` 事件触发后隐藏封面图。
+	 * @default false
 	 */
 	hideCanplay?: boolean;
-	/**
-	 * @brief 是否一直显示
-	 * @default `false`
+	/** {zh}
+	 * @brief 是否一直显示封面图。
+	 * @default false
 	 */
 	notHidden?: boolean;
-	/**
-	 * @brief 封面图填充方式
-	 * - `fixWidth`：宽度方向填充，不会被拉伸压缩
-	 * - `fixHeight`：高度方向完全填充，不会被拉伸压缩
-	 * - `cover`：方式完全覆盖容器，多余但部分会被裁剪
-	 * - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩
+	/** {zh}
+	 * @brief 封面图填充方式。取值如下：
+	 *        - `fixWidth`：宽度方向填充，不会被拉伸压缩。
+	 *        - `fixHeight`：高度方向填充，不会被拉伸压缩。
+	 *        - `cover`：完全覆盖容器，多余部分会被裁剪。
+	 *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
 	 */
 	fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
 }
@@ -2795,41 +3177,41 @@ export declare type PlayerCore = Player & {
 	vodLogger?: VodLogger;
 };
 declare class VePlayer {
-	/**
+	/** {zh}
 	 * @brief 播放相关配置数据
 	 * @hidden
 	 * @type {PlayerData}
 	 * @memberof VePlayer
 	 */
 	playerData: PlayerData;
-	/**
-	 * @brief 播放器内核实例, 详情参考{@link https://www.volcengine.com/docs/4/109909#%E6%92%AD%E6%94%BE%E5%99%A8%E5%86%85%E6%A0%B8 播放内核}
+	/** {zh}
+	 * @brief 播放器内核实例，详情参考{@link https://www.volcengine.com/docs/4/1249083 播放器内核}。
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
 	player: PlayerCore;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
 	mountingDom: any;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
 	playerContainer: any;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
 	mobilePanel: any;
-	/**
+	/** {zh}
 	 *
 	 * @private
 	 * @type {*}
@@ -2915,7 +3297,9 @@ declare class VePlayer {
 	 */
 	static veStrategy: typeof VeStrategy;
 	/**
-	 * @brief sdk版本
+	 * @brief SDK 版本
+	 * @type {*}
+	 * @memberof VePlayer
 	 */
 	static sdkVersion: string;
 	/**
@@ -2927,9 +3311,9 @@ declare class VePlayer {
 		targetProfileLevel?: string;
 	}) => Promise<boolean>;
 	private vodLogCommon;
-	/**
-	 * @brief 构造函数
-	 * @param configs sdk配置
+	/** {zh}
+	 * @brief 构造函数。
+	 * @param configs 播放器实例化配置。
 	 */
 	constructor(configs: IPlayerConfig);
 	/**
@@ -2987,59 +3371,55 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	getUrlTimestamp(url: string): void;
-	/**
-	 * @brief  监听sdk事件
-	 *
-	 * @param action 监听的事件名
-	 * @param {(...args: any[]) => void} func
+	/** {zh}
+	 * @brief 监听事件。
 	 * @memberof VePlayer
+	 * @param action 事件名。
+	 * @param func 回调函数。
 	 */
 	on(action: string, func: (...args: any[]) => void): void;
-	/**
-	 * @brief  触发sdk事件
-	 *
-	 * @param {string} action 监听的事件名
-	 * @param {*} [payload]
+	/** {zh}
+	 * @brief 触发事件。
 	 * @memberof VePlayer
+	 * @param action 事件名。
+	 * @param payload 事件数据。
 	 */
 	emit(action: string, payload?: any): void;
-	/**
-	 * 监听sdk事件，事件处理函数只执行一次
-	 *
-	 * @param {string} action
-	 * @param {(...args: any[]) => void} func
+	/** {zh}
 	 * @memberof VePlayer
+	 * @brief 监听事件。事件处理函数只执行一次。
+	 * @param action 事件名。
+	 * @param func 回调函数。
 	 */
 	once(action: string, func: (...args: any[]) => void): void;
-	/**
-	 * 解绑事件监听
-	 *
-	 * @param {string} action
-	 * @param {(...args: any[]) => void} func
+	/** {zh}
 	 * @memberof VePlayer
+	 * @brief 解绑事件监听。
+	 * @param action 事件名。
+	 * @param func 回调函数。
 	 */
 	off(action: string, func: (...args: any[]) => void): void;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @memberof VePlayer
 	 */
 	renderDom(): void;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	renderPoster(): void;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	createPlayer(): Promise<PlayerCore>;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @param {IPlayerConfig} finalOptions
@@ -3047,14 +3427,14 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	setPluginConfig(finalOptions: IPlayerConfig): void;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @param {string} url 地址
 	 * @memberof VePlayer
 	 */
 	detectCodec(url: string): Promise<void>;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @param {*} options
@@ -3062,7 +3442,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	setDefaultConfigOptions(options: any): void;
-	/**
+	/** {zh}
 	 * @brief 获取当前播放视频数据
 	 * @hidden
 	 * @return {any}
@@ -3131,32 +3511,32 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _bindPlayerEvents;
-	/**
+	/** {zh}
 	 * @private
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	private onMediaExpiredAction;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @memberof VePlayer
 	 */
 	private onTokenExpiredAction;
-	/**
+	/** {zh}
 	 *
 	 *
 	 * @private
 	 * @memberof VePlayer
 	 */
 	private _bindSdkEvents;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @memberof VePlayer
 	 */
 	private _mountingExtendMethods;
-	/**
+	/** {zh}
 	 *
 	 *
 	 * @private
@@ -3164,17 +3544,15 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _offPlayerEvents;
-	/**
-	 * @hidden
-	 * 切换插件展示
-	 *
-	 * @param {*} pluginName
-	 * @param {*} IsShow
+	/** {zh}
+	 * @hidden 切换插件展示
 	 * @return {*}
 	 * @memberof VePlayer
+	 * @param {*} pluginName
+	 * @param {*} IsShow
 	 */
 	changePluginsIcon(pluginName: any, IsShow: any): void;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @brief  对外提供获取SDK插件实例的方法
@@ -3183,79 +3561,78 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	getSdkPlugin(name: any): any;
-	/**
-	 * @brief  更换playAuthToken的方法
-	 * @notes 这里指同一个视频切换视频源，不能用来切换不同类型的视频
-	 * @param { IPlayAuthTokenConfig } config authToken配置
-	 * @param { boolean } isNewVideo 是否是新视频，默认true。若未false即表示同一个视频切换token播放，会在切换前时间点继续播放
+	/** {zh}
+	 * @brief 播放时更换 `playAuthToken`，以更换视频源。
 	 * @memberof VePlayer
+	 * @param config `playAuthToken` 配置。
+	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	switchAuthToken(config: IPlayAuthTokenConfig, isNewVideo?: boolean): Promise<void>;
-	/**
-	 * @brief  更新playAuthToken的方法，用来更新视频地址
-	 * @param { IPlayAuthTokenConfig } config playAuthToken配置
+	/** {zh}
+	 * @brief 更新 `playAuthToken`。
 	 * @memberof VePlayer
+	 * @notes 播放前 `playAuthToken` 过期（收到 `play_auth_token_expired` 事件或者 `onTokenExpired` 回调触发）时，调用此方法更新 `playAuthToken`。
+	 * @param config `playAuthToken` 配置。
 	 */
 	updateAuthToken(config: IPlayAuthTokenConfig): Promise<void>;
-	/**
-	 * @brief  返回当前视频的地址
+	/** {zh}
+	 * @brief 返回当前视频的地址
 	 * @memberof VePlayer
 	 */
 	get src(): any;
-	/**
-	 * @brief  设置当前视频的地址
+	/** {zh}
+	 * @brief 设置当前视频的地址
 	 * @notes 会重新拉取新的视频，从0开始起播
 	 * @memberof VePlayer
 	 */
 	set src(url: any);
-	/**
-	 * 切换视频url
-	 * @param {string} url 同一个视频，更新视频地址
-	 * @notes 切换后从切换前的时间点继续播放
+	/** {zh}
+	 * @notes 更换后，会从更换前的时间点继续播放。
 	 * @return {Promise<void>}
 	 * @memberof VePlayer
+	 * @brief 播放时更换视频 URL，以更换视频源。
+	 * @param url 视频播放地址。
 	 */
 	switchURL(url: string): Promise<void>;
-	/**
-	 * 重建播放下一个
-	 *
-	 * @param {playerConfig} config
-	 * @param { boolean } isNewVideo 是否是新视频，默认true。若为false即表示同一个视频切换token播放，会在切换前时间点继续播放
+	/** {zh}
 	 * @memberof VePlayer
+	 * @brief 针对不同格式的视频，重建播放器内核播放下一个视频。
+	 * @hidden
+	 * @param config 播放器配置。
+	 * @param isNewVideo 是否为新视频，默认为 `true`。为 `false` 时表示是同一个视频更换 token。更换后，会从更换前的时间点继续播放。
 	 */
 	next(config: IPlayerConfig, isNewVideo?: boolean): Promise<void>;
-	/**
-	 * 切换视频源
-	 *
-	 * @param {IPlayerConfig} config
-	 * @param { boolean } isNewVideo 是否是新视频，默认true。若为false即表示同一个视频切换地址播放，会在切换前的时间点继续播放
-	 * @brief  默认切换后是暂停状态，如果设置了自动播放，则会自动播放
+	/** {zh}
+	 * @brief 播放下一视频。
 	 * @return{Promise<any>}
 	 * @memberof VePlayer
+	 * @notes 成功更换视频源后，默认是暂停状态，如果设置了自动播放，则会自动播放。
+	 * @param config 播放器实例化配置。
+	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	resetUrlState(url: any): void;
-	/**
-	 * 销毁xgplayer实例
+	/** {zh}
+	 * @brief 销毁xgplayer实例
 	 *
 	 * @private
 	 * @memberof VePlayer
 	 */
 	private _destroyPlayer;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	getPlayerInstance(): PlayerCore;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @return {*}
@@ -3267,152 +3644,153 @@ declare class VePlayer {
 		codecType?: CodecType;
 		plugins?: any[];
 	}>;
-	/**
+	/** {zh}
 	 * @hidden
 	 *
 	 * @brief  获取h265软解播放时的播放列表
 	 * @memberof VePlayer
 	 */
 	setH265SoftPlayList(): void;
-	/**
-	 * 初始化多语言词典
+	/** {zh}
+	 * @brief 初始化多语言词典
 	 *
 	 * @param {*} languages
 	 * @memberof VePlayer
 	 */
 	private _initI18N;
-	/**
-	 * 获取音乐播放模式
+	/** {zh}
+	 * @brief 获取音乐播放模式
 	 * @notes 仅音乐播放模式有效
 	 * @return {PlayModeType}
 	 * @memberof VePlayer
 	 */
 	get musicMode(): PlayModeType;
-	/**
-	 * 设置音乐播放模式
+	/** {zh}
+	 * @brief 设置音乐播放模式
 	 * @notes 仅音乐播放模式有效
 	 * @memberof VePlayer
 	 * @param {PlayModeType} val 模式值
 	 */
 	set musicMode(val: PlayModeType);
-	/**
-	 * 获取音乐播放快进快退时间跨度
+	/** {zh}
+	 * @brief 获取音乐播放快进快退时间跨度
 	 * @notes 仅音乐播放模式有效
 	 * @return {number}
 	 * @memberof VePlayer
 	 */
 	get musicTimeScale(): number;
-	/**
-	 * 设置音乐播放快进快退时间跨度
+	/** {zh}
+	 * @brief 设置音乐播放快进快退时间跨度
 	 * @notes 仅音乐播放模式有效
 	 * @param {number} scale 时间跨度
 	 * @memberof VePlayer
 	 */
 	set musicTimeScale(scale: number);
-	/**
-	 * 获取音乐播放列表
+	/** {zh}
+	 * @brief 获取音乐播放列表
 	 * @notes 仅音乐播放模式有效
 	 * @return {IMusicListItem[]}
 	 * @memberof VePlayer
 	 */
 	get musicList(): IMusicListItem[];
-	/**
-	 * 设置音乐播放列表
+	/** {zh}
+	 * @brief 设置音乐播放列表
 	 * @notes 仅音乐播放模式有效
 	 * @param {IMusicListItem[]} list 播放列表
 	 * @memberof VePlayer
 	 */
 	set musicList(list: IMusicListItem[]);
-	/**
-	 * 向播放列表中加入歌曲
-	 * @notes 仅音乐播放模式有效
-	 * @param {IMusicListItem} meta 歌曲信息
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 向播放列表中加入歌曲。
+	 * @param meta 歌曲信息。
 	 */
 	musicAdd(meta: IMusicListItem): void;
-	/**
-	 * 随机获取播放列表中某一首歌曲
-	 * @notes 仅音乐播放模式有效
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @return {IMusicListItem} 歌曲信息
 	 * @memberof VePlayer
+	 * @brief 随机获取播放列表中的一首歌曲。
 	 */
 	musicRandom(): IMusicListItem;
-	/**
+	/** {zh}
 	 * 播放播放列表的下一首歌曲
-	 * @notes 仅音乐播放模式有效
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 播放播放列表中的下一首歌曲。
 	 */
 	musicNext(): void;
-	/**
+	/** {zh}
 	 * 播放播放列表的上一首歌曲
-	 * @notes 仅音乐播放模式有效
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 播放播放列表中的上一首歌曲。
 	 */
 	musicPrev(): void;
-	/**
-	 * 播放播放列表的第n首歌曲
-	 * @notes 仅音乐播放模式有效
-	 * @param {number} index 播放列表中的序号
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 播放播放列表中的指定歌曲。
+	 * @param index 播放列表中的序号。
 	 */
 	musicSetIndex(index: number): void;
-	/**
-	 * 歌曲快进
-	 * @notes 仅音乐播放模式有效
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 歌曲快进。
 	 */
 	musicForward(): void;
-	/**
-	 * 歌曲后退
-	 * @notes 仅音乐播放模式有效
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 歌曲后退。
 	 */
 	musicBackward(): void;
-	/**
-	 * 从播放列表移除指定歌曲
-	 * @notes 仅音乐播放模式有效
-	 * @param {string | number} vid 歌曲vid
+	/** {zh}
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
 	 * @memberof VePlayer
+	 * @brief 移除播放列表中的指定歌曲。
+	 * @param vid 待移除歌曲的 `vid`。
 	 */
 	musicRemove(vid: string | number): void;
-	/**
-	 * 设置ab循环
-	 * @param { number | IABCycle } start
-	 * @param { number } [end]
-	 * @param { boolean } [loop]
-	 * @param {{ [propName: string]: any }} [ext]
+	/** {zh}
 	 * @memberof VePlayer
+	 * @notes 仅音乐播放模式开启时（`isMusic` 为 `true` 时）有效。
+	 * @brief 设置 AB 循环，即设置播放区域任意位置循环播放。
+	 * @param start AB 循环段起始位置，单位为秒。
+	 * @param end AB 循环段结束位置，单位为秒。
+	 * @param loop 是否循环播放。
 	 */
 	musicSetAbCycle(start: number | IABCycle, end?: number, loop?: boolean, ext?: {
 		[propName: string]: any;
 	}): void;
-	/**
-	 * 移除ab循环
+	/** {zh}
 	 * @memberof VePlayer
+	 * @brief 移除 AB 循环。
 	 */
 	musicRemoveAbCycle(): void;
-	/**
-	 * 获取质量日志上报的用户id
+	/** {zh}
 	 * @return {string | undefined}
 	 * @memberof VePlayer
+	 * @notes 获取用户 ID 后，您可进入视频点播控制台[单点追查](https://console.volcengine.com/vod/quality_control/SingleTracing/?Tab=play)页面，根据用户 ID 查询该用户的播放日志。
+	 * @brief 获取质量日志上报的用户 ID。
 	 */
 	getLogUserId(): string;
-	/**
-	 * 获取当前配置的region
+	/** {zh}
+	 * @brief 获取当前配置的 region
 	 * @return {TRegionType}
 	 * @memberof VePlayer
 	 */
 	get region(): TRegionType;
-	/**
-	 * @brief 获取当前播放器内核的插件实例
-	 * @param { string } pluginName 插件名
-	 * @return { null | BasePlugin } plugin
+	/** {zh}
+	 * @brief 获取插件实例。
+	 * @param pluginName 插件名。
 	 */
 	getPlugin(pluginName: string): null | BasePlugin;
-	/**
-	 * 销毁当前播放器SDK实例
-	 *
+	/** {zh}
 	 * @memberof VePlayer
+	 * @brief 销毁当前播放器实例。
 	 */
 	destroy(): Promise<void>;
 }
@@ -3914,11 +4292,7 @@ declare class ToastPlugin extends Plugin {
 }
 export declare class MemoryPlay extends Plugin {
 	static get pluginName(): string;
-	static get defaultConfig(): {
-		getTime: any;
-		saveTime: any;
-		memoryId: string;
-	};
+	static get defaultConfig(): IMemoryPlayConfig;
 	startTime: number;
 	saveTimeFun: (id: number | string, time: number) => unknown;
 	getTimeFun: (id: number | string) => number | Promise<number>;
@@ -3938,12 +4312,14 @@ export declare class MemoryPlay extends Plugin {
 	};
 	afterCreate(): void;
 	beforePlayerInit(): Promise<void>;
-	destroy(): void;
 	getTime(): Promise<void>;
+	saveTime(): void;
+	visibilitychangeCallback(): void;
 	setSave(): void;
 	showToast(): void;
-	saveTimeByStorage(memoryId: any, time: any): void;
-	getTimeByStorage(memoryId: any): string;
+	saveTimeByStorage(memoryId: string, time: number): void;
+	getTimeByStorage(memoryId: string): string;
+	destroy(): void;
 }
 export declare type InfoItem = {
 	key: string;
@@ -4079,210 +4455,210 @@ export declare class SdkPlugin {
 	__destroy(): void;
 }
 export declare const Events: {
-	/**
-	 * 弹幕配置发生变化
+	/** {zh}
+	 * @brief 弹幕配置发生变化。
 	 */
 	DANMU_CHANGE: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	TIME_SHIFT_CHANGE: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	AI_SUBTITLE_LANG_CHANGE: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	AI_SUBTITLE_MATCH: string;
-	/**
-	 * 取消静音
+	/** {zh}
+	 * @brief 取消静音。
 	 */
 	CANCEL_UNMUTE: string;
-	/**
-	 * 刷新按钮点击
+	/** {zh}
+	 * @brief 刷新按钮被点击。
 	 */
 	REFRESH_CLICK: string;
-	/**
-	 * 报错时触发降级
+	/** {zh}
+	 * @brief 报错时触发降级。
 	 */
 	PLAY_BACKUP_CHANGE: string;
-	/**
-	 * 报错时触发所有降级结束
+	/** {zh}
+	 * @brief 报错时触发的降级结束。
 	 */
 	PLAY_BACKUP_CHANGE_FINISH: string;
-	/**
-	 * 报错时触发重试
+	/** {zh}
+	 * @brief 报错时触发重试。
 	 */
 	PLAY_ERROR_BUTTON_CLICK: string;
-	/**
-	 * 播放url改变
+	/** {zh}
+	 * @brief 播放 URL 改变。
 	 */
 	PlAY_URL_CHANGE: string;
-	/**
-	 * 展示报错
+	/** {zh}
+	 * @brief 展示报错。
 	 */
 	SHOW_PLAY_ERROR: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	PLAYER_EXTEND_BUTTON: string;
-	/**
-	 * 长时间waiting
+	/** {zh}
+	 * @brief 长时间等待。
 	 */
 	LONG_WAITING: string;
-	/**
-	 * 频繁waiting
+	/** {zh}
+	 * @brief 频繁等待。
 	 */
 	OFTEN_WAITING: string;
-	/**
-	 * 清晰度降级
+	/** {zh}
+	 * @brief 清晰度降级。
 	 */
 	DEFINITION_DEMOTE: string;
-	/**
-	 *@hidden
+	/** {zh}
+	 * @hidden
 	 */
 	LARKWINDOW_CHANGE: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 */
 	PANEL_MODE_CHANGE: string;
-	/**
-	 * 清晰度切换
+	/** {zh}
+	 * @brief 清晰度切换。
 	 */
 	INNER_DEFINITION_CHANGE: string;
-	/**
-	 * 线路切换
+	/** {zh}
+	 * @brief 线路切换。
 	 */
 	LINE_CHANGE: string;
-	/**
-	 * playAuthToken获取url失败
+	/** {zh}
+	 * @brief `playAuthToken` 获取 URL 失败。
 	 */
 	GET_PLAY_URL_ERR: string;
-	/**
-	 * 资源过期
+	/** {zh}
+	 * @brief 资源过期。
 	 */
 	MEDIA_EXPIRED: string;
-	/**
-	 * 开启镜像
+	/** {zh}
+	 * @brief 镜像开启。
 	 */
 	MIRROR_CHANGE: string;
-	/**
-	 * 音乐播放器快进快退跨度
+	/** {zh}
+	 * @brief 音乐播放器快进或快退。
 	 */
 	TIME_SCALE_CHANGE: string;
-	/**
-	 * 音乐播放器播放模式改变
+	/** {zh}
+	 * @brief 音乐播放模式切换。
 	 */
 	MUSIC_MODE_CHANGE: string;
-	/**
-	 * 音乐播放器切换音乐
+	/** {zh}
+	 * @brief 音乐播放模式下切换音乐。
 	 */
 	MUSIC_CHANGE: string;
-	/**
-	 * 音乐播放列表发生变化
+	/** {zh}
+	 * @brief 音乐播放列表发生变化。
 	 */
 	MUSIC_LIST_CHANGE: string;
-	/**
-	 * 自动播放成功
+	/** {zh}
+	 * @brief 自动播放成功。
 	 */
 	AUTOPLAY_SUCCESS: string;
-	/**
-	 * 自动播放失败
+	/** {zh}
+	 * @brief 自动播放失败。
 	 */
 	AUTOPLAY_FAILED: string;
-	/**
-	 * 右键菜单事件，事件data中包含具体信息
+	/** {zh}
+	 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
 	 */
 	MENU_LOG: string;
-	/**
-	 * 点击了右键菜单的反馈按钮
+	/** {zh}
+	 * @brief 点击了右键菜单的反馈按钮。
 	 */
 	MENU_REPORT: string;
-	/**
-	 * 播放列表更新
+	/** {zh}
+	 * @brief 播放列表更新。
 	 */
 	PLAY_LIST_CHANGE: string;
-	/**
-	 * 播放列表播放项变更
+	/** {zh}
+	 * @brief 播放列表播放项变更。
 	 */
 	PLAY_LIST_ITEM_CHANGE: string;
 	/** {zh}
-	 * 播放器完成实例化
+	 * @brief 播放器实例创建完成时触发。
 	 */
 	/** {en}
-	 * The player is instantiated.
+	 * @brief The player is instantiated.
 	 */
 	READY: string;
 	/** {zh}
-	 * 播放器创建video完成，可以开始播放
+	 * @brief 播放器创建 `video` 完成时触发，表示可以开始播放。
 	 */
 	/** {en}
-	 * The player has created the video and the playback is ready to start.
+	 * @brief The player has created the video and the playback is ready to start.
 	 */
 	COMPLETE: string;
 	/** {zh}
-	 * 播放资源发生变化
+	 * @brief 播放资源发生变化。
 	 */
 	/** {en}
-	 * The playback address changes.
+	 * @brief The playback address changes.
 	 */
 	URL_CHANGE: string;
 	/** {zh}
-	 * 播放器聚焦
+	 * @brief 播放器聚焦。
 	 */
 	/** {en}
-	 * The player has focus.
+	 * @brief The player has focus.
 	 */
 	PLAYER_FOCUS: string;
 	/** {zh}
-	 * 播放器失焦
+	 * @brief 播放器失焦。
 	 */
 	/** {en}
-	 * The player loses focus.
+	 * @brief The player loses focus.
 	 */
 	PLAYER_BLUR: string;
 	/** {zh}
-	 * 系统全屏状态切换
+	 * @brief 系统全屏状态切换。
 	 */
 	/** {en}
-	 * The player switches to or from full-window mode, in which the player covers the entire desktop.
+	 * @brief The player switches to or from full-window mode, in which the player covers the entire desktop.
 	 */
 	FULLSCREEN_CHANGE: string;
 	/** {zh}
-	 * 网页样式全屏状态切换
+	 * @brief 网页全屏状态切换。
 	 */
 	/** {en}
-	 * The player switches to or from full-screen mode, in which the player covers the browser window.
+	 * @brief The player switches to or from full-screen mode, in which the player covers the browser window.
 	 */
 	CSS_FULLSCREEN_CHANGE: string;
-	/**
-	 * @brief 画中画播放模式切换
+	/** {zh}
+	 * @brief 画中画模式切换。
 	 */
 	MINI_STATE_CHANGE: string;
 	/** {zh}
-	 * 播放器销毁
+	 * @brief 播放器销毁。
 	 */
 	/** {en}
-	 * The player is destroyed.
+	 * @brief The player is destroyed.
 	 */
 	DESTROY: string;
 	/** {zh}
-	 * 播放器重新播放
+	 * @brief 播放器重新播放。
 	 */
 	/** {en}
-	 * Replay starts.
+	 * @brief Replay starts.
 	 */
 	REPLAY: string;
-	/**
-	 * @brief 重试
+	/** {zh}
+	 * @brief 播放器重试。
 	 */
 	RETRY: string;
 	/** {zh}
-	 * 清晰度发生变化
+	 * @brief 清晰度发生变化
 	 */
 	/** {en}
-	 * The video resolution changes.
+	 * @brief The video resolution changes.
 	 */
 	DEFINITION_CHANGE: string;
 	/** {zh}
@@ -4300,274 +4676,273 @@ export declare const Events: {
 	 */
 	AFTER_DEFINITION_CHANGE: string;
 	/** {zh}
-	 * 播放器容器尺寸发生变化
+	 * @brief 播放器容器尺寸发生变化。
 	 */
 	/** {en}
-	 * The size of the player container changes.
+	 * @brief The size of the player container changes.
 	 */
 	VIDEO_RESIZE: string;
 	/** {zh}
-	 * 画中画状态切换
+	 * @brief 画中画状态切换。
 	 */
 	/** {en}
-	 * The player switches to or from Picture-in-Picture (PIP) mode.
+	 * @brief The player switches to or from Picture-in-Picture (PIP) mode.
 	 */
 	PIP_CHANGE: string;
 	/** {zh}
-	 * 播放器被旋转
+	 * @brief 播放器发生旋转。
 	 */
 	/** {en}
-	 * The player is rotated.
+	 * @brief The player is rotated.
 	 */
 	ROTATE: string;
 	/** {zh}
-	 * 播放器内置快捷键事件触发
+	 * @brief 播放器内置快捷键事件被触发。
 	 */
 	/** {en}
 	 * A built-in shortcut event occurs within the player.
 	 */
 	SHORTCUT: string;
 	/** {zh}
-	 * SEI 信息解析
+	 * @brief SEI 信息解析。
 	 */
 	/** {en}
-	 * The player parses the SEI information.
+	 * @brief The player parses the SEI information.
 	 */
 	SEI_PARSED: string;
 	/** {zh}
-	 * 内置插件用户行为触发，所有内置插件用户行为交互都会下发该事件，可用于用户行为埋点
+	 * @brief 内置插件用户行为触发。所有内置插件用户行为交互都会下发该事件，可用于用户行为埋点。
 	 */
 	/** {en}
-	 * A user event occurs within a built-in plug-in. This event applies to all built-in plug-ins and can be used for tracking user behaviors.
+	 * @brief A user event occurs within a built-in plug-in. This event applies to all built-in plug-ins and can be used for tracking user behaviors.
 	 */
 	USER_ACTION: string;
 	/** {zh}
-	 * 自动播放成功
+	 * @brief 自动播放成功时触发。
 	 */
 	/** {en}
-	 * Autoplay starts successfully.
+	 * @brief Autoplay starts successfully.
 	 */
 	AUTOPLAY_STARTED: string;
 	/** {zh}
-	 * 自动播放失败
+	 * @brief 自动播放失败时触发。
 	 */
 	/** {en}
-	 * Autoplay fails to start.
+	 * @brief Autoplay fails to start.
 	 */
 	AUTOPLAY_PREVENTED: string;
-	/**
-	 * 播放器完成创建
+	/** {zh}
+	 * @brief 播放器完成创建。
 	 */
 	PLAYER_CREATED_FINISH: string;
-	/**
-	 * 播放器重建
+	/** {zh}
+	 * @brief 播放器重建。
 	 */
 	PLAYER_REBUILD: string;
-	/**
-	 * 硬解不支持
+	/** {zh}
+	 * @brief 硬解不支持时触发。
 	 */
 	NOT_SUPPORT_HARDWARE_DECODER: string;
-	/**
-	 * 软解不支持
+	/** {zh}
+	 * @brief 软解不支持时触发。
 	 */
 	NOT_SUPPORT_SOFT_DECODER: string;
-	/**
-	 * playAuthToken 过期
+	/** {zh}
+	 * @brief `playAuthToken` 过期
 	 */
 	TOKEN_EXPIRED: string;
-	/**
-	 * umd 加载失败
+	/** {zh}
+	 * @brief UMD 加载失败。
 	 */
 	UMD_LOAD_FAIL: string;
-	/**
-	 * @brief 在播放被终止时触发。例如：当播放中的视频重新开始播放。
+	/** {zh}
+	 * @brief 在播放被终止时触发。例如当播放中的视频重新开始播放。
 	 */
 	ABORT: string;
 	/** {zh}
-	 * @brief在媒体数据已经有足够的数据（至少播放数帧）可供播放时触发。
-	 **/
+	 * @brief 视频缓冲足够数据、可以播放时触发。
+	 */
 	CANPLAY: string;
 	/** {zh}
-	 * @brief表明媒体可以在保持当前的下载速度的情况下不被中断地播放完毕。
-	 * @notice 手动设置currentTime会使得firefox触发一次canplaythrough事件，其他浏览器或许不会如此。
+	 * @brief 视频可以流畅播放时触发。
 	 */
 	CANPLAY_THROUGH: string;
 	/** {zh}
-	 * @brief表明媒体的长度发生了改变。例如：在媒体已被加载足够的长度从而得知总长度时会触发这个事件。
+	 * @brief 视频时长发生变化时触发。
 	 */
 	DURATION_CHANGE: string;
-	/**
-	 * @brief 媒体被清空（初始化）时触发
+	/** {zh}
+	 * @brief 媒体被清空（初始化）时触发。
 	 */
 	EMPITED: string;
 	/** {zh}
-	 * 视频播放完毕
+	 * @brief 视频播放完毕时触发。
 	 */
 	/** {en}
-	 * Video playback ends.
+	 * @brief Video playback ends.
 	 */
 	ENDED: string;
 	/** {zh}
-	 * 发生错误
+	 * @brief 发生错误时触发。
 	 */
 	ERROR: string;
 	/** {zh}
-	 * @brief媒体的第一帧已经加载完毕
+	 * @brief 视频起播数据加载完成时触发。
 	 */
 	LOADED_DATA: string;
-	/**
-	 * 媒体的元数据已经加载完毕，playerSdkIns.player.video 可获取所有的video属性
+	/** {zh}
+	 * @brief 媒体的元数据已加载完毕，`playerSdkIns.player.video` 可获取所有的 `video` 属性。
 	 */
 	LOADED_META_DATA: string;
 	/** {zh}
-	 * 媒体内容开始加载
+	 * @brief 媒体内容开始加载时触发。
 	 */
 	LOAD_START: string;
 	/** {zh}
-	 * 视频暂停播放
+	 * @brief 视频暂停播放时触发。
 	 */
 	/** {en}
-	 * Video playback pauses.
+	 * @brief Video playback pauses.
 	 */
 	PAUSE: string;
 	/** {zh}
-	 * @brief 视频开始播放
+	 * @brief 视频开始播放时触发。
 	 */
 	/** {en}
 	 * @brief Video playback starts.
 	 */
 	PLAY: string;
 	/** {zh}
-	 * 恢复播放（包括暂停后恢复播放或卡顿后恢复播放）
+	 * @brief 恢复播放时触发，包括暂停后恢复播放或卡顿后恢复播放。
 	 */
 	/** {en}
-	 * Video playback resumes after a pause or freeze.
+	 * @brief Video playback resumes after a pause or freeze.
 	 */
 	PLAYING: string;
-	/**
-	 * 媒体下载进度，即已缓存播放数据进度
+	/** {zh}
+	 * @brief 报告媒体下载进度，即已缓存播放数据进度。
 	 */
 	PROGRESS: string;
-	/**
-	 * 播放速率变化
+	/** {zh}
+	 * @brief 播放速率变化时触发。
 	 */
 	RATE_CHANGE: string;
-	/**
-	 * 在跳跃（seek）操作完成时触发
+	/** {zh}
+	 * @brief Seek 操作完成时触发。
 	 */
 	SEEKED: string;
-	/**
-	 * 在跳跃（seek）操作开始时触发
+	/** {zh}
+	 * @brief Seek 操作开始时触发。
 	 */
 	SEEKING: string;
-	/**
-	 * 在尝试获取媒体数据，但数据不可用时触发。
+	/** {zh}
+	 * @brief 在尝试获取媒体数据、但数据不可用时触发。
 	 */
 	STALLED: string;
-	/**
-	 * 在媒体资源加载终止时触发，这可能是因为下载已完成或因为其他原因暂停。
+	/** {zh}
+	 * @brief 媒体资源加载终止时触发。这可能是因为下载已完成或因为其他原因暂停。
 	 */
 	SUSPEND: string;
 	/** {zh}
-	 * 视频播放时间更新
+	 * @brief 视频播放时间更新时触发。
 	 */
 	/** {en}
-	 * The video playback time is updated.
+	 * @brief The video playback time is updated.
 	 */
 	TIME_UPDATE: string;
 	/** {zh}
-	 * 视频音量发生变化
+	 * @brief 视频音量发生变化时触发。
 	 */
 	/** {en}
-	 * The video volume changes.
+	 * @brief The video volume changes.
 	 */
 	VOLUME_CHANGE: string;
 	/** {zh}
-	 * 等待加载数据
+	 * @brief 等待加载数据时触发。
 	 */
 	/** {en}
-	 * The player is loading data.
+	 * @brief The player is loading data.
 	 */
 	WAITING: string;
 };
 export declare const Event: {
 	SDKEvents: {
 		/** {zh}
-		 * 播放器完成实例化
+		 * @brief 播放器实例创建完成时触发。
 		 */
 		/** {en}
-		 * The player is instantiated.
+		 * @brief The player is instantiated.
 		 */
 		READY: string;
 		/** {zh}
-		 * 播放器创建video完成，可以开始播放
+		 * @brief 播放器创建 `video` 完成时触发，表示可以开始播放。
 		 */
 		/** {en}
-		 * The player has created the video and the playback is ready to start.
+		 * @brief The player has created the video and the playback is ready to start.
 		 */
 		COMPLETE: string;
 		/** {zh}
-		 * 播放资源发生变化
+		 * @brief 播放资源发生变化。
 		 */
 		/** {en}
-		 * The playback address changes.
+		 * @brief The playback address changes.
 		 */
 		URL_CHANGE: string;
 		/** {zh}
-		 * 播放器聚焦
+		 * @brief 播放器聚焦。
 		 */
 		/** {en}
-		 * The player has focus.
+		 * @brief The player has focus.
 		 */
 		PLAYER_FOCUS: string;
 		/** {zh}
-		 * 播放器失焦
+		 * @brief 播放器失焦。
 		 */
 		/** {en}
-		 * The player loses focus.
+		 * @brief The player loses focus.
 		 */
 		PLAYER_BLUR: string;
 		/** {zh}
-		 * 系统全屏状态切换
+		 * @brief 系统全屏状态切换。
 		 */
 		/** {en}
-		 * The player switches to or from full-window mode, in which the player covers the entire desktop.
+		 * @brief The player switches to or from full-window mode, in which the player covers the entire desktop.
 		 */
 		FULLSCREEN_CHANGE: string;
 		/** {zh}
-		 * 网页样式全屏状态切换
+		 * @brief 网页全屏状态切换。
 		 */
 		/** {en}
-		 * The player switches to or from full-screen mode, in which the player covers the browser window.
+		 * @brief The player switches to or from full-screen mode, in which the player covers the browser window.
 		 */
 		CSS_FULLSCREEN_CHANGE: string;
-		/**
-		 * @brief 画中画播放模式切换
+		/** {zh}
+		 * @brief 画中画模式切换。
 		 */
 		MINI_STATE_CHANGE: string;
 		/** {zh}
-		 * 播放器销毁
+		 * @brief 播放器销毁。
 		 */
 		/** {en}
-		 * The player is destroyed.
+		 * @brief The player is destroyed.
 		 */
 		DESTROY: string;
 		/** {zh}
-		 * 播放器重新播放
+		 * @brief 播放器重新播放。
 		 */
 		/** {en}
-		 * Replay starts.
+		 * @brief Replay starts.
 		 */
 		REPLAY: string;
-		/**
-		 * @brief 重试
+		/** {zh}
+		 * @brief 播放器重试。
 		 */
 		RETRY: string;
 		/** {zh}
-		 * 清晰度发生变化
+		 * @brief 清晰度发生变化
 		 */
 		/** {en}
-		 * The video resolution changes.
+		 * @brief The video resolution changes.
 		 */
 		DEFINITION_CHANGE: string;
 		/** {zh}
@@ -4585,213 +4960,213 @@ export declare const Event: {
 		 */
 		AFTER_DEFINITION_CHANGE: string;
 		/** {zh}
-		 * 播放器容器尺寸发生变化
+		 * @brief 播放器容器尺寸发生变化。
 		 */
 		/** {en}
-		 * The size of the player container changes.
+		 * @brief The size of the player container changes.
 		 */
 		VIDEO_RESIZE: string;
 		/** {zh}
-		 * 画中画状态切换
+		 * @brief 画中画状态切换。
 		 */
 		/** {en}
-		 * The player switches to or from Picture-in-Picture (PIP) mode.
+		 * @brief The player switches to or from Picture-in-Picture (PIP) mode.
 		 */
 		PIP_CHANGE: string;
 		/** {zh}
-		 * 播放器被旋转
+		 * @brief 播放器发生旋转。
 		 */
 		/** {en}
-		 * The player is rotated.
+		 * @brief The player is rotated.
 		 */
 		ROTATE: string;
 		/** {zh}
-		 * 播放器内置快捷键事件触发
+		 * @brief 播放器内置快捷键事件被触发。
 		 */
 		/** {en}
 		 * A built-in shortcut event occurs within the player.
 		 */
 		SHORTCUT: string;
 		/** {zh}
-		 * SEI 信息解析
+		 * @brief SEI 信息解析。
 		 */
 		/** {en}
-		 * The player parses the SEI information.
+		 * @brief The player parses the SEI information.
 		 */
 		SEI_PARSED: string;
 		/** {zh}
-		 * 内置插件用户行为触发，所有内置插件用户行为交互都会下发该事件，可用于用户行为埋点
+		 * @brief 内置插件用户行为触发。所有内置插件用户行为交互都会下发该事件，可用于用户行为埋点。
 		 */
 		/** {en}
-		 * A user event occurs within a built-in plug-in. This event applies to all built-in plug-ins and can be used for tracking user behaviors.
+		 * @brief A user event occurs within a built-in plug-in. This event applies to all built-in plug-ins and can be used for tracking user behaviors.
 		 */
 		USER_ACTION: string;
 		/** {zh}
-		 * 自动播放成功
+		 * @brief 自动播放成功时触发。
 		 */
 		/** {en}
-		 * Autoplay starts successfully.
+		 * @brief Autoplay starts successfully.
 		 */
 		AUTOPLAY_STARTED: string;
 		/** {zh}
-		 * 自动播放失败
+		 * @brief 自动播放失败时触发。
 		 */
 		/** {en}
-		 * Autoplay fails to start.
+		 * @brief Autoplay fails to start.
 		 */
 		AUTOPLAY_PREVENTED: string;
-		/**
-		 * 播放器完成创建
+		/** {zh}
+		 * @brief 播放器完成创建。
 		 */
 		PLAYER_CREATED_FINISH: string;
-		/**
-		 * 播放器重建
+		/** {zh}
+		 * @brief 播放器重建。
 		 */
 		PLAYER_REBUILD: string;
-		/**
-		 * 硬解不支持
+		/** {zh}
+		 * @brief 硬解不支持时触发。
 		 */
 		NOT_SUPPORT_HARDWARE_DECODER: string;
-		/**
-		 * 软解不支持
+		/** {zh}
+		 * @brief 软解不支持时触发。
 		 */
 		NOT_SUPPORT_SOFT_DECODER: string;
-		/**
-		 * playAuthToken 过期
+		/** {zh}
+		 * @brief `playAuthToken` 过期
 		 */
 		TOKEN_EXPIRED: string;
-		/**
-		 * umd 加载失败
+		/** {zh}
+		 * @brief UMD 加载失败。
 		 */
 		UMD_LOAD_FAIL: string;
 	};
 	PluginEvents: {
-		/**
-		 * 弹幕配置发生变化
+		/** {zh}
+		 * @brief 弹幕配置发生变化。
 		 */
 		DANMU_CHANGE: string;
-		/**
+		/** {zh}
 		 * @hidden
 		 */
 		TIME_SHIFT_CHANGE: string;
-		/**
+		/** {zh}
 		 * @hidden
 		 */
 		AI_SUBTITLE_LANG_CHANGE: string;
-		/**
+		/** {zh}
 		 * @hidden
 		 */
 		AI_SUBTITLE_MATCH: string;
-		/**
-		 * 取消静音
+		/** {zh}
+		 * @brief 取消静音。
 		 */
 		CANCEL_UNMUTE: string;
-		/**
-		 * 刷新按钮点击
+		/** {zh}
+		 * @brief 刷新按钮被点击。
 		 */
 		REFRESH_CLICK: string;
-		/**
-		 * 报错时触发降级
+		/** {zh}
+		 * @brief 报错时触发降级。
 		 */
 		PLAY_BACKUP_CHANGE: string;
-		/**
-		 * 报错时触发所有降级结束
+		/** {zh}
+		 * @brief 报错时触发的降级结束。
 		 */
 		PLAY_BACKUP_CHANGE_FINISH: string;
-		/**
-		 * 报错时触发重试
+		/** {zh}
+		 * @brief 报错时触发重试。
 		 */
 		PLAY_ERROR_BUTTON_CLICK: string;
-		/**
-		 * 播放url改变
+		/** {zh}
+		 * @brief 播放 URL 改变。
 		 */
 		PlAY_URL_CHANGE: string;
-		/**
-		 * 展示报错
+		/** {zh}
+		 * @brief 展示报错。
 		 */
 		SHOW_PLAY_ERROR: string;
-		/**
+		/** {zh}
 		 * @hidden
 		 */
 		PLAYER_EXTEND_BUTTON: string;
-		/**
-		 * 长时间waiting
+		/** {zh}
+		 * @brief 长时间等待。
 		 */
 		LONG_WAITING: string;
-		/**
-		 * 频繁waiting
+		/** {zh}
+		 * @brief 频繁等待。
 		 */
 		OFTEN_WAITING: string;
-		/**
-		 * 清晰度降级
+		/** {zh}
+		 * @brief 清晰度降级。
 		 */
 		DEFINITION_DEMOTE: string;
-		/**
-		 *@hidden
+		/** {zh}
+		 * @hidden
 		 */
 		LARKWINDOW_CHANGE: string;
-		/**
+		/** {zh}
 		 * @hidden
 		 */
 		PANEL_MODE_CHANGE: string;
-		/**
-		 * 清晰度切换
+		/** {zh}
+		 * @brief 清晰度切换。
 		 */
 		INNER_DEFINITION_CHANGE: string;
-		/**
-		 * 线路切换
+		/** {zh}
+		 * @brief 线路切换。
 		 */
 		LINE_CHANGE: string;
-		/**
-		 * playAuthToken获取url失败
+		/** {zh}
+		 * @brief `playAuthToken` 获取 URL 失败。
 		 */
 		GET_PLAY_URL_ERR: string;
-		/**
-		 * 资源过期
+		/** {zh}
+		 * @brief 资源过期。
 		 */
 		MEDIA_EXPIRED: string;
-		/**
-		 * 开启镜像
+		/** {zh}
+		 * @brief 镜像开启。
 		 */
 		MIRROR_CHANGE: string;
-		/**
-		 * 音乐播放器快进快退跨度
+		/** {zh}
+		 * @brief 音乐播放器快进或快退。
 		 */
 		TIME_SCALE_CHANGE: string;
-		/**
-		 * 音乐播放器播放模式改变
+		/** {zh}
+		 * @brief 音乐播放模式切换。
 		 */
 		MUSIC_MODE_CHANGE: string;
-		/**
-		 * 音乐播放器切换音乐
+		/** {zh}
+		 * @brief 音乐播放模式下切换音乐。
 		 */
 		MUSIC_CHANGE: string;
-		/**
-		 * 音乐播放列表发生变化
+		/** {zh}
+		 * @brief 音乐播放列表发生变化。
 		 */
 		MUSIC_LIST_CHANGE: string;
-		/**
-		 * 自动播放成功
+		/** {zh}
+		 * @brief 自动播放成功。
 		 */
 		AUTOPLAY_SUCCESS: string;
-		/**
-		 * 自动播放失败
+		/** {zh}
+		 * @brief 自动播放失败。
 		 */
 		AUTOPLAY_FAILED: string;
-		/**
-		 * 右键菜单事件，事件data中包含具体信息
+		/** {zh}
+		 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
 		 */
 		MENU_LOG: string;
-		/**
-		 * 点击了右键菜单的反馈按钮
+		/** {zh}
+		 * @brief 点击了右键菜单的反馈按钮。
 		 */
 		MENU_REPORT: string;
-		/**
-		 * 播放列表更新
+		/** {zh}
+		 * @brief 播放列表更新。
 		 */
 		PLAY_LIST_CHANGE: string;
-		/**
-		 * 播放列表播放项变更
+		/** {zh}
+		 * @brief 播放列表播放项变更。
 		 */
 		PLAY_LIST_ITEM_CHANGE: string;
 	};