@vkontakte/videoplayer-core 2.0.173 → 2.0.174-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.173",
+  "version": "2.0.174-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.102"
+    "@vkontakte/videoplayer-shared": "1.0.103-beta.0"
   }
 }

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

@@ -34,4 +34,5 @@ export default class DashLiveProvider implements IProvider {
 	private seek;
 	private _dashCb;
 	private syncPlayback;
+	private isSeekOffsetSupported;
 }

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

@@ -5,4 +5,5 @@ export default class DashCmafLiveProvider extends BaseDashProvider {
 	constructor(params: IParams);
 	protected override subscribe(): void;
 	protected override seek(position: Milliseconds): void;
+	private isSeekOffsetSupported;
 }

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

@@ -84,6 +84,7 @@ export declare class BufferManager {
 	switchTo: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
 	switchToOld: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
 	warmUpMediaSource(): void;
+	private releaseStrandedSegment;
 	abort(): Promise<boolean>;
 	maintain(currentPosition?: Milliseconds | undefined): void;
 	get lastDataObtainedTimestamp(): number;

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

@@ -27,6 +27,7 @@ export interface IParams {
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
+	cacheHitTtfbMaxMs?: Milliseconds;
 	preloadFirstSegment?: boolean;
 	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
@@ -76,13 +77,14 @@ export declare class Fetcher {
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
 	private measureFastSamples;
+	private cacheHitTtfbMaxMs;
 	private preloadFirstSegment;
 	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, cacheHitTtfbMaxMs, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processPerformanceResourceTiming;

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

@@ -1,4 +1,5 @@
 import type { Byte, IError, ISubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../../../utils/tuningConfig";
 declare class SourceBufferTaskQueue {
 	bufferFull$: ISubject<Byte>;
 	error$: ISubject<IError>;
@@ -7,7 +8,8 @@ declare class SourceBufferTaskQueue {
 	private currentTask;
 	private destroyed;
 	private abortRequested;
-	constructor(buffer: SourceBuffer);
+	private readonly tuning;
+	constructor(buffer: SourceBuffer, tuning: ITuningConfig);
 	append(data: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	remove(from: Milliseconds, to: Milliseconds, signal?: AbortSignal): Promise<boolean>;
 	abort(init?: BufferSource): Promise<boolean>;

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

@@ -27,6 +27,7 @@ export interface IParams {
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
+	cacheHitTtfbMaxMs?: Milliseconds;
 	preloadFirstSegment?: boolean;
 	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
@@ -75,13 +76,14 @@ export declare class Fetcher {
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
 	private measureFastSamples;
+	private cacheHitTtfbMaxMs;
 	private preloadFirstSegment;
 	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, cacheHitTtfbMaxMs, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processResourceTiming;

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

@@ -30,4 +30,5 @@ export default class HlsLiveProvider implements IProvider {
 	private seek;
 	private syncPlayback;
 	private generateLiveUrl;
+	private isSeekOffsetSupported;
 }

package/types/providers/HlsProvider/manifestDataExtractor.d.ts

@@ -12,6 +12,8 @@ export type ManifestUrl = {
 	bandwidth?: Kbps;
 	size?: IRectangle;
 	fps?: number;
+	/** HLS fMP4: идентификатор аудио-группы (EXT-X-MEDIA GROUP-ID), к которой привязан вариант через STREAM-INF AUDIO= */
+	audioGroupId?: string;
 };
 export type HLSManifestData = {
 	qualityManifests: ManifestUrl[];

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

@@ -0,0 +1,12 @@
+import type { ManifestUrl } from "../HlsProvider/manifestDataExtractor";
+export declare const FMP4_QUALITY_QUERY_PARAMS: readonly ["mq", "lq"];
+/**
+* HLS fMP4: дочерний плейлист варианта не содержит EXT-X-MEDIA групп, поэтому нативный HLS
+* не знает какую аудио-группу подцепить и продолжает держать предыдущую — звук пропадает при
+* смене качества. Решение — грузить мастер-плейлист с зафиксированным качеством через
+* mq=lq=<height>, тогда бэк сам отдаст нужный вариант с правильной аудио-группой.
+*
+* Возвращает undefined, если у варианта нельзя надёжно определить высоту — в этом случае
+* лучше оставить дефолтное поведение провайдера, чем отправлять мусор в URL.
+*/
+export declare const buildFmp4MasterUrl: (masterUrl: string, qualityManifest: ManifestUrl) => URL | undefined;

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

@@ -4,6 +4,7 @@ export declare enum OffsetParameterType {
 	PLAYBACK_SHIFT = 1,
 	DASH_CMAF_OFFSET_P = 2
 }
+export declare const hasOffsetMarker: (url: string) => boolean;
 declare const _default: (url: string, offset?: Milliseconds, type?: OffsetParameterType) => string;
 export default _default;
 export declare const getLiveUrlOffset: (url: string, type: OffsetParameterType) => number;

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

@@ -1,6 +1,7 @@
 import { CurrentClientDevice } from "../types/currentClientDevice";
 import type { DisplayChecker } from "./DisplayChecker";
 import type { Checker } from "../types/checker";
+import type { HighEntropyValues } from "../types/userAgentData";
 export interface OS {
 	name: string;
 	version: string;
@@ -10,6 +11,12 @@ export interface DeviceDetails {
 	vendor: string;
 	model: string;
 }
+export interface DeviceHardware {
+	cpuCores?: number;
+	memoryGb?: number;
+	gpuVendor?: string;
+	gpuArchitecture?: string;
+}
 export declare class DeviceChecker implements Checker {
 	private _displayChecker;
 	private _isMobile;
@@ -18,10 +25,14 @@ export declare class DeviceChecker implements Checker {
 	private _highEntropyValues;
 	private _os;
 	private _details;
+	private _hardware;
+	private _gpuDetection;
 	constructor(displayChecker: DisplayChecker);
 	get current(): CurrentClientDevice;
 	get os(): OS;
 	get details(): DeviceDetails;
+	get hardware(): DeviceHardware;
+	get highEntropyValues(): HighEntropyValues;
 	get isIOS(): boolean;
 	get isIPadOS(): boolean;
 	get isMac(): boolean;
@@ -33,6 +44,9 @@ export declare class DeviceChecker implements Checker {
 	get isMobile(): boolean;
 	get iOSVersion(): number | undefined;
 	detect(): void;
+	private detectHardware;
+	detectGpu(): Promise<void>;
+	private requestGpuInfo;
 	private detectHighEntropyValues;
 	private detectDevice;
 	private detectOS;

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

@@ -10,6 +10,7 @@ export declare class DisplayChecker implements Checker {
 	private _screenHeight;
 	private _screenWidth;
 	private _colorDepth;
+	private _colorGamut;
 	private _displayMode;
 	private _isStandalone;
 	get isTouch(): boolean;
@@ -21,8 +22,10 @@ export declare class DisplayChecker implements Checker {
 	get pixelRatio(): number;
 	get isHDR(): boolean;
 	get colorDepth(): number;
+	get colorGamut(): ColorGamut | undefined;
 	get displayMode(): DisplayMode;
 	get isStandalone(): boolean;
 	detect(): void;
+	private detectColorGamut;
 	private detectDisplayMode;
 }

package/types/utils/tuningConfig.d.ts

@@ -43,6 +43,13 @@ export type ITuningConfig = {
 		smallSampleMinDuration: Milliseconds;
 		cacheThresholdSize: Milliseconds;
 		/**
+		* UVP-11541: верхняя граница порога, ниже которого ответ считается кэш-хитом по TTFB.
+		* Без неё порог растёт вместе с rtt и после деградации сети объявляет кэшем любой быстрый
+		* сетевой ответ — оценка застывает навсегда. Замер на CDN: кэш отвечает за 0.5–1.2 мс,
+		* сеть не быстрее 45 мс, так что коридор широкий.
+		*/
+		cacheHitTtfbMaxMs: Milliseconds;
+		/**
 		* Фичафлаг UVP-10855: лечит залипание throughput на быстрых соединениях.
 		*
 		* Проблема: на быстром соединении крупный сегмент реально скачивается за ≤ cacheThresholdSize
@@ -252,6 +259,8 @@ export type ITuningConfig = {
 		maxQualityForFirstSegmentPreload: ExactVideoQuality;
 		/** Включает отправку телеметрии трейсера (resume) при превышении stall watchdog */
 		tracerResumeOnUnexpectedStall: boolean;
+		/** Включает отправку телеметрии трейсера (resume) при выборе ABR качества не выше lowQualityTelemetryLimit */
+		tracerResumeOnLowQuality: boolean;
 		/**
 		* Эксперимент: при `true` отключает `await this.reinitDecoderIfNeeded(shouldForceSeek)`
 		* внутри `stallWatchdogIntervalCallback`. По умолчанию `false` — текущее поведение
@@ -268,6 +277,23 @@ export type ITuningConfig = {
 		* Включать поэтапно, начиная с процента трафика, для A/B по метрикам утечек и восстановления.
 		*/
 		resolveQueueOnDestroy: boolean;
+		/**
+		* Освобождает застрявшую загрузку сегментов в `DashProvider`: запись из `activeSegments`,
+		* когда её загрузчик закончил работу или когда `warmUpMediaSource()` переоткрыл
+		* `mediaSource`, и колбэки задач `sourceBufferTaskQueue`, когда очередь разрушается
+		* посреди `append` (UVP-11642, UVP-11519).
+		*
+		* Без первого ранний выход `onSegmentFullyAppended` по протухшему `sourceBuffer` оставляет
+		* запись навсегда, а `maintain()` планирует загрузки только при пустом `activeSegments` —
+		* видеодорожка перестаёт докачиваться до конца жизни `BufferManager`. Без второго
+		* `destroy()` зануляет `currentTask`, не вызвав callback, `loadTemplateSegment` навсегда
+		* стоит на `await`, а `initRepresentations` не доходит до `REPRESENTATIOS_READY`.
+		*
+		* Освобождённый сегмент возвращается в `NONE` через `abortSegment()`, то есть будет скачан
+		* заново: пережили ли байты переоткрытие буфера, достоверно неизвестно, и лишняя докачка
+		* дешевле замершего воспроизведения.
+		*/
+		recoverStuckSegmentLoading: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -315,6 +341,15 @@ export type ITuningConfig = {
 		*/
 		maxPausedTime: number;
 		catchupLiveForMutedInactiveTab: boolean;
+		/**
+		* UVP-2618. Отключать перемотку лайва, если ссылка пришла без маркера offset (`_offset_p` в пути
+		* или query-параметр `?offset_p=`). Применяется ко всем live-форматам: dash_live, dash_live_cmaf,
+		* hls_live, hls_live_cmaf. Когда манифест отдаёт DVR-окно (shiftDuration / liveSeekableDuration /
+		* X-Playback-Duration), но в URL нет маркера, `generateLiveUrl` не сможет подставить offset и плеер
+		* молча переинициализируется на live edge. Включение делает DVR-окно нулевым и скрывает таймлайн.
+		* По умолчанию false (прежнее поведение), включается для эксперимента.
+		*/
+		disableLiveSeekWithoutOffsetMarker: boolean;
 	};
 	enableWakeLock: boolean;
 	enableTelemetryAtStart: boolean;
@@ -355,6 +390,7 @@ export type ITuningConfig = {
 	* include-threshold - записываем столлы длинее stallIgnoreThreshold
 	*/
 	stallHandlingStrategy: "verbose" | "exclude-threshold" | "include-threshold";
+	stallIgnoreOnPause: boolean;
 	gapWatchdogInterval: Milliseconds;
 	requestQuick: boolean;
 	/** @deprecated HLS.js удалён, флаг ничего не делает */