@volcengine/veplayer 1.15.3-rc.31 → 1.15.3-rc.32

package/README.md

@@ -13,6 +13,19 @@ import VePlayer from '@volcengine/veplayer';
 import '@volcengine/veplayer/index.min.css';
 ```
 
+### 精简版（Lite）
+
+Lite 版本面向仅需点播（VOD）能力的场景，可通过同一包的子路径引入。
+
+```javascript
+import VePlayer from '@volcengine/veplayer/lite';
+import '@volcengine/veplayer/lite.css';
+```
+
+Lite 仅支持点播；直播、弹幕、音乐、广告和 RTM plugin 均不可用。配置或启用这些能力会在启动阶段被明确拒绝并报错；请改用完整版 `@volcengine/veplayer`。
+
+Lite 为现代浏览器构建，不支持 IE11 或旧版 polyfill；完整版仍保持原有兼容策略。
+
 ### 添加播放容器
 在需要展示播放器的页面添加播放器容器，例如，在 index.html 中加入以下代码。
 ```javascript

package/index.d.ts

@@ -4754,7 +4754,7 @@ export declare type IPreloadAuthTokenStream = {
 export declare type IPreloadStream = IPreloadResolvedStream | IPreloadDramaStream | IPreloadAuthTokenStream;
 declare class VeStrategyWrapper {
 	private tea;
-	private static mapStrategyNameToUmdKey;
+	private collector;
 	teaId: number;
 	teaChannel: TLogChannel;
 	preloader: PreloaderManagerOrigin | undefined;
@@ -4788,7 +4788,102 @@ declare class VeStrategyWrapper {
 	private initPreloaderConfig;
 }
 declare const _default: VeStrategyWrapper;
-declare enum UmdKeys {
+/** {zh}
+ * @hidden
+ */
+export declare type IRes = IGetPlayInfoRes & {
+	Data: IGetPlayInfoRes & {
+		VideoID?: string;
+	};
+};
+declare enum VideoFileTypes {
+	VIDEO = "video",
+	EVIDEO = "evideo",
+	DRM_EVIDEO = "drm_evideo"
+}
+declare enum AudioFileTypes {
+	AUDIO = "audio",
+	EAUDIO = "eaudio",
+	DRM_AUDIO = "drm_eaudio"
+}
+export interface ITokenInfo {
+	Action?: string;
+	Codec?: ICodecType;
+	FileType?: VideoFileTypes | AudioFileTypes;
+	Format?: string;
+	Ssl?: 0 | 1;
+	Version?: string;
+	Vid?: string;
+	"X-Algorithm"?: string;
+	"X-Credential"?: string;
+	"X-Expires"?: number | string;
+	"X-Date"?: string;
+	"X-Signature"?: string;
+	"X-SignedQueries"?: string;
+	DrmType?: string;
+	PlayAuthIds?: string;
+	[propName: string]: string | number;
+}
+/** {zh}
+ * @hidden
+ */
+export interface IDefItem extends Stream {
+	vid: string;
+	lineId?: number;
+	lineName?: string;
+	url: string;
+	streamType: string;
+	backupUrl: string;
+	backUrlList: string[];
+	fileType?: "video" | "audio" | "evideo" | "eaudio";
+	format: string;
+	bitrate?: number;
+	size?: number;
+	kid?: string;
+	vwidth?: number;
+	vheight?: number;
+}
+/** {zh}
+ * @hidden
+ */
+export interface VideoInfoRes {
+	playList: IDefItem[];
+	type?: string;
+	poster: string;
+	vid: string;
+	duration: number;
+	dashOpts: IRes | {
+		Data: IRes;
+	};
+	thumbs: IThumbInfoItem[];
+	barrageMaskUrl: string;
+	enableAdaptive?: boolean;
+	adaptiveBitrateStreamingInfo?: ABRInfo;
+}
+export interface ICreatePlayerPerfTiming {
+	name: string;
+	duration: number;
+}
+export interface ICreatePlayerPerfReport {
+	totalDuration: number;
+	timings: ICreatePlayerPerfTiming[];
+	timingMap: Record<string, number>;
+}
+declare class CreatePlayerPerfCollector {
+	private now;
+	private startAt;
+	private timings;
+	private timingMap;
+	constructor();
+	markDuration(name: string, durationMs: number): void;
+	measure<T>(name: string, fn: () => T): T;
+	measureAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
+	finish(): ICreatePlayerPerfReport;
+}
+export declare type CollectorConstructor = new (name: string) => any;
+declare function isMSESupport(mime?: string): boolean;
+/** UMD modules that can be loaded or explicitly pre-registered. */
+export declare enum UmdKeys {
 	HLS = "hls",
 	FLV = "flv",
 	XGVideo = "XGVideo",
@@ -4805,11 +4900,17 @@ declare enum UmdKeys {
 	DashAbralgo = "DashAbralgo",
 	Preloader = "preloader"
 }
+/** Resolved UMD module values keyed by their public UMD key. */
+export declare type UmdModules = Partial<Record<UmdKeys, unknown>>;
+/**
+ * @hidden
+ * @breif umdmap 的keys
+ */
 /**
  * @hidden
- * @breif umdmap 配置
+ * @breif umdmap 单项配置
  */
-export declare type UMDMap = Record<UmdKeys, {
+export interface UMDMapEntry {
 	/**
 	 * umd Module 的名称，即在window下暴露的接口名称
 	 */
@@ -4826,10 +4927,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;
@@ -5437,6 +5548,10 @@ export interface EncryptInfo {
 	unionInfo: string;
 }
 declare class VePlayer {
+	/**
+	 * 注册业务已打包的 UMD 模块，供所有后续创建的播放器共享使用。
+	 */
+	static registerModules(modules: UmdModules): void;
 	/** {zh}
 	 * @brief 播放相关配置数据
 	 * @hidden
@@ -5630,6 +5745,15 @@ declare class VePlayer {
 	 * @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
 	 */
@@ -5699,6 +5823,8 @@ declare class VePlayer {
 	 * @param configs 播放器实例化配置。
 	 */
 	constructor(configs: IPlayerConfig);
+	/** @hidden */
+	assertLiteConfig(config?: Partial<IPlayerConfig>): void;
 	/**
 	 *
 	 * @hidden
@@ -6746,6 +6872,53 @@ export declare class MirrorPlugin extends Plugin {
 	render(): string;
 }
 export declare const Events: {
+	/** {zh}
+	 * @brief 自动播放成功。
+	 */
+	AUTOPLAY_SUCCESS: string;
+	/** {zh}
+	 * @brief 自动播放失败。
+	 */
+	AUTOPLAY_FAILED: string;
+	/** {zh}
+	 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
+	 */
+	MENU_LOG: string;
+	/** {zh}
+	 * @brief 点击了右键菜单的反馈按钮。
+	 */
+	MENU_REPORT: string;
+	/** {zh}
+	 * @brief 播放列表更新。
+	 */
+	PLAY_LIST_CHANGE: string;
+	/** {zh}
+	 * @brief 播放列表播放项变更。
+	 */
+	PLAY_LIST_ITEM_CHANGE: string;
+	/** {zh}
+	 * @brief `playNext` 开始。
+	 */
+	PLAY_NEXT_START: string;
+	/** {zh}
+	 * @brief `playNext` 结束。
+	 */
+	PLAY_NEXT_END: string;
+	/** {zh}
+	 * @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;
+	TIME_SCALE_CHANGE?: string;
+	MUSIC_MODE_CHANGE?: string;
+	MUSIC_CHANGE?: string;
+	MUSIC_LIST_CHANGE?: string;
 	/** {zh}
 	 * @brief 弹幕配置发生变化。
 	 */
@@ -6834,65 +7007,6 @@ export declare const Events: {
 	 * @brief 镜像开启。
 	 */
 	MIRROR_CHANGE: string;
-	/** {zh}
-	 * @brief 音乐播放器快进或快退。
-	 */
-	TIME_SCALE_CHANGE: string;
-	/** {zh}
-	 * @brief 音乐播放模式切换。
-	 */
-	MUSIC_MODE_CHANGE: string;
-	/** {zh}
-	 * @brief 音乐播放模式下切换音乐。
-	 */
-	MUSIC_CHANGE: string;
-	/** {zh}
-	 * @brief 音乐播放列表发生变化。
-	 */
-	MUSIC_LIST_CHANGE: string;
-	/** {zh}
-	 * @brief 自动播放成功。
-	 */
-	AUTOPLAY_SUCCESS: string;
-	/** {zh}
-	 * @brief 自动播放失败。
-	 */
-	AUTOPLAY_FAILED: string;
-	/** {zh}
-	 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
-	 */
-	MENU_LOG: string;
-	/** {zh}
-	 * @brief 点击了右键菜单的反馈按钮。
-	 */
-	MENU_REPORT: string;
-	/** {zh}
-	 * @brief 播放列表更新。
-	 */
-	PLAY_LIST_CHANGE: string;
-	/** {zh}
-	 * @brief 播放列表播放项变更。
-	 */
-	PLAY_LIST_ITEM_CHANGE: string;
-	/** {zh}
-	 * @brief `playNext` 开始。
-	 */
-	PLAY_NEXT_START: string;
-	/** {zh}
-	 * @brief `playNext` 结束。
-	 */
-	PLAY_NEXT_END: string;
-	/** {zh}
-	 * @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 播放器实例创建完成时触发。
 	 */
@@ -7446,6 +7560,53 @@ export declare const Event: {
 		LICENSE_STATUS_WARNING: string;
 	};
 	PluginEvents: {
+		/** {zh}
+		 * @brief 自动播放成功。
+		 */
+		AUTOPLAY_SUCCESS: string;
+		/** {zh}
+		 * @brief 自动播放失败。
+		 */
+		AUTOPLAY_FAILED: string;
+		/** {zh}
+		 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
+		 */
+		MENU_LOG: string;
+		/** {zh}
+		 * @brief 点击了右键菜单的反馈按钮。
+		 */
+		MENU_REPORT: string;
+		/** {zh}
+		 * @brief 播放列表更新。
+		 */
+		PLAY_LIST_CHANGE: string;
+		/** {zh}
+		 * @brief 播放列表播放项变更。
+		 */
+		PLAY_LIST_ITEM_CHANGE: string;
+		/** {zh}
+		 * @brief `playNext` 开始。
+		 */
+		PLAY_NEXT_START: string;
+		/** {zh}
+		 * @brief `playNext` 结束。
+		 */
+		PLAY_NEXT_END: string;
+		/** {zh}
+		 * @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;
+		TIME_SCALE_CHANGE?: string;
+		MUSIC_MODE_CHANGE?: string;
+		MUSIC_CHANGE?: string;
+		MUSIC_LIST_CHANGE?: string;
 		/** {zh}
 		 * @brief 弹幕配置发生变化。
 		 */
@@ -7534,65 +7695,6 @@ export declare const Event: {
 		 * @brief 镜像开启。
 		 */
 		MIRROR_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放器快进或快退。
-		 */
-		TIME_SCALE_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放模式切换。
-		 */
-		MUSIC_MODE_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放模式下切换音乐。
-		 */
-		MUSIC_CHANGE: string;
-		/** {zh}
-		 * @brief 音乐播放列表发生变化。
-		 */
-		MUSIC_LIST_CHANGE: string;
-		/** {zh}
-		 * @brief 自动播放成功。
-		 */
-		AUTOPLAY_SUCCESS: string;
-		/** {zh}
-		 * @brief 自动播放失败。
-		 */
-		AUTOPLAY_FAILED: string;
-		/** {zh}
-		 * @brief 右键菜单事件。事件 `data` 中包含具体信息。
-		 */
-		MENU_LOG: string;
-		/** {zh}
-		 * @brief 点击了右键菜单的反馈按钮。
-		 */
-		MENU_REPORT: string;
-		/** {zh}
-		 * @brief 播放列表更新。
-		 */
-		PLAY_LIST_CHANGE: string;
-		/** {zh}
-		 * @brief 播放列表播放项变更。
-		 */
-		PLAY_LIST_ITEM_CHANGE: string;
-		/** {zh}
-		 * @brief `playNext` 开始。
-		 */
-		PLAY_NEXT_START: string;
-		/** {zh}
-		 * @brief `playNext` 结束。
-		 */
-		PLAY_NEXT_END: string;
-		/** {zh}
-		 * @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";