@volcengine/veplayer 1.8.6-rc.9 → 1.8.7-rc.0

package/index.d.ts

@@ -5,6 +5,7 @@ import { VeStrategyH265Config } from '@volcengine/vestrategy-h265';
 import EventEmitter from 'eventemitter3';
 import Player from 'xgplayer';
 import { BasePlugin, I18N, IXGI18nText, Plugin } from 'xgplayer';
+import { IUrl } from 'xgplayer/es/defaultConfig';
 
 /**
  * @brief 插件按钮位置
@@ -780,53 +781,81 @@ export interface ITextItem {
 /**
  * @brief 清晰度自动降级配置
  * @list Options
- * @hidden
- *
- * @export
- * @interface IDefinitionDemotePlugin
+ * @kind property
  */
 export interface IDefinitionDemotePlugin {
 	/**
-	 * 超时重试次数
-	 * 默认：3
+	 * @brief 是否自动触发降级
+	 * @default true
 	 *
-	 * @type {number}
-	 * @memberof IDefinitionDemotePlugin
 	 */
-	oftenWaitingCount?: number;
+	isNeedAutoDemote?: boolean;
 	/**
-	 * 设置经常超时时间
-	 * 默认：5000
+	 * @brief 降级顺序，按照数组 顺序依次降级，数组 中的元素与playList 中的 definition 相对应
+	 * @default []
 	 *
-	 * @type {number}
+	 * @type {string[]}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	oftenWaitingTime?: number;
+	demotePriority?: string[];
 	/**
-	 * 设置超时时间
-	 * 默认5000
+	 * @brief 长时间卡顿的时间阈值，单位为ms。卡顿超过该值，即为长时间卡顿
+	 * @default 5000
 	 *
-	 * @type {number}
-	 * @memberof IDefinitionDemotePlugin
 	 */
 	longWaitingTime?: number;
 	/**
-	 * 是否自动触发降级
-	 * 默认：false
+	 * @brief 频繁卡顿的次数阈值。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 * @default 3
 	 *
-	 * @type {boolean}
-	 * @memberof IDefinitionDemotePlugin
 	 */
-	isNeedAutoDemote?: boolean;
+	oftenWaitingCount?: number;
 	/**
-	 *
-	 * 降级顺序，按照数组顺序依次降级，数字元素对应playList中的definition
-	 * 默认: ['uhd', 'hd', 'sd', 'ld', 'ao']
-	 *
-	 * @type {string[]}
-	 * @memberof IDefinitionDemotePlugin
+	 * @brief 频繁卡顿的时间范围。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 * @default 5000
 	 */
-	demotePriority?: string[];
+	oftenWaitingTime?: number;
+	/**
+	 * @brief 卡顿时是否显示建议切换清晰度的提醒tips
+	 * @default true
+	 */
+	isNeedShowTips?: boolean;
+	/**
+	 * @brief 提醒降级的toast显示持续时间,单位ms
+	 * @default 3000
+	 */
+	toastShowTime?: number;
+}
+export declare class DefinitionDemotePlugin extends Plugin {
+	static get pluginName(): string;
+	waitings: number[];
+	timer: ReturnType<typeof setTimeout>;
+	toastId: number;
+	longWaitingEmitTime: number;
+	waitingStartTime: number;
+	playerData: PlayerData;
+	static get defaultConfig(): IDefinitionDemotePlugin;
+	constructor(args: any);
+	registerLanguageTexts(): {
+		definition_demote_txt: {
+			jp: string;
+			en: string;
+			zh: string;
+			"zh-hk": string;
+		};
+	};
+	afterCreate(): void;
+	bindCtx(): void;
+	bindEvents(): void;
+	_waiting(): void;
+	_count(): void;
+	_time(): void;
+	_clearTime(): void;
+	clearState(): void;
+	demote(): void;
+	changeUrl(url: string): void;
+	showToast(definition: Stream): void;
+	destroy(): void;
 }
 /**
  * @brief DASH 播放配置。
@@ -840,7 +869,7 @@ export interface IDashPluginConfig {
 	/**
 	 * @brief 视频 ID。
 	 * @default -
-	 * @notice 播放加密视频时必选
+	 * @notes 播放加密视频时必选
 	 */
 	/** {en}
 	 * @brief 视频vid
@@ -1011,7 +1040,7 @@ export interface IVodLogOptsConfig {
 	/**
 	 * @brief 用于识别单一用户的 ID，可在{@link https://www.volcengine.com/docs/4/75736#qoe-%E6%8C%87%E6%A0%87%E8%AF%B4%E6%98%8E QoE指标}中用于用户维度的筛选，也可以用于{@link https://www.volcengine.com/docs/4/106093 单点追查} 查找单用户的播放日志
 	 * 用户 ID 对应于单点追查功能的查询条件中的设备 ID 维度。如不设置用户 ID，VePlayer 将根据用户浏览器随机生成一个值，该值会在浏览器端缓存。
-	 * @notice 强烈建议您使用与业务相关的用户 ID，以便在发生播放错误时通过{@link https://console.volcengine.com/vod/region:vod+cn-north-1/quality_control/SingleTracing/?Tab=play 点播控制台 > 质量平台 > 单点追查}功能排查故障。
+	 * @notes 强烈建议您使用与业务相关的用户 ID，以便在发生播放错误时通过{@link https://console.volcengine.com/vod/region:vod+cn-north-1/quality_control/SingleTracing/?Tab=play 点播控制台 > 质量平台 > 单点追查}功能排查故障。
 	 * @default -
 	 */
 	line_user_id: string | number;
@@ -1023,7 +1052,7 @@ export interface IVodLogOptsConfig {
 	vtype?: "MP4" | "HLS" | "DASH" | "FLV";
 	/**
 	 * @brief 业务标签。对应于质量平台上的业务类型维度，其作用是区分业务中的不同场景，以便进行多维度分析。举例来说，假设您的应用中包含短视频和长视频两个场景，则可分别将 `tag` 设为 `short` 和 `long`。这样一来，您就能够在{@link https://www.volcengine.com/docs/4/120175 质量平台}上通过业务标签维度查询或过滤不同场景的数据。
-	 * @notice 如需自定义配置 tag 值在点播控制台上的展示文案，请联系{@link https://www.volcengine.com/docs/4/108992#%E5%94%AE%E5%90%8E%E6%94%AF%E6%8C%81 技术支持}
+	 * @notes 如需自定义配置 tag 值在点播控制台上的展示文案，请联系{@link https://www.volcengine.com/docs/4/108992#%E5%94%AE%E5%90%8E%E6%94%AF%E6%8C%81 技术支持}
 	 * @default 普通视频
 	 */
 	tag?: string;
@@ -1401,7 +1430,7 @@ export declare const enum TOGGLE_MODES {
  */
 export interface IPlayListItem {
 	/**
-	 * @notice `playAuthToken` 为空时，此参数必传。
+	 * @notes `playAuthToken` 为空时，此参数必传。
 	 * @default -
 	 * @listtip `playAuthToken` 为空时，此参数必传。
 	 * @brief 视频地址。
@@ -1410,7 +1439,7 @@ export interface IPlayListItem {
 	 */
 	url?: string;
 	/**
-	 * @notice `url` 为空时，此参数必传。
+	 * @notes `url` 为空时，此参数必传。
 	 * @default -
 	 * @listtip `url` 为空时，此参数必传。
 	 * @brief 播放临时安全凭证，由业务的 AppServer 签发。
@@ -1483,7 +1512,7 @@ export interface IPlayListConfig {
 	 *        - `rootRight`：播放器根节点右侧
 	 *        - `rootTop`：播放器根节点顶部
 	 *        - `root`：播放器根节点
-	 * @notice 此参数同时影响“打开/关闭播放列表”和“播放下一个”两个按钮的位置。
+	 * @notes 此参数同时影响“打开/关闭播放列表”和“播放下一个”两个按钮的位置。
 	 * @default controlsLeft
 	 */
 	/** {en}
@@ -1631,7 +1660,188 @@ export declare class PlayListPlugin extends Plugin {
 	get disable(): boolean;
 	render(): string;
 }
-export interface IPlayInfoList {
+/**
+ * @brief 动态水印配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief watermark config
+ */
+export interface IWatermarkConfig {
+	/**
+	 * @brief 是否开启水印
+	 * @default false
+	 */
+	enable: boolean;
+	/**
+	 * @brief 水印文案内容
+	 * @default -
+	 */
+	content: string;
+	/**
+	 * @brief 水印展示形式
+	 * - 0: 固定位置
+	 * - 1: 全屏滚动
+	 * - 2: 随机闪烁
+	 * @default 1
+	 */
+	displayType: 0 | 1 | 2;
+	/**
+	 * @brief 水印字体大小，number类型时单位为px，string类型需要携带单位
+	 * @default 12
+	 */
+	fontSize: number | string;
+	/**
+	 * @brief 水印字体颜色
+	 * @brief #FFFFFF
+	 */
+	fontColor: string;
+	/**
+	 * @brief 不透明度
+	 * @default 0.3
+	 */
+	opacity: number;
+	/**
+	 * @brief 水印闪烁速度
+	 * @default MODERATE
+	 * - MODERATE: 适中
+	 * - FAST: 较快
+	 * - SLOW: 较慢
+	 */
+	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
+	/**
+	 * @brief 水印字体类型
+	 * @default -
+	 */
+	fontFamily?: string;
+	/**
+	 * @brief 水印相对于播放容器顶部起始位置，单位px
+	 * @default 0
+	 */
+	top?: number;
+	/**
+	 * @brief 水印相对于播放容器左侧起始位置，单位px
+	 * @default 0
+	 */
+	left?: number;
+	/**
+	 * @brief 水印相对于播放容器底部起始位置，单位px
+	 * @default -
+	 */
+	bottom?: number;
+	/**
+	 * @brief 水印相对于播放容器右侧起始位置，单位px
+	 * @default -
+	 */
+	right?: number;
+}
+export declare class DynamicWatermarkPlugin extends Plugin {
+	private wm;
+	static get pluginName(): string;
+	static get defaultConfig(): IWatermarkConfig & {
+		position: string;
+	};
+	constructor(props: any);
+	afterCreate(): void;
+	start(): void;
+	pause(): void;
+	resume(): void;
+	resize(): void;
+	_initWatermark(): void;
+	destroy(): void;
+	render(): string | HTMLElement;
+}
+declare class ToastPlugin extends Plugin {
+	static get pluginName(): string;
+	static get defaultConfig(): {
+		index: number;
+	};
+	constructor(args: any);
+	private toastNumber;
+	private toastMaps;
+	beforePlayerInit(): void;
+	afterPlayerInit(): void;
+	afterCreate(): void;
+	destroy(): void;
+	add(content: string | HTMLElement, duration?: number, isNeedCloseBt?: boolean): number;
+	remove(id: number): void;
+	renderToast(content: string | HTMLElement, isNeedCloseBt: any, id: any): HTMLElement;
+	render(): string;
+}
+/** {zh}
+ * @brief 记忆播放配置。
+ * @kind property
+ * @list Options
+ * @interface IMemoryPlayConfig
+ */
+export interface IMemoryPlayConfig {
+	/** {zh}
+	 * @brief 存储标识id
+	 * @default 视频vid或视频地址（去除query参数）
+	 *
+	 * @type {number | string}
+	 * @memberof IMemoryPlayConfig
+	 */
+	memoryId: number | string;
+	/** {zh}
+	 * @brief 设置存储记忆时间的回调函数
+	 * @default -
+	 * @param id 存储标识id，由SDK传入
+	 * @param time 需要记忆的时间点
+	 * @type {(id: number | string, time: number) => unknown}
+	 * @memberof IMemoryPlayConfig
+	 */
+	saveTime?: (id: number | string, time: number) => unknown;
+	/** {zh}
+	 * @brief 获取最后一次播放时间的回调函数
+	 * @param id 存储标识id，由SDK传入
+	 * @default -
+	 */
+	getTime?: (id: number | string) => number | Promise<number>;
+	/** {zh}
+	 * @brief 判断是否播放了最小时间阈值，即如果播的时长太小，则不算做播放过，存储的时间进度为0
+	 * @default 1
+	 */
+	minStartTime?: number;
+	/** {zh}
+	 * @brief 判断是否播放结束的最小时间阈值，即距离结束多少时间内算作播放结束，播放结束则不存储时间进度,且清空之前的进度为0
+	 * @default 1
+	 */
+	minEndTime?: number;
+}
+export declare class MemoryPlay extends Plugin {
+	static get pluginName(): string;
+	static get defaultConfig(): IMemoryPlayConfig;
+	startTime: number;
+	saveTimeFun: (id: number | string, time: number) => unknown;
+	getTimeFun: (id: number | string) => number | Promise<number>;
+	memoryId: number | string;
+	shouldShowToast: boolean;
+	constructor(args: any);
+	registerLanguageTexts(): {
+		preText: {
+			jp: string;
+			en: string;
+			zh: string;
+			"zh-hk": string;
+		};
+	};
+	children(): {
+		toast: typeof ToastPlugin;
+	};
+	afterCreate(): void;
+	beforePlayerInit(): Promise<void>;
+	getTime(): Promise<void>;
+	saveTime(): void;
+	visibilitychangeCallback(): void;
+	setSave(): void;
+	showToast(): void;
+	saveTimeByStorage(memoryId: string, time: number): void;
+	getTimeByStorage(memoryId: string): string | 0;
+	destroy(): void;
+}
+export interface IPlayInfoListItem {
 	BackupPlayUrl: string;
 	BackupUrlExpire: string;
 	BarrageMaskOffset: string;
@@ -1813,7 +2023,7 @@ export interface IMusicConfig {
  * @export
  * @interface Stream
  */
-export interface Stream extends Partial<IPlayInfoList> {
+export interface Stream extends Partial<IPlayInfoListItem> {
 	/** {zh}
 	 * @type {('rtm' | 'flv' | 'mp4' | 'hls')}
 	 * @memberof IPlayerConfig
@@ -1837,6 +2047,13 @@ export interface Stream extends Partial<IPlayInfoList> {
 	 * @brief 清晰度 key
 	 */
 	definition?: string;
+	/** {zh}
+	 * @type {string}
+	 * @memberof Stream
+	 * @brief 映射清晰度 key，用于清晰度降级中设置自动档位实际对应的definition
+	 * @default -
+	 */
+	mapDefinition?: string;
 	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
@@ -1868,6 +2085,16 @@ export interface Stream extends Partial<IPlayInfoList> {
 	 * @brief 多语言词典中对应的 key。比如 `lineTextKey: LINE_ONE`。
 	 */
 	lineTextKey?: string;
+	/**
+	 * @brief 码流的平均码率
+	 * @default -
+	 */
+	bitrate?: number;
+	/**
+	 * @brief 码流流畅播放需要的带宽
+	 * @default -
+	 */
+	bandwidth?: number;
 	/** {zh}
 	 * @hidden
 	 */
@@ -1975,12 +2202,12 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `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
+	 * @notes 受限制于浏览器策略，自动播放不一定能成功，取决于浏览器环境、用户行为、浏览器配置等，详细参考自动播放 @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。
+	 * @brief 视频封面图配置。
 	 */
 	poster?: string | IPoster;
 	/** {zh}
@@ -2041,7 +2268,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        ```javascript
 	 *        { zh: { PIP: '画中画' }, en: { PIP: 'pip' }}
 	 *        ```
-	 * @notice
+	 * @notes
 	 * @see 了解更多，请参见{@link https://www.volcengine.com/docs/6469/127529 默认词典}。
 	 * @listtip 了解更多，请参见[默认词典](https://www.volcengine.com/docs/6469/127529)。
 	 */
@@ -2051,7 +2278,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
 	 * @brief 画中画配置。
 	 * @default PC: {position: 'controlsRight', index: 2.5, showIcon: true}; mobile：false
-	 * @notice 画中画功能由浏览器提供，如果本身浏览器不支持，即使有该配置也不显示画中画按钮
+	 * @notes 画中画功能由浏览器提供，如果本身浏览器不支持，即使有该配置也不显示画中画按钮
 	 * @listtip 画中画功能由浏览器提供。如果浏览器不支持，即使传入此配置也不会显示画中画按钮。
 	 */
 	pip?: IPIPConfig | boolean;
@@ -2081,7 +2308,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	definitionTextKey?: string;
 	/** {zh}
 	 * @brief 视频编码格式。
-	 * @notice 在已知视频编码方式的情况下推荐传入，以方便日志分析
+	 * @notes 在已知视频编码方式的情况下推荐传入，以方便日志分析
 	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
 	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
@@ -2089,7 +2316,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
 	 * @brief 点播服务所在区域，影响服务接口和日志上报
 	 * @default cn
-	 * @notice 火山引擎海外区域播放时请填写'mya'
+	 * @notes 火山引擎海外区域播放时请填写'mya'
 	 * @hidden
 	 */
 	/** {en}
@@ -2101,12 +2328,12 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
 	 * @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 可将插件文件夹置于业务方服务器上，指定插件的地址即可
+	 * @notes 可将插件文件夹置于业务方服务器上，指定插件的地址即可
 	 */
 	/** {en}
 	 * @brief plug loading public path, used to specify the loading path of the plug-in, or the local file service to load the plug-in
 	 * @default https://sf-unpkg.bytepluscdn.com/obj/byteplusfe-sg/sdk/@byteplus/veplayer/${version}/plugin
-	 * @notice can place the plug-in folder on the business server and specify the address of the plug-in.
+	 * @notes can place the plug-in folder on the business server and specify the address of the plug-in.
 	 */
 	pluginPublicPath?: string;
 	/**
@@ -2223,7 +2450,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	enableMenu?: boolean;
 	/** {zh}
 	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生`video 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
-	 * @notice 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
+	 * @notes 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
 	 */
 	enableHlsMSE?: boolean;
 	/** {zh}
@@ -2243,6 +2470,11 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 */
 	playList?: Stream[];
+	/** {zh}
+	 * @brief 只传playList时，用于指定默认清晰度
+	 * @default playList第一项
+	 */
+	defaultDefinition?: string;
 	/** {zh}
 	 * @brief 插件，可自行选择安装的插件，支持{@link https://h5player.bytedance.com/plugins/ 西瓜播放器插件}。
 	 * @default -
@@ -2286,7 +2518,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * })
 	 * ```
 	 * @default -
-	 * @notice 插件可以从{@link https://www.volcengine.com/docs/4/67077 集成SDK} 章节中下载SDK离线包获取
+	 * @notes 插件可以从{@link https://www.volcengine.com/docs/4/67077 集成SDK} 章节中下载SDK离线包获取
 	 */
 	umdUrlMap?: Record<string, string>;
 	/**
@@ -2370,7 +2602,6 @@ export interface IPlayerConfig extends IPlayerOptions {
 	DanmuPlugin?: IDanmuConfig | boolean;
 	/** {zh}
 	 * @brief 清晰度自动降级配置
-	 * @hidden
 	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
 	 */
 	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
@@ -2431,6 +2662,16 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 播放列表配置。
 	 */
 	playListPlugin?: IPlayListConfig;
+	/** {zh}
+	 * @brief 动态水印配置
+	 * @default -
+	 */
+	dynamicwatermark?: IWatermarkConfig;
+	/** {zh}
+	 * @brief 进度条预览缩略图配置
+	 * @default -
+	 */
+	thumbnail?: IThumbnailConfig;
 }
 /** {zh}
  * @hidden
@@ -2609,6 +2850,18 @@ export interface IPlayAuthTokenConfig {
 	 * @default 1
 	 */
 	retryCount?: number;
+	/** {zh}
+	 * @brief 清晰度自动降级开启时的自动档位，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo}返回的Definition字段
+	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
+	 * @default -
+	 */
+	autoDemoteDefinition?: string;
+	/** {zh}
+	 * @brief 清晰度自动降级开启时的自动档位对应的多语言文案key，即languages字段中对应语种的相应key
+	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
+	 * @default -
+	 */
+	autoDemoteDefinitionTextKey?: string;
 }
 /** {zh}
  * @list Options
@@ -2679,45 +2932,6 @@ export interface IAutoBitrateOptsConfig {
 	 */
 	module?: any;
 }
-/** {zh}
- * @brief 记忆播放配置。
- * @kind property
- * @list Options
- * @interface IMemoryPlayConfig
- */
-export interface IMemoryPlayConfig {
-	/** {zh}
-	 * @brief 存储标识id
-	 * @default options.vid || options.url
-	 *
-	 * @type {number | string}
-	 * @memberof IMemoryPlayConfig
-	 */
-	memoryId: number | string;
-	/** {zh}
-	 * @brief 设置时间函数
-	 * @default -
-	 *
-	 * @type {(id: number | string, time: number) => unknown}
-	 * @memberof IMemoryPlayConfig
-	 */
-	saveTime?: (id: number | string, time: number) => unknown;
-	/** {zh}
-	 * @brief 获取最后一次播放时间函数
-	 * @default -
-	 */
-	getTime?: (id: number | string) => number | Promise<number>;
-	/** {zh}
-	 * @brief 判断是否播放了最小时间阈值，即如果播的时长太小，则不算做播放过，存储的时间进度为0
-	 * @default 1
-	 */
-	minStartTime?: number;
-	/** {zh}
-	 * @brief 判断是否播放结束的最小时间阈值，即距离结束多少时间内算作播放结束，播放结束则不存储时间进度,且清空之前的进度为0
-	 * @default 1
-	 */
-	minEndTime?: number;
-}
 /** {zh}
  * @brief 插件按钮位置
  */
@@ -2825,7 +3039,7 @@ export interface IFullscreenConfig {
 	 *        - `false`：否。
 	 *        - `true`：是，即全屏后，如在竖屏状态下，播放器会把 `dom` 旋转 90 度实现横屏效果。
 	 * @default false
-	 * @notice
+	 * @notes
 	 * - 该配置优先于 `useCssFullscreen` 配置。
 	 * - 该配置一般在移动端使用。
 	 * @listtip - 该参数的优先级高于 `useCssFullscreen` 参数。
@@ -2850,7 +3064,7 @@ export interface IFullscreenConfig {
 	 *        - `false`：不显示右上角返回按钮。
 	 *        - `true`：显示右上角返回按钮。
 	 * @default false
-	 * @notice 该配置一般在移动端开启
+	 * @notes 该配置一般在移动端开启
 	 * @listtip 此参数一般用于移动端。
 	 */
 	needBackIcon?: boolean;
@@ -2929,6 +3143,58 @@ export interface IPoster {
 	 */
 	fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
 }
+/** {zh}
+ * @list Options
+ * @brief 进度条预览缩略图配置
+ * @kind property
+ */
+export interface IThumbnailConfig {
+	/** {zh}
+	 * @brief 雪碧图截图地址数组
+	 * @default -
+	 */
+	urls: Array<string>;
+	/** {zh}
+	 * @brief 雪碧图中小图总数目
+	 * @default -
+	 */
+	pic_num: number;
+	/** {zh}
+	 * @brief 雪碧图每张大图中小图列数
+	 * @default -
+	 */
+	col: number;
+	/** {zh}
+	 * @brief 雪碧图每张大图中小图行数
+	 * @default -
+	 */
+	row: number;
+	/** {zh}
+	 * @brief 雪碧图每张小图的高度
+	 * @default -
+	 */
+	height?: number;
+	/** {zh}
+	 * @brief 雪碧图每张小图的宽度
+	 * @default -
+	 */
+	width?: number;
+	/** {zh}
+	 * @brief 显示缩放比例
+	 * @default 1
+	 */
+	scale?: 1;
+	/** {zh}
+	 * @brief 额外添加在dom上的class
+	 * @default -
+	 */
+	className?: string;
+	/** {zh}
+	 * @brief 是否在竖屏的时候隐藏
+	 * @default false
+	 */
+	hidePortrait?: false;
+}
 /**
  * @brief api map
  * @hidden
@@ -3012,9 +3278,14 @@ declare class PlayerData {
 	playDomainDegrade: boolean;
 	strategiesPlugins: any[];
 	strategiesPluginConfigs: any;
+	/**
+	 * @brief direct-url播放模式时的默认清晰度
+	 * @default playList第一项
+	 */
+	defaultDefinition: string;
 	constructor(configs: IPlayerConfig);
-	initPlayData(configs: any): void;
-	initPlaylistAndGetCurrent(configs: IPlayerConfig): any;
+	initPlayData(configs: IPlayerConfig): void;
+	initPlaylistAndGetCurrent(configs: IPlayerConfig): Stream;
 	isCurrentH265(): boolean;
 	getCurrentByDefaultConfig(): Stream;
 	initCurrent(currentStreams: any): void;
@@ -3055,9 +3326,10 @@ declare class PlayerData {
 	getUrlList(condition: Condition): Stream[];
 	/**
 	 * @description: 获取当期清晰的上一级清晰度或下一级清晰度
-	 * @param {boolean} isDown
+	 * @param {boolean} isDown 是否取下一级清晰度
+	 * @param {string[]} demotePriority 清晰度降级顺序
 	 */
-	getNextDefinition(isDown: boolean, demotePriority: any): Stream[];
+	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
 	/**
 	 * 获取api map
 	 * @return { ApiMapConfig }
@@ -3117,7 +3389,8 @@ declare enum UmdKeys {
 	DanmuMask = "danmuMask",
 	StreamProbe = "streamprobe",
 	VeStrategy = "vestrategy",
-	VeStrategyH265 = "vestrategy_h265"
+	VeStrategyH265 = "vestrategy_h265",
+	Preloader = "preloader"
 }
 /**
  * @hidden
@@ -3131,6 +3404,7 @@ export declare type UMDMap = Record<UmdKeys, {
 }>;
 declare class umdLoader {
 	private static jsLoadMap;
+	private static jsLoadPromiseMap;
 	umdMap: UMDMap;
 	backupUmdUrlMap: Record<string, string>;
 	failCallback: (umdName: string, err: any) => any;
@@ -3163,6 +3437,91 @@ declare class umdLoader {
 	 */
 	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
 }
+export interface IPreloadConfig {
+	preloadCacheType: 0 | 1;
+	autoPreload: boolean;
+	autoCheckPreload: boolean;
+	autoCheck: {
+		enable: boolean;
+		interval: number;
+	};
+	preloadTime: number;
+	segmentMinDuration: number;
+	preloadMaxCacheCount: number;
+}
+export interface IPreloadConfigOptions extends IPreloadConfig {
+	enableMp4: boolean;
+	enableDash: boolean;
+	enableDebugger: boolean;
+	plugins: any[];
+}
+export interface IPreloadDataPayload {
+	vid: string;
+	vtype: string;
+	codecType: string;
+	payload: Array<{
+		url: {
+			src: string;
+		}[];
+		bitrate: number;
+		duration: number;
+		size: number;
+		definition: string;
+	}>;
+	defaultDefinition?: string;
+	duration?: number;
+	mediaType?: string;
+	bizType?: 0 | 1;
+}
+export interface IPreloadData {
+	data: IPreloadDataPayload;
+	order?: number;
+}
+declare class Preloader {
+	private inst;
+	private sdkUmdLoader;
+	private registerPromise;
+	constructor();
+	static get defaultConfig(): {
+		preloadCacheType: number;
+		autoPreload: boolean;
+		autoCheckPreload: boolean;
+		autoCheck: {
+			enable: boolean;
+			interval: number;
+		};
+		preloadTime: number;
+		isDegrade: boolean;
+		waitingTimeOut: number;
+		needAutoBitrate: boolean;
+		startPreloadMinBuffer: number;
+		startPreloadControl: boolean;
+		maxBufferLength: number;
+		minBufferLength: number;
+		removeBufferLen: number;
+		preloadMaxCacheCount: number;
+		startPreloadMinPosTime: number;
+		resumePlayWaterLevel: number;
+		onProcessMinLen: number;
+		needPreloadCheck: boolean;
+		forceVideoPlay: boolean;
+		segmentMinDuration: number;
+		timerInWorker: boolean;
+		tickInSeconds: number;
+		fixEditListOffset: boolean;
+		audioGroupingStrategy: number;
+		noPreloadAddBufferLen: number;
+		loadRangeType: string;
+	};
+	private initUmdLoader;
+	private _register;
+	register(config: Partial<IPreloadConfigOptions>): Promise<any>;
+	addList(preloadList: IPreloadData[]): Promise<void>;
+	updateConfig(config: Partial<IPreloadConfig>): Promise<void>;
+	attachPlayer(player: any): Promise<void>;
+	removeAll(): Promise<any>;
+	removeAllPreloadTask(): Promise<any>;
+}
 /**
  * @hidden
  */
@@ -3196,7 +3555,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	mountingDom: any;
+	mountingDom: Element;
 	/** {zh}
 	 * @hidden
 	 *
@@ -3296,6 +3655,7 @@ declare class VePlayer {
 	 * @hidden
 	 */
 	static veStrategy: typeof VeStrategy;
+	static preloader: Preloader;
 	/**
 	 * @brief SDK 版本
 	 * @type {*}
@@ -3412,6 +3772,12 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	renderPoster(): void;
+	/**
+	 * @brief 获取西瓜的definition的配置，用于在创建player或者在playNext()时传入definition，
+	 * 以用来将playerData的当前清晰度列表数据与player.config.definition的数据进行同步
+	 * @private
+	 */
+	private getDefinitionConfig;
 	/** {zh}
 	 * @hidden
 	 *
@@ -3651,6 +4017,21 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	setH265SoftPlayList(): void;
+	/** {zh}
+	 * @brief 切换清晰度
+	 * @param definition 清晰度，如果在vid播放中有映射的清晰度，则对应映射之后的清晰度
+	 * @notes 如果传的清晰度不存在，则不处理。可以通过api: getDefinitionList()获取当前的清晰度列表
+	 */
+	changeDefinition(definition: string): void;
+	/** {zh}
+	 * @brief 获取当前的清晰度列表，列表项中包含definition、url和selected，selected为true时表示当前被选中的清晰度
+	 */
+	getDefinitionList(): Array<{
+		definition: string;
+		url: IUrl;
+		selected: boolean;
+		[propName: string]: any;
+	}>;
 	/** {zh}
 	 * @brief 初始化多语言词典
 	 *
@@ -4094,73 +4475,6 @@ export declare class Subtitle extends Plugin {
 	destroy(): void;
 	render(): string;
 }
-export interface WatermarkConfig {
-	enable: boolean;
-	content: string;
-	displayType: 0 | 1 | 2;
-	fontSize: number | string;
-	fontColor: string;
-	opacity: number;
-	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
-	fontFamily?: string;
-	top?: number;
-	left?: number;
-	bottom?: number;
-	right?: number;
-}
-export declare class DynamicWatermarkPlugin extends Plugin {
-	private wm;
-	static get pluginName(): string;
-	static get defaultConfig(): WatermarkConfig & {
-		position: string;
-	};
-	constructor(props: any);
-	afterCreate(): void;
-	start(): void;
-	pause(): void;
-	resume(): void;
-	resize(): void;
-	_initWatermark(): void;
-	destroy(): void;
-	render(): string | HTMLElement;
-}
-export declare class DefinitionDemotePlugin extends Plugin {
-	static get pluginName(): string;
-	waitings: number[];
-	timer: any;
-	longWaitingEmitTime: number;
-	waitingStartTime: number;
-	playerData: any;
-	isNeedShowTips: boolean;
-	static get defaultConfig(): {
-		oftenWaitingCount: number;
-		oftenWaitingTime: number;
-		longWaitingTime: number;
-		isNeedAutoDemote: boolean;
-		demotePriority: any[];
-	};
-	constructor(args: any);
-	registerLanguageTexts(): {
-		definition_demote_txt: {
-			jp: string;
-			en: string;
-			zh: string;
-			"zh-hk": string;
-		};
-	};
-	afterCreate(): void;
-	bindCtx(): void;
-	bindEvents(): void;
-	_waiting(): void;
-	_count(): void;
-	_time(): void;
-	_clearTime(): void;
-	clearState(): void;
-	demote(): void;
-	changeUrl(url: any): void;
-	showToast(definition: any): void;
-	destroy(): void;
-}
 export declare class TimeShiftPlugin extends Plugin {
 	static get pluginName(): string;
 	static get defaultConfig(): {
@@ -4273,54 +4587,6 @@ export declare class MirrorPlugin extends Plugin {
 	destroy(): void;
 	render(): string;
 }
-declare class ToastPlugin extends Plugin {
-	static get pluginName(): string;
-	static get defaultConfig(): {
-		index: number;
-	};
-	constructor(args: any);
-	private toastNumber;
-	private toastMaps;
-	beforePlayerInit(): void;
-	afterPlayerInit(): void;
-	afterCreate(): void;
-	destroy(): void;
-	add(content: string | HTMLElement, duration?: number, isNeedCloseBt?: boolean): number;
-	remove(id: number): void;
-	renderToast(content: string | HTMLElement, isNeedCloseBt: any, id: any): HTMLElement;
-	render(): string;
-}
-export declare class MemoryPlay extends Plugin {
-	static get pluginName(): string;
-	static get defaultConfig(): IMemoryPlayConfig;
-	startTime: number;
-	saveTimeFun: (id: number | string, time: number) => unknown;
-	getTimeFun: (id: number | string) => number | Promise<number>;
-	memoryId: number | string;
-	canJump: boolean;
-	constructor(args: any);
-	registerLanguageTexts(): {
-		preText: {
-			jp: string;
-			en: string;
-			zh: string;
-			"zh-hk": string;
-		};
-	};
-	children(): {
-		toast: typeof ToastPlugin;
-	};
-	afterCreate(): void;
-	beforePlayerInit(): Promise<void>;
-	getTime(): Promise<void>;
-	saveTime(): void;
-	visibilitychangeCallback(): void;
-	setSave(): void;
-	showToast(): void;
-	saveTimeByStorage(memoryId: string, time: number): void;
-	getTimeByStorage(memoryId: string): string;
-	destroy(): void;
-}
 export declare type InfoItem = {
 	key: string;
 	label: string;