@volcengine/veplayer 1.17.0-rc.0 → 1.17.0-rc.1

package/index.d.ts

@@ -897,6 +897,20 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
+export interface IAudioTrackConfig {
+	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 5 */
+	index?: number;
+	/** 是否显示图标按钮。@default true */
+	isShowIcon?: boolean;
+	/** 竖屏时是否隐藏控件。@default false */
+	hidePortrait?: boolean;
+}
+export interface IAudioTrackMobileConfig {
+	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 2.6 */
+	index?: number;
+	/** 是否显示图标按钮。@default true */
+	isShowIcon?: boolean;
+}
 /**
  * @brief DASH 播放配置。
  * @list Options
@@ -2378,24 +2392,36 @@ export interface IMusicListItem {
 	 * @type {string}
 	 * @brief 音乐播放地址。
 	 */
+	/** {en}
+	 * @brief Music playback URL.
+	 */
 	src: string;
 	/** {zh}
 	 * @type {string | number}
 	 * @memberof IMusicListItem
 	 * @brief 音乐唯一 ID。
 	 */
+	/** {en}
+	 * @brief Unique music ID.
+	 */
 	vid: string | number;
 	/** {zh}
 	 * @type {string}
 	 * @memberof IMusicListItem
 	 * @brief 音乐封面 URL 地址。
 	 */
+	/** {en}
+	 * @brief Music cover image URL.
+	 */
 	poster?: string;
 	/** {zh}
 	 * @type {string}
 	 * @memberof IMusicListItem
 	 * @brief 音乐标题。
 	 */
+	/** {en}
+	 * @brief Music title.
+	 */
 	title?: string;
 	/** {zh}
 	 * @hidden
@@ -2419,6 +2445,10 @@ export interface IABCycle {
 	 * @memberof IABCycle
 	 * @brief AB 循环段开始时间，单位为秒。
 	 */
+	/** {en}
+	 * @brief AB loop start time in seconds.
+	 * @default 0
+	 */
 	start: number;
 	/** {zh}
 	 * @default 音乐结束时间点
@@ -2427,6 +2457,10 @@ export interface IABCycle {
 	 * @memberof IABCycle
 	 * @brief AB 循环段开始时间，单位为秒。
 	 */
+	/** {en}
+	 * @brief AB loop end time in seconds.
+	 * @default End of audio
+	 */
 	end: number;
 	/** {zh}
 	 * @default false
@@ -2434,6 +2468,10 @@ export interface IABCycle {
 	 * @memberof IABCycle
 	 * @brief AB 段是否循环播放。
 	 */
+	/** {en}
+	 * @brief Whether to loop the AB segment.
+	 * @default false
+	 */
 	loop?: boolean;
 	/**
 	 * @hidden
@@ -2457,6 +2495,10 @@ export interface IMusicConfig {
 	 * @memberof IMusicConfig
 	 * @brief 是否启用离线下载播放。
 	 */
+	/** {en}
+	 * @brief Whether to enable offline downloaded playback.
+	 * @default false
+	 */
 	offline?: boolean;
 	/** {zh}
 	 * @default null
@@ -2465,6 +2507,10 @@ export interface IMusicConfig {
 	 * @memberof IMusicConfig
 	 * @brief AB 循环播放配置。
 	 */
+	/** {en}
+	 * @brief AB loop playback configuration.
+	 * @default null
+	 */
 	abCycle?: IABCycle | null;
 	/** {zh}
 	 * @default 15
@@ -2473,6 +2519,10 @@ export interface IMusicConfig {
 	 * @memberof IMusicConfig
 	 * @brief 快进快退时间跨度，单位为秒。
 	 */
+	/** {en}
+	 * @brief Fast-forward / rewind step in seconds.
+	 * @default 15
+	 */
 	timeScale?: number;
 	/** {zh}
 	 * @default order
@@ -2481,6 +2531,10 @@ export interface IMusicConfig {
 	 * @memberof IMusicConfig
 	 * @brief 循环模式。
 	 */
+	/** {en}
+	 * @brief Playback loop mode: `order`, `sloop` (single loop), `loop` (list loop), `random`.
+	 * @default order
+	 */
 	mode?: PlayModeType;
 	/** {zh}
 	 * @default []
@@ -2489,6 +2543,10 @@ export interface IMusicConfig {
 	 * @memberof IMusicConfig
 	 * @brief 播放列表。
 	 */
+	/** {en}
+	 * @brief Music playlist.
+	 * @default []
+	 */
 	list?: Array<IMusicListItem>;
 	/** {zh}
 	 * @hidden
@@ -2518,18 +2576,27 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 *        - `"mp4"`
 	 *        - `"hls"`
 	 */
+	/** {en}
+	 * @brief Stream type: `"rtm"`, `"flv"`, `"mp4"`, or `"hls"`.
+	 */
 	streamType?: string;
 	/** {zh}
 	 * @brief 视频播放地址。
 	 * @type {Url}
 	 * @memberof IPlayerConfig
 	 */
+	/** {en}
+	 * @brief Video playback URL.
+	 */
 	url: Url;
 	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
 	 * @brief 清晰度 key
 	 */
+	/** {en}
+	 * @brief Definition key for this stream.
+	 */
 	definition?: string;
 	/** {zh}
 	 * @type {string}
@@ -2537,6 +2604,10 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @brief 映射清晰度 key
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Mapped definition key.
+	 * @default -
+	 */
 	mapDefinition?: string;
 	/** {zh}
 	 * @type {string}
@@ -2548,10 +2619,17 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @brief 编码格式
 	 * @default unknown
 	 */
+	/** {en}
+	 * @brief Codec type of this stream.
+	 * @default unknown
+	 */
 	codec?: ICodecType;
 	/** {zh}
 	 * @brief 线路唯一 ID
 	 */
+	/** {en}
+	 * @brief Unique line (CDN route) ID.
+	 */
 	lineId?: number | string;
 	/** {zh}
 	 * @example
@@ -2602,6 +2680,9 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	/** {zh}
 	 * @brief 私有加密播放的加密密钥，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuth
 	 */
+	/** {en}
+	 * @brief Encryption key for private-encrypted playback, corresponding to `PlayAuth` in the GetPlayInfo response.
+	 */
 	secretKey?: string;
 	/**
 	 * @brief 视频为加密视频时的加密类型
@@ -2697,6 +2778,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 * @listtip `id` 和 `root` 参数需至少传入 1 个。如果都传入，则优先使用 `root` 参数。
 	 */
+	/** {en}
+	 * @brief Player container ID. The player will be inserted into this container. At least one of `id` or `root` must be provided.
+	 * @default -
+	 */
 	id?: string;
 	/** {zh}
 	 * @brief 播放器容器 DOM 元素。VePlayer 将被插入该容器中。
@@ -2704,11 +2789,19 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 * @listtip `id` 和 `root` 参数需至少传入 1 个。如果都传入，则优先使用 `root` 参数。
 	 */
+	/** {en}
+	 * @brief Player container DOM element. VePlayer will be inserted into this container. At least one of `id` or `root` must be provided; `root` takes precedence when both are provided.
+	 * @default -
+	 */
 	root?: HTMLElement;
 	/** {zh}
 	 * @brief 视频播放地址。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video playback URL.
+	 * @default -
+	 */
 	url?: Url;
 	/** {zh}
 	 * @brief 视频点播服务中的视频 ID。推荐填写，以方便跟踪该视频的播放质量。您将音视频上传至视频点播服务后，可通过以下方式获取 `Vid`：
@@ -2718,21 +2811,35 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - 如果您设置了媒资上传完成的回调事件，会在 [FileUploadComplete](https://www.volcengine.com/docs/4/4655) 中返回 `Vid`。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video ID in the VOD service. Recommended for tracking playback quality.
+	 * @default -
+	 */
 	vid?: string;
 	/** {zh}
 	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时临时播放 Token，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
 	 * @memberof IPlayerConfig
 	 */
+	/** {en}
+	 * @brief Vid playback configuration. The app server generates a temporary play token from `vid` and passes it to the client.
+	 */
 	getVideoByToken?: IPlayAuthTokenConfig;
 	/** {zh}
 	 * @brief 视频加密类型
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video encryption type.
+	 * @default -
+	 */
 	drmType?: EDRMTYPE;
 	/** {zh}
 	 * @brief 私有加密会话id
 	 */
+	/** {en}
+	 * @brief Private encryption session ID.
+	 */
 	encryptSessionId?: string;
 	/**
 	 * @brief 视频为加密视频时的密钥KeyId，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuthId
@@ -2742,6 +2849,9 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
 	 * @brief 私有加密播放的加密密钥，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuth
 	 */
+	/** {en}
+	 * @brief Encryption key for private-encrypted playback, corresponding to `PlayAuth` in the GetPlayInfo response.
+	 */
 	playAuth?: string;
 	/** {zh}
 	 * @brief 视频格式。取值如下：
@@ -2751,21 +2861,36 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `flv`
 	 * @listtip 如果 `url` 参数取值中不包含文件格式后缀，则 `streamType` 必填。
 	 */
+	/** {en}
+	 * @brief Video format. Required when the `url` does not include a file extension.
+	 */
 	streamType?: "mp4" | "hls" | "dash" | "rtm" | "flv";
 	/** {zh}
 	 * @brief 播放器宽度。可传入数字或者 CSS `width` 属性值。如为数字，单位为 px。
 	 * @default 100%
 	 */
+	/** {en}
+	 * @brief Player width. Accepts a number (px) or a CSS `width` value.
+	 * @default 100%
+	 */
 	width?: number | string;
 	/** {zh}
 	 * @brief 播放器高度。可传入数字或者 CSS `width` 属性值。如为数字，单位为 px。
 	 * @default 100%
 	 */
+	/** {en}
+	 * @brief Player height. Accepts a number (px) or a CSS `height` value.
+	 * @default 100%
+	 */
 	height?: number | string;
 	/** {zh}
 	 * @brief 默认起播音量。取值范围为 [0,1]。
 	 * @default 0.6
 	 */
+	/** {en}
+	 * @brief Initial playback volume. Range: [0, 1].
+	 * @default 0.6
+	 */
 	volume?: number;
 	/** {zh}
 	 * @brief 是否开启自动播放。取值如下：
@@ -2775,10 +2900,17 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @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)。
 	 */
+	/** {en}
+	 * @brief Whether to enable autoplay. Subject to browser autoplay policies.
+	 * @default false
+	 */
 	autoplay?: boolean;
 	/** {zh}
 	 * @brief 视频封面图配置。
 	 */
+	/** {en}
+	 * @brief Video poster image configuration.
+	 */
 	poster?: string | IPoster;
 	/** {zh}
 	 * @brief 是否开启静音自动播放。取值如下：
@@ -2786,6 +2918,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：关闭静音自动播放。
 	 *  @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable muted autoplay.
+	 * @default false
+	 */
 	autoplayMuted?: boolean;
 	/** {zh}
 	 * @brief 是否开启降级静音自动播放。开启后，有声音自动播放失败时，会降级成静音自动播放。取值如下：
@@ -2793,6 +2929,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：关闭降级静音自动播放
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to fall back to muted autoplay when autoplay with sound fails.
+	 * @default false
+	 */
 	enableDegradeMuteAutoplay?: boolean;
 	/** {zh}
 	 * @brief 启用微信jsBridge方式的自动播放，默认不开启
@@ -2811,6 +2951,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：不开启
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to allow the first user interaction (any click) to trigger autoplay.
+	 * @default false
+	 */
 	enableUserActionAutoplay?: boolean;
 	/** {zh}
 	 * @brief 是否开启循环播放。取值如下：
@@ -2818,11 +2962,19 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：关闭循环播放。
 	 *  @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable loop playback.
+	 * @default false
+	 */
 	loop?: boolean;
 	/** {zh}
 	 * @brief 默认起播倍速。可设为 `0.5`、`0.75`、`1`、`1.5`、`2`。
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief Default playback rate. Supported values: `0.5`, `0.75`, `1`, `1.5`, `2`.
+	 * @default 1
+	 */
 	defaultPlaybackRate?: number;
 	/** {zh}
 	 * @brief 界面语言。取值如下：
@@ -2832,6 +2984,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `zh-hk`
 	 * @default zh
 	 */
+	/** {en}
+	 * @brief UI language. Supported values: `zh`, `zh-cn`, `en`, `jp`, `zh-hk`.
+	 * @default zh
+	 */
 	lang?: "zh" | "zh-cn" | "en" | "jp" | "zh-hk";
 	/** {zh}
 	 * @brief 多语言词典。可设置每个语种的词典，例如：
@@ -2842,6 +2998,9 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @see 了解更多，请参见{@link https://www.volcengine.com/docs/6469/127529 默认词典}。
 	 * @listtip 了解更多，请参见[默认词典](https://www.volcengine.com/docs/6469/127529)。
 	 */
+	/** {en}
+	 * @brief i18n dictionary. Provide per-language key-value maps, e.g. `{ zh: { PIP: '画中画' }, en: { PIP: 'pip' } }`.
+	 */
 	languages?: {
 		[key: string]: Record<string, any>;
 	};
