@byteplus/veplayer 1.18.0-rc.4 → 1.18.0-rc.6

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
@@ -3052,6 +3075,7 @@ export interface ISubtitleInfoList {
 	Version: string;
 	Vid: string;
 }
+export declare type ISubtitleInfoListItem = ISubtitleInfoList | string;
 /** {zh}
  * @hidden
  */
@@ -3126,11 +3150,102 @@ 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;
+	/**
+	 * @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;
+}
+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 视频编码格式。
@@ -3775,6 +3890,86 @@ export declare type Url = string | Array<{
 	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}
  * @list Options
  * @kind property
@@ -3838,6 +4033,14 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 */
 	vid?: string;
+	/**
+	 * @brief 剧id,Minis 短剧播放需要
+	 */
+	albumId?: string;
+	/**
+	 * @brief 剧集id，Minis 短剧播放需要
+	 */
+	episodeId?: string;
 	/** {zh}
 	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时临时播放 Token，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
@@ -3847,6 +4050,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 -
@@ -4724,6 +4955,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
@@ -5891,7 +6131,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",
@@ -5910,11 +6151,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下暴露的接口名称
 	 */
@@ -5931,10 +6174,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;
@@ -6036,6 +6289,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;
@@ -6057,14 +6433,51 @@ declare class AuthToken extends SdkPlugin {
 		codec: ICodecType;
 		defaultDefinition: string;
 	}>;
+	/**
+	 * 短剧 Minis 环境：通过 JSB getDramaInfo 获取媒体信息
+	 */
+	getDramaInfoViaJSB(): 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(): 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;
-	/** {zh}
+	/**
+	 * 剧集切换：configs 已由 player 更新 album_id/episode_id，重新拉取媒体信息
+	 */
+	updateDramaEpisode(isNewVideo: boolean): Promise<void>;
+	/**
 	 * @description 更新playAuthToken
 	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
 	 * @param {boolean} isNewVideo 是否新视频，即是否为切换视频
@@ -6186,9 +6599,7 @@ declare class PlayerData {
 	 * @brief 私有加密会话id
 	 */
 	encryptSessionId?: string;
-	constructor(configs: IPlayerConfig & {
-		licensSupportModuleList: string[];
-	}, sdk: VePlayer);
+	constructor(configs: IPlayerConfig, sdk: VePlayer);
 	/**
 	 * 初始化播放数据
 	 * @param configs { IPlayerConfig } 播放器配置
@@ -6455,7 +6866,7 @@ export declare type IPreloadUpdateConfig = {
  * @brief Preload video resource.
  * @detail Options
  */
-export declare type IPreloadStream = {
+export declare type IPreloadResolvedStream = {
 	/** {zh}
 	 * @brief 视频 ID
 	 */
@@ -6513,92 +6924,291 @@ export declare type IPreloadStream = {
 	 */
 	size: number;
 };
-export type TLogChannel = "cn" | "va" | "sg";
+export declare type IPreloadDramaStream = {
+	vid?: string;
+	albumId: string;
+	episodeId: string;
+	defaultDefinition?: string;
+	getVideoByToken?: IPlayAuthTokenConfig;
+};
+export declare type IPreloadAuthTokenStream = {
+	vid?: string;
+	defaultDefinition?: string;
+	getVideoByToken: IPlayAuthTokenConfig;
+};
+export declare type IPreloadStream = IPreloadResolvedStream | IPreloadDramaStream | IPreloadAuthTokenStream;
 /** {zh}
- * @hidden
- * h265策略配置
- * @detail Options
+ * @list Options
+ * @brief 字幕项。
+ * @kind property
  */
 /** {en}
- * @hidden
- * @brief H.265 strategy configuration.
- * @detail Options
+ * @list Options
+ * @brief Subtitle item.
+ * @kind property
  */
-export declare type IH265Config = {
+export interface ISubTitleItem {
 	/** {zh}
-	 * @brief h265策略依赖Module
+	 * @brief 字幕语言。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief H.265 strategy dependency module.
+	 * @brief Subtitle language.
+	 * @default -
 	 */
-	Strategy?: any;
+	language?: string | number;
 	/** {zh}
-	 * @brief 是否禁用265策略
+	 * @brief 字幕 ID。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Whether to disable the H.265 strategy.
+	 * @brief Subtitle ID.
+	 * @default -
 	 */
-	disabled?: boolean;
-} & VeStrategyH265Config;
-/** {zh}
- * 预加载初始配置
- * @detail Options
- */
-/** {en}
- * @brief Preload initial configuration.
- * @detail Options
- */
-export declare type IPreloadConfig = {
+	id?: number | string;
 	/** {zh}
-	 * 预加载场景
-	 * - 0：手动执行
-	 * - 1：字段执行
-	 * @default 0
+	 * @brief 是否为默认选择的字幕。
+	 * @default false
 	 */
 	/** {en}
-	 * @brief Preload scene.
-	 * - 0: manual execution
-	 * - 1: automatic execution
-	 * @default 0
+	 * @brief Whether this is the default selected subtitle.
+	 * @default false
 	 */
-	preloadScene?: PreloadScene;
+	isDefault?: boolean;
 	/** {zh}
-	 * @brief 视频格式
-	 * - mp4: mp4格式
-	 * - hls: hls格式
-	 * @default mp4
+	 * @brief 字幕名称。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Video format.
-	 * @default mp4
+	 * @brief Subtitle display name.
+	 * @default -
 	 */
-	format?: PreloadFormat;
+	text?: string;
 	/** {zh}
-	 * 向前预加载视频个数，Feed流场景时生效
-	 * @default 1
-	 * @brief 向前预加载视频个数。Feed 流场景时生效。
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Number of videos to preload ahead. Effective in Feed scenarios.
-	 * @default 1
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
 	 */
-	prevCount?: number;
+	label?: string | number;
 	/** {zh}
-	 * @brief 向后预加载视频个数。Feed 流场景生效
-	 * @default 2
+	 * @brief 外挂字幕 URL 地址。
+	 * @default -
 	 */
 	/** {en}
-	 * @brief Number of videos to preload behind. Effective in Feed scenarios.
-	 * @default 2
+	 * @brief External subtitle URL.
+	 * @default -
 	 */
-	nextCount?: number;
-	/** {zh}
-	 * @brief 单个视频预加载时长
-	 * @default 5
+	url?: string;
+	/**
+	 * @hidden
+	 * @type {string}
+	 * @memberof ISubTitleItem
 	 */
-	/** {en}
-	 * @brief Preload duration per video (seconds).
-	 * @default 5
+	stringContent?: string;
+	/** {zh}
+	 * @brief 字幕内容列表。非 `url` 形式时使用。
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
+	 */
+	/** {en}
+	 * @brief Subtitle content list when not using URL.
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
+	 */
+	list?: IListItem[];
+}
+/** {zh}
+ * @brief 字幕内容项。
+ * @list Options
+ * @kind property
+ * @export
+ * @interface IListItem
+ */
+/** {en}
+ * @brief Subtitle content item.
+ * @list Options
+ * @kind property
+ * @export
+ * @interface IListItem
+ */
+export interface IListItem {
+	/** {zh}
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Start time in seconds.
+	 * @type {number}
+	 */
+	start: number;
+	/** {zh}
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief End time in seconds.
+	 * @type {number}
+	 */
+	end: number;
+	/** {zh}
+	 * @brief 字幕数据列表。
+	 * @type {Array<ITextItem>}
+	 */
+	/** {en}
+	 * @brief Subtitle cue data list.
+	 * @type {Array<ITextItem>}
+	 */
+	list: Array<ITextItem>;
+	/**
+	 * @hidden
+	 * @type {any}
+	 */
+	[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}
+	 */
+	[propName: string]: any;
+	/** {zh}
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Start time in seconds.
+	 * @type {number}
+	 */
+	start: number;
+	/** {zh}
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief End time in seconds.
+	 * @type {number}
+	 */
+	end: number;
+	/** {zh}
+	 * @brief 字幕文案数组。
+	 * @type {string[]}
+	 */
+	/** {en}
+	 * @brief Subtitle text array.
+	 * @type {string[]}
+	 */
+	text: string[];
+	/** {zh}
+	 * @brief 字幕顺序。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Subtitle display order.
+	 * @type {number}
+	 */
+	index?: number;
+}
+export type TLogChannel = "cn" | "va" | "sg";
+/** {zh}
+ * @hidden
+ * h265策略配置
+ * @detail Options
+ */
+/** {en}
+ * @hidden
+ * @brief H.265 strategy configuration.
+ * @detail Options
+ */
+export declare type IH265Config = {
+	/** {zh}
+	 * @brief h265策略依赖Module
+	 */
+	/** {en}
+	 * @brief H.265 strategy dependency module.
+	 */
+	Strategy?: any;
+	/** {zh}
+	 * @brief 是否禁用265策略
+	 */
+	/** {en}
+	 * @brief Whether to disable the H.265 strategy.
+	 */
+	disabled?: boolean;
+} & VeStrategyH265Config;
+/** {zh}
+ * 预加载初始配置
+ * @detail Options
+ */
+/** {en}
+ * @brief Preload initial configuration.
+ * @detail Options
+ */
+export declare type IPreloadConfig = {
+	/** {zh}
+	 * 预加载场景
+	 * - 0：手动执行
+	 * - 1：字段执行
+	 * @default 0
+	 */
+	/** {en}
+	 * @brief Preload scene.
+	 * - 0: manual execution
+	 * - 1: automatic execution
+	 * @default 0
+	 */
+	preloadScene?: PreloadScene;
+	/** {zh}
+	 * @brief 视频格式
+	 * - mp4: mp4格式
+	 * - hls: hls格式
+	 * @default mp4
+	 */
+	/** {en}
+	 * @brief Video format.
+	 * @default mp4
+	 */
+	format?: PreloadFormat;
+	/** {zh}
+	 * 向前预加载视频个数，Feed流场景时生效
+	 * @default 1
+	 * @brief 向前预加载视频个数。Feed 流场景时生效。
+	 */
+	/** {en}
+	 * @brief Number of videos to preload ahead. Effective in Feed scenarios.
+	 * @default 1
+	 */
+	prevCount?: number;
+	/** {zh}
+	 * @brief 向后预加载视频个数。Feed 流场景生效
+	 * @default 2
+	 */
+	/** {en}
+	 * @brief Number of videos to preload behind. Effective in Feed scenarios.
+	 * @default 2
+	 */
+	nextCount?: number;
+	/** {zh}
+	 * @brief 单个视频预加载时长
+	 * @default 5
+	 */
+	/** {en}
+	 * @brief Preload duration per video (seconds).
+	 * @default 5
 	 */
 	preloadTime?: number;
 	/** {zh}
@@ -6750,8 +7360,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;
@@ -6811,6 +7421,62 @@ 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;
 /** {zh}
  * @hidden
  */
@@ -6863,6 +7529,10 @@ export interface EncryptInfo {
 	unionInfo: string;
 }
 declare class VePlayer {
+	/**
+	 * 注册业务已打包的 UMD 模块，供所有后续创建的播放器共享使用。
+	 */
+	static registerModules(modules: UmdModules): void;
 	/** {zh}
 	 * @brief 播放相关配置数据
 	 * @hidden
@@ -6946,6 +7616,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;
 	/**
 	 *
 	 *
@@ -6988,6 +7670,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加载器
@@ -7003,7 +7701,6 @@ declare class VePlayer {
 	/**
 	 * @hidden
 	 */
-	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
 	/**
 	 * @hidden
 	 */
@@ -7019,6 +7716,62 @@ declare class VePlayer {
 	 * @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 设置全局日志开关。开启后会输出 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
 	 */
@@ -7068,7 +7821,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[]}
@@ -7089,9 +7842,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[]>;
@@ -7126,6 +7877,8 @@ declare class VePlayer {
 	 * @brief Constructor.
 	 */
 	constructor(configs: IPlayerConfig);
+	/** @hidden */
+	assertLiteConfig(config?: Partial<IPlayerConfig>): void;
 	/**
 	 *
 	 * @hidden
@@ -7344,6 +8097,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
@@ -7390,6 +8165,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _bindPlayerEvents;
+	private _onMp4PreloadInfo;
 	private _proxyError;
 	private _onError;
 	/** {zh}
@@ -7567,7 +8343,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 * @notes - 成功更换视频源后，默认是暂停状态。如果设置了自动播放，则会自动播放。
 	 *        - 此接口不支持切换火山引擎私有加密视频。
-	 * @param config 播放器实例化配置。此接口仅支持 `IPlayerConfig` 中的 `url`、`playList`、`poster`、`getVideoByToken` 字段。。
+	 * @param config 播放器实例化配置
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	/** {en}
@@ -7576,7 +8352,14 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
+	private updatePlayNextSubtitleConfig;
 	private _playNext;
+	/** 从 playerData.configs 取出短剧 id，供 XGPlayer setConfig / playNext 与切换后 configs 一致 */
+	private _getDramaConfigPatchForPlayer;
+	private _buildDramaInvalidParamError;
+	private _getDramaAlbumIdFromConfig;
+	private _getDramaEpisodeIdFromConfig;
+	private switchDramaEpisode;
 	/** {zh}
 	 * @brief 销毁xgplayer实例
 	 *
@@ -7926,6 +8709,32 @@ declare class VePlayer {
 	 * @brief Get a plugin instance.
 	 */
 	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}
 	 * @memberof VePlayer
 	 * @brief 销毁当前播放器实例。
@@ -8350,344 +9159,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 播放器实例创建完成时触发。
 	 */
@@ -8844,6 +9551,10 @@ export declare const Events: {
 	 * @brief Triggered when autoplay fails.
 	 */
 	AUTOPLAY_PREVENTED: string;
+	/** {zh}
+	 * @brief 播放器准备创建。
+	 */
+	READY_CREATE_PLAYER: string;
 	/** {zh}
 	 * @brief 播放器完成创建。
 	 */
@@ -8851,6 +9562,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 播放器重建。
 	 */
@@ -9278,6 +9996,10 @@ export declare const Event: {
 		 * @brief Triggered when autoplay fails.
 		 */
 		AUTOPLAY_PREVENTED: string;
+		/** {zh}
+		 * @brief 播放器准备创建。
+		 */
+		READY_CREATE_PLAYER: string;
 		/** {zh}
 		 * @brief 播放器完成创建。
 		 */
@@ -9285,6 +10007,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 播放器重建。
 		 */
@@ -9392,6 +10121,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 弹幕配置发生变化。
 		 */
@@ -9546,110 +10356,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,
 };