@vkontakte/videoplayer-core 2.0.171-dev.ed76c949d.0 → 2.0.171

package/types/utils/autoSelectTrack.d.ts

@@ -1,5 +1,5 @@
 import type { ITuningConfig } from "./tuningConfig";
-import type { Kbps, Milliseconds, IRectangle, QualityLimits, IComponentLogger } from "@vkontakte/videoplayer-shared";
+import type { Kbps, Milliseconds, IRectangle, QualityLimits, IComponentLogger, Nullable } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../player/types";
 interface IConstraints<T extends IBaseTrack> {
@@ -11,6 +11,7 @@ interface IConstraints<T extends IBaseTrack> {
 	playbackRate?: number;
 	forwardBufferHealth?: number;
 	current?: T;
+	failedVideoTrack?: Nullable<T>;
 	visible?: boolean;
 	history?: TrackHistory<T>;
 	droppedVideoMaxQualityLimit?: ExactVideoQuality;
@@ -29,8 +30,8 @@ export declare class TrackHistory<T extends IBaseTrack> {
 export declare const defaultEmptyArrayErrorMessage = "Assertion \"ABR Tracks is empty array\" failed";
 export declare const getMinPossibleAudioForVideoOld: (videoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], minVideoAudioRatio: number) => IAudioTrack | undefined;
 export declare const getMinPossibleAudioForVideoNew: (videoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], minVideoAudioRatio: number) => IAudioTrack | undefined;
-export declare const autoSelectVideoTrackNew: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
-export declare const autoSelectVideoTrackOld: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
+export declare const autoSelectVideoTrackNew: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, failedVideoTrack, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
+export declare const autoSelectVideoTrackOld: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, failedVideoTrack, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
 export declare const autoSelectAudioTrackForVideoOld: (selectedVideoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], { estimatedThroughput, tuning, playbackRate, forwardBufferHealth, history, abrLogger, stallsPredictedThroughput }: IConstraints<IAudioTrack>) => IAudioTrack | undefined;
 export declare const autoSelectAudioTrackForVideoNew: (selectedVideoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], { estimatedThroughput, tuning, playbackRate, forwardBufferHealth, history, abrLogger, stallsPredictedThroughput }: IConstraints<IAudioTrack>) => IAudioTrack | undefined;
 export {};

package/types/utils/buffer/dynamicBufferTarget.d.ts