@@ -2851,17 +3010,28 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @notes 画中画功能由浏览器提供，如果本身浏览器不支持，即使有该配置也不显示画中画按钮
 	 * @listtip 画中画功能由浏览器提供。如果浏览器不支持，即使传入此配置也不会显示画中画按钮。
 	 */
+	/** {en}
+	 * @brief Picture-in-picture configuration. Requires browser-level PiP support.
+	 * @default PC: {position: 'controlsRight', index: 2.5, showIcon: true}; mobile: false
+	 */
 	pip?: IPIPConfig | boolean;
 	/** {zh}
 	 * @brief 全屏配置。
 	 * @default {position: 'controlsRight', index: 0, rotateFullscreen: false, useCssFullscreen: false, target: null, switchCallback: null, disable: false, needBackIcon: false }
 	 */
+	/** {en}
+	 * @brief Fullscreen configuration.
+	 */
 	fullscreen?: IFullscreenConfig;
 	/** {zh}
 	 * @breif 是否总是显示清晰度切换控件，即只有一个清晰度时也显示清晰度切换控件
 	 * @default false
 	 * @brief 是否总是显示清晰度切换控件，即只有单个清晰度时也显示清晰度切换控件。
 	 */
+	/** {en}
+	 * @brief Whether to always show the definition selector, even when only one definition is available.
+	 * @default false
+	 */
 	alwaysShowDefinition?: boolean;
 	/** {zh}
 	 * @breif url对应视频的清晰度文案，仅`alwaysShowDefinition`为`true`时有效
@@ -2869,12 +3039,20 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip 仅 `alwaysShowDefinition` 为 `true` 时有效。
 	 * @brief `url` 参数对应视频的清晰度文案。
 	 */
+	/** {en}
+	 * @brief Display label for the definition corresponding to `url`. Only effective when `alwaysShowDefinition` is `true`.
+	 * @default HD
+	 */
 	definitionText?: string;
 	/** {zh}
 	 * @brief `url` 参数对应视频的清晰度文案的多语言 key，对应参数 `languages` 中的文案。
 	 * @default -
 	 * @listtip 仅 `alwaysShowDefinition` 为 `true` 时有效，优先级高于 `definitionText`。
 	 */
+	/** {en}
+	 * @brief i18n key for the definition label of `url`, mapping to `languages`. Takes priority over `definitionText`.
+	 * @default -
+	 */
 	definitionTextKey?: string;
 	/** {zh}
 	 * @brief 视频编码格式。
@@ -2882,6 +3060,9 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
 	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
+	/** {en}
+	 * @brief Video codec type. Recommended when the codec is known, to improve log analysis and soft-decode initialization.
+	 */
 	codec?: ICodecType;
 	/** {zh}
 	 * @brief 点播服务所在区域，影响服务接口的请求域名
@@ -2933,6 +3114,9 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief `video` 标签扩展属性。播放器初始化时会设置在 `videoElement` 或 `audioElement` 对象上。请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看支持的属性。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Extra attributes applied to the `videoElement` / `audioElement` on initialization. See [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties).
+	 */
 	videoAttributes?: Partial<HTMLVideoElement>;
 	/** {zh}
 	 * @brief 是否启用流式布局。启用流式布局后，播放器会根据屏幕宽度进行自适应调整，以确保在不同屏幕尺寸上都能呈现良好的显示效果。取值如下：
@@ -2943,6 +3127,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *          - 如果 `width` 和 `height` 不是 `Number` 类型，默认使用 16:9 比例。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable fluid layout. When enabled, the player adapts its aspect ratio based on `width` / `height` (defaults to 16:9 when they are non-numeric).
+	 * @default false
+	 */
 	fluid?: boolean;
 	/** {zh}
 	 * @brief 尺寸适配方式。在视频资源初始化之后，根据获取到的 `videoWidth` 和 `videoHeight` 的值对播放器容器宽高比进行调整。取值如下：
@@ -2951,6 +3139,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `fixHeight`: 保持容器高度，仅适配宽度。
 	 * @default fixed
 	 */
+	/** {en}
+	 * @brief Container size adaptation mode after video metadata is loaded. `fixed`: keep container ratio; `fixWidth`: adapt height; `fixHeight`: adapt width.
+	 * @default fixed
+	 */
 	fitVideoSize?: "fixWidth" | "fixHeight" | "fixed";
 	/** {zh}
 	 * @brief 视频画面填充模式，等同于设置{@link https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit CSS object-fit}属性。取值如下：
@@ -2961,6 +3153,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `fillHeight`: 填充高度，宽度溢出则裁剪宽度，当播放器容器宽高比大于视频的宽高比，等同于设置CSS `object-fit: cover`。
 	 * @default auto
 	 */
+	/** {en}
+	 * @brief Video fill mode, equivalent to CSS `object-fit`. `auto`: browser default (may produce letterboxing); `fill`: stretch; `cover`: crop to fill; `fillWidth` / `fillHeight`: fill one axis and crop the other.
+	 * @default auto
+	 */
 	videoFillMode?: "auto" | "fillHeight" | "fillWidth" | "fill" | "cover";
 	/** {zh}
 	 * @brief 是否开启画面和控制栏分离模式。开启时，控制栏将会常驻，与视频画面不重叠。
@@ -2968,11 +3164,18 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：关闭
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to separate the video canvas from the controls bar. When enabled, the controls bar is always visible and does not overlap the video.
+	 * @default false
+	 */
 	marginControls?: boolean;
 	/** {zh}
 	 * @brief 是否启用 X5 内核浏览器的同层播放。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Enable same-layer playback for X5 kernel browsers.
+	 */
 	"x5-video-player-type"?: string;
 	/** {zh}
 	 * @brief 是否启用 X5 内核浏览器的全屏播放模式。
@@ -2980,6 +3183,9 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：停用
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Whether to enable fullscreen playback mode for X5 kernel browsers.
+	 */
 	"x5-video-player-fullscreen"?: boolean;
 	/** {zh}
 	 * @brief X5 内核浏览器的横竖屏控制。取值如下：
@@ -2988,11 +3194,19 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `landscape|portrait`：跟随手机自动旋转
 	 * @default `landscape|portrait`（移动端）
 	 */
+	/** {en}
+	 * @brief Screen orientation for X5 kernel browsers. `landscape`, `portrait`, or `landscape|portrait` (auto-rotate).
+	 * @default `landscape|portrait` (mobile)
+	 */
 	"x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
 	/** {zh}
 	 * @brief 为播放器配置关键点样式。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Key point style configuration for the player.
+	 * @default -
+	 */
 	commonStyle?: ICommonStyle;
 	/** {zh}
 	 * @brief 是否开启音乐播放模式。开启后，您可还通过 `music` 参数对音乐播放器进行配置。取值如下：
@@ -3000,6 +3214,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：停用音乐播放模式
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable music playback mode. Use `music` for further music player configuration.
+	 * @default false
+	 */
 	isMusic?: boolean;
 	/** {zh}
 	 * @hidden
@@ -3020,6 +3238,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：开启。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to stop event propagation on the `video` element.
+	 * @default false
+	 */
 	closeVideoStopPropagation?: boolean;
 	/** {zh}
 	 * @brief 是否开启右键菜单。取值如下：
@@ -3027,6 +3249,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：否。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable the right-click context menu.
+	 * @default false
+	 */
 	enableMenu?: boolean;
 	/**
 	 * @brief 是否禁用 PC 端点击播放器区域切换播放和暂停功能。
@@ -3112,39 +3338,88 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/** {zh}
 	 * @brief 是否开启 HLS 视频的 MSE 模式。仅移动端生效。默认情况下，在移动端使用原生 `video` 播放 HLS 视频。开启后，将采用 MSE 方式播放 HLS 视频，实现更好的兼容性、能控制缓存、节省流量。
 	 * @notes 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to use MSE for HLS playback on mobile (default is native `video`). Improves compatibility, cache control, and bandwidth usage.
+	 * @default false
 	 */
 	enableHlsMSE?: boolean;
+	/** {zh}
+	 * @brief 是否启用 {@link https://hlsjs.video-dev.org/ hls.js} 插件播放HLS视频，默认为true，设置为false后，PC端播放HLS使用自研hls插件播放HLS视频
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to use the hls.js plugin for HLS playback on PC. When `false`, the built-in HLS adapter is used instead.
+	 * @default true
+	 */
+	enableHlsJs?: boolean;
 	/** {zh}
 	 * @brief 在 PC Safari 上是否 HLS 插件播放视频。取值如下：
 	 *        - `true`：使用 HLS 插件。SDK 会自动加载 HLS 插件。
 	 *        - `false`：不使用 HLS 插件。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to use the HLS plugin on PC Safari. When `true`, the SDK loads the HLS plugin automatically.
+	 * @default true
+	 */
 	useHlsPluginForSafari?: boolean;
 	/** {zh}
 	 * @brief 是否开启 MP4 视频的 MSE 模式。开启后，将采用 MSE 方式播放 MP4，实现精确的 Seek 加载、视频的无缝切换、流量节省等功能。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to use MSE for MP4 playback, enabling accurate seek, seamless stream switching, and bandwidth savings.
+	 * @default false
+	 */
 	enableMp4MSE?: boolean;
 	/** {zh}
 	 * @brief 播放地址列表。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Playlist of video streams with multi-definition and multi-line support.
+	 * @default -
+	 */
 	playList?: Stream[];
 	/** {zh}
 	 * @brief 默认清晰度。仅当 `playList` 有值时生效。
 	 * @default playList第一项
 	 */
+	/** {en}
+	 * @brief Default definition. Effective only when `playList` is set.
+	 * @default First item of playList
+	 */
 	defaultDefinition?: string;
+	/** {zh}
+	 * @brief 起播默认音频轨道的语言代码（BCP-47，如 `"zh-cn"`、`"en"`）。
+	 * @notes HLS 流匹配 `audioTrack.lang`；iOS 原生播放匹配 `audioTrack.language`。
+	 *        多条轨道语言相同时取第一条。未匹配到时沿用 manifest 默认轨道。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Default audio track language code (BCP-47, e.g. `"zh-cn"`, `"en"`) at playback start. Falls back to the manifest default when no match is found.
+	 * @default -
+	 */
+	defaultAudioLang?: string;
 	/** {zh}
 	 * @brief 插件，可自行选择安装的插件，支持{@link https://h5player.bytedance.com/plugins/ 西瓜播放器插件}。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Additional plugins to install. Compatible with XGPlayer plugins.
+	 * @default -
+	 */
 	plugins?: any[];
 	/** {zh}
 	 * @brief 用于禁用插件。VePlayer 内置了一些常用的功能插件。如需禁用某一内置插件，可传入插件名称（不区分大小写）。
 	 * @default []
 	 */
+	/** {en}
+	 * @brief List of built-in plugin names to disable (case-insensitive).
+	 * @default []
+	 */
 	ignores?: string[];
 	/** {zh}
 	 * @brief 默认配置
@@ -3187,6 +3462,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 * @notes 插件可以从{@link https://www.volcengine.com/docs/4/67077 集成SDK} 章节中下载SDK离线包获取
 	 */
+	/** {en}
+	 * @brief Fallback URL map for UMD plugin dependencies when the default CDN is unreachable. Supported keys: `hls`, `flv`, `XGVideo`, `hlsEncrypt`, `dash`, `mp4Encrypt`, `danmujs`, `danmuMask`, `subtitle`.
+	 * @default -
+	 */
 	umdUrlMap?: Record<string, string>;
 	/**
 	 * @brief 唯一 ID，用于[私有加密方案](https://www.volcengine.com/docs/4/106524)。
@@ -3204,6 +3483,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip - 移动端浏览器不支持 FLV 格式，如果需要播放该格式的视频，请开启软解。
 	 *          - 软解播放的解码操作依赖设备 CPU，播放高码率、高分辨率的视频时，对 CPU 占用率较高。
 	 */
