@byteplus/veplayer 1.18.0-rc.1 → 1.18.0-rc.10

package/index.d.ts

@@ -805,6 +805,15 @@ export interface ISubTitleItem {
 	 * @default -
 	 */
 	text?: string;
+	/** {zh}
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	label?: string | number;
 	/** {zh}
 	 * @brief 外挂字幕 URL 地址。
 	 * @default -
@@ -834,6 +843,20 @@ export interface ISubTitleItem {
 	 */
 	list?: IListItem[];
 }
+export declare type IAutoSubtitleSourceItem = Record<string, any> | string;
+export declare type IAutoSubtitleFormatterResult = string | number | boolean | null | undefined | {
+	label?: string | number;
+	text?: string | number;
+	show?: boolean;
+	visible?: boolean;
+	/** 排序权重，值越小越靠前。未指定时保持原始顺序。 */
+	order?: number;
+	/** 是否为默认选中的字幕。 */
+	isDefault?: boolean;
+	/** 是否为默认选中的字幕，与 `isDefault` 等价。 */
+	default?: boolean;
+};
+export declare type IAutoSubtitleItemFormatter = (item: IAutoSubtitleSourceItem, index: number) => IAutoSubtitleFormatterResult;
 /** {zh}
  * @brief 字幕内容项。
  * @list Options
@@ -882,8 +905,13 @@ export interface IListItem {
 	 */
 	[propName: string]: any;
 }
-/**
- * @brief 字幕文案配置
+/** {zh}
+ * @brief 字幕文案配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Subtitle text item configuration.
  * @list Options
  * @kind property
  */
@@ -930,7 +958,7 @@ export interface ITextItem {
 	 */
 	index?: number;
 }
-/**
+/** {zh}
  * @brief 清晰度降级配置。
  * @list Options
  * @kind property
@@ -941,7 +969,7 @@ export interface ITextItem {
  * @kind property
  */
 export interface IDefinitionDemotePlugin {
-	/**
+	/** {zh}
 	 * @brief 是否开启自动降级，取值如下：
 	 *        - `false`：关闭自动降级。
 	 *        - `true`：开启自动降级。
@@ -954,7 +982,7 @@ export interface IDefinitionDemotePlugin {
 	 *        - `true`: automatic downgrade is enabled.
 	 */
 	isNeedAutoDemote?: boolean;
-	/**
+	/** {zh}
 	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
 	 *
@@ -962,49 +990,59 @@ export interface IDefinitionDemotePlugin {
 	 * @memberof IDefinitionDemotePlugin
 	 */
 	/** {en}
+	 * @brief The order of definition downgrade. The elements in the array should correspond to the `definition` in the `playList`.
+	 * @default []
+	 *
+	 * @type {string[]}
+	 * @memberof IDefinitionDemotePlugin
 	 */
 	demotePriority: string[];
-	/**
+	/** {zh}
 	 * @brief 长时间卡顿的时间阈值，单位为毫秒。卡顿时长超过该值，即视为长时间卡顿。发生长时间卡顿时，SDK 会触发 `LONG_WAITING` 事件。
 	 * @default 5000
 	 *
 	 */
 	/** {en}
+	 * @brief The threshold for long waiting time, in milliseconds. If the waiting time exceeds this value, it is considered as long waiting. The `LONG_WAITING` event will be triggered when long waiting occurs.
 	 * @default 5000
 	 *
 	 */
 	longWaitingTime?: number;
-	/**
+	/** {zh}
 	 * @brief 频繁卡顿的次数阈值。`oftenWaitingTime` 内卡顿次数大于或等于阈值时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 3
 	 *
 	 */
 	/** {en}
+	 * @brief The threshold for frequent stuttering, in milliseconds. If the stuttering count exceeds this value, the `OFTEN_WAITING` event will be triggered, indicating frequent stuttering.
 	 * @default 3
 	 *
 	 */
 	oftenWaitingCount?: number;
-	/**
+	/** {zh}
 	 * @brief 频繁卡顿监测的时间范围。`oftenWaitingTime` 内卡顿次数大于或等于 `oftenWaitingCount` 时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 5000
 	 */
 	/** {en}
+	 * @brief The time range for frequent stuttering monitoring. If the stuttering count exceeds `oftenWaitingCount` within `oftenWaitingTime`, the `OFTEN_WAITING` event will be triggered, indicating frequent stuttering.
 	 * @default 5000
 	 */
 	oftenWaitingTime?: number;
-	/**
+	/** {zh}
 	 * @brief 卡顿时是否显示清晰度降级提示 toast。
 	 * @default true
 	 */
 	/** {en}
+	 * @brief Whether to display the definition downgrade toast.
 	 * @default true
 	 */
 	isNeedShowTips?: boolean;
-	/**
+	/** {zh}
 	 * @brief 清晰度降级提示 toast 的显示时长，单位为毫秒。
 	 * @default 3000
 	 */
 	/** {en}
+	 * @brief The duration of the definition downgrade toast, in milliseconds.
 	 * @default 3000
 	 */
 	toastShowTime?: number;
@@ -1040,79 +1078,253 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
-/**
- * 音轨选择选项。
+/** {zh}
+ * @brief 音轨选择选项。
  * 对应 hls.js `AudioSelectionOption` 的所有字段，所有字段均可选。
- * 用于 `switchAudioTrack()` 参数（配合 `id` 使用）以及 `audioPreference` 配置。
+ * 用于 `switchAudioTrack()` 参数以及 `audioPreference` 配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Audio track selection options.
+ * Corresponding to all fields of hls.js `AudioSelectionOption`, all fields are optional.
+ * Used for `switchAudioTrack()` and `audioPreference` configuration.
+ * @list Options
+ * @kind property
  */
 export interface AudioTrackOption {
+	/** {zh}
+	 * @brief 音轨主要语言，BCP-47 格式（如 `zh`、`en`）。对应 `#EXT-X-MEDIA` 的 `LANGUAGE`。
+	 */
+	/** {en}
+	 * @brief Primary track language in BCP-47 format (e.g. `zh`, `en`). Maps to `#EXT-X-MEDIA` `LANGUAGE`.
+	 */
 	lang?: string;
+	/** {zh}
+	 * @brief 关联语言代码。对应 `#EXT-X-MEDIA` 的 `ASSOC-LANGUAGE`。
+	 */
+	/** {en}
+	 * @brief Associated language code. Maps to `#EXT-X-MEDIA` `ASSOC-LANGUAGE`.
+	 */
 	assocLang?: string;
+	/** {zh}
+	 * @brief 轨道特征描述字符串。对应 `#EXT-X-MEDIA` 的 `CHARACTERISTICS`（如 `public.accessibility.describes-video`）。
+	 */
+	/** {en}
+	 * @brief Track characteristics string. Maps to `#EXT-X-MEDIA` `CHARACTERISTICS`.
+	 */
 	characteristics?: string;
+	/** {zh}
+	 * @brief 声道数。对应 `#EXT-X-MEDIA` 的 `CHANNELS`（如 `"2"`）。
+	 */
+	/** {en}
+	 * @brief Number of audio channels. Maps to `#EXT-X-MEDIA` `CHANNELS` (e.g. `"2"`).
+	 */
 	channels?: string;
+	/** {zh}
+	 * @brief 音轨名称，用于展示或精确匹配（如 `Stereo`）。hls.js 路径下与 `lang` 组合可唯一定位轨道。
+	 */
+	/** {en}
+	 * @brief Track name for display or precise matching (e.g. `Stereo`). With `lang`, uniquely identifies a track on the hls.js path.
+	 */
 	name?: string;
+	/** {zh}
+	 * @brief 音频编解码器标识（如 `mp4a.40.2`）。
+	 */
+	/** {en}
+	 * @brief Audio codec identifier (e.g. `mp4a.40.2`).
+	 */
 	audioCodec?: string;
+	/** {zh}
+	 * @brief 音频组 ID。对应 `#EXT-X-MEDIA` 的 `GROUP-ID`。
+	 */
+	/** {en}
+	 * @brief Audio group ID. Maps to `#EXT-X-MEDIA` `GROUP-ID`.
+	 */
 	groupId?: string;
+	/** {zh}
+	 * @brief 是否为 manifest 中的默认音轨。
+	 */
+	/** {en}
+	 * @brief Whether this is the default track declared in the manifest.
+	 */
 	default?: boolean;
+	/** {zh}
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
 	[key: string]: unknown;
 }
+/** {zh}
+ * @detail Api
+ * @brief HLS 音轨对象。在 `AudioTrackOption` 基础上包含列表索引与展示名称。
+ */
+/** {en}
+ * @detail Api
+ * @brief HLS audio track object. Extends `AudioTrackOption` with list index and display name.
+ */
 export interface AudioTrack extends AudioTrackOption {
+	/** {zh}
+	 * @brief 轨道在 `audioTracks` 列表中的索引（hls.js 与原生路径均为 number）。
+	 */
+	/** {en}
+	 * @brief Track index in the `audioTracks` list (number on both hls.js and native paths).
+	 */
 	id: number;
+	/** {zh}
+	 * @brief 展示名称（由 `lang` / `name` 等字段生成或来自 manifest）。
+	 */
+	/** {en}
+	 * @brief Display name (derived from `lang` / `name` or from the manifest).
+	 */
 	name: string;
+	/** {zh}
+	 * @brief 是否为 manifest 默认音轨。
+	 */
+	/** {en}
+	 * @brief Whether this is the default track in the manifest.
+	 */
 	default: boolean;
 }
-/**
- * `getAudioTracks()` / `getCurrentAudioTrack()` 的返回项类型。
- * 是 `switchAudioTrack()` 参数类型的子类型，可直接传入。
+/** {zh}
+ * @detail Api
+ * @brief `getAudioTracks()` / `getCurrentAudioTrack()` 的返回项类型，可直接传入 `switchAudioTrack()`。
+ */
+/** {en}
+ * @detail Api
+ * @brief Return type of `getAudioTracks()` / `getCurrentAudioTrack()`; can be passed directly to `switchAudioTrack()`.
  */
 export interface AudioTrackInfo extends AudioTrack {
-	/** 是否为当前激活轨道。`getCurrentAudioTrack()` 返回时始终为 `true`。 */
+	/** {zh}
+	 * @brief 是否为当前激活轨道。`getCurrentAudioTrack()` 返回时始终为 `true`。
+	 */
+	/** {en}
+	 * @brief Whether this is the currently active track. Always `true` when returned by `getCurrentAudioTrack()`.
+	 */
 	selected: boolean;
 }
+/** {zh}
+ * @brief PC 端音轨切换插件配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief PC audio track selector plugin configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IAudioTrackConfig {
-	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 5 */
+	/** {zh}
+	 * @brief 控件在控制栏中的排列顺序，数值越小越靠左。
+	 * @default 70
+	 */
+	/** {en}
+	 * @brief Sort weight in the control bar; smaller values appear further left.
+	 * @default 70
+	 */
 	index?: number;
-	/** 是否显示图标按钮。@default true */
+	/** {zh}
+	 * @brief 是否显示音轨切换图标按钮。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to show the audio track switcher icon.
+	 * @default true
+	 */
 	isShowIcon?: boolean;
-	/** 竖屏时是否隐藏控件。@default false */
+	/** {zh}
+	 * @brief 竖屏时是否隐藏音轨控件。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to hide the audio track control in portrait orientation.
+	 * @default false
+	 */
 	hidePortrait?: boolean;
-	/** 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。@default true */
+	/** {zh}
+	 * @brief 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to append the raw track name in parentheses after the language label, e.g. `Japanese (Stereo AudioTrack1)`.
+	 * @default true
+	 */
 	showNameSuffix?: boolean;
 }
+/** {zh}
+ * @brief 移动端音轨切换插件配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Mobile audio track selector plugin configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IAudioTrackMobileConfig {
-	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 2.6 */
+	/** {zh}
+	 * @brief 控件在控制栏中的排列顺序，数值越小越靠左。
+	 * @default 2.6
+	 */
+	/** {en}
+	 * @brief Sort weight in the control bar; smaller values appear further left.
+	 * @default 2.6
+	 */
 	index?: number;
-	/** 是否显示图标按钮。@default true */
+	/** {zh}
+	 * @brief 是否显示音轨切换图标按钮。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to show the audio track switcher icon.
+	 * @default true
+	 */
 	isShowIcon?: boolean;
-	/** 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。@default true */
+	/** {zh}
+	 * @brief 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to append the raw track name in parentheses after the language label, e.g. `Japanese (Stereo AudioTrack1)`.
+	 * @default true
+	 */
 	showNameSuffix?: boolean;
 }
-/**
+/** {zh}
  * @brief DASH 播放配置。
  * @list Options
  * @kind property
  */
 /** {en}
+ * @brief DASH playback configuration.
  * @list Options
  * @kind property
  */
 export interface IDashPluginConfig {
-	/**
+	/** {zh}
 	 * @brief 视频 ID。
 	 * @default -
 	 * @notes 播放加密视频时必选
 	 */
 	/** {en}
+	 * @brief Video ID.
 	 * @default -
+	 * @notes When playing encrypted videos, it is required.
 	 */
 	vid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放类型
 	 * @default TOP
 	 */
+	/** {en}
+	 * @brief Playback type.
+	 * @default TOP
+	 */
 	playInfoType: "TOP";
-	/**
+	/** {zh}
 	 * @brief 清晰度映射文案。
 	 * @default -
 	 * @example
@@ -1127,6 +1339,16 @@ export interface IDashPluginConfig {
 	 */
 	/** {en}
 	 * @brief Definition label mapping.
+	 * @default -
+	 * @example
+	 * ``` javascript
+	 * {
+	 *   360p: "SD 360p",
+	 *   480p: "HD 480p",
+	 *   720p: "FHD 720p",
+	 *   1080p: "UHD 1080p"
+	 * }
+	 * ```
 	 */
 	definitionText: Record<string, string>;
 	/**
@@ -1135,91 +1357,142 @@ export interface IDashPluginConfig {
 	 */
 	/** {en}
 	 * @brief Default definition.
+	 * @default The first definition in the list
 	 */
 	defaultDefinition?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 获取证书地址
 	 * 默认：`//i.snssdk.com/video/drm/v1/play_licenses`
 	 * 播放加密视频时必选
 	 */
+	/** {en}
+	 * @brief Get the certificate address.
+	 * @default `//i.snssdk.com/video/drm/v1/play_licenses`
+	 * @notes When playing encrypted videos, it is required.
+	 */
 	getLicenseUrl?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * dash播放信息，由`Service.url`服务接口获取
 	 * 默认：无
 	 * 必选
 	 */
+	/** {en}
+	 * @hidden
+	 * @brief Dash playback information, obtained from the `Service.url` service interface.
+	 * @default -
+	 * @notes Required.
+	 */
 	dashOpts?: {
 		Data: any;
 	};
-	/**
+	/** {zh}
 	 * @brief 兜底的mp4播放列表，由`Service.url`服务接口获取
 	 * @default -
 	 * @hidden
 	 */
+	/** {en}
+	 * @brief Fallback mp4 playback list, obtained from the `Service.url` service interface.
+	 * @default -
+	 * @hidden
+	 */
 	mp4Opts: {
 		mp4List: mp4OptsItem[];
 	};
-	/**
-	 * 预加载时间，单位ms
+	/** {zh}
+	 * @brief 预加载时间，单位ms
 	 * @default 50
-	 * @brief 预加载时间，单位为毫秒。
 	 */
 	/** {en}
 	 * @brief Preload time in milliseconds.
+	 * @default 50
 	 */
 	preloadTime?: number;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 自适应配置项
 	 * 默认：undefined
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Adaptive configuration item.
+	 * @default undefined
+	 * @hidden
+	 */
 	autoBitrateOpts?: any;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 备用地址降级,默认情况下，当dash播放出问题后，会降级为mp4播放；
 	 * 设置改参数后，会优先使用备用地址进行dash的降级播放，再次出错时，会降级为mp4播放
 	 * 默认：false
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Fallback address degradation. By default, when dash playback fails, it will be downgraded to mp4 playback.
+	 * @default false
+	 * @hidden
+	 */
 	useBackUrl?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 优化首帧
 	 * 是针对域名，将range参数放在url后面，避免OPTIONS请求，从而优化首帧
 	 * 默认：无
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Optimize the first frame.
+	 * @default undefined
+	 * @hidden
+	 */
 	url_range_domains?: string[];
 }
