@volcengine/veplayer 1.4.1 → 1.5.9

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Property } from 'dom-helpers/esm/types';
+import Player from 'xgplayer';
 import { I18N, IPlayerOptions, IXGI18nText, Plugin } from 'xgplayer';
 
 declare enum POSITIONS {
@@ -330,6 +331,27 @@ export interface ISubtitleConfig {
 	 * @memberof ISubtitleConfig
 	 */
 	isDefaultOpen?: boolean;
+	/**
+	 * 是否显示图标
+	 * 默认值：true
+	 * @type {boolean}
+	 * @memberof ISubtitleConfig
+	 */
+	isShowIcon?: boolean;
+	/**
+	 * 字幕渲染模式，外挂字幕或原生字幕
+	 * 默认值：external
+	 * @type {string}
+	 * @memberof ISubtitleConfig
+	 */
+	mode?: "external" | "native";
+	/**
+	 * 字幕更新模式，默认vod
+	 * 默认值：vod
+	 * @type {string}
+	 * @memberof ISubtitleConfig
+	 */
+	updateMode?: "vod" | "live";
 	/**
 	 * 字幕样式
 	 * 默认值：无
@@ -609,6 +631,12 @@ export interface IDefinitionDemotePlugin {
 	 */
 	demotePriority?: string[];
 }
+/**
+ * @detail Options
+ * @brief 更多options
+ * @id 2
+ *
+
 /**
  * dash播放配置想
  *
@@ -943,10 +971,114 @@ export interface IMp4EncryptPlayerConfig {
 		};
 	};
 }
+declare enum PlatformEnum {
+	VOLC_ENGINE = "volcengine",
+	BYTE_PLUS = "byteplus"
+}
+export interface apiMapItem {
+	playDomain: string;
+	backupPlayDomain?: string;
+	licenseUrl: string;
+	keyDomain: string;
+}
 declare enum CodecType {
 	H265 = "h265",
 	H264 = "h264"
 }
+export declare type PLAY_MODE_TYPE = "order" | "sloop" | "loop" | "random";
+export interface IMusicListItem {
+	/**
+	 * 音乐地址
+	 *
+	 * @type {string}
+	 * @memberof IMusicListItem
+	 */
+	src: string;
+	/**
+	 * 音乐唯一vid
+	 *
+	 * @type {string | number}
+	 * @memberof IMusicListItem
+	 */
+	vid: string | number;
+	/**
+	 * 音乐封面
+	 *
+	 * @type {string}
+	 * @memberof IMusicListItem
+	 */
+	poster?: string;
+	/**
+	 * 音乐标题
+	 *
+	 * @type {string}
+	 * @memberof IMusicListItem
+	 */
+	title?: string;
+	[propName: string]: any;
+}
+export interface IABCycle {
+	/**
+	 * AB循环段开始时间
+	 *
+	 * @type {boolean}
+	 * @memberof IABCycle
+	 */
+	start: number;
+	/**
+	 * AB循环段结束时间
+	 *
+	 * @type {boolean}
+	 * @memberof IABCycle
+	 */
+	end: number;
+	/**
+	 * AB段是否循环播放
+	 *
+	 * @type {boolean}
+	 * @memberof IABCycle
+	 */
+	loop?: boolean;
+	[propName: string]: any;
+}
+export interface IMusicConfig {
+	/**
+	 * 是否启用离线下载播放
+	 *
+	 * @type {boolean}
+	 * @memberof IMusicConfig
+	 */
+	offline?: boolean;
+	/**
+	 * AB循环设置
+	 *
+	 * @type {IABCycle}
+	 * @memberof IMusicConfig
+	 */
+	abCycle?: IABCycle | null;
+	/**
+	 * 快进快退时间跨度
+	 *
+	 * @type {number}
+	 * @memberof IMusicConfig
+	 */
+	timeScale?: number;
+	/**
+	 * 循环模式
+	 *
+	 * @type {('order' | 'sloop' | 'loop' | 'random')}
+	 * @memberof IMusicConfig
+	 */
+	mode?: PLAY_MODE_TYPE;
+	/**
+	 * 播放列表
+	 *
+	 * @type {Array<IMusicListItem>}
+	 * @memberof IMusicConfig
+	 */
+	list?: Array<IMusicListItem>;
+	[propName: string]: any;
+}
 /**
  * @detail Options
  * @brief 播放地址列表， 可配置多线路和多清晰度
@@ -1045,19 +1177,12 @@ export interface Current {
  * 本文档是介绍火山引擎直播和点播播放器VePlayer的相关参数和Api。
  */
 export interface IPlayerConfig extends IPlayerOptions {
-	/**
-	 * “点播”还是“直播”
-	 * @hidden
-	 * @type {('live' | 'vod')}
-	 * @memberof IPlayerConfig
-	 */
-	type: "live" | "vod";
 	/**
 	 * 是否是直播，默认为false
 	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
-	isLive: boolean;
+	isLive?: boolean;
 	/**
 	 * 播放器容器id，VePlayer将被插入在该容器中
 	 *
@@ -1074,14 +1199,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	root?: HTMLElement;
 	/**
-	 * @hidden
-	 *
-	 * @type {IPlayerOptions}
-	 * @memberof IPlayerConfig
-	 */
-	options: IPlayerOptions;
-	/**
-	 * 播放地址，
+	 * 播放地址
 	 * 直播可通过 {@link https://console.volcengine.com/live/main/locationGenerate 视频直播控制台} 生成
 	 *
 	 * @type {string}
@@ -1092,24 +1210,45 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * 播放地址类型，可以选值为“rtm”/“flv”/“mp4”/“hls”
 	 * @notes 播放地址带后缀的则streamType非必填，否则为必填
 	 *
-	 * @type {('rtm' | 'flv' | 'mp4' | 'hls')}
+	 * @type {(''mp4' | 'hls' | 'dash' | 'rtm' | 'flv')}
+	 * @memberof IPlayerConfig
+	 */
+	streamType?: "mp4" | "hls" | "dash" | "rtm" | "flv";
+	/**
+	 * 点播服务平台，可选值为'volcengine' 和 'byteplus'，默认为'volcengine'即火山引擎视频点播
+	 * 设定此参数会指定默认的服务接口
+	 * @type {('volcengine' | 'byteplus')}
+	 * @memberof playerConfig
+	 */
+	platform?: PlatformEnum;
+	/**
+	 * 是否音乐播放器模式
+	 *
+	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
-	streamType?: "rtm" | "flv" | "mp4" | "hls";
+	isMusic?: boolean;
 	/**
 	 * 右键是否可用
 	 *
 	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
-	enableContextmenu: boolean;
+	enableContextmenu?: boolean;
 	/**
 	 * 关闭video上的阻止事件传播
 	 *
 	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
-	closeVideoStopPropagation: boolean;
+	closeVideoStopPropagation?: boolean;
+	/**
+	 * 是否开启hls的MSE模式，仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
+	 *
+	 * @type {boolean}
+	 * @memberof IPlayerConfig
+	 */
+	enableHlsMSE?: boolean;
 	/**
 	 * 是否开启mp4的MSE模式，开启后采用MSE方式播放MP4，
 	 * 同时带来精确的seek加载、视频的无缝切换、流量节省等功能
@@ -1117,7 +1256,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @type {boolean}
 	 * @memberof IPlayerConfig
 	 */
-	enableMp4MSE: boolean;
+	enableMp4MSE?: boolean;
 	/**
 	 * 播放列表
 	 * @notes url和playList必填一个，二者都传入时， url必须在playList中。
@@ -1144,7 +1283,6 @@ export interface IPlayerConfig extends IPlayerOptions {
 	defaultConfig?: IDefaultConfig;
 	/**
 	 * 设置多语言词典，可设置每个语言的多语言词典，
-	 * TODO: 这里需要补充当前默认的有哪些，还有如何替换和新增多语言
 	 * 例如:
 	 * {
 	 *    zh: {
@@ -1155,11 +1293,11 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 *    }
 	 * }
 	 *
-	 * @type {{ [key: string]: Object }}
+	 * @type {{ [key: string]: Record<string, any> }}
 	 * @memberof IPlayerConfig
 	 */
 	languages?: {
-		[key: string]: Object;
+		[key: string]: Record<string, any>;
 	};
 	/**
 	 * @hidden
@@ -1176,7 +1314,6 @@ export interface IPlayerConfig extends IPlayerOptions {
 	umdUrlMap?: Record<string, string>;
 	/**
 	 * 是否启用软解
-	 * @notes 关于软解的一些性能说明参考 https://v3.h5player.bytedance.net/en/plugins/extension/xgplayer-livevideo.html#%E8%BD%AF%E8%A7%A3%E6%A8%A1%E5%9D%97-%E7%94%A8%E4%BA%8E%E6%92%AD%E6%94%BE265%E6%B5%81-hls%E3%80%81flv-%E6%88%96h5%E4%B8%8B%E9%98%B2%E5%8A%AB%E6%8C%81%E6%92%AD%E6%94%BEhls%E3%80%81flv%E6%B5%81-%E5%8F%AF%E4%BB%A5%E4%B8%8Exgplayer-hls%E3%80%81xgplayer-flv%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8
 	 * 默认: false
 	 *
 	 * @type {boolean}
@@ -1244,10 +1381,10 @@ export interface IPlayerConfig extends IPlayerOptions {
 	/**
 	 * 弹幕及面板配置，可配置弹幕的一些参数，如弹幕文字大小、透明度、展示区域等，
 	 *
-	 * @type {InitConfig}
+	 * @type {InitConfig | boolean}
 	 * @memberof IPlayerConfig
 	 */
-	DanmuPlugin?: InitConfig;
+	DanmuPlugin?: InitConfig | boolean;
 	/**
 	 * 清晰度自动降级配置
 	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [window.VePlayer.DefinitionDemotePlugin]
@@ -1256,9 +1393,16 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @memberof IPlayerConfig
 	 */
 	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
+	/**
+	 * 唯一id，用于私有DRM加密
+	 *
+	 * @type {string}
+	 * @memberof IPlayerConfig
+	 */
+	unionId?: string;
 	/**
 	 * vid播放配置项
-	 * @notes 需要业务方AppServer通过vid生成临时playAuthToken
+	 * @notes 需要业务方服务端通过vid生成临时playAuthToken
 	 *
 	 * @type {IPlayAuthTokenConfig}
 	 * @memberof IPlayerConfig
@@ -1266,28 +1410,28 @@ export interface IPlayerConfig extends IPlayerOptions {
 	getVideoByToken?: IPlayAuthTokenConfig;
 	/**
 	 * dash 播放配置项
-	 * @type {IDashPluginConfig}
+	 * @type {Partial<IDashPluginConfig>}
 	 * @memberof IPlayerConfig
 	 */
-	DASHPlugin?: IDashPluginConfig;
+	DASHPlugin?: Partial<IDashPluginConfig>;
 	/**
 	 * hls 加密播放配置项
-	 * @type {IEncryptHlsPluginConfig}
+	 * @type {Partial<IEncryptHlsPluginConfig> | boolean}
 	 * @memberof IPlayerConfig
 	 */
-	EncryptHlsPlugin?: IEncryptHlsPluginConfig;
+	EncryptHlsPlugin?: Partial<IEncryptHlsPluginConfig> | boolean;
 	/**
 	 * 质量日志配置项
-	 * @type {IVodLogOptsConfig}
+	 * @type {Partial<IVodLogOptsConfig>}
 	 * @memberof IPlayerConfig
 	 */
-	vodLogOpts?: IVodLogOptsConfig;
+	vodLogOpts?: Partial<IVodLogOptsConfig>;
 	/**
 	 * mp4加密播放配置项
-	 * @type {IMp4EncryptPlayerConfig}
+	 * @type {Partial<IMp4EncryptPlayerConfig> | boolean}
 	 * @memberof IPlayerConfig
 	 */
-	Mp4EncryptPlayer?: IMp4EncryptPlayerConfig;
+	Mp4EncryptPlayer?: Partial<IMp4EncryptPlayerConfig> | boolean;
 	/**
 	 * 自适应码率配置项
 	 * @type {IAutoBitrateOptsConfig}
@@ -1305,7 +1449,13 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @type {IMemoryPlayConfig}
 	 * @memberof IPlayerConfig
 	 */
-	MemoryPlay?: IMemoryPlayConfig;
+	MemoryPlay?: IMemoryPlayConfig | boolean;
+	/**
+	 * 音乐播放器配置项
+	 * @type {IMusicConfig}
+	 * @memberof IPlayerConfig
+	 */
+	music?: IMusicConfig;
 }
 /**
  * 初始配置
@@ -1396,23 +1546,29 @@ export interface IPlayAuthTokenConfig {
 	 */
 	playDomain?: string;
 	/**
-	 * 是否启用控制台设置的封面图
+	 * 是否启用控制台设置的封面图，默认false
 	 * @type {boolean}
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	needPoster?: boolean;
 	/**
-	 * 是否启用控制台设置的雪碧图
+	 * 是否启用控制台设置的雪碧图，默认false
 	 * @type {boolean}
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	needThumbs?: boolean;
 	/**
-	 * 是否启用控制台设置的蒙版弹幕
+	 * 是否启用控制台设置的蒙版弹幕，默认false
 	 * @type {boolean}
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	needBarrageMask?: boolean;
+	/**
+	 * 是否需要多清晰度，默认为true
+	 * @type {boolean}
+	 * @memberof IPlayAuthTokenConfig
+	 */
+	needDefinitionList?: boolean;
 	/**
 	 * hls标准加密播放所用的keyToken
 	 * @type {boolean}
@@ -1421,18 +1577,31 @@ export interface IPlayAuthTokenConfig {
 	keyToken?: string;
 	/**
 	 * 密钥请求域名
-	 * @hidden
 	 * @type {string}
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	keyDomain?: string;
 	/**
 	 * 获取key方式，默认'TOP'
-	 * @hidden
 	 * @type {string}
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	getKeyType?: string;
+	/**
+	 * 获取privateDrmAuthToken的回调，
+	 * @type {(
+	 *     playAuthIds: string,
+	 *     vid: string,
+	 *     unionInfo: string,
+	 *   ) => Promise<Record<string, string>>}
+	 * @memberof IPlayAuthTokenConfig
+	 */
+	getDrmAuthToken?: (playAuthIds: string, vid: string, unionInfo: string) => Promise<string>;
+	/**
+	 * 是否禁用DRM解密播放降级，默认false
+	 * @type {boolean}
+	 */
+	disDrmDegraded?: boolean;
 	/**
 	 * 可携带aid等透传参数，如
 	 * {aid: 1234}，以playAuthToken下发的参数的优先级最高。
@@ -1456,8 +1625,8 @@ export interface IPlayAuthTokenConfig {
 	 * ``` javascript
 	 * {
 	 * '480p': {
-	 *   definition: 'hd',
-	 *   definitionTextKey: 'HD'
+	 *   definition: 'hd', // 清晰度兜底文案
+	 *   definitionTextKey: 'HD' // 多语言文案key
 	 *  },
 	 * '720p': {
 	 *   definition: 'uhd',
@@ -1470,6 +1639,12 @@ export interface IPlayAuthTokenConfig {
 	 * @memberof IPlayAuthTokenConfig
 	 */
 	definitionMap?: Record<string, string | definitionItem>;
