@volcengine/veplayer 1.15.3-rc.0 → 1.16.0-rc.0

package/index.d.ts

@@ -3113,6 +3113,11 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @notes 仅移动端生效，开启后采用MSE方式播放HLS，默认在移动端使用原生video播放hls
 	 */
 	enableHlsMSE?: boolean;
+	/** {zh}
+	 * @brief 是否启用 {@link https://hlsjs.video-dev.org/ hls.js} 插件播放HLS视频，默认为true，设置为false后，PC端播放HLS使用自研hls插件播放HLS视频
+	 * @default true
+	 */
+	enableHlsJs?: boolean;
 	/** {zh}
 	 * @brief 在 PC Safari 上是否 HLS 插件播放视频。取值如下：
 	 *        - `true`：使用 HLS 插件。SDK 会自动加载 HLS 插件。
@@ -3626,6 +3631,10 @@ export interface IPlayAuthTokenConfig {
 	 * @default -
 	 */
 	autoDemoteDefinitionTextKey?: string;
+	/** {zh}
+	 * @brief HLS 播放时是否使用master m3u8 地址作为播放源
+	 */
+	useMasterM3u8?: boolean;
 }
 /** {zh}
  * @list Options
@@ -4328,6 +4337,7 @@ declare class VeStrategyWrapper {
 declare const _default: VeStrategyWrapper;
 declare enum UmdKeys {
 	HLS = "hls",
+	HLSJS = "hlsjs",
 	FLV = "flv",
 	XGVideo = "XGVideo",
 	HLSEncrypt = "hlsEncrypt",
@@ -4400,6 +4410,26 @@ declare class UMDLoader {
 	 * @return Promise<any>
 	 */
 	loadPlugins(pluginName: UmdKeys, successCallback?: () => void): Promise<any>;
+	/**
+	 * 处理加载成功
+	 */
+	private handleLoadSuccess;
+	/**
+	 * 处理加载失败
+	 */
+	private handleLoadError;
+	/**
+	 * 处理catch分支的错误处理
+	 */
+	private handleLoadCatch;
+	/**
+	 * 加载备用URL
+	 */
+	private loadBackupUrl;
+	/**
+	 * 触发成功回调
+	 */
+	private triggerSuccessCallback;
 }
 export declare class SdkPlugin {
 	pluginName: string;
@@ -4523,7 +4553,7 @@ declare abstract class AbstractBaseAdapter {
 	abstract prepareAbrModule(_playerData: any, _sdkUmdLoader: any): void;
 	abstract needAbrAutoDefinition(): boolean;
 	abstract setAbrDefaultDefiWithAuto(): boolean;
-	abstract generatePlaylistFromServer(res: VideoInfoRes): Stream[];
+	abstract generatePlaylistFromServer(res: VideoInfoRes, ...args: any[]): Stream[];
 	abstract canAdaptRangeEnable(): boolean;
 	abstract adaptRangeDefaultOptions(): IAdaptRangeDefaultOptions | undefined;
 	abstract applyAdaptRangePluginConfig(_finalOptions: any, _adaptRangeOptions: any): void;
@@ -4559,6 +4589,7 @@ declare class PlayerData {
 	isMusic?: boolean;
 	sdkPlugins: any[];
 	useHlsPluginForSafari: boolean;
+	enableHlsJs: boolean;
 	enableMenu: boolean;
 	region: TRegionType;
 	userRegion: TRegionType;
@@ -5769,15 +5800,17 @@ export declare class Subtitle extends Plugin {
 	 */
 	_initExtSubTitle(defaultIndex: any): void;
 	_renderList(defaultIndex: any): void;
-	_onOff(): void;
-	_onChange(data: any): void;
-	_onListReset(data: any): void;
+	_onOff: () => void;
+	_onChange: (data: any) => void;
+	_onListReset: (data: any) => void;
 	updateCurItem(cIndex: any, subtitle: any): void;
 	initEvents(): void;
-	handleButtonChange(e: any): void;
+	handleButtonChange: (e: any) => void;
+	onEnter: (e: any) => void;
+	onLeave: (e: any) => void;
 	showList(): void;
 	hideList(): void;
-	openSubtitle(): void;
+	openSubtitle(): Promise<any>;
 	getSubTitleIndex(list: any, subtitle?: {
 		id: string;
 		language: string;
@@ -5819,9 +5852,9 @@ export declare class Subtitle extends Plugin {
 	/**
 	 *
 	 * @param {ISubTitleItem} subtitle
-	 * @returns
+	 * @returns {Promise<void>}
 	 */
-	switchSubTitle(subtitle?: ISubTitleItem): any;
+	switchSubTitle(subtitle?: ISubTitleItem): Promise<void>;
 	switchOffSubtitle(): void;
 	noShowSubtitle(): void;
 	renderItemList(): void;
@@ -6185,6 +6218,10 @@ export declare const Events: {
 	 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 	 */
 	ABR_AUTO_DESC_CHANGE: string;
+	/** {zh}
+	 * @brief 播放插件内核的扩展事件
+	 */
+	CORE_EVENT: string;
 	/** {zh}
 	 * @brief 播放器实例创建完成时触发。
 	 */
@@ -6856,6 +6893,10 @@ export declare const Event: {
 		 * @brief 多码率自适应播放时，自动挡位对应的清晰度改变。
 		 */
 		ABR_AUTO_DESC_CHANGE: string;
+		/** {zh}
+		 * @brief 播放插件内核的扩展事件
+		 */
+		CORE_EVENT: string;
 	};
 };
 export * from "xgplayer";