+	/** {en}
+	 * @brief Whether to enable software decoding. Required for FLV on mobile. High CPU usage on high-bitrate / high-resolution videos.
+	 * @default false
+	 */
 	useSoftDecoding?: boolean;
 	/** {zh}
 	 * @brief 是否开启 H.265 自动降级模式。开启 H.265 兼容模式后，VePlayer 会在不支持 H.265 硬解的浏览器环境下，自动降级为兼容模式。取值如下：
@@ -3212,11 +3495,19 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *        - `false`：不开启 H.265 自动降级模式。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable H.265 auto-degrade mode. When enabled, VePlayer falls back to a compatible mode in browsers that do not support H.265 hardware decoding.
+	 * @default false
+	 */
 	enableH265Degrade?: boolean;
 	/** {zh}
 	 * @brief 是否开启视频播放地址过期检测。开启后，播放器会轮询地将播放器所在的客户端时间与过期时间戳进行比较，以判断视频播放地址是否过期。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable URL expiry polling. The player periodically compares the client time against `urlExpireTimestamp`.
+	 * @default false
+	 */
 	enableUrlExpireCheck?: boolean;
 	/**
 	 * @brief 地址的过期时间戳，单位秒(s)，vid模式下不用输入，播放器自动获取。如果是火山引擎的CDN分发地址，在不传入过期时间戳时，则需指定urlType，支持{@link https://www.volcengine.com/docs/4/177191 A-E类型}，其他云厂商或者业务服务器存储的地址不支持。
@@ -3237,11 +3528,19 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 播放源过期的回调函数。可用来更新播放源数据。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Callback invoked when the playback source expires. Use it to refresh source data.
+	 * @default -
+	 */
 	onMediaExpired?: () => Promise<SourceConfig>;
 	/** {zh}
 	 * @brief 临时播放 Token 过期时的回调函数，可用来更新临时播放 Token。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Callback invoked when the temporary play token expires. Use it to refresh the token.
+	 * @default -
+	 */
 	onTokenExpired?: () => Promise<IPlayAuthTokenConfig>;
 	/** {zh}
 	 * @hidden
@@ -3256,78 +3555,192 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 是否开启日志打印。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable debug log output.
+	 * @default false
+	 */
 	debug?: boolean;
 	/** {zh}
 	 * @brief 播放器报错信息。支持配置播放异常时显示的异常文案、图片以及是否提供刷新按钮等。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Error UI configuration. Controls the error message, image, and refresh button displayed on playback failure.
+	 * @default -
+	 */
 	sdkErrorPlugin?: ISdkErrorConfig;
 	/** {zh}
-	 * @brief rtm配置，配置rtm拉流参数
-	 * @notes 传入rtm流url时才生效
-	 * @default -
-	 * @hidden
+	 * @brief 非 MSE 播放模式下（含加密 HLS），触发媒体错误后的窗口内最大重试次数。
+	 * @default 3
 	 */
 	/** {en}
-	 * @hidden
+	 * @brief Maximum number of retries within the sliding window for media errors in non-MSE mode (including encrypted HLS).
+	 * @default 3
 	 */
-	rtm?: IRtmConfig;
+	oriErrRetryCount?: number;
 	/** {zh}
-	 * @brief 弹幕及面板配置。支持配置弹幕文字大小、透明度、展示区域等参数。
-	 * @default -
+	 * @brief 重试滑动窗口时长（ms）。窗口内超过 `oriErrRetryCount` 次重试后停止并进行错误诊断。
+	 * @default 10000
 	 */
-	DanmuPlugin?: IDanmuConfig | boolean;
-	/** {zh}
-	 * @brief 清晰度降级配置。
-	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
+	/** {en}
+	 * @brief Sliding window duration (ms) for retry counting. Retries stop and error analysis begins once `oriErrRetryCount` is reached within the window.
+	 * @default 10000
 	 */
-	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
+	oriErrRetryCycle?: number;
 	/** {zh}
-	 * @hidden
-	 * @brief DASH 播放配置项
-	 * @default -
+	 * @brief 重试指数退避基础延迟（ms）。第 n 次重试延迟为 `oriErrRetryBaseDelay * 2^(n-1)`。
+	 * @default 500
 	 */
 	/** {en}
-	 * @hidden
+	 * @brief Base delay (ms) for exponential backoff between retries. The delay for the nth retry is `oriErrRetryBaseDelay * 2^(n-1)`.
+	 * @default 500
 	 */
-	DASHPlugin?: Partial<IDashPluginConfig>;
+	oriErrRetryBaseDelay?: number;
 	/** {zh}
-	 * @brief HLS 加密播放配置。
-	 * @default -
+	 * @brief 最大总重试次数（跨窗口累计）。设为 `0` 表示不限制。
+	 * @default 0
 	 */
-	EncryptHlsPlugin?: Partial<IEncryptHlsPluginConfig> | boolean;
-	/** {zh}
-	 * @brief 质量日志上报配置。
-	 * @default -
+	/** {en}
+	 * @brief Maximum total retry count accumulated across all windows. Set to `0` to disable the limit.
+	 * @default 0
 	 */
-	vodLogOpts?: Partial<IVodLogOptsConfig>;
+	oriErrMaxTotalRetry?: number;
 	/** {zh}
-	 * @brief 日志tea的id，一般不需要配置，播放器会自动设置。
-	 * @default 火山国内：4951，海外：323254
+	 * @brief 是否在重试耗尽后发起错误诊断请求，以细化错误码。
+	 * @default true
 	 */
 	/** {en}
-	 * @brief The id of the log tea. Generally, no configuration is required and the player will automatically set it.。
-	 * @default 323254
+	 * @brief Whether to perform error analysis after retries are exhausted, to refine the error code.
+	 * @default true
 	 */
-	logTeaAppId?: number;
+	needSyncAnalyzeError?: boolean;
 	/** {zh}
-	 * @hidden
-	 * @brief mp4加密播放配置项
-	 * @default -
+	 * @brief 网络诊断请求超时时间（ms）。
+	 * @default 3000
 	 */
 	/** {en}
-	 * @hidden
+	 * @brief Timeout (ms) for the network analysis request.
+	 * @default 3000
+	 */
+	analyzeTimeout?: number;
+	/** {zh}
+	 * @brief 需要忽略、不上报的错误码列表。
+	 * @default []
+	 */
+	/** {en}
+	 * @brief List of error codes to suppress and not report.
+	 * @default []
+	 */
+	ignoreErrorCodes?: Array<string | number>;
+	/** {zh}
+	 * @brief PC 端音频轨道切换插件配置。传 `false` 可禁用该插件。
+	 * @notes 仅在多音轨视频中生效；单音轨时插件自动隐藏。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief PC audio track selector plugin configuration. Pass `false` to disable. Only effective for multi-track videos.
+	 * @default -
+	 */
+	AudioTrack?: IAudioTrackConfig | false;
+	/** {zh}
+	 * @brief 移动端音频轨道切换插件配置。传 `false` 可禁用该插件。
+	 * @notes 仅在多音轨视频中生效；单音轨时插件自动隐藏。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Mobile audio track selector plugin configuration. Pass `false` to disable. Only effective for multi-track videos.
+	 * @default -
+	 */
+	AudioTrackMobile?: IAudioTrackMobileConfig | false;
+	/** {zh}
+	 * @brief rtm配置，配置rtm拉流参数
+	 * @notes 传入rtm流url时才生效
+	 * @default -
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
+	rtm?: IRtmConfig;
+	/** {zh}
+	 * @brief 弹幕及面板配置。支持配置弹幕文字大小、透明度、展示区域等参数。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Danmaku (bullet comment) and panel configuration. Supports font size, opacity, display area, etc.
+	 * @default -
+	 */
+	DanmuPlugin?: IDanmuConfig | boolean;
+	/** {zh}
+	 * @brief 清晰度降级配置。
+	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
+	 */
+	/** {en}
+	 * @brief Definition auto-demote configuration. Requires `DefinitionDemotePlugin` in `plugins`.
+	 */
+	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
+	/** {zh}
+	 * @hidden
+	 * @brief DASH 播放配置项
+	 * @default -
+	 */
+	/** {en}
+	 * @hidden
+	 */
+	DASHPlugin?: Partial<IDashPluginConfig>;
+	/** {zh}
+	 * @brief HLS 加密播放配置。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Encrypted HLS playback configuration.
+	 * @default -
+	 */
+	EncryptHlsPlugin?: Partial<IEncryptHlsPluginConfig> | boolean;
+	/** {zh}
+	 * @brief 质量日志上报配置。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Quality metrics log reporting configuration.
+	 * @default -
+	 */
+	vodLogOpts?: Partial<IVodLogOptsConfig>;
+	/** {zh}
+	 * @brief 日志tea的id，一般不需要配置，播放器会自动设置。
+	 * @default 火山国内：4951，海外：323254
+	 */
+	/** {en}
+	 * @brief The id of the log tea. Generally, no configuration is required and the player will automatically set it.
+	 * @default 323254
+	 */
+	logTeaAppId?: number;
+	/** {zh}
+	 * @hidden
+	 * @brief mp4加密播放配置项
+	 * @default -
+	 */
+	/** {en}
+	 * @hidden
 	 */
 	Mp4EncryptPlayer?: Partial<IMp4EncryptPlayerConfig> | boolean;
 	/** {zh}
 	 * @brief 多码率自适应播放配置。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Adaptive bitrate (ABR) playback configuration.
+	 * @default -
+	 */
 	autoBitrateOpts?: IAutoBitrateOpts;
 	/** {zh}
 	 * @brief 动态 Buffer 配置。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Dynamic buffer range configuration.
+	 * @default -
+	 */
 	adaptRange?: IAdaptRange;
 	/** {zh}
 	 * @brief 视频时长。
@@ -3342,45 +3755,73 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 外挂字幕配置。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief External subtitle configuration.
+	 * @default -
+	 */
 	Subtitle?: ISubtitleConfig;
 	/** {zh}
 	 * @type {IMemoryPlayConfig}
 	 * @memberof IPlayerConfig
 	 * @brief 记忆播放配置。
 	 */
+	/** {en}
+	 * @brief Resume playback (memory play) configuration.
+	 */
 	MemoryPlay?: IMemoryPlayConfig | boolean;
 	/** {zh}
 	 * @type {IMusicConfig}
 	 * @memberof IPlayerConfig
 	 * @brief 音乐播放器配置。
 	 */
+	/** {en}
+	 * @brief Music player configuration. Effective when `isMusic` is `true`.
+	 */
 	music?: IMusicConfig;
 	/** {zh}
 	 * @type {IMusicConfig}
 	 * @memberof IPlayerConfig
 	 * @brief 自动播放配置。
 	 */
+	/** {en}
+	 * @brief Autoplay plugin configuration.
+	 */
 	AutoplayPlugin?: IAutoplayPluginConfig;
 	/** {zh}
 	 * @type { IPlayListConfig }
 	 * @memberof IPlayerConfig
 	 * @brief 播放列表配置。
 	 */
+	/** {en}
+	 * @brief Playlist plugin configuration.
+	 */
 	playListPlugin?: IPlayListConfig;
 	/** {zh}
 	 * @brief 动态水印配置。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Dynamic watermark configuration.
+	 * @default -
+	 */
 	dynamicwatermark?: IWatermarkConfig;
 	/** {zh}
 	 * @brief 进度条预览缩略图配置。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Progress bar thumbnail preview configuration.
+	 * @default -
+	 */
 	thumbnail?: IThumbnailConfig;
 	/** {zh}
 	 * @brief 进度条标记配置
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Progress bar dot marker configuration.
+	 * @default -
+	 */
 	progressDot?: IDot[];
 	/** {zh}
 	 * @brief 移动端下倍速、清晰度等选择弹窗的样式
@@ -3464,6 +3905,10 @@ export interface IDefaultConfig {
 	 * 如果是对象则可以对音量控制插件进行各型特性单独配置
 	 * @default 0.6
 	 */
+	/** {en}
+	 * @brief Volume configuration. A number sets the default volume [0, 1]; an object allows per-feature configuration.
+	 * @default 0.6
+	 */
 	volume?: IVolume;
 	/** {zh}
 	 * @brief 弹幕插件配置
@@ -3471,6 +3916,9 @@ export interface IDefaultConfig {
 	 * @type {*}
 	 * @memberof IDefaultConfig
 	 */
+	/** {en}
+	 * @brief Danmaku plugin configuration.
+	 */
 	DanmuPlugin?: any;
 	/** {zh}
 	 * @brief 字幕插件配置
@@ -3478,6 +3926,9 @@ export interface IDefaultConfig {
 	 * @type {*}
 	 * @memberof IDefaultConfig
 	 */
+	/** {en}
+	 * @brief Live subtitle icon plugin configuration.
+	 */
 	LiveSubtitlesIconPlugin?: any;
 }
 /** {zh}
@@ -3490,11 +3941,19 @@ export interface IPlayAuthTokenConfig {
 	 * @brief 应用服务端生成的临时播放凭证。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Temporary play token generated by the app server.
+	 * @default -
+	 */
 	playAuthToken: string;
 	/** {zh}
 	 * @brief 默认清晰度。对应 [GetPlayInfo](https://www.volcengine.com/docs/4/2918) 接口返回的 `Definition`。为空时默认为接口返回的最高清晰度。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Default definition, corresponding to `Definition` in the GetPlayInfo response. Defaults to the highest available when empty.
+	 * @default -
+	 */
 	defaultDefinition?: string;
 	/** {zh}
 	 * @brief 获取播放地址的请求域名。
@@ -3514,6 +3973,10 @@ export interface IPlayAuthTokenConfig {
 	 * @default false
 	 * @listtip 请确保您已在视频点播控制台中生成和设置封面图，详见[封面图和封面候选](https://www.volcengine.com/docs/4/5335)。
 	 */
+	/** {en}
+	 * @brief Whether to use the poster image set in the VOD console.
+	 * @default false
+	 */
 	needPoster?: boolean;
 	/** {zh}
 	 * @brief 是否使用您在视频点播控制台上生成的雪碧图。取值如下：
@@ -3523,6 +3986,10 @@ export interface IPlayAuthTokenConfig {
 	 * @default false
 	 * @listtip 请确保您已通过视频点播媒体处理服务生成雪碧图，详见[雪碧图](https://www.volcengine.com/docs/4/1171758)。
 	 */