+	/**
+	 * 服务502错误时重试次数,默认为1
+	 * @type {number}
+	 * @memberof IPlayAuthTokenConfig
+	 */
+	retryCount?: number;
 }
 /**
  * 清晰度定义
@@ -1598,6 +1773,11 @@ declare class PlayerData {
 	expireDetectType: Array<"xhrStatus" | "urlExpire" | "getUrlTime">;
 	onMediaExpired: () => Promise<IPlayerConfig>;
 	onTokenExpired: () => Promise<IPlayAuthTokenConfig>;
+	platform: PlatformEnum;
+	apiMap: apiMapItem;
+	unionId?: string;
+	unionInfo?: string;
+	isMusic?: boolean;
 	constructor(configs: IPlayerConfig);
 	initPlayData(configs: any): void;
 	initPlaylistAndGetCurrent(configs: IPlayerConfig): any;
@@ -1645,6 +1825,38 @@ declare class PlayerData {
 	 */
 	getNextDefinition(isDown: boolean, demotePriority: any): Stream[];
 }
+declare function isMSESupport(mime?: string): boolean;
+export interface IConfig {
+	mode?: number;
+	isAutoChange?: boolean;
+}
+declare class MobilePlayerPanel {
+	config: IConfig;
+	parent: HTMLElement;
+	root: any;
+	mode: number;
+	isAutoChange: number;
+	player: any;
+	children: HTMLElement | undefined;
+	container: HTMLElement | undefined;
+	title: HTMLElement | undefined;
+	isShow: boolean;
+	constructor(args: any);
+	initEvents(): void;
+	handleOrientationChange(): void;
+	changeConfig(config: IConfig): void;
+	changeMode(mode: number): void;
+	renderPanel(): void;
+	showPanel(children: HTMLElement, title?: string, isItemList?: boolean): Promise<void>;
+	updatePanel(children: HTMLElement): void;
+	setTitle(title: any): void;
+	renderTitle(title: any): HTMLElement;
+	show(): void;
+	hide(): void;
+	handleHide(e: any): void;
+	bind(event: string, eventHandle: any, isBubble?: boolean): void;
+	destroy(): void;
+}
 declare class VePlayer {
 	/**
 	 * 播放相关配置数据
@@ -1655,12 +1867,18 @@ declare class VePlayer {
 	 */
 	playerData: PlayerData;
 	/**
-	 * xgplayer实例
-	 * @hidden
+	 * 播放器内核实例
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	player: any;
+	player: Player & {
+		changePluginsIcon?: (name: any, isShow: any) => void;
+		playerData?: PlayerData;
+		playerType?: string;
+		playerVersion?: string;
+		panel?: MobilePlayerPanel;
+		emitExpireTimestamp?: number;
+	};
 	/**
 	 * @hidden
 	 *
@@ -1744,7 +1962,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	private delayError;
+	delayError: any[];
 	private isFirstEmitted;
 	/**
 	 * @hidden
@@ -1753,6 +1971,9 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	private sdkUmdLoader;
+	static isMSESupported: typeof isMSESupport;
+	static isRTMSupported: typeof import("@byted/xgplayer-rts").RtsPlugin.isSupported;
+	static playerVersion: string;
 	constructor(configs: IPlayerConfig);
 	/**
 	 *
@@ -1855,16 +2076,22 @@ declare class VePlayer {
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
-	createPlayer(): Promise<any>;
+	createPlayer(): Promise<Player & {
+		changePluginsIcon?: (name: any, isShow: any) => void;
+		playerData?: PlayerData;
+		playerType?: string;
+		playerVersion?: string;
+		panel?: MobilePlayerPanel;
+		emitExpireTimestamp?: number;
+	}>;
 	/**
 	 * @hidden
 	 *
 	 * @param {*} finalOptions
-	 * @param {IEncryptHlsPluginConfig} encryptHlsPluginConfig
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
-	setHlsEncryptConfig(finalOptions: IPlayerConfig, encryptHlsPluginConfig: IEncryptHlsPluginConfig): void;
+	setPluginConfig(finalOptions: IPlayerConfig): void;
 	/**
 	 * @hidden
 	 *
@@ -1887,7 +2114,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 */
 	getCurrentPlayerConfig(): {
-		type?: "live" | "vod";
+		type?: "vod" | "live";
 		isLive?: boolean;
 		lineId?: string | number;
 		definition?: string;
@@ -1926,7 +2153,7 @@ declare class VePlayer {
 	 *
 	 * @memberof VePlayer
 	 */
-	_setPlayerInfo(): void;
+	private _setPlayerInfo;
 	/**
 	 *
 	 *
@@ -1997,14 +2224,14 @@ declare class VePlayer {
 	getSdkPlugin(name: any): any;
 	/**
 	 * @description 更换playAuthToken的方法
-	 * @note 这里指同一个视频切换视频源，不能用来切换不同类型的视频
-	 * @param { IPlayAuthTokenConfig } config
-	 * @param { boolean } isNewVideo 是否是新视频，默认false，如果是true，则起播时间为0
+	 * @notes 这里指同一个视频切换视频源，不能用来切换不同类型的视频
+	 * @param { IPlayAuthTokenConfig } config authToken配置
+	 * @param { boolean } isNewVideo 是否是新视频，默认true。若未false即表示同一个视频切换token播放，会在切换前时间点继续播放
 	 * @memberof VePlayer
 	 */
 	switchAuthToken(config: IPlayAuthTokenConfig, isNewVideo?: boolean): Promise<void>;
 	/**
-	 * @description 更新playAuthToken的方法
+	 * @description 更新playAuthToken的方法，用来更新视频地址
 	 * @param { IPlayAuthTokenConfig } config
 	 * @memberof VePlayer
 	 */
@@ -2016,14 +2243,14 @@ declare class VePlayer {
 	get src(): any;
 	/**
 	 * @description 设置当前视频的地址
-	 * @note 会重新拉取新的视频，从0开始起播
+	 * @notes 会重新拉取新的视频，从0开始起播
 	 * @memberof VePlayer
 	 */
 	set src(url: any);
 	/**
 	 * 切换视频url
 	 * @param {string} url 同一个视频，切换视频地址
-	 * @note 切换后从切换前的时间点继续播放
+	 * @notes 切换后从切换前的时间点继续播放
 	 * @return {Promise<void>}
 	 * @memberof VePlayer
 	 */
@@ -2032,17 +2259,19 @@ declare class VePlayer {
 	 * 重建播放下一个
 	 *
 	 * @param {playerConfig} config
+	 * @param { boolean } isNewVideo 是否是新视频，默认true。若未false即表示同一个视频切换token播放，会在切换前时间点继续播放
 	 * @memberof VePlayer
 	 */
-	next(config: IPlayerConfig): Promise<void>;
+	next(config: IPlayerConfig, isNewVideo?: boolean): Promise<void>;
 	/**
 	 * 切换视频源，主要用于在视频过期时更新视频源
 	 *
 	 * @param {IPlayerConfig} config
+	 * @param { boolean } isNewVideo 是否是新视频，默认true。若未false即表示同一个视频切换token播放，会在切换前时间点继续播放
 	 * @return{Promise<any>}
 	 * @memberof VePlayer
 	 */
-	playNext(config: IPlayerConfig): Promise<any>;
+	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
 	/**
 	 * @hidden
 	 *
@@ -2063,9 +2292,16 @@ declare class VePlayer {
 	 * @return {*}
 	 * @memberof VePlayer
 	 */
-	getPlayerInstance(): any;
+	getPlayerInstance(): Player & {
+		changePluginsIcon?: (name: any, isShow: any) => void;
+		playerData?: PlayerData;
+		playerType?: string;
+		playerVersion?: string;
+		panel?: MobilePlayerPanel;
+		emitExpireTimestamp?: number;
+	};
 	/**
-	 * @public
+	 * @hidden
 	 *
 	 * @return {*}
 	 * @memberof VePlayer
@@ -2094,13 +2330,128 @@ declare class VePlayer {
 	 */
 	private _initI18N;
 	/**
-	 * 销毁当前示例
+	 * 获取音乐播放模式
+	 * @notes 仅音乐播放模式有效
+	 * @return {PLAY_MODE_TYPE}
+	 * @memberof VePlayer
+	 */
+	get musicMode(): PLAY_MODE_TYPE;
+	/**
+	 * 设置音乐播放模式
+	 * @notes 仅音乐播放模式有效
+	 * @memberof VePlayer
+	 * @param {PLAY_MODE_TYPE} val 模式值
+	 */
+	set musicMode(val: PLAY_MODE_TYPE);
+	/**
+	 * 获取音乐播放快进快退时间跨度
+	 * @notes 仅音乐播放模式有效
+	 * @return {number}
+	 * @memberof VePlayer
+	 */
+	get musicTimeScale(): number;
+	/**
+	 * 设置音乐播放快进快退时间跨度
+	 * @notes 仅音乐播放模式有效
+	 * @param {number} scale 时间跨度
+	 * @memberof VePlayer
+	 */
+	set musicTimeScale(scale: number);
+	/**
+	 * 获取音乐播放列表
+	 * @notes 仅音乐播放模式有效
+	 * @return {IMusicListItem[]}
+	 * @memberof VePlayer
+	 */
+	get musicList(): IMusicListItem[];
+	/**
+	 * 设置音乐播放列表
+	 * @notes 仅音乐播放模式有效
+	 * @param {IMusicListItem[]} list 播放列表
+	 * @memberof VePlayer
+	 */
+	set musicList(list: IMusicListItem[]);
+	/**
+	 * 向播放列表中加入歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @param {IMusicListItem} meta 歌曲信息
+	 * @memberof VePlayer
+	 */
+	musicAdd(meta: IMusicListItem): void;
+	/**
+	 * 随机获取播放列表中某一首歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @return {IMusicListItem} 歌曲信息
+	 * @memberof VePlayer
+	 */
+	musicRandom(): IMusicListItem;
+	/**
+	 * 播放播放列表的下一首歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @memberof VePlayer
+	 */
+	musicNext(): void;
+	/**
+	 * 播放播放列表的上一首歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @memberof VePlayer
+	 */
+	musicPrev(): void;
+	/**
+	 * 播放播放列表的第n首歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @param {number} index 播放列表中的序号
+	 * @memberof VePlayer
+	 */
+	musicSetIndex(index: number): void;
+	/**
+	 * 歌曲快进
+	 * @notes 仅音乐播放模式有效
+	 * @memberof VePlayer
+	 */
+	musicForward(): void;
+	/**
+	 * 歌曲后退
+	 * @notes 仅音乐播放模式有效
+	 * @memberof VePlayer
+	 */
+	musicBackward(): void;
+	/**
+	 * 从播放列表移除指定歌曲
+	 * @notes 仅音乐播放模式有效
+	 * @param {string | number} vid 歌曲vid
+	 * @memberof VePlayer
+	 */
+	musicRemove(vid: string | number): void;
+	/**
+	 * 设置ab循环
+	 * @param { number | IABCycle } start
+	 * @param { number } [end]
+	 * @param { boolean } [loop]
+	 * @param {{ [propName: string]: any }} [ext]
+	 * @memberof VePlayer
+	 */
+	musicSetAbCycle(start: number | IABCycle, end?: number, loop?: boolean, ext?: {
+		[propName: string]: any;
+	}): void;
+	/**
+	 * 移除ab循环
+	 * @memberof VePlayer
+	 */
+	musicRemoveAbCycle(): void;
+	/**
+	 * 销毁当前播放器SDK实例
 	 *
 	 * @memberof VePlayer
 	 */
 	destroy(): Promise<void>;
 }
 export declare function getI18N(): typeof I18N;
+declare class MusicPreset {
+	ignores: string[];
+	plugins: any[];
+	constructor(options: any, playerConfig: any);
+}
 export interface ISubTitles {
 	timestamp: number;
 	text: string;
@@ -2251,6 +2602,7 @@ export interface IPanelItem {
 	"data-type"?: string;
 }
 export declare class Subtitle extends Plugin {
+	constructor(args: any);
 	static get pluginName(): string;
 	static get defaultConfig(): {
 		position: string;
@@ -2270,6 +2622,9 @@ export declare class Subtitle extends Plugin {
 			line: string;
 			fontColor: string;
 		};
+		isShowIcon: boolean;
+		mode: string;
+		updateMode: string;
 	};
 	private _delegates;
 	isOpenState: boolean;
@@ -2278,13 +2633,31 @@ export declare class Subtitle extends Plugin {
 	subTitles: any;
 	curIndex: number;
 	curItem: ISubTitleItem;
-	beforeCreate(args: any): void;
 	afterCreate(): void;
+	/**
+	 * @description 初始化原生字幕
+	 *
+	 */
+	_initNativeSubtitle(defaultIndex: any): void;
+	/**
+	 * 初始化外挂字幕
+	 * @param {number} defaultIndex
+	 */
+	_initExtSubTitle(defaultIndex: any): void;
+	_renderList(defaultIndex: any): void;
+	_onOff(): void;
+	_onChange(data: any): void;
+	_onListReset(data: any): void;
+	updateCurItem(cIndex: any, subtitle: any): void;
 	initEvents(): void;
 	handleButtonChange(e: any): void;
 	showList(): void;
 	hideList(): void;
 	openSubtitle(): void;
+	getSubTitleIndex(list: any, subtitle?: {
+		id: string;
+		language: string;
+	}): number;
 	registerIcons(): {
 		vttSubOpen: {
 			icon: any;
@@ -2326,13 +2699,15 @@ export declare class Subtitle extends Plugin {
 	 */
 	switchSubTitle(subtitle?: ISubTitleItem): any;
 	switchOffSubtitle(): void;
+	noShowSubtitle(): void;
 	renderItemList(): void;
 	/**
 	 *
-	 * @param { Array<ISubTitleItem> } list
+	 * @param { Array<SubTitleItem> } list
 	 * @param { boolean } needRemove 是否移除原来的字幕
 	 */
 	updateSubtitles(list?: any[], needRemove?: boolean): void;
+	updateList(data?: {}): void;
 	changeTipText(): void;
 	showMobilePanel(): void;
 	updatePanel(): void;
@@ -2629,9 +3004,11 @@ export declare class LiveInfoPanel extends Plugin {
 	close(): void;
 	render(): string;
 }
+export * from "xgplayer";
 
 export {
 	LiveSubTitlesPlugin as LiveSubtitlesPlugin,
+	MusicPreset as Music,
 	VePlayer as default,
 };