@volcengine/veplayer 1.10.0 → 1.11.0-rc.1

package/index.d.ts

@@ -79,8 +79,21 @@ 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;
@@ -810,6 +823,61 @@ export interface IDefinitionDemotePlugin {
 	 *        - `true`: automatic downgrade is enabled.
 	 */
 	isNeedAutoDemote?: 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.
+	 */
+	shouldDemoteDefinitionFirst?: 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.
+	 */
+	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;
+	/**
+	 * @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;
 	/**
 	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
@@ -871,6 +939,10 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	longWaitingEmitTime: number;
 	waitingStartTime: number;
 	playerData: PlayerData;
+	fallbackState: {
+		retryTimes: number;
+		idx: number;
+	};
 	static get defaultConfig(): IDefinitionDemotePlugin;
 	constructor(args: any);
 	registerLanguageTexts(): {
@@ -890,6 +962,12 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	_clearTime(): void;
 	clearState(): void;
 	demote(): void;
+	executeDemoteFallbackFirst(): void;
+	executeDemoteDefinitionFirst(): void;
+	getRetryListForCurrentDefinition(): any[];
+	getRetryListForCurrentDefinitionAcrossAllLines(): any[];
+	resetTimes(): void;
+	changeMainOrBackup(): boolean;
 	changeUrl(url: Url): void;
 	showToast(definition: Stream): void;
 	destroy(): void;
@@ -4288,6 +4366,7 @@ declare class PlayerData {
 	 * @description: 获取满足当前直播条件的流
 	 */
 	getCurrentStreams(): Stream[];
+	getStreamsMatchCurrentDefinition(): Stream[];
 	/**
 	 * @description: 获取根据线路ID去重的流，用于获取有几个线路
 	 */
@@ -5754,11 +5833,11 @@ export declare const Events: {
 	 */
 	REFRESH_CLICK: string;
 	/** {zh}
-	 * @brief 报错时触发降级。
+	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
 	 */
 	PLAY_BACKUP_CHANGE: string;
 	/** {zh}
-	 * @brief 报错时触发的降级结束。
+	 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
 	 */
 	PLAY_BACKUP_CHANGE_FINISH: string;
 	/** {zh}
@@ -5789,6 +5868,15 @@ 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
 	 */
@@ -6417,11 +6505,11 @@ export declare const Event: {
 		 */
 		REFRESH_CLICK: string;
 		/** {zh}
-		 * @brief 报错时触发降级。
+		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl。
 		 */
 		PLAY_BACKUP_CHANGE: string;
 		/** {zh}
-		 * @brief 报错时触发的降级结束。
+		 * @brief 发生报错，卡顿时，在同清晰度等级下，触发降级至 fallbackUrl, 所有可执行降级结束，无可用 fallbackUrl
 		 */
 		PLAY_BACKUP_CHANGE_FINISH: string;
 		/** {zh}
@@ -6452,6 +6540,15 @@ 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
 		 */