@volcengine/veplayer 1.12.0 → 1.13.0-rc.0

package/index.d.ts

@@ -6,6 +6,8 @@ import VodLogger from '@byted/xgplayer-app-logger/es/logger';
 import EventEmitter from 'eventemitter3';
 import Player from 'xgplayer';
 import { BasePlugin, I18N, IXGI18nText, Plugin } from 'xgplayer';
+import XGAdsPlugin from 'xgplayer-ads';
+import { AdsPluginConfig } from 'xgplayer-ads/es/plugin';
 import { IUrl } from 'xgplayer/es/defaultConfig';
 
 /**
@@ -258,14 +260,14 @@ export interface IDanmuConfig {
 	 */
 	fontSize?: number;
 	/**
-	 * @brief 是否打开面板。取值如下：
+	 * @brief 是否默认开启弹幕。取值如下：
 	 *
-	 *        - `false`：关闭面板。
-	 *        - `true`：打开面板。
+	 *        - `false`：关闭。
+	 *        - `true`：开启。
 	 * @default false
 	 */
 	/** {en}
-	 * @brief 是否打开面板
+	 * @brief 是否默认开启弹幕
 	 */
 	active?: boolean;
 	/**
@@ -277,7 +279,7 @@ export interface IDanmuConfig {
 	 * @hidden
 	 */
 	/** {en}
-	 * @brief 是否展示弹幕设置面板
+	 * @brief Whether to enable barrage by default
 	 */
 	usePanel?: boolean;
 	/**
@@ -295,11 +297,13 @@ export interface IDanmuConfig {
 	 */
 	external?: ExternalItem[];
 	/**
-	 * @hidden
+	 * @brief 蒙版弹幕配置
+	 * @default -
 	 */
 	maskConfig?: IMaskConfig;
 	/**
-	 * @hidden
+	 * @brief 是否开启蒙版弹幕，即对应智能挡板开关
+	 * @default false
 	 */
 	maskActive?: boolean;
 }
@@ -1574,6 +1578,11 @@ export interface IStartConfig {
 	 */
 	mode?: "hide" | "show" | "auto";
 }
+/**
+ * @hidden
+ * @brief 西瓜插件
+ */
+export declare type XGPlugin = typeof Plugin | typeof BasePlugin;
 /**
  * @brief 自动播放配置。
  * @list Options
@@ -2118,14 +2127,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
@@ -2136,7 +2140,7 @@ export interface IPlayInfoListItem {
 	BarrageMaskOffset: string;
 	Bitrate: number;
 	CheckInfo: string;
-	Codec: CodecType;
+	Codec: ICodecType;
 	Definition: string;
 	Duration: number;
 	FileId: string;
@@ -2241,55 +2245,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",
@@ -2297,6 +2308,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'`：中国内地
@@ -2492,7 +2542,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @brief 编码格式
 	 * @default unknown
 	 */
-	codec?: CodecType;
+	codec?: ICodecType;
 	/** {zh}
 	 * @brief 线路唯一 ID
 	 */
@@ -2538,6 +2588,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
 	 */