@@ -0,0 +1,10 @@
+import type { Kbps, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../tuningConfig";
+type DynamicBufferTargetConfig = ITuningConfig["dash"]["dynamicBufferTarget"];
+export interface IDynamicBufferTargetState {
+	throughputKbps: Kbps;
+	currentBitrateKbps: Nullable<Kbps>;
+	baseTargetMs: Milliseconds;
+}
+export declare const computeDynamicBufferTarget: (state: IDynamicBufferTargetState, config: DynamicBufferTargetConfig) => Milliseconds;
+export {};

package/types/utils/tuningConfig.d.ts

@@ -2,7 +2,7 @@ import type { VideoCodecName, VideoFormat } from "../player/types";
 import { WebmCodecStrategy } from "../enums/WebmCodecStrategy";
 import { AndroidPreferredFormat } from "../enums/AndroidPreferredFormat";
 import { IOSPreferredFormat } from "../enums/IOSPreferredFormat";
-import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds, TimerModule } from "@vkontakte/videoplayer-shared";
+import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { AudioRuleName, VideoRuleName } from "../providers/utils/Abr/types";
 export type ITuningConfig = {
@@ -13,23 +13,24 @@ export type ITuningConfig = {
 		playingUnstableThresholdMs: Milliseconds;
 		/** Список имён включённых эвристик. Пустой массив = все эвристики выключены */
 		heuristics: string[];
-		/** Множитель уменьшения grace-таймаута при каждом поступлении данных в StartupHangupHeuristic */
-		hangupGraceDecayFactor: number;
-		/** Минимальный grace-таймаут (мс). При достижении — следующий decay возвращает 0 (немедленный expire) */
-		hangupGraceMinTimeoutMs: Milliseconds;
-		/**
-		* Если true — audible (не muted) хэнгап в hidden-вкладке откладывается до возврата на visible (reinit),
-		* desired state при этом не меняется.
-		* Если false — audible хэнгап в hidden-вкладке мониторится: данные перезапускают decay-таймер,
-		* при ≥3 поступлениях данных без завершения перехода — эскалация в switch_codec/switch_provider.
-		*/
-		deferAudibleHangupOnHiddenTab: boolean;
 	};
 	/**
+	* Если true, внутренний video элемент не будет уничтожаться при реините провайдера
+	* и при создании нового экземляра Player.
+	* Будет веcти себя аналогично элементу переданному снаружи
+	* Для кейса прямого использовани ядра
+	*/
+	keepVideoElement: boolean;
+	/**
+	* Временный флаг для тестирования очистки video элемента
+	* Если true, при очистке будет вызван innerHTML = '' для очистки дочерних элементов трэков
+	* В противном случае они размножаются
+	*/
+	clearVideoElementInnerHTML: boolean;
+	/**
 	* Включает очистку состояния плеера при вызове метода stop()
 	*/
 	allowPlayerReuse: boolean;
-	useWorkerTimers: TimerModule[];
 	throughputEstimator: {
 		type: "TwoEma" | "EmaAndMa";
 		emaAlphaSlow: number;
@@ -118,7 +119,6 @@ export type ITuningConfig = {
 		activeVideoAreaThreshold: number;
 		trafficSavingLimit: ExactVideoQuality;
 		highQualityLimit: ExactVideoQuality;
-		lowQualityTelemetryLimit: ExactVideoQuality;
 	};
 	stallsManager: {
 		enabled: boolean;
@@ -159,6 +159,7 @@ export type ITuningConfig = {
 		forwardBufferTargetManual: Milliseconds;
 		forwardBufferTargetPreload: Milliseconds;
 		audioBufferAheadOfVideoMs: Milliseconds;
+		useDynamicBufferTarget: boolean;
 		seekBiasInTheEnd: Milliseconds;
 		maxSegmentDurationLeftToSelectNextSegment: Milliseconds;
 		minSafeBufferThreshold: number;
@@ -181,12 +182,14 @@ export type ITuningConfig = {
 		useSmartRepresentationSwitch: boolean;
 		stallForceSeekOncePerStall: boolean;
 		useFetchPriorityHints: boolean;
+		useAbortMSEFix: boolean;
 		enableBaseUrlSupport: boolean;
 		maxSegmentRetryCount: number;
 		sourceOpenTimeout: number;
 		vktvAbrThrottle: number;
 		timeupdateEventTickThrottle: number;
 		fetcherBufferOptimisation: boolean;
+		codecsPrioritizeEnabled: boolean;
 		usePersistentGaps: boolean;
 		abrThrottle: number;
 		useVideoElementWaitingCurrentTimeReassign: boolean;
@@ -205,7 +208,9 @@ export type ITuningConfig = {
 		abrVideoRules: VideoRuleName[];
 		abrAudioRules: AudioRuleName[];
 		useDynamicBirtateRule: boolean;
+		useNewFailoverLogic: boolean;
 		useFailoverHostsOnAllProviderCrash: boolean;
+		videoTrackBanAfterProviderFail: Milliseconds;
 		saveData3gQualityLimit: ExactVideoQuality;
 		saveData2gQualityLimit: ExactVideoQuality;
 		useConnectionDataUpperLimit: boolean;
@@ -233,14 +238,26 @@ export type ITuningConfig = {
 			budgetFactor: number;
 			fallbackSegmentDurationMs: Milliseconds;
 		};
+		dynamicBufferTarget: {
+			maxMs: Milliseconds;
+			optimisticHeadroomLow: number;
+			optimisticHeadroomHigh: number;
+			weakThroughputLowKbps: Kbps;
+			weakThroughputHighKbps: Kbps;
+			maxFactor: number;
+		};
 		videoStreamRepresentaionsFilter: [VideoQuality, number, VideoCodecName][];
 		filterOnDemandQualityList: boolean;
 		dashMaxTvVideoQuality: boolean;
 		checkRepresentationCanPlayType: Extract<CanPlayTypeResult, "maybe" | "probably"> | false;
 		preloadFirstSegment: boolean;
 		maxQualityForFirstSegmentPreload: ExactVideoQuality;
-		/** Включает отправку телеметрии трейсера (resume) при превышении stall watchdog */
-		tracerResumeOnUnexpectedStall: boolean;
+		downloadTime: {
+			minLookaheadSegments: number;
+			safetyFactor: number;
+			bootstrapBufferMs: Milliseconds;
+			demandTolerance: number;
+		};
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -437,14 +454,6 @@ export type ITuningConfig = {
 	useDurationFromSegments: boolean;
 	/** включен режим проигрывания только аудио (без видео) */
 	audioOnly: boolean;
-	/**
-	* Переводить провайдер в READY по loadedmetadata вместо canplay.
-	* canplay означает, что видео уже может играться, что избыточно для READY —
-	* достаточно получить манифест (loadedmetadata).
-	* Применяется только когда желаемое состояние — READY (preload): при автоплее
-	* провайдер по-прежнему ждёт canplay, чтобы play() не вызывался до появления данных.
-	*/
-	readyOnLoadedMetadata: boolean;
 };
 export type IOptionalTuningConfig = RecursivePartial<ITuningConfig>;
 export declare const fillDefault: (partial: IOptionalTuningConfig) => ITuningConfig;

package/types/providers/ProviderContainer/Mayday/GraceTimeout.d.ts

@@ -1,17 +0,0 @@
-import type { Milliseconds } from "@vkontakte/videoplayer-shared";
-/**
-* Декрементный grace-таймаут: каждый вызов `decay()` уменьшает оставшееся время.
-*
-* После создания `current` возвращает начальное значение.
-* Каждый вызов `decay()` умножает `remaining` на `decayFactor`, но не меньше `minTimeout`.
-* Когда `remaining` достигает `minTimeout` — следующий `decay()` возвращает 0 (expire).
-*/
-export declare class GraceTimeout {
-	private remaining;
-	private readonly decayFactor;
-	private readonly minTimeout;
-	constructor(initialTimeout: Milliseconds, decayFactor: number, minTimeout: Milliseconds);
-	get current(): Milliseconds;
-	decay(): Milliseconds;
-	reset(initialTimeout: Milliseconds): void;
-}

package/types/providers/ProviderContainer/Mayday/heuristics/StartupHangupHeuristic.d.ts

@@ -1,46 +0,0 @@
-import { Subject } from "@vkontakte/videoplayer-shared";
-import type { IError } from "@vkontakte/videoplayer-shared";
-import type { IHeuristicDeps, IMaydayEvent } from "../types";
-import type { IAsyncHeuristic, HeuristicResult } from "./IHeuristic";
-/**
-* Эвристика зависания перехода stopped-*.
-*
-* В зависимости от видимости вкладки и наличия звука выбирает стратегию
-* и эмитит одну из рекомендаций:
-*
-* Visible-вкладка: grace-таймаут с уменьшением таймаута на поступление данных.
-*   — данные поступают → таймер продлевается.
-*   — grace истёк без прогресса → emit switch_codec (или switch_provider).
-*
-* Hidden-вкладка (audible): та же grace-модель с таймаутом (таймеры в воркере не тротлятся).
-*   — данные поступают → таймер продлевается.
-*   — grace истёк без прогресса → emit switch_codec.
-*
-* Hidden-вкладка (muted/deferred): молча ждём возврата на visible, desired state не трогаем.
-*   — вкладка стала visible → emit reinit (полный реинит сам восстановит воспроизведение).
-*   — переход всё-таки завершился в фоне (видео заиграло) → отмена, reinit не нужен.
-*/
-export declare class StartupHangupHeuristic implements IAsyncHeuristic {
-	private deps;
-	static readonly heuristicName = "StartupHangupHeuristic";
-	readonly type = "async";
-	readonly recommendation$: Subject<IMaydayEvent>;
-	private timerId;
-	private subscription;
-	private error;
-	private grace;
-	private hangupStartedAt;
-	private dataArrivals;
-	private hiddenWaitActive;
-	constructor(deps: IHeuristicDeps);
-	analyze(error: IError): HeuristicResult;
-	private startMonitoring;
-	private waitForVisible;
-	private restartTimer;
-	private recommendSwitch;
-	private isTabHidden;
-	private logOutcome;
-	private cancel;
-	reset(): void;
-	destroy(): void;
-}

package/types/providers/ProviderContainer/Mayday/heuristics/TvFetcherErrorHeuristic.d.ts

@@ -1,10 +0,0 @@
-import type { IError } from "@vkontakte/videoplayer-shared";
-import type { IHeuristicDeps } from "../types";
-import type { ISyncHeuristic, HeuristicResult } from "./IHeuristic";
-export declare class TvFetcherErrorHeuristic implements ISyncHeuristic {
-	private _deps;
-	static readonly heuristicName = "TvFetcherErrorHeuristic";
-	readonly type = "sync";
-	constructor(_deps: IHeuristicDeps);
-	analyze(error: IError): HeuristicResult;
-}

package/types/utils/timers.d.ts

@@ -1,2 +0,0 @@
-import type { ITimers } from "@vkontakte/videoplayer-shared";
-export declare const timers: ITimers;