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

package/index.d.ts

@@ -79,21 +79,8 @@ export interface ISdkErrorConfig {
 	 * @hidden
 	 */
 	isNeedDemoteBack?: boolean;
-	/**
-	 * @brief 是否允许回退到同清晰度不同线路的 fallbackurl：
-	 *        - `false`：只能在当前 defintion 范围内 fallback。
-	 *        - `true`：允许 fallback 相同清晰度，不同的线路的 fallbackurl。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote to different line enabled? The values are as follows:
-	 *        - `false`: only demote in current definition line.
-	 *        - `true`: allow demote to different line.
-	 */
-	allowDemoteToDifferentLine?: boolean;
 	/** {zh}
-	 * @brief 报错后重试轮数。
+	 * @brief 报错后重试次数。
 	 * @default 1
 	 */
 	retryLoopNum?: number;
@@ -811,125 +798,18 @@ export interface ITextItem {
  */
 export interface IDefinitionDemotePlugin {
 	/**
-	 * @brief 长卡顿情况下是否开启自动降级，取值如下：
-	 *        - `false`：关闭自动降级。
-	 *        - `true`：开启自动降级。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is automatic downgrade enabled for long waiting? The values are as follows:
-	 *        - `false`: automatic downgrade is disabled.
-	 *        - `true`: automatic downgrade is enabled.
-	 */
-	isNeedAutoDemoteWhenLongWaiting?: boolean;
-	/**
-	 * @brief 频繁卡顿情况下是否开启自动降级，取值如下：
+	 * @brief 是否开启自动降级，取值如下：
 	 *        - `false`：关闭自动降级。
 	 *        - `true`：开启自动降级。
 	 * @default true
 	 *
 	 */
 	/** {en}
-	 * @brief Is automatic downgrade enabled for often waiting? The values are as follows:
+	 * @brief Is automatic downgrade enabled? The values are as follows:
 	 *        - `false`: automatic downgrade is disabled.
 	 *        - `true`: automatic downgrade is enabled.
 	 */
-	isNeedAutoDemoteWhenOftenWaiting?: boolean;
-	/**
-	 * @brief 长卡顿情况下，当用户开启 fallbackUrl 降级（降级到备用线路) 时，优先降级清晰度还是 fallbackUrl，取值如下：
-	 *        - `false`：优先在同一个清晰度的所有 fallback 之间切换, 都有问题的情况下，再降低到下一个清晰度
-	 *        - `true`：优先降级清晰度, 清晰度降到最低之后，再在最后一个清晰度的 fallbackUrl 之间切换
-	 * @default false
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote quality first? The values are as follows:
-	 *        - `false`: not demote quality first.
-	 *        - `true`: demote quality first.
-	 */
-	shouldDemoteDefinitionFirstWhenLongWaiting?: boolean;
-	/**
-	 * @brief 频繁卡顿情况下，当用户开启 fallbackUrl 降级（降级到备用线路) 时，优先降级清晰度还是 fallbackUrl，取值如下：
-	 *        - `false`：优先在同一个清晰度的所有 fallback 之间切换, 都有问题的情况下，再降低到下一个清晰度
-	 *        - `true`：优先降级清晰度, 清晰度降到最低之后，再在最后一个清晰度的 fallbackUrl 之间切换
-	 * @default false
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote quality first? The values are as follows:
-	 *        - `false`: not demote quality first.
-	 *        - `true`: demote quality first.
-	 */
-	shouldDemoteDefinitionFirstWhenOftenWaiting?: boolean;
-	/**
-	 * @brief 长卡顿情况下是否开启 fallbackUrl 降级：
-	 *        - `false`：不尝试降级到备用线路。
-	 *        - `true`：尝试降级到备用线路。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is automatic downgrade enabled? The values are as follows:
-	 *        - `false`: not try to play fallbackUrl first.
-	 *        - `true`: try to play fallbackUrl first before demote definition.
-	 */
-	isNeedDemoteBackWhenLongWaiting?: boolean;
-	/**
-	 * @brief 频繁卡顿情况下是否开启 fallbackUrl 降级：
-	 *        - `false`：不尝试降级到备用线路。
-	 *        - `true`：尝试降级到备用线路。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is automatic downgrade enabled? The values are as follows:
-	 *        - `false`: not try to play fallbackUrl first.
-	 *        - `true`: try to play fallbackUrl first before demote definition.
-	 */
-	isNeedDemoteBackWhenOftenWaiting?: boolean;
-	/**
-	 * @brief 长卡顿情况下是否允许回退到同清晰度不同线路的 fallbackurl：
-	 *        - `false`：只能在当前 defintion 范围内 fallback。
-	 *        - `true`：允许 fallback 相同清晰度，不同的线路的 fallbackurl。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote to different line enabled? The values are as follows:
-	 *        - `false`: only demote in current definition line.
-	 *        - `true`: allow demote to different line.
-	 */
-	allowDemoteToDifferentLineWhenLongWaiting?: boolean;
-	/**
-	 * @brief 频繁卡顿情况下是否允许回退到同清晰度不同线路的 fallbackurl：
-	 *        - `false`：只能在当前 defintion 范围内 fallback。
-	 *        - `true`：允许 fallback 相同清晰度，不同的线路的 fallbackurl。
-	 * @default true
-	 *
-	 */
-	/** {en}
-	 * @brief Is demote to different line enabled? The values are as follows:
-	 *        - `false`: only demote in current definition line.
-	 *        - `true`: allow demote to different line.
-	 */
-	allowDemoteToDifferentLineWhenOftenWaiting?: boolean;
-	/**
-	 * @brief 同一清晰度降级至 fallbackurl 的重试轮数。
-	 * @default 1
-	 */
-	/** {en}
-	 * @brief The retry loop number for all available fallbackUrl.
-	 */
-	retryLoopNum?: number;
-	/**
-	 * @brief 在降级时到下一个definition 时，是否显示 toast 提示。
-	 * @default 1
-	 */
-	/** {en}
-	 * @brief Whether to show toast when demote to next definition.
-	 */
-	bumpToastWhenDemoteToNextDefinition?: boolean;
+	isNeedAutoDemote?: boolean;
 	/**
 	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
@@ -982,35 +862,15 @@ export interface IDefinitionDemotePlugin {
 	 * @brief 提醒降级的toast显示持续时间,单位ms
 	 */
 	toastShowTime?: number;
-	/**
-	 * @brief 记录清除时间阈值，单位为毫秒。
-	 * @default 3 * 60 * 1000
-	 */
-	/** {en}
-	 * @brief Record clear time threshold, unit is ms.
-	 */
-	clearRecordThreshold?: number;
-}
-declare enum FALLBACK_REASON {
-	LONG_STALL = "long_stall",
-	OFTEN_STALL = "often_stall",
-	ERROR = "error"
 }
 export declare class DefinitionDemotePlugin extends Plugin {
 	static get pluginName(): string;
 	waitings: number[];
 	timer: ReturnType<typeof setTimeout>;
-	clearRecordTimer: ReturnType<typeof setTimeout>;
 	toastId: number;
 	longWaitingEmitTime: number;
 	waitingStartTime: number;
 	playerData: PlayerData;
-	private lastSeekingTime;
-	fallbackState: {
-		retryTimes: number;
-		idx: number;
-	};
-	isDemoting: boolean;
 	static get defaultConfig(): IDefinitionDemotePlugin;
 	constructor(args: any);
 	registerLanguageTexts(): {
@@ -1029,21 +889,8 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_time(): void;
 	_clearTime(): void;
 	clearState(): void;
-	demote(reason: FALLBACK_REASON): void;
-	executeDemoteFallbackFirst(reason: FALLBACK_REASON): void;
-	executeDemoteDefinitionFirst(reason: FALLBACK_REASON): void;
-	private _emitFallbackEventAndReportTea;
-	getRetryListForCurrentDefinition(): {
-		urls: any[];
-		sources: (string | number)[];
-	};
-	getRetryListForCurrentDefinitionAcrossAllLines(): {
-		urls: any[];
-		sources: any[];
-	};
-	resetTimes(): void;
-	changeMainOrBackup(reason: FALLBACK_REASON): boolean;
-	changeUrl(url: Url, source: string | number): void;
+	demote(): void;
+	changeUrl(url: Url): void;
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
@@ -2212,7 +2059,7 @@ export interface IMemoryPlayConfig {
 	 * @type {number | string}
 	 * @memberof IMemoryPlayConfig
 	 */
-	memoryId: number | string;
+	memoryId?: number | string;
 	/** {zh}
 	 * @brief 设置时间函数
 	 * @default -
@@ -2241,6 +2088,10 @@ export interface IMemoryPlayConfig {
 }
 export declare class MemoryPlay extends Plugin {
 	private curTime;
+	private pendingMemoryId;
+	private hasPendingMemoryId;
+	private skipNextGetTime;
+	private hasSavedForPlayNext;
 	static get pluginName(): string;
 	static get defaultConfig(): IMemoryPlayConfig;
 	startTime: number;
@@ -2262,6 +2113,9 @@ export declare class MemoryPlay extends Plugin {
 	};
 	afterCreate(): void;
 	beforePlayerInit(): Promise<void>;
+	private resolveMemoryId;
+	setConfig(config: Partial<IMemoryPlayConfig> | boolean): void;
+	private onPlayNext;
 	getTime(): Promise<void>;
 	saveTime(): void;
 	visibilitychangeCallback(): void;
@@ -3655,7 +3509,7 @@ export interface IPlayAuthTokenConfig {
 	 */
 	autoDemoteDefinition?: string;
 	/** {zh}
-	 * @brief 开启清晰度自动降级（`isNeedAutoDemoteWhenLongWaiting` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
+	 * @brief 开启清晰度自动降级（`isNeedAutoDemote` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
 	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
 	 * @default -
 	 */
@@ -4441,7 +4295,6 @@ declare class PlayerData {
 	 * @description: 获取满足当前直播条件的流
 	 */
 	getCurrentStreams(): Stream[];
-	getStreamsMatchCurrentDefinition(): Stream[];
 	/**
 	 * @description: 获取根据线路ID去重的流，用于获取有几个线路
 	 */
@@ -4456,7 +4309,6 @@ declare class PlayerData {
 	 * @param {number} lineId
 	 */
 	getDefinitionListByLineId(lineId: number | string): Stream[];
-	getDefinitionListForAllLines(): Stream[];
 	/**
 	 * @description: 根据条件筛选符合条件的流list
 	 * @param {Condition} condition
@@ -4467,10 +4319,7 @@ declare class PlayerData {
 	 * @param {boolean} isDown 是否取下一级清晰度
 	 * @param {string[]} demotePriority 清晰度降级顺序
 	 */
-	getNextDefinition(isDown: boolean, demotePriority: string[], allowDemoteToDifferentLine?: boolean): {
-		urls: Stream[];
-		lineId: string | number;
-	};
+	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
 	/**
 	 * 获取api map
 	 * @return { ApiMapConfig }
@@ -5136,7 +4985,7 @@ declare class VePlayer {
 	 * @memberof VePlayer
 	 * @notes - 成功更换视频源后，默认是暂停状态。如果设置了自动播放，则会自动播放。
 	 *        - 此接口不支持切换火山引擎私有加密视频。
-	 * @param config 播放器实例化配置。此接口仅支持 `IPlayerConfig` 中的 `url`、`playList`、`poster`、`getVideoByToken` 字段。。
+	 * @param config 播放器实例化配置。此接口仅支持 `IPlayerConfig` 中的 `url`、`playList`、`poster`、`getVideoByToken`、`vid`、`MemoryPlay` 字段。
 	 * @param isNewVideo 是否为新视频。为 `false` 时，更换后，会从更换前的时间点继续播放。
 	 */
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
@@ -5912,11 +5761,11 @@ export declare const Events: {
 	 */
 	REFRESH_CLICK: string;
 	/** {zh}
-	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
+	 * @brief 报错时触发降级。
 	 */
 	PLAY_BACKUP_CHANGE: string;
 	/** {zh}
-	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
+	 * @brief 报错时触发的降级结束。
 	 */
 	PLAY_BACKUP_CHANGE_FINISH: string;
 	/** {zh}
@@ -5947,15 +5796,6 @@ export declare const Events: {
 	 * @brief 清晰度降级。
 	 */
 	DEFINITION_DEMOTE: string;
-	/** {zh}
-	 * @brief 已降至最低清晰度。
-	 */
-	DEFINITION_DEMOTE_ALL_DONE: string;
-	/** {zh}
-	 * @brief 所有可执行的降级操作均执行完毕。如果用户同时开启了 definition 降级和 fallbackUrl 降级，
-	 * 无论两者哪个优先级更高，待所有可执行的降级操作均执行完毕，会触发该事件。
-	 */
-	DEMOTE_ALL_DONE: string;
 	/** {zh}
 	 * @hidden
 	 */
@@ -6238,10 +6078,6 @@ export declare const Events: {
 	 * @brief `<source>` 加载成功。
 	 */
 	SOURCE_SUCCESS: string;
-	/** {zh}
-	 * @brief 降级事件。
-	 */
-	FALLBACK: string;
 	/** {zh}
 	 * @brief 在播放被终止时触发。例如当播放中的视频重新开始播放。
 	 */
@@ -6561,10 +6397,6 @@ export declare const Event: {
 		 * @brief `<source>` 加载成功。
 		 */
 		SOURCE_SUCCESS: string;
-		/** {zh}
-		 * @brief 降级事件。
-		 */
-		FALLBACK: string;
 	};
 	PluginEvents: {
 		/** {zh}
@@ -6592,11 +6424,11 @@ export declare const Event: {
 		 */
 		REFRESH_CLICK: string;
 		/** {zh}
-		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
+		 * @brief 报错时触发降级。
 		 */
 		PLAY_BACKUP_CHANGE: string;
 		/** {zh}
-		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
+		 * @brief 报错时触发的降级结束。
 		 */
 		PLAY_BACKUP_CHANGE_FINISH: string;
 		/** {zh}
@@ -6627,15 +6459,6 @@ export declare const Event: {
 		 * @brief 清晰度降级。
 		 */
 		DEFINITION_DEMOTE: string;
-		/** {zh}
-		 * @brief 已降至最低清晰度。
-		 */
-		DEFINITION_DEMOTE_ALL_DONE: string;
-		/** {zh}
-		 * @brief 所有可执行的降级操作均执行完毕。如果用户同时开启了 definition 降级和 fallbackUrl 降级，
-		 * 无论两者哪个优先级更高，待所有可执行的降级操作均执行完毕，会触发该事件。
-		 */
-		DEMOTE_ALL_DONE: string;
 		/** {zh}
 		 * @hidden
 		 */