-/**
+/** {zh}
  * @brief dash播放的mp4兜底播放列表配置
  * @list Options
+ * @kind property
+ * @hidden
+ */
+/** {en}
+ * @brief Fallback mp4 playback list configuration for dash playback.
+ * @list Options
+ * @kind property
  * @hidden
  */
 export interface mp4OptsItem {
-	/**
+	/** {zh}
 	 * 清晰度
 	 * 默认： 无
 	 * 必传
 	 */
+	/** {en}
+	 * @brief Definition for fallback mp4 playback.
+	 * @default -
+	 * @notes Required.
+	 */
 	definition: string;
-	/**
-	 * mp4地址
-	 * 默认： 无
-	 * 必传
+	/** {zh}
+	 * @briefmp4地址
+	 * @default -
+	 * @notes Required.
+	 */
+	/** {en}
+	 * @brief URL for fallback mp4 playback.
+	 * @default -
+	 * @notes Required.
 	 */
 	url: string;
 }
-/**
+/** {zh}
  * @brief HLS 加密播放配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief HLS encrypted playback configuration.
+ * @list Options
+ * @kind property
  */
 export interface IEncryptHlsPluginConfig {
 	/** {zh}
@@ -1231,49 +1504,77 @@ export interface IEncryptHlsPluginConfig {
 	 * @default https://vod.byteplusapi.com
 	 */
 	playDomain?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 请求类型，固定值 'TOP'
 	 * @default TOP
 	 */
+	/** {en}
+	 * @brief Request type, fixed value 'TOP'
+	 * @default TOP
+	 * @hidden
+	 */
 	getKeyType?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 密钥请求域名
 	 * @default https://vod.volcengineapi.com
 	 */
+	/** {en}
+	 * @brief Request domain name for key request
+	 * @default https://vod.byteplusapi.com
+	 */
 	keyDomain?: string;
-	/**
+	/** {zh}
 	 * @brief 播放地址获取token，由服务端生成下发，详见{@link https://www.volcengine.com/docs/4/67350#%E4%B8%B4%E6%97%B6%E5%AE%89%E5%85%A8%E5%87%AD%E8%AF%81%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E 播放临时安全凭证（PlayAuthToken）}
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Playback address acquisition token, generated by the server and distributed by the server, see {@link https://docs.byteplus.com/en/docs/byteplus-vod/reference-getplayinfo PlayAuthToken}
+	 * @default -
+	 */
 	playAuthToken?: string;
-	/**
+	/** {zh}
 	 * @brief 密钥获取token，由服务端生成下发，详见{@link https://www.volcengine.com/docs/4/65659#%E7%AD%BE%E5%8F%91-hls-%E6%A0%87%E5%87%86%E5%8A%A0%E5%AF%86-authtoken%EF%BC%88sha1hlsdrmauthtoken%EF%BC%89 签发 Hls 标准加密AuthToken}
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Key acquisition token, generated by the server and distributed by the server, see {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-go-sdk#generating-hls-decryption-token keyToken}
+	 */
 	keyToken: string;
 }
-/**
+/** {zh}
  * @brief 质量日志上报配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief Quality log configuration.
+ * @list Options
+ * @kind property
  */
 export interface IVodLogOptsConfig {
-	/**
+	/** {zh}
 	 * @brief 视频点播应用 ID。您可在视频{@link https://console.volcengine.com/vod/region:vod+cn-north-1/sdk/app/ 点播控制台 > 点播SDK > 应用管理}页面获取应用 ID（App ID）。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief VOD application ID. You can get the application ID (App ID) on the video {@link https://console.byteplus.com/vodpaas/region:vodpaas+ap-singapore-1/sdk/app/?projectName=default VOD Console > VOD SDK > application management} page.
+	 * @default -
+	 */
 	line_app_id: number;
-	/**
+	/** {zh}
 	 * @brief 用于识别单一用户的 ID，可在{@link https://www.volcengine.com/docs/4/75736#qoe-%E6%8C%87%E6%A0%87%E8%AF%B4%E6%98%8E QoE指标}中用于用户维度的筛选，也可以用于{@link https://www.volcengine.com/docs/4/106093 单点追查} 查找单用户的播放日志
 	 * 用户 ID 对应于单点追查功能的查询条件中的设备 ID 维度。如不设置用户 ID，VePlayer 将根据用户浏览器随机生成一个值，该值会在浏览器端缓存。
 	 * @notes 强烈建议您使用与业务相关的用户 ID，以便在发生播放错误时通过{@link https://console.volcengine.com/vod/region:vod+cn-north-1/quality_control/SingleTracing/?Tab=play 点播控制台 > 质量平台 > 单点追查}功能排查故障。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The ID used to identify a single user. It can be used for user-level filtering in {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-quality-insight-overview QoE indicators}, and also for {@link https://www.volcengine.com/docs/4/106093 single-point tracing} to find the playback logs of a single user.
+	 * The user ID corresponds to the device ID dimension in the query conditions of the single-point tracing function. If no user ID is set, VePlayer will generate a random value according to the user's browser, which will be cached in the browser.
+	 * @notes It is strongly recommended to use a user ID related to your business to troubleshoot problems through the {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-end-point-tracker VOD Console > Quality Platform > Single Tracing} function.
+	 * @default -
+	 */
 	line_user_id: string | number;
 	/**
 	 * @hidden
@@ -1281,154 +1582,273 @@ export interface IVodLogOptsConfig {
 	 * @default MP4
 	 */
 	vtype?: "MP4" | "HLS" | "DASH" | "FLV";
-	/**
+	/** {zh}
 	 * @brief 业务标签。对应于质量平台上的业务类型维度，其作用是区分业务中的不同场景，以便进行多维度分析。举例来说，假设您的应用中包含短视频和长视频两个场景，则可分别将 `tag` 设为 `short` 和 `long`。这样一来，您就能够在{@link https://www.volcengine.com/docs/4/120175 质量平台}上通过业务标签维度查询或过滤不同场景的数据。
 	 * @notes 如需自定义配置 tag 值在点播控制台上的展示文案，请联系{@link https://www.volcengine.com/docs/4/108992#%E5%94%AE%E5%90%8E%E6%94%AF%E6%8C%81 技术支持}
 	 * @default 普通视频
 	 */
+	/** {en}
+	 * @brief Business tag. Corresponds to the business type dimension on the quality platform, which is used to distinguish different scenarios in the business and facilitate multi-dimensional analysis. For example, if your application contains short video and long video scenarios, you can set `tag` to `short` and `long` respectively. This way, you can query or filter data for different scenarios through the business tag dimension on the {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-end-point-tracker quality platform}.
+	 * @notes If you need to customize the display text of `tag` in the VOD Console, please contact {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-quality-insight-overview technical support}.
+	 * @default Normal
+	 */
 	tag?: string;
-	/**
+	/** {zh}
 	 * @brief 自定义子标签。对应于质量平台上的自定义标签维度，与 `tag` 配合使用，可用于区分同一业务类型下更为细分的音视频类型，比如加密视频、非加密视频、音频等。
 	 * @default -
 	 */
 	/** {en}
 	 * @brief Custom sub-tag for quality platform analytics; use with `tag` to distinguish sub-types such as encrypted/non-encrypted video or audio.
+	 * @default -
 	 */
 	subtag?: string;
-	/**
+	/** {zh}
 	 * @brief 视频编码类型，取值如下
 	 * - `h264`：H.264
 	 * - `h265`：H.265
 	 * @default unknown
 	 */
+	/** {en}
+	 * @brief Video codec type, values:
+	 * - `h264`: H.264
+	 * - `h265`: H.265
+	 * @default unknown
+	 */
 	codec_type?: "h264" | "h265";
-	/**
+	/** {zh}
 	 * @brief 是否加密，0:非drm视频，1：drm视频
 	 * @hidden
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Whether the video is encrypted, 0: non-drm video, 1: drm video
+	 * @hidden
+	 * @default 0
+	 */
 	drm_type?: 0 | 1;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放内核版本号
 	 */
+	/** {en}
+	 * @brief Player core version number
+	 * @hidden
+	 * @default -
+	 */
 	playerCoreVersion?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放器版本号
 	 */
+	/** {en}
+	 * @brief Player version number
+	 * @hidden
+	 * @default -
+	 */
 	playerVersion?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief DASH播放的封装类型
 	 */
+	/** {en}
+	 * @brief DASH playback packaging type
+	 * @hidden
+	 * @default -
+	 */
 	dynamic_type?: "segment_base" | "segment_template";
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否使用bash，0:不使用，1：使用
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Whether to use bash, 0: not use, 1: use
+	 * @hidden
+	 * @default 0
+	 */
 	enable_bash?: 0 | 1;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 发送的埋点日志是本地缓存的时候回调
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Callback when the local cache of the sent log is sent
+	 * @hidden
+	 * @default -
+	 */
 	sendLocalCallback?: (event: any, data: any) => void;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否禁用localStorage暂时缓存onPlay逻辑
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable localStorage temporarily cache onPlay logic
+	 * @hidden
+	 * @default false
+	 */
 	disableLocalCache?: boolean;
-	/**
+	/** {zh}
 	 * @brief 日志上报渠道，可选值：cn(国内) 、sg(新加坡)
 	 * @default cn
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Log reporting channel, optional values: cn(domestic) 、va(overseas) 、sg(Singapore)
+	 * @default sg
+	 * @hidden
 	 */
 	channel?: "cn" | "va" | "sg";
-	/**
+	/** {zh}
 	 * @brief 日志上报额外配置
 	 * @note 火山海外区域的用户播放需要配置为`{log_from_region: 'volc-overseas'}`
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Log reporting additional configuration
+	 * @note BytePlus need to configure `{log_from_region: 'byteplus'}`
+	 * @hidden
 	 */
 	trackerConfig?: Record<string, string>;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否关闭清晰度切换埋点
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to close the resolution switching log
+	 * @hidden
+	 * @default false
+	 */
 	closeResolutionLog?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 关闭seek相关埋点
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to close the seek related log
+	 * @hidden
+	 * @default false
+	 */
 	closeSeekLog?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 队列超过多少条日志的时候发送
 	 * @default 5
 	 */
+	/** {en}
+	 * @brief The number of logs when the queue exceeds the threshold
+	 * @hidden
+	 * @default 5
+	 */
 	maxQueueCount?: number;
 }