+	/** {en}
+	 * @brief Whether to use the sprite sheet (thumbnail) generated by the VOD media processing service.
+	 * @default false
+	 */
 	needThumbs?: boolean;
 	/** {zh}
 	 * @brief 是否使用您在视频点播控制台上生成的蒙版弹幕。取值如下：
@@ -3532,17 +3999,29 @@ export interface IPlayAuthTokenConfig {
 	 * @default false
 	 * @listtip 请确保您已通过视频点播媒体处理服务生成蒙版弹幕。
 	 */
+	/** {en}
+	 * @brief Whether to use the masked danmaku generated by the VOD media processing service.
+	 * @default false
+	 */
 	needBarrageMask?: boolean;
 	/** {zh}
 	 * @brief 是否需要获取展示多个清晰度。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to fetch and display multiple definition options.
+	 * @default true
+	 */
 	needDefinitionList?: boolean;
 	/** {zh}
 	 * @briefhls标准加密播放所需要的keyToken
 	 * @default -
 	 * @brief 用于 HLS 标准加密播放的 keyToken。
 	 */
+	/** {en}
+	 * @brief Key token required for HLS standard-encrypted playback.
+	 * @default -
+	 */
 	keyToken?: string;
 	/** {zh}
 	 * @hidden
@@ -3557,6 +4036,10 @@ export interface IPlayAuthTokenConfig {
 	 *        - `unionInfo`: 由 `unionId` 生成的 `unionInfo`，用来加密`PrivateDrmAuthToken`。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Async callback to fetch `PrivateDrmAuthToken`. Receives `playAuthIds` (comma-separated key IDs), `vid`, and `unionInfo`.
+	 * @default -
+	 */
 	getDrmAuthToken?: (playAuthIds: string, vid: string, unionInfo: string) => Promise<string>;
 	/**
 	 * @brief 商业DRM 获取license的token
@@ -3583,6 +4066,10 @@ export interface IPlayAuthTokenConfig {
 	 * 具体可传参数见{@link https://www.volcengine.com/docs/4/65659 签发 PlayAuthToken}
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Extra pass-through query parameters (e.g. `{ aid: 1234 }`). Parameters from `playAuthToken` take highest priority.
+	 * @default -
+	 */
 	reqParams?: Record<string, number | string | boolean>;
 	/** {zh}
 	 * @brief 定义清晰度的映射。
@@ -3614,24 +4101,46 @@ export interface IPlayAuthTokenConfig {
 	 * @brief 点播服务发生 502 错误时的重试次数。
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief Number of retries when the VOD service returns a 502 error.
+	 * @default 1
+	 */
 	retryCount?: number;
 	/** {zh}
 	 * @brief 清晰度自动降级开启时的自动档位，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo}返回的Definition字段
 	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Auto-demote definition target when definition auto-demote is enabled. Corresponds to `Definition` in GetPlayInfo response.
+	 * @default -
+	 */
 	autoDemoteDefinition?: string;
 	/** {zh}
 	 * @brief 开启清晰度自动降级（`isNeedAutoDemote` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
 	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief i18n key for the auto-demote definition label, mapping into `languages`.
+	 * @default -
+	 */
 	autoDemoteDefinitionTextKey?: string;
 	/** {zh}
 	 * @brief 视频地址请求时携带的额外query参数
 	 * @notes 一般用于携带HLS标准加密播放携带
 	 */
+	/** {en}
+	 * @brief Extra query parameters appended to video URL requests. Typically used for HLS standard-encrypted playback.
+	 */
 	urlQueryParams?: Record<string, string>;
+	/** {zh}
+	 * @brief HLS 播放时是否使用master m3u8 地址作为播放源
+	 */
+	/** {en}
+	 * @brief Whether to use the master m3u8 URL as the playback source for HLS.
+	 */
+	useMasterM3u8?: boolean;
 }
 /** {zh}
  * @list Options
@@ -3736,6 +4245,10 @@ export interface IPIPConfig extends IPluginConfig {
 	 *        - `false`：不显示画中画按钮。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to show the picture-in-picture button.
+	 * @default false
+	 */
 	showIcon?: boolean;
 	/** {zh}
 	 * @brief 是否优先使用[网页画中画](https://developer.mozilla.org/en-US/docs/Web/API/DocumentPictureInPicture)。
@@ -3745,26 +4258,46 @@ export interface IPIPConfig extends IPluginConfig {
 	 * @default false
 	 * @listtip 仅浏览器支持 `DocumentPictureInPicture` 时才生效。
 	 */
+	/** {en}
+	 * @brief Whether to prefer `DocumentPictureInPicture` (web PiP) when available.
+	 * @default false
+	 */
 	preferDocument?: boolean;
 	/** {zh}
 	 * @brief 网页画中画模式下窗口的宽度。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Width of the document PiP window.
+	 * @default -
+	 */
 	width?: number;
 	/** {zh}
 	 * @brief 网页画中画模式下窗口的高度。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Height of the document PiP window.
+	 * @default -
+	 */
 	height?: number;
 	/** {zh}
 	 * @brief 网页画中画模式下窗口的根节点。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Root element of the document PiP window.
+	 * @default -
+	 */
 	docPiPNode?: HTMLElement;
 	/** {zh}
 	 * @brief 文档画中画窗口的 css style
 	 * @default -
 	 */
+	/** {en}
+	 * @brief CSS style for the document PiP window.
+	 * @default -
+	 */
 	docPiPStyle?: ((...arg: any) => string) | string;
 }
 /** {zh}
@@ -3785,6 +4318,10 @@ export interface IFullscreenConfig {
 	 *        - `false`：系统全屏。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to use CSS fullscreen instead of native system fullscreen.
+	 * @default false
+	 */
 	useCssFullscreen?: boolean;
 	/** {zh}
 	 * @brief 是否使用旋转横屏。取值如下：
@@ -3797,22 +4334,38 @@ export interface IFullscreenConfig {
 	 * @listtip - 该参数的优先级高于 `useCssFullscreen` 参数。
 	 *          - 该参数一般用于移动端。
 	 */
+	/** {en}
+	 * @brief Whether to rotate the DOM 90° to achieve landscape fullscreen. Takes priority over `useCssFullscreen`. Mainly for mobile.
+	 * @default false
+	 */
 	rotateFullscreen?: boolean;
 	/** {zh}
 	 * @brief 旋转全屏后，锁定屏幕方向。适应于移动端设备全屏观看横屏视频
 	 * @default false
 	 * @notes 仅部分浏览器支持，兼容性见{@link https://caniuse.com/mdn-api_screenorientation_lock ScreenOrientation API: lock}
 	 */
+	/** {en}
+	 * @brief Whether to lock the screen orientation after rotating to fullscreen. Only supported in some browsers.
+	 * @default false
+	 */
 	useScreenOrientation?: boolean;
 	/** {zh}
 	 * @brief 旋转全屏后，锁定屏幕方向类型，默认是横屏，可选值见{@link https://developer.mozilla.org/en-US/docs/Web/API/ScreenOrientation/lock#orientation orientation}
 	 * @default landscape
 	 */
+	/** {en}
+	 * @brief Orientation type to lock after rotating to fullscreen.
+	 * @default landscape
+	 */
 	lockOrientationType?: string;
 	/** {zh}
 	 * @brief 自定义全屏功能的 `dom`。默认是播放器根节点。该参数必须是 `player.root` 的父辈节点，适用于解决全屏时和 `player.root` 同级的 `dom`需要显示的场景。
 	 * @default `null`
 	 */
+	/** {en}
+	 * @brief Custom DOM element for fullscreen. Must be an ancestor of `player.root`. Defaults to the player root node.
+	 * @default null
+	 */
 	target?: HTMLElement;
 	/** {zh}
 	 * @brief 是否禁用全屏按钮。
@@ -3820,6 +4373,10 @@ export interface IFullscreenConfig {
 	 *        - `false`：不禁用。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the fullscreen button. When `true`, the button is not rendered.
+	 * @default false
+	 */
 	disable?: boolean;
 	/** {zh}
 	 * @brief 全屏的时候是否显示右上角返回按钮。取值如下：
@@ -3830,11 +4387,19 @@ export interface IFullscreenConfig {
 	 * @notes 该配置一般在移动端开启
 	 * @listtip 此参数一般用于移动端。
 	 */
+	/** {en}
+	 * @brief Whether to show a back button in the top-right corner during fullscreen. Mainly for mobile.
+	 * @default false
+	 */
 	needBackIcon?: boolean;
 	/** {zh}
 	 * @brief 全屏切换自定义实现。该函数配置相当于完全替代插件内部的切换逻辑。
 	 * @default `null`
 	 */
+	/** {en}
+	 * @brief Custom fullscreen toggle implementation. Completely replaces the built-in toggle logic.
+	 * @default null
+	 */
 	switchCallback?: (...arg: any) => any;
 }
 /** {zh}
@@ -3847,26 +4412,41 @@ export interface ICommonStyle {
 	 * @brief 进度条底色。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Progress bar track color.
+	 */
 	progressColor?: string;
 	/** {zh}
 	 * @brief 播放完成部分进度条底色。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Color of the played portion of the progress bar.
+	 */
 	playedColor?: string;
 	/** {zh}
 	 * @brief 缓存部分进度条底色。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Color of the buffered portion of the progress bar.
+	 */
 	cachedColor?: string;
 	/** {zh}
 	 * @brief 进度条滑块样式。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Style of the progress bar thumb/slider.
+	 */
 	sliderBtnStyle?: CSSStyleDeclaration;
 	/** {zh}
 	 * @brief 音量颜色。
 	 * @default 无
 	 */
+	/** {en}
+	 * @brief Volume control color.
+	 */
 	volumeColor?: string;
 }
 /** {zh}
@@ -3879,11 +4459,19 @@ export interface IPoster {
 	 * @brief 封面图 URL 地址。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Poster image URL.
+	 * @default -
+	 */
 	poster: string;
 	/** {zh}
 	 * @brief 是否在播放结束之后显示封面图。
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to show the poster after playback ends.
+	 * @default true
+	 */
 	isEndedShow?: boolean;
 	/** {zh}
 	 * @brief 是否播放后隐藏封面图。
@@ -3891,11 +4479,19 @@ export interface IPoster {
 	 *        - `false`：在 `play` 事件触发后隐藏封面图。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to hide the poster after playback starts. When `true`, the poster re-appears after a URL update.
+	 * @default false
+	 */
 	hideCanplay?: boolean;
 	/** {zh}
 	 * @brief 是否一直显示封面图。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to keep the poster always visible.
+	 * @default false
+	 */
 	notHidden?: boolean;
 	/** {zh}
 	 * @brief 封面图填充方式。取值如下：
@@ -3904,6 +4500,9 @@ export interface IPoster {
 	 *        - `cover`：完全覆盖容器，多余部分会被裁剪。
 	 *        - `contain`：完全覆盖，与容器不匹配时会被拉伸压缩。
 	 */
+	/** {en}
+	 * @brief Poster fill mode: `fixWidth`, `fixHeight`, `cover` (crop to fill), or `contain` (stretch to fill).
+	 */
 	fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
 }
 /** {zh}
@@ -3916,48 +4515,82 @@ export interface IThumbnailConfig {
 	 * @brief 雪碧图地址数组。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Array of sprite sheet URLs.
+	 * @default -
+	 */
 	urls: Array<string>;
 	/** {zh}
 	 * @brief 缩略小图总张数。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Total number of thumbnail frames.
+	 * @default -
+	 */
 	pic_num: number;
 	/** {zh}
 	 * @brief 雪碧大图中每列包含的缩略小图数量。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Number of thumbnail columns per sprite sheet.
+	 * @default -
+	 */
 	col: number;
 	/** {zh}
 	 * @brief 雪碧大图中每行包含的缩略小图数量。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Number of thumbnail rows per sprite sheet.
+	 * @default -
+	 */
 	row: number;
 	/** {zh}
 	 * @brief 缩略小图高度，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Thumbnail frame height in px.
+	 * @default -
+	 */
 	height?: number;
 	/** {zh}
 	 * @brief 缩略小图宽度，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Thumbnail frame width in px.
+	 * @default -
+	 */
 	width?: number;
 	/** {zh}
 	 * @brief 显示缩放比例
 	 * @default 1
 	 * @hidden
 	 */
+	/** {en}
+	 * @hidden
+	 */
 	scale?: 1;
 	/** {zh}
 	 * @brief 额外添加在dom上的class
 	 * @default -
 	 * @hidden
 	 */
