@vkontakte/videoplayer-core 2.0.180 → 2.0.181-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.180",
+  "version": "2.0.181-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.109"
+    "@vkontakte/videoplayer-shared": "1.0.110-beta.0"
   }
 }

package/types/index.d.ts

@@ -3,9 +3,10 @@ import type { IMpegSource, IDashSource, IHLSSource, IDashURLSource, IHLSLiveSour
 import type { VideoCodec } from "./player/types";
 import { VideoFormat, Surface, PredefinedQualityLimits, VideoCodecName } from "./player/types";
 import Player from "./player/Player";
-import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, ICueSettings, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
+import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
 import { PlaybackState, ChromecastState, HttpConnectionType } from "./player/types";
 import type { IOptionalTuningConfig } from "./utils/tuningConfig";
+import type { UserHappinessTrigger } from "./utils/userHappinessTriggers";
 export { clientChecker, isMobile } from "./utils/ClientChecker";
 export { areValidLiveRecordSources } from "./utils/videoFormat";
 export { WebmCodecStrategy } from "./enums/WebmCodecStrategy";
@@ -15,5 +16,5 @@ import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from "@
 * @deprecated
 */
 declare const SDK_VERSION: string;
-export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, ICueSettings, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
+export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, UserHappinessTrigger, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
 export { Player, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };

package/types/player/Player.d.ts

@@ -1,6 +1,6 @@
 import type { IOptionalTuningConfig } from "../utils/tuningConfig";
 import type { ILogEntry, ITracer, QualityLimits, Seconds, VideoQuality, DebugData } from "@vkontakte/videoplayer-shared";
-import { type IAudioStream, type IConfig, type ICueSettings, type IExternalTextTrack, type IPlayer, type ITextTrack, type IVideoStream, type PlaybackRate, type PlayerEventsImpl, type PlayerExperimentalImpl, type PlayerInfoImpl, PredefinedQualityLimits } from "./types";
+import { type IAudioStream, type IConfig, type IExternalTextTrack, type IPlayer, type ITextTrack, type IVideoStream, type PlaybackRate, type PlayerEventsImpl, type PlayerExperimentalImpl, type PlayerInfoImpl, PredefinedQualityLimits } from "./types";
 import type { IPlayerOptions } from "../utils/playerOptions";
 export default class Player implements IPlayer {
 	private readonly subscription;
@@ -26,6 +26,7 @@ export default class Player implements IPlayer {
 	private wasSetStartedQuality;
 	private desiredState;
 	info: PlayerInfoImpl;
+	private userHappinessController;
 	events: PlayerEventsImpl;
 	experimental: PlayerExperimentalImpl;
 	private devNullLog;
@@ -37,6 +38,7 @@ export default class Player implements IPlayer {
 	* Очищает необходимые поля при переключении на другое видео
 	*/
 	private resetDesiredState;
+	private createUserHappinessController;
 	/**
 	* Возвращает плеер в начальное состояние
 	* Позвонялет переиспользовать для другого видео
@@ -71,7 +73,6 @@ export default class Player implements IPlayer {
 	setPlaybackRate(playbackRate: PlaybackRate): IPlayer;
 	setExternalTextTracks(tracks: Omit<IExternalTextTrack, "type">[]): IPlayer;
 	selectTextTrack(id: ITextTrack["id"] | undefined): IPlayer;
-	setTextTrackCueSettings(settings: ICueSettings): IPlayer;
 	setLiveLowLatency(isLowLatency: boolean): IPlayer;
 	setLooped(isLooped: boolean): IPlayer;
 	toggleChromecast(): void;

package/types/player/types.d.ts

@@ -56,8 +56,10 @@ export interface IPlayer {
 	setPlaybackRate(playbackRate: PlaybackRate): IPlayer;
 	setLooped(isLooped: boolean): IPlayer;
 	setExternalTextTracks(tracks: Omit<IExternalTextTrack, "type">[]): IPlayer;
+	/**
+	* Запоминает выбранную дорожку субтитров. Отрисовка субтитров на стороне UI
+	*/
 	selectTextTrack(id: ITextTrack["id"] | undefined): IPlayer;
-	setTextTrackCueSettings(settings: ICueSettings): IPlayer;
 	setLiveLowLatency(isLowLatency: boolean): IPlayer;
 	/**
 	* Включает или отключает Chromecast
@@ -225,7 +227,7 @@ export interface IPlayerEvents {
 	*/
 	fetcherRecoverableError$: IObservable<IError>;
 	/**
-	* Произошел серьезный/долгий стол.
+	* Произошел серьёзный/долгий stall.
 	*/
 	severeStallOccured$: IObservable<boolean>;
 }
@@ -348,7 +350,7 @@ export interface PlayerInfoValues {
 	*/
 	isBuffering$: boolean;
 	/**
-	* Состояние столла. Возникает по истечении stallIgnoreThreshold после старта нежелательной буферизации
+	* Состояние stall. Возникает по истечении stallIgnoreThreshold после старта нежелательной буферизации
 	* Статус только нежелательной буферизации возникает при опустошении буфера в процессе воспроизведения
 	* и не возникает при начальном наполнении буфера или после перемотки
 	*/
@@ -407,7 +409,7 @@ export interface PlayerInfoValues {
 	*/
 	availableTextTracks$: ITextTrack[];
 	/**
-	* Выбранная и отображаемая дорожка субтитров
+	* Выбранная дорожка субтитров
 	*/
 	currentTextTrack$: ITextTrack["id"] | undefined;
 	/**
@@ -517,7 +519,7 @@ export interface PlayerEventsImpl {
 	fetcherError$: Subject<IError>;
 	severeStallOccured$: Subject<boolean>;
 }
-interface IPlayerExperimental {
+export interface IPlayerExperimental {
 	/**
 	* Элемент, который сейчас вставлен в container.
 	* Может быть видеоэлементом, iframe и вообще чем угодно в общем случае.
@@ -685,12 +687,6 @@ export interface IInternalTextTrack extends ITextTrackBase {
 	url: string;
 }
 export type ITextTrack = IExternalTextTrack | IInternalTextTrack;
-export interface ICueSettings {
-	align?: "left" | "center" | "right";
-	position?: number | "auto";
-	size?: number;
-	line?: number | "auto";
-}
 export declare enum VideoDestination {
 	SCREEN = "SCREEN",
 	CHROMECAST = "CHROMECAST"

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

@@ -8,7 +8,7 @@ import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import { Player } from "./lib/player";
 import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager";
-import TextTrackManager from "../utils/HTMLVideoElement/TextTrackManager";
+import TextTrackManager from "../utils/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
 import { AbrManager } from "../utils/Abr/abrManager";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";

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

@@ -12,6 +12,7 @@ export interface Dependencies {
 	compatibilityMode?: boolean;
 	manifest: Manifest | null;
 	tracer: ITracer;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
 }
 export interface Gap extends IRange<Milliseconds> {
 	representation: Representation["id"];
@@ -56,6 +57,7 @@ export declare class BufferManager {
 	private destroyAbortController;
 	private useSmartRepresentationSwitch;
 	private readonly getCurrentPosition;
+	private readonly getSeekTargetPosition;
 	private readonly isActiveLowLatency;
 	private tuning;
 	private forwardBufferTarget;
@@ -77,9 +79,8 @@ export declare class BufferManager {
 	private index;
 	private lastDataObtainedTimestampMs;
 	private loadByteRangeSegmentsTimeoutId;
-	private preDownloadedFirstSegment;
 	private brokenSegmentAppendDetected;
-	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, isActiveLowLatency, compatibilityMode, manifest, tracer }: Dependencies);
+	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, getSeekTargetPosition, isActiveLowLatency, compatibilityMode, manifest, tracer }: Dependencies);
 	startWith: ReturnType<typeof abortable<[Representation["id"]]>>;
 	switchToWithPreviousAbort(newRepresentationId: Representation["id"], dropBuffer?: boolean): Promise<void | undefined>;
 	switchTo: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
@@ -108,7 +109,6 @@ export declare class BufferManager {
 	private loadSegments;
 	private loadTemplateSegment;
 	private updateRepresentationsBaseUrlIfNeeded;
-	private feedPreDownloadedFirstSegment;
 	private loadByteRangeSegments;
 	private prepareByteRangeFetchSegmentParams;
 	private buildCacheMetadata;
@@ -128,7 +128,32 @@ export declare class BufferManager {
 	private detectBrokenSegmentAppend;
 	private abortSegment;
 	private loadNextInit;
+	private isFirstSegmentPreloadEnabled;
+	private isStartPositionWithinFirstSegment;
+	/**
+	* Работа с прелоадом первого сегмента.
+	*
+	* Загружает init+index репрезентации и применяет их через onInitFetched (результаты сетятся в initData /
+	* parsedInitData / segments). Резолвится после применения инита.
+	*
+	* Режимы вызова:
+	* - critical=true — только startWith (стартовая загрузка);
+	* - critical=false — switchTo и ленивые idle-догрузки остальных репрезентаций.
+	*
+	* С прелоадом первого сегмента (critical && isFirstSegmentPreloadEnabled):
+	* - фетчер делает один combined-запрос init+index+первый сегмент;
+	* - инит применяется досрочно из onInitFetched, до скачанных байтов сегмента, и сразу ставится
+	*   init-аппенд в SourceBufferTaskQueue — раньше кормления чанков сегмента (кормление синхронно
+	*   внутри onProgress, поэтому без этого сегмент аппендился бы раньше инита);
+	* - резолв loadInit ждёт завершения init-аппенда;
+	* - чанки сегмента кормятся через handleFirstSegmentChunk, хвост добивается в finalizeCombinedStreaming
+	*/
 	private loadInit;
+	/**
+	* Здесь мы только финалим хвостовую часть — сегментную — комбинированного запроса.
+	* Если сегмент не докачался не беда, loadSegments подхватит.
+	*/
+	private finalizeCombinedStreaming;
 	private dropBuffer;
 	private pruneBuffer;
 	private abortBuffer;

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

@@ -1,8 +1,7 @@
 import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from "../../../player/types";
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
-import type { Byte, IValueSubject, ISubject, Milliseconds, IRange, ITracer, IError } from "@vkontakte/videoplayer-shared";
+import type { Byte, ExactVideoQuality, 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";
 import type { ISegmentCacheStorage, CacheMetadata, SegmentCacheMode } from "../../utils/segmentCache";
 declare global {
@@ -50,13 +49,19 @@ export interface FetchParams {
 	ignoreNetworkErrors?: boolean;
 	representationHeight?: number;
 	cacheMetadata?: CacheMetadata;
+	firstSegmentPreload?: boolean;
+	onInitFetched?: (data: IRepresentationInitReady) => void;
+	onSegmentsDone?: (result: ICombinedBodyResult | null) => void;
 }
-export type RepresentationFetchResult = {
+export interface IRepresentationInitReady {
 	init: CommonInit | null;
 	segments: Segment[];
+	initData: ArrayBuffer;
+	globalFrom: Byte;
+}
+export interface ICombinedBodyResult {
 	dataView: DataView;
-	firstSegmentData?: ArrayBuffer;
-};
+}
 export declare class Fetcher {
 	private throughputEstimator;
 	private requestQuic;
@@ -97,11 +102,31 @@ export declare class Fetcher {
 	private trackRequestStart;
 	fetchManifest: ReturnType<typeof abortable<[string], string | null>>;
 	fetch: ReturnType<typeof abortable<[string, FetchParams], ArrayBuffer | null>>;
-	fetchRepresentation(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams: FetchParams): Promise<RepresentationFetchResult | null>;
+	/**
+	* Резолвится, когда получили init данные.
+	*/
+	fetchRepresentation(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams: FetchParams): Promise<IRepresentationInitReady | null>;
 	/** Скипнутые сегменты не записаны в кэш — при следующем запросе региона докачаются как miss. */
 	private traceSkippedCacheSegments;
 	destroy(): void;
+	/**
+	* Тут проверяем расположение данных, нам из манифеста приходит только длина сегмента, ничто не известно про оффсет от начала,
+	* заявлено, что первый сегмент идет сразу после индекса. Проверяем контракт: true — нарушен, первый сегмент лежит не сразу за индексом.
+	*/
+	private isFirstSegmentLayoutViolated;
+	private logFirstSegmentLayoutViolation;
+	/**
+	* Адаптируем onProgress комбинированного запроса: отдельно информируем о данных инита
+	* и о данных сегмента на основании одного combined-стрима.
+	*/
+	private createInitAndFirstSegmentStreamingOnProgress;
 	private fetchByteRangeRepresentation;
+	private fetchByteRangeRepresentationWithFirstSegment;
+	/**
+	* Если происходит downloadSignal то мы не хотим абортить загрузку инит части запроса,
+	* скачиваем нужную часть запроса, как только инит+индекс готов, сегмент хвост можно абортить.
+	*/
+	private createSegmentTailAbort;
 	private fetchTemplateRepresentation;
 	private isLikelyCacheHitByTtfb;
 	private doFetch;

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

@@ -22,6 +22,7 @@ export interface Params {
 	tracer: ITracer;
 	isOnDemand: boolean;
 	dashMaxTvVideoQuality: Nullable<ExactVideoQuality>;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
 }
 export declare class Player {
 	private element;
@@ -89,6 +90,7 @@ export declare class Player {
 	private liveWasInterrupted;
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
+	private getSeekTargetPosition;
 	private destroyController;
 	constructor(params: Params);
 	initManifest: ReturnType<typeof abortable<[HTMLMediaElement, string, number]>>;

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

@@ -7,7 +7,7 @@ import type { IObservableMediaElement } from "../utils/HTMLVideoElement/observab
 import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager";
-import TextTrackManager from "../utils/HTMLVideoElement/TextTrackManager";
+import TextTrackManager from "../utils/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";
 import type { BasePlayer } from "./lib/player/basePlayer";

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

@@ -20,6 +20,7 @@ export interface Dependencies {
 	getCurrentPosition(): Milliseconds | undefined;
 	getCurrentStallDuration(): Milliseconds;
 	isActiveLowLatency(): boolean;
+	getSeekTargetPosition?(): Milliseconds | undefined;
 }
 export interface IVirtualBufferManager<T extends Segment = Segment> {
 	error$: ISubject<IError>;

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

@@ -1,4 +1,4 @@
-import type { Fetcher, FetchParamsWithUrl, Priority, RepresentationFetchResult } from "../../fetcher";
+import type { Fetcher, FetchParamsWithUrl, Priority } from "../../fetcher";
 import type { CommonInit, ContainerParser, Representation, Segment } from "../../../../utils/parsers/types";
 import { StreamKind } from "../../../../utils/parsers/types";
 import type { ITuningConfig } from "../../../../../utils/tuningConfig";
@@ -26,7 +26,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected downloadingRepresentationId: Representation["id"] | undefined;
 	protected switchingRepresentationId: Representation["id"] | null;
 	protected initData: Map<Representation["id"], ArrayBuffer>;
-	protected initDataPromises: Map<Representation["id"], Promise<RepresentationFetchResult<T> | null | undefined>>;
+	protected initDataPromises: Map<Representation["id"], Promise<unknown>>;
 	protected idleCallbacks: Map<Representation["id"], number>;
 	protected parsedInitData: Map<Representation["id"], CommonInit>;
 	protected forwardBufferRepresentations: Map<Representation["id"], T[]>;
@@ -55,8 +55,9 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected subscription: Subscription;
 	protected readonly getCurrentPosition: () => Milliseconds | undefined;
 	protected readonly getCurrentStallDuration: () => Milliseconds | undefined;
+	protected readonly getSeekTargetPosition: (() => Milliseconds | undefined) | undefined;
 	protected brokenSegmentAppendDetected: boolean;
-	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, manifest, segmentCacheService }: Dependencies);
+	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, getSeekTargetPosition, manifest, segmentCacheService }: Dependencies);
 	protected abstract loadItems(itemsToLoad: IBufferPlaybackQueueItem<T>[], representation: Representation, priority?: Priority): Promise<void>;
 	protected abstract selectItemsToLoad(): IBufferPlaybackQueueItem<T>[];
 	protected abstract prepareFetchParams(items: IBufferPlaybackQueueItem<T>[], representation: Representation): FetchParamsWithUrl;
@@ -110,6 +111,9 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected loadInits(): Promise<void>;
 	protected loadInitIfNeeded(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
 	protected loadInit(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
+	private isStartPositionWithinFirstSegment;
+	private finalizeCombinedStreaming;
+	private resetStreamingItem;
 	protected maintainNativeBuffer(signal: AbortSignal): Promise<void>;
 	protected maintainPlaybackBuffer(position: Milliseconds): Promise<void>;
 	protected actualizeLastSegmentInfo(currentPosition: Milliseconds): void;

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

@@ -1,8 +1,7 @@
 import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from "../../../player/types";
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
-import type { Byte, IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { Byte, ExactVideoQuality, 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, StreamKind } from "../../utils/parsers/types";
 import type { ISegmentCacheStorage, CacheMetadata, SegmentCacheMode } from "../../utils/segmentCache";
 declare global {
@@ -44,17 +43,30 @@ export interface FetchParams {
 	onProgressTasks?: Promise<void>[];
 	signal?: AbortSignal;
 	priority?: Priority;
+	representationHeight?: number;
 	measureThroughput?: boolean;
 	isLowLatency?: boolean;
 	bufferOptimisation?: boolean;
 	kind: StreamKind;
 	cacheMetadata?: CacheMetadata;
+	firstSegmentPreload?: boolean;
+	onInitFetched?: (data: IRepresentationInitReady) => void;
+	onSegmentsDone?: (result: ICombinedBodyResult | null) => void;
+}
+export interface IRepresentationInitReady {
+	init: CommonInit | null;
+	segments: Segment[];
+	initData: ArrayBuffer;
+	globalFrom: Byte;
+}
+export interface ICombinedBodyResult {
+	dataView: DataView;
 }
 export type RepresentationFetchResult<T extends Segment> = {
-	initMetadata: CommonInit | null;
-	initDataView: DataView;
+	init: CommonInit | null;
 	segments: T[];
-	firstSegmentData?: ArrayBuffer;
+	initData: ArrayBuffer;
+	globalFrom: Byte;
 };
 export declare class Fetcher {
 	private throughputEstimator;
@@ -96,11 +108,23 @@ 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, representationHeight?: number, kind?: StreamKind): Promise<RepresentationFetchResult<T> | null | undefined>;
+	fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams?: FetchParams): Promise<RepresentationFetchResult<T> | null | undefined>;
 	/** Скипнутые сегменты не записаны в кэш — при следующем запросе региона докачаются как miss. */
 	private traceSkippedCacheSegments;
 	destroy(): void;
+	/**
+	* Так как качем инит+сегмент, то нам нужно раньше сообщить, что мы получили инит+индекс часть,
+	* а сегментная пусть качается дальше.
+	*/
+	private createInitAndFirstSegmentStreamingOnProgress;
+	/**
+	* Проверяем, что данные сегмента идут сразу после индекса.
+	*/
+	private isFirstSegmentLayoutViolated;
+	private logFirstSegmentLayoutViolation;
 	private fetchByteRangeRepresentation;
+	private fetchByteRangeRepresentationWithFirstSegment;
+	private createSegmentTailAbort;
 	private fetchTemplateRepresentation;
 	private isLikelyCacheHitByTtfb;
 	private doFetch;

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

@@ -80,6 +80,7 @@ export declare abstract class BasePlayer {
 	updateDurationError$: Subject<IError>;
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
+	private getSeekTargetPosition;
 	protected constructor(params: Params);
 	protected abstract prepareManifestUrlString(manifestBaseUrlString: string, offset: number): string;
 	protected abstract setSourceInitDuration(): void;

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

@@ -1,7 +1,7 @@
 import type ThroughputEstimator from "../../../../utils/ThroughputEstimator";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { VideoCodec } from "../../../../player/types";
-import type { ExactVideoQuality, ITracer, Nullable } from "@vkontakte/videoplayer-shared";
+import type { ExactVideoQuality, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 export declare enum State {
 	NONE = "none",
 	MANIFEST_READY = "manifest_ready",
@@ -16,4 +16,5 @@ export interface Params {
 	tracer: ITracer;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
 }

package/types/providers/types.d.ts

@@ -2,7 +2,7 @@ import type { ITuningConfig } from "../utils/tuningConfig";
 import type { IComponentLogger, IError, ILogger, IRange, IRectangle, ISubject, ITracer, IValueSubject, IWarning, Milliseconds, QualityLimits, Seconds } from "@vkontakte/videoplayer-shared";
 import type { IChromecastInitializer } from "./ChromecastProvider/ChromecastInitializer/types";
 import type { IExternalTextTrack, IInternalTextTrack, ITextTrack, IVideoTrack, IVolumeState, PlaybackRate, PlaybackState } from "../player/types";
-import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ICueSettings, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
+import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
 import type { IStateMachine } from "../utils/StateMachine/types";
 import type ThroughputEstimator from "../utils/ThroughputEstimator";
 export interface IProvider {
@@ -44,7 +44,6 @@ export interface DesiredStateValues {
 	playbackRate: PlaybackRate;
 	playbackState: PlaybackState;
 	seekState: SeekState;
-	textTrackCuesSettings: ICueSettings;
 	videoStream: IVideoStream | undefined;
 	/**
 	* Порядок смены видео дорожек:
@@ -76,7 +75,6 @@ export interface IProviderOutput {
 	availableAudioTracks$: IValueSubject<IAudioTrack[]>;
 	availableAudioCodecs$: IValueSubject<AudioCodec[]>;
 	availableTextTracks$: IValueSubject<ITextTrack[]>;
-	currentTextTrack$: IValueSubject<ITextTrack["id"] | undefined>;
 	isAudioAvailable$: IValueSubject<boolean>;
 	autoVideoTrackLimits$: IValueSubject<QualityLimits | undefined>;
 	autoVideoTrackLimitingAvailable$: IValueSubject<boolean>;

package/types/providers/utils/Abr/rules/video/stallsRule.d.ts

@@ -1,23 +1,21 @@
 import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
-import type { Kbps, Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
-import type { ITuningConfig } from "../../../../../utils/tuningConfig";
 import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
-type StallLogsArgs = [forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig];
-export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, StallLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
-	private severeStallOccurred;
-	private qualityRestrictionTimer;
-	private lastStallDurationRestriction;
+export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, []> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
+	private wasSevereStall;
+	private restrictedInCurrentStall;
+	private stalledQuality;
+	private stallsByQuality;
+	private recoveryStartedAt;
 	private maxQualityLimitOnStall;
-	private predictedThroughputWithoutData;
 	private restrictionTracer;
 	private restrictionStartedAt;
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): RuleLogData;
+	protected createLogData(selectedTrack: IVideoTrack): RuleLogData;
+	private trackStallEpisode;
+	private resolveQualityLimit;
 	private traceRestrictionSet;
 	private traceRestrictionReset;
-	private updateStallQualityLimits;
 }
-export {};

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

@@ -1,9 +1,8 @@
-import type { ExactVideoQuality, IObservable, IValueSubject, Milliseconds, Kbps, Seconds } from "@vkontakte/videoplayer-shared";
+import type { IObservable, IValueSubject, Milliseconds, Seconds } from "@vkontakte/videoplayer-shared";
 import type { IVideoTrack } from "../../player/types";
 import type { ITuningConfig } from "../../utils/tuningConfig";
 interface IConnectData {
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds>;
-	throughput$: IValueSubject<number>;
 	rtt$: IValueSubject<Milliseconds>;
 	isBuffering$: IObservable<boolean>;
 	isSeeked$: IObservable<boolean>;
@@ -18,7 +17,6 @@ interface IConnectData {
 declare class StallsManager {
 	private currentStallDuration$;
 	private videoLastDataObtainedTimestamp$;
-	private throughput$;
 	private rtt$;
 	private tuning;
 	private abrParams;
@@ -26,20 +24,15 @@ declare class StallsManager {
 	private isSeeked$;
 	private isBuffering$;
 	private isPaused;
-	private maxQualityLimit;
 	private lastUniqueVideoTrackSelected;
 	private currentStallsCount;
 	private sumStallsDuration;
 	private lastStallDuration;
 	private providerStartWatchingTimestamp;
 	private lastUniqueVideoTrackSelectedTimestamp;
-	private predictedThroughputWithoutData;
-	private qualityRestrictionTimer;
 	private subscription;
 	severeStallOccurred$: IValueSubject<boolean>;
 	init(data: IConnectData): void;
-	get videoMaxQualityLimit(): ExactVideoQuality | undefined;
-	get predictedThroughput(): Kbps;
 	get abrTuningParams(): ITuningConfig["autoTrackSelection"];
 	set lastVideoTrackSelected(lastUniqueVideoTrackSelected: IVideoTrack);
 	destroy(): void;

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

@@ -0,0 +1,16 @@
+import type { IExternalTextTrack, IInternalTextTrack } from "../../player/types";
+import type { IDesiredState, IProviderOutput } from "../types";
+declare class TextTrackManager {
+	private available$;
+	private error$;
+	private subscription;
+	private externalTracks;
+	private internalTracks;
+	private emittedIds;
+	connect(desiredState: Pick<IDesiredState, "externalTextTracks" | "internalTextTracks">, providerOutput: Pick<IProviderOutput, "availableTextTracks$" | "error$">): void;
+	setExternal(tracks: IExternalTextTrack[]): void;
+	setInternal(tracks: IInternalTextTrack[]): void;
+	destroy(): void;
+	private emitAvailable;
+}
+export default TextTrackManager;

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

@@ -20,6 +20,7 @@ export interface DeviceHardware {
 export declare class DeviceChecker implements Checker {
 	private _displayChecker;
 	private _isMobile;
+	private _isSmartTV;
 	private _current;
 	private _iosVersion;
 	private _highEntropyValues;
@@ -31,6 +32,7 @@ export declare class DeviceChecker implements Checker {
 	get current(): CurrentClientDevice;
 	get os(): OS;
 	get details(): DeviceDetails;
+	get isSmartTV(): boolean;
 	get hardware(): DeviceHardware;
 	get highEntropyValues(): HighEntropyValues;
 	get isIOS(): boolean;
@@ -42,12 +44,14 @@ export declare class DeviceChecker implements Checker {
 	get isWindows(): boolean;
 	get isLinux(): boolean;
 	get isMobile(): boolean;
+	get isTablet(): boolean;
 	get iOSVersion(): number | undefined;
 	detect(): void;
 	private detectHardware;
 	detectGpu(): Promise<void>;
 	private requestGpuInfo;
 	private detectHighEntropyValues;
+	private detectSmartTv;
 	private detectDevice;
 	private detectOS;
 	private normalizeOSName;

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

@@ -19,6 +19,7 @@ export declare enum UADataPlatform {
 }
 export interface HighEntropyValues {
 	mobile?: boolean;
+	formFactors?: string[];
 	model?: string;
 	platform?: UADataPlatform;
 	platformVersion?: string;
@@ -27,7 +28,8 @@ export interface HighEntropyValues {
 	brands?: UADataBrandItem[];
 }
 export type NavigatorWithUserAgentData = Navigator & {
-	userAgentData: {
-		getHighEntropyValues: (values: Array<string>) => HighEntropyValues;
+	userAgentData?: {
+		mobile?: boolean;
+		getHighEntropyValues?: (values: Array<string>) => Promise<HighEntropyValues>;
 	};
 };