@volcengine/veplayer 1.12.0-rc.7 → 1.12.0-rc.9

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 Whether to enable barrage by default
+	 * @brief 是否展示弹幕设置面板
 	 */
 	usePanel?: boolean;
 	/**
@@ -295,13 +297,11 @@ export interface IDanmuConfig {
 	 */
 	external?: ExternalItem[];
 	/**
-	 * @brief 蒙版弹幕配置
-	 * @default -
+	 * @hidden
 	 */
 	maskConfig?: IMaskConfig;
 	/**
-	 * @brief 是否开启蒙版弹幕，即对应智能挡板开关
-	 * @default false
+	 * @hidden
 	 */
 	maskActive?: boolean;
 }
@@ -1576,11 +1576,6 @@ export interface IStartConfig {
 	 */
 	mode?: "hide" | "show" | "auto";
 }
-/**
- * @hidden
- * @brief 西瓜插件
- */
-export declare type XGPlugin = typeof Plugin | typeof BasePlugin;
 /**
  * @brief 自动播放配置。
  * @list Options
@@ -2125,9 +2120,14 @@ export declare class MemoryPlay extends Plugin {
 	getTimeByStorage(memoryId: string): string | 0;
 	destroy(): void;
 }
-export interface IVolume {
-	Loudness: number;
-	Peak: number;
+/** {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"
 }
 /** {zh}
  * @hidden
@@ -2138,7 +2138,7 @@ export interface IPlayInfoListItem {
 	BarrageMaskOffset: string;
 	Bitrate: number;
 	CheckInfo: string;
-	Codec: ICodecType;
+	Codec: CodecType;
 	Definition: string;
 	Duration: number;
 	FileId: string;
@@ -2243,62 +2243,55 @@ 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 CodecType: {
+export declare const enum CodecType {
 	/** {zh}
 	 * @brief H.264
 	 */
-	readonly H264: "h264";
+	H264 = "h264",
 	/** {zh}
 	 * @brief H.265
 	 */
-	readonly H265: "h265";
+	H265 = "h265",
 	/** {zh}
 	 * @brief H.266
 	 */
-	readonly H266: "h266";
+	H266 = "h266",
 	/** {zh}
 	 * @brief 音频 AAC，含 heaacv2
 	 */
-	readonly AAC: "aac";
+	AAC = "aac",
 	/** {zh}
 	 * @brief 音频 MP3
 	 */
-	readonly MP3: "mp3";
+	MP3 = "mp3",
 	/** {zh}
 	 * @brief 音频 OPUS
 	 */
-	readonly OPUS: "opus";
+	OPUS = "opus",
 	/** {zh}
 	 * @brief 未知编码格式
 	 */
-	readonly UNKNOWN: "unknown";
-};
-export declare type ICodecType = (typeof CodecType)[keyof typeof CodecType];
-export declare const ContentType: {
-	h265: string;
-	h264: string;
-};
-export declare enum RTMCodec {
+	UNKNOWN = "unknown"
+}
+declare enum RTMCodec {
 	H264 = "h264"
 }