+	/** {en}
+	 * @hidden
+	 */
 	className?: string;
 	/** {zh}
 	 * @brief 是否在竖屏的时候隐藏缩略图。
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to hide the thumbnail in portrait orientation.
+	 * @default false
+	 */
 	hidePortrait?: false;
 }
 export interface ISourceConfig {
@@ -3973,764 +4606,809 @@ export interface ApiMapConfig {
 	playDomain: string;
 	backupPlayDomain?: string;
 }
-export type TLogChannel = "cn" | "va" | "sg";
-declare enum PreloadScene {
-	/**
-	 * 普通场景（手动执行预加载）
-	 */
-	NORMAL = 0,
-	/**
-	 * Feed流场景（播放器自动执行预加载）
-	 * @brief Feed 流场景（播放器自动执行预加载）
-	 */
-	/** {en}
-	 * @brief Feed流场景（播放器自动执行预加载）
-	 */
-	FEED = 1
+declare enum UmdKeys {
+	HLS = "hls",
+	HLSJS = "hlsjs",
+	FLV = "flv",
+	XGVideo = "XGVideo",
+	HLSEncrypt = "hlsEncrypt",
+	DASH = "dash",
+	MP4Encrypt = "mp4Encrypt",
+	DanmuJS = "danmujs",
+	DanmuMask = "danmuMask",
+	StreamProbe = "streamprobe",
+	VeStrategy = "vestrategy",
+	VeStrategyH265 = "vestrategy_h265",
+	VeStrategyPreload = "vestrategy_preload",
+	VeStrategyAdaptRange = "vestrategy_adapt_range",
+	DashAbralgo = "DashAbralgo",
+	Preloader = "preloader",
+	HLSjsPro = "hlsjsPro"
 }
-declare enum StrategyNames {
+/**
+ * @hidden
+ * @breif umdmap 配置
+ */
+export declare type UMDMap = Record<UmdKeys, {
 	/**
-	 * h265
-	 * @brief H.265 策略
+	 * umd Module 的名称，即在window下暴露的接口名称
 	 */
-	H265 = "h265",
+	name: string;
 	/**
-	 * 预加载
-	 * @brief 预加载策略
+	 * 对应umd文件名，只用来标记，实际不使用
 	 */
-	PRELOAD = "preload",
+	pluginName?: string;
 	/**
-	 * Range拆分-动态Buffer
-	 * @brief 动态 Buffer
+	 * 对应npm包的名称，在打包文件时，会在libd.config.js中onPostBuild的钩子中会用于寻找对应npm包
 	 */
-	ADAPT_RANGE = "adaptRange"
-}
-/** {zh}
- * @hidden
- * h265策略配置
- * @detail Options
- */
-export declare type IH265Config = {
+	packageName: string;
 	/**
-	 * h265策略依赖Module
+	 * npm包中umd入口文件路径，用于打包上传到cdn目录
 	 */
-	Strategy?: any;
+	devPath: string;
+}>;
+declare class UMDLoader {
+	private static jsLoadMap;
+	private static jsLoadPromiseMap;
+	umdMap: UMDMap;
+	backupUmdUrlMap: Record<string, string>;
+	failCallback: (umdName: string, err: any) => any;
+	region: TRegionType;
+	userRegion: TRegionType;
+	customPluginPublicPath: string;
+	importedPlugins: any[];
+	constructor();
 	/**
-	 * 是否禁用265策略
+	 * @return { string } 插件加载的公共路径
 	 */
-	disabled?: boolean;
-} & VeStrategyH265Config;
-/** {zh}
- * 预加载初始配置
- * @detail Options
- */
-export declare type IPreloadConfig = {
+	get pluginPublicPath(): string;
 	/**
-	 * 预加载场景
-	 * @default 0
-	 * */
-	preloadScene?: PreloadScene;
+	 * 更新umd的备用地址
+	 * @param {Record<string, string>} map 备用地址map
+	 */
+	updateBackupMap(map: Record<string, string>): void;
 	/**
-	 * 向前预加载视频个数，Feed流场景时生效
-	 * @default 1
-	 * @brief 向前预加载视频个数。Feed 流场景时生效。
+	 * 加载额外的js-sdk
+	 * 适用 umd 模块
+	 * 只能浏览器环境下使用
+	 * @param url 额外加载JS 的 CDN 地址
+	 * @param isJs 是否js文件
 	 */
-	/** {en}
-	 * @brief 向前预加载视频个数，Feed流场景时生效
+	loadExtraCdn(url: string, isJs?: boolean): Promise<void>;
+	/**
+	 * @description 加载xgplayer插件
+	 * @param pluginName 插件名称
+	 * @param successCallback 加载完成后执行的回调
+	 * @return Promise<any>
 	 */
-	prevCount?: number;
+	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
 	/**
-	 * 向后预加载视频个数，Feed流场景生效
-	 * @default 2
-	 * @brief 向后预加载视频个数。Feed 流场景生效
+	 * 处理加载成功
 	 */
-	/** {en}
-	 * @brief 向后预加载视频个数，Feed流场景生效
+	private handleLoadSuccess;
+	/**
+	 * 处理加载失败
 	 */
-	nextCount?: number;
+	private handleLoadError;
 	/**
-	 * 单个视频预加载时长
-	 * @default 5
+	 * 处理catch分支的错误处理
 	 */
-	preloadTime?: number;
+	private handleLoadCatch;
 	/**
-	 * 最大视频缓存个数
-	 * @default 15
+	 * 加载备用URL
 	 */
-	preloadMaxCacheCount?: number;
+	private loadBackupUrl;
 	/**
-	 * 预加载依赖Module
-	 * @brief 预加载依赖 Module
+	 * 触发成功回调
 	 */
-	/** {en}
-	 * @brief 预加载依赖Module
+	private triggerSuccessCallback;
+}
+export declare class SdkPlugin {
+	pluginName: string;
+	__args: any;
+	sdk: VePlayer;
+	playerData: PlayerData;
+	player: Player;
+	_emitter: EventEmitter;
+	static defineGetterOrSetter(Obj: any, map: any): void;
+	/**
+	 * @type { string }
 	 */
-	Strategy?: any;
+	static get pluginName(): string;
 	/**
-	 * 是否禁用预加载
+	 * @constructor
+	 * @param { { sdk: object, pluginName: string, [propName: string]: any;}  } args
 	 */
-	disabled?: boolean;
-};
-/** {zh}
- * @hidden
- * @detail Options
- * @brief Range 拆分（动态Buffer）策略初始配置
- * @notes adaptRange策略配置结构较复杂，暂不开放Range默认配置自定义，使用策略下发
- */
-export declare type IAdaptRangeConfig = {
-	/** {zh}
-	 * @brief 预加载依赖Module
+	constructor(args: any);
+	/**
+	 * @description sdk实例创建，挂载插件实例时首先执行
 	 */
-	Strategy?: any;
-	/** {zh}
-	 * @brief 是否禁用Range拆分策略
+	beforeCreate(): void;
+	/**
+	 * @description sdk实例创建，挂载插件实例完后执行
 	 */
-	disabled?: boolean;
-};
-/** {zh}
- * @detail Options
- * @brief 策略配置。
- */
-export declare type StrategyConfigOptions = {
+	afterCreate(): void;
 	/**
-	 * h265策略配置
-	 * @hidden
-	 * @brief H.265 策略配置。
+	 * @description sdk创建播放器前执行，只有这里能保证异步操作在creatPlayer之前同步完成
 	 */
-	/** {en}
-	 * @hidden
-	 * @brief h265策略配置
+	beforePlayerCreate(): void;
+	/**
+	 * @description sdk创建播放器完执行
 	 */
-	[StrategyNames.H265]?: boolean | IH265Config;
+	afterPlayerCreate(): void;
 	/**
-	 * 预加载配置
-	 * @brief 预加载配置。
+	 * @description sdk销毁时执行
 	 */
-	/** {en}
-	 * @brief 预加载配置
+	destroy(): void;
+	/**
+	 * @private
+	 * @param { any } args
 	 */
-	[StrategyNames.PRELOAD]?: boolean | IPreloadConfig;
+	__init(args: any): void;
 	/**
-	 * Range拆分（动态Buffer）
-	 * @brief 动态 Buffer 配置。
+	 * @description 插件销毁
+	 * @private
 	 */
-	/** {en}
-	 * @brief Range拆分（动态Buffer）
+	__destroy(): void;
+}
+declare class AuthToken extends SdkPlugin {
+	static get pluginName(): string;
+	isPlayByToken: boolean;
+	isEncrypt: boolean;
+	tokenInfo: ITokenInfo;
+	keyTokenInfo: ITokenInfo;
+	thirdPartyDrmAuthTokenInfo: ITokenInfo;
+	config: IPlayAuthTokenConfig;
+	privateDrmAuthToken: string;
+	useUnionInfoDRM: boolean;
+	sessionId: string;
+	retryCount: number;
+	playInfo?: VideoInfoRes;
+	constructor(args: any);
+	beforePlayerCreate(): Promise<void>;
+	getVideoInfo(): Promise<{
+		vid: string;
+		playList: Stream[];
+		codec: ICodecType;
+		defaultDefinition: string;
+	}>;
+	getVideos(): Promise<any>;
+	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
+	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
+	getBarrageMaskUrl(url: string): void;
+	getDrmConfig(videoInfo: IVideoInfo): void;
+	init(): void;
+	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
+	/**
+	 * @description 更新playAuthToken
+	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
+	 * @param {boolean} isNewVideo 是否新视频，即是否为切换视频
 	 */
-	[StrategyNames.ADAPT_RANGE]?: boolean | IAdaptRangeConfig;
-};
+	updateAuthToken(getVideoByToken: IPlayAuthTokenConfig, isNewVideo: boolean): Promise<void>;
+	checkPlayAuthTokenValid(): boolean;
+	checkKeyTokenValid(): boolean;
+	checkDrmAuthTokenValid(): boolean;
+}
 /** {zh}
- * 播放器预初始化配置
- * @detail Options
+ * @hidden
  */
-export declare type StrategyInitOptions = {
-	/** {zh}
-	 * 应用ID
-	 * @brief 应用 ID
-	 */
-	/** {en}
-	 * @brief appid
-	 */
-	appId: number;
-	/** {zh}
-	 * @brief 用户所在区域
-	 * @default cn
-	 * @notes 如果是海外用户，播放时请填写'mya'
-	 */
-	/** {en}
-	 * @brief The region where the user is located,
-	 * @default sg
-	 */
-	region?: TRegionType;
-	/** {zh}
-	 * 高级能力（策略）配置
-	 * @brief 策略配置
-	 */
-	/** {en}
-	 * @brief Advanced Capability (Strategy) Configuration
-	 */
-	strategies: StrategyConfigOptions;
-	/** {zh}
-	 * 设备ID
-	 * @brief 设备 ID
-	 */
-	/** {en}
-	 * @brief device id
-	 */
-	deviceId?: string;
-	/** {zh}
-	 * @brief 手动注入依赖插件，默认自动加载
-	 * @default -
-	 */
-	/** {en}
-	 * @brief Manually inject dependency plugins, automatically load by default
-	 * @default -
-	 */
-	plugins?: any[];
+export interface IAdaptRangeDefaultOptions {
+	maxTargetCacheDur: number;
+	minTargetCacheDur: number;
+	rangeMaxDuration: number;
+	rangeMinDuration: number;
+	cacheSafeFactor: number;
+	estPTcontrol: boolean;
+	estPlayTime: number;
+	minBandwidth: number;
+	minDangerThreshold: number;
+	rangeControl: boolean;
+	rangeMinSize: number;
+	safeFactor: number;
+	targetCacheControl: boolean;
+}
+declare abstract class AbstractBaseAdapter {
+	isLive: boolean;
+	playerData: PlayerData;
+	streamType: string;
+	constructor(options: {
+		configs: IPlayerConfig;
+		playerData: PlayerData;
+		streamType: string;
+	});
 	/**
-	 * 策略Module，默认自动加载
-	 * @brief 策略 Module，默认自动加载
-	 * @default -
-	 */
-	/** {en}
-	 * @brief Strategy Module, automatically loaded by default
-	 * @default -
+	 * @description 是否使用原生video的abr能力
 	 */
-	Module?: typeof VeStrategy;
-};
-/** {zh}
- * 预加载实例，通过预加载实例可执行一些高级方法
- * @detail Options
- * @hidden
- */
-export declare type PreloaderManager = {
+	abstract useNativeAbr(): boolean;
+	abstract canOpenAbr(vidPlayInfo?: VideoInfoRes): boolean;
+	abstract applyAbrPluginConfig(_finalOptions: any, _autoBitrateOpts: any): void;
+	abstract prepareAbrModule(_playerData: any, _sdkUmdLoader: any): void;
+	abstract needAbrAutoDefinition(): boolean;
+	abstract setAbrDefaultDefiWithAuto(): boolean;
+	abstract generatePlaylistFromServer(res: VideoInfoRes, ...args: any[]): Stream[];
+	abstract canAdaptRangeEnable(): boolean;
+	abstract adaptRangeDefaultOptions(): IAdaptRangeDefaultOptions | undefined;
+	abstract applyAdaptRangePluginConfig(_finalOptions: any, _adaptRangeOptions: any): void;
+	abstract applyAdaptRangeStrategy(_finalOptions: any, _adaptRangeOptions: any): void;
+	abstract getPlugins(umdLoader: UMDLoader): Promise<XGPlugin[]>;
+	abstract setPluginConfigInVid(videoInfo: IVideoInfo, context: AuthToken): void;
+}
+declare class PlayerData {
+	id?: string;
+	root?: HTMLElement;
+	configs: IPlayerConfig;
+	type: string;
+	isLive: boolean;
+	options: any;
+	isMobile: boolean;
+	playList: Stream[];
+	plugins: any[];
+	openSoftDecoding: boolean;
+	defaultConfig: IDefaultConfig | undefined;
+	isHitDefault: boolean;
+	codec?: ICodecType;
+	enableH265Degrade: boolean;
+	languageData: {
+		extraLangList: IXGI18nText[];
+		extendLangList: IXGI18nText[];
+	};
+	current: Current;
+	onMediaExpired: () => Promise<SourceConfig>;
+	onTokenExpired: () => Promise<IPlayAuthTokenConfig>;
+	unionId?: string;
+	unionInfo?: string;
+	isMusic?: boolean;
+	sdkPlugins: any[];
+	useHlsPluginForSafari: boolean;
+	enableHlsJs: boolean;
+	enableMenu: boolean;
+	region: TRegionType;
+	userRegion: TRegionType;
+	playDomainDegrade: boolean;
+	strategiesPlugins: any[];
+	strategiesPluginConfigs: any;
 	/**
-	 * 移除所有已预加载数据
+	 * @default playList第一项
 	 */
-	removeAll(): void;
+	defaultDefinition: string;
+	urlCheckData: {
+		enableUrlExpireCheck: boolean;
+		urlExpireTimestamp: number;
+		urlExpireDiff: number;
+		urlCheckExpireInterval: number;
+	};
+	private isAutoBitrateEnable;
+	adapter: AbstractBaseAdapter;
 	/**
-	 * 移除所有预加载任务
+	 * @breif 是否vid模式的加密播放
 	 */
-	removeAllPreloadTask(): void;
+	isVidEncrypt: boolean;
+	dashOpts: {
+		Data: IGetPlayInfoRes;
+	};
 	/**
-	 * 清空待预加载列表
+	 * @brief 播放器sdk实例
 	 */
-	clearPreloadList(): void;
-};
-declare enum PreloaderStatus {
+	sdk: VePlayer;
 	/**
-	 * 不可用
+	 * @brief 当前加密播放类型，为空则表示非加密
 	 */
-	DISABLED = 0,
+	drmType: EDRMTYPE;
 	/**
-	 * 初始状态
+	 * @brief 私有加密会话id
 	 */
-	INITIALIZING = 1,
+	encryptSessionId?: string;
+	constructor(configs: IPlayerConfig & {
+		licensSupportModuleList: string[];
+	}, sdk: VePlayer);
 	/**
-	 * 已Ready
+	 * 初始化播放数据
+	 * @param configs { IPlayerConfig } 播放器配置
 	 */
-	READY = 2,
+	initPlayData(configs: IPlayerConfig): void;
+	initPlaylistAndGetCurrent(configs: IPlayerConfig): Stream;
+	checkAutoBitratePlayList(): boolean;
+	getABRStreamInfo(streamType: any, originDefaultStream: any): {
+		defaultDefinition: string;
+		defaultStream: any;
+		playList: Stream[];
+	};
+	isCurrentH265(): boolean;
+	setDrmType(drmType: EDRMTYPE): void;
+	getCurrentByDefaultConfig(): Stream;
+	initCurrent(currentStreams: Stream): void;
+	initCheckExpireData(): void;
 	/**
-	 * 加载失败
+	 * 更新过期检测的数据
 	 */
-	FAILED = 3
-}
-/** {zh}
- * 预加载配置更新
- * @detail Options
- * @hidden
- */
-export declare type IPreloadUpdateConfig = {
+	updateCheckExpireData(): void;
+	initI18nData(languages: any): {
+		extraLangList: any[];
+		extendLangList: any[];
+	};
 	/**
-	 * 向前加载视频个数
+	 * @description: 获取当前直播url
 	 */
-	prevCount?: number;
+	getCurrentUrl(): Url;
+	getTargetStreamType(stream?: Stream): string;
 	/**
-	 * 向后加载视频个数
+	 * @description: 获取当前的streamType
 	 */
-	nextCount?: number;
-};
-/** {zh}
- * 预加载视频资源
- * @detail Options
- */
-export declare type IPreloadStream = {
+	getCurrentStreamType(): string;
+	getStreamType(): string;
+	isOpenABR(): boolean;
+	showRealDefinition(): boolean;
+	isAutoDefinition(def: any): boolean;
+	isPlayAutoDefinition(def?: string): boolean;
+	isDefinitionMatch(pre: any, next: any): boolean;
 	/**
-	 * 视频唯一ID
-	 * @brief 视频 ID
+	 * @description: 获取满足当前直播条件的流
 	 */
-	/** {en}
-	 * @brief 视频唯一ID
+	getCurrentStreams(): Stream[];
+	/**
+	 * @description: 获取根据线路ID去重的流，用于获取有几个线路
 	 */
-	vid: string;
+	getLineList(): Stream[];
 	/**
-	 * 播放地址
-	 * @brief 视频播放地址
+	 * @description: 根据线路ID获取符合条件的流
+	 * @param {number} lineId
 	 */
-	/** {en}
-	 * @brief 播放地址
+	getLineListByLineId(lineId: number | string): Stream[];
+	/**
+	 * @description: 根据线路ID获取清晰度list,用于获取某个线路下有几个清晰度
+	 * @param {number} lineId
 	 */
-	url: string;
+	getDefinitionListByLineId(lineId: number | string): Stream[];
 	/**
-	 * 视频清晰度
+	 * @description: 根据条件筛选符合条件的流list
+	 * @param {Condition} condition
 	 */
-	definition: string;
+	getUrlList(condition: Condition): Stream[];
 	/**
-	 * 视频streamType，暂只支持 mp4
-	 * @brief 视频流类型，当前仅支持 mp4
+	 * @description: 获取当期清晰的上一级清晰度或下一级清晰度
+	 * @param {boolean} isDown 是否取下一级清晰度
+	 * @param {string[]} demotePriority 清晰度降级顺序
 	 */
-	/** {en}
-	 * @brief 视频streamType，暂只支持 mp4
+	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
+	/**
+	 * 获取api map
+	 * @return { ApiMapConfig }
 	 */
-	streamType: string;
+	get apiMap(): ApiMapConfig;
 	/**
-	 * 视频codec，暂支持 h264
-	 * @brief 视频编码格式，当前仅支持 mp4
+	 * 获取播放域名
 	 */
-	/** {en}
-	 * @brief 视频codec，暂支持 h264
+	get playDomain(): string;
+	setVodTeaId(): void;
+	/**
+	 * 更新configs,即更新用户的configs，常用于playNext时
+	 * @param newConfigs {IPlayerConfig} 要更新的配置
 	 */
-	codec: string;
+	updateConfigs(newConfigs: IPlayerConfig): void;
 	/**
-	 * 码率, 数据统计需要，可选填
-	 * @brief 码率, 数据统计需要，选填
+	 * 更新playList
 	 */
-	/** {en}
-	 * @brief 码率, 数据统计需要，可选填
-	 */
-	bitrate: number;
+	updatePlayList(): void;
+	isVidPlay(): boolean;
+}
+/**
+ * @hidden
+ * @brief 移动端交互面板配置
+ */
+export interface IConfig {
+	mode?: number;
+	isAutoChange?: boolean;
+}
+declare class MobilePlayerPanel {
+	config: IConfig;
+	parent: HTMLElement;
+	root: any;
+	mode: number;
+	isAutoChange: number;
+	player: any;
+	children: HTMLElement | undefined;
+	container: HTMLElement | undefined;
+	title: HTMLElement | undefined;
+	isShow: boolean;
+	showCancelBtn: boolean;
+	constructor(args: any);
+	initEvents(): void;
+	handleOrientationChange(): void;
+	changeConfig(config: IConfig): void;
+	changeMode(mode: number): void;
+	renderPanel(): void;
+	showPanel(children: HTMLElement, title?: string, isItemList?: boolean): Promise<void>;
+	updatePanel(children: HTMLElement): void;
+	setTitle(title: any): void;
+	renderTitle(title: any): HTMLElement;
+	show(): void;
+	hide(): void;
+	handleHide(e: any): void;
+	bind(event: string, eventHandle: any, isBubble?: boolean): void;
+	destroy(): void;
+}
+declare enum StrategyNames {
 	/**
-	 * 视频时长，数据统计需要，可选填
-	 * @brief 视频时长，数据统计需要，选填
-	 */
-	/** {en}
-	 * @brief 视频时长，数据统计需要，可选填
+	 * h265
+	 * @brief H.265 策略
 	 */
-	duration: number;
+	H265 = "h265",
 	/**
-	 * 视频大小，数据统计需要，可选填
-	 * @brief 视频大小，数据统计需要，选填
+	 * 预加载
+	 * @brief 预加载策略
 	 */
-	/** {en}
-	 * @brief 视频大小，数据统计需要，可选填
+	PRELOAD = "preload",
+	/**
+	 * Range拆分-动态Buffer
+	 * @brief 动态 Buffer
 	 */
-	size: number;
-};
-declare class VeStrategyWrapper {
-	private tea;
-	private static mapStrategyNameToUmdKey;
-	teaId: number;
-	teaChannel: TLogChannel;
-	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(options?: any, commonOptions?: any): StrategyRecommendation;
-	getStrategyRecommendationsAsync(options?: any, commonOptions?: any): Promise<StrategyRecommendation>;
-	isHevcRecommended(): boolean;
-	private initPreloaderConfig;
-}
-declare const _default: VeStrategyWrapper;
-declare enum UmdKeys {
-	HLS = "hls",
-	FLV = "flv",
-	XGVideo = "XGVideo",
-	HLSEncrypt = "hlsEncrypt",
-	DASH = "dash",
-	MP4Encrypt = "mp4Encrypt",
-	DanmuJS = "danmujs",
-	DanmuMask = "danmuMask",
-	StreamProbe = "streamprobe",
-	VeStrategy = "vestrategy",
-	VeStrategyH265 = "vestrategy_h265",
-	VeStrategyPreload = "vestrategy_preload",
-	VeStrategyAdaptRange = "vestrategy_adapt_range",
-	DashAbralgo = "DashAbralgo",
-	Preloader = "preloader"
+	ADAPT_RANGE = "adaptRange"
 }
-/**
+/** {zh}
+ * 预加载实例，通过预加载实例可执行一些高级方法
+ * @detail Options
  * @hidden
- * @breif umdmap 配置
  */
-export declare type UMDMap = Record<UmdKeys, {
+export declare type PreloaderManager = {
 	/**
-	 * umd Module 的名称，即在window下暴露的接口名称
+	 * 移除所有已预加载数据
 	 */
-	name: string;
+	removeAll(): void;
 	/**
-	 * 对应umd文件名，只用来标记，实际不使用
+	 * 移除所有预加载任务
 	 */
-	pluginName?: string;
+	removeAllPreloadTask(): void;
 	/**
-	 * 对应npm包的名称，在打包文件时，会在libd.config.js中onPostBuild的钩子中会用于寻找对应npm包
+	 * 清空待预加载列表
 	 */
-	packageName: string;
+	clearPreloadList(): void;
+};
+declare enum PreloadScene {
 	/**
-	 * npm包中umd入口文件路径，用于打包上传到cdn目录
+	 * 普通场景（手动执行预加载）
 	 */
-	devPath: string;
-}>;
-declare class UMDLoader {
-	private static jsLoadMap;
-	private static jsLoadPromiseMap;
-	umdMap: UMDMap;
-	backupUmdUrlMap: Record<string, string>;
-	failCallback: (umdName: string, err: any) => any;
-	region: TRegionType;
-	userRegion: TRegionType;
-	customPluginPublicPath: string;
-	importedPlugins: any[];
-	constructor();
+	NORMAL = 0,
 	/**
-	 * @return { string } 插件加载的公共路径
+	 * Feed流场景（播放器自动执行预加载）
+	 * @brief Feed 流场景（播放器自动执行预加载）
 	 */
-	get pluginPublicPath(): string;
+	/** {en}
+	 * @brief Feed流场景（播放器自动执行预加载）
+	 */
+	FEED = 1
+}
+declare enum PreloadFormat {
+	MP4 = "mp4",
+	HLS = "hls"
+}
+declare enum PreloaderStatus {
 	/**
-	 * 更新umd的备用地址
-	 * @param {Record<string, string>} map 备用地址map
+	 * 不可用
 	 */
-	updateBackupMap(map: Record<string, string>): void;
+	DISABLED = 0,
 	/**
-	 * 加载额外的js-sdk
-	 * 适用 umd 模块
-	 * 只能浏览器环境下使用
-	 * @param url 额外加载JS 的 CDN 地址
-	 * @param isJs 是否js文件
+	 * 初始状态
 	 */
-	loadExtraCdn(url: string, isJs?: boolean): Promise<void>;
+	INITIALIZING = 1,
 	/**
-	 * @description 加载xgplayer插件
-	 * @param pluginName 插件名称
-	 * @param successCallback 加载完成后执行的回调
-	 * @return Promise<any>
+	 * 已Ready
 	 */
-	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
+	READY = 2,
+	/**
+	 * 加载失败
+	 */
+	FAILED = 3
 }
-export declare class SdkPlugin {
-	pluginName: string;
-	__args: any;
-	sdk: VePlayer;
-	playerData: PlayerData;
-	player: Player;
-	_emitter: EventEmitter;
-	static defineGetterOrSetter(Obj: any, map: any): void;
+/** {zh}
+ * 预加载配置更新
+ * @detail Options
+ * @hidden
+ */
+export declare type IPreloadUpdateConfig = {
 	/**
-	 * @type { string }
+	 * 向前加载视频个数
 	 */
-	static get pluginName(): string;
+	prevCount?: number;
 	/**
-	 * @constructor
-	 * @param { { sdk: object, pluginName: string, [propName: string]: any;}  } args
+	 * 向后加载视频个数
 	 */
-	constructor(args: any);
+	nextCount?: number;
+};
+/** {zh}
+ * 预加载视频资源
+ * @detail Options
+ */
+export declare type IPreloadStream = {
 	/**
-	 * @description sdk实例创建，挂载插件实例时首先执行
+	 * 视频唯一ID
+	 * @brief 视频 ID
 	 */
-	beforeCreate(): void;
+	/** {en}
+	 * @brief 视频唯一ID
+	 */
+	vid: string;
 	/**
-	 * @description sdk实例创建，挂载插件实例完后执行
+	 * 播放地址
+	 * @brief 视频播放地址
 	 */
-	afterCreate(): void;
+	/** {en}
+	 * @brief 播放地址
+	 */
+	url: string;
 	/**
-	 * @description sdk创建播放器前执行，只有这里能保证异步操作在creatPlayer之前同步完成
+	 * 视频清晰度
 	 */
-	beforePlayerCreate(): void;
+	definition: string;
 	/**
-	 * @description sdk创建播放器完执行
+	 * 视频streamType，支持 mp4、hls
+	 * @brief 视频流类型，支持 mp4、hls
 	 */
-	afterPlayerCreate(): void;
+	/** {en}
+	 * @brief video streamType，support mp4、hls
+	 */
+	streamType: string;
 	/**
-	 * @description sdk销毁时执行
+	 * 视频codec，暂支持 h264
+	 * @brief 视频编码格式，当前仅支持 mp4
 	 */
-	destroy(): void;
+	/** {en}
+	 * @brief 视频codec，暂支持 h264
+	 */
+	codec: string;
 	/**
-	 * @private
-	 * @param { any } args
+	 * 码率, 数据统计需要，可选填
+	 * @brief 码率, 数据统计需要，选填
 	 */
-	__init(args: any): void;
+	/** {en}
+	 * @brief 码率, 数据统计需要，可选填
+	 */
+	bitrate: number;
 	/**
-	 * @description 插件销毁
-	 * @private
+	 * 视频时长，数据统计需要，可选填
+	 * @brief 视频时长，数据统计需要，选填
 	 */
-	__destroy(): void;
-}
-declare class AuthToken extends SdkPlugin {
-	static get pluginName(): string;
-	isPlayByToken: boolean;
-	isEncrypt: boolean;
-	tokenInfo: ITokenInfo;
-	keyTokenInfo: ITokenInfo;
-	thirdPartyDrmAuthTokenInfo: ITokenInfo;
-	config: IPlayAuthTokenConfig;
-	privateDrmAuthToken: string;
-	useUnionInfoDRM: boolean;
-	sessionId: string;
-	retryCount: number;
-	playInfo?: VideoInfoRes;
-	constructor(args: any);
-	beforePlayerCreate(): Promise<void>;
-	getVideoInfo(): Promise<{
-		vid: string;
-		playList: Stream[];
-		codec: ICodecType;
-		defaultDefinition: string;
-	}>;
-	getVideos(): Promise<any>;
-	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
-	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
-	getBarrageMaskUrl(url: string): void;
-	getDrmConfig(videoInfo: IVideoInfo): void;
-	init(): void;
-	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
+	/** {en}
+	 * @brief 视频时长，数据统计需要，可选填
+	 */
+	duration: number;
 	/**
-	 * @description 更新playAuthToken
-	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
-	 * @param {boolean} isNewVideo 是否新视频，即是否为切换视频
+	 * 视频大小，数据统计需要，可选填
+	 * @brief 视频大小，数据统计需要，选填
 	 */
-	updateAuthToken(getVideoByToken: IPlayAuthTokenConfig, isNewVideo: boolean): Promise<void>;
-	checkPlayAuthTokenValid(): boolean;
-	checkKeyTokenValid(): boolean;
-	checkDrmAuthTokenValid(): boolean;
-}
+	/** {en}
+	 * @brief 视频大小，数据统计需要，可选填
+	 */
+	size: number;
+};
+export type TLogChannel = "cn" | "va" | "sg";
 /** {zh}
  * @hidden
+ * h265策略配置
+ * @detail Options
  */
-export interface IAdaptRangeDefaultOptions {
-	maxTargetCacheDur: number;
-	minTargetCacheDur: number;
-	rangeMaxDuration: number;
-	rangeMinDuration: number;
-	cacheSafeFactor: number;
-	estPTcontrol: boolean;
-	estPlayTime: number;
-	minBandwidth: number;
-	minDangerThreshold: number;
-	rangeControl: boolean;
-	rangeMinSize: number;
-	safeFactor: number;
-	targetCacheControl: boolean;
-}
-declare abstract class AbstractBaseAdapter {
-	isLive: boolean;
-	playerData: PlayerData;
-	streamType: string;
-	constructor(options: {
-		configs: IPlayerConfig;
-		playerData: PlayerData;
-		streamType: string;
-	});
+export declare type IH265Config = {
 	/**
-	 * @description 是否使用原生video的abr能力
+	 * h265策略依赖Module
 	 */
-	abstract useNativeAbr(): boolean;
-	abstract canOpenAbr(vidPlayInfo?: VideoInfoRes): boolean;
-	abstract applyAbrPluginConfig(_finalOptions: any, _autoBitrateOpts: any): void;
-	abstract prepareAbrModule(_playerData: any, _sdkUmdLoader: any): void;
-	abstract needAbrAutoDefinition(): boolean;
-	abstract setAbrDefaultDefiWithAuto(): boolean;
-	abstract generatePlaylistFromServer(res: VideoInfoRes): Stream[];
-	abstract canAdaptRangeEnable(): boolean;
-	abstract adaptRangeDefaultOptions(): IAdaptRangeDefaultOptions | undefined;
-	abstract applyAdaptRangePluginConfig(_finalOptions: any, _adaptRangeOptions: any): void;
-	abstract applyAdaptRangeStrategy(_finalOptions: any, _adaptRangeOptions: any): void;
-	abstract getPlugins(umdLoader: UMDLoader): Promise<XGPlugin[]>;
-	abstract setPluginConfigInVid(videoInfo: IVideoInfo, context: AuthToken): void;
-}
-declare class PlayerData {
-	id?: string;
-	root?: HTMLElement;
-	configs: IPlayerConfig;
-	strategyConfig?: StrategyConfigOptions;
-	type: string;
-	isLive: boolean;
-	options: any;
-	isMobile: boolean;
-	playList: Stream[];
-	plugins: any[];
-	openSoftDecoding: boolean;
-	defaultConfig: IDefaultConfig | undefined;
-	isHitDefault: boolean;
-	codec?: ICodecType;
-	enableH265Degrade: boolean;
-	languageData: {
-		extraLangList: IXGI18nText[];
-		extendLangList: IXGI18nText[];
-	};
-	current: Current;
-	onMediaExpired: () => Promise<SourceConfig>;
-	onTokenExpired: () => Promise<IPlayAuthTokenConfig>;
-	unionId?: string;
-	unionInfo?: string;
-	isMusic?: boolean;
-	sdkPlugins: any[];
-	useHlsPluginForSafari: boolean;
-	enableMenu: boolean;
-	region: TRegionType;
-	userRegion: TRegionType;
-	playDomainDegrade: boolean;
-	strategiesPlugins: any[];
-	strategiesPluginConfigs: any;
+	Strategy?: any;
 	/**
-	 * @default playList第一项
+	 * 是否禁用265策略
 	 */
-	defaultDefinition: string;
-	urlCheckData: {
-		enableUrlExpireCheck: boolean;
-		urlExpireTimestamp: number;
-		urlExpireDiff: number;
-		urlCheckExpireInterval: number;
-	};
-	private isAutoBitrateEnable;
-	adapter: AbstractBaseAdapter;
+	disabled?: boolean;
+} & VeStrategyH265Config;
+/** {zh}
+ * 预加载初始配置
+ * @detail Options
+ */
+export declare type IPreloadConfig = {
+	/** {zh}
+	 * 预加载场景
+	 * - 0：手动执行
+	 * - 1：字段执行
+	 * @default 0
+	 */
+	/** {en}
+	 * preload scene
+	 * - 0: manual execution
+	 * - 1: field execution
+	 * @default 0
+	 */
+	preloadScene?: PreloadScene;
+	/** {zh}
+	 * @brief 视频格式
+	 * - mp4: mp4格式
+	 * - hls: hls格式
+	 * @default mp4
+	 */
+	/** {en}
+	 * @brief video format
+	 * - mp4: mp4 format
+	 * - hls: hls format
+	 * @default mp4
+	 */
+	format?: PreloadFormat;
+	/** {zh}
+	 * 向前预加载视频个数，Feed流场景时生效
+	 * @default 1
+	 * @brief 向前预加载视频个数。Feed 流场景时生效。
+	 */
+	/** {en}
+	 * @brief 向前预加载视频个数，Feed流场景时生效
+	 */
+	prevCount?: number;
 	/**
-	 * @breif 是否vid模式的加密播放
+	 * 向后预加载视频个数，Feed流场景生效
+	 * @default 2
+	 * @brief 向后预加载视频个数。Feed 流场景生效
+	 */
+	/** {en}
+	 * @brief 向后预加载视频个数，Feed流场景生效
+	 */
+	nextCount?: number;
+	/**
+	 * 单个视频预加载时长
+	 * @default 5
+	 */
+	preloadTime?: number;
+	/**
+	 * 最大视频缓存个数
+	 * @default 15
+	 */
+	preloadMaxCacheCount?: number;
+	/**
+	 * 预加载依赖Module
+	 * @brief 预加载依赖 Module
+	 */
+	/** {en}
+	 * @brief 预加载依赖Module
+	 */
+	Strategy?: any;
+	/**
+	 * 是否禁用预加载
+	 */
+	disabled?: boolean;
+};
+/** {zh}
+ * @hidden
+ * @detail Options
+ * @brief Range 拆分（动态Buffer）策略初始配置
+ * @notes adaptRange策略配置结构较复杂，暂不开放Range默认配置自定义，使用策略下发
+ */
+export declare type IAdaptRangeConfig = {
+	/** {zh}
+	 * @brief 预加载依赖Module
 	 */
-	isVidEncrypt: boolean;
-	dashOpts: {
-		Data: IGetPlayInfoRes;
-	};
-	/**
-	 * @brief 播放器sdk实例
+	Strategy?: any;
+	/** {zh}
+	 * @brief 是否禁用Range拆分策略
 	 */
-	sdk: VePlayer;
+	disabled?: boolean;
+};
+/** {zh}
+ * @detail Options
+ * @brief 策略配置。
+ */
+export declare type StrategyConfigOptions = {
 	/**
-	 * @brief 当前加密播放类型，为空则表示非加密
+	 * h265策略配置
+	 * @hidden
+	 * @brief H.265 策略配置。
 	 */
-	drmType: EDRMTYPE;
-	/**
-	 * @brief 私有加密会话id
+	/** {en}
+	 * @hidden
+	 * @brief h265策略配置
 	 */
-	encryptSessionId?: string;
-	constructor(configs: IPlayerConfig & {
-		licensSupportModuleList: string[];
-	}, sdk: VePlayer);
+	[StrategyNames.H265]?: boolean | IH265Config;
 	/**
-	 * 初始化播放数据
-	 * @param configs { IPlayerConfig } 播放器配置
+	 * 预加载配置
+	 * @brief 预加载配置。
 	 */
-	initPlayData(configs: IPlayerConfig): void;
-	initPlaylistAndGetCurrent(configs: IPlayerConfig): Stream;
-	checkAutoBitratePlayList(): boolean;
-	getABRStreamInfo(streamType: any, originDefaultStream: any): {
-		defaultDefinition: string;
-		defaultStream: any;
-		playList: Stream[];
-	};
-	isCurrentH265(): boolean;
-	setDrmType(drmType: EDRMTYPE): void;
-	getCurrentByDefaultConfig(): Stream;
-	initCurrent(currentStreams: Stream): void;
-	initCheckExpireData(): void;
-	/**
-	 * 更新过期检测的数据
+	/** {en}
+	 * @brief 预加载配置
 	 */
-	updateCheckExpireData(): void;
-	initI18nData(languages: any): {
-		extraLangList: any[];
-		extendLangList: any[];
-	};
+	[StrategyNames.PRELOAD]?: boolean | IPreloadConfig;
 	/**
-	 * @description: 获取当前直播url
+	 * Range拆分（动态Buffer）
+	 * @brief 动态 Buffer 配置。
 	 */
-	getCurrentUrl(): Url;
-	getTargetStreamType(stream?: Stream): string;
-	/**
-	 * @description: 获取当前的streamType
+	/** {en}
+	 * @brief Range拆分（动态Buffer）
 	 */
-	getCurrentStreamType(): string;
-	getStreamType(): string;
-	isOpenABR(): boolean;
-	showRealDefinition(): boolean;
-	isAutoDefinition(def: any): boolean;
-	isPlayAutoDefinition(def?: string): boolean;
-	isDefinitionMatch(pre: any, next: any): boolean;
-	/**
-	 * @description: 获取满足当前直播条件的流
+	[StrategyNames.ADAPT_RANGE]?: boolean | IAdaptRangeConfig;
+};
+/** {zh}
+ * 播放器预初始化配置
+ * @detail Options
+ */
+export declare type StrategyInitOptions = {
+	/** {zh}
+	 * 应用ID
+	 * @brief 应用 ID
 	 */
-	getCurrentStreams(): Stream[];
-	/**
-	 * @description: 获取根据线路ID去重的流，用于获取有几个线路
+	/** {en}
+	 * @brief appid
 	 */
-	getLineList(): Stream[];
-	/**
-	 * @description: 根据线路ID获取符合条件的流
-	 * @param {number} lineId
+	appId: number;
+	/** {zh}
+	 * @brief 用户所在区域
+	 * @default cn
+	 * @notes 如果是海外用户，播放时请填写'mya'
 	 */
-	getLineListByLineId(lineId: number | string): Stream[];
-	/**
-	 * @description: 根据线路ID获取清晰度list,用于获取某个线路下有几个清晰度
-	 * @param {number} lineId
+	/** {en}
+	 * @brief The region where the user is located,
+	 * @default sg
 	 */
-	getDefinitionListByLineId(lineId: number | string): Stream[];
-	/**
-	 * @description: 根据条件筛选符合条件的流list
-	 * @param {Condition} condition
+	region?: TRegionType;
+	/** {zh}
+	 * 高级能力（策略）配置
+	 * @brief 策略配置
 	 */
-	getUrlList(condition: Condition): Stream[];
-	/**
-	 * @description: 获取当期清晰的上一级清晰度或下一级清晰度
-	 * @param {boolean} isDown 是否取下一级清晰度
-	 * @param {string[]} demotePriority 清晰度降级顺序
+	/** {en}
+	 * @brief Advanced Capability (Strategy) Configuration
 	 */
-	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
-	/**
-	 * 获取api map
-	 * @return { ApiMapConfig }
+	strategies: StrategyConfigOptions;
+	/** {zh}
+	 * 设备ID
+	 * @brief 设备 ID
 	 */
-	get apiMap(): ApiMapConfig;
-	/**
-	 * 获取播放域名
+	/** {en}
+	 * @brief device id
 	 */
-	get playDomain(): string;
-	setVodTeaId(): void;
-	/**
-	 * 更新configs,即更新用户的configs，常用于playNext时
-	 * @param newConfigs {IPlayerConfig} 要更新的配置
+	deviceId?: string;
+	/** {zh}
+	 * @brief 手动注入依赖插件，默认自动加载
+	 * @default -
 	 */
-	updateConfigs(newConfigs: IPlayerConfig): void;
+	/** {en}
+	 * @brief Manually inject dependency plugins, automatically load by default
+	 * @default -
+	 */
+	plugins?: any[];
 	/**
-	 * 更新playList
+	 * 策略Module，默认自动加载
+	 * @brief 策略 Module，默认自动加载
+	 * @default -
 	 */
-	updatePlayList(): void;
-	isVidPlay(): boolean;
-}
-/**
- * @hidden
- * @brief 移动端交互面板配置
- */
-export interface IConfig {
-	mode?: number;
-	isAutoChange?: boolean;
-}
-declare class MobilePlayerPanel {
-	config: IConfig;
-	parent: HTMLElement;
-	root: any;
-	mode: number;
-	isAutoChange: number;
-	player: any;
-	children: HTMLElement | undefined;
-	container: HTMLElement | undefined;
-	title: HTMLElement | undefined;
-	isShow: boolean;
-	showCancelBtn: boolean;
-	constructor(args: any);
-	initEvents(): void;
-	handleOrientationChange(): void;
-	changeConfig(config: IConfig): void;
-	changeMode(mode: number): void;
-	renderPanel(): void;
-	showPanel(children: HTMLElement, title?: string, isItemList?: boolean): Promise<void>;
-	updatePanel(children: HTMLElement): void;
-	setTitle(title: any): void;
-	renderTitle(title: any): HTMLElement;
-	show(): void;
-	hide(): void;
-	handleHide(e: any): void;
-	bind(event: string, eventHandle: any, isBubble?: boolean): void;
-	destroy(): void;
+	/** {en}
+	 * @brief Strategy Module, automatically loaded by default
+	 * @default -
+	 */
+	Module?: typeof VeStrategy;
+};
+declare class VeStrategyManager {
+	tea: Collector;
+	private static mapStrategyNameToUmdKey;
+	teaId: number;
+	teaChannel: TLogChannel;
+	private sdkUmdLoader;
+	private webId;
+	config: StrategyInitOptions;
+	private status;
+	private initPromise;
+	Module: typeof VeStrategy;
+	private preloadWrapper;
+	private h265Wrapper;
+	get preloader(): PreloaderManagerOrigin | undefined;
+	get preloaderStatus(): PreloaderStatus;
+	constructor();
+	private initUmdLoader;
+	private fetchWebId;
+	private initTea;
+	private fetchVeStrategy;
+	private fetchStrategies;
+	private initOnce;
+	init(config: 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(options?: any, commonOptions?: any): StrategyRecommendation;
+	getStrategyRecommendationsAsync(options?: any, commonOptions?: any): Promise<StrategyRecommendation>;
+	isHevcRecommended(): boolean;
 }
+declare const _default: VeStrategyManager;
 export interface IlicenseContent {
 	content: string;
 	sign: string;
@@ -4850,6 +5528,8 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _emitter;
+	/** 最近一次用户主动（或 defaultAudioLang）选中的音轨语言代码，用于清晰度切换后恢复音轨 */
+	private _lastSelectedAudioLang;
 	/**
 	 *
 	 *
@@ -4956,6 +5636,10 @@ declare class VePlayer {
 	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}
 	 */
 	static setPreloadList(list: IPreloadStream[]): Promise<void>;
+	/** {zh}
+	 * @brief 是否支持iOS的MMS
+	 */
+	static isMMSSupported: typeof isMMSSupported;
 	/**
 	 * @hidden
 	 * @param codec
@@ -5252,6 +5936,9 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _bindSdkEvents;
+	private _bindNativeAudioTrackEvents;
+	private _onNativeAddTrack;
+	private _onNativeTrackChange;
 	/** {zh}
 	 * @hidden
 	 *
@@ -5265,6 +5952,12 @@ declare class VePlayer {
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
+	/** @hidden 获取 HLS 实例（兼容加密和普通 HLS 插件） */
+	private _getHlsInstance;
+	/** @hidden 在 HLS 音轨列表就绪或清晰度切换后，恢复上次选中的音轨；找不到时 fallback 到 defaultAudioLang */
+	private _applyDefaultAudioLang;
+	/** @hidden 在 native AudioTrackList 就绪后，恢复上次选中的音轨；找不到时 fallback 到 defaultAudioLang */
+	private _applyDefaultAudioLangNative;
 	private _offPlayerEvents;
 	/** {zh}
 	 * @hidden 切换插件展示
@@ -5404,6 +6097,50 @@ declare class VePlayer {
 		selected: boolean;
 		[propName: string]: any;
 	}>;
+	/** {zh}
+	 * @brief 获取音频轨道列表。HLS 流通过 hls.js 获取，iOS 原生播放通过 HTMLMediaElement.audioTracks 获取。
+	 * @notes 每项包含 `id`、`name`、`lang`、`channels`、`default`、`selected` 字段；轨道数量 ≤ 1 时返回空数组。
+	 */
+	getAudioTracks(): Array<{
+		id: string | number;
+		name: string;
+		lang?: string;
+		channels?: string;
+		default: boolean;
+		selected: boolean;
+		[key: string]: unknown;
+	}>;
+	/** {zh}
+	 * @brief 获取当前激活的音频轨道。
+	 * @notes HLS 流通过 hls.js 获取，iOS 原生播放通过 HTMLMediaElement.audioTracks 获取；无激活轨道时返回 null。
+	 */
+	getCurrentAudioTrack(): {
+		id: string | number;
+		name: string;
+		lang?: string;
+		channels?: string;
+		default: boolean;
+		selected: boolean;
+		[key: string]: unknown;
+	} | null;
+	/** {zh}
+	 * @brief 切换音频轨道。
+	 * @param id 目标轨道的 id，可通过 `getAudioTracks()` 获取。
+	 * @notes 切换完成后会触发 `Events.AUDIO_TRACK_CHANGE` 事件；
+	 *        同时 PC 端和移动端音频轨道插件的选中状态会自动更新。
+	 */
+	switchAudioTrack(id: string | number): void;
+	/** {zh}
+	 * @brief 当前播放是否命中预加载缓存
+	 * @memberof VePlayer
+	 * @return {boolean} 是否命中预加载
+	 */
+	/** {en}
+	 * @brief Whether the current playback hits the preloaded cache
+	 * @memberof VePlayer
+	 * @return {boolean} Whether the current playback hits the preloaded cache
+	 */
+	get hitPreload(): boolean;
 	/** {zh}
 	 * @brief 初始化多语言词典
 	 *
@@ -5775,15 +6512,17 @@ export declare class Subtitle extends Plugin {
 	 */
 	_initExtSubTitle(defaultIndex: any): void;
 	_renderList(defaultIndex: any): void;
-	_onOff(): void;
-	_onChange(data: any): void;
-	_onListReset(data: any): void;
+	_onOff: () => void;
+	_onChange: (data: any) => void;
+	_onListReset: (data: any) => void;
 	updateCurItem(cIndex: any, subtitle: any): void;
 	initEvents(): void;
-	handleButtonChange(e: any): void;
+	handleButtonChange: (e: any) => void;
+	onEnter: (e: any) => void;
+	onLeave: (e: any) => void;
 	showList(): void;
 	hideList(): void;
-	openSubtitle(): void;
+	openSubtitle(): Promise<any>;
 	getSubTitleIndex(list: any, subtitle?: {
 		id: string;
 		language: string;
@@ -5825,9 +6564,9 @@ export declare class Subtitle extends Plugin {
 	/**
 	 *
 	 * @param {ISubTitleItem} subtitle
-	 * @returns
+	 * @returns {Promise<void>}
 	 */
-	switchSubTitle(subtitle?: ISubTitleItem): any;
+	switchSubTitle(subtitle?: ISubTitleItem): Promise<void>;
 	switchOffSubtitle(): void;
 	noShowSubtitle(): void;
 	renderItemList(): void;
@@ -6191,6 +6930,10 @@ export declare const Events: {
 	 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 	 */
 	ABR_AUTO_DESC_CHANGE: string;
+	/** {zh}
+	 * @brief 播放插件内核的扩展事件
+	 */
+	CORE_EVENT: string;
 	/** {zh}
 	 * @brief 播放器实例创建完成时触发。
 	 */
@@ -6397,6 +7140,14 @@ export declare const Events: {
 	 * @brief license 提醒
 	 */
 	LICENSE_STATUS_WARNING: string;
+	/** {zh}
+	 * @brief HLS 音频轨道列表更新时触发。`data.audioTracks` 为完整轨道数组。
+	 */
+	AUDIO_TRACKS_UPDATED: string;
+	/** {zh}
+	 * @brief 音频轨道切换完成时触发。`data.id` 为新轨道 id，`data.audioTrack` 为完整轨道对象。
+	 */
+	AUDIO_TRACK_CHANGE: string;
 	/** {zh}
 	 * @brief 在播放被终止时触发。例如当播放中的视频重新开始播放。
 	 */
@@ -6720,6 +7471,14 @@ export declare const Event: {
 		 * @brief license 提醒
 		 */
 		LICENSE_STATUS_WARNING: string;
+		/** {zh}
+		 * @brief HLS 音频轨道列表更新时触发。`data.audioTracks` 为完整轨道数组。
+		 */
+		AUDIO_TRACKS_UPDATED: string;
+		/** {zh}
+		 * @brief 音频轨道切换完成时触发。`data.id` 为新轨道 id，`data.audioTrack` 为完整轨道对象。
+		 */
+		AUDIO_TRACK_CHANGE: string;
 	};
 	PluginEvents: {
 		/** {zh}
@@ -6862,6 +7621,10 @@ export declare const Event: {
 		 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 		 */
 		ABR_AUTO_DESC_CHANGE: string;
+		/** {zh}
+		 * @brief 播放插件内核的扩展事件
+		 */
+		CORE_EVENT: string;
 	};
 };
 export * from "xgplayer";