@@ -2581,21 +2645,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 -
@@ -2670,6 +2719,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`
@@ -2809,7 +2876,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
 	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
-	codec?: `${CodecType}`;
+	codec?: ICodecType;
 	/** {zh}
 	 * @brief 点播服务所在区域，影响服务接口和日志上报
 	 * @default cn
@@ -3528,6 +3595,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 插件按钮位置
  */
@@ -3574,7 +3662,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;
 }
@@ -3803,6 +3891,11 @@ export interface IThumbnailConfig {
 	 */
 	hidePortrait?: false;
 }
+export interface ISourceConfig {
+	url?: string;
+	playList?: Stream[];
+	getVideByToken?: IPlayAuthTokenConfig;
+}
 /**
  * @brief api map
  * @hidden
@@ -4151,6 +4244,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
  */
@@ -4192,6 +4445,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;
@@ -4207,7 +4462,7 @@ declare class PlayerData {
 	openSoftDecoding: boolean;
 	defaultConfig: IDefaultConfig | undefined;
 	isHitDefault: boolean;
-	codec?: `${CodecType}`;
+	codec?: ICodecType;
 	enableH265Degrade: boolean;
 	languageData: {
 		extraLangList: IXGI18nText[];
@@ -4238,12 +4493,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);
@@ -4260,6 +4528,7 @@ declare class PlayerData {
 		playList: Stream[];
 	};
 	isCurrentH265(): boolean;
+	setDrmType(drmType: EDRMTYPE): void;
 	getCurrentByDefaultConfig(): Stream;
 	initCurrent(currentStreams: Stream): void;
 	initCheckExpireData(): void;
@@ -4372,80 +4641,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;
@@ -4494,6 +4689,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 播放相关配置数据
@@ -4596,7 +4808,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	sdkUmdLoader: umdLoader;
+	sdkUmdLoader: UMDLoader;
 	private adapter;
 	/**
 	 * @hidden
@@ -4616,10 +4828,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}
@@ -4666,7 +4884,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
@@ -4709,10 +4932,16 @@ declare class VePlayer {
 	private _initCheckExpire;
 	/**
 	 * @hidden
-	 * @description 更新umdLoader 的配置
+	 * @description 初始化umdLoader 的配置
 	 * @memberof VePlayer
 	 */
 	private initUmdLoader;
+	/**
+	 * @hidden
+	 * @description 更新umdLoader 的配置
+	 * @memberof VePlayer
+	 */
+	private updateUmdLoader;
 	/**
 	 * @hidden
 	 * @private
@@ -4772,7 +5001,10 @@ declare class VePlayer {
 	/** {en}
 	 * @hidden
 	 */
-	renderDom(): void;
+	renderDom({ id, root }: {
+		id: any;
+		root: any;
+	}): void;
 	/** {zh}
 	 * @hidden
 	 *
@@ -5059,7 +5291,7 @@ declare class VePlayer {
 	getSoftDecodingOption(isOpenSoftDecoding: boolean, url: string, type: string): Promise<{
 		mediaType?: string;
 		innerDegrade?: number;
-		codecType?: `${CodecType}`;
+		codecType?: ICodecType;
 		plugins?: any[];
 	}>;
 	/** {zh}
@@ -5530,6 +5762,59 @@ export declare class Subtitle extends Plugin {
 	destroy(): void;
 	render(): string;
 }
+export declare type AdRuleOffset = "pre" | "post" | `${number}:${number}:${number}`;
+export declare type AdRuleType = "linear" | "nonlinear";
+export interface AdRule {
+	offset: AdRuleOffset;
+	tag: string;
+	type: AdRuleType;
+}
+export interface AdsConfig {
+	controls?: boolean;
+	enableSCTE35?: boolean;
+	replayForSCTE35?: {
+		enable?: boolean;
+		minDurationOffset?: number;
+	};
+	adType: "ima" | "google-ima" | "ssai";
+	ima: AdsPluginConfig["ima"] & {
+		schedule?: AdRule[];
+		adTagUrlForSCTE35?: string;
+	};
+}
+export declare class AdsPlugin extends XGAdsPlugin {
+	config: AdsConfig;
+	csManager: any;
+	player: any;
+	root: any;
+	private _scte35Manager?;
+	private _ssManager?;
+	private _onPlay?;
+	private _onTimeUpdate?;
+	private _onPause?;
+	private _onError?;
+	private _onClick?;
+	static get pluginName(): string;
+	get adManager(): any;
+	afterCreate(): void;
+	afterPlayerInit(): void;
+	beforePlayerInit(): Promise<any>;
+	destroy(): void;
+	private _clearSSAIListener;
+	private _setupSSAIListener;
+	private _dispatchEvent;
+	private _init;
+	/**
+	 * Preroll广告播放完，retry重新拉流保证启播延迟
+	 */
+	/**
+	 * 如果存在midroll广告，需要将disconnectTime和maxLatency设为最大值，否则currentTime的变化会影响展示时间
+	 */
+	/**
+	 * 静音播放Preroll广告时，需要显示autoplayPlugin插件的ummute蒙层
+	 */
+	private _handlePrerollMuted;
+}
 export declare class TimeShiftPlugin extends Plugin {
 	static get pluginName(): string;
 	static get defaultConfig(): {
@@ -5727,54 +6012,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 弹幕配置发生变化。