-/** {zh}
- * @hidden
- * @brief 音频封装格式
- */
-export declare enum EVideoFormat {
+declare enum EVideoFormat {
 	MP4 = "mp4",
 	DASH = "dash",
 	HLS = "hls"
 }
-/** {zh}
- * @hidden
- * @brief 视频封装格式
- */
-export declare enum EAudioFormat {
+declare enum EAudioFormat {
 	M4A = "m4a",
 	MP4 = "mp4",
 	MP3 = "mp3",
@@ -2306,45 +2299,6 @@ export 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'`：中国内地
@@ -2540,7 +2494,7 @@ export interface Stream extends Partial<IPlayInfoListItem> {
 	 * @brief 编码格式
 	 * @default unknown
 	 */
-	codec?: ICodecType;
+	codec?: CodecType;
 	/** {zh}
 	 * @brief 线路唯一 ID
 	 */
@@ -2586,20 +2540,6 @@ 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
 	 */
@@ -2643,6 +2583,21 @@ 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 -
@@ -2717,24 +2672,6 @@ 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`
@@ -2874,7 +2811,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @listtip - 在已知视频编码方式的情况下推荐传入，以便日志分析。
 	 *          - 在 `useSoftDecoding` 参数为 `true`（开启 H.265 兼容降级模式）时，建议传入，可提升软解初始效率。
 	 */
-	codec?: ICodecType;
+	codec?: `${CodecType}`;
 	/** {zh}
 	 * @brief 点播服务所在区域，影响服务接口和日志上报
 	 * @default cn
@@ -3593,27 +3530,6 @@ 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 插件按钮位置
  */
@@ -3660,7 +3576,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;
 }
@@ -3889,11 +3805,6 @@ export interface IThumbnailConfig {
 	 */
 	hidePortrait?: false;
 }
-export interface ISourceConfig {
-	url?: string;
-	playList?: Stream[];
-	getVideByToken?: IPlayAuthTokenConfig;
-}
 /**
  * @brief api map
  * @hidden
@@ -4242,166 +4153,6 @@ 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
  */
@@ -4443,8 +4194,6 @@ 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;
@@ -4460,7 +4209,7 @@ declare class PlayerData {
 	openSoftDecoding: boolean;
 	defaultConfig: IDefaultConfig | undefined;
 	isHitDefault: boolean;
-	codec?: ICodecType;
+	codec?: `${CodecType}`;
 	enableH265Degrade: boolean;
 	languageData: {
 		extraLangList: IXGI18nText[];
@@ -4491,25 +4240,12 @@ declare class PlayerData {
 	};
 	private isAutoBitrateEnable;
 	adapter: AbstractBaseAdapter;
-	/**
-	 * @breif 是否vid模式的加密播放
-	 */
-	isVidEncrypt: boolean;
+	isBusinessDrm: boolean;
+	isEncrypt: boolean;
 	dashOpts: {
 		Data: IGetPlayInfoRes;
 	};
-	/**
-	 * @brief 播放器sdk实例
-	 */
 	sdk: VePlayer;
-	/**
-	 * @brief 当前加密播放类型，为空则表示非加密
-	 */
-	drmType: EDRMTYPE;
-	/**
-	 * @brief 私有加密会话id
-	 */
-	encryptSessionId?: string;
 	constructor(configs: IPlayerConfig & {
 		licensSupportModuleList: string[];
 	}, sdk: VePlayer);
@@ -4526,7 +4262,6 @@ declare class PlayerData {
 		playList: Stream[];
 	};
 	isCurrentH265(): boolean;
-	setDrmType(drmType: EDRMTYPE): void;
 	getCurrentByDefaultConfig(): Stream;
 	initCurrent(currentStreams: Stream): void;
 	initCheckExpireData(): void;
@@ -4639,6 +4374,80 @@ 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;
@@ -4687,23 +4496,6 @@ 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 播放相关配置数据
@@ -4806,7 +4598,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	sdkUmdLoader: UMDLoader;
+	sdkUmdLoader: umdLoader;
 	private adapter;
 	/**
 	 * @hidden
@@ -4826,16 +4618,10 @@ 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}
@@ -4882,12 +4668,7 @@ declare class VePlayer {
 	static checkModuleList(): Promise<string[]>;
 	static checkLicenseStatus(): Promise<LicenseStatus>;
 	static checkLicenseModuleAuth(module: string, featureName: LicenseFeature): Promise<boolean>;
-	/**
-	 * @breif 生成加密混淆的数据信息
-	 * @param unionId 用户唯一id
-	 * @param streamType 私有加密视频的格式/协议，取值有：hls、mp4、dash。
-	 */
-	static generateEncryptInfo(unionId: string, streamType: "hls" | "mp4" | "dash"): Promise<EncryptInfo | undefined>;
+	private static vodLogCommon;
 	private static hasInitVeStrategy;
 	/**
 	 * @hidden
@@ -4928,18 +4709,12 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private _initCheckExpire;
-	/**
-	 * @hidden
-	 * @description 初始化umdLoader 的配置
-	 * @memberof VePlayer
-	 */
-	private initUmdLoader;
 	/**
 	 * @hidden
 	 * @description 更新umdLoader 的配置
 	 * @memberof VePlayer
 	 */
-	private updateUmdLoader;
+	private initUmdLoader;
 	/**
 	 * @hidden
 	 * @private
@@ -5286,7 +5061,7 @@ declare class VePlayer {
 	getSoftDecodingOption(isOpenSoftDecoding: boolean, url: string, type: string): Promise<{
 		mediaType?: string;
 		innerDegrade?: number;
-		codecType?: ICodecType;
+		codecType?: `${CodecType}`;
 		plugins?: any[];
 	}>;
 	/** {zh}
@@ -5757,6 +5532,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(): {
@@ -5954,6 +5782,54 @@ 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 弹幕配置发生变化。