@volcengine/veplayer 1.12.0-rc.1 → 1.12.0-rc.3

package/index.d.ts

@@ -194,6 +194,224 @@ export interface IRtmConfig {
 	 */
 	backupStreamType: "hls" | "flv";
 }
+/**
+ * @brief 弹幕配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @list Options
+ * @kind property
+ */
+export interface IDanmuConfig {
+	/**
+	 * @brief 弹幕透明度。取值如下：
+	 *
+	 *        - `0`：透明度 0。
+	 *        - `33`：透明度 33%。
+	 *        - `66`：透明度 66%。
+	 *        - `99`：透明度 100%。
+	 * @default 99
+	 */
+	/** {en}
+	 * @brief 透明度, 枚举值[0, 33, 66, 99], 实际对应0, 0.33, 0.66, 1
+	 */
+	opacity?: number;
+	/**
+	 * @brief 弹幕区域大小。取值如下：
+	 *
+	 *        - `0`：弹幕区域占全屏的 1/4。
+	 *        - `33`：弹幕区域占全屏的 1/2。
+	 *        - `66`：弹幕区域占全屏的 3/4。
+	 *        - `99`：弹幕区域占满全屏。
+	 * @default 99
+	 */
+	/** {en}
+	 * @brief 枚举值[0, 33, 66, 99] 实际对应1/4, 1/2, 3/4, 1
+	 */
+	area?: number;
+	/**
+	 * @brief 弹幕滚动速度。取值如下：
+	 *
+	 *        - `0`：弹幕速度为 1/4。
+	 *        - `20`：弹幕速度为 1/2。
+	 *        - `40`：弹幕速度为 1。
+	 *        - `60`：弹幕速度为 5/4。
+	 *        - `80`：弹幕速度为 3/2。
+	 *        - `100`：弹幕速度为 2。
+	 * @default 40
+	 */
+	/** {en}
+	 * @brief 速度, 枚举值[0, 20, 40, 60, 80, 100]， 实际对应1/4, 1/2,1,5/4,3/2,2
+	 */
+	speed?: number;
+	/**
+	 * @brief 弹幕字体大小。取值如下：
+	 *
+	 *        - `0`：字体大小为 14 px。
+	 *        - `50`：字体大小为 16 px。
+	 *        - `100`：字体大小为 20 px。
+	 * @default 50
+	 */
+	/** {en}
+	 * @brief 字体大小， 枚举值[0, 50, 100]，实际对应14px 16px 20px
+	 */
+	fontSize?: number;
+	/**
+	 * @brief 是否默认开启弹幕。取值如下：
+	 *
+	 *        - `false`：关闭。
+	 *        - `true`：开启。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief 是否默认开启弹幕
+	 */
+	active?: boolean;
+	/**
+	 * @brief 是否展示弹幕设置面板。取值如下：
+	 *
+	 *        - `false`：不展示弹幕设置面板。
+	 *        - `true`：展示弹幕设置面板。
+	 * @default true
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Whether to enable barrage by default
+	 */
+	usePanel?: boolean;
+	/**
+	 * @brief 弹幕列表。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 弹幕列表
+	 */
+	danmuItems?: DanmuItem[];
+	/**
+	 * @hidden
+	 * @type {ExternalItem[]}
+	 * @memberof IDanmuConfig
+	 */
+	external?: ExternalItem[];
+	/**
+	 * @brief 蒙版弹幕配置
+	 * @default -
+	 */
+	maskConfig?: IMaskConfig;
+	/**
+	 * @brief 是否开启蒙版弹幕，即对应智能挡板开关
+	 * @default false
+	 */
+	maskActive?: boolean;
+}
+export interface IMaskConfig {
+	maskUrl: string;
+	maskOffset?: number;
+	interval?: number;
+}
+/** {zh}
+ * @hidden
+ * @brief 语言类型
+ */
+/** {en}
+ * @hidden
+ * @brief 语言类型
+ */
+export interface Lang {
+	zh: string;
+	en: string;
+	[props: string]: string;
+}
+/** {zh}
+ * @brief 弹幕项
+ * @list Options
+ * @kind property
+ * @export
+ * @interface DanmuItem
+ */
+/** {en}
+ * @list Options
+ * @kind property
+ * @export
+ * @interface DanmuItem
+ * @brief 弹幕项
+ */
+export interface DanmuItem {
+	/**
+	 * 弹幕唯一id
+	 *
+	 * @type {string}
+	 * @memberof DanmuItem
+	 * @brief 弹幕唯一 ID。
+	 */
+	/** {en}
+	 * @brief 弹幕唯一id
+	 */
+	id: string;
+	/**
+	 * 弹幕文案
+	 *
+	 * @type {string}
+	 * @memberof DanmuItem
+	 * @brief 弹幕文案。
+	 */
+	/** {en}
+	 * @brief 弹幕文案
+	 */
+	txt: string;
+	/**
+	 * 弹幕出现时间, 单位为ms
+	 * @default 0
+	 * @brief 弹幕出现时间，单位为毫秒。
+	 */
+	/** {en}
+	 * @brief 弹幕出现时间, 单位为ms
+	 */
+	start?: number;
+	/**
+	 * 是否优先显示
+	 * @hidden
+	 * @type {boolean}
+	 * @memberof DanmuItem
+	 */
+	prior?: boolean;
+	/**
+	 * 弹幕持续显示时间, 单位为ms
+	 * @default 5000
+	 *
+	 * @type {number}
+	 * @memberof DanmuItem
+	 * @brief 弹幕持续显示时长，单位为毫秒。
+	 */
+	/** {en}
+	 * @brief 弹幕持续显示时间, 单位为ms
+	 */
+	duration?: number;
+	/**
+	 * @brief 弹幕样式。示例如下：`style : { color: '#ff9500', fontSize: '20px', padding: '2px 11px'}`
+	 * @example
+	 * ``` javascript
+	 * {
+	 *    color: '#ff9500',
+	 *    fontSize: '20px',
+	 *    padding: '2px 11px'
+	 * }
+	 *```
+	 * @type {Partial<Record<Property, string>>}
+	 * @memberof DanmuItem
+	 */
+	/** {en}
+	 * @brief 弹幕样式
+	 */
+	style?: CSSStyleDeclaration;
+}
+export interface ExternalItem {
+	key: string;
+	name: string;
+	value: boolean;
+	lang?: Lang;
+}
 /**
  * @brief 外挂字幕配置。
  * @list Options
@@ -1358,6 +1576,11 @@ export interface IStartConfig {
 	 */
 	mode?: "hide" | "show" | "auto";
 }
