@volcengine/veplayer 1.11.0-rc.1 → 1.11.0-rc.3

package/index.d.ts

@@ -811,20 +811,46 @@ export interface ITextItem {
  */
 export interface IDefinitionDemotePlugin {
 	/**
-	 * @brief 是否开启自动降级，取值如下：
+	 * @brief 长卡顿情况下是否开启自动降级，取值如下：
 	 *        - `false`：关闭自动降级。
 	 *        - `true`：开启自动降级。
 	 * @default true
 	 *
 	 */
 	/** {en}
-	 * @brief Is automatic downgrade enabled? The values are as follows:
+	 * @brief Is automatic downgrade enabled for long waiting? The values are as follows:
 	 *        - `false`: automatic downgrade is disabled.
 	 *        - `true`: automatic downgrade is enabled.
 	 */
-	isNeedAutoDemote?: boolean;
+	isNeedAutoDemoteWhenLongWaiting?: boolean;
+	/**
+	 * @brief 频繁卡顿情况下是否开启自动降级，取值如下：
+	 *        - `false`：关闭自动降级。
+	 *        - `true`：开启自动降级。
+	 * @default true
+	 *
+	 */
+	/** {en}
+	 * @brief Is automatic downgrade enabled for often waiting? 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，取值如下：
+	 * @brief 频繁卡顿情况下，当用户开启 fallbackUrl 降级（降级到备用线路) 时，优先降级清晰度还是 fallbackUrl，取值如下：
 	 *        - `false`：优先在同一个清晰度的所有 fallback 之间切换, 都有问题的情况下，再降低到下一个清晰度
 	 *        - `true`：优先降级清晰度, 清晰度降到最低之后，再在最后一个清晰度的 fallbackUrl 之间切换
 	 * @default false
@@ -835,9 +861,9 @@ export interface IDefinitionDemotePlugin {
 	 *        - `false`: not demote quality first.
 	 *        - `true`: demote quality first.
 	 */
-	shouldDemoteDefinitionFirst?: boolean;
+	shouldDemoteDefinitionFirstWhenOftenWaiting?: boolean;
 	/**
-	 * @brief 是否开启 fallbackUrl 降级：
+	 * @brief 长卡顿情况下是否开启 fallbackUrl 降级：
 	 *        - `false`：不尝试降级到备用线路。
 	 *        - `true`：尝试降级到备用线路。
 	 * @default true
@@ -848,9 +874,22 @@ export interface IDefinitionDemotePlugin {
 	 *        - `false`: not try to play fallbackUrl first.
 	 *        - `true`: try to play fallbackUrl first before demote definition.
 	 */
-	isNeedDemoteBack?: boolean;
+	isNeedDemoteBackWhenLongWaiting?: boolean;
 	/**
-	 * @brief 是否允许回退到同清晰度不同线路的 fallbackurl：
+	 * @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
@@ -861,7 +900,20 @@ export interface IDefinitionDemotePlugin {
 	 *        - `false`: only demote in current definition line.
 	 *        - `true`: allow demote to different line.
 	 */
-	allowDemoteToDifferentLine?: boolean;
+	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
@@ -930,11 +982,25 @@ 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;
@@ -943,6 +1009,7 @@ export declare class DefinitionDemotePlugin extends Plugin {
 		retryTimes: number;
 		idx: number;
 	};
+	isDemoting: boolean;
 	static get defaultConfig(): IDefinitionDemotePlugin;
 	constructor(args: any);
 	registerLanguageTexts(): {
@@ -961,14 +1028,21 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_time(): void;
 	_clearTime(): void;
 	clearState(): void;
-	demote(): void;
-	executeDemoteFallbackFirst(): void;
-	executeDemoteDefinitionFirst(): void;
-	getRetryListForCurrentDefinition(): any[];
-	getRetryListForCurrentDefinitionAcrossAllLines(): any[];
+	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(): boolean;
-	changeUrl(url: Url): void;
+	changeMainOrBackup(reason: FALLBACK_REASON): boolean;
+	changeUrl(url: Url, source: string | number): void;
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
@@ -3580,7 +3654,7 @@ export interface IPlayAuthTokenConfig {
 	 */
 	autoDemoteDefinition?: string;
 	/** {zh}
-	 * @brief 开启清晰度自动降级（`isNeedAutoDemote` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
+	 * @brief 开启清晰度自动降级（`isNeedAutoDemoteWhenLongWaiting` 为 `true`）时的自动档位对应的多语言文案 key，取值对应 `languages` 字段中各语种的 `key`。
 	 * @notes 如果指定的清晰度，playAuthToken从服务端返回的清晰度列表中不存在该清晰度，则此参数无效。
 	 * @default -
 	 */
@@ -4381,6 +4455,7 @@ declare class PlayerData {
 	 * @param {number} lineId
 	 */
 	getDefinitionListByLineId(lineId: number | string): Stream[];
+	getDefinitionListForAllLines(): Stream[];
 	/**
 	 * @description: 根据条件筛选符合条件的流list
 	 * @param {Condition} condition
@@ -4391,7 +4466,10 @@ declare class PlayerData {
 	 * @param {boolean} isDown 是否取下一级清晰度
 	 * @param {string[]} demotePriority 清晰度降级顺序
 	 */
-	getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
+	getNextDefinition(isDown: boolean, demotePriority: string[], allowDemoteToDifferentLine?: boolean): {
+		urls: Stream[];
+		lineId: string | number;
+	};
 	/**
 	 * 获取api map
 	 * @return { ApiMapConfig }
@@ -6159,6 +6237,10 @@ export declare const Events: {
 	 * @brief `<source>` 加载成功。
 	 */
 	SOURCE_SUCCESS: string;
+	/** {zh}
+	 * @brief 降级事件。
+	 */
+	FALLBACK: string;
 	/** {zh}
 	 * @brief 在播放被终止时触发。例如当播放中的视频重新开始播放。
 	 */
@@ -6478,6 +6560,10 @@ export declare const Event: {
 		 * @brief `<source>` 加载成功。
 		 */
 		SOURCE_SUCCESS: string;
+		/** {zh}
+		 * @brief 降级事件。
+		 */
+		FALLBACK: string;
 	};
 	PluginEvents: {
 		/** {zh}