@vkontakte/videoplayer-core 2.0.163-dev.eb086bcd9.0 → 2.0.164-beta.0

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

@@ -1,5 +1,7 @@
-import type { Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
+import type { Kbps, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../../../player/types";
+import type { Segment } from "../parsers/types";
+export declare const computeForwardBitrate: (segments: Nullable<Segment[]>) => Kbps;
 export declare const bufferToPlaybackMs: (contentMs: Milliseconds | undefined, playbackRate: number) => Milliseconds;
 export declare enum CompareTrack {
 	Descending = -1,

package/types/providers/utils/HTMLVideoElement/destroy.d.ts

@@ -1 +1 @@
-export declare const destroy: (video: HTMLVideoElement, clearVideoElementInnerHTML: boolean) => void;
+export declare const destroy: (video: HTMLMediaElement, clearVideoElementInnerHTML: boolean) => void;

package/types/providers/utils/HTMLVideoElement/forcePlay.d.ts

@@ -4,5 +4,5 @@
 * @param {Function} soundNotAllowedCallback - колбэк, который вызовется если нам не разрешили играть со звуком
 * @return {Promise}<boolean> - получилось начать воспроизведение
 */
-declare const _default: (video: HTMLVideoElement, soundNotAllowedCallback?: () => void) => Promise<boolean>;
+declare const _default: (video: HTMLMediaElement, soundNotAllowedCallback?: () => void) => Promise<boolean>;
 export default _default;

package/types/providers/utils/HTMLVideoElement/observable.d.ts

@@ -12,6 +12,7 @@ export interface IObservableVideo {
 	progress$: IObservable<undefined>;
 	timeUpdate$: IObservable<Seconds>;
 	durationChange$: IObservable<Seconds>;
+	playedTime$: IObservable<Seconds>;
 	loadStart$: IObservable<void>;
 	loadedMetadata$: IObservable<undefined>;
 	loadedData$: IObservable<undefined>;
@@ -25,4 +26,4 @@ export interface IObservableVideo {
 	leavePip$: IObservable<PictureInPictureEvent>;
 	destroy: () => void;
 }
-export declare const observe: (video: HTMLVideoElement) => IObservableVideo;
+export declare const observe: (video: HTMLMediaElement) => IObservableVideo;

package/types/providers/utils/HTMLVideoElement/pool.d.ts

@@ -1,6 +1,7 @@
 import type { ITuningConfig } from "../../../utils/tuningConfig";
-type AllocateConstraints = Pick<ITuningConfig, "audioVideoSyncRate" | "disableYandexPiP" | "clearVideoElementInnerHTML" | "reuseOwnVideoElement">;
+export type AllocateConstraints = Pick<ITuningConfig, "audioVideoSyncRate" | "disableYandexPiP" | "clearVideoElementInnerHTML" | "reuseOwnVideoElement">;
 type DisposeConstraints = Pick<ITuningConfig, "keepVideoElement" | "clearVideoElementInnerHTML" | "reuseOwnVideoElement">;
-export declare const allocate: (container: HTMLElement, { audioVideoSyncRate, disableYandexPiP, clearVideoElementInnerHTML, reuseOwnVideoElement }: AllocateConstraints) => HTMLVideoElement;
-export declare const dispose: (videoElement: HTMLVideoElement, { keepVideoElement, clearVideoElementInnerHTML, reuseOwnVideoElement }: DisposeConstraints) => void;
+export declare const allocate: (container: HTMLElement, { audioVideoSyncRate, disableYandexPiP, clearVideoElementInnerHTML, reuseOwnVideoElement }: ITuningConfig) => HTMLVideoElement;
+export declare const initializeAudio: (element: HTMLAudioElement) => HTMLAudioElement;
+export declare const dispose: (element: HTMLMediaElement, constraints: DisposeConstraints) => void;
 export {};

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

@@ -0,0 +1,3 @@
+import type { ITuningConfig } from "../../utils/tuningConfig";
+import type { Stream } from "./parsers/types";
+export declare const filterStreams: (streams: Stream[], videoElement: HTMLMediaElement, canPlayTypeRestriction: ITuningConfig["dash"]["checkRepresentationCanPlayType"]) => Stream[];

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

@@ -0,0 +1,12 @@
+import type { ITuningConfig } from "../../utils/tuningConfig";
+import type { IProviderAllocationResolution } from "../types";
+/**
+* Разрешает аллокацию медиа-элемента для провайдера.
+*
+* Возвращает два поля:
+* - `target: HTMLMediaElement` — элемент для управления воспроизведением (play, pause, load, currentTime и т.д.).
+*   Всегда присутствует, тип определяется входным контейнером: HTMLVideoElement для видео, HTMLAudioElement для аудио.
+* - `video: HTMLVideoElement | null` — видеоэлемент для UI-специфичных операций (textTracks, getBoundingClientRect).
+*   Равен `target` если это HTMLVideoElement, иначе `null` для аудио-режима.
+*/
+export declare function resolveAllocation(container: HTMLElement, tuningConfig: ITuningConfig): IProviderAllocationResolution;

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

@@ -121,7 +121,7 @@ export interface Stream {
 }
 export interface Manifest {
 	duration: Milliseconds | undefined;
-	streams: { [key in StreamKind] : Stream[] };
+	streams: { [key in StreamKind]: Stream[] };
 	baseUrls: string[];
 	codecs?: {
 		video?: VideoCodec[];

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

@@ -6,9 +6,9 @@ declare const syncDesiredState: <Value>(desiredState: IStateMachine<Value | unde
 	changed$?: IObservable<Value | undefined>;
 	onError?: IListener<Error | unknown>;
 }) => ISubscription;
-export declare const syncVideoLooped: (video: HTMLVideoElement, desiredState: IStateMachine<boolean>, onError?: IListener<Error | unknown>) => ISubscription;
-export declare const syncVideoVolumeState: (video: HTMLVideoElement, desiredState: IStateMachine<IVolumeState>, changed$: IObservable<IVolumeState>, onError?: IListener<Error | unknown>, params?: {
+export declare const syncVideoLooped: (video: HTMLMediaElement, desiredState: IStateMachine<boolean>, onError?: IListener<Error | unknown>) => ISubscription;
+export declare const syncVideoVolumeState: (video: HTMLMediaElement, desiredState: IStateMachine<IVolumeState>, changed$: IObservable<IVolumeState>, onError?: IListener<Error | unknown>, params?: {
 	skipVideoElVolumeSync$: IValueSubject<boolean>;
 }) => ISubscription;
-export declare const syncVideoPlaybackRate: (video: HTMLVideoElement, desiredState: IStateMachine<PlaybackRate>, changed$: IObservable<PlaybackRate>, onError?: IListener<Error | unknown>) => ISubscription;
+export declare const syncVideoPlaybackRate: (video: HTMLMediaElement, desiredState: IStateMachine<PlaybackRate>, changed$: IObservable<PlaybackRate>, onError?: IListener<Error | unknown>) => ISubscription;
 export default syncDesiredState;

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/buffer/getPlayedTime.d.ts

@@ -0,0 +1,3 @@
+import type { Seconds } from "@vkontakte/videoplayer-shared";
+declare const _default: (ranges: TimeRanges) => Seconds;
+export default _default;

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

@@ -0,0 +1,8 @@
+import type { IRange, Milliseconds } from "@vkontakte/videoplayer-shared";
+/**
+* Вычисляет пересечение двух наборов интервалов.
+* Если один из наборов пуст, возвращается другой набор (т.к. пустой набор означает
+* отсутствие ограничений — например, аудиодорожки может не быть).
+* Оба набора должны быть отсортированы по полю from и не содержать пересекающихся интервалов внутри себя.
+*/
+export declare const intersectBufferIntervals: (range1: IRange<Milliseconds>[], range2: IRange<Milliseconds>[]) => IRange<Milliseconds>[];

package/types/utils/changePlaybackRate.d.ts

@@ -1,2 +1,2 @@
 import type { Nullable } from "@vkontakte/videoplayer-shared";
-export declare const changePlaybackRate: (element: Nullable<HTMLVideoElement>, targetPlaybackRate: number) => void;
+export declare const changePlaybackRate: (element: Nullable<HTMLMediaElement>, targetPlaybackRate: number) => void;

package/types/utils/tuningConfig.d.ts

@@ -132,6 +132,8 @@ export type ITuningConfig = {
 		forwardBufferTargetAuto: Milliseconds;
 		forwardBufferTargetManual: Milliseconds;
 		forwardBufferTargetPreload: Milliseconds;
+		audioBufferAheadOfVideoMs: Milliseconds;
+		useDynamicBufferTarget: boolean;
 		seekBiasInTheEnd: Milliseconds;
 		maxSegmentDurationLeftToSelectNextSegment: Milliseconds;
 		minSafeBufferThreshold: number;
@@ -146,6 +148,8 @@ export type ITuningConfig = {
 		enableSubSegmentBufferFeeding: boolean;
 		bufferEmptinessTolerance: Milliseconds;
 		virtualBufferEmptinessTolerance: Milliseconds;
+		useBufferQueueVerification: boolean;
+		useVirtualBufferImplicitSeek: boolean;
 		useNewRepresentationSwitch: boolean;
 		useDelayedRepresentationSwitch: boolean;
 		useSmartRepresentationSwitch: boolean;
@@ -209,9 +213,24 @@ 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;
+		downloadTime: {
+			minLookaheadSegments: number;
+			safetyFactor: number;
+			bootstrapBufferMs: Milliseconds;
+			demandTolerance: number;
+		};
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -413,6 +432,8 @@ export type ITuningConfig = {
 	* Устанавливаем длительность видео на основе последнего сегмента.
 	*/
 	useDurationFromSegments: boolean;
+	/** включен режим проигрывания только аудио (без видео) */
+	audioOnly: boolean;
 };
 export type IOptionalTuningConfig = RecursivePartial<ITuningConfig>;
 export declare const fillDefault: (partial: IOptionalTuningConfig) => ITuningConfig;