-/**
+/** {zh}
  * @brief mp4加密日志配置项
  * @list Options
  * @hidden
  */
 export interface IMp4EncryptPlayerConfig {
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否加密
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to encrypt
+	 * @hidden
+	 * @default false
+	 */
 	isEncrypt?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频vid
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video vid
+	 * @hidden
+	 * @default -
+	 */
 	vid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频密钥 id
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video kid
+	 * @hidden
+	 * @default -
+	 */
 	kid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 获取密钥凭证地址
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Get the certificate address
+	 * @hidden
+	 * @default -
+	 */
 	getLicenseUrl?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否使用EME
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to use EME
+	 * @hidden
+	 * @default false
+	 */
 	useEME?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频密钥值
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video key value
+	 * @hidden
+	 * @default -
+	 */
 	keyValue?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 加密后的视频密钥值
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Encrypted video key value
+	 * @hidden
+	 * @default -
+	 */
 	secretKey?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否携带cookie
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to carry cookie
+	 * @hidden
+	 * @default false
+	 */
 	withCredentials?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief drm内容
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Drm content
+	 * @hidden
+	 * @default -
+	 */
 	drm?: {
 		clearKeys: {
 			[propName: string]: string;
@@ -1451,73 +1871,127 @@ export declare type IDefinition = {
 		[propName: string]: any;
 	};
 };
-/**
+/** {zh}
  * @brief 音量配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief Volume configuration.
+ * @list Options
+ * @kind property
+ */
 export declare type IVolume = number | {
-	/**
+	/** {zh}
 	 * @brief 插件Dom挂载的位置，默认播放器底部控制栏右侧
 	 * @default POSITIONS.CONTROLS_RIGHT
 	 */
+	/** {en}
+	 * @brief The position of the plugin dom. The default value is `POSITIONS.CONTROLS_RIGHT`.
+	 * @default POSITIONS.CONTROLS_RIGHT
+	 */
 	position?: POSITIONS;
-	/**
+	/** {zh}
 	 * @brief 插件在挂载的位置的排序权重
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The index of the plugin in the position. The default value is `1`.
+	 * @default 1
+	 */
 	index?: number;
-	/**
+	/** {zh}
 	 * @brief 是否禁用插件交互行为，即是否隐藏音量调节按钮
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the plugin interaction behavior, i.e., whether to hide the volume adjustment button.
+	 * @default false
+	 */
 	disable?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否在音量调节slider上方显示当前音量数值
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to show the current volume value on the volume adjustment slider.
+	 * @default false
+	 */
 	showValueLabel?: boolean;
-	/**
+	/** {zh}
 	 * @brief 默认音量大小，取值范围0-1
 	 * @default 0.6
 	 */
+	/** {en}
+	 * @brief The default volume value. The value range is `[0, 1]`.
+	 * @default 0.6
+	 */
 	default?: number;
-	/**
+	/** {zh}
 	 * @brief 静音恢复的时候最小音量
 	 * @default 0.2
 	 */
+	/** {en}
+	 * @brief The minimum volume value when unmuting. The value range is `[0, 1]`.
+	 * @default 0.2
+	 */
 	miniVolume?: number;
 };
-/**
+/** {zh}
  * @brief 进度条标记点配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief Progress bar marker point configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IDot {
-	/**
+	/** {zh}
 	 * @brief 进度条标记点
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The id of the progress bar marker point.
+	 * @default 1
+	 */
 	id: string | number;
-	/**
+	/** {zh}
 	 * @brief 标记点所在的播放时间
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief The time of the progress bar marker point.
+	 * @default 0
+	 */
 	time: number;
-	/**
+	/** {zh}
 	 * @brief 进度条自定义文案
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The text of the progress bar marker point.
+	 * @default -
+	 */
 	text?: string;
-	/**
+	/** {zh}
 	 * @brief 标记点持续的时间，单位秒
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The duration of the progress bar marker point.
+	 * @default 1
+	 */
 	duration?: number;
-	/**
+	/** {zh}
 	 * @brief 进度条自定义的CSS Style样式
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The custom CSS style of the progress bar marker point.
+	 * @default -
+	 */
 	style?: CSSStyleDeclaration;
 }
 /**
@@ -1636,49 +2110,83 @@ export declare type IPlayerOptions = {
 		volumeColor?: string;
 	};
 };
-/**
+/** {zh}
  * @brief mobile端交互配置。
  */
+/** {en}
+ * @brief Mobile interaction configuration.
+ */
 export interface IMobileConfig {
-	/**
+	/** {zh}
 	 * @brief 是否禁用手势，手势包括：
 	 * - 水平手势滑动快进/快退
 	 * - 左侧手势滑动调节亮度
 	 * - 右侧手势滑动调节音量（iOS不可用）
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable gestures. Gesture includes:
+	 * - Horizontal gesture to fast forward/rewind
+	 * - Left gesture to adjust brightness
+	 * - Right gesture to adjust volume (iOS not available)
+	 * @default false
+	 */
 	disableGesture?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否启用水平手势处理，水平手势快进/快退
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable horizontal gesture processing. Horizontal gesture includes fast forward/rewind.
+	 * @default false
+	 */
 	gestureX?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否启用垂直手势处理，默认不启用, 垂直手势包括屏幕右侧和屏幕左侧，默认左侧调节亮度，右侧调节音量，左右范围比例通过scopeL和scopeR设置
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable vertical gesture processing. Vertical gesture includes screen right and screen left. Default left to adjust brightness, right to adjust volume. The left and right range ratio is set through scopeL and scopeR.
+	 * @default false
+	 */
 	gestureY?: boolean;
-	/**
+	/** {zh}
 	 * @brief 左侧手势范围比例，取值0-1
 	 * @default 0.25
 	 */
+	/** {en}
+	 * @brief The left gesture range ratio, the value is 0-1.
+	 * @default 0.25
+	 */
 	scopeL?: number;
-	/**
+	/** {zh}
 	 * @brief 右侧手势范围，取值0-1
 	 * @default 0.25
 	 */
+	/** {en}
+	 * @brief The right gesture range ratio, the value is 0-1.
+	 * @default 0.25
+	 */
 	scopeR?: number;
-	/**
+	/** {zh}
 	 * @brief 是否启用左侧调暗功能，因为web端无法调用系统的亮度，这个功能实际使用透明蒙层实
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to enable left dimming function. Because the web cannot call the system brightness, this function is actually implemented using a transparent overlay.
+	 * @default true
+	 */
 	darkness?: boolean;
-	/**
-	 * @brief 播放器可调节的最大暗度，即蒙层最大透明度
+	/** {zh}
+	 * @brief 播放器可调节的最大暗度，即蒙层最大透明度。
+	 * @default 0.6
+	 */
+	/** {en}
+	 * @brief The maximum darkness of the player, i.e., the maximum transparency of the transparent layer.
 	 * @default 0.6
 	 */
 	maxDarkness?: number;
-	/**
+	/** {zh}
 	 * @brief 是否启用上下渐变阴影，即在播放器在激活时上下范围内有阴影
 	 * - normal 上下阴影
 	 * - none 无阴影
@@ -1686,90 +2194,165 @@ export interface IMobileConfig {
 	 * - bottom 仅下阴影
 	 * @default normal
 	 */
+	/** {en}
+	 * @brief Whether to enable vertical gradient shadow, i.e., there is a shadow in the upper and lower range when the player is activated.
+	 * - normal: normal shadow
+	 * - none: no shadow
+	 * - top: only upper shadow
+	 * - bottom: only lower shadow
+	 * @default normal
+	 */
 	gradient?: "normal" | "none" | "top" | "bottom";
-	/**
+	/** {zh}
 	 * @brief 是否在touchMove事件触发时（即手势滑动时）同时更新播放器的currentTime, 在手势移动过程中，不会直接调用播放器的快进快退，在toucheEnd的时候再设置
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to update the player's currentTime when the touchMove event is triggered (i.e., when the gesture is slid). During the gesture movement, the player's fast forward/rewind is not directly called, and the currentTime is set when the toucheEnd event is triggered.
+	 * @default false
+	 */
 	isTouchingSeek?: boolean;
-	/**
-	 * @brief 手势滑动的最小步伐，单位px，即滑动距离超过多少算作滑动，以减少不必要的滑动手势事件触发
+	/** {zh}
+	 * @brief 手势滑动的最小步伐，单位px，即滑动距离超过多少算作滑动，以减少不必要的滑动手势事件触发。
+	 * @default 5
+	 */
+	/** {en}
+	 * @brief The minimum step of the gesture movement, the unit is px, i.e., the sliding distance exceeding which is considered as sliding, to reduce unnecessary sliding gesture event triggers.
 	 * @default 5
 	 */
 	miniMoveStep?: number;
-	/**
+	/** {zh}
 	 * @brief 长按快进倍速
 	 * @default 2
 	 */
+	/** {en}
+	 * @brief The long press fast forward speed.
+	 * @default 2
+	 */
 	pressRate?: number;
-	/**
-	 * @brief 是否禁用时间预览雪碧图面板
+	/** {zh}
+	 * @brief 是否禁用时间预览雪碧图面板。
 	 * @notice 前提需要配置进度条预览雪碧图 thumbnail
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to disable the time preview sprite panel.
+	 * @notice The prerequisite is to configure the progress bar preview sprite thumbnail.
+	 * @default true
+	 */
 	disableActive?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用时间进度条，即拖动时不展示mini进度条
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the time progress bar, i.e., not to show the mini progress bar when dragging.
+	 * @default false
+	 */
 	disableTimeProgress?: boolean;
-	/**
+	/** {zh}
 	 * @brief 手势拖动的时候是否隐藏控制栏
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to hide the control bar when dragging.
+	 * @default true
+	 */
 	hideControlsActive?: boolean;
-	/**
+	/** {zh}
 	 * @brief 手势结束时隐藏控制栏
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to hide the control bar when the gesture ends.
+	 * @default false
+	 */
 	hideControlsEnd?: boolean;
-	/**
+	/** {zh}
 	 * @brief 滑动播放器区域快进/快退时，播放器区域对应的时长，即完整滑过播放器所对应的时长，单位ms
 	 * @default 360000
 	 */
+	/** {en}
+	 * @brief The duration of the player area when fast forward/rewind is performed, i.e., the duration corresponding to the full passage of the player area, the unit is ms.
+	 * @default 360000
+	 */
 	moveDuration?: number;
-	/**
+	/** {zh}
 	 * @brief 是否关闭双击切换暂停/播放的能力，同closeVideoDblclick
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the double-click to switch pause/play ability, same as closeVideoDblclick.
+	 * @default false
+	 */
 	closedbClick?: boolean;
-	/**
+	/** {zh}
 	 * @brief 禁用长按倍速调整
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to disable the long press to adjust the speed.
+	 * @default true
+	 */
 	disablePress?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用快进/快退的时候按钮提示
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the fast forward/rewind button prompt.
+	 * @default false
+	 */
 	disableSeekIcon?: boolean;
 }
-/**
+/** {zh}
  * @brief 播放器中间切换暂停/播放的按钮。
  */
+/** {en}
+ * @brief The center play/pause button.
+ */
 export interface IStartConfig {
-	/**
+	/** {zh}
 	 * @brief 暂停是否常驻
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to keep the pause button visible.
+	 * @default true
+	 */
 	isShowPause?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否播放结束常驻
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to keep the end button visible.
+	 * @default false
+	 */
 	isShowEnd?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用点击动画
 	 * @default pc：true，mobile：false
 	 */
+	/** {en}
+	 * @brief Whether to disable the click animation.
+	 * @default pc: true, mobile: false
+	 */
 	disableAnimate?: boolean;
-	/**
+	/** {zh}
 	 * @brief 按钮的跟随模式
 	 * - hide：起播之后隐藏
 	 * - show：常驻一直存在
 	 * - auto：自动跟随，播放器激活时即player.isActive=true的时候显示，否则隐藏
 	 * @default hide
 	 */
+	/** {en}
+	 * @brief The following modes are supported:
+	 * - hide: hidden after playback starts
+	 * - show: always visible
+	 * - auto: automatically follows, visible when player.isActive=true
+	 * @default hide
+	 */
 	mode?: "hide" | "show" | "auto";
 }
 /**
@@ -1777,7 +2360,7 @@ export interface IStartConfig {
  * @brief 西瓜插件
  */
 export declare type XGPlugin = typeof Plugin | typeof BasePlugin;
-/**
+/** {zh}
  * @brief 自动播放配置。
  * @list Options
  * @kind property
@@ -1792,7 +2375,7 @@ export interface IAutoplayPluginConfig {
 	 * @hidden
 	 */
 	position?: string;
-	/**
+	/** {zh}
 	 * @brief 是否开启降级静音自动播放。开启后，如果当前浏览器环境不支持有声音自动播放，则降级为静音自动播放。
 	 * @default false
 	 */
@@ -1801,7 +2384,7 @@ export interface IAutoplayPluginConfig {
 	 * @default false
 	 */
 	enableDegradeMuteAutoplay?: boolean;
-	/**
+	/** {zh}
 	 * @brief 启用微信jsBridge方式的自动播放
 	 * @default false
 	 * @hidden
@@ -1813,7 +2396,7 @@ export interface IAutoplayPluginConfig {
 	 * @hidden
 	 */
 	enableWxJsBridgeAutoplay?: boolean;
-	/**
+	/** {zh}
 	 * @brief 用户触发自动播放的目标 dom。
 	 * @default window.document.body
 	 */
@@ -1863,21 +2446,21 @@ declare class PlayList {
 	setStyle(style: any): void;
 	destroy(): void;
 }
-/**
+/** {zh}
  * @brief 播放列表展示面板触发动作类型。
  */
 /** {en}
  * @brief Playlist panel trigger action type.
  */
 export declare const enum TOGGLE_MODES {
-	/**
+	/** {zh}
 	 * @brief 鼠标点击。
 	 */
 	/** {en}
 	 * @brief Mouse click.
 	 */
 	CLICK = "click",
-	/**
+	/** {zh}
 	 * @brief 鼠标悬浮。
 	 */
 	/** {en}
@@ -1885,20 +2468,26 @@ export declare const enum TOGGLE_MODES {
 	 */
 	HOVER = "hover"
 }
-/**
+/** {zh}
  * @list Options
  * @brief 播放列表项配置，支持 DirectUrl 和 Vid + playAuthToken 两种播放模式。
  * @notes 列表数据由外部提供，播放器内部不直接获取播放列表数据。
  * @kind property
  */
+/** {en}
+ * @list Options
+ * @brief Playlist item configuration, supporting DirectUrl and Vid + playAuthToken two playback modes.
+ * @notes The list data is provided by external, and the player does not directly obtain the list data.
+ * @kind property
+ */
 export interface IPlayListItem {
-	/**
+	/** {zh}
 	 * @notes 临时播放 Token 为空时，此参数必传。
 	 * @default -
 	 * @listtip `playAuthToken` 为空时，此参数必传。
 	 * @brief 视频地址。
 	 */
-	/**
+	/** {en}
 	 * @notes Required when temporary play token is empty.
 	 * @default -
 	 * @listtip when `playAuthToken` is empty, this parameter is required.
@@ -1936,7 +2525,7 @@ export interface IPlayListItem {
 	 * @brief Video cover image URL.
 	 */
 	poster?: string;
-	/**
+	/** {zh}
 	 * @default -
 	 * @brief 视频标题。
 	 */
@@ -1945,7 +2534,7 @@ export interface IPlayListItem {
 	 * @brief Video title.
 	 */
 	title?: string;
-	/**
+	/** {zh}
 	 * @brief 视频时长，单位为秒。
 	 * @default -
 	 */
@@ -1978,10 +2567,11 @@ declare enum EPlayMode {
  */
 /** {en}
  * @list Options
+ * @brief Playlist plugin configuration.
  * @kind property
  */
 export interface IPlayListConfig {
-	/**
+	/** {zh}
 	 * @brief 按钮位置。取值如下：
 	 *
 	 *        - `controlsLeft`: 播控栏左侧
@@ -2007,7 +2597,7 @@ export interface IPlayListConfig {
 	 * @default controlsLeft
 	 */
 	position?: string;
-	/**
+	/** {zh}
 	 * @brief 按钮在所在区域的次序。默认值为 `2`，表示在播放按钮后。
 	 * @default 20
 	 */
@@ -2016,7 +2606,7 @@ export interface IPlayListConfig {
 	 * @default 20
 	 */
 	index?: number;
-	/**
+	/** {zh}
 	 * @brief 播放列表数据。
 	 * @default []
 	 */
@@ -2025,7 +2615,7 @@ export interface IPlayListConfig {
 	 * @default []
 	 */
 	list: IPlayListItem[];
-	/**
+	/** {zh}
 	 * @brief 循环模式，取值如下：
 	 *
 	 *        - `order`: 不循环播放，即列表中最后一个视频播放完成后就停止播放。
@@ -2040,7 +2630,7 @@ export interface IPlayListConfig {
 	 * @default order
 	 */
 	mode?: EPlayMode;
-	/**
+	/** {zh}
 	 * @brief 默认起始的播放次序。
 	 * @default order
 	 */
@@ -2049,7 +2639,7 @@ export interface IPlayListConfig {
 	 * @default order
 	 */
 	defaultIndex?: number;
-	/**
+	/** {zh}
 	 * @brief 列表点击之后是否隐藏。
 	 * @default true
 	 */
@@ -2058,7 +2648,7 @@ export interface IPlayListConfig {
 	 * @default true
 	 */
 	isItemClickHide?: boolean;
-	/**
+	/** {zh}
 	 * @brief 列表行为触发模式。
 	 * @default click
 	 */
@@ -2067,7 +2657,7 @@ export interface IPlayListConfig {
 	 * @default click
 	 */
 	toggleMode?: TOGGLE_MODES;
-	/**
+	/** {zh}
 	 * @brief 是否显示播放列表按钮。
 	 * @default true
 	 */
@@ -2156,16 +2746,18 @@ export declare class PlayListPlugin extends Plugin {
 	get disable(): boolean;
 	render(): string;
 }
-/**
+/** {zh}
  * @brief 动态水印配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief watermark config
+ * @list Options
+ * @kind property
  */
 export interface IWatermarkConfig {
-	/**
+	/** {zh}
 	 * @brief 是否开启动态水印，取值如下：<br/>
 	 *        - `true`：开启动态水印
 	 *        - `false`：关闭动态水印
@@ -2175,17 +2767,19 @@ export interface IWatermarkConfig {
 	 * @brief Is dynamic watermark enabled? The value is as follows:<br/>
 	 *        - `true`: Enable dynamic watermark
 	 *        - `false`: Disable dynamic watermark
+	 * @default false
 	 */
 	enable: boolean;
-	/**
+	/** {zh}
 	 * @brief 水印文案。
 	 * @default -
 	 */
 	/** {en}
+	 * @brief Watermark content.
 	 * @default -
 	 */
 	content: string;
-	/**
+	/** {zh}
 	 * @brief 水印展示形式，取值如下：<br/>
 	 *        - `0`：固定位置
 	 *        - `1`：全屏滚动
@@ -2193,18 +2787,23 @@ export interface IWatermarkConfig {
 	 * @default 1
 	 */
 	/** {en}
+	 * @brief Watermark display type. The value is as follows:<br/>
+	 *        - `0`: Fixed position
+	 *        - `1`: Full screen scrolling
+	 *        - `2`: Random flickering
 	 * @default 1
 	 */
 	displayType?: 0 | 1 | 2;
-	/**
+	/** {zh}
 	 * @brief 水印字体大小。`number`类型时单位为 px，`string` 类型时需要携带单位。
 	 * @default 12
 	 */
 	/** {en}
+	 * @brief Watermark font size. When the type is `number`, the unit is px. When the type is `string`, the unit needs to be included.
 	 * @default 12
 	 */
 	fontSize?: number | string;
-	/**
+	/** {zh}
 	 * @brief 水印字体颜色。
 	 * @brief 水印字体颜色。
 	 */
@@ -2213,15 +2812,16 @@ export interface IWatermarkConfig {
 	 * @brief Watermark font color.
 	 */
 	fontColor?: string;
-	/**
+	/** {zh}
 	 * @brief 水印不透明度。取值范围：\[0~1\]。
 	 * @default 0.3
 	 */
 	/** {en}
+	 * @brief Watermark opacity. The value is in the range of [0~1].
 	 * @default 0.3
 	 */
 	opacity?: number;
-	/**
+	/** {zh}
 	 * @brief 水印闪烁速度，取值如下：<br/>
 	 *        - `MODERATE`：适中
 	 *        - `FAST`：较快
@@ -2229,33 +2829,57 @@ export interface IWatermarkConfig {
 	 * @default MODERATE
 	 */
 	/** {en}
+	 * @brief Watermark ticker speed. The value is as follows:<br/>
+	 *        - `MODERATE`: Moderate
+	 *        - `FAST`: Fast
+	 *        - `SLOW`: Slow
 	 * @default MODERATE
 	 */
 	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
-	/**
+	/** {zh}
 	 * @brief 水印字体类型
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark font family.
+	 * @default -
+	 */
 	fontFamily?: string;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器顶部的距离，单位为 px
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Watermark top distance. The unit is px.
+	 * @default 0
+	 */
 	top?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器左侧的距离，单位为 px。
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Watermark left distance. The unit is px.
+	 * @default 0
+	 */
 	left?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器底部的距离，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark bottom distance. The unit is px.
+	 * @default -
+	 */
 	bottom?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器右侧的距离，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark right distance. The unit is px.
+	 * @default -
+	 */
 	right?: number;
 }
 export declare class DynamicWatermarkPlugin extends Plugin {
@@ -2451,6 +3075,7 @@ export interface ISubtitleInfoList {
 	Version: string;
 	Vid: string;
 }
+export declare type ISubtitleInfoListItem = ISubtitleInfoList | string;
 /** {zh}
  * @hidden
  */
@@ -2525,11 +3150,118 @@ export interface IGetPlayInfoRes {
 	PlayInfoList: IPlayInfoListItem[];
 	PosterUrl: string;
 	Status: number;
-	SubtitleInfoList: ISubtitleInfoList[];
+	SubtitleInfoList?: ISubtitleInfoListItem[];
 	ThumbInfoList: IThumbInfoItem[];
 	TotalCount: number;
 	Version: number;
 }
+/**
+ * 短剧环境配置接口
+ */
+export interface ITTDramaEnv {
+	/** 云服务商，默认从构建时 env.__PLATFORM__ 获取，未注入时默认为 byteplus */
+	channel?: "volcengine" | "byteplus";
+	/**
+	 * @brief 应用版本号
+	 * @type {string}
+	 */
+	appVersion: string;
+	/**
+	 * @brief 小程序三方id
+	 * @type {string}
+	 */
+	clientKey: string;
+	/**
+	 * @brief 是否支持获取短剧信息
+	 * @type {boolean}
+	 */
+	canIUseGetDramaInfo: boolean;
+	/** 是否支持在 getDramaInfo 中透传 transcodeParam */
+	canIUseGetDramaInfoTranscodeParam?: boolean;
+	/**
+	 * @brief Android 是否支持批量获取短剧信息（高版本 app）
+	 * @type {boolean}
+	 */
+	canAndroidBatchGetDramaInfo?: boolean;
+	/**
+	 * @brief 获取短剧信息
+	 * @type {function}
+	 */
+	getDramaInfo: (callback: (res: IJSBCallbackResult) => void, options: IGetDramaInfoOptions) => void;
+	videoSecurityModule?: any;
+	/**
+	 * @brief 日志发送接口
+	 * @type {function}
+	 */
+	sendLog: (EventName: string, params: Record<string, any>) => void;
+	/**
+	 * 低版本 app 下验证 TTOP 签发的 playAuthToken 时使用的密钥
+	 * 通过 JSB（如 minis.getSecret）从 Native 获取，用于 HMAC-SHA256 签名校验
+	 */
+	getTokenVerifySecret?: () => Promise<string>;
+}
+/**
+ * JSB 获取短剧信息请求参数
+ */
+export interface IGetDramaInfoOptions {
+	clientKey: string;
+	albumId: string;
+	episodeId: string;
+	vid: string;
+	transcodeParam?: IGetDramaInfoTranscodeParam;
+}
+/** JSB/TTOP 使用的 snake_case 转码参数。 */
+export interface IGetDramaInfoTranscodeParam {
+	format?: string;
+	codec?: string;
+	definition?: string;
+	file_type?: string;
+	need_thumbs?: string;
+	need_barrage_mask?: string;
+	union_info?: string;
+	quality?: string;
+	drm_kek?: string;
+	js_player?: string;
+}
+export interface MinisError {
+	error_code: number;
+	error_msg: string;
+	error_extra?: unknown;
+}
+/**
+ * JSB getDramaInfo 返回的客户端耗时信息，单位 ms。
+ */
+export interface IGetDramaInfoPerfInfo {
+	prepare_cost?: number;
+	request_cost?: number;
+	parse_cost?: number;
+	total_cost?: number;
+	[propName: string]: any;
+}
+/**
+ * JSB 获取短剧信息返回结果
+ */
+export interface IJSBCallbackResult {
+	is_success: number | boolean;
+	error?: MinisError;
+	data?: {
+		status: number;
+		drama_info: {
+			album_id: string;
+			drama_name: string;
+			drama_cover: string;
+			drama_description: string;
+		};
+		episode_info: {
+			episode_id: string;
+			episode_name: string;
+			episode_cover: string;
+			episode_description: string;
+		};
+		video_info: IGetPlayInfoRes | Record<string, any>;
+		perf_info?: IGetDramaInfoPerfInfo;
+	};
+}
 /** {zh}
  * @list Options
  * @brief 视频编码格式。
@@ -2828,6 +3560,7 @@ export interface IABCycle {
  */
 /** {en}
  * @list Options
+ * @brief Music playback mode configuration.
  * @kind property
  */
 export interface IMusicConfig {
@@ -3158,21 +3891,119 @@ export interface Current extends Partial<Stream> {
 	/**
 	 * @hidden
 	 */
-	[propName: string]: any;
+	[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 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;
+	type?: string;
+	[propName: string]: any;
+}>;
+/** {zh}
+ * @list Options
+ * @kind property
+ * @brief 获取到媒体信息时的回调参数。
+ */
+/** {en}
+ * @list Options
+ * @kind property
+ * @brief Callback payload when media information is obtained.
+ */
+export interface IGetMediaInfoCallbackPayload {
+	/** {zh}
+	 * @brief 媒体信息。
+	 */
+	/** {en}
+	 * @brief Media information.
+	 */
+	data: {
+		playList?: Stream[];
+		type?: string;
+		poster?: string;
+		vid?: string;
+		duration?: number;
+		[propName: string]: any;
+	};
+	/** {zh}
+	 * @brief 媒体信息是否来自缓存。
+	 */
+	/** {en}
+	 * @brief Whether the media information comes from cache.
+	 */
+	fromCache: boolean;
+}
+/** {zh}
+ * @list Options
+ * @kind property
+ * @brief JSB getDramaInfo 客户端耗时回调参数。
+ */
+/** {en}
+ * @list Options
+ * @kind property
+ * @brief Callback payload for client-side getDramaInfo timing returned by JSB.
+ */
+export interface IGetDramaInfoPerfCallbackPayload {
+	/** {zh}
+	 * @brief JSB 返回的客户端耗时信息，单位 ms。
+	 */
+	/** {en}
+	 * @brief Client-side timing returned by JSB, in milliseconds.
+	 */
+	perfInfo: IGetDramaInfoPerfInfo;
+	/** {zh}
+	 * @brief 剧 ID。
+	 */
+	albumId?: string;
+	/** {zh}
+	 * @brief 剧集 ID。
+	 */
+	episodeId?: string;
+	/** {zh}
+	 * @brief 视频 ID。
+	 */
+	vid?: string;
+	/** {zh}
+	 * @brief JSB 是否请求成功。
+	 */
+	isSuccess: boolean;
+	/** {zh}
+	 * @brief 短剧审核状态。
+	 */
+	status?: number;
+	/** {zh}
+	 * @brief 是否来自缓存。getDramaInfo 实际请求返回时固定为 false。
+	 */
+	fromCache: boolean;
+	/** {zh}
+	 * @brief SDK 收到回调时的时间戳。
+	 */
+	timestamp: number;
 }
 /** {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 加密视频。
+ * @brief Minis 短剧转码参数。各字段会由 VePlayer 转换为服务端 snake_case 命名后透传。
  */
 /** {en}
- * @detail Options
- * @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.
+ * @brief Minis short-drama transcoding parameters. VePlayer converts the fields to server-side snake_case names before forwarding them.
  */
-export declare type Url = string | Array<{
-	src: string;
-	type?: string;
-	[propName: string]: any;
-}>;
+export interface ITranscodeParam {
+	format?: string;
+	codec?: string;
+	definition?: string;
+	fileType?: string;
+	needThumbs?: string;
+	needBarrageMask?: string;
+	unionInfo?: string;
+	quality?: string;
+	drmKek?: string;
+	jsPlayer?: string;
+}
 /** {zh}
  * @list Options
  * @kind property
@@ -3236,6 +4067,21 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 */
 	vid?: string;
+	/**
+	 * @brief 剧id,Minis 短剧播放需要
+	 */
+	albumId?: string;
+	/**
+	 * @brief 剧集id，Minis 短剧播放需要
+	 */
+	episodeId?: string;
+	/** {zh}
+	 * @brief Minis 短剧转码参数。
+	 */
+	/** {en}
+	 * @brief Minis short-drama transcoding parameters.
+	 */
+	transcodeParam?: ITranscodeParam;
 	/** {zh}
 	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时临时播放 Token，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
@@ -3245,6 +4091,34 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief Vid playback configuration. The app server generates a temporary play token from `vid` and passes it to the client.
 	 */
 	getVideoByToken?: IPlayAuthTokenConfig;
+	/** {zh}
+	 * @brief 通过 `playAuthToken` 或缓存获取到媒体信息时触发的回调。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Callback fired when media information is obtained from `playAuthToken` or cache.
+	 * @default -
+	 */
+	onGetMediaInfo?: (payload: IGetMediaInfoCallbackPayload) => void;
+	/** {zh}
+	 * @brief JSB `getDramaInfo` 返回客户端耗时信息时触发的回调。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Callback fired when JSB `getDramaInfo` returns client-side timing.
+	 * @default -
+	 */
+	onGetDramaInfoPerf?: (payload: IGetDramaInfoPerfCallbackPayload) => void;
+	/** {zh}
+	 * @brief 是否自动使用 `playAuthToken` 或短剧信息返回的字幕列表。
+	 * @default false
+	 */
+	autoSubtitle?: boolean;
+	/** {zh}
+	 * @brief 自动字幕项格式化回调。返回字符串或数字时作为字幕名称；返回 `false` 或 `{ show: false }` 时不展示该项；返回 `{ isDefault: true }` 或 `{ default: true }` 时设为默认字幕。
+	 * @default -
+	 */
+	formatAutoSubtitleItem?: IAutoSubtitleItemFormatter;
 	/** {zh}
 	 * @brief 视频加密类型
 	 * @default -
@@ -4122,6 +4996,15 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default 0
 	 */
 	oriErrMaxTotalRetry?: number;
+	/** {zh}
+	 * @brief 是否在原生媒体错误时自动重试拉流。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to automatically retry playback after native media errors.
+	 * @default true
+	 */
+	enableOriErrRetry?: boolean;
 	/** {zh}
 	 * @brief 是否在重试耗尽后发起错误诊断请求，以细化错误码。
 	 * @default true
@@ -5289,7 +6172,8 @@ export interface ApiMapConfig {
 	playDomain: string;
 	backupPlayDomain?: string;
 }
-declare enum UmdKeys {
+/** UMD modules that can be loaded or explicitly pre-registered. */
+export declare enum UmdKeys {
 	HLS = "hls",
 	HLSJS = "hlsjs",
 	FLV = "flv",
@@ -5308,11 +6192,13 @@ declare enum UmdKeys {
 	Preloader = "preloader",
 	HLSjsPro = "hlsjsPro"
 }
+/** Resolved UMD module values keyed by their public UMD key. */
+export declare type UmdModules = Partial<Record<UmdKeys, unknown>>;
 /**
  * @hidden
- * @breif umdmap 配置
+ * @breif umdmap 单项配置
  */
-export declare type UMDMap = Record<UmdKeys, {
+export interface UMDMapEntry {
 	/**
 	 * umd Module 的名称，即在window下暴露的接口名称
 	 */
@@ -5329,10 +6215,20 @@ export declare type UMDMap = Record<UmdKeys, {
 	 * npm包中umd入口文件路径，用于打包上传到cdn目录
 	 */
 	devPath: string;
-}>;
+}
+/**
+ * @hidden
+ * @breif umdmap 配置；精简构建可只提供其支持的依赖。
+ */
+export declare type UMDMap = Partial<Record<UmdKeys, UMDMapEntry>>;
 declare class UMDLoader {
 	private static jsLoadMap;
 	private static jsLoadPromiseMap;
+	private static registeredModules;
+	/** 注册业务已打包的 UMD 模块，优先于缓存、window 全局和 script 加载。 */
+	static registerModules(modules: UmdModules): void;
+	/** 清除指定插件的加载缓存，使下次 loadPlugins 重新触发加载。 */
+	clearPluginCache(pluginName: UmdKeys): void;
 	umdMap: UMDMap;
 	backupUmdUrlMap: Record<string, string>;
 	failCallback: (umdName: string, err: any) => any;
@@ -5434,6 +6330,129 @@ export declare class SdkPlugin {
 	 */
 	__destroy(): void;
 }
+/**
+ * @author bytedance
+ * @version 1.0
+ * @Description
+ * @date 2024/12/16 17:59
+ */
+export declare const enum LangTextKey {
+	NETWORK = "NETWORK",
+	NETWORK_TIMEOUT = "NETWORK_TIMEOUT",
+	NETWORK_FORBIDDEN = "NETWORK_FORBIDDEN",
+	NETWORK_NOTFOUND = "NETWORK_NOTFOUND",
+	NETWORK_RANGE_NOT_SATISFIABLE = "NETWORK_RANGE_NOT_SATISFIABLE",
+	NETWORK_PROTOCOL = "NETWORK_PROTOCOL",
+	NETWORK_URL_EXPIRE = "NETWORK_URL_EXPIRE",
+	NETWORK_URL_SIGN = "NETWORK_URL_SIGN",
+	NETWORK_ENCRYPT_HLS_ERR = "NETWORK_ENCRYPT_HLS_ERR",
+	MEDIA_ERR = "MEDIA_ERR",
+	MEDIA_ERR_ABORTED = "MEDIA_ERR_ABORTED",
+	MEDIA_ERR_NETWORK = "MEDIA_ERR_NETWORK",
+	MEDIA_ERR_DECODE = "MEDIA_ERR_DECODE",
+	MEDIA_ERR_SRC_NOT_SUPPORTED = "MEDIA_ERR_SRC_NOT_SUPPORTED",
+	MEDIA_ERR_NOT_SUPPORTED = "MEDIA_ERR_NOT_SUPPORTED",
+	MEDIA_ERR_URL_EMPTY = "MEDIA_ERR_URL_EMPTY",
+	MEDIA_ERR_FILE_NOT_SUPPORTED = "MEDIA_ERR_FILE_NOT_SUPPORTED",
+	MEDIA_ERR_PLAY_ERR = "MEDIA_ERR_PLAY_ERR",
+	MEDIA_SOURCE_CANNOT_PLAY_TYPE = "MEDIA_SOURCE_CANNOT_PLAY_TYPE",
+	BUSINESS_DRM_NOT_SUPPORT = "BUSINESS_DRM_NOT_SUPPORT",
+	BUSINESS_DRM_NOT_SUPPORT_UN_RECORD = "BUSINESS_DRM_NOT_SUPPORT_UN_RECORD",
+	BUSINESS_DRM_LACK_MEDIA_KEY = "BUSINESS_DRM_LACK_MEDIA_KEY",
+	BUSINESS_DRM_LACK_KEY_SESSION = "BUSINESS_DRM_LACK_KEY_SESSION",
+	BUSINESS_DRM_GENERATE_REQUEST_FAIL = "BUSINESS_DRM_GENERATE_REQUEST_FAIL",
+	BUSINESS_DRM_LACK_SERVER_CERTIFICATE_PATH = "BUSINESS_DRM_LACK_SERVER_CERTIFICATE_PATH",
+	BUSINESS_DRM_LACK_SERVER_PROCESSSPC_PATH = "BUSINESS_DRM_LACK_SERVER_PROCESSSPC_PATH",
+	BUSINESS_DRM_LICENSE_FAIL = "BUSINESS_DRM_LICENSE_FAIL",
+	BUSINESS_DRM_KEY_ERROR = "BUSINESS_DRM_KEY_ERROR",
+	BUSINESS_DRM_CERT_FAIL = "BUSINESS_DRM_CERT_FAIL",
+	PRIVATE_DRM_KEY_GET_FAILED = "PRIVATE_DRM_KEY_GET_FAILED",
+	PRIVATE_DRM_CRYPTO_NOT_SUPPORT = "PRIVATE_DRM_CRYPTO_NOT_SUPPORT",
+	PRIVATE_DRM_RSA_FAIL = "PRIVATE_DRM_RSA_FAIL",
+	OTHER = "OTHER",
+	VOD_LOG_NOT_CONFIGURED = "VOD_LOG_NOT_CONFIGURED",
+	PLAY_AUTH_TOKEN_EXPIRED = "PLAY_AUTH_TOKEN_EXPIRED",
+	HLS_KEY_TOKEN_EXPIRED = "HLS_KEY_TOKEN_EXPIRED",
+	THIRD_PARTY_DRM_AUTH_TOKEN_EXPIRED = "THIRD_PARTY_DRM_AUTH_TOKEN_EXPIRED",
+	GET_PLAY_INFO_ERR = "GET_PLAY_INFO_ERR",
+	GET_HLS_DECRYPTION_KEY_ERR = "GET_HLS_DECRYPTION_KEY_ERR",
+	LICENSE_VALIDATE_FAIL = "LICENSE_VALIDATE_FAIL",
+	DEFINITION_AUTO = "DEFINITION_AUTO",
+	LICENSE_STATUS_INVALID = "LICENSE_STATUS_INVALID",
+	LICENSE_STATUS_ERROR_DOMAIN_NOT_MATCH = "LICENSE_STATUS_ERROR_DOMAIN_NOT_MATCH",
+	BASE_LICENSE_NOT_SUPPORT_265 = "BASE_LICENSE_NOT_SUPPORT_265",
+	BASE_LICENSE_NOT_SUPPORT_ABR = "BASE_LICENSE_NOT_SUPPORT_ABR",
+	BASE_LICENSE_NOT_SUPPORT_ADAPT_BUFFER = "BASE_LICENSE_NOT_SUPPORT_ADAPT_BUFFER",
+	BASE_LICENSE_NOT_SUPPORT_PRELOAD = "BASE_LICENSE_NOT_SUPPORT_PRELOAD",
+	EXPIRED_LICENSE_NOT_SUPPORT_265 = "EXPIRED_LICENSE_NOT_SUPPORT_265",
+	EXPIRED_LICENSE_NOT_SUPPORT_ABR = "EXPIRED_LICENSE_NOT_SUPPORT_ABR",
+	EXPIRED_LICENSE_NOT_SUPPORT_ADAPT_BUFFER = "EXPIRED_LICENSE_NOT_SUPPORT_ADAPT_BUFFER",
+	EXPIRED_LICENSE_NOT_SUPPORT_PRELOAD = "EXPIRED_LICENSE_NOT_SUPPORT_PRELOAD",
+	/** Short drama (Minis) errors — codes 93xx */
+	DRAMA_INVALID_PARAM = "DRAMA_INVALID_PARAM",
+	DRAMA_NO_INFO_FOUND = "DRAMA_NO_INFO_FOUND",
+	DRAMA_NOT_SUBMITTED = "DRAMA_NOT_SUBMITTED",
+	DRAMA_UNDER_REVIEW = "DRAMA_UNDER_REVIEW",
+	DRAMA_FAILED_REVIEW = "DRAMA_FAILED_REVIEW",
+	DRAMA_WITHDRAWN_REVIEW = "DRAMA_WITHDRAWN_REVIEW",
+	DRAMA_FAILED_TO_QUERY = "DRAMA_FAILED_TO_QUERY",
+	DRAMA_INVALID_TTOP_TOKEN = "DRAMA_INVALID_TTOP_TOKEN",
+	DRAMA_NOT_ON_SHELF = "DRAMA_NOT_ON_SHELF",
+	DRAMA_FAILED_GET_EPISODE_INFO = "DRAMA_FAILED_GET_EPISODE_INFO"
+}
+declare const DRAMA_ERROR_CODE: {
+	/** 9301 - 短剧环境下参数不合法（如使用 url/playList 播放，或缺少 albumId / episodeId） */
+	readonly INVALID_PARAM: {
+		readonly code: 9301;
+		readonly message: "Invalid parameter in short drama environment";
+		readonly textKey: LangTextKey.DRAMA_INVALID_PARAM;
+	};
+	readonly NO_INFO_FOUND: {
+		readonly code: 9302;
+		readonly message: "No information found for this Episode";
+		readonly textKey: LangTextKey.DRAMA_NO_INFO_FOUND;
+	};
+	readonly NOT_SUBMITTED: {
+		readonly code: 9303;
+		readonly message: "Episode not submitted for review";
+		readonly textKey: LangTextKey.DRAMA_NOT_SUBMITTED;
+	};
+	readonly UNDER_REVIEW: {
+		readonly code: 9304;
+		readonly message: "Episode under for review";
+		readonly textKey: LangTextKey.DRAMA_UNDER_REVIEW;
+	};
+	readonly FAILED_REVIEW: {
+		readonly code: 9305;
+		readonly message: "Episode failed review";
+		readonly textKey: LangTextKey.DRAMA_FAILED_REVIEW;
+	};
+	readonly WITHDRAWN_REVIEW: {
+		readonly code: 9306;
+		readonly message: "Episode withdrawn from review";
+		readonly textKey: LangTextKey.DRAMA_WITHDRAWN_REVIEW;
+	};
+	readonly FAILED_TO_QUERY: {
+		readonly code: 9307;
+		readonly message: "Failed to query video playback information";
+		readonly textKey: LangTextKey.DRAMA_FAILED_TO_QUERY;
+	};
+	readonly INVALID_TTOP_TOKEN: {
+		readonly code: 9308;
+		readonly message: "Invalid playAuthToken or failed to verify TTOP token";
+		readonly textKey: LangTextKey.DRAMA_INVALID_TTOP_TOKEN;
+	};
+	readonly NOT_ON_SHELF: {
+		readonly code: 9310;
+		readonly message: "Video is not on shelf";
+		readonly textKey: LangTextKey.DRAMA_NOT_ON_SHELF;
+	};
+	readonly FAILED_GET_EPISODE_INFO: {
+		readonly code: 9399;
+		readonly message: "Failed get episode info";
+		readonly textKey: LangTextKey.DRAMA_FAILED_GET_EPISODE_INFO;
+	};
+};
 declare class AuthToken extends SdkPlugin {
 	static get pluginName(): string;
 	isPlayByToken: boolean;
@@ -5449,19 +6468,56 @@ declare class AuthToken extends SdkPlugin {
 	playInfo?: VideoInfoRes;
 	constructor(args: any);
 	beforePlayerCreate(): Promise<void>;
-	getVideoInfo(): Promise<{
+	getVideoInfo(sourceConfigs?: IPlayerConfig): Promise<{
 		vid: string;
 		playList: Stream[];
 		codec: ICodecType;
 		defaultDefinition: string;
 	}>;
-	getVideos(): Promise<any>;
+	/**
+	 * 短剧 Minis 环境：通过 JSB getDramaInfo 获取媒体信息
+	 */
+	getDramaInfoViaJSB(sourceConfigs?: IPlayerConfig): Promise<VideoInfoRes | undefined>;
+	/**
+	 * 将审核状态映射到短剧错误码
+	 */
+	mapReviewStatusToErrorCode(status: number): keyof typeof DRAMA_ERROR_CODE;
+	/**
+	 * 根据 JSB 返回的 msg 或 status 映射到错误码 key
+	 */
+	mapDramaErrorCode(msg: string, status?: number): keyof typeof DRAMA_ERROR_CODE;
+	/**
+	 * 将 JSB 返回的 video_info 转换为 VideoInfoRes 格式
+	 */
+	transformDramaVideoInfoToRes(videoInfo: any, config: IPlayAuthTokenConfig): VideoInfoRes;
+	callOnGetMediaInfo(mediaInfo: VideoInfoRes | undefined, fromCache: boolean): void;
+	reportGetDramaInfoPerf(res: IJSBCallbackResult | undefined, request: {
+		albumId?: string;
+		episodeId?: string;
+		vid?: string;
+	}): void;
+	getVideos(sourceConfigs?: IPlayerConfig): Promise<any>;
 	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
 	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
 	getBarrageMaskUrl(url: string): void;
+	setSubtitleConfig(mediaInfo: VideoInfoRes | undefined): void;
+	getAutoSubtitleList(mediaInfo: VideoInfoRes): ISubTitleItem[];
+	getSubtitleSourceData(mediaInfo: VideoInfoRes): any;
+	getAutoSubtitleItem(item: any, index: number): ISubTitleItem | undefined;
+	getStringAutoSubtitleItem(item: string, index: number): ISubTitleItem;
+	getObjectAutoSubtitleItem(item: any, index: number): ISubTitleItem | undefined;
+	formatAutoSubtitleItem(subtitleItem: ISubTitleItem, rawItem: any, index: number): ISubTitleItem | undefined;
 	getDrmConfig(videoInfo: IVideoInfo): void;
+	/**
+	 * 是否处于短剧 Minis 环境（通过剧 ID + 剧集 ID 获取视频）
+	 */
+	get isMinisDramaMode(): boolean;
 	init(): void;
-	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
+	initConfig(getVideoByToken: IPlayAuthTokenConfig, sourceConfigs?: IPlayerConfig): void;
+	/**
+	 * 剧集切换：configs 已由 player 更新 album_id/episode_id，重新拉取媒体信息
+	 */
+	updateDramaEpisode(isNewVideo: boolean, candidateConfig?: IPlayerConfig): Promise<void>;
 	/**
 	 * @description 更新playAuthToken
 	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
@@ -5584,9 +6640,7 @@ declare class PlayerData {
 	 * @brief 私有加密会话id
 	 */
 	encryptSessionId?: string;
-	constructor(configs: IPlayerConfig & {
-		licensSupportModuleList: string[];
-	}, sdk: VePlayer);
+	constructor(configs: IPlayerConfig, sdk: VePlayer);
 	/**
 	 * 初始化播放数据
 	 * @param configs { IPlayerConfig } 播放器配置
@@ -5666,6 +6720,10 @@ declare class PlayerData {
 	 */
 	get playDomain(): string;
 	setVodTeaId(): void;
+	/**
+	 * 基于当前配置生成合并后的候选配置，不修改当前播放状态。
+	 */
+	getMergedConfigs(newConfigs: IPlayerConfig): IPlayerConfig;
 	/**
 	 * 更新configs,即更新用户的configs，常用于playNext时
 	 * @param newConfigs {IPlayerConfig} 要更新的配置
@@ -5771,146 +6829,412 @@ export declare type PreloaderManager = {
 };
 declare enum PreloadScene {
 	/** {zh}
-	 * @brief 普通场景（手动执行预加载）
+	 * @brief 普通场景（手动执行预加载）
+	 */
+	/** {en}
+	 * @brief Normal scenario (manual preload).
+	 */
+	NORMAL = 0,
+	/** {zh}
+	 * @brief Feed 流场景（播放器自动执行预加载）
+	 */
+	/** {en}
+	 * @brief Feed scenario (player auto-preloads).
+	 */
+	FEED = 1
+}
+declare enum PreloadFormat {
+	MP4 = "mp4",
+	HLS = "hls"
+}
+declare enum PreloaderStatus {
+	/** {zh}
+	 * @brief 不可用
+	 */
+	/** {en}
+	 * @brief Disabled.
+	 */
+	DISABLED = 0,
+	/** {zh}
+	 * @brief 初始状态
+	 */
+	/** {en}
+	 * @brief Initializing.
+	 */
+	INITIALIZING = 1,
+	/** {zh}
+	 * @brief 已Ready
+	 */
+	/** {en}
+	 * @brief Ready.
+	 */
+	READY = 2,
+	/** {zh}
+	 * @brief 加载失败
+	 */
+	/** {en}
+	 * @brief Failed.
+	 */
+	FAILED = 3
+}
+/** {zh}
+ * 预加载配置更新
+ * @detail Options
+ * @hidden
+ */
+/** {en}
+ * @brief Preload configuration update.
+ * @detail Options
+ * @hidden
+ */
+export declare type IPreloadUpdateConfig = {
+	/** {zh}
+	 * @brief 向前加载视频个数
+	 */
+	/** {en}
+	 * @brief Number of videos to load ahead.
+	 */
+	prevCount?: number;
+	/** {zh}
+	 * @brief 向后加载视频个数
+	 */
+	/** {en}
+	 * @brief Number of videos to load behind.
+	 */
+	nextCount?: number;
+};
+/** {zh}
+ * 预加载视频资源
+ * @detail Options
+ */
+/** {en}
+ * @brief Preload video resource.
+ * @detail Options
+ */
+export declare type IPreloadResolvedStream = {
+	/** {zh}
+	 * @brief 视频 ID
+	 */
+	/** {en}
+	 * @brief Unique video ID.
+	 */
+	vid: string;
+	/** {zh}
+	 * @brief 视频播放地址
+	 */
+	/** {en}
+	 * @brief Playback URL.
+	 */
+	url: string;
+	/** {zh}
+	 * @brief 视频清晰度
+	 */
+	/** {en}
+	 * @brief Video definition (resolution).
+	 */
+	definition: string;
+	/** {zh}
+	 * @brief 视频流类型，支持 mp4、hls
+	 */
+	/** {en}
+	 * @brief Stream type; supports mp4 and hls.
+	 */
+	streamType: string;
+	/** {zh}
+	 * @brief 视频编码格式，当前仅支持 mp4
+	 */
+	/** {en}
+	 * @brief Video codec; currently supports h264.
+	 */
+	codec: string;
+	/** {zh}
+	 * @brief 码率, 数据统计需要，选填
+	 */
+	/** {en}
+	 * @brief Bitrate; optional, used for analytics.
+	 */
+	bitrate: number;
+	/** {zh}
+	 * @brief 视频时长，数据统计需要，选填
+	 */
+	/** {en}
+	 * @brief Duration; optional, used for analytics.
+	 */
+	duration: number;
+	/** {zh}
+	 * @brief 视频大小，数据统计需要，选填
+	 */
+	/** {en}
+	 * @brief File size; optional, used for analytics.
+	 */
+	size: number;
+};
+export declare type IPreloadDramaStream = {
+	vid?: string;
+	albumId: string;
+	episodeId: string;
+	/** {zh}
+	 * @brief 默认清晰度，仅用于从完整媒体信息中选择预加载流。
+	 */
+	/** {en}
+	 * @brief Default definition used only to select a preload stream from complete media information.
+	 */
+	defaultDefinition?: string;
+	/** {zh}
+	 * @brief Minis 短剧转码参数。
+	 */
+	/** {en}
+	 * @brief Transcoding parameters for Minis short dramas.
+	 */
+	transcodeParam?: ITranscodeParam;
+	/** {zh}
+	 * @brief Vid 播放配置。短剧预加载会复用 playAuthToken 等配置请求短剧信息。
+	 */
+	/** {en}
+	 * @brief Vid playback configuration reused by short-drama preload requests.
+	 */
+	getVideoByToken?: IPlayAuthTokenConfig;
+};
+export declare type IPreloadAuthTokenStream = {
+	vid?: string;
+	defaultDefinition?: string;
+	getVideoByToken: IPlayAuthTokenConfig;
+};
+/** {zh}
+ * @brief 媒体信息预取源，支持 playAuthToken 和短剧剧集配置，不支持直接 URL。
+ * @detail ref
+ */
+/** {en}
+ * @brief Media info prefetch source. Supports playAuthToken and short-drama episode configs, but not direct URLs.
+ * @detail ref
+ */
+export declare type IMediaInfoPrefetchSource = IPreloadAuthTokenStream | IPreloadDramaStream;
+/** {zh}
+ * @brief 媒体信息预取成功结果。
+ * @detail ref
+ */
+/** {en}
+ * @brief Successful media info prefetch result.
+ * @detail ref
+ */
+export declare type IMediaInfoPrefetchSuccess = {
+	status: "fulfilled";
+	source: IMediaInfoPrefetchSource;
+	data: IGetMediaInfoCallbackPayload["data"];
+	fromCache: boolean;
+};
+/** {zh}
+ * @brief 媒体信息预取失败结果。
+ * @detail ref
+ */
+/** {en}
+ * @brief Failed media info prefetch result.
+ * @detail ref
+ */
+export declare type IMediaInfoPrefetchFailure = {
+	status: "rejected";
+	source: IMediaInfoPrefetchSource;
+	error: {
+		code: number;
+		message: string;
+	};
+};
+/** {zh}
+ * @brief 单个媒体信息预取结果。批量请求按输入顺序返回，单项失败不会中断其他项。
+ * @detail ref
+ */
+/** {en}
+ * @brief Result for one media info prefetch item. Batch results preserve input order, and one failure does not interrupt other items.
+ * @detail ref
+ */
+export declare type IMediaInfoPrefetchResult = IMediaInfoPrefetchSuccess | IMediaInfoPrefetchFailure;
+export declare type IPreloadStream = IPreloadResolvedStream | IPreloadDramaStream | IPreloadAuthTokenStream;
+/** {zh}
+ * @list Options
+ * @brief 字幕项。
+ * @kind property
+ */
+/** {en}
+ * @list Options
+ * @brief Subtitle item.
+ * @kind property
+ */
+export interface ISubTitleItem {
+	/** {zh}
+	 * @brief 字幕语言。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Normal scenario (manual preload).
+	 * @brief Subtitle language.
+	 * @default -
 	 */
-	NORMAL = 0,
+	language?: string | number;
 	/** {zh}
-	 * @brief Feed 流场景（播放器自动执行预加载）
+	 * @brief 字幕 ID。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Feed scenario (player auto-preloads).
+	 * @brief Subtitle ID.
+	 * @default -
 	 */
-	FEED = 1
-}
-declare enum PreloadFormat {
-	MP4 = "mp4",
-	HLS = "hls"
-}
-declare enum PreloaderStatus {
+	id?: number | string;
 	/** {zh}
-	 * @brief 不可用
+	 * @brief 是否为默认选择的字幕。
+	 * @default false
 	 */
 	/** {en}
-	 * @brief Disabled.
+	 * @brief Whether this is the default selected subtitle.
+	 * @default false
 	 */
-	DISABLED = 0,
+	isDefault?: boolean;
 	/** {zh}
-	 * @brief 初始状态
+	 * @brief 字幕名称。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Initializing.
+	 * @brief Subtitle display name.
+	 * @default -
 	 */
-	INITIALIZING = 1,
+	text?: string;
 	/** {zh}
-	 * @brief 已Ready
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Ready.
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
 	 */
-	READY = 2,
+	label?: string | number;
 	/** {zh}
-	 * @brief 加载失败
+	 * @brief 外挂字幕 URL 地址。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Failed.
-	 */
-	FAILED = 3
-}
-/** {zh}
- * 预加载配置更新
- * @detail Options
- * @hidden
- */
-/** {en}
- * @brief Preload configuration update.
- * @detail Options
- * @hidden
- */
-export declare type IPreloadUpdateConfig = {
-	/** {zh}
-	 * @brief 向前加载视频个数
+	 * @brief External subtitle URL.
+	 * @default -
 	 */
-	/** {en}
-	 * @brief Number of videos to load ahead.
+	url?: string;
+	/**
+	 * @hidden
+	 * @type {string}
+	 * @memberof ISubTitleItem
 	 */
-	prevCount?: number;
+	stringContent?: string;
 	/** {zh}
-	 * @brief 向后加载视频个数
+	 * @brief 字幕内容列表。非 `url` 形式时使用。
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
 	 */
 	/** {en}
-	 * @brief Number of videos to load behind.
+	 * @brief Subtitle content list when not using URL.
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
 	 */
-	nextCount?: number;
-};
+	list?: IListItem[];
+}
 /** {zh}
- * 预加载视频资源
- * @detail Options
+ * @brief 字幕内容项。
+ * @list Options
+ * @kind property
+ * @export
+ * @interface IListItem
  */
 /** {en}
- * @brief Preload video resource.
- * @detail Options
+ * @brief Subtitle content item.
+ * @list Options
+ * @kind property
+ * @export
+ * @interface IListItem
  */
-export declare type IPreloadStream = {
+export interface IListItem {
 	/** {zh}
-	 * @brief 视频 ID
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
 	 */
 	/** {en}
-	 * @brief Unique video ID.
+	 * @brief Start time in seconds.
+	 * @type {number}
 	 */
-	vid: string;
+	start: number;
 	/** {zh}
-	 * @brief 视频播放地址
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
 	 */
 	/** {en}
-	 * @brief Playback URL.
+	 * @brief End time in seconds.
+	 * @type {number}
 	 */
-	url: string;
+	end: number;
 	/** {zh}
-	 * @brief 视频清晰度
+	 * @brief 字幕数据列表。
+	 * @type {Array<ITextItem>}
 	 */
 	/** {en}
-	 * @brief Video definition (resolution).
+	 * @brief Subtitle cue data list.
+	 * @type {Array<ITextItem>}
 	 */
-	definition: string;
-	/** {zh}
-	 * @brief 视频流类型，支持 mp4、hls
+	list: Array<ITextItem>;
+	/**
+	 * @hidden
+	 * @type {any}
 	 */
-	/** {en}
-	 * @brief Stream type; supports mp4 and hls.
+	[propName: string]: any;
+}
+/** {zh}
+ * @brief 字幕文案配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Subtitle text item configuration.
+ * @list Options
+ * @kind property
+ */
+export interface ITextItem {
+	/**
+	 * @hidden
+	 * @type {any}
 	 */
-	streamType: string;
+	[propName: string]: any;
 	/** {zh}
-	 * @brief 视频编码格式，当前仅支持 mp4
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
 	 */
 	/** {en}
-	 * @brief Video codec; currently supports h264.
+	 * @brief Start time in seconds.
+	 * @type {number}
 	 */
-	codec: string;
+	start: number;
 	/** {zh}
-	 * @brief 码率, 数据统计需要，选填
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
 	 */
 	/** {en}
-	 * @brief Bitrate; optional, used for analytics.
+	 * @brief End time in seconds.
+	 * @type {number}
 	 */
-	bitrate: number;
+	end: number;
 	/** {zh}
-	 * @brief 视频时长，数据统计需要，选填
+	 * @brief 字幕文案数组。
+	 * @type {string[]}
 	 */
 	/** {en}
-	 * @brief Duration; optional, used for analytics.
+	 * @brief Subtitle text array.
+	 * @type {string[]}
 	 */
-	duration: number;
+	text: string[];
 	/** {zh}
-	 * @brief 视频大小，数据统计需要，选填
+	 * @brief 字幕顺序。
+	 * @type {number}
 	 */
 	/** {en}
-	 * @brief File size; optional, used for analytics.
+	 * @brief Subtitle display order.
+	 * @type {number}
 	 */
-	size: number;
-};
+	index?: number;
+}
 export type TLogChannel = "cn" | "va" | "sg";
 /** {zh}
  * @hidden
@@ -6148,8 +7472,8 @@ export declare type StrategyInitOptions = {
 	Module?: typeof VeStrategy;
 };
 declare class VeStrategyManager {
-	tea: Collector;
-	private static mapStrategyNameToUmdKey;
+	tea: InstanceType<CollectorConstructor> | undefined;
+	private collector;
 	teaId: number;
 	teaChannel: TLogChannel;
 	private sdkUmdLoader;
@@ -6209,6 +7533,79 @@ export interface ILicenseConfig {
 	expireDiffTime?: number;
 	expireCallback?: (expireDiffTime?: number) => void;
 }
+export declare type MediaInfoCacheType = "memory" | "localStorage";
+/** {zh}
+ * @brief 媒体信息本地缓存配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Local media info cache config.
+ * @list Options
+ * @kind property
+ */
+export interface MediaInfoCacheConfig {
+	/** {zh}
+	 * @brief 是否启用媒体信息本地缓存。默认关闭。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to enable local media info cache. Disabled by default.
+	 * @default false
+	 */
+	enable?: boolean;
+	/** {zh}
+	 * @brief 缓存方式。默认使用内存缓存，设置为 localStorage 时写入浏览器本地存储。
+	 * @default memory
+	 */
+	/** {en}
+	 * @brief Cache storage type. Memory cache is used by default. Set to localStorage to write browser local storage.
+	 * @default memory
+	 */
+	cacheType?: MediaInfoCacheType;
+	/** {zh}
+	 * @brief 缓存过期时间，单位毫秒。默认 30 分钟。
+	 * @default 1800000
+	 */
+	/** {en}
+	 * @brief Cache expiration time in milliseconds. Defaults to 30 minutes.
+	 * @default 1800000
+	 */
+	expireTime?: number;
+	/** {zh}
+	 * @brief 最多缓存的媒体信息条数，默认 100。
+	 * @default 100
+	 */
+	/** {en}
+	 * @brief Maximum number of media info entries to cache. Defaults to 100.
+	 * @default 100
+	 */
+	maxEntries?: number;
+}
+export declare type NormalizedMediaInfoCacheConfig = {
+	enable: boolean;
+	expireTime: number;
+	cacheType: MediaInfoCacheType;
+	maxEntries: number;
+};
+declare function getMediaInfoCacheConfig(): NormalizedMediaInfoCacheConfig;
+export interface DramaIdentity {
+	albumId: string | null;
+	episodeId: string | null;
+}
+export declare type PlayerPlaybackState = "creating" | "ready" | "playing" | "paused" | "buffering" | "ended" | "error" | "destroyed";
+export interface PlayerPlaybackStateSnapshot extends DramaIdentity {
+	playbackSessionId: string;
+	playbackState: PlayerPlaybackState;
+	isEnded: boolean;
+	isPaused: boolean;
+	isBeforePlayerCreate: boolean;
+	duration: number;
+	currentTime: number;
+}
+export interface IdentitySwitchTransaction {
+	readonly settled: Promise<void>;
+}
 /** {zh}
  * @hidden
  */
@@ -6229,24 +7626,51 @@ export declare type PlayerCore = Player & {
 		licenseType: LicenseEdition;
 	};
 };
-/**
+/** {zh}
  * @brief 加密混淆信息
+ * @hidden
+ */
+/** {en}
+ * @brief Encrypted obfuscation information
+ * @hidden
  */
 export interface EncryptInfo {
-	/**
+	/** {zh}
 	 * @breif 会话ID
 	 */
+	/** {en}
+	 * @brief Session ID
+	 */
 	sessionId: string;
-	/**
+	/** {zh}
 	 * @brief 混淆后的公钥
 	 */
-	drmKeK: string;
+	/** {en}
+	 * @brief Encrypted public key
+	 */
+	drmKeK: string;
+	/** {zh}
+	 * @breif 唯一身份信息
+	 */
+	/** {en}
+	 * @brief Unique identity information
+	 */
+	unionInfo: string;
+}
+declare class VePlayer {
+	/** {zh}
+	 * @brief 供 JSSDK 门面查询当前播放器播放状态。
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Returns the current player playback state for the JSSDK facade.
+	 * @hidden
+	 */
+	static getPlayerPlaybackState(): PlayerPlaybackStateSnapshot | null;
 	/**
-	 * @breif 唯一身份信息
+	 * 注册业务已打包的 UMD 模块，供所有后续创建的播放器共享使用。
 	 */
-	unionInfo: string;
-}
-declare class VePlayer {
+	static registerModules(modules: UmdModules): void;
 	/** {zh}
 	 * @brief 播放相关配置数据
 	 * @hidden
@@ -6330,6 +7754,18 @@ declare class VePlayer {
 	private _suppressAudioTrackMemoryTimer;
 	/** playNext 后置为 true，直到新视频首个 addtrack 到达前屏蔽旧视频 change 事件的干扰 */
 	private _playNextPending;
+	/**
+	 * @hidden
+	 * createPlayer 阶段耗时采集器（仅在 createPlayer 执行期间存在）
+	 */
+	_createPlayerPerf?: CreatePlayerPerfCollector;
+	/**
+	 * @hidden
+	 * 最近一次 createPlayer 性能报告
+	 */
+	private _lastCreatePlayerPerfReport?;
+	private _isCollectingCreatePlayerPerf;
+	private _getDramaInfoPerfRecords;
 	/**
 	 *
 	 *
@@ -6372,6 +7808,22 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	delayError: any[];
+	/** {zh}
+	 * @brief 设置是否为通过短剧信息或 playAuthToken 获取到的视频地址追加时间戳 query（t=Date.now()）。
+	 * @param enable true=追加时间戳，false=不追加
+	 */
+	/** {en}
+	 * @brief Set whether to append a timestamp query (t=Date.now()) to video URLs from drama info or playAuthToken.
+	 * @param enable true=append timestamp, false=do not append
+	 */
+	static setAppendVideoUrlTimestamp(enable?: boolean): void;
+	/** {zh}
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
+	static getAppendVideoUrlTimestamp(): boolean;
 	/**
 	 * @hidden
 	 * umd加载器
@@ -6387,22 +7839,113 @@ declare class VePlayer {
 	/**
 	 * @hidden
 	 */
-	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
 	/**
 	 * @hidden
 	 */
 	static veStrategy: typeof VeStrategy;
-	/**
+	/** {zh}
 	 * @brief SDK 版本
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
+	/** {en}
+	 * @brief SDK version
+	 * @type {*}
+	 * @memberof VePlayer
+	 */
 	static sdkVersion: string;
+	/**
+	 * @brief TT短剧环境配置
+	 * @type {ITTDramaEnv | null}
+	 * @memberof VePlayer
+	 */
+	static ttDramaEnv: ITTDramaEnv | null;
+	/** {zh}
+	 * @brief 设置TT短剧播放环境
+	 * @param env 短剧环境配置，详情见{@link ITTDramaEnv}
+	 */
+	static setTTDramaEnv(env: ITTDramaEnv): void;
+	/** {zh}
+	 * @brief 设置媒体信息本地缓存配置，默认关闭。开启后，通过短剧信息或 playAuthToken 获取媒体信息时优先使用缓存。
+	 * @param config 缓存配置
+	 */
+	/** {en}
+	 * @brief Set the local media info cache config. It is disabled by default. When enabled, media info from drama info or playAuthToken prefers cached data.
+	 * @param config Cache config
+	 */
+	static setMediaInfoCacheConfig(config: MediaInfoCacheConfig): void;
+	/** {zh}
+	 * @brief 获取当前媒体信息本地缓存配置。
+	 * @returns 当前媒体信息缓存配置。
+	 */
+	/** {en}
+	 * @brief Get current local media info cache config.
+	 * @returns Current media info cache config.
+	 */
+	static getMediaInfoCacheConfig(): ReturnType<typeof getMediaInfoCacheConfig>;
+	/** {zh}
+	 * @brief 清除媒体信息缓存，会同时清除内存缓存和 localStorage 缓存。
+	 */
+	/** {en}
+	 * @brief Clear media info cache from both memory cache and localStorage cache.
+	 */
+	static clearMediaInfoCache(): void;
+	/** {zh}
+	 * @brief 提前请求并缓存 playAuthToken 或短剧剧集的媒体信息，不下载视频数据。批量结果与输入顺序一致，单项失败不会中断其他项。
+	 * @list Api
+	 * @param sources 媒体信息预取源列表，详情见 {@link IMediaInfoPrefetchSource}。
+	 * @returns 每项媒体信息的成功或失败结果，详情见 {@link IMediaInfoPrefetchResult}。
+	 * @example
+	 * ``` javascript
+	 * const results = await VePlayer.prefetchMediaInfo([
+	 *   { getVideoByToken: { playAuthToken } },
+	 *   { albumId: 'album-id', episodeId: 'episode-id' }
+	 * ]);
+	 * ```
+	 */
+	/** {en}
+	 * @brief Request and cache media information for playAuthToken or short-drama episodes without downloading video data. Batch results preserve input order, and one failure does not interrupt other items.
+	 * @list Api
+	 * @param sources Media info prefetch sources. See {@link IMediaInfoPrefetchSource}.
+	 * @returns A success or failure result for each source. See {@link IMediaInfoPrefetchResult}.
+	 * @example
+	 * ``` javascript
+	 * const results = await VePlayer.prefetchMediaInfo([
+	 *   { getVideoByToken: { playAuthToken } },
+	 *   { albumId: 'album-id', episodeId: 'episode-id' }
+	 * ]);
+	 * ```
+	 */
+	static prefetchMediaInfo(sources: IMediaInfoPrefetchSource[]): Promise<IMediaInfoPrefetchResult[]>;
+	/** {zh}
+	 * @brief 设置全局日志开关。开启后会输出 VE_DEBUG.log 级别日志。
+	 * @param enable 是否开启详细日志
+	 */
+	/** {en}
+	 * @brief Set the global log switch. When enabled, VE_DEBUG.log level logs are printed.
+	 * @param enable Whether to enable verbose logs
+	 */
+	static setDebug(enable: boolean): void;
+	/** {zh}
+	 * @brief 设置可选的 Tea Collector 构造函数。传入 undefined 可清除后续实例的注册。
+	 * @param Collector Tea Collector 构造函数
+	 */
+	/** {en}
+	 * @brief Set the optional Tea Collector constructor. Pass undefined to clear it for subsequent instances.
+	 * @param Collector Tea Collector constructor
+	 */
+	static setCollector(Collector?: CollectorConstructor): void;
+	/** @hidden 短剧 Minis 环境与 Lite 构建均不执行 License 校验。 */
+	private static shouldCheckLicense;
 	/**
 	 * @hidden
 	 */
 	private veErrorIns;
 	private vodLogCommon;
+	private _publicPlayNextOperation;
+	private _sourceSwitchAborters?;
+	private _lifecycleGeneration;
+	private _playerRebuildListener?;
 	/** {zh}
 	 * @brief 播放策略预初始化配置
 	 * @param options 初始化配置，详情见{@link StrategyInitOptions}
@@ -6447,7 +7990,7 @@ declare class VePlayer {
 	/** {en}
 	 * @brief Add videos to the preload list.
 	 */
-	static addPreloadList(list: IPreloadStream[]): void;
+	static addPreloadList(list: IPreloadStream[]): Promise<void>;
 	/** {zh}
 	 * @brief 设置待预加载视频列表，替换当前已设置的待预加载列表
 	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}
@@ -6468,9 +8011,7 @@ declare class VePlayer {
 	 * @param codec
 	 * @param options
 	 */
-	static isRTMSupportCodec: (codec: RTMCodec, options: {
-		targetProfileLevel?: string;
-	}) => Promise<boolean>;
+	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
 	static setLicenseConfig(config: ILicenseConfig): Promise<void>;
 	static checkLicense(): Promise<LicenseEdition>;
 	static checkModuleList(): Promise<string[]>;
@@ -6505,6 +8046,8 @@ declare class VePlayer {
 	 * @brief Constructor.
 	 */
 	constructor(configs: IPlayerConfig);
+	/** @hidden */
+	assertLiteConfig(config?: Partial<IPlayerConfig>): void;
 	/**
 	 *
 	 * @hidden
@@ -6646,7 +8189,8 @@ declare class VePlayer {
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
-	createPlayer: () => Promise<PlayerCore>;
+	createPlayer: (transaction?: IdentitySwitchTransaction) => Promise<any>;
+	private _createPlayer;
 	private checkLicenseCallback;
 	/** {zh}
 	 * @hidden
@@ -6723,6 +8267,28 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	beforePlayerCreate(): Promise<void>;
+	/** {zh}
+	 * @hidden
+	 * @brief 获取最近一次 createPlayer 的性能报告。
+	 */
+	/** {en}
+	 * @hidden
+	 * @brief Get the perf report of the latest createPlayer.
+	 */
+	getCreatePlayerPerfReport(): ICreatePlayerPerfReport;
+	/**
+	 * @brief 记录一次 JSB getDramaInfo 返回的客户端耗时信息。
+	 */
+	recordGetDramaInfoPerf(payload: IGetDramaInfoPerfCallbackPayload): void;
+	/**
+	 * @brief 获取当前播放器实例记录到的 getDramaInfo 客户端耗时列表。
+	 */
+	getDramaInfoPerfRecords(): IGetDramaInfoPerfCallbackPayload[];
+	/**
+	 * @brief 获取最近一次 getDramaInfo 客户端耗时。
+	 */
+	getLastDramaInfoPerf(): IGetDramaInfoPerfCallbackPayload | undefined;
+	private _markGetDramaInfoClientPerf;
 	private prepareStrategies;
 	/**
 	 * @hidden
@@ -6768,7 +8334,10 @@ declare class VePlayer {
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
+	private _onPlayerRebuild;
+	private _getPlayerRebuildListener;
 	private _bindPlayerEvents;
+	private _onMp4PreloadInfo;
 	private _proxyError;
 	private _onError;
 	/** {zh}
@@ -6778,10 +8347,14 @@ declare class VePlayer {
 	 * @private
 	 */
 	private _onMediaExpiredAction;
-	/**
+	/** {zh}
 	 * @brief 更新播放源。您可在视频播放地址过期前调用此方法更新地址及过期时间戳。
 	 * @param source 播放源配置。详见 [SourceConfig](1248901#sourceconfig)。支持传入视频播放地址 `url`、播放列表 `playList` 或者 `vid` 和 `playAuthToken`，还需包含新地址的过期时间戳 `urlExpireTimestamp`。
 	 */
+	/** {en}
+	 * @brief Update the media source. You can call this method to update the address and expiration timestamp before the video playback address expires.
+	 * @param source The media source configuration. See SourceConfig. Supports passing video playback address `url`, playback list `playList`, or `vid` and `playAuthToken`, and also includes the expiration timestamp `urlExpireTimestamp` of the new address.
+	 */
 	updateMediaSource(source: SourceConfig): Promise<void>;
 	/** {zh}
 	 * @hidden
@@ -6879,6 +8452,8 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	switchAuthToken(config: IPlayAuthTokenConfig, isNewVideo?: boolean): Promise<void>;
+	private _switchAuthToken;
+	private _performAuthTokenSwitch;
 	/** {zh}
 	 * @brief 更新临时播放 Token。
 	 * @memberof VePlayer
@@ -6936,13 +8511,14 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	next(config: IPlayerConfig, isNewVideo?: boolean): Promise<void>;
+	private _next;
 	/** {zh}
 	 * @brief 播放下一视频。
 	 * @return{Promise<any>}
 	 * @memberof VePlayer
 	 * @notes - 成功更换视频源后，默认是暂停状态。如果设置了自动播放，则会自动播放。
 	 *        - 此接口不支持切换火山引擎私有加密视频。
-	 * @param config 播放器实例化配置。此接口仅支持 `IPlayerConfig` 中的 `url`、`playList`、`poster`、`getVideoByToken` 字段。。
+	 * @param config 播放器实例化配置
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	/** {en}
@@ -6951,7 +8527,25 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
+	private _createPlayNextInProgressError;
+	private _registerSourceSwitchAborter;
+	private _abortSourceSwitches;
+	private _runDestroyableSourceSwitch;
+	private _createDestroyedPlaybackSwitchError;
+	private _isDestroyedPlaybackSwitchError;
+	private _isStaleLifecycleGeneration;
+	private _cancelStalePlayerCreation;
+	private _discardStalePlayer;
+	private updatePlayNextSubtitleConfig;
 	private _playNext;
+	private _applyIncomingIdentityAliases;
+	private _createDramaPlayNextCandidateConfig;
+	/** 从 playerData.configs 取出短剧 id，供 XGPlayer setConfig / playNext 与切换后 configs 一致 */
+	private _getDramaConfigPatchForPlayer;
+	private _buildDramaInvalidParamError;
+	private _getDramaAlbumIdFromConfig;
+	private _getDramaEpisodeIdFromConfig;
+	private switchDramaEpisode;
 	/** {zh}
 	 * @brief 销毁xgplayer实例
 	 *
@@ -7032,6 +8626,8 @@ declare class VePlayer {
 	 * @notes 每项包含 `id`、`name`、`lang`、`channels`、`default`、`selected` 字段；轨道数量 ≤ 1 时返回空数组。
 	 */
 	/** {en}
+	 * @brief Get the audio track list. For HLS, tracks come from hls.js; on iOS native playback, from `HTMLMediaElement.audioTracks`.
+	 * @notes Each item includes `id`, `name`, `lang`, `channels`, `default`, and `selected`. Returns an empty array when there is at most one track.
 	 */
 	getAudioTracks(): AudioTrackInfo[];
 	/** {zh}
@@ -7039,18 +8635,20 @@ declare class VePlayer {
 	 * @notes HLS 流通过 hls.js 获取，iOS 原生播放通过 HTMLMediaElement.audioTracks 获取；无激活轨道时返回 null。
 	 */
 	/** {en}
+	 * @brief Get the currently active audio track.
+	 * @notes For HLS, from hls.js; on iOS native playback, from `HTMLMediaElement.audioTracks`. Returns `null` when no track is active.
 	 */
 	getCurrentAudioTrack(): AudioTrackInfo | null;
 	/** {zh}
 	 * @brief 切换音频轨道。
-	 * @param id 目标轨道的 id，可通过 `getAudioTracks()` 获取。
-	 * @param lang 目标轨道的语言代码（BCP-47）。若提供，则 id 与 lang 同时匹配时才执行切换，
-	 *             可用于 iOS 原生 audioTracks 中存在重复 id 的场景。
+	 * @param track 目标音轨对象，可通过 `getAudioTracks()` 获取。
 	 * @notes 切换完成后会触发 `Events.AUDIO_TRACK_CHANGE` 事件；
 	 *        同时 PC 端和移动端音频轨道插件的选中状态会自动更新。
 	 */
 	/** {en}
 	 * @brief Switch audio track.
+	 * @param track Target audio track object from `getAudioTracks()`.
+	 * @notes Emits `Events.AUDIO_TRACK_CHANGE` when done. PC and mobile audio track plugins update selection automatically.
 	 */
 	switchAudioTrack(track: AudioTrackInfo): void;
 	/** {zh}
@@ -7298,8 +8896,41 @@ declare class VePlayer {
 	 */
 	getPlugin(pluginName: string): null | BasePlugin;
 	/** {zh}
+	 * @brief 获取字幕列表。需配置 `Subtitle` 插件后调用。
+	 * @return 当前字幕列表，每项包含 `id`、`language`、`text`（显示名称）等字段。列表为空时返回空数组。
 	 * @memberof VePlayer
+	 */
+	getSubtitleList(): ISubTitleItem[];
+	/** {zh}
+	 * @brief 切换字幕。需配置 `Subtitle` 插件后调用。
+	 * @param subtitle 目标字幕的 id 或 language，任意一个非空即可定位字幕项。
+	 * @return 切换成功时 resolve，失败（未找到、切换被中止）时 reject。
+	 * @memberof VePlayer
+	 */
+	switchSubtitle(subtitle: {
+		id?: string | number;
+		language?: string | number;
+	}): Promise<void>;
+	/** {zh}
+	 * @brief 开启字幕展示。恢复上次选中的字幕项；若从未选中过则默认选第一项。需配置 `Subtitle` 插件后调用。
+	 * @memberof VePlayer
+	 */
+	showSubtitle(): void;
+	/** {zh}
+	 * @brief 关闭字幕展示。字幕数据保留，可通过 `showSubtitle` 重新开启。需配置 `Subtitle` 插件后调用。
+	 * @memberof VePlayer
+	 */
+	hideSubtitle(): void;
+	/** {zh}
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
+	private _teardown;
+	/** {zh}
 	 * @brief 销毁当前播放器实例。
+	 * @memberof VePlayer
 	 */
 	/** {en}
 	 * @brief Destroy the current player instance.
@@ -7721,344 +9352,242 @@ export declare class MirrorPlugin extends Plugin {
 	destroy(): void;
 	render(): string;
 }
-export declare type InfoItem = {
-	key: string;
-	label: string;
-	labelTextKey?: string;
-	value?: any;
-	render?: (key: any) => string;
-	type?: string;
-	dom?: Element;
-};
-/**
- * 直播信息面板
- */
-export declare class LiveInfoPanel extends Plugin {
-	private _pollTimer;
-	private _infoItems;
-	static get pluginName(): string;
-	static get defaultConfig(): {
-		visible: boolean;
-		showH265Info: boolean;
-	};
-	get streamType(): any;
-	afterCreate(): void;
-	registerLanguageTexts(): {
-		DECODEFPS: {
-			en: string;
-			zh: string;
-		};
-		DECODECOST: {
-			en: string;
-			zh: string;
-		};
-		FORMAT: {
-			en: string;
-			zh: string;
-		};
-		FPS: {
-			en: string;
-			zh: string;
-		};
-		BITRATE: {
-			en: string;
-			zh: string;
-		};
-		GOP: {
-			en: string;
-			zh: string;
-		};
-		RESOLUTION: {
-			en: string;
-			zh: string;
-		};
-		ENCODETYPE: {
-			en: string;
-			zh: string;
-		};
-		BUFFEREND: {
-			en: string;
-			zh: string;
-		};
-		CURRENTTIME: {
-			en: string;
-			zh: string;
-		};
-	};
-	_getDefaultInfo(data: any): Record<string, InfoItem>;
-	_init(): void;
-	_getStats(): any;
-	_getInfoListData(): Record<string, InfoItem>;
-	_initDom(infoItems: any): any;
-	_updateTitle(rowDom: Element, item: InfoItem): void;
-	_updateDom(rowdom: Element, newItem: InfoItem): void;
-	_renderLabel(item: InfoItem): any;
-	_renderValue(item: InfoItem): any;
-	_handleDataChange(): void;
-	_tick(): void;
-	_poll(): void;
-	destroy(): void;
-	_handleError(): void;
-	_handleLoadedData(): void;
-	_open(): void;
-	_close(): void;
-	open(): void;
-	close(): void;
-	render(): string;
-}
 export declare const Events: {
 	/** {zh}
-	 * @brief 弹幕配置发生变化。
-	 */
-	/** {en}
-	 * @brief Triggered when danmu (bullet comment) configuration changes.
-	 */
-	DANMU_CHANGE: string;
-	/** {zh}
-	 * @hidden
-	 */
-	/** {en}
-	 * @hidden
-	 */
-	TIME_SHIFT_CHANGE: string;
-	/** {zh}
-	 * @hidden
-	 */
-	/** {en}
-	 * @hidden
-	 */
-	AI_SUBTITLE_LANG_CHANGE: string;
-	/** {zh}
-	 * @hidden
+	 * @brief 自动播放成功。
 	 */
 	/** {en}
-	 * @hidden
+	 * @brief Triggered when autoplay succeeds.
 	 */
-	AI_SUBTITLE_MATCH: string;
+	AUTOPLAY_SUCCESS: string;
 	/** {zh}
-	 * @brief 取消静音。
+	 * @brief 自动播放失败。
 	 */
 	/** {en}
-	 * @brief Triggered when unmute is cancelled.
+	 * @brief Triggered when autoplay fails.
 	 */
-	CANCEL_UNMUTE: string;
+	AUTOPLAY_FAILED: string;
 	/** {zh}
-	 * @brief 刷新按钮被点击。
+	 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
 	 */
 	/** {en}
-	 * @brief Triggered when the refresh button is clicked.
+	 * @brief Triggered for context menu actions. Event `data` contains details.
 	 */
-	REFRESH_CLICK: string;
+	MENU_LOG: string;
 	/** {zh}
-	 * @brief 报错时触发降级。
+	 * @brief 点击了右键菜单的反馈按钮。
 	 */
 	/** {en}
-	 * @brief Triggered when playback demotes to a backup URL after an error.
+	 * @brief Triggered when the context menu feedback button is clicked.
 	 */
-	PLAY_BACKUP_CHANGE: string;
+	MENU_REPORT: string;
 	/** {zh}
-	 * @brief 报错时触发的降级结束。
+	 * @brief 播放列表更新。
 	 */
 	/** {en}
-	 * @brief Triggered when error-triggered demotion finishes.
+	 * @brief Triggered when the playlist is updated.
 	 */
-	PLAY_BACKUP_CHANGE_FINISH: string;
+	PLAY_LIST_CHANGE: string;
 	/** {zh}
-	 * @brief 报错时触发重试。
+	 * @brief 播放列表播放项变更。
 	 */
 	/** {en}
-	 * @brief Triggered when the error retry button is clicked.
+	 * @brief Triggered when the current playlist item changes.
 	 */
-	PLAY_ERROR_BUTTON_CLICK: string;
+	PLAY_LIST_ITEM_CHANGE: string;
 	/** {zh}
-	 * @brief 播放 URL 改变。
+	 * @brief `playNext` 开始。
 	 */
 	/** {en}
-	 * @brief Triggered when the playback URL changes.
+	 * @brief Triggered when `playNext` starts.
 	 */
-	PlAY_URL_CHANGE: string;
+	PLAY_NEXT_START: string;
 	/** {zh}
-	 * @brief 展示报错。
+	 * @brief `playNext` 结束。
 	 */
 	/** {en}
-	 * @brief Triggered when the error UI is shown.
+	 * @brief Triggered when `playNext` ends.
 	 */
-	SHOW_PLAY_ERROR: string;
+	PLAY_NEXT_END: string;
 	/** {zh}
-	 * @hidden
+	 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 	 */
 	/** {en}
-	 * @hidden
+	 * @brief Triggered when the actual definition behind the auto ABR level changes.
 	 */
-	PLAYER_EXTEND_BUTTON: string;
+	ABR_AUTO_DESC_CHANGE: string;
 	/** {zh}
-	 * @brief 发生长时间卡顿时触发。播放器会在事件发生时自动进行清晰度降级或提醒用户手动切换晰度降级。
+	 * @brief 播放插件内核的扩展事件
 	 */
 	/** {en}
-	 * @brief Triggered on prolonged stalling. The player may auto-demote definition or prompt the user to switch manually.
+	 * @brief Extension events from the playback plugin core.
 	 */
-	LONG_WAITING: string;
+	CORE_EVENT: string;
 	/** {zh}
-	 * @brief 发生频繁卡顿时触发。
+	 * @brief mp4 加密插件命中预加载数据时触发。data 为预加载缓存对象，含 `byteLength`、`duration`、`mediaSegList` 等字段。
 	 */
 	/** {en}
-	 * @brief Triggered on frequent stalling.
+	 * @brief Fired when the mp4 encrypt plugin finds a preload cache hit. The event data is the preload cache object, including fields such as `byteLength`, `duration`, and `mediaSegList`.
 	 */
-	OFTEN_WAITING: string;
+	PRELOAD_INFO: string;
+	TIME_SCALE_CHANGE?: string;
+	MUSIC_MODE_CHANGE?: string;
+	MUSIC_CHANGE?: string;
+	MUSIC_LIST_CHANGE?: string;
 	/** {zh}
-	 * @brief 清晰度降级。
+	 * @brief 弹幕配置发生变化。
 	 */
 	/** {en}
-	 * @brief Triggered when definition is demoted.
+	 * @brief Triggered when danmu (bullet comment) configuration changes.
 	 */
-	DEFINITION_DEMOTE: string;
+	DANMU_CHANGE: string;
 	/** {zh}
 	 * @hidden
 	 */
 	/** {en}
 	 * @hidden
 	 */
-	LARKWINDOW_CHANGE: string;
+	TIME_SHIFT_CHANGE: string;
 	/** {zh}
 	 * @hidden
 	 */
 	/** {en}
 	 * @hidden
 	 */
-	PANEL_MODE_CHANGE: string;
+	AI_SUBTITLE_LANG_CHANGE: string;
 	/** {zh}
-	 * @brief 清晰度切换。
+	 * @hidden
 	 */
 	/** {en}
-	 * @brief Triggered when definition changes.
+	 * @hidden
 	 */
-	INNER_DEFINITION_CHANGE: string;
+	AI_SUBTITLE_MATCH: string;
 	/** {zh}
-	 * @brief 线路切换。
+	 * @brief 取消静音。
 	 */
 	/** {en}
-	 * @brief Triggered when the CDN line (route) changes.
+	 * @brief Triggered when unmute is cancelled.
 	 */
-	LINE_CHANGE: string;
+	CANCEL_UNMUTE: string;
 	/** {zh}
-	 * @brief 播放器通过 `playAuthToken` 获取 URL 失败。
+	 * @brief 刷新按钮被点击。
 	 */
 	/** {en}
-	 * @brief Triggered when fetching the URL via `playAuthToken` fails.
+	 * @brief Triggered when the refresh button is clicked.
 	 */
-	GET_PLAY_URL_ERR: string;
+	REFRESH_CLICK: string;
 	/** {zh}
-	 * @brief 资源过期。
+	 * @brief 报错时触发降级。
 	 */
 	/** {en}
-	 * @brief Triggered when the media resource has expired.
+	 * @brief Triggered when playback demotes to a backup URL after an error.
 	 */
-	MEDIA_EXPIRED: string;
+	PLAY_BACKUP_CHANGE: string;
 	/** {zh}
-	 * @brief 镜像开启。
+	 * @brief 报错时触发的降级结束。
 	 */
 	/** {en}
-	 * @brief Triggered when mirror mode is enabled.
+	 * @brief Triggered when error-triggered demotion finishes.
 	 */
-	MIRROR_CHANGE: string;
+	PLAY_BACKUP_CHANGE_FINISH: string;
 	/** {zh}
-	 * @brief 音乐播放器快进或快退。
+	 * @brief 报错时触发重试。
 	 */
 	/** {en}
-	 * @brief Triggered when music playback seeks forward or backward.
+	 * @brief Triggered when the error retry button is clicked.
 	 */
-	TIME_SCALE_CHANGE: string;
+	PLAY_ERROR_BUTTON_CLICK: string;
 	/** {zh}
-	 * @brief 音乐播放模式切换。
+	 * @brief 播放 URL 改变。
 	 */
 	/** {en}
-	 * @brief Triggered when music play mode changes.
+	 * @brief Triggered when the playback URL changes.
 	 */
-	MUSIC_MODE_CHANGE: string;
+	PlAY_URL_CHANGE: string;
 	/** {zh}
-	 * @brief 音乐播放模式下切换音乐。
+	 * @brief 展示报错。
 	 */
 	/** {en}
-	 * @brief Triggered when switching tracks in music mode.
+	 * @brief Triggered when the error UI is shown.
 	 */
-	MUSIC_CHANGE: string;
+	SHOW_PLAY_ERROR: string;
 	/** {zh}
-	 * @brief 音乐播放列表发生变化。
+	 * @hidden
 	 */
 	/** {en}
-	 * @brief Triggered when the music playlist changes.
+	 * @hidden
 	 */
-	MUSIC_LIST_CHANGE: string;
+	PLAYER_EXTEND_BUTTON: string;
 	/** {zh}
-	 * @brief 自动播放成功。
+	 * @brief 发生长时间卡顿时触发。播放器会在事件发生时自动进行清晰度降级或提醒用户手动切换晰度降级。
 	 */
 	/** {en}
-	 * @brief Triggered when autoplay succeeds.
+	 * @brief Triggered on prolonged stalling. The player may auto-demote definition or prompt the user to switch manually.
 	 */
-	AUTOPLAY_SUCCESS: string;
+	LONG_WAITING: string;
 	/** {zh}
-	 * @brief 自动播放失败。
+	 * @brief 发生频繁卡顿时触发。
 	 */
 	/** {en}
-	 * @brief Triggered when autoplay fails.
+	 * @brief Triggered on frequent stalling.
 	 */
-	AUTOPLAY_FAILED: string;
+	OFTEN_WAITING: string;
 	/** {zh}
-	 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
+	 * @brief 清晰度降级。
 	 */
 	/** {en}
-	 * @brief Triggered for context menu actions. Event `data` contains details.
+	 * @brief Triggered when definition is demoted.
 	 */
-	MENU_LOG: string;
+	DEFINITION_DEMOTE: string;
 	/** {zh}
-	 * @brief 点击了右键菜单的反馈按钮。
+	 * @hidden
 	 */
 	/** {en}
-	 * @brief Triggered when the context menu feedback button is clicked.
+	 * @hidden
 	 */
-	MENU_REPORT: string;
+	LARKWINDOW_CHANGE: string;
 	/** {zh}
-	 * @brief 播放列表更新。
+	 * @hidden
 	 */
 	/** {en}
-	 * @brief Triggered when the playlist is updated.
+	 * @hidden
 	 */
-	PLAY_LIST_CHANGE: string;
+	PANEL_MODE_CHANGE: string;
 	/** {zh}
-	 * @brief 播放列表播放项变更。
+	 * @brief 清晰度切换。
 	 */
 	/** {en}
-	 * @brief Triggered when the current playlist item changes.
+	 * @brief Triggered when definition changes.
 	 */
-	PLAY_LIST_ITEM_CHANGE: string;
+	INNER_DEFINITION_CHANGE: string;
 	/** {zh}
-	 * @brief `playNext` 开始。
+	 * @brief 线路切换。
 	 */
 	/** {en}
-	 * @brief Triggered when `playNext` starts.
+	 * @brief Triggered when the CDN line (route) changes.
 	 */
-	PLAY_NEXT_START: string;
+	LINE_CHANGE: string;
 	/** {zh}
-	 * @brief `playNext` 结束。
+	 * @brief 播放器通过 `playAuthToken` 获取 URL 失败。
 	 */
 	/** {en}
-	 * @brief Triggered when `playNext` ends.
+	 * @brief Triggered when fetching the URL via `playAuthToken` fails.
 	 */
-	PLAY_NEXT_END: string;
+	GET_PLAY_URL_ERR: string;
 	/** {zh}
-	 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
+	 * @brief 资源过期。
 	 */
 	/** {en}
-	 * @brief Triggered when the actual definition behind the auto ABR level changes.
+	 * @brief Triggered when the media resource has expired.
 	 */
-	ABR_AUTO_DESC_CHANGE: string;
+	MEDIA_EXPIRED: string;
 	/** {zh}
-	 * @brief 播放插件内核的扩展事件
+	 * @brief 镜像开启。
 	 */
 	/** {en}
-	 * @brief Extension events from the playback plugin core.
+	 * @brief Triggered when mirror mode is enabled.
 	 */
-	CORE_EVENT: string;
+	MIRROR_CHANGE: string;
 	/** {zh}
 	 * @brief 播放器实例创建完成时触发。
 	 */
@@ -8215,6 +9744,10 @@ export declare const Events: {
 	 * @brief Triggered when autoplay fails.
 	 */
 	AUTOPLAY_PREVENTED: string;
+	/** {zh}
+	 * @brief 播放器准备创建。
+	 */
+	READY_CREATE_PLAYER: string;
 	/** {zh}
 	 * @brief 播放器完成创建。
 	 */
@@ -8222,6 +9755,13 @@ export declare const Events: {
 	 * @brief Triggered when player creation completes.
 	 */
 	PLAYER_CREATED_FINISH: string;
+	/** {zh}
+	 * @brief createPlayer 性能报告。与 `PLAYER_CREATED_FINISH` 几乎同时触发（略早）。
+	 */
+	/** {en}
+	 * @brief createPlayer performance report. Fired almost at the same time as `PLAYER_CREATED_FINISH` (slightly earlier).
+	 */
+	CREATE_PLAYER_PERF: string;
 	/** {zh}
 	 * @brief 播放器重建。
 	 */
@@ -8649,6 +10189,10 @@ export declare const Event: {
 		 * @brief Triggered when autoplay fails.
 		 */
 		AUTOPLAY_PREVENTED: string;
+		/** {zh}
+		 * @brief 播放器准备创建。
+		 */
+		READY_CREATE_PLAYER: string;
 		/** {zh}
 		 * @brief 播放器完成创建。
 		 */
@@ -8656,6 +10200,13 @@ export declare const Event: {
 		 * @brief Triggered when player creation completes.
 		 */
 		PLAYER_CREATED_FINISH: string;
+		/** {zh}
+		 * @brief createPlayer 性能报告。与 `PLAYER_CREATED_FINISH` 几乎同时触发（略早）。
+		 */
+		/** {en}
+		 * @brief createPlayer performance report. Fired almost at the same time as `PLAYER_CREATED_FINISH` (slightly earlier).
+		 */
+		CREATE_PLAYER_PERF: string;
 		/** {zh}
 		 * @brief 播放器重建。
 		 */
@@ -8763,6 +10314,87 @@ export declare const Event: {
 		AUDIO_TRACK_CHANGE: string;
 	};
 	PluginEvents: {
+		/** {zh}
+		 * @brief 自动播放成功。
+		 */
+		/** {en}
+		 * @brief Triggered when autoplay succeeds.
+		 */
+		AUTOPLAY_SUCCESS: string;
+		/** {zh}
+		 * @brief 自动播放失败。
+		 */
+		/** {en}
+		 * @brief Triggered when autoplay fails.
+		 */
+		AUTOPLAY_FAILED: string;
+		/** {zh}
+		 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
+		 */
+		/** {en}
+		 * @brief Triggered for context menu actions. Event `data` contains details.
+		 */
+		MENU_LOG: string;
+		/** {zh}
+		 * @brief 点击了右键菜单的反馈按钮。
+		 */
+		/** {en}
+		 * @brief Triggered when the context menu feedback button is clicked.
+		 */
+		MENU_REPORT: string;
+		/** {zh}
+		 * @brief 播放列表更新。
+		 */
+		/** {en}
+		 * @brief Triggered when the playlist is updated.
+		 */
+		PLAY_LIST_CHANGE: string;
+		/** {zh}
+		 * @brief 播放列表播放项变更。
+		 */
+		/** {en}
+		 * @brief Triggered when the current playlist item changes.
+		 */
+		PLAY_LIST_ITEM_CHANGE: string;
+		/** {zh}
+		 * @brief `playNext` 开始。
+		 */
+		/** {en}
+		 * @brief Triggered when `playNext` starts.
+		 */
+		PLAY_NEXT_START: string;
+		/** {zh}
+		 * @brief `playNext` 结束。
+		 */
+		/** {en}
+		 * @brief Triggered when `playNext` ends.
+		 */
+		PLAY_NEXT_END: string;
+		/** {zh}
+		 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
+		 */
+		/** {en}
+		 * @brief Triggered when the actual definition behind the auto ABR level changes.
+		 */
+		ABR_AUTO_DESC_CHANGE: string;
+		/** {zh}
+		 * @brief 播放插件内核的扩展事件
+		 */
+		/** {en}
+		 * @brief Extension events from the playback plugin core.
+		 */
+		CORE_EVENT: string;
+		/** {zh}
+		 * @brief mp4 加密插件命中预加载数据时触发。data 为预加载缓存对象，含 `byteLength`、`duration`、`mediaSegList` 等字段。
+		 */
+		/** {en}
+		 * @brief Fired when the mp4 encrypt plugin finds a preload cache hit. The event data is the preload cache object, including fields such as `byteLength`, `duration`, and `mediaSegList`.
+		 */
+		PRELOAD_INFO: string;
+		TIME_SCALE_CHANGE?: string;
+		MUSIC_MODE_CHANGE?: string;
+		MUSIC_CHANGE?: string;
+		MUSIC_LIST_CHANGE?: string;
 		/** {zh}
 		 * @brief 弹幕配置发生变化。
 		 */
@@ -8917,110 +10549,11 @@ export declare const Event: {
 		 * @brief Triggered when mirror mode is enabled.
 		 */
 		MIRROR_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放器快进或快退。
-		 */
-		/** {en}
-		 * @brief Triggered when music playback seeks forward or backward.
-		 */
-		TIME_SCALE_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放模式切换。
-		 */
-		/** {en}
-		 * @brief Triggered when music play mode changes.
-		 */
-		MUSIC_MODE_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放模式下切换音乐。
-		 */
-		/** {en}
-		 * @brief Triggered when switching tracks in music mode.
-		 */
-		MUSIC_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放列表发生变化。
-		 */
-		/** {en}
-		 * @brief Triggered when the music playlist changes.
-		 */
-		MUSIC_LIST_CHANGE: string;
-		/** {zh}
-		 * @brief 自动播放成功。
-		 */
-		/** {en}
-		 * @brief Triggered when autoplay succeeds.
-		 */
-		AUTOPLAY_SUCCESS: string;
-		/** {zh}
-		 * @brief 自动播放失败。
-		 */
-		/** {en}
-		 * @brief Triggered when autoplay fails.
-		 */
-		AUTOPLAY_FAILED: string;
-		/** {zh}
-		 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
-		 */
-		/** {en}
-		 * @brief Triggered for context menu actions. Event `data` contains details.
-		 */
-		MENU_LOG: string;
-		/** {zh}
-		 * @brief 点击了右键菜单的反馈按钮。
-		 */
-		/** {en}
-		 * @brief Triggered when the context menu feedback button is clicked.
-		 */
-		MENU_REPORT: string;
-		/** {zh}
-		 * @brief 播放列表更新。
-		 */
-		/** {en}
-		 * @brief Triggered when the playlist is updated.
-		 */
-		PLAY_LIST_CHANGE: string;
-		/** {zh}
-		 * @brief 播放列表播放项变更。
-		 */
-		/** {en}
-		 * @brief Triggered when the current playlist item changes.
-		 */
-		PLAY_LIST_ITEM_CHANGE: string;
-		/** {zh}
-		 * @brief `playNext` 开始。
-		 */
-		/** {en}
-		 * @brief Triggered when `playNext` starts.
-		 */
-		PLAY_NEXT_START: string;
-		/** {zh}
-		 * @brief `playNext` 结束。
-		 */
-		/** {en}
-		 * @brief Triggered when `playNext` ends.
-		 */
-		PLAY_NEXT_END: string;
-		/** {zh}
-		 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
-		 */
-		/** {en}
-		 * @brief Triggered when the actual definition behind the auto ABR level changes.
-		 */
-		ABR_AUTO_DESC_CHANGE: string;
-		/** {zh}
-		 * @brief 播放插件内核的扩展事件
-		 */
-		/** {en}
-		 * @brief Extension events from the playback plugin core.
-		 */
-		CORE_EVENT: string;
 	};
 };
 export * from "xgplayer";
 
 export {
-	LiveSubTitlesPlugin as LiveSubtitlesPlugin,
 	MusicPreset as Music,
 	VePlayer as default,
 };