@vkontakte/videoplayer-core 2.0.169-dev.b7ed8d2a3.0 → 2.0.170-dev.0bc518265.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.169-dev.b7ed8d2a3.0",
+  "version": "2.0.170-dev.0bc518265.0",
   "author": "vk.ru",
   "description": "Videoplayer core library based on the vk.ru platform",
   "homepage": "https://vk.ru",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.98-dev.b7ed8d2a3.0"
+    "@vkontakte/videoplayer-shared": "1.0.99-dev.0bc518265.0"
   }
 }

package/types/providers/DashLiveProvider/utils/LiveDashPlayer.d.ts

@@ -49,6 +49,8 @@ export default class LiveDashPlayer {
 	private bufferStates;
 	private downloadRate?;
 	private sourceJitter;
+	/** Токен для защиты от устаревших callback'ов sourceopen при многократных вызовах _setVideoSrc */
+	private srcToken;
 	private chunkRateEstimator;
 	private manifestUrl;
 	private urlResolver;

package/types/providers/DashProvider/baseDashProvider.d.ts

@@ -16,7 +16,6 @@ import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
-	failedVideoTrack?: Nullable<IVideoTrack>;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };
@@ -34,7 +33,6 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
-	protected failedVideoTrack: Nullable<IVideoTrack>;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;

package/types/providers/DashProvider/lib/fetcher.d.ts

@@ -2,6 +2,7 @@ import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } f
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
 import type { Byte, IValueSubject, ISubject, Milliseconds, IRange, ITracer, IError } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
+import type { ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import type { CommonInit, GenericContainerParser, Segment, SegmentReference } from "../../utils/parsers/types";
 declare global {
 	interface Navigator {
@@ -27,6 +28,7 @@ export interface IParams {
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
 	preloadFirstSegment?: boolean;
+	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -44,6 +46,7 @@ export interface FetchParams {
 	bufferOptimisation?: boolean;
 	ignoreNetworkErrors?: boolean;
 	urlCacheMechanismEnabled?: boolean;
+	representationHeight?: number;
 }
 export type RepresentationFetchResult = {
 	init: CommonInit | null;
@@ -74,11 +77,12 @@ export declare class Fetcher {
 	private measureNonSegmentRequests;
 	private measureFastSamples;
 	private preloadFirstSegment;
+	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processPerformanceResourceTiming;

package/types/providers/DashProviderVirtual/baseDashProvider.d.ts

@@ -16,7 +16,6 @@ import { AbrManager } from "../utils/Abr/abrManager";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
-	failedVideoTrack?: Nullable<IVideoTrack>;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };

package/types/providers/DashProviderVirtual/lib/buffer/virtualBuffer/baseVirtualBufferManager.versionA.d.ts

@@ -79,8 +79,26 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	setPreloadOnly(preloadOnly: boolean): void;
 	destroy(): void;
 	protected verifyBufferPlaybackQueue(position: Milliseconds): Promise<void>;
+	/**
+	* Удаляет из `bufferPlaybackQueue` «зомби»-сегменты — те, что попали в очередь через
+	* `onSomeDataLoaded` → `onDownloadItem` (sub-segment feeding) со статусом `DOWNLOADING`,
+	* а затем были сброшены в `NONE` вызовом `abortDownloadingItems` (`data` = null, `loadedBytes` = 0),
+	* но из самой очереди не удалены.
+	*
+	* Зомби вызывает дедлок:
+	* 1. `maintain` → `maintainPlaybackBuffer` → `selectDownloadingItems` начинает выбор новых сегментов
+	*    для скачивания после последнего элемента `bufferPlaybackQueue`. Зомби в очереди сдвигает
+	*    эту позицию вперёд — сегмент пропускается и никогда не перевыбирается.
+	* 2. `maintain` → `maintainNativeBuffer` ищет `nextPlayingItem` как первый элемент с `bufferStatus` !== `FED`.
+	*    Находит зомби, но не может его скормить (`data` = null) и не переходит к следующим сегментам.
+	*
+	* Метод вызывается в `maintain` между `verifyBufferPlaybackQueue` и `maintainPlaybackBuffer`,
+	* чтобы очистить очередь до того, как `selectDownloadingItems` начнёт по ней работать.
+	*/
+	protected sanitizeBufferPlaybackQueue(): boolean;
 	protected forceSwitchCondition(oldRepresentation: Representation, newRepresentation: Representation): boolean;
 	protected clearBuffer(): Promise<void>;
+	private resetBuffer;
 	protected abortDownload(): void;
 	protected abortDownloadingItems(): void;
 	protected abortNativeBuffer(): Promise<boolean>;

package/types/providers/DashProviderVirtual/lib/fetcher.d.ts

@@ -2,6 +2,7 @@ import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } f
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
 import type { Byte, IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
+import type { ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import type { CommonInit, GenericContainerParser, Segment, SegmentReference } from "../../utils/parsers/types";
 declare global {
 	interface Navigator {
@@ -27,6 +28,7 @@ export interface IParams {
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
 	preloadFirstSegment?: boolean;
+	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -73,11 +75,12 @@ export declare class Fetcher {
 	private measureNonSegmentRequests;
 	private measureFastSamples;
 	private preloadFirstSegment;
+	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processResourceTiming;
@@ -87,7 +90,7 @@ export declare class Fetcher {
 	private trackRequestStart;
 	fetchManifest: ReturnType<typeof abortable<[string], string | null>>;
 	fetch: ReturnType<typeof abortable<[string, FetchParams], ArrayBuffer | null>>;
-	fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, dowbloadAbortSignal: AbortSignal, priority?: Priority): Promise<RepresentationFetchResult<T> | null | undefined>;
+	fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, dowbloadAbortSignal: AbortSignal, priority?: Priority, representationHeight?: number): Promise<RepresentationFetchResult<T> | null | undefined>;
 	destroy(): void;
 	private fetchByteRangeRepresentation;
 	private fetchTemplateRepresentation;

package/types/providers/DashProviderVirtual/lib/player/basePlayer.d.ts

@@ -23,6 +23,8 @@ export declare abstract class BasePlayer {
 	protected stallTracer: ITracer | null;
 	protected forceVideoCodec?: VideoCodec;
 	protected stallTimeInWaitingExitAttemptMade: Milliseconds;
+	protected stallStartTime: Milliseconds | null;
+	protected lastForceSeekTimestamp: Milliseconds | null;
 	protected videoBufferManager: IVirtualBufferManager | null;
 	protected audioBufferManager: IVirtualBufferManager | null;
 	protected bufferManagers: IVirtualBufferManager[];

package/types/providers/ProviderContainer/index.d.ts

@@ -35,7 +35,6 @@ export default class ProviderContainer implements IProviderContainer {
 	private tracer;
 	private params;
 	private currentProviderStarted;
-	private currentFailedVideoTrack;
 	private volumeMultiplierManager;
 	private dashMaxTvVideoQuality;
 	private mayday;

package/types/providers/utils/Abr/types.d.ts

@@ -15,7 +15,6 @@ export declare enum VideoRuleName {
 	Buffer = "buffer_rule",
 	Bola = "bola_rule",
 	FitsContainer = "fits_container_rule",
-	FailedVideoTrack = "failed_video_track_rule",
 	TvDisabledVideoTrack = "tv_disabled_video_track_rule",
 	Stalls = "stalls_rule",
 	LowerLimit = "lower_limit_rule",
@@ -59,7 +58,6 @@ export interface IInitAbrManagerContext {
 	rtt$: IValueSubject<Milliseconds>;
 	throughputVariance$?: IValueSubject<number>;
 	element: HTMLMediaElement;
-	failedVideoTrack: Nullable<IVideoTrack>;
 	abrLogger: IComponentLogger;
 	panelSize?: IRectangle;
 }

package/types/utils/ClientChecker/services/DisplayChecker.d.ts

@@ -1,4 +1,5 @@
 import type { Checker } from "../types/checker";
+import { DisplayMode } from "../types/displayMode";
 export { isMobile } from "../utils/isMobile";
 export declare class DisplayChecker implements Checker {
 	private _maxTouchPoints;
@@ -9,6 +10,8 @@ export declare class DisplayChecker implements Checker {
 	private _screenHeight;
 	private _screenWidth;
 	private _colorDepth;
+	private _displayMode;
+	private _isStandalone;
 	get isTouch(): boolean;
 	get maxTouchPoints(): number;
 	get height(): number;
@@ -18,5 +21,8 @@ export declare class DisplayChecker implements Checker {
 	get pixelRatio(): number;
 	get isHDR(): boolean;
 	get colorDepth(): number;
+	get displayMode(): DisplayMode;
+	get isStandalone(): boolean;
 	detect(): void;
+	private detectDisplayMode;
 }

package/types/utils/ClientChecker/types/displayMode.d.ts

@@ -0,0 +1,8 @@
+export declare enum DisplayMode {
+	Browser = "browser",
+	Standalone = "standalone",
+	MinimalUi = "minimal-ui",
+	Fullscreen = "fullscreen",
+	WindowControlsOverlay = "window-controls-overlay",
+	PictureInPicture = "picture-in-picture"
+}

package/types/utils/autoSelectTrack.d.ts

@@ -1,5 +1,5 @@
 import type { ITuningConfig } from "./tuningConfig";
-import type { Kbps, Milliseconds, IRectangle, QualityLimits, IComponentLogger, Nullable } from "@vkontakte/videoplayer-shared";
+import type { Kbps, Milliseconds, IRectangle, QualityLimits, IComponentLogger } 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,7 +11,6 @@ interface IConstraints<T extends IBaseTrack> {
 	playbackRate?: number;
 	forwardBufferHealth?: number;
 	current?: T;
-	failedVideoTrack?: Nullable<T>;
 	visible?: boolean;
 	history?: TrackHistory<T>;
 	droppedVideoMaxQualityLimit?: ExactVideoQuality;
@@ -30,8 +29,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, 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 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 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/tuningConfig.d.ts

@@ -184,6 +184,7 @@ export type ITuningConfig = {
 		mutexStallExitPolicy: boolean;
 		useFetchPriorityHints: boolean;
 		useAbortMSEFix: boolean;
+		useByteRangeNullFetchRecovery: boolean;
 		enableBaseUrlSupport: boolean;
 		maxSegmentRetryCount: number;
 		sourceOpenTimeout: number;
@@ -202,7 +203,6 @@ export type ITuningConfig = {
 		minNativeBufferSize: Milliseconds;
 		removeTimeShiftFromSegment: Milliseconds;
 		tickMaintainInterval: Milliseconds;
-		tickMaintainThrottle: Milliseconds;
 		minSafeBufferToPlay: Milliseconds;
 		useBufferHoldingOnlyOnStall: boolean;
 		useNewAbr: boolean;
@@ -210,9 +210,7 @@ export type ITuningConfig = {
 		abrVideoRules: VideoRuleName[];
 		abrAudioRules: AudioRuleName[];
 		useDynamicBirtateRule: boolean;
-		useNewFailoverLogic: boolean;
 		useFailoverHostsOnAllProviderCrash: boolean;
-		videoTrackBanAfterProviderFail: Milliseconds;
 		saveData3gQualityLimit: ExactVideoQuality;
 		saveData2gQualityLimit: ExactVideoQuality;
 		useConnectionDataUpperLimit: boolean;
@@ -253,6 +251,8 @@ export type ITuningConfig = {
 		dashMaxTvVideoQuality: boolean;
 		checkRepresentationCanPlayType: Extract<CanPlayTypeResult, "maybe" | "probably"> | false;
 		preloadFirstSegment: boolean;
+		jumpGapToNearestBuffer: boolean;
+		maxQualityForFirstSegmentPreload: ExactVideoQuality;
 		downloadTime: {
 			minLookaheadSegments: number;
 			safetyFactor: number;
@@ -456,6 +456,14 @@ 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/utils/Abr/rules/video/failedVideoTrackRule.d.ts

@@ -1,14 +0,0 @@
-import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext } from "../../types";
-import type { IVideoTrack } from "../../../../../player/types";
-import type { Nullable } from "@vkontakte/videoplayer-shared";
-import { LimitAboveRule } from "../limitAboveRule";
-import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
-type FailedVideoTracLogsArgs = [banTrack: Nullable<IVideoTrack>];
-export declare class FailedVideoTrackRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, FailedVideoTracLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
-	protected banTrack: Nullable<IVideoTrack>;
-	constructor(phaseConfig: RulePhaseConfig);
-	init(initContext: IRuleInitContext): void;
-	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, banTrack: Nullable<IVideoTrack>): string;
-}
-export {};