@volcengine/veplayer 1.9.0 → 1.9.2

package/index.d.ts

@@ -1,7 +1,8 @@
+import VeStrategy from '@byted/volcengine-vestrategy';
+import { StrategyRecommendation } from '@byted/volcengine-vestrategy';
+import { VeStrategyH265Config } from '@byted/volcengine-vestrategy-h265';
+import { PreloaderManager as PreloaderManagerOrigin } from '@byted/volcengine-vestrategy-preload';
 import VodLogger from '@byted/xgplayer-app-logger/es/logger.js';
-import VeStrategy from '@volcengine/vestrategy';
-import { StrategyRecommendation, VeStrategyInitOptions } from '@volcengine/vestrategy';
-import { VeStrategyH265Config } from '@volcengine/vestrategy-h265';
 import EventEmitter from 'eventemitter3';
 import Player from 'xgplayer';
 import { BasePlugin, I18N, IXGI18nText, Plugin } from 'xgplayer';
@@ -199,7 +200,8 @@ export interface IRtmConfig {
  * @kind property
  */
 /** {en}
- * @brief 弹幕相关设置
+ * @list Options
+ * @kind property
  */
 export interface IDanmuConfig {
 	/**
@@ -306,7 +308,11 @@ export interface IMaskConfig {
 	maskOffset?: number;
 	interval?: number;
 }
-/**
+/** {zh}
+ * @hidden
+ * @brief 语言类型
+ */
+/** {en}
  * @hidden
  * @brief 语言类型
  */
@@ -315,7 +321,7 @@ export interface Lang {
 	en: string;
 	[props: string]: string;
 }
-/**
+/** {zh}
  * @brief 弹幕项
  * @list Options
  * @kind property
@@ -323,7 +329,11 @@ export interface Lang {
  * @interface DanmuItem
  */
 /** {en}
- * @brief 弹幕项配置
+ * @list Options
+ * @kind property
+ * @export
+ * @interface DanmuItem
+ * @brief 弹幕项
  */
 export interface DanmuItem {
 	/**
@@ -1359,6 +1369,146 @@ export declare type IPlayerOptions = {
 		volumeColor?: string;
 	};
 };
+/**
+ * @brief mobile端交互配置。
+ * @list Options
+ * @kind property
+ */
+export interface IMobileConfig {
+	/**
+	 * @brief 是否禁用手势，手势包括：
+	 * - 水平手势滑动快进/快退
+	 * - 左侧手势滑动调节亮度
+	 * - 右侧手势滑动调节音量（iOS不可用）
+	 * @default false
+	 */
+	disableGesture?: boolean;
+	/**
+	 * @brief 是否启用水平手势处理，水平手势快进/快退
+	 * @default false
+	 */
+	gestureX?: boolean;
+	/**
+	 * @brief 是否启用垂直手势处理, 垂直手势包括屏幕右侧和屏幕左侧，默认左侧调节亮度，右侧调节音量，左右范围比例通过scopeL和scopeR设置
+	 * @default false
+	 */
+	gestureY?: boolean;
+	/**
+	 * @brief 左侧手势范围比例，取值0-1
+	 * @default 0.25
+	 */
+	scopeL?: number;
+	/**
+	 * @brief 右侧手势范围，取值0-1
+	 * @default 0.25
+	 */
+	scopeR?: number;
+	/**
+	 * @brief 是否启用左侧调暗功能，因为web端无法调用系统的亮度，这个功能实际使用透明蒙层实
+	 * @default true
+	 */
+	darkness?: boolean;
+	/**
+	 * @brief 播放器可调节的最大暗度，即蒙层最大透明度
+	 * @default 0.6
+	 */
+	maxDarkness?: number;
+	/**
+	 * @brief 是否启用上下渐变阴影，即在播放器在激活时上下范围内有阴影
+	 * - normal 上下阴影
+	 * - none 无阴影
+	 * - top 仅上阴影
+	 * - bottom 仅下阴影
+	 * @default normal
+	 */
+	gradient?: "normal" | "none" | "top" | "bottom";
+	/**
+	 * @brief 是否在touchMove事件触发时（即手势滑动时）同时更新播放器的currentTime, 在手势移动过程中，不会直接调用播放器的快进快退，在toucheEnd的时候再设置
+	 * @default false
+	 */
+	isTouchingSeek?: boolean;
+	/**
+	 * @brief 手势滑动的最小步伐，单位px，即滑动距离超过多少算作滑动，以减少不必要的滑动手势事件触发
+	 * @default 5
+	 */
+	miniMoveStep?: number;
+	/**
+	 * @brief 长按快进倍速
+	 * @default 2
+	 */
+	pressRate?: number;
+	/**
+	 * @brief 是否禁用时间预览雪碧图面板
+	 * @notice 前提需要配置进度条预览雪碧图 thumbnail
+	 * @default true
+	 */
+	disableActive?: boolean;
+	/**
+	 * @brief 是否禁用时间进度条，即拖动时不展示mini进度条
+	 * @default false
+	 */
+	disableTimeProgress?: boolean;
+	/**
+	 * @brief 手势拖动的时候是否隐藏控制栏
+	 * @default true
+	 */
+	hideControlsActive?: boolean;
+	/**
+	 * @brief 手势结束时隐藏控制栏
+	 * @default false
+	 */
+	hideControlsEnd?: boolean;
+	/**
+	 * @brief 滑动播放器区域快进/快退时，播放器区域对应的时长，即完整滑过播放器所对应的时长，单位ms
+	 * @default 360000
+	 */
+	moveDuration?: number;
+	/**
+	 * @brief 是否关闭双击切换暂停/播放的能力，同closeVideoDblclick
+	 * @default false
+	 */
+	closedbClick?: boolean;
+	/**
+	 * @brief 禁用长按倍速调整
+	 * @default true
+	 */
+	disablePress?: boolean;
+	/**
+	 * @brief 是否禁用快进/快退的时候按钮提示
+	 * @default false
+	 */
+	disableSeekIcon?: boolean;
+}
+/**
+ * @brief 播放器中间切换暂停/播放的按钮。
+ * @list Options
+ * @kind property
+ */
+export interface IStartConfig {
+	/**
+	 * @brief 暂停是否常驻
+	 * @default true
+	 */
+	isShowPause?: boolean;
+	/**
+	 * @brief 是否播放结束常驻
+	 * @default false
+	 */
+	isShowEnd?: boolean;
+	/**
+	 * @brief 是否禁用点击动画
+	 * @default pc：true，mobile：false
+	 */
+	disableAnimate?: boolean;
+	/**
+	 * @brief 按钮的跟随模式
+	 * - hide：起播之后隐藏
+	 * - show：常驻一直存在
+	 * - auto：自动跟随，播放器激活时即player.isActive=true的时候显示，否则隐藏
+	 * @default hide
+	 */
+	mode?: "hide" | "show" | "auto";
+}
 /**
  * @brief 自动播放配置。
  * @list Options
@@ -1408,7 +1558,7 @@ export interface IAutoplayPluginConfig {
 	 */
 	enableUserActionAutoplay?: boolean;
 	/**
-	 * @brief 静音自动播放时，是否在播放器容器上居中展示取消静音的大按钮
+	 * @brief 静音自动播放时，是否在播放器容器上居中展示取消静音的大按钮。
 	 * @default true
 	 */
 	showUnmuteBtn?: boolean;
@@ -1462,12 +1612,13 @@ export declare const enum TOGGLE_MODES {
  */
 export interface IPlayListItem {
 	/**
-	 * @notes `playAuthToken` 为空时，此参数必传。
+	 * @notes 临时播放 Token 为空时，此参数必传。
 	 * @default -
 	 * @listtip `playAuthToken` 为空时，此参数必传。
 	 * @brief 视频地址。
 	 */
 	/** {en}
+	 * @notes 临时播放 Token 为空时，此参数必传。
 	 */
 	url?: string;
 	/**
@@ -1953,6 +2104,8 @@ declare enum RTMCodec {
  *        - `'sg'`：暂不生效
  *        - `'va'`：暂不生效
  */
+/** {en}
+ */
 export declare type TRegionType = "cn" | "mya" | "va" | "sg";
 /** {zh}
  * @brief 音乐循环模式：
@@ -1961,6 +2114,8 @@ export declare type TRegionType = "cn" | "mya" | "va" | "sg";
  *        - `'loop'`：列表循环
  *        - `'random'`：列表随机
  */
+/** {en}
+ */
 export declare type PlayModeType = "order" | "sloop" | "loop" | "random";
 export interface IMusicListItem {
 	/** {zh}
@@ -1996,6 +2151,10 @@ export interface IMusicListItem {
  * @list Options
  * @kind property
  */
+/** {en}
+ * @list Options
+ * @kind property
+ */
 export interface IABCycle {
 	/** {zh}
 	 * @default 0
@@ -2030,6 +2189,10 @@ export interface IABCycle {
  * @brief 音乐播放模式配置。
  * @kind property
  */
+/** {en}
+ * @list Options
+ * @kind property
+ */
 export interface IMusicConfig {
 	/** {zh}
 	 * @default false
@@ -2080,7 +2243,12 @@ export interface IMusicConfig {
  * @list Options
  * @brief 播放地址列表，可配置多线路和多清晰度。
  * @kind property
- *
+ * @export
+ * @interface Stream
+ */
+/** {en}
+ * @list Options
+ * @kind property
  * @export
  * @interface Stream
  */
@@ -2096,8 +2264,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 */
 	streamType?: string;
 	/** {zh}
-	 * @brief 播放地址
-	 * 如果是数组形式，则数组每项需要传入src和type，分别表示视频地址及类型，在非MSE的播放方式下，将以HTML@{link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source <source>} 形式设置视频资源
+	 * @brief 视频播放地址。
 	 * @type {Url}
 	 * @memberof IPlayerConfig
 	 */
@@ -2169,6 +2336,9 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 /** {zh}
  * @hidden
  */
+/** {en}
+ * @hidden
+ */
 export interface Condition {
 	definition?: string;
 	lineId?: number | string;
@@ -2177,6 +2347,9 @@ export interface Condition {
 /** {zh}
  * @hidden
  */
+/** {en}
+ * @hidden
+ */
 export interface Current {
 	definition: string;
 	streamType: string;
@@ -2193,10 +2366,13 @@ export interface Current {
 	 */
 	[propName: string]: any;
 }
-/**
+/** {zh}
+ * @detail Options
+ * @brief URL 类型。支持字符串和数组。如果是数组形式，则每个数组项应包含视频播放地址 `src` 和视频容器格式类型 `type`，在 HTML `<video />` 元素中使用 [`<source />`](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source) 元素设置多种格式的视频源。以 `<source />` 元素设置的地址不支持 MSE（媒体源扩展）播放场景，例如 PC 上播放 HLS 视频或安卓上播放 HLS 加密视频。
+ */
+/** {en}
  * @detail Options
- * @brief url 类型，支持字符串和数组，当为数组时将以HTML@{link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source <source>} 形式设置视频资源，可设置多个格式以兼容不同的浏览器
- * 注意：数组形式的url不支持hls、dash等的MSE方式播放
+ * @brief URL type. Supports strings and arrays. If it's in the form of an array, each item in the array should contain the video playback address `src` and the video container format type `type`. Use the [<source />](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/source) element in the HTML `<video />` element to set multiple format video sources. The addresses set with the `<source />` element do not support MSE (Media Source Extensions) playback scenarios, such as playing HLS videos on PCs or encrypted HLS videos on Android.
  */
 export declare type Url = string | Array<{
 	src: string;
@@ -2233,7 +2409,6 @@ 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?: Url;
@@ -2247,7 +2422,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	vid?: string;
 	/** {zh}
-	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时 `playAuthToken`，下发给客户端。
+	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时临时播放 Token，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
 	 * @memberof IPlayerConfig
 	 */
@@ -2527,6 +2702,57 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default false
 	 */
 	enableMenu?: boolean;
+	/**
+	 * @brief 是否关闭pc端单击播放器区域切换播放/暂停
+	 * @default false
+	 */
+	closeVideoClick?: boolean;
+	/**
+	 * @brief pc端: 是否关闭双击播放器进入全屏的能力
+	 * mobile端: 是否关闭双击切换暂停/播放的能力
+	 * @default pc端: true， mobile端: false
+	 */
+	closeVideoDblclick?: boolean;
+	/**
+	 * @brief 是否关闭播放器自动失焦（只在pc端生效）
+	 * @default false
+	 */
+	closeDelayBlur?: boolean;
+	/**
+	 * @brief 播放器focus状态自动消失延迟时长，单位为ms
+	 * @default pc端: 2000， mobile端: 3000
+	 */
+	inactive?: number;
+	/**
+	 * @brief 用户鼠标离开播放器区域之后，控制栏隐藏延时时间，如果想要鼠标移出播放器区域就隐藏，则配置为0（只在pc端生效）
+	 * @default 0
+	 */
+	leavePlayerTime?: number;
+	/**
+	 * @brief 是否关闭play时触发player焦点状态
+	 * @default pc端：true, mobile端：false
+	 */
+	closePlayVideoFocus?: boolean;
+	/**
+	 * @brief 是否关闭pause时触发player焦点状态，会强制呼出控制栏
+	 * @default false
+	 */
+	closePauseVideoFocus?: boolean;
+	/**
+	 * @brief 是否需要在退出全屏后滚动定位到全屏之前的位置。（一般安卓下退出全屏后页面会滚动）
+	 * @default false
+	 */
+	needFullscreenScroll?: boolean;
+	/**
+	 * @brief 移动端交互插件配置
+	 * @default -
+	 */
+	mobile?: IMobileConfig;
+	/**
+	 * @brief 播放器中间切换暂停/播放的按钮插件配置
+	 * @default -
+	 */
+	start?: IStartConfig;
 	/** {zh}
 	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生 `video` 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
 	 * @notes 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
@@ -2626,7 +2852,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	enableH265Degrade?: boolean;
 	/** {zh}
-	 * @brief 是否开启地址过期检测，开启后以轮询的方式将当前时间与过期时间戳进行对比，以判断是否过期
+	 * @brief 是否开启视频播放地址过期检测。开启后，播放器会轮询地将播放器所在的客户端时间与过期时间戳进行比较，以判断视频播放地址是否过期。
 	 * @default false
 	 */
 	enableUrlExpireCheck?: boolean;
@@ -2636,23 +2862,23 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	urlExpireTimestamp?: number;
 	/**
-	 * @brief 判断地址过期的阈值，单位秒(s)。如设置为500时，则在过期前500ms时就可以检测出过期执行更新地址操作，为更新地址留足足够缓冲时间。
+	 * @brief 判断视频播放地址过期的阈值。单位为秒。如设置为 500，则 SDK 会在地址过期前 500 秒时就触发过期事件 `Events.MEDIA_EXPIRED`，为您更新地址留足缓冲时间。
 	 * @default 60
 	 */
 	urlExpireDiff?: number;
 	/**
-	 * @brief 地址过期检测任务的时间间隔，单位ms。
+	 * @brief 视频播放地址过期检测的时间间隔。单位为毫秒。播放器以这个时间间隔轮询地将播放器所在的客户端时间与过期时间戳进行比较，以判断地址是否过期。
 	 * @default 400
 	 */
 	urlCheckExpireInterval?: number;
 	/** {zh}
 	 * @hidden
-	 * @brief 资源过期时的回调函数，用来更新视频资源
+	 * @brief 播放源过期的回调函数。可用来更新播放源数据。
 	 * @default -
 	 */
 	onMediaExpired?: () => Promise<SourceConfig>;
 	/** {zh}
-	 * @brief `playAuthToken` 过期时的回调函数，可用来更新 `playAuthToken`。
+	 * @brief 临时播放 Token 过期时的回调函数，可用来更新临时播放 Token。
 	 * @default -
 	 */
 	onTokenExpired?: () => Promise<IPlayAuthTokenConfig>;
@@ -2702,7 +2928,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	EncryptHlsPlugin?: Partial<IEncryptHlsPluginConfig> | boolean;
 	/** {zh}
-	 * @brief 质量日志上报配置
+	 * @brief 质量日志上报配置。
 	 * @default -
 	 */
 	vodLogOpts?: Partial<IVodLogOptsConfig>;
@@ -2713,7 +2939,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	Mp4EncryptPlayer?: Partial<IMp4EncryptPlayerConfig> | boolean;
 	/** {zh}
-	 * @brief 自适应码率配置项
+	 * @brief 自适应码率配置。
 	 * @default -
 	 */
 	autoBitrateOpts?: IAutoBitrateOpts;
@@ -2747,18 +2973,18 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	playListPlugin?: IPlayListConfig;
 	/** {zh}
-	 * @brief 动态水印配置
+	 * @brief 动态水印配置。
 	 * @default -
 	 */
 	dynamicwatermark?: IWatermarkConfig;
 	/** {zh}
-	 * @brief 进度条预览缩略图配置
+	 * @brief 进度条预览缩略图配置。
 	 * @default -
 	 */
 	thumbnail?: IThumbnailConfig;
 }
 /**
- * @brief source数据，可包含url、playList、getVideoByToken和urlExpireTimestamp
+ * @brief 播放源数据。支持传入视频播放地址 `url`、播放列表 `playList` 或者 `vid` 和 `playAuthToken`，还需包含新地址的过期时间戳 `urlExpireTimestamp`。
  */
 export declare type SourceConfig = Pick<IPlayerConfig, "url" | "playList" | "getVideoByToken" | "urlExpireTimestamp">;
 /** {zh}
@@ -3212,44 +3438,242 @@ export interface ApiMapConfig {
 	playDomain: string;
 	backupPlayDomain?: string;
 }
+declare enum PreloadScene {
+	/**
+	 * 普通场景（手动执行预加载）
+	 */
+	NORMAL = 0,
+	/**
+	 * Feed流场景（播放器自动执行预加载）
+	 */
+	FEED = 1
+}
 declare enum StrategyNames {
-	H265 = "h265"
+	/**
+	 * h265
+	 */
+	H265 = "h265",
+	/**
+	 * 预加载
+	 */
+	PRELOAD = "preload"
 }
-/**
+/**{zh}
  * @hidden
- * @brief 策略配置项
+ * h265策略配置
+ * @detail detail
+ */
+export declare type IH265Config = {
+	/**
+	 * h265策略依赖Module
+	 */
+	Strategy?: any;
+	/**
+	 * 是否禁用265策略
+	 */
+	disabled?: boolean;
+} & VeStrategyH265Config;
+/**{zh}
+ * 预加载初始配置
+ * @detail detail
+ */
+export declare type IPreloadConfig = {
+	/**
+	 * 预加载场景
+	 * @default 0
+	 * */
+	preloadScene?: PreloadScene;
+	/**
+	 * 向前预加载视频个数，Feed流场景时生效
+	 * @default 1
+	 */
+	prevCount?: number;
+	/**
+	 * 向后预加载视频个数，Feed流场景生效
+	 * @default 2
+	 */
+	nextCount?: number;
+	/**
+	 * 单个视频预加载时长
+	 * @default 5
+	 */
+	preloadTime?: number;
+	/**
+	 * 最大视频缓存个数
+	 * @default 15
+	 */
+	preloadMaxCacheCount?: number;
+	/**
+	 * 预加载依赖Module
+	 */
+	Strategy?: any;
+	/**
+	 * 是否禁用预加载
+	 */
+	disabled?: boolean;
+};
+/**{zh}
+ * 高级能力（策略）配置
+ * @detail detail
  */
 export declare type StrategyConfigOptions = {
-	[StrategyNames.H265]?: boolean | {
-		Strategy?: any;
-		disabled?: boolean;
-		config?: VeStrategyH265Config;
-	};
+	/**
+	 * @hidden
+	 * h265策略配置
+	 */
+	[StrategyNames.H265]?: boolean | IH265Config;
+	/**
+	 * 预加载配置
+	 */
+	[StrategyNames.PRELOAD]?: boolean | IPreloadConfig;
 };
-export declare type StrategyInitOptions = Omit<VeStrategyInitOptions, "strategies"> & {
-	Module: typeof VeStrategy;
+/**{zh}
+ * 播放器预初始化配置
+ * @detail detail
+ */
+export declare type StrategyInitOptions = {
+	/**
+	 * 应用ID
+	 */
+	appId: number;
+	/**
+	 * 高级能力（策略）配置
+	 */
 	strategies: StrategyConfigOptions;
+	/**
+	 * 设备ID
+	 */
+	deviceId?: string;
+	/**
+	 * 手动注入依赖插件，默认自动加载
+	 */
+	plugins?: any[];
+	/**
+	 * 策略Module，默认自动加载
+	 */
+	Module?: typeof VeStrategy;
+};
+/**{zh}
+ * 预加载实例，通过预加载实例可执行一些高级方法
+ * @detail detail
+ */
+export declare type PreloaderManager = {
+	/**
+	 * 移除所有已预加载数据
+	 */
+	removeAll(): void;
+	/**
+	 * 移除所有预加载任务
+	 */
+	removeAllPreloadTask(): void;
+	/**
+	 * 清空待预加载列表
+	 */
+	clearPreloadList(): void;
+};
+declare enum PreloaderStatus {
+	/**
+	 * 不可用
+	 */
+	DISABLED = 0,
+	/**
+	 * 初始状态
+	 */
+	INITIALIZING = 1,
+	/**
+	 * 已Ready
+	 */
+	READY = 2,
+	/**
+	 * 加载失败
+	 */
+	FAILED = 3
+}
+/**{zh}
+ * 预加载配置更新
+ * @detail detail
+ */
+export declare type IPreloadUpdateConfig = {
+	/**
+	 * 向前加载视频个数
+	 */
+	prevCount?: number;
+	/**
+	 * 向后加载视频个数
+	 */
+	nextCount?: number;
+};
+/**{zh}
+ * 预加载视频资源
+ * @detail detail
+ */
+export declare type IPreloadStream = {
+	/**
+	 * 视频唯一ID
+	 */
+	vid: string;
+	/**
+	 * 播放地址
+	 */
+	url: string;
+	/**
+	 * 视频清晰度
+	 */
+	definition: string;
+	/**
+	 * 视频streamType，暂只支持 mp4
+	 */
+	streamType: string;
+	/**
+	 * 视频codec，暂支持 h264
+	 */
+	codec: string;
+	/**
+	 * 码率, 数据统计需要，可选填
+	 */
+	bitrate: number;
+	/**
+	 * 视频时长，数据统计需要，可选填
+	 */
+	duration: number;
+	/**
+	 * 视频大小，数据统计需要，可选填
+	 */
+	size: number;
 };
 declare class VeStrategyWrapper {
+	private tea;
 	private static mapStrategyNameToUmdKey;
 	private static TEA_ID;
+	preloader: PreloaderManagerOrigin | undefined;
+	preloaderStatus: PreloaderStatus;
 	private sdkUmdLoader;
 	private webId;
 	private config;
 	private status;
 	private initPromise;
+	private preloadCacheConfig;
+	private preloadCacheScene;
+	private preloadCacheList;
 	constructor();
 	private initUmdLoader;
 	private fetchWebId;
+	private initTea;
 	private fetchVeStrategy;
 	private fetchStrategies;
 	private initOnce;
 	init(config: StrategyInitOptions): Promise<boolean>;
+	initPreloadService(options: StrategyInitOptions): Promise<boolean>;
+	addPreloadList(list: IPreloadStream[]): void;
+	setPreloadList(list: IPreloadStream[]): Promise<void>;
+	setPreloadScene(preloadScene: PreloadScene, options?: any): void;
 	prepare(): Promise<boolean>;
 	getDeviceId(): string;
 	isReady(): boolean;
 	getStrategyRecommendations(): StrategyRecommendation;
+	getStrategyRecommendationsAsync(): Promise<StrategyRecommendation>;
 	isHevcRecommended(): boolean;
+	private initPreloaderConfig;
 }
 declare const _default: VeStrategyWrapper;
 declare class PlayerData {
@@ -3426,7 +3850,9 @@ declare enum UmdKeys {
 	StreamProbe = "streamprobe",
 	VeStrategy = "vestrategy",
 	VeStrategyH265 = "vestrategy_h265",
-	DashAbralgo = "DashAbralgo"
+	VeStrategyPreload = "vestrategy_preload",
+	DashAbralgo = "DashAbralgo",
+	Preloader = "preloader"
 }
 /**
  * @hidden
@@ -3473,7 +3899,10 @@ declare class umdLoader {
 	 */
 	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
 }
-/**
+/** {zh}
+ * @hidden
+ */
+/** {en}
  * @hidden
  */
 export declare type PlayerCore = Player & {
@@ -3595,6 +4024,37 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	static sdkVersion: string;
+	/**{zh}
+	 * @brief 播放器预初始化配置
+	 * @param options 初始化配置，详情见{@link StrategyInitOptions}
+	 */
+	static prepare(options: StrategyInitOptions): Promise<void>;
+	/**{zh}
+	 * @brief 设置预加载模式
+	 * @param preloadScene 预加载模式，详情见{@link PreloadScene}
+	 * @param options 预加载配置更新，详情见{@link IPreloadUpdateConfig}
+	 */
+	static setPreloadScene(preloadScene: PreloadScene, options?: IPreloadUpdateConfig): void;
+	/**{zh}
+	 * @brief 获取预加载实例，可通过预加载实例执行高级方法，需在VePlayer.prepare Promise执行完成之后才能获取到预加载实例
+	 * @returns 预加载实例，详情见{@link PreloaderManager}
+	 */
+	static get preloader(): PreloaderManager | undefined;
+	/**{zh}
+	 * @brief 获取当前预加载实例状态
+	 * @returns 预加载实例状态，详情见{@link PreloaderStatus}
+	 */
+	static get preloaderStatus(): PreloaderStatus;
+	/**{zh}
+	 * @brief 添加待预加载视频列表
+	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}。
+	 */
+	static addPreloadList(list: IPreloadStream[]): void;
+	/**{zh}
+	 * @brief 设置待预加载视频列表，替换当前已设置的待预加载列表
+	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}
+	 */
+	static setPreloadList(list: IPreloadStream[]): Promise<void>;
 	/**
 	 * @hidden
 	 * @param codec
@@ -3819,8 +4279,8 @@ declare class VePlayer {
 	 */
 	private _onMediaExpiredAction;
 	/**
-	 * @brief 更新视频源，常用于地址过期时或者过期前更新视频地址及过期时间戳
-	 * @param source 视频资源配置，支持传入地址url、playList、getVideByToken以及过期检查的相关配置
+	 * @brief 更新播放源。您可在视频播放地址过期前调用此方法更新地址及过期时间戳。
+	 * @param source 播放源配置。详见 [SourceConfig](1248901#sourceconfig)。支持传入视频播放地址 `url`、播放列表 `playList` 或者 `vid` 和 `playAuthToken`，还需包含新地址的过期时间戳 `urlExpireTimestamp`。
 	 */
 	updateMediaSource(source: SourceConfig): Promise<void>;
 	/** {zh}
@@ -3868,17 +4328,17 @@ declare class VePlayer {
 	 */
 	getSdkPlugin(name: any): any;
 	/** {zh}
-	 * @brief 播放时更换 `playAuthToken`，以更换视频源。
+	 * @brief 播放时更换临时播放 Token，以更换视频源。
 	 * @memberof VePlayer
-	 * @param config `playAuthToken` 配置。
+	 * @param config 临时播放 Token 配置。
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	switchAuthToken(config: IPlayAuthTokenConfig, isNewVideo?: boolean): Promise<void>;
 	/** {zh}
-	 * @brief 更新 `playAuthToken`。
+	 * @brief 更新临时播放 Token。
 	 * @memberof VePlayer
-	 * @notes 播放前 `playAuthToken` 过期（收到 `play_auth_token_expired` 事件或者 `onTokenExpired` 回调触发）时，调用此方法更新 `playAuthToken`。
-	 * @param config `playAuthToken` 配置。
+	 * @notes 播放前临时播放 Token 过期（收到 `play_auth_token_expired` 事件或者 `onTokenExpired` 回调触发）时，调用此方法更新临时播放 Token。
+	 * @param config 临时播放 Token 配置。
 	 */
 	updateAuthToken(config: IPlayAuthTokenConfig): Promise<void>;
 	private _playerPlayNext;