@byteplus/veplayer 1.15.3-rc.2 → 1.15.3-rc.20

package/index.d.ts

@@ -669,6 +669,11 @@ export interface ISubTitleItem {
 	 * @brief 字幕名称
 	 */
 	text?: string;
+	/**
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	label?: string | number;
 	/**
 	 * @brief 外挂字幕 URL 地址。
 	 * @default -
@@ -697,6 +702,16 @@ 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;
+};
+export declare type IAutoSubtitleItemFormatter = (item: IAutoSubtitleSourceItem, index: number) => IAutoSubtitleFormatterResult;
 /**
  * @brief 字幕内容项。
  * @list Options
@@ -2185,6 +2200,7 @@ export interface ISubtitleInfoList {
 	Version: string;
 	Vid: string;
 }
+export declare type ISubtitleInfoListItem = ISubtitleInfoList | string;
 /** {zh}
  * @hidden
  */
@@ -2243,11 +2259,97 @@ 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 获取短剧信息
+	 * @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 视频编码格式。
@@ -2282,7 +2384,7 @@ export declare const CodecType: {
 	 */
 	readonly UNKNOWN: "unknown";
 };
-export declare type ICodecType = (typeof CodecType)[keyof typeof CodecType];
+export declare type ICodecType = typeof CodecType[keyof typeof CodecType];
 export declare const ContentType: {
 	h265: string;
 	h264: string;
@@ -2673,6 +2775,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
@@ -2718,12 +2900,48 @@ 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}
 	 * @memberof IPlayerConfig
 	 */
 	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 }` 时不展示该项。
+	 * @default -
+	 */
+	formatAutoSubtitleItem?: IAutoSubtitleItemFormatter;
 	/** {zh}
 	 * @brief 视频加密类型
 	 * @default -
@@ -3261,6 +3479,31 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default -
 	 */
 	sdkErrorPlugin?: ISdkErrorConfig;
+	/** {zh}
+	 * @brief 原生媒体错误（如网络类 code 2/4）自动重试的最大次数，对应 {@link VeErrorOptions.oriErrRetryCount}。
+	 * @default 3
+	 */
+	oriErrRetryCount?: number;
+	/** {zh}
+	 * @brief 上述重试计数的清零周期（毫秒），超时后重试次数重新统计，对应 {@link VeErrorOptions.oriErrRetryCycle}。
+	 * @default 10000
+	 */
+	oriErrRetryCycle?: number;
+	/** {zh}
+	 * @brief 是否在原生媒体错误时自动重试拉流，对应 {@link VeErrorOptions.enableOriErrRetry}。
+	 * @default true
+	 */
+	enableOriErrRetry?: boolean;
+	/** {zh}
+	 * @brief 是否在错误时同步分析网络/流（如 XHR 探测），对应 {@link VeErrorOptions.needSyncAnalyzeError}。
+	 * @default true
+	 */
+	needSyncAnalyzeError?: boolean;
+	/** {zh}
+	 * @brief 错误分析请求超时时间（毫秒），对应 {@link VeErrorOptions.analyzeTimeout}。
+	 * @default 3000
+	 */
+	analyzeTimeout?: number;
 	/** {zh}
 	 * @brief rtm配置，配置rtm拉流参数
 	 * @notes 传入rtm流url时才生效
@@ -3972,6 +4215,174 @@ export interface ApiMapConfig {
 	playDomain: string;
 	backupPlayDomain?: string;
 }
+/**
+ * @list Options
+ * @brief 字幕项。
+ * @kind property
+ */
+/** {en}
+ * @brief 字幕项配置
+ */
+export interface ISubTitleItem {
+	/**
+	 * @brief 字幕语言。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 字幕语言
+	 */
+	language?: string | number;
+	/**
+	 * @brief 字幕 ID。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 字幕id
+	 */
+	id?: number | string;
+	/**
+	 * @brief 是否为默认选择的字幕。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief 是否是默认选择的字幕
+	 */
+	isDefault?: boolean;
+	/**
+	 * @brief 字幕名称。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 字幕名称
+	 */
+	text?: string;
+	/**
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	label?: string | number;
+	/**
+	 * @brief 外挂字幕 URL 地址。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 外挂字幕地址
+	 */
+	url?: string;
+	/**
+	 * stringContent
+	 * @default 无
+	 * @hidden
+	 * @type {string}
+	 * @memberof ISubTitleItem
+	 */
+	stringContent?: string;
+	/**
+	 * 字幕内容列表，非url形式时使用
+	 * @default 无
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
+	 * @brief 字幕内容列表。非 `url` 形式时使用。
+	 */
+	/** {en}
+	 * @brief 字幕内容列表，非url形式时使用
+	 */
+	list?: IListItem[];
+}
+/**
+ * @brief 字幕内容项。
+ * @list Options
+ * @kind property
+ * @export
+ * @interface IListItem
+ */
+/** {en}
+ * @brief 字幕内容项配置
+ */
+export interface IListItem {
+	/**
+	 * 开始时间
+	 * @type {number}
+	 * @brief 开始时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 开始时间
+	 */
+	start: number;
+	/**
+	 * 结束时间
+	 * @type {number}
+	 * @brief 结束时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 结束时间
+	 */
+	end: number;
+	/**
+	 * 字幕数据列表
+	 * @type {Array<ITextItem>}
+	 * @brief 字幕数据列表。
+	 */
+	/** {en}
+	 * @brief 字幕数据列表
+	 */
+	list: Array<ITextItem>;
+	/**
+	 * @default 无
+	 * @hidden
+	 * @type {any}
+	 */
+	[propName: string]: any;
+}
+/**
+ * @breif 字幕文案配置
+ * @list Options
+ * @kind property
+ */
+export interface ITextItem {
+	/**
+	 * @default 无
+	 * @hidden
+	 * @type {any}
+	 */
+	[propName: string]: any;
+	/**
+	 * 开始时间
+	 * @type {number}
+	 * @brief 开始时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 开始时间
+	 */
+	start: number;
+	/**
+	 * 结束时间
+	 * @type {number}
+	 * @brief 结束时间，单位为秒。
+	 */
+	/** {en}
+	 * @brief 结束时间
+	 */
+	end: number;
+	/**
+	 * 字幕文案数组
+	 * @type {string[]}
+	 * @brief 字幕文案数组。
+	 */
+	/** {en}
+	 * @brief 字幕文案数组
+	 */
+	text: string[];
+	/**
+	 * 字幕顺序
+	 * @type {number}
+	 * @brief 字幕顺序。
+	 */
+	/** {en}
+	 * @brief 字幕顺序
+	 */
+	index?: number;
+}
 export type TLogChannel = "cn" | "va" | "sg";
 declare enum PreloadScene {
 	/**
@@ -4233,7 +4644,7 @@ export declare type IPreloadUpdateConfig = {
  * 预加载视频资源
  * @detail Options
  */
-export declare type IPreloadStream = {
+export declare type IPreloadResolvedStream = {
 	/**
 	 * 视频唯一ID
 	 * @brief 视频 ID
@@ -4295,6 +4706,43 @@ export declare type IPreloadStream = {
 	 */
 	size: number;
 };
+export declare type IPreloadDramaStream = {
+	/**
+	 * 视频唯一ID
+	 */
+	vid?: string;
+	/**
+	 * 短剧剧 ID
+	 */
+	albumId: string;
+	/**
+	 * 短剧剧集 ID
+	 */
+	episodeId: string;
+	/**
+	 * 默认清晰度，用于缓存 key 和预加载流选择
+	 */
+	defaultDefinition?: string;
+	/**
+	 * Vid 播放配置。短剧预加载会复用 playAuthToken 等配置请求短剧信息。
+	 */
+	getVideoByToken?: IPlayAuthTokenConfig;
+};
+export declare type IPreloadAuthTokenStream = {
+	/**
+	 * 视频唯一ID
+	 */
+	vid?: string;
+	/**
+	 * 默认清晰度，用于选择预加载流
+	 */
+	defaultDefinition?: string;
+	/**
+	 * Vid 播放配置。预加载会复用 playAuthToken 请求媒体信息。
+	 */
+	getVideoByToken: IPlayAuthTokenConfig;
+};
+export declare type IPreloadStream = IPreloadResolvedStream | IPreloadDramaStream | IPreloadAuthTokenStream;
 declare class VeStrategyWrapper {
 	private tea;
 	private static mapStrategyNameToUmdKey;
@@ -4373,6 +4821,8 @@ export declare type UMDMap = Record<UmdKeys, {
 declare class UMDLoader {
 	private static jsLoadMap;
 	private static jsLoadPromiseMap;
+	/** 清除指定插件的加载缓存，使下次 loadPlugins 重新触发加载（用于修复首次加载失败的情况） */
+	clearPluginCache(pluginName: UmdKeys): void;
 	umdMap: UMDMap;
 	backupUmdUrlMap: Record<string, string>;
 	failCallback: (umdName: string, err: any) => any;
@@ -4454,6 +4904,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;
@@ -4475,13 +5048,50 @@ 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;
+	/**
+	 * 剧集切换：configs 已由 player 更新 album_id/episode_id，重新拉取媒体信息
+	 */
+	updateDramaEpisode(isNewVideo: boolean): Promise<void>;
 	/**
 	 * @description 更新playAuthToken
 	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
@@ -4601,9 +5211,7 @@ declare class PlayerData {
 	 * @brief 私有加密会话id
 	 */
 	encryptSessionId?: string;
-	constructor(configs: IPlayerConfig & {
-		licensSupportModuleList: string[];
-	}, sdk: VePlayer);
+	constructor(configs: IPlayerConfig, sdk: VePlayer);
 	/**
 	 * 初始化播放数据
 	 * @param configs { IPlayerConfig } 播放器配置
@@ -4730,34 +5338,62 @@ declare class MobilePlayerPanel {
 	bind(event: string, eventHandle: any, isBubble?: boolean): void;
 	destroy(): void;
 }
-export interface IlicenseContent {
-	content: string;
-	sign: string;
-	mainUrl?: string;
-}
-declare enum LicenseEdition {
-	EDITION_STANDARD = "standard_edition",
-	EDITION_PREMIUM = "premium_edition",
-	EDITION_NONE = "none_edition"
-}
-declare enum LicenseFeature {
-	H265 = "h265",
-	PRELOAD = "preload",
-	ADAPT_RANGE = "adaptRange",
-	ABR = "abr"
-}
-declare enum LicenseStatus {
-	LICENSE_STATUS_INVALID = 0,
-	LICENSE_STATUS_OK = 1,
-	LICENSE_STATUS_EXPIRED = 2,
-	LICENSE_STATUS_ERROR_DOMAIN_NOT_MATCH = 401
-}
-export interface ILicenseConfig {
-	license: string | IlicenseContent;
-	autoUpload?: boolean;
-	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
  */
@@ -4773,10 +5409,6 @@ export declare type PlayerCore = Player & {
 	panel?: MobilePlayerPanel;
 	emitExpireTimestamp?: number;
 	vodLogger?: VodLogger;
-	licenseLogInfo?: {
-		licenseStatus: LicenseStatus;
-		licenseType: LicenseEdition;
-	};
 };
 /**
  * @brief 加密混淆信息
@@ -4849,6 +5481,18 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _emitter;
+	/**
+	 * @hidden
+	 * createPlayer 阶段耗时采集器（仅在 createPlayer 执行期间存在）
+	 */
+	_createPlayerPerf?: CreatePlayerPerfCollector;
+	/**
+	 * @hidden
+	 * 最近一次 createPlayer 性能报告
+	 */
+	private _lastCreatePlayerPerfReport?;
+	private _isCollectingCreatePlayerPerf;
+	private _getDramaInfoPerfRecords;
 	/**
 	 *
 	 *
@@ -4891,6 +5535,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加载器
@@ -4906,7 +5566,6 @@ declare class VePlayer {
 	/**
 	 * @hidden
 	 */
-	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
 	/**
 	 * @hidden
 	 */
@@ -4917,6 +5576,51 @@ 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;
 	/**
 	 * @hidden
 	 */
@@ -4949,7 +5653,7 @@ declare class VePlayer {
 	 * @brief 添加待预加载视频列表
 	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}。
 	 */
-	static addPreloadList(list: IPreloadStream[]): void;
+	static addPreloadList(list: IPreloadStream[]): Promise<void>;
 	/** {zh}
 	 * @brief 设置待预加载视频列表，替换当前已设置的待预加载列表
 	 * @param list 待预加载视频列表，详情见{@link IPreloadStream[]}
@@ -4960,14 +5664,6 @@ declare class VePlayer {
 	 * @param codec
 	 * @param options
 	 */
-	static isRTMSupportCodec: (codec: RTMCodec, options: {
-		targetProfileLevel?: string;
-	}) => Promise<boolean>;
-	static setLicenseConfig(config: ILicenseConfig): Promise<void>;
-	static checkLicense(): Promise<LicenseEdition>;
-	static checkModuleList(): Promise<string[]>;
-	static checkLicenseStatus(): Promise<LicenseStatus>;
-	static checkLicenseModuleAuth(module: string, featureName: LicenseFeature): Promise<boolean>;
 	/**
 	 * @breif 生成加密混淆的数据信息
 	 * @param unionId 用户唯一id
@@ -5115,7 +5811,6 @@ declare class VePlayer {
 	 * @hidden
 	 */
 	createPlayer: () => Promise<PlayerCore>;
-	private checkLicenseCallback;
 	/** {zh}
 	 * @hidden
 	 * @brief 设置合并开发者的插件配置，如果开发者从初始化的configs里传了插件配置，则只用开发者的配置，并补齐其他参数
@@ -5181,6 +5876,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
@@ -5227,6 +5944,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _bindPlayerEvents;
+	private _onMp4PreloadInfo;
 	private _proxyError;
 	private _onError;
 	/** {zh}
@@ -5344,8 +6062,35 @@ declare class VePlayer {
 	 * @param config 播放器实例化配置。此接口仅支持 `IPlayerConfig` 中的 `url`、`playList`、`poster`、`getVideoByToken` 字段。。
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
+	/** {zh}
+	 * @brief 当前播放器命中预加载的情况
+	 * @type {{
+	 *  hit: number, // 0-未命中 1-命中
+	 *  duration: 0, // 预加载时长
+	 *  length: 0 // 预加载数据长度
+	 * }}
+	 */
+	/** {en}
+	 * @brief Whether the current playback hit preloaded data.
+	 * @type {{
+	 *  hit: number, // 0-miss 1-hit
+	 *  duration: number, // preloaded duration
+	 *  length: number // preloaded data length in bytes
+	 * }}
+	 */
+	get preLoadData(): {
+		hit: number;
+		duration?: number;
+		length?: number;
+	};
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
 	private _playNext;
+	/** 从 playerData.configs 取出短剧 id，供 XGPlayer setConfig / playNext 与切换后 configs 一致 */
+	private _getDramaConfigPatchForPlayer;
+	private _buildDramaInvalidParamError;
+	private _getDramaAlbumIdFromConfig;
+	private _getDramaEpisodeIdFromConfig;
+	private switchDramaEpisode;
 	/** {zh}
 	 * @brief 销毁xgplayer实例
 	 *
@@ -5546,6 +6291,32 @@ declare class VePlayer {
 	 * @param pluginName 插件名。
 	 */
 	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 销毁当前播放器实例。
@@ -5964,91 +6735,6 @@ 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 弹幕配置发生变化。
@@ -6190,6 +6876,13 @@ export declare const Events: {
 	 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 	 */
 	ABR_AUTO_DESC_CHANGE: 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;
 	/** {zh}
 	 * @brief 播放器实例创建完成时触发。
 	 */
@@ -6340,10 +7033,21 @@ export declare const Events: {
 	 * @brief Autoplay fails to start.
 	 */
 	AUTOPLAY_PREVENTED: string;
+	/** {zh}
+	 * @brief 播放器准备创建。
+	 */
+	READY_CREATE_PLAYER: string;
 	/** {zh}
 	 * @brief 播放器完成创建。
 	 */
 	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 播放器重建。
 	 */
@@ -6663,10 +7367,21 @@ export declare const Event: {
 		 * @brief Autoplay fails to start.
 		 */
 		AUTOPLAY_PREVENTED: string;
+		/** {zh}
+		 * @brief 播放器准备创建。
+		 */
+		READY_CREATE_PLAYER: string;
 		/** {zh}
 		 * @brief 播放器完成创建。
 		 */
 		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 播放器重建。
 		 */
@@ -6861,12 +7576,18 @@ export declare const Event: {
 		 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 		 */
 		ABR_AUTO_DESC_CHANGE: 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;
 	};
 };
 export * from "xgplayer";
 
 export {
-	LiveSubTitlesPlugin as LiveSubtitlesPlugin,
 	MusicPreset as Music,
 	VePlayer as default,
 };