+/**
+ * @hidden
+ * @brief 西瓜插件
+ */
+export declare type XGPlugin = typeof Plugin | typeof BasePlugin;
 /**
  * @brief 自动播放配置。
  * @list Options
@@ -1902,14 +2125,9 @@ export declare class MemoryPlay extends Plugin {
 	getTimeByStorage(memoryId: string): string | 0;
 	destroy(): void;
 }
-/** {zh}
- * @hidden
- */
-export declare const enum EDRMTYPE {
-	DRM_ENCRYPT = "drm_encrypt",
-	PRIVATE_ENCRYPT = "private_encrypt",
-	PRIVATE_ENCRYPT_UPGRADE = "private_encrypt_upgrade",
-	STANDARD_ENCRYPT = "standard_encrypt"
+export interface IVolume {
+	Loudness: number;
+	Peak: number;
 }
 /** {zh}
  * @hidden
@@ -1920,7 +2138,7 @@ export interface IPlayInfoListItem {
 	BarrageMaskOffset: string;
 	Bitrate: number;
 	CheckInfo: string;
-	Codec: CodecType;
+	Codec: ICodecType;
 	Definition: string;
 	Duration: number;
 	FileId: string;
@@ -2025,55 +2243,62 @@ export interface IGetPlayInfoRes {
 	TotalCount: number;
 	Version: number;
 }
-/**
- * @author bytedance
- * @version 1.0
- * @Description
- * @date 2024/5/17 15:53
- */
 /** {zh}
  * @list Options
  * @brief 视频编码格式。
  */
-export declare const enum CodecType {
+export declare const CodecType: {
 	/** {zh}
 	 * @brief H.264
 	 */
-	H264 = "h264",
+	readonly H264: "h264";
 	/** {zh}
 	 * @brief H.265
 	 */
-	H265 = "h265",
+	readonly H265: "h265";
 	/** {zh}
 	 * @brief H.266
 	 */
-	H266 = "h266",
+	readonly H266: "h266";
 	/** {zh}
 	 * @brief 音频 AAC，含 heaacv2
 	 */
-	AAC = "aac",
+	readonly AAC: "aac";
 	/** {zh}
 	 * @brief 音频 MP3
 	 */
-	MP3 = "mp3",
+	readonly MP3: "mp3";
 	/** {zh}
 	 * @brief 音频 OPUS
 	 */
-	OPUS = "opus",
+	readonly OPUS: "opus";
 	/** {zh}
 	 * @brief 未知编码格式
 	 */
-	UNKNOWN = "unknown"
-}
-declare enum RTMCodec {
+	readonly UNKNOWN: "unknown";
+};
+export declare type ICodecType = (typeof CodecType)[keyof typeof CodecType];
+export declare const ContentType: {
+	h265: string;
+	h264: string;
+};
+export declare enum RTMCodec {
 	H264 = "h264"
 }
-declare enum EVideoFormat {
+/** {zh}
+ * @hidden
+ * @brief 音频封装格式
+ */
+export declare enum EVideoFormat {
 	MP4 = "mp4",
 	DASH = "dash",
 	HLS = "hls"
 }
-declare enum EAudioFormat {
+/** {zh}
+ * @hidden
+ * @brief 视频封装格式
+ */
+export declare enum EAudioFormat {
 	M4A = "m4a",
 	MP4 = "mp4",
 	MP3 = "mp3",
@@ -2081,6 +2306,45 @@ declare enum EAudioFormat {
 	HLS = "hls",
 	OGG = "ogg"
 }
+/** {zh}
+ * @brief 加密播放类型
+ */
+export declare const enum EDRMTYPE {
+	/**
+	 * @brief 商业DRM
+	 */
+	DRM_ENCRYPT = "drm_encrypt",
+	/**
+	 * @brief 旧私有加密
+	 */
+	PRIVATE_ENCRYPT = "private_encrypt",
+	/**
+	 * @brief 新私有加密
+	 */
+	PRIVATE_ENCRYPT_UPGRADE = "private_encrypt_upgrade",
+	/**
+	 * @brief HLS标准加密
+	 */
+	STANDARD_ENCRYPT = "standard_encrypt"
+}
+export interface IVideoInfo {
+	playList: Stream[];
+	vid: string;
+	defaultDefinitionData: Stream;
+	codec: ICodecType;
+	dashOpts?: {
+		Data: IGetPlayInfoRes;
+	};
+}
+export declare type TRegionConfig = {
+	__PLAY_DOMAIN__: string;
+	__BACKUP_PLAY_DOMAIN__?: string;
+	__LOG_TEA_ID__: number;
+	__LOG_CHANNEL__: TLogChannel;
+	__LOG_CUSTOM_REGION__?: string;
+	__UMD_PRE_PATH__: string;
+};
+export declare type TLogChannel = "cn" | "va" | "sg";
 /** {zh}
  * @brief 区域类型：
  *        - `'cn'`：中国内地
@@ -2276,7 +2540,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @brief 编码格式
 	 * @default unknown
 	 */
-	codec?: CodecType;
+	codec?: ICodecType;
 	/** {zh}
 	 * @brief 线路唯一 ID
 	 */
@@ -2322,6 +2586,20 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @default -
 	 */
 	urlExpireTimestamp?: number;
+	/**
+	 * @brief 视频为加密视频时的密钥KeyId，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuthId
+	 * @default -
+	 */
+	kid?: string;
+	/** {zh}
+	 * @brief 私有加密播放的加密密钥，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuth
+	 */
+	secretKey?: string;
+	/**
+	 * @brief 视频为加密视频时的加密类型
+	 * @default -
+	 */
+	drmType?: EDRMTYPE;
 	/** {zh}
 	 * @hidden
 	 */
@@ -2365,21 +2643,6 @@ export interface Current extends Partial<Stream> {
 	 * @default -
 	 */
 	lineId?: number | string;
-	/**
-	 * @brief 视频编码格式
-	 * @default unknown
-	 */
-	codec?: CodecType;
-	/**
-	 * @brief 视频为加密视频时的密钥KeyId
-	 * @default -
-	 */
-	kid?: string;
-	/**
-	 * @brief 视频为加密视频时的加密类型
-	 * @default -
-	 */
-	drmType?: EDRMTYPE;
 	/**
 	 * @brief 地址的过期时间戳，vid模式下不用输入，播放器自动获取。如果是火山引擎的CDN分发地址，在不传入过期时间戳时，则需指定urlType，支持{@link https://www.volcengine.com/docs/4/177191 A-E类型}，其他云厂商或者业务服务器存储的地址不支持。
 	 * @default -
@@ -2454,6 +2717,24 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @memberof IPlayerConfig
 	 */
 	getVideoByToken?: IPlayAuthTokenConfig;
+	/** {zh}
+	 * @brief 视频加密类型
+	 * @default -
+	 */
+	drmType?: EDRMTYPE;
+	/** {zh}
+	 * @brief 私有加密会话id
+	 */
+	encryptSessionId?: string;
+	/**
+	 * @brief 视频为加密视频时的密钥KeyId，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuthId
+	 * @default -
+	 */
+	playAuthId?: string;
+	/** {zh}
+	 * @brief 私有加密播放的加密密钥，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo} 接口返回的PlayInfoList项中的 PlayAuth
+	 */
+	playAuth?: string;
 	/** {zh}
 	 * @brief 视频格式。取值如下：
 	 *        - `mp4`
@@ -2593,7 +2874,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
 	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
-	codec?: `${CodecType}`;
+	codec?: ICodecType;
 	/** {zh}
 	 * @brief 点播服务所在区域，影响服务接口和日志上报
 	 * @default cn
@@ -3312,6 +3593,27 @@ export interface definitionItem {
 	 */
 	definitionTextKey?: string;
 }
+/** {zh}
+ * @brief 可扩展插件结构
+ */
+export interface EventPlugin {
+	pluginName: string;
+	type?: "inner" | "normal" | string;
+	position?: string;
+	icon?: string;
+	index?: number;
+	tips?: Transition;
+	hideAtFullScreen?: boolean;
+}
+/** {zh}
+ * @brief 多语言翻译结构体
+ */
+export interface Transition {
+	jp?: string;
+	en?: string;
+	zh?: string;
+	"zh-hk"?: string;
+}
 /** {zh}
  * @brief 插件按钮位置
  */
@@ -3358,7 +3660,7 @@ export declare const enum POSITIONS {
  * @brief Plugin类插件基础配置
  */
 export interface IPluginConfig {
-	position?: typeof Plugin.POSITIONS[keyof typeof Plugin.POSITIONS];
+	position?: (typeof Plugin.POSITIONS)[keyof typeof Plugin.POSITIONS];
 	index?: number;
 	disable?: boolean;
 }
@@ -3587,6 +3889,11 @@ export interface IThumbnailConfig {
 	 */
 	hidePortrait?: false;
 }
+export interface ISourceConfig {
+	url?: string;
+	playList?: Stream[];
+	getVideByToken?: IPlayAuthTokenConfig;
+}
 /**
  * @brief api map
  * @hidden
@@ -3935,6 +4242,166 @@ declare class VeStrategyWrapper {
 	private initPreloaderConfig;
 }
 declare const _default: VeStrategyWrapper;
+declare enum UmdKeys {
+	HLS = "hls",
+	FLV = "flv",
+	XGVideo = "XGVideo",
+	HLSEncrypt = "hlsEncrypt",
+	DASH = "dash",
+	MP4Encrypt = "mp4Encrypt",
+	DanmuJS = "danmujs",
+	DanmuMask = "danmuMask",
+	StreamProbe = "streamprobe",
+	VeStrategy = "vestrategy",
+	VeStrategyH265 = "vestrategy_h265",
+	VeStrategyPreload = "vestrategy_preload",
+	VeStrategyAdaptRange = "vestrategy_adapt_range",
+	DashAbralgo = "DashAbralgo",
+	Preloader = "preloader"
+}
+/**
+ * @hidden
+ * @breif umdmap 配置
+ */
+export declare type UMDMap = Record<UmdKeys, {
+	/**
+	 * umd Module 的名称，即在window下暴露的接口名称
+	 */
+	name: string;
+	/**
+	 * 对应umd文件名，只用来标记，实际不使用
+	 */
+	pluginName?: string;
+	/**
+	 * 对应npm包的名称，在打包文件时，会在libd.config.js中onPostBuild的钩子中会用于寻找对应npm包
+	 */
+	packageName: string;
+	/**
+	 * npm包中umd入口文件路径，用于打包上传到cdn目录
+	 */
+	devPath: string;
+}>;
+declare class UMDLoader {
+	private static jsLoadMap;
+	private static jsLoadPromiseMap;
+	umdMap: UMDMap;
+	backupUmdUrlMap: Record<string, string>;
+	failCallback: (umdName: string, err: any) => any;
+	region: TRegionType;
+	customPluginPublicPath: string;
+	importedPlugins: any[];
+	constructor();
+	/**
+	 * @return { string } 插件加载的公共路径
+	 */
+	get pluginPublicPath(): string;
+	/**
+	 * 更新umd的备用地址
+	 * @param {Record<string, string>} map 备用地址map
+	 */
+	updateBackupMap(map: Record<string, string>): void;
+	/**
+	 * 加载额外的js-sdk
+	 * 适用 umd 模块
+	 * 只能浏览器环境下使用
+	 * @param url 额外加载JS 的 CDN 地址
+	 * @param isJs 是否js文件
+	 */
+	loadExtraCdn(url: string, isJs?: boolean): Promise<void>;
+	/**
+	 * @description 加载xgplayer插件
+	 * @param pluginName 插件名称
+	 * @param successCallback 加载完成后执行的回调
+	 * @return Promise<any>
+	 */
+	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
+}
+export declare class SdkPlugin {
+	pluginName: string;
+	__args: any;
+	sdk: VePlayer;
+	playerData: PlayerData;
+	player: Player;
+	_emitter: EventEmitter;
+	static defineGetterOrSetter(Obj: any, map: any): void;
+	/**
+	 * @type { string }
+	 */
+	static get pluginName(): string;
+	/**
+	 * @constructor
+	 * @param { { sdk: object, pluginName: string, [propName: string]: any;}  } args
+	 */
+	constructor(args: any);
+	/**
+	 * @description sdk实例创建，挂载插件实例时首先执行
+	 */
+	beforeCreate(): void;
+	/**
+	 * @description sdk实例创建，挂载插件实例完后执行
+	 */
+	afterCreate(): void;
+	/**
+	 * @description sdk创建播放器前执行，只有这里能保证异步操作在creatPlayer之前同步完成
+	 */
+	beforePlayerCreate(): void;
+	/**
+	 * @description sdk创建播放器完执行
+	 */
+	afterPlayerCreate(): void;
+	/**
+	 * @description sdk销毁时执行
+	 */
+	destroy(): void;
+	/**
+	 * @private
+	 * @param { any } args
+	 */
+	__init(args: any): void;
+	/**
+	 * @description 插件销毁
+	 * @private
+	 */
+	__destroy(): void;
+}
+declare class AuthToken extends SdkPlugin {
+	static get pluginName(): string;
+	isPlayByToken: boolean;
+	isEncrypt: boolean;
+	tokenInfo: ITokenInfo;
+	keyTokenInfo: ITokenInfo;
+	thirdPartyDrmAuthTokenInfo: ITokenInfo;
+	config: IPlayAuthTokenConfig;
+	privateDrmAuthToken: string;
+	useUnionInfoDRM: boolean;
+	sessionId: string;
+	retryCount: number;
+	playInfo?: VideoInfoRes;
+	constructor(args: any);
+	beforePlayerCreate(): Promise<void>;
+	getVideoInfo(): Promise<{
+		vid: string;
+		playList: Stream[];
+		codec: ICodecType;
+		defaultDefinition: string;
+	}>;
+	getVideos(): Promise<any>;
+	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
+	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
+	getBarrageMaskUrl(url: string): void;
+	getDrmConfig(videoInfo: IVideoInfo): void;
+	init(): void;
+	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
+	/**
+	 * @description 更新playAuthToken
+	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
+	 * @param {boolean} isNewVideo 是否新视频，即是否为切换视频
+	 */
+	updateAuthToken(getVideoByToken: IPlayAuthTokenConfig, isNewVideo: boolean): Promise<void>;
+	checkPlayAuthTokenValid(): boolean;
+	checkKeyTokenValid(): boolean;
+	checkDrmAuthTokenValid(): boolean;
+}
 /** {zh}
  * @hidden
  */
@@ -3976,6 +4443,8 @@ declare abstract class AbstractBaseAdapter {
 	abstract adaptRangeDefaultOptions(): IAdaptRangeDefaultOptions | undefined;
 	abstract applyAdaptRangePluginConfig(_finalOptions: any, _adaptRangeOptions: any): void;
 	abstract applyAdaptRangeStrategy(_finalOptions: any, _adaptRangeOptions: any): void;
+	abstract getPlugins(umdLoader: UMDLoader): Promise<XGPlugin[]>;
+	abstract setPluginConfigInVid(videoInfo: IVideoInfo, context: AuthToken): void;
 }
 declare class PlayerData {
 	id?: string;
@@ -3991,7 +4460,7 @@ declare class PlayerData {
 	openSoftDecoding: boolean;
 	defaultConfig: IDefaultConfig | undefined;
 	isHitDefault: boolean;
-	codec?: `${CodecType}`;
+	codec?: ICodecType;
 	enableH265Degrade: boolean;
 	languageData: {
 		extraLangList: IXGI18nText[];
@@ -4022,12 +4491,25 @@ declare class PlayerData {
 	};
 	private isAutoBitrateEnable;
 	adapter: AbstractBaseAdapter;
-	isBusinessDrm: boolean;
-	isEncrypt: boolean;
+	/**
+	 * @breif 是否vid模式的加密播放
+	 */
+	isVidEncrypt: boolean;
 	dashOpts: {
 		Data: IGetPlayInfoRes;
 	};
+	/**
+	 * @brief 播放器sdk实例
+	 */
 	sdk: VePlayer;
+	/**
+	 * @brief 当前加密播放类型，为空则表示非加密
+	 */
+	drmType?: EDRMTYPE;
+	/**
+	 * @brief 私有加密会话id
+	 */
+	encryptSessionId?: string;
 	constructor(configs: IPlayerConfig & {
 		licensSupportModuleList: string[];
 	}, sdk: VePlayer);
@@ -4044,6 +4526,7 @@ declare class PlayerData {
 		playList: Stream[];
 	};
 	isCurrentH265(): boolean;
+	setDrmType(drmType: EDRMTYPE): void;
 	getCurrentByDefaultConfig(): Stream;
 	initCurrent(currentStreams: Stream): void;
 	initCheckExpireData(): void;
@@ -4156,80 +4639,6 @@ declare class MobilePlayerPanel {
 	bind(event: string, eventHandle: any, isBubble?: boolean): void;
 	destroy(): void;
 }
-declare enum UmdKeys {
-	HLS = "hls",
-	FLV = "flv",
-	XGVideo = "XGVideo",
-	HLSEncrypt = "hlsEncrypt",
-	DASH = "dash",
-	MP4Encrypt = "mp4Encrypt",
-	DanmuJS = "danmujs",
-	DanmuMask = "danmuMask",
-	StreamProbe = "streamprobe",
-	VeStrategy = "vestrategy",
-	VeStrategyH265 = "vestrategy_h265",
-	VeStrategyPreload = "vestrategy_preload",
-	VeStrategyAdaptRange = "vestrategy_adapt_range",
-	DashAbralgo = "DashAbralgo",
-	Preloader = "preloader"
-}
-/**
- * @hidden
- * @breif umdmap 配置
- */
-export declare type UMDMap = Record<UmdKeys, {
-	/**
-	 * umd Module 的名称，即在window下暴露的接口名称
-	 */
-	name: string;
-	/**
-	 * 对应umd文件名，只用来标记，实际不使用
-	 */
-	pluginName?: string;
-	/**
-	 * 对应npm包的名称，在打包文件时，会在libd.config.js中onPostBuild的钩子中会用于寻找对应npm包
-	 */
-	packageName: string;
-	/**
-	 * npm包中umd入口文件路径，用于打包上传到cdn目录
-	 */
-	devPath: string;
-}>;
-declare class umdLoader {
-	private static jsLoadMap;
-	private static jsLoadPromiseMap;
-	umdMap: UMDMap;
-	backupUmdUrlMap: Record<string, string>;
-	failCallback: (umdName: string, err: any) => any;
-	region: TRegionType;
-	customPluginPublicPath: string;
-	importedPlugins: any[];
-	constructor();
-	/**
-	 * @return { string } 插件加载的公共路径
-	 */
-	get pluginPublicPath(): string;
-	/**
-	 * 更新umd的备用地址
-	 * @param {Record<string, string>} map 备用地址map
-	 */
-	updateBackupMap(map: Record<string, string>): void;
-	/**
-	 * 加载额外的js-sdk
-	 * 适用 umd 模块
-	 * 只能浏览器环境下使用
-	 * @param url 额外加载JS 的 CDN 地址
-	 * @param isJs 是否js文件
-	 */
-	loadExtraCdn(url: string, isJs?: boolean): Promise<void>;
-	/**
-	 * @description 加载xgplayer插件
-	 * @param pluginName 插件名称
-	 * @param successCallback 加载完成后执行的回调
-	 * @return Promise<any>
-	 */
-	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
-}
 export interface IlicenseContent {
 	content: string;
 	sign: string;
@@ -4278,6 +4687,23 @@ export declare type PlayerCore = Player & {
 		licenseType: LicenseEdition;
 	};
 };
+/**
+ * @brief 加密混淆信息
+ */
+export interface EncryptInfo {
+	/**
+	 * @breif 会话ID
+	 */
+	sessionId: string;
+	/**
+	 * @brief 混淆后的公钥
+	 */
+	drmKeK: string;
+	/**
+	 * @breif 唯一身份信息
+	 */
+	unionInfo: string;
+}
 declare class VePlayer {
 	/** {zh}
 	 * @brief 播放相关配置数据
@@ -4380,7 +4806,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	sdkUmdLoader: umdLoader;
+	sdkUmdLoader: UMDLoader;
 	private adapter;
 	/**
 	 * @hidden
@@ -4400,10 +4826,16 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	static sdkVersion: string;
+	/**
+	 * @hidden
+	 * @private 私有加密会话id
+	 */
+	private static privateEncryptSessionId;
 	/**
 	 * @hidden
 	 */
 	private veErrorIns;
+	private vodLogCommon;
 	/** {zh}
 	 * @brief 播放策略预初始化配置
 	 * @param options 初始化配置，详情见{@link StrategyInitOptions}
@@ -4450,7 +4882,12 @@ declare class VePlayer {
 	static checkModuleList(): Promise<string[]>;
 	static checkLicenseStatus(): Promise<LicenseStatus>;
 	static checkLicenseModuleAuth(module: string, featureName: LicenseFeature): Promise<boolean>;
-	private static vodLogCommon;
+	/**
+	 * @breif 生成加密混淆的数据信息
+	 * @param unionId 用户唯一id
+	 * @param streamType 私有加密视频的格式/协议，取值有：hls、mp4、dash。
+	 */
+	static generateEncryptInfo(unionId: string, streamType: "hls" | "mp4" | "dash"): Promise<EncryptInfo | undefined>;
 	private static hasInitVeStrategy;
 	/**
 	 * @hidden
@@ -4493,10 +4930,16 @@ declare class VePlayer {
 	private _initCheckExpire;
 	/**
 	 * @hidden
-	 * @description 更新umdLoader 的配置
+	 * @description 初始化umdLoader 的配置
 	 * @memberof VePlayer
 	 */
 	private initUmdLoader;
+	/**
+	 * @hidden
+	 * @description 更新umdLoader 的配置
+	 * @memberof VePlayer
+	 */
+	private updateUmdLoader;
 	/**
 	 * @hidden
 	 * @private
@@ -4843,7 +5286,7 @@ declare class VePlayer {
 	getSoftDecodingOption(isOpenSoftDecoding: boolean, url: string, type: string): Promise<{
 		mediaType?: string;
 		innerDegrade?: number;
-		codecType?: `${CodecType}`;
+		codecType?: ICodecType;
 		plugins?: any[];
 	}>;
 	/** {zh}
@@ -5511,54 +5954,6 @@ export declare class LiveInfoPanel extends Plugin {
 	close(): void;
 	render(): string;
 }
-export declare class SdkPlugin {
-	pluginName: string;
-	__args: any;
-	sdk: VePlayer;
-	playerData: PlayerData;
-	player: Player;
-	_emitter: EventEmitter;
-	static defineGetterOrSetter(Obj: any, map: any): void;
-	/**
-	 * @type { string }
-	 */
-	static get pluginName(): string;
-	/**
-	 * @constructor
-	 * @param { { sdk: object, pluginName: string, [propName: string]: any;}  } args
-	 */
-	constructor(args: any);
-	/**
-	 * @description sdk实例创建，挂载插件实例时首先执行
-	 */
-	beforeCreate(): void;
-	/**
-	 * @description sdk实例创建，挂载插件实例完后执行
-	 */
-	afterCreate(): void;
-	/**
-	 * @description sdk创建播放器前执行，只有这里能保证异步操作在creatPlayer之前同步完成
-	 */
-	beforePlayerCreate(): void;
-	/**
-	 * @description sdk创建播放器完执行
-	 */
-	afterPlayerCreate(): void;
-	/**
-	 * @description sdk销毁时执行
-	 */
-	destroy(): void;
-	/**
-	 * @private
-	 * @param { any } args
-	 */
-	__init(args: any): void;
-	/**
-	 * @description 插件销毁
-	 * @private
-	 */
-	__destroy(): void;
-}
 export declare const Events: {
 	/** {zh}
 	 * @brief 弹幕配置发生变化。