@volcengine/veplayer 1.8.7-rc.0 → 1.9.0

package/index.d.ts

@@ -779,51 +779,78 @@ export interface ITextItem {
 	index?: number;
 }
 /**
- * @brief 清晰度自动降级配置
+ * @brief 清晰度降级配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief 清晰度降级配置
+ */
 export interface IDefinitionDemotePlugin {
 	/**
-	 * @brief 是否自动触发降级
+	 * @brief 是否开启自动降级，取值如下：
+	 *        - `false`：关闭自动降级。
+	 *        - `true`：开启自动降级。
 	 * @default true
 	 *
 	 */
+	/** {en}
+	 * @brief Is automatic downgrade enabled? The values are as follows:
+	 *        - `false`: automatic downgrade is disabled.
+	 *        - `true`: automatic downgrade is enabled.
+	 */
 	isNeedAutoDemote?: boolean;
 	/**
-	 * @brief 降级顺序，按照数组 顺序依次降级，数组 中的元素与playList 中的 definition 相对应
+	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
 	 *
 	 * @type {string[]}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	demotePriority?: string[];
+	/** {en}
+	 */
+	demotePriority: string[];
 	/**
-	 * @brief 长时间卡顿的时间阈值，单位为ms。卡顿超过该值，即为长时间卡顿
+	 * @brief 长时间卡顿的时间阈值，单位为毫秒。卡顿时长超过该值，即视为长时间卡顿。发生长时间卡顿时，SDK 会触发 `LONG_WAITING` 事件。
 	 * @default 5000
 	 *
 	 */
+	/** {en}
+	 * @brief 长时间卡顿的时间阈值，单位为ms。卡顿超过该值，即为长时间卡顿
+	 */
 	longWaitingTime?: number;
 	/**
-	 * @brief 频繁卡顿的次数阈值。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 * @brief 频繁卡顿的次数阈值。`oftenWaitingTime` 内卡顿次数大于或等于阈值时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 3
 	 *
 	 */
+	/** {en}
+	 * @brief 频繁卡顿的次数阈值。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 */
 	oftenWaitingCount?: number;
 	/**
-	 * @brief 频繁卡顿的时间范围。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 * @brief 频繁卡顿监测的时间范围。`oftenWaitingTime` 内卡顿次数大于或等于 `oftenWaitingCount` 时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 5000
 	 */
+	/** {en}
+	 * @brief 频繁卡顿的时间范围。OftenWaitingTime 内卡顿次数大于等于阈值时，触发often_waiting事件，即表示发生了频繁卡顿
+	 */
 	oftenWaitingTime?: number;
 	/**
-	 * @brief 卡顿时是否显示建议切换清晰度的提醒tips
+	 * @brief 卡顿时是否显示清晰度降级提示 toast。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief 卡顿时是否显示建议切换清晰度的提醒tips
+	 */
 	isNeedShowTips?: boolean;
 	/**
-	 * @brief 提醒降级的toast显示持续时间,单位ms
+	 * @brief 清晰度降级提示 toast 的显示时长，单位为毫秒。
 	 * @default 3000
 	 */
+	/** {en}
+	 * @brief 提醒降级的toast显示持续时间,单位ms
+	 */
 	toastShowTime?: number;
 }
 export declare class DefinitionDemotePlugin extends Plugin {
@@ -853,7 +880,7 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_clearTime(): void;
 	clearState(): void;
 	demote(): void;
-	changeUrl(url: string): void;
+	changeUrl(url: Url): void;
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
@@ -1380,6 +1407,11 @@ export interface IAutoplayPluginConfig {
 	 * @brief 开启任意点击/触摸的用户行为触发自动播放
 	 */
 	enableUserActionAutoplay?: boolean;
+	/**
+	 * @brief 静音自动播放时，是否在播放器容器上居中展示取消静音的大按钮
+	 * @default true
+	 */
+	showUnmuteBtn?: boolean;
 }
 declare class PlayList {
 	private config;
@@ -1670,44 +1702,73 @@ export declare class PlayListPlugin extends Plugin {
  */
 export interface IWatermarkConfig {
 	/**
-	 * @brief 是否开启水印
+	 * @brief 是否开启动态水印，取值如下：<br/>
+	 *        - `true`：开启动态水印
+	 *        - `false`：关闭动态水印
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Is dynamic watermark enabled? The value is as follows:<br/>
+	 *        - `true`: Enable dynamic watermark
+	 *        - `false`: Disable dynamic watermark
+	 */
 	enable: boolean;
 	/**
-	 * @brief 水印文案内容
+	 * @brief 水印文案。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief 水印文案内容
+	 */
 	content: string;
 	/**
-	 * @brief 水印展示形式
-	 * - 0: 固定位置
-	 * - 1: 全屏滚动
-	 * - 2: 随机闪烁
+	 * @brief 水印展示形式，取值如下：<br/>
+	 *        - `0`：固定位置
+	 *        - `1`：全屏滚动
+	 *        - `2`：随机闪烁
 	 * @default 1
 	 */
-	displayType: 0 | 1 | 2;
+	/** {en}
+	 * @brief 水印展示形式
+	 *        - 0: 固定位置
+	 *        - 1: 全屏滚动
+	 *        - 2: 随机闪烁
+	 */
+	displayType?: 0 | 1 | 2;
 	/**
-	 * @brief 水印字体大小，number类型时单位为px，string类型需要携带单位
+	 * @brief 水印字体大小。`number`类型时单位为 px，`string` 类型时需要携带单位。
 	 * @default 12
 	 */
-	fontSize: number | string;
+	/** {en}
+	 * @brief 水印字体大小，number类型时单位为px，string类型需要携带单位
+	 */
+	fontSize?: number | string;
 	/**
+	 * @brief 水印字体颜色。
+	 * @brief 水印字体颜色。
+	 */
+	/** {en}
 	 * @brief 水印字体颜色
-	 * @brief #FFFFFF
 	 */
-	fontColor: string;
+	fontColor?: string;
 	/**
-	 * @brief 不透明度
+	 * @brief 水印不透明度。取值范围：\[0~1\]。
 	 * @default 0.3
 	 */
-	opacity: number;
+	/** {en}
+	 * @brief 不透明度
+	 */
+	opacity?: number;
 	/**
-	 * @brief 水印闪烁速度
+	 * @brief 水印闪烁速度，取值如下：<br/>
+	 *        - `MODERATE`：适中
+	 *        - `FAST`：较快
+	 *        - `SLOW`：较慢
+	 * @default MODERATE
+	 */
+	/** {en}
 	 * @default MODERATE
-	 * - MODERATE: 适中
-	 * - FAST: 较快
-	 * - SLOW: 较慢
+	 * @brief 水印闪烁速度
 	 */
 	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
 	/**
@@ -1716,22 +1777,22 @@ export interface IWatermarkConfig {
 	 */
 	fontFamily?: string;
 	/**
-	 * @brief 水印相对于播放容器顶部起始位置，单位px
+	 * @brief 水印相对于播放容器顶部的距离，单位为 px
 	 * @default 0
 	 */
 	top?: number;
 	/**
-	 * @brief 水印相对于播放容器左侧起始位置，单位px
+	 * @brief 水印相对于播放容器左侧的距离，单位为 px。
 	 * @default 0
 	 */
 	left?: number;
 	/**
-	 * @brief 水印相对于播放容器底部起始位置，单位px
+	 * @brief 水印相对于播放容器底部的距离，单位为 px。
 	 * @default -
 	 */
 	bottom?: number;
 	/**
-	 * @brief 水印相对于播放容器右侧起始位置，单位px
+	 * @brief 水印相对于播放容器右侧的距离，单位为 px。
 	 * @default -
 	 */
 	right?: number;
@@ -1778,39 +1839,39 @@ declare class ToastPlugin extends Plugin {
 export interface IMemoryPlayConfig {
 	/** {zh}
 	 * @brief 存储标识id
-	 * @default 视频vid或视频地址（去除query参数）
-	 *
+	 * @default options.vid || options.url
 	 * @type {number | string}
 	 * @memberof IMemoryPlayConfig
 	 */
 	memoryId: number | string;
 	/** {zh}
-	 * @brief 设置存储记忆时间的回调函数
+	 * @brief 设置时间函数
 	 * @default -
-	 * @param id 存储标识id，由SDK传入
-	 * @param time 需要记忆的时间点
+	 * @param id
+	 * @param time
 	 * @type {(id: number | string, time: number) => unknown}
 	 * @memberof IMemoryPlayConfig
 	 */
 	saveTime?: (id: number | string, time: number) => unknown;
 	/** {zh}
-	 * @brief 获取最后一次播放时间的回调函数
-	 * @param id 存储标识id，由SDK传入
+	 * @brief 获取最后一次播放时间函数
+	 * @param id
 	 * @default -
 	 */
 	getTime?: (id: number | string) => number | Promise<number>;
 	/** {zh}
-	 * @brief 判断是否播放了最小时间阈值，即如果播的时长太小，则不算做播放过，存储的时间进度为0
+	 * @brief 判断播放是否已开始的最小时间阈值。如果播放时长短于此阈值，则不算作已开始播放，存储的时间进度为 0。
 	 * @default 1
 	 */
 	minStartTime?: number;
 	/** {zh}
-	 * @brief 判断是否播放结束的最小时间阈值，即距离结束多少时间内算作播放结束，播放结束则不存储时间进度,且清空之前的进度为0
+	 * @brief 判断播放是否已结束的最小时间阈值，即距离结束还剩余的时间不足此阈值时，即视为播放已结束。播放结束时，不再存储时间进度，并将之前的进度清零。
 	 * @default 1
 	 */
 	minEndTime?: number;
 }
 export declare class MemoryPlay extends Plugin {
+	private curTime;
 	static get pluginName(): string;
 	static get defaultConfig(): IMemoryPlayConfig;
 	startTime: number;
@@ -2036,11 +2097,11 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	streamType?: string;
 	/** {zh}
 	 * @brief 播放地址
-	 *
-	 * @type {string}
+	 * 如果是数组形式，则数组每项需要传入src和type，分别表示视频地址及类型，在非MSE的播放方式下，将以HTML@{link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source <source>} 形式设置视频资源
+	 * @type {Url}
 	 * @memberof IPlayerConfig
 	 */
-	url: string;
+	url: Url;
 	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
@@ -2050,7 +2111,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
-	 * @brief 映射清晰度 key，用于清晰度降级中设置自动档位实际对应的definition
+	 * @brief 映射清晰度 key
 	 * @default -
 	 */
 	mapDefinition?: string;
@@ -2095,6 +2156,11 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @default -
 	 */
 	bandwidth?: number;
+	/**
+	 * @brief 地址的过期时间戳，单位秒(s)，vid模式下不用输入，播放器自动获取。如果是火山引擎的CDN分发地址，在不传入过期时间戳时，则需指定urlType，支持{@link https://www.volcengine.com/docs/4/177191 A-E类型}，其他云厂商或者业务服务器存储的地址不支持。
+	 * @default -
+	 */
+	urlExpireTimestamp?: number;
 	/** {zh}
 	 * @hidden
 	 */
@@ -2106,10 +2172,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 export interface Condition {
 	definition?: string;
 	lineId?: number | string;
-	/**
-	 * @hidden
-	 */
-	[propName: string]: any;
+	url?: Url;
 }
 /** {zh}
  * @hidden
@@ -2120,11 +2183,26 @@ export interface Current {
 	language: string;
 	lineId?: number | string;
 	codec?: CodecType;
+	/**
+	 * @brief 地址的过期时间戳，vid模式下不用输入，播放器自动获取。如果是火山引擎的CDN分发地址，在不传入过期时间戳时，则需指定urlType，支持{@link https://www.volcengine.com/docs/4/177191 A-E类型}，其他云厂商或者业务服务器存储的地址不支持。
+	 * @default -
+	 */
+	urlExpireTimestamp?: number;
 	/**
 	 * @hidden
 	 */
 	[propName: string]: any;
 }
+/**
+ * @detail Options
+ * @brief url 类型，支持字符串和数组，当为数组时将以HTML@{link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source <source>} 形式设置视频资源，可设置多个格式以兼容不同的浏览器
+ * 注意：数组形式的url不支持hls、dash等的MSE方式播放
+ */
+export declare type Url = string | Array<{
+	src: string;
+	type?: string;
+	[propName: string]: any;
+}>;
 /** {zh}
  * @list Options
  * @kind property
@@ -2155,9 +2233,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	root?: HTMLElement;
 	/** {zh}
 	 * @brief 视频播放地址。
+	 * 如果是数组形式，则数组每项需要传入src和type，分别表示视频地址及类型，在非MSE的播放方式下，将以HTML@{link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source <source>} 形式设置视频资源
 	 * @default -
 	 */
-	url?: string;
+	url?: Url;
 	/** {zh}
 	 * @brief 视频点播服务中的视频 ID。推荐填写，以方便跟踪该视频的播放质量。您将音视频上传至视频点播服务后，可通过以下方式获取 `Vid`：
 	 *
@@ -2449,7 +2528,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	enableMenu?: boolean;
 	/** {zh}
-	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生`video 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
+	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生 `video` 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
 	 * @notes 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
 	 */
 	enableHlsMSE?: boolean;
@@ -2471,7 +2550,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	playList?: Stream[];
 	/** {zh}
-	 * @brief 只传playList时，用于指定默认清晰度
+	 * @brief 默认清晰度。仅当 `playList` 有值时生效。
 	 * @default playList第一项
 	 */
 	defaultDefinition?: string;
@@ -2546,31 +2625,37 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default false
 	 */
 	enableH265Degrade?: boolean;
+	/** {zh}
+	 * @brief 是否开启地址过期检测，开启后以轮询的方式将当前时间与过期时间戳进行对比，以判断是否过期
+	 * @default false
+	 */
+	enableUrlExpireCheck?: boolean;
+	/**
+	 * @brief 地址的过期时间戳，单位秒(s)，vid模式下不用输入，播放器自动获取。如果是火山引擎的CDN分发地址，在不传入过期时间戳时，则需指定urlType，支持{@link https://www.volcengine.com/docs/4/177191 A-E类型}，其他云厂商或者业务服务器存储的地址不支持。
+	 * @default -
+	 */
+	urlExpireTimestamp?: number;
+	/**
+	 * @brief 判断地址过期的阈值，单位秒(s)。如设置为500时，则在过期前500ms时就可以检测出过期执行更新地址操作，为更新地址留足足够缓冲时间。
+	 * @default 60
+	 */
+	urlExpireDiff?: number;
+	/**
+	 * @brief 地址过期检测任务的时间间隔，单位ms。
+	 * @default 400
+	 */
+	urlCheckExpireInterval?: number;
 	/** {zh}
 	 * @hidden
 	 * @brief 资源过期时的回调函数，用来更新视频资源
 	 * @default -
 	 */
-	onMediaExpired?: () => Promise<IPlayerConfig>;
+	onMediaExpired?: () => Promise<SourceConfig>;
 	/** {zh}
 	 * @brief `playAuthToken` 过期时的回调函数，可用来更新 `playAuthToken`。
 	 * @default -
 	 */
 	onTokenExpired?: () => Promise<IPlayAuthTokenConfig>;
-	/** {zh}
-	 * @hidden
-	 * @brief 定期检查资源过期的周期，单位秒
-	 * @default `400`
-	 */
-	checkExpireInterval?: number;
-	/** {zh}
-	 * @hidden
-	 * @brief 定期检查资源过期的方式，支持三种类型
-	 * - `urlExpire`: 根据url的过期时间判断
-	 * - `xhrStatus`: 发送资源请求，根据资源xhr状态判断
-	 * - `getUrlTime`: 根据估算的地址获取时间判断
-	 */
-	expireDetectType?: Array<"urlExpire" | "xhrStatus" | "getUrlTime">;
 	/** {zh}
 	 * @hidden
 	 * @brief 禁用点播日志配置检测，默认开启，如果未配置line_app_id则会播放报错
@@ -2601,7 +2686,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	DanmuPlugin?: IDanmuConfig | boolean;
 	/** {zh}
-	 * @brief 清晰度自动降级配置
+	 * @brief 清晰度降级配置。
 	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
 	 */
 	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
@@ -2628,11 +2713,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	Mp4EncryptPlayer?: Partial<IMp4EncryptPlayerConfig> | boolean;
 	/** {zh}
-	 * @hidden
 	 * @brief 自适应码率配置项
 	 * @default -
 	 */
-	autoBitrateOpts?: IAutoBitrateOptsConfig;
+	autoBitrateOpts?: IAutoBitrateOpts;
 	/** {zh}
 	 * @brief 外挂字幕配置。
 	 * @default -
@@ -2673,6 +2757,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	thumbnail?: IThumbnailConfig;
 }
+/**
+ * @brief source数据，可包含url、playList、getVideoByToken和urlExpireTimestamp
+ */
+export declare type SourceConfig = Pick<IPlayerConfig, "url" | "playList" | "getVideoByToken" | "urlExpireTimestamp">;
 /** {zh}
  * @hidden
  */
@@ -2857,7 +2945,7 @@ export interface IPlayAuthTokenConfig {
 	 */
 	autoDemoteDefinition?: string;
 	/** {zh}
-	 * @brief 清晰度自动降级开启时的自动档位对应的多语言文案key，即languages字段中对应语种的相应key
+	 * @brief 开启清晰度自动降级（`isNeedAutoDemote` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
 	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
 	 * @default -
 	 */
@@ -2883,107 +2971,20 @@ export interface definitionItem {
 	 */
 	definitionTextKey?: string;
 }
-export interface IAutoBitrateOptsConfig {
-	/** {zh}
-	 * @brief 是否开启功能,默认为false
-	 * @type {boolean}
-	 * @memberof IAutoBitrateOptsConfig
-	 */
-	isOpenAutoDefi?: boolean;
-	/** {zh}
-	 * @brief 自动切换清晰度对应显示文案
-	 *
-	 * @type {string}
-	 * @memberof IAutoBitrateOptsConfig
-	 */
-	autoDefiText?: string;
-	/** {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}
-	 * @memberof IAutoBitrateOptsConfig
-	 */
-	module?: any;
-}
-/** {zh}
- * @brief 插件按钮位置
+/**
+ * @brief Plugin类插件基础配置
  */
-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",
-	/** {zh}
-	 * @hidden
-	 * @brief 播控栏左侧
-	 */
-	CONTROLS = "controls"
-}
-export interface IIconPluginConfig {
-	position?: POSITIONS;
+export interface IPluginConfig {
+	position?: typeof Plugin.POSITIONS[keyof typeof Plugin.POSITIONS];
 	index?: number;
+	disable?: boolean;
 }
 /** {zh}
  * @brief 画中画配置。
  * @list Options
  * @kind property
  */
-export interface IPIPConfig extends IIconPluginConfig {
+export interface IPIPConfig extends IPluginConfig {
 	/** {zh}
 	 * @brief 是否显示画中画按钮。取值如下：
 	 *        - `true`：显示画中画按钮。
@@ -3027,6 +3028,12 @@ export interface IPIPConfig extends IIconPluginConfig {
  * @kind property
  */
 export interface IFullscreenConfig {
+	/** {zh}
+	 * @brief 是否使用页面全屏代替系统全屏。取值如下：
+	 *        - `true`：页面全屏。
+	 *        - `false`：系统全屏。
+	 * @default false
+	 */
 	/** {zh}
 	 * @brief 是否使用页面全屏代替系统全屏。取值如下：
 	 *        - `true`：页面全屏。
@@ -3145,52 +3152,54 @@ export interface IPoster {
 }
 /** {zh}
  * @list Options
- * @brief 进度条预览缩略图配置
+ * @brief 进度条预览缩略图配置。
  * @kind property
  */
 export interface IThumbnailConfig {
 	/** {zh}
-	 * @brief 雪碧图截图地址数组
+	 * @brief 雪碧图地址数组。
 	 * @default -
 	 */
 	urls: Array<string>;
 	/** {zh}
-	 * @brief 雪碧图中小图总数目
+	 * @brief 缩略小图总张数。
 	 * @default -
 	 */
 	pic_num: number;
 	/** {zh}
-	 * @brief 雪碧图每张大图中小图列数
+	 * @brief 雪碧大图中每列包含的缩略小图数量。
 	 * @default -
 	 */
 	col: number;
 	/** {zh}
-	 * @brief 雪碧图每张大图中小图行数
+	 * @brief 雪碧大图中每行包含的缩略小图数量。
 	 * @default -
 	 */
 	row: number;
 	/** {zh}
-	 * @brief 雪碧图每张小图的高度
+	 * @brief 缩略小图高度，单位为 px。
 	 * @default -
 	 */
 	height?: number;
 	/** {zh}
-	 * @brief 雪碧图每张小图的宽度
+	 * @brief 缩略小图宽度，单位为 px。
 	 * @default -
 	 */
 	width?: number;
 	/** {zh}
 	 * @brief 显示缩放比例
 	 * @default 1
+	 * @hidden
 	 */
 	scale?: 1;
 	/** {zh}
 	 * @brief 额外添加在dom上的class
 	 * @default -
+	 * @hidden
 	 */
 	className?: string;
 	/** {zh}
-	 * @brief 是否在竖屏的时候隐藏
+	 * @brief 是否在竖屏的时候隐藏缩略图。
 	 * @default false
 	 */
 	hidePortrait?: false;
@@ -3257,16 +3266,14 @@ declare class PlayerData {
 	openSoftDecoding: boolean;
 	defaultConfig: IDefaultConfig | undefined;
 	isHitDefault: boolean;
-	codec?: CodecType;
+	codec?: `${CodecType}`;
 	enableH265Degrade: boolean;
 	languageData: {
 		extraLangList: IXGI18nText[];
 		extendLangList: IXGI18nText[];
 	};
 	current: Current;
-	checkExpireInterval: number;
-	expireDetectType: Array<"xhrStatus" | "urlExpire" | "getUrlTime">;
-	onMediaExpired: () => Promise<IPlayerConfig>;
+	onMediaExpired: () => Promise<SourceConfig>;
 	onTokenExpired: () => Promise<IPlayAuthTokenConfig>;
 	unionId?: string;
 	unionInfo?: string;
@@ -3279,16 +3286,30 @@ declare class PlayerData {
 	strategiesPlugins: any[];
 	strategiesPluginConfigs: any;
 	/**
-	 * @brief direct-url播放模式时的默认清晰度
 	 * @default playList第一项
 	 */
 	defaultDefinition: string;
+	urlCheckData: {
+		enableUrlExpireCheck: boolean;
+		urlExpireTimestamp: number;
+		urlExpireDiff: number;
+		urlCheckExpireInterval: number;
+	};
 	constructor(configs: IPlayerConfig);
+	/**
+	 * 初始化播放数据
+	 * @param configs { IPlayerConfig } 播放器配置
+	 */
 	initPlayData(configs: IPlayerConfig): void;
 	initPlaylistAndGetCurrent(configs: IPlayerConfig): Stream;
 	isCurrentH265(): boolean;
 	getCurrentByDefaultConfig(): Stream;
-	initCurrent(currentStreams: any): void;
+	initCurrent(currentStreams: Stream): void;
+	initCheckExpireData(): void;
+	/**
+	 * 更新过期检测的数据
+	 */
+	updateCheckExpireData(): void;
 	initI18nData(languages: any): {
 		extraLangList: any[];
 		extendLangList: any[];
@@ -3296,11 +3317,17 @@ declare class PlayerData {
 	/**
 	 * @description: 获取当前直播url
 	 */
-	getCurrentUrl(): string;
+	getCurrentUrl(): Url;
 	/**
 	 * @description: 获取当前的streamType
 	 */
 	getCurrentStreamType(): any;
+	getStreamType(): any;
+	isOpenABR(streamType?: string): boolean;
+	showRealDefinition(): boolean;
+	isAutoDefinition(def: any): boolean;
+	isPlayAutoDefinition(def?: string): any;
+	isDefinitionMatch(pre: any, next: any): boolean;
 	/**
 	 * @description: 获取满足当前直播条件的流
 	 */
@@ -3340,6 +3367,15 @@ declare class PlayerData {
 	 */
 	get playDomain(): string;
 	setVodTeaId(): void;
+	/**
+	 * 更新configs,即更新用户的configs，常用于playNext时
+	 * @param newConfigs {IPlayerConfig} 要更新的配置
+	 */
+	updateConfigs(newConfigs: IPlayerConfig): void;
+	/**
+	 * 更新playList
+	 */
+	updatePlayList(): void;
 }
 declare function isMSESupport(mime?: string): boolean;
 /**
@@ -3390,7 +3426,7 @@ declare enum UmdKeys {
 	StreamProbe = "streamprobe",
 	VeStrategy = "vestrategy",
 	VeStrategyH265 = "vestrategy_h265",
-	Preloader = "preloader"
+	DashAbralgo = "DashAbralgo"
 }
 /**
  * @hidden
@@ -3437,91 +3473,6 @@ 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
  */
@@ -3609,25 +3560,9 @@ declare class VePlayer {
 	private checkExpireTimer;
 	/**
 	 * @hidden
-	 *
-	 * @type {*}
-	 * @memberof VePlayer
-	 */
-	private _playOriginalUrl;
-	/**
-	 * @hidden
-	 * 过期次数
-	 * @type {*}
-	 * @memberof VePlayer
-	 */
-	private expireCount;
-	/**
-	 * @hidden
-	 * 获取url的时间
-	 * @type {*}
-	 * @memberof VePlayer
+	 * 上次触发过期的时间
 	 */
-	private getUrlTime;
+	private emitExpireTimestamp;
 	/**
 	 * @hidden
 	 * 延迟触发但错误
@@ -3635,7 +3570,6 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	delayError: any[];
-	private isFirstEmitted;
 	/**
 	 * @hidden
 	 * umd加载器
@@ -3655,7 +3589,6 @@ declare class VePlayer {
 	 * @hidden
 	 */
 	static veStrategy: typeof VeStrategy;
-	static preloader: Preloader;
 	/**
 	 * @brief SDK 版本
 	 * @type {*}
@@ -3671,6 +3604,14 @@ declare class VePlayer {
 		targetProfileLevel?: string;
 	}) => Promise<boolean>;
 	private vodLogCommon;
+	/**
+	 * @hidden
+	 * 延时触发的events，即保证在palyer创建之后才触发
+	 */
+	delayEvents: Array<{
+		name: string;
+		payload: any;
+	}>;
 	/** {zh}
 	 * @brief 构造函数。
 	 * @param configs 播放器实例化配置。
@@ -3695,7 +3636,7 @@ declare class VePlayer {
 	 * @description 初始化过期检测
 	 * @memberof VePlayer
 	 */
-	initCheckExpire(): void;
+	private _initCheckExpire;
 	/**
 	 * @hidden
 	 * @description 更新umdLoader 的配置
@@ -3718,19 +3659,13 @@ declare class VePlayer {
 	 * @description 循环执行过期检测
 	 * @memberof VePlayer
 	 */
-	onRepeat(): void;
+	private _onRepeat;
 	/**
 	 * @hidden
 	 * @brief  触发过期事件
 	 * @memberof VePlayer
 	 */
-	emitExpireEvent(): void;
-	/**
-	 * @hidden
-	 * @brief  地址获取时间
-	 * @memberof VePlayer
-	 */
-	getUrlTimestamp(url: string): void;
+	private _emitExpireEvent;
 	/** {zh}
 	 * @brief 监听事件。
 	 * @memberof VePlayer
@@ -3787,7 +3722,7 @@ declare class VePlayer {
 	createPlayer(): Promise<PlayerCore>;
 	/** {zh}
 	 * @hidden
-	 *
+	 * @brief 设置合并开发者的插件配置，如果开发者从初始化的configs里传了插件配置，则只用开发者的配置，并补齐其他参数
 	 * @param {IPlayerConfig} finalOptions
 	 * @return {void}
 	 * @memberof VePlayer
@@ -3824,6 +3759,7 @@ declare class VePlayer {
 		DanmuPlugin?: any;
 		LiveSubtitlesIconPlugin?: any;
 	};
+	private getStreamType;
 	/**
 	 *
 	 * @private
@@ -3854,7 +3790,8 @@ declare class VePlayer {
 	 *
 	 * @memberof VePlayer
 	 */
-	emitDelayError(): void;
+	private _emitDelayError;
+	private _emitDelayEvent;
 	/**
 	 * @hidden
 	 *
@@ -3870,19 +3807,22 @@ declare class VePlayer {
 	 */
 	private _mountingPlayerPanel;
 	/**
-	 *
 	 *
 	 * @private
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
 	private _bindPlayerEvents;
+	private _onError;
 	/** {zh}
 	 * @private
-	 * @return {*}
-	 * @memberof VePlayer
 	 */
-	private onMediaExpiredAction;
+	private _onMediaExpiredAction;
+	/**
+	 * @brief 更新视频源，常用于地址过期时或者过期前更新视频地址及过期时间戳
+	 * @param source 视频资源配置，支持传入地址url、playList、getVideByToken以及过期检查的相关配置
+	 */
+	updateMediaSource(source: SourceConfig): Promise<void>;
 	/** {zh}
 	 * @hidden
 	 *
@@ -3941,25 +3881,25 @@ declare class VePlayer {
 	 * @param config `playAuthToken` 配置。
 	 */
 	updateAuthToken(config: IPlayAuthTokenConfig): Promise<void>;
+	private _playerPlayNext;
 	/** {zh}
-	 * @brief 返回当前视频的地址
+	 * @brief 返回当前视频的地址。
+	 * @notice 多source下，返回video的currentSrc，即实际使用的source。MSE 播放时返回blob地址。
 	 * @memberof VePlayer
 	 */
-	get src(): any;
+	get src(): string;
 	/** {zh}
 	 * @brief 设置当前视频的地址
 	 * @notes 会重新拉取新的视频，从0开始起播
 	 * @memberof VePlayer
 	 */
-	set src(url: any);
+	set src(url: Url);
 	/** {zh}
-	 * @notes 更换后，会从更换前的时间点继续播放。
-	 * @return {Promise<void>}
-	 * @memberof VePlayer
 	 * @brief 播放时更换视频 URL，以更换视频源。
+	 * @notes 更换后，会从更换前的时间点继续播放。
 	 * @param url 视频播放地址。
 	 */
-	switchURL(url: string): Promise<void>;
+	switchURL(url: Url): Promise<void>;
 	/** {zh}
 	 * @memberof VePlayer
 	 * @brief 针对不同格式的视频，重建播放器内核播放下一个视频。
@@ -3977,13 +3917,7 @@ declare class VePlayer {
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
-	/** {zh}
-	 * @hidden
-	 *
-	 * @return {*}
-	 * @memberof VePlayer
-	 */
-	resetUrlState(url: any): void;
+	private _playNext;
 	/** {zh}
 	 * @brief 销毁xgplayer实例
 	 *
@@ -4007,7 +3941,7 @@ declare class VePlayer {
 	getSoftDecodingOption(isOpenSoftDecoding: boolean, url: string, type: string): Promise<{
 		mediaType?: string;
 		innerDegrade?: number;
-		codecType?: CodecType;
+		codecType?: `${CodecType}`;
 		plugins?: any[];
 	}>;
 	/** {zh}
@@ -4770,11 +4704,11 @@ export declare const Events: {
 	 */
 	PLAYER_EXTEND_BUTTON: string;
 	/** {zh}
-	 * @brief 长时间等待。
+	 * @brief 发生长时间卡顿时触发。播放器会在事件发生时自动进行清晰度降级或提醒用户手动切换晰度降级。
 	 */
 	LONG_WAITING: string;
 	/** {zh}
-	 * @brief 频繁等待。
+	 * @brief 发生频繁卡顿时触发。
 	 */
 	OFTEN_WAITING: string;
 	/** {zh}
@@ -4849,6 +4783,18 @@ export declare const Events: {
 	 * @brief 播放列表播放项变更。
 	 */
 	PLAY_LIST_ITEM_CHANGE: string;
+	/** {zh}
+	 * @brief playNext开始
+	 */
+	PLAY_NEXT_START: string;
+	/** {zh}
+	 * @brief playNext结束。
+	 */
+	PLAY_NEXT_END: string;
+	/** {zh}
+	 * @brief 自动挡档位改变。
+	 */
+	ABR_AUTO_DESC_CHANGE: string;
 	/** {zh}
 	 * @brief 播放器实例创建完成时触发。
 	 */
@@ -5038,9 +4984,14 @@ export declare const Events: {
 	 */
 	DURATION_CHANGE: string;
 	/** {zh}
+	 * @deprecated
 	 * @brief 媒体被清空（初始化）时触发。
 	 */
 	EMPITED: string;
+	/** {zh}
+	 * @brief 媒体被清空（初始化）时触发。
+	 */
+	EMPTIED: string;
 	/** {zh}
 	 * @brief 视频播放完毕时触发。
 	 */
@@ -5356,11 +5307,11 @@ export declare const Event: {
 		 */
 		PLAYER_EXTEND_BUTTON: string;
 		/** {zh}
-		 * @brief 长时间等待。
+		 * @brief 发生长时间卡顿时触发。播放器会在事件发生时自动进行清晰度降级或提醒用户手动切换晰度降级。
 		 */
 		LONG_WAITING: string;
 		/** {zh}
-		 * @brief 频繁等待。
+		 * @brief 发生频繁卡顿时触发。
 		 */
 		OFTEN_WAITING: string;
 		/** {zh}
@@ -5435,6 +5386,18 @@ export declare const Event: {
 		 * @brief 播放列表播放项变更。
 		 */
 		PLAY_LIST_ITEM_CHANGE: string;
+		/** {zh}
+		 * @brief playNext开始
+		 */
+		PLAY_NEXT_START: string;
+		/** {zh}
+		 * @brief playNext结束。
+		 */
+		PLAY_NEXT_END: string;
+		/** {zh}
+		 * @brief 自动挡档位改变。
+		 */
+		ABR_AUTO_DESC_CHANGE: string;
 	};
 };
 export * from "xgplayer";