@vkontakte/videoplayer-core 2.0.167-dev.fc8d8316c.0 → 2.0.168-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.167-dev.fc8d8316c.0",
+  "version": "2.0.168-beta.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.96-dev.fc8d8316c.0"
+    "@vkontakte/videoplayer-shared": "1.0.97-beta.0"
   }
 }

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

@@ -74,6 +74,7 @@ export declare class BufferManager {
 	private index;
 	private lastDataObtainedTimestampMs;
 	private loadByteRangeSegmentsTimeoutId;
+	private preDownloadedFirstSegment;
 	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, isActiveLowLatency, compatibilityMode, manifest }: Dependencies);
 	startWith: ReturnType<typeof abortable<[Representation["id"]]>>;
 	switchToWithPreviousAbort(newRepresentationId: Representation["id"], dropBuffer?: boolean): Promise<void | undefined>;
@@ -102,6 +103,7 @@ export declare class BufferManager {
 	private loadSegments;
 	private loadTemplateSegment;
 	private updateRepresentationsBaseUrlIfNeeded;
+	private feedPreDownloadedFirstSegment;
 	private loadByteRangeSegments;
 	private prepareByteRangeFetchSegmentParams;
 	private prepareTemplateFetchSegmentParams;

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

@@ -25,6 +25,8 @@ export interface IParams {
 	handleExtendedNetworkErrorsSet?: boolean;
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
+	measureFastSamples?: boolean;
+	preloadFirstSegment?: boolean;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -47,6 +49,7 @@ export type RepresentationFetchResult = {
 	init: CommonInit | null;
 	segments: Segment[];
 	dataView: DataView;
+	firstSegmentData?: ArrayBuffer;
 };
 export declare class Fetcher {
 	private throughputEstimator;
@@ -69,11 +72,13 @@ export declare class Fetcher {
 	private useEnableSubtitlesParam;
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
+	private measureFastSamples;
+	private preloadFirstSegment;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processPerformanceResourceTiming;
@@ -87,6 +92,7 @@ export declare class Fetcher {
 	destroy(): void;
 	private fetchByteRangeRepresentation;
 	private fetchTemplateRepresentation;
+	private isLikelyCacheHitByTtfb;
 	private doFetch;
 	private unsubscribeAbortSubscription;
 }

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

@@ -25,6 +25,8 @@ export interface IParams {
 	handleExtendedNetworkErrorsSet?: boolean;
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
+	measureFastSamples?: boolean;
+	preloadFirstSegment?: boolean;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -46,6 +48,7 @@ export type RepresentationFetchResult<T extends Segment> = {
 	initMetadata: CommonInit | null;
 	initDataView: DataView;
 	segments: T[];
+	firstSegmentData?: ArrayBuffer;
 };
 export declare class Fetcher {
 	private throughputEstimator;
@@ -68,11 +71,13 @@ export declare class Fetcher {
 	private useEnableSubtitlesParam;
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
+	private measureFastSamples;
+	private preloadFirstSegment;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processResourceTiming;
@@ -86,5 +91,6 @@ export declare class Fetcher {
 	destroy(): void;
 	private fetchByteRangeRepresentation;
 	private fetchTemplateRepresentation;
+	private isLikelyCacheHitByTtfb;
 	private doFetch;
 }

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

@@ -49,6 +49,7 @@ export type ByteRangeSegmentReference = {
 	url: string;
 	initRange: IRange<Byte>;
 	indexRange?: IRange<Byte>;
+	firstSegmentLength?: Byte;
 };
 export type TemplateSegmentReference = {
 	type: SegmentReferencingType.TEMPLATE;

package/types/utils/tuningConfig.d.ts

@@ -43,6 +43,25 @@ export type ITuningConfig = {
 		measureNonSegmentRequests: boolean;
 		smallSampleMinDuration: Milliseconds;
 		cacheThresholdSize: Milliseconds;
+		/**
+		* Фичафлаг UVP-10855: лечит залипание throughput на быстрых соединениях.
+		*
+		* Проблема: на быстром соединении крупный сегмент реально скачивается за ≤ cacheThresholdSize
+		* (например 200 КБ за 10 мс = 160 Мбит/с), а sanityCheck режет такие сэмплы как «кэш».
+		* Промежуточных сэмплов нет (нужно streamMinSampleTime=300 мс), поэтому эстиматор не получает
+		* ни одного значения, throughput стоит на стартовой оценке → ABR не поднимает качество
+		* (мелкие сегменты качаются быстро → замкнутый круг).
+		*
+		* При true:
+		* 1. Фетчер детектит кэш-хиты двумя сигналами (OR) и НЕ измеряет их:
+		*    - fromCache — попадание в Cache API (doFetch дёргает onCacheHit);
+		*    - TTFB — headersReceivedAt - requestStartedAt < max(rtt*0.5, 2мс) (кэш ~0, реал ≥ RTT).
+		* 2. sanityCheck отключает порог time ≤ cacheThresholdSize → реальные быстрые сэмплы проходят.
+		* Честный кэш (мгновенная отдача → rate > 1 Гбит/с) по-прежнему режется проверкой rate выше.
+		*
+		* По умолчанию false — поведение не меняется.
+		*/
+		measureFastSamples: boolean;
 		rttPenaltyRequestSize: Byte;
 		streamMinSampleSize: Byte;
 		streamMinSampleTime: Milliseconds;
@@ -231,6 +250,7 @@ export type ITuningConfig = {
 		filterOnDemandQualityList: boolean;
 		dashMaxTvVideoQuality: boolean;
 		checkRepresentationCanPlayType: Extract<CanPlayTypeResult, "maybe" | "probably"> | false;
+		preloadFirstSegment: boolean;
 		downloadTime: {
 			minLookaheadSegments: number;
 			safetyFactor: number;