@volcengine/veplayer 1.8.6-rc.13 → 1.8.6-rc.15

package/index.d.ts

@@ -787,21 +787,31 @@ export interface ITextItem {
  */
 export interface IDefinitionDemotePlugin {
 	/**
-	 * 超时重试次数
-	 * 默认：3
+	 * 是否开启自动降级
+	 * 默认：false
 	 *
-	 * @type {number}
+	 * @type {boolean}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	oftenWaitingCount?: number;
+	isNeedAutoDemote?: boolean;
+	/**
+	 * @brief 卡顿时是否展示toast
+	 * @default true
+	 */
+	isNeedShowTips?: boolean;
+	/**
+	 * @brief 提醒降级的toast显示持续时间
+	 */
+	toastShowTime?: number;
 	/**
-	 * 设置经常超时时间
-	 * 默认：5000
 	 *
-	 * @type {number}
+	 * 降级顺序，按照数组顺序依次降级，数字元素对应playList中的definition
+	 * 默认: ['uhd', 'hd', 'sd', 'ld', 'ao']
+	 *
+	 * @type {string[]}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	oftenWaitingTime?: number;
+	demotePriority?: string[];
 	/**
 	 * 设置超时时间
 	 * 默认5000
@@ -811,22 +821,21 @@ export interface IDefinitionDemotePlugin {
 	 */
 	longWaitingTime?: number;
 	/**
-	 * 是否自动触发降级
-	 * 默认：false
+	 * 超时重试次数
+	 * 默认：3
 	 *
-	 * @type {boolean}
+	 * @type {number}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	isNeedAutoDemote?: boolean;
+	oftenWaitingCount?: number;
 	/**
+	 * 设置经常超时时间
+	 * 默认：5000
 	 *
-	 * 降级顺序，按照数组顺序依次降级，数字元素对应playList中的definition
-	 * 默认: ['uhd', 'hd', 'sd', 'ld', 'ao']
-	 *
-	 * @type {string[]}
+	 * @type {number}
 	 * @memberof IDefinitionDemotePlugin
 	 */
-	demotePriority?: string[];
+	oftenWaitingTime?: number;
 }
 /**
  * @brief DASH 播放配置。
@@ -1631,7 +1640,7 @@ export declare class PlayListPlugin extends Plugin {
 	get disable(): boolean;
 	render(): string;
 }
-export interface IPlayInfoList {
+export interface IPlayInfoListItem {
 	BackupPlayUrl: string;
 	BackupUrlExpire: string;
 	BarrageMaskOffset: string;
@@ -1658,6 +1667,98 @@ export interface IPlayInfoList {
 	Volume?: number;
 	Width: number;
 }
+/**
+ * @brief 动态水印配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief watermark config
+ */
+export interface IWatermarkConfig {
+	/**
+	 * @brief 是否开启水印
+	 * @default false
+	 */
+	enable: boolean;
+	/**
+	 * @brief 水印文案内容
+	 * @default -
+	 */
+	content: string;
+	/**
+	 * @brief 水印展示形式
+	 * - 0: 固定位置
+	 * - 1: 全屏滚动
+	 * - 2: 随机闪烁
+	 * @default 1
+	 */
+	displayType: 0 | 1 | 2;
+	/**
+	 * @brief 水印字体大小，number类型时单位为px，string类型需要携带单位
+	 * @default 12
+	 */
+	fontSize: number | string;
+	/**
+	 * @brief 水印字体颜色
+	 * @brief #FFFFFF
+	 */
+	fontColor: string;
+	/**
+	 * @brief 不透明度
+	 * @default 0.3
+	 */
+	opacity: number;
+	/**
+	 * @brief 水印闪烁速度
+	 * @default MODERATE
+	 * - MODERATE: 适中
+	 * - FAST: 较快
+	 * - SLOW: 较慢
+	 */
+	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
+	/**
+	 * @brief 水印字体类型
+	 * @default -
+	 */
+	fontFamily?: string;
+	/**
+	 * @brief 水印相对于播放容器顶部起始位置，单位px
+	 * @default 0
+	 */
+	top?: number;
+	/**
+	 * @brief 水印相对于播放容器左侧起始位置，单位px
+	 * @default 0
+	 */
+	left?: number;
+	/**
+	 * @brief 水印相对于播放容器底部起始位置，单位px
+	 * @default -
+	 */
+	bottom?: number;
+	/**
+	 * @brief 水印相对于播放容器右侧起始位置，单位px
+	 * @default -
+	 */
+	right?: number;
+}
+export declare class DynamicWatermarkPlugin extends Plugin {
+	private wm;
+	static get pluginName(): string;
+	static get defaultConfig(): IWatermarkConfig & {
+		position: string;
+	};
+	constructor(props: any);
+	afterCreate(): void;
+	start(): void;
+	pause(): void;
+	resume(): void;
+	resize(): void;
+	_initWatermark(): void;
+	destroy(): void;
+	render(): string | HTMLElement;
+}
 declare enum CodecType {
 	/** {zh}
 	 * @brief H.265
@@ -1813,7 +1914,7 @@ export interface IMusicConfig {
  * @export
  * @interface Stream
  */
-export interface Stream extends Partial<IPlayInfoList> {
+export interface Stream extends Partial<IPlayInfoListItem> {
 	/** {zh}
 	 * @type {('rtm' | 'flv' | 'mp4' | 'hls')}
 	 * @memberof IPlayerConfig
@@ -1837,6 +1938,12 @@ export interface Stream extends Partial<IPlayInfoList> {
 	 * @brief 清晰度 key
 	 */
 	definition?: string;
+	/** {zh}
+	 * @type {string}
+	 * @memberof Stream
+	 * @brief 映射清晰度 key
+	 */
+	mapDefinition?: string;
 	/** {zh}
 	 * @type {string}
 	 * @memberof Stream
@@ -1980,7 +2087,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	autoplay?: boolean;
 	/** {zh}
-	 * @brief 视频封面图片的 URL。
+	 * @brief 视频封面图配置。
 	 */
 	poster?: string | IPoster;
 	/** {zh}
@@ -2346,8 +2453,7 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 */
 	disableVodLogOptsCheck?: boolean;
 	/** {zh}
-	 * @hidden
-	 * @brief 是否打开日志打印
+	 * @brief 是否开启调试模式
 	 * @default false
 	 */
 	debug?: boolean;
@@ -2370,7 +2476,6 @@ export interface IPlayerConfig extends IPlayerOptions {
 	DanmuPlugin?: IDanmuConfig | boolean;
 	/** {zh}
 	 * @brief 清晰度自动降级配置
-	 * @hidden
 	 * @notes 需要先引入DefinitionDemotePlugin插件，plugins: [VePlayer.DefinitionDemotePlugin]
 	 */
 	DefinitionDemotePlugin?: IDefinitionDemotePlugin;
@@ -2431,6 +2536,16 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 播放列表配置。
 	 */
 	playListPlugin?: IPlayListConfig;
+	/** {zh}
+	 * @brief 动态水印配置
+	 * @default -
+	 */
+	dynamicwatermark?: IWatermarkConfig;
+	/** {zh}
+	 * @brief 进度条预览缩略图配置
+	 * @default -
+	 */
+	thumbnail?: IThumbnailConfig;
 }
 /** {zh}
  * @hidden
@@ -2609,6 +2724,18 @@ export interface IPlayAuthTokenConfig {
 	 * @default 1
 	 */
 	retryCount?: number;
+	/** {zh}
+	 * @brief 清晰度自动降级开启时的自动档位，对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo}返回的Definition字段
+	 * @notice 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
+	 * @default -
+	 */
+	autoDemoteDefinition?: string;
+	/** {zh}
+	 * @brief 清晰度自动降级开启时的自动档位对应的多语言文案key，即languages字段中对应语种的相应key
+	 * @notice 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
+	 * @default -
+	 */
+	autoDemoteDefinitionTextKey?: string;
 }
 /** {zh}
  * @list Options
@@ -2707,16 +2834,6 @@ export interface IMemoryPlayConfig {
 	 * @default -
 	 */
 	getTime?: (id: number | string) => number | Promise<number>;
-	/** {zh}
-	 * @brief 判断是否播放了最小时间阈值，即如果播的时长太小，则不算做播放过，存储的时间进度为0
-	 * @default 1
-	 */
-	minStartTime?: number;
-	/** {zh}
-	 * @brief 判断是否播放结束的最小时间阈值，即距离结束多少时间内算作播放结束，播放结束则不存储时间进度,且清空之前的进度为0
-	 * @default 1
-	 */
-	minEndTime?: number;
 }
 /** {zh}
  * @brief 插件按钮位置
@@ -2929,6 +3046,58 @@ export interface IPoster {
 	 */
 	fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
 }
+/** {zh}
+ * @list Options
+ * @brief 进度条预览缩略图配置
+ * @kind property
+ */
+export interface IThumbnailConfig {
+	/** {zh}
+	 * @brief 雪碧图截图地址数组
+	 * @default -
+	 */
+	urls: Array<string>;
+	/** {zh}
+	 * @brief 雪碧图中小图总数目
+	 * @default -
+	 */
+	pic_num: number;
+	/** {zh}
+	 * @brief 雪碧图每张大图中小图列数
+	 * @default -
+	 */
+	col: number;
+	/** {zh}
+	 * @brief 雪碧图每张大图中小图行数
+	 * @default -
+	 */
+	row: number;
+	/** {zh}
+	 * @brief 雪碧图每张小图的高度
+	 * @default -
+	 */
+	height?: number;
+	/** {zh}
+	 * @brief 雪碧图每张小图的宽度
+	 * @default -
+	 */
+	width?: number;
+	/** {zh}
+	 * @brief 显示缩放比例
+	 * @default 1
+	 */
+	scale?: 1;
+	/** {zh}
+	 * @brief 额外添加在dom上的class
+	 * @default -
+	 */
+	className?: string;
+	/** {zh}
+	 * @brief 是否在竖屏的时候隐藏
+	 * @default false
+	 */
+	hidePortrait?: false;
+}
 /**
  * @brief api map
  * @hidden
@@ -3055,9 +3224,10 @@ declare class PlayerData {
 	getUrlList(condition: Condition): Stream[];
 	/**
 	 * @description: 获取当期清晰的上一级清晰度或下一级清晰度
-	 * @param {boolean} isDown
+	 * @param {boolean} isDown 是否取下一级清晰度
+	 * @param {string[]} demotePriority 清晰度降级顺序
 	 */
-	getNextDefinition(isDown: boolean, demotePriority: any): Stream[];
+	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
 	/**
 	 * 获取api map
 	 * @return { ApiMapConfig }
@@ -3196,7 +3366,7 @@ declare class VePlayer {
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
-	mountingDom: any;
+	mountingDom: Element;
 	/** {zh}
 	 * @hidden
 	 *
@@ -4094,51 +4264,15 @@ export declare class Subtitle extends Plugin {
 	destroy(): void;
 	render(): string;
 }
-export interface WatermarkConfig {
-	enable: boolean;
-	content: string;
-	displayType: 0 | 1 | 2;
-	fontSize: number | string;
-	fontColor: string;
-	opacity: number;
-	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
-	fontFamily?: string;
-	top?: number;
-	left?: number;
-	bottom?: number;
-	right?: number;
-}
-export declare class DynamicWatermarkPlugin extends Plugin {
-	private wm;
-	static get pluginName(): string;
-	static get defaultConfig(): WatermarkConfig & {
-		position: string;
-	};
-	constructor(props: any);
-	afterCreate(): void;
-	start(): void;
-	pause(): void;
-	resume(): void;
-	resize(): void;
-	_initWatermark(): void;
-	destroy(): void;
-	render(): string | HTMLElement;
-}
 export declare class DefinitionDemotePlugin extends Plugin {
 	static get pluginName(): string;
 	waitings: number[];
-	timer: any;
+	timer: ReturnType<typeof setTimeout>;
+	toastId: number;
 	longWaitingEmitTime: number;
 	waitingStartTime: number;
-	playerData: any;
-	isNeedShowTips: boolean;
-	static get defaultConfig(): {
-		oftenWaitingCount: number;
-		oftenWaitingTime: number;
-		longWaitingTime: number;
-		isNeedAutoDemote: boolean;
-		demotePriority: any[];
-	};
+	playerData: PlayerData;
+	static get defaultConfig(): IDefinitionDemotePlugin;
 	constructor(args: any);
 	registerLanguageTexts(): {
 		definition_demote_txt: {
@@ -4157,8 +4291,8 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_clearTime(): void;
 	clearState(): void;
 	demote(): void;
-	changeUrl(url: any): void;
-	showToast(definition: any): void;
+	changeUrl(url: string): void;
+	showToast(definition: Stream): void;
 	destroy(): void;
 }
 export declare class TimeShiftPlugin extends Plugin {
@@ -4292,7 +4426,11 @@ declare class ToastPlugin extends Plugin {
 }
 export declare class MemoryPlay extends Plugin {
 	static get pluginName(): string;
-	static get defaultConfig(): IMemoryPlayConfig;
+	static get defaultConfig(): {
+		getTime: any;
+		saveTime: any;
+		memoryId: string;
+	};
 	startTime: number;
 	saveTimeFun: (id: number | string, time: number) => unknown;
 	getTimeFun: (id: number | string) => number | Promise<number>;
@@ -4312,14 +4450,12 @@ export declare class MemoryPlay extends Plugin {
 	};
 	afterCreate(): void;
 	beforePlayerInit(): Promise<void>;
+	destroy(): void;
 	getTime(): Promise<void>;
-	saveTime(): void;
-	visibilitychangeCallback(): void;
 	setSave(): void;
 	showToast(): void;
-	saveTimeByStorage(memoryId: string, time: number): void;
-	getTimeByStorage(memoryId: string): string;
-	destroy(): void;
+	saveTimeByStorage(memoryId: any, time: any): void;
+	getTimeByStorage(memoryId: any): string;
 }
 export declare type InfoItem = {
 	key: string;