@volcengine/veplayer 1.15.3-rc.1 → 1.15.3-rc.11

package/index.d.ts

@@ -80,21 +80,8 @@ export interface ISdkErrorConfig {
 	 * @hidden
 	 */
 	isNeedDemoteBack?: boolean;
-	/**
-	 * @brief 是否允许回退到同清晰度不同线路的 fallbackurl：
-	 *        - `false`：只能在当前 defintion 范围内 fallback。
-	 *        - `true`：允许 fallback 相同清晰度，不同的线路的 fallbackurl。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote to different line enabled? The values are as follows:
-	 *        - `false`: only demote in current definition line.
-	 *        - `true`: allow demote to different line.
-	 */
-	allowDemoteToDifferentLine?: boolean;
 	/** {zh}
-	 * @brief 报错后重试轮数。
+	 * @brief 报错后重试次数。
 	 * @default 1
 	 */
 	retryLoopNum?: number;
@@ -826,61 +813,6 @@ export interface IDefinitionDemotePlugin {
 	 *        - `true`: automatic downgrade is enabled.
 	 */
 	isNeedAutoDemote?: boolean;
-	/**
-	 * @brief 当用户开启 fallbackUrl 降级（降级到备用线路) 时，优先降级清晰度还是 fallbackUrl，取值如下：
-	 *        - `false`：优先在同一个清晰度的所有 fallback 之间切换, 都有问题的情况下，再降低到下一个清晰度
-	 *        - `true`：优先降级清晰度, 清晰度降到最低之后，再在最后一个清晰度的 fallbackUrl 之间切换
-	 * @default false
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote quality first? The values are as follows:
-	 *        - `false`: not demote quality first.
-	 *        - `true`: demote quality first.
-	 */
-	shouldDemoteDefinitionFirst?: boolean;
-	/**
-	 * @brief 是否开启 fallbackUrl 降级：
-	 *        - `false`：不尝试降级到备用线路。
-	 *        - `true`：尝试降级到备用线路。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is automatic downgrade enabled? The values are as follows:
-	 *        - `false`: not try to play fallbackUrl first.
-	 *        - `true`: try to play fallbackUrl first before demote definition.
-	 */
-	isNeedDemoteBack?: boolean;
-	/**
-	 * @brief 是否允许回退到同清晰度不同线路的 fallbackurl：
-	 *        - `false`：只能在当前 defintion 范围内 fallback。
-	 *        - `true`：允许 fallback 相同清晰度，不同的线路的 fallbackurl。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote to different line enabled? The values are as follows:
-	 *        - `false`: only demote in current definition line.
-	 *        - `true`: allow demote to different line.
-	 */
-	allowDemoteToDifferentLine?: boolean;
-	/**
-	 * @brief 同一清晰度降级至 fallbackurl 的重试轮数。
-	 * @default 1
-	 */
-	/** {en}
-	 * @brief The retry loop number for all available fallbackUrl.
-	 */
-	retryLoopNum?: number;
-	/**
-	 * @brief 在降级时到下一个definition 时，是否显示 toast 提示。
-	 * @default 1
-	 */
-	/** {en}
-	 * @brief Whether to show toast when demote to next definition.
-	 */
-	bumpToastWhenDemoteToNextDefinition?: boolean;
 	/**
 	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
@@ -942,10 +874,6 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	longWaitingEmitTime: number;
 	waitingStartTime: number;
 	playerData: PlayerData;
-	fallbackState: {
-		retryTimes: number;
-		idx: number;
-	};
 	static get defaultConfig(): IDefinitionDemotePlugin;
 	constructor(args: any);
 	registerLanguageTexts(): {
@@ -965,12 +893,6 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_clearTime(): void;
 	clearState(): void;
 	demote(): void;
-	executeDemoteFallbackFirst(): void;
-	executeDemoteDefinitionFirst(): void;
-	getRetryListForCurrentDefinition(): any[];
-	getRetryListForCurrentDefinitionAcrossAllLines(): any[];
-	resetTimes(): void;
-	changeMainOrBackup(): boolean;
 	changeUrl(url: Url): void;
 	showToast(definition: Stream): void;
 	destroy(): void;
@@ -2326,6 +2248,81 @@ export interface IGetPlayInfoRes {
 	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 获取短剧信息返回结果
+ */
+export interface IJSBCallbackResult {
+	is_success: number;
+	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;
+	};
+}
 /** {zh}
  * @list Options
  * @brief 视频编码格式。
@@ -2360,7 +2357,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;
@@ -2751,6 +2748,39 @@ 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
@@ -2796,12 +2826,29 @@ 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 视频加密类型
 	 * @default -
@@ -3339,6 +3386,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时才生效
@@ -4311,7 +4383,7 @@ export declare type IPreloadUpdateConfig = {
  * 预加载视频资源
  * @detail Options
  */
-export declare type IPreloadStream = {
+export declare type IPreloadResolvedStream = {
 	/**
 	 * 视频唯一ID
 	 * @brief 视频 ID
@@ -4373,6 +4445,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;
@@ -4532,6 +4641,135 @@ 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_INVALID_PLAY_DOMAIN = "DRAMA_INVALID_PLAY_DOMAIN",
+	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 INVALID_PLAY_DOMAIN: {
+		readonly code: 9309;
+		readonly message: "Invalid play domain";
+		readonly textKey: LangTextKey.DRAMA_INVALID_PLAY_DOMAIN;
+	};
+	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;
@@ -4553,13 +4791,42 @@ declare class AuthToken extends SdkPlugin {
 		codec: ICodecType;
 		defaultDefinition: string;
 	}>;
-	getVideos(): Promise<any>;
+	/**
+	 * 短剧 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;
+	/**
+	 * 短剧环境（宿主注入 ttDramaEnv）：校验每条主播放地址域名须为 *.tiktok-minis-vod.us
+	 */
+	ensureMinisDramaPlayDomainOrReject(videoInfoRes: VideoInfoRes | undefined): VideoInfoRes | undefined;
+	callOnGetMediaInfo(mediaInfo: VideoInfoRes | undefined, fromCache: boolean): void;
+	getVideos(): Promise<VideoInfoRes>;
 	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
 	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
 	getBarrageMaskUrl(url: string): void;
 	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信息
@@ -4679,9 +4946,7 @@ declare class PlayerData {
 	 * @brief 私有加密会话id
 	 */
 	encryptSessionId?: string;
-	constructor(configs: IPlayerConfig & {
-		licensSupportModuleList: string[];
-	}, sdk: VePlayer);
+	constructor(configs: IPlayerConfig, sdk: VePlayer);
 	/**
 	 * 初始化播放数据
 	 * @param configs { IPlayerConfig } 播放器配置
@@ -4726,7 +4991,6 @@ declare class PlayerData {
 	 * @description: 获取满足当前直播条件的流
 	 */
 	getCurrentStreams(): Stream[];
-	getStreamsMatchCurrentDefinition(): Stream[];
 	/**
 	 * @description: 获取根据线路ID去重的流，用于获取有几个线路
 	 */
@@ -4809,34 +5073,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
  */
@@ -4852,10 +5144,6 @@ export declare type PlayerCore = Player & {
 	panel?: MobilePlayerPanel;
 	emitExpireTimestamp?: number;
 	vodLogger?: VodLogger;
-	licenseLogInfo?: {
-		licenseStatus: LicenseStatus;
-		licenseType: LicenseEdition;
-	};
 };
 /**
  * @brief 加密混淆信息
@@ -4928,6 +5216,16 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _emitter;
+	/**
+	 * @hidden
+	 * createPlayer 阶段耗时采集器（仅在 createPlayer 执行期间存在）
+	 */
+	_createPlayerPerf?: CreatePlayerPerfCollector;
+	/**
+	 * @hidden
+	 * 最近一次 createPlayer 性能报告
+	 */
+	private _lastCreatePlayerPerfReport?;
 	/**
 	 *
 	 *
@@ -4970,6 +5268,28 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	delayError: any[];
+	/**
+	 * @hidden
+	 * When enabled, bypass `short video minis drama` play-domain validation.
+	 * This is only used for `ttDramaEnv` scenarios.
+	 */
+	private static _skipMinisDramaPlayDomainValidation;
+	/** {zh}
+	 * @brief 跳过短剧 minis 播放域名校验（仅影响 `ttDramaEnv` 下的主播放地址校验）。
+	 * @param skip true=跳过校验，false=恢复校验
+	 */
+	/** {en}
+	 * @brief Skip minis drama play-domain validation (only affects `ttDramaEnv` scenarios).
+	 * @param skip true=skip validation, false=restore validation
+	 */
+	static setSkipMinisDramaPlayDomainValidation(skip?: boolean): void;
+	/** {zh}
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
+	static getSkipMinisDramaPlayDomainValidation(): boolean;
 	/**
 	 * @hidden
 	 * umd加载器
@@ -4985,7 +5305,6 @@ declare class VePlayer {
 	/**
 	 * @hidden
 	 */
-	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
 	/**
 	 * @hidden
 	 */
@@ -4996,6 +5315,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
 	 */
@@ -5028,7 +5392,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[]}
@@ -5039,14 +5403,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
@@ -5194,7 +5550,6 @@ declare class VePlayer {
 	 * @hidden
 	 */
 	createPlayer: () => Promise<PlayerCore>;
-	private checkLicenseCallback;
 	/** {zh}
 	 * @hidden
 	 * @brief 设置合并开发者的插件配置，如果开发者从初始化的configs里传了插件配置，则只用开发者的配置，并补齐其他参数
@@ -5260,6 +5615,15 @@ 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;
 	private prepareStrategies;
 	/**
 	 * @hidden
@@ -5306,6 +5670,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _bindPlayerEvents;
+	private _onMp4PreloadInfo;
 	private _proxyError;
 	private _onError;
 	/** {zh}
@@ -5423,8 +5788,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实例
 	 *
@@ -6043,91 +6435,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 弹幕配置发生变化。
@@ -6154,11 +6461,11 @@ export declare const Events: {
 	 */
 	REFRESH_CLICK: string;
 	/** {zh}
-	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
+	 * @brief 报错时触发降级。
 	 */
 	PLAY_BACKUP_CHANGE: string;
 	/** {zh}
-	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
+	 * @brief 报错时触发的降级结束。
 	 */
 	PLAY_BACKUP_CHANGE_FINISH: string;
 	/** {zh}
@@ -6189,15 +6496,6 @@ export declare const Events: {
 	 * @brief 清晰度降级。
 	 */
 	DEFINITION_DEMOTE: string;
-	/** {zh}
-	 * @brief 已降至最低清晰度。
-	 */
-	DEFINITION_DEMOTE_ALL_DONE: string;
-	/** {zh}
-	 * @brief 所有可执行的降级操作均执行完毕。如果用户同时开启了 definition 降级和 fallbackUrl 降级，
-	 * 无论两者哪个优先级更高，待所有可执行的降级操作均执行完毕，会触发该事件。
-	 */
-	DEMOTE_ALL_DONE: string;
 	/** {zh}
 	 * @hidden
 	 */
@@ -6278,6 +6576,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 播放器实例创建完成时触发。
 	 */
@@ -6428,10 +6733,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 播放器重建。
 	 */
@@ -6751,10 +7067,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 播放器重建。
 		 */
@@ -6834,11 +7161,11 @@ export declare const Event: {
 		 */
 		REFRESH_CLICK: string;
 		/** {zh}
-		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
+		 * @brief 报错时触发降级。
 		 */
 		PLAY_BACKUP_CHANGE: string;
 		/** {zh}
-		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
+		 * @brief 报错时触发的降级结束。
 		 */
 		PLAY_BACKUP_CHANGE_FINISH: string;
 		/** {zh}
@@ -6869,15 +7196,6 @@ export declare const Event: {
 		 * @brief 清晰度降级。
 		 */
 		DEFINITION_DEMOTE: string;
-		/** {zh}
-		 * @brief 已降至最低清晰度。
-		 */
-		DEFINITION_DEMOTE_ALL_DONE: string;
-		/** {zh}
-		 * @brief 所有可执行的降级操作均执行完毕。如果用户同时开启了 definition 降级和 fallbackUrl 降级，
-		 * 无论两者哪个优先级更高，待所有可执行的降级操作均执行完毕，会触发该事件。
-		 */
-		DEMOTE_ALL_DONE: string;
 		/** {zh}
 		 * @hidden
 		 */
@@ -6958,12 +7276,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,
 };