@vkontakte/videoplayer-core 2.0.150-dev.f4d0e2c9.0 → 2.0.151-dev.0ce40db4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.150-dev.f4d0e2c9.0",
+  "version": "2.0.151-dev.0ce40db4.0",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -54,6 +54,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.79-dev.f4d0e2c9.0"
+    "@vkontakte/videoplayer-shared": "1.0.80-dev.0ce40db4.0"
   }
 }

package/types/index.d.ts

@@ -5,6 +5,7 @@ import { IPlayer, PlaybackState, IPlayerInfo, IPlayerEvents, IConfig, ISources,
 import type { IOptionalTuningConfig } from './utils/tuningConfig';
 export { clientChecker, isMobile } from './utils/ClientChecker';
 export { areValidLiveRecordSources } from './utils/videoFormat';
+export { WebmCodecStrategy } from './enums/WebmCodecStrategy';
 import type { ISubscription, IUnsubscriber, IEmitter, IObservable, IValueObservable, IValue, IOperator, IListener, ILogEntry, IRange, ExactVideoQuality } from '@vkontakte/videoplayer-shared';
 import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from '@vkontakte/videoplayer-shared';
 /**

package/types/player/Player.d.ts

@@ -1,6 +1,6 @@
 import { IOptionalTuningConfig } from '../utils/tuningConfig';
 import { IError, ILogEntry, Seconds, Subject, ValueSubject, QualityLimits, VideoQuality, ITracer } from '@vkontakte/videoplayer-shared';
-import { ChromecastState, HttpConnectionType, IAudioStream, IConfig, ICueSettings, IExternalTextTrack, IPlayer, ISeekRequest, ISources, ITextTrack, IVideoStream, PlaybackRate, PlaybackState, PredefinedQualityLimits, StartEnd, Surface, VideoFormat } from './types';
+import { ChromecastState, HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics, IAudioStream, IConfig, ICueSettings, IExternalTextTrack, IPlayer, ISeekRequest, ISources, ITextTrack, IVideoStream, PlaybackRate, PlaybackState, PredefinedQualityLimits, StartEnd, Surface, VideoFormat } from './types';
 import { IPlayerOptions } from '../utils/playerOptions';
 export default class Player implements IPlayer {
     private subscription;
@@ -67,6 +67,8 @@ export default class Player implements IPlayer {
         hostname$: ValueSubject<string | undefined>;
         httpConnectionType$: ValueSubject<HttpConnectionType | undefined>;
         httpConnectionReused$: ValueSubject<boolean | undefined>;
+        httpConnectionMetrics$: ValueSubject<HttpConnectionMetrics | undefined>;
+        httpDownloadMetrics$: ValueSubject<HttpDownloadMetrics | undefined>;
         surface$: ValueSubject<Surface>;
         chromecastState$: ValueSubject<ChromecastState>;
         chromecastDeviceName$: ValueSubject<string | undefined>;

package/types/player/types.d.ts

@@ -417,6 +417,14 @@ export interface IPlayerInfo {
      * Было ли переиспользовано последнее HTTP соединение
      */
     httpConnectionReused$: IValueObservable<boolean | undefined>;
+    /**
+     * Дополнительные данные-метрики по HTTP соединению
+     */
+    httpConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    /**
+     * Данные по загрузке по сети
+     */
+    httpDownloadMetrics$: IValueObservable<HttpDownloadMetrics | undefined>;
     /**
      * Состояние подключения Chromecast
      */
@@ -618,6 +626,19 @@ export declare enum HttpConnectionType {
     HTTP2 = "http2",
     QUIC = "quic"
 }
+export interface HttpConnectionMetrics {
+    dnsResolveTime: number;
+    tcpHandshakeTime: number;
+    tlsHandshakeTime: number;
+    totalConnectTime: number;
+    url: string;
+    networkType: string;
+}
+export interface HttpDownloadMetrics {
+    bytes: number;
+    speed: number;
+    url: string;
+}
 export declare enum SeekOperationState {
     None = "none",
     Requested = "requested",

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

@@ -1,7 +1,16 @@
-import { HttpConnectionType } from '../../../player/types';
+import { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from '../../../player/types';
 import type ThroughputEstimator from '../../../utils/ThroughputEstimator';
 import { Byte, IValueSubject, ISubject, Milliseconds, IRange, ITracer, IError } from '@vkontakte/videoplayer-shared';
 import { CommonInit, GenericContainerParser, Segment, SegmentReference } from '../../../providers/utils/parsers/types';
+declare global {
+    interface Navigator {
+        connection: {
+            effectiveType: string;
+            downlink: number;
+            rtt: number;
+        };
+    }
+}
 export declare enum RangeMethod {
     HEADER = 0,
     PARAM = 1
@@ -45,14 +54,24 @@ export declare class Fetcher {
     lastConnectionType$: IValueSubject<HttpConnectionType | undefined>;
     lastConnectionReused$: IValueSubject<boolean | undefined>;
     lastRequestFirstBytes$: IValueSubject<Milliseconds | undefined>;
+    lastConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    lastDownloadMetrics$: IValueSubject<HttpDownloadMetrics | undefined>;
     recoverableError$: ISubject<IError>;
     error$: ISubject<IError>;
     private abortAllController;
     private readonly subscription;
     private compatibilityMode;
     private useEnableSubtitlesParam;
+    private performanceObserver;
+    private pendingConnectionMetrics;
     constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam }: IParams);
     private onHeadersReceived;
+    private setupPerformanceObserver;
+    private processPerformanceResourceTiming;
+    private estimateNetworkType;
+    private extractConnectionMetrics;
+    private findMatchingRequest;
+    private trackRequestStart;
     fetchManifest: (param_0: string) => Promise<string | null | undefined>;
     fetch: (param_0: string, param_1: FetchParams) => Promise<ArrayBuffer | null | undefined>;
     fetchRepresentation(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams: FetchParams): Promise<RepresentationFetchResult | null>;

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

@@ -1,4 +1,4 @@
-import { HttpConnectionType, VideoCodec } from '../../../player/types';
+import { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics, VideoCodec } from '../../../player/types';
 import { LiveStreamStatus } from './types';
 import { CommonInit, Manifest, Representation, StreamKind, TextRepresentation } from '../../../providers/utils/parsers/types';
 import StateMachine from '../../../utils/StateMachine/StateMachine';
@@ -50,6 +50,8 @@ export declare class Player {
     lastConnectionType$: IValueSubject<HttpConnectionType | undefined>;
     lastConnectionReused$: IValueSubject<boolean | undefined>;
     lastRequestFirstBytes$: IValueSubject<Milliseconds | undefined>;
+    lastConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    lastDownloadMetrics$: IValueSubject<HttpDownloadMetrics | undefined>;
     currentLiveTextRepresentation$: IValueSubject<TextRepresentation | null>;
     private timeoutSourceOpenId;
     isLive$: IValueSubject<boolean>;

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

@@ -9,6 +9,7 @@ export interface Dependencies {
     compatibilityMode?: boolean;
     manifest: Manifest | null;
     getCurrentPosition(): Milliseconds | undefined;
+    getCurrentStallDuration(): Milliseconds;
     isActiveLowLatency(): boolean;
 }
 export interface IVirtualBufferManager {
@@ -27,7 +28,7 @@ export interface IVirtualBufferManager {
     setTarget(time: Milliseconds): void;
     setPreloadOnly(preloadOnly: boolean): void;
     findSegmentStartTime(position: Milliseconds): Milliseconds | undefined;
-    calculateDurationFromSegments(): Milliseconds;
+    calculateDurationFromSegments(representationId: Representation['id']): Milliseconds;
     destroy(): void;
     get lastDataObtainedTimestamp(): Milliseconds;
 }

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

@@ -44,7 +44,8 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
     protected downloadAbortController: AbortController;
     protected subscription: Subscription;
     protected readonly getCurrentPosition: () => Milliseconds | undefined;
-    protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tuning, getCurrentPosition, manifest }: Dependencies);
+    protected readonly getCurrentStallDuration: () => Milliseconds | undefined;
+    protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tuning, getCurrentPosition, getCurrentStallDuration, manifest }: 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;
@@ -59,7 +60,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
     abort(): Promise<void>;
     findSegmentStartTime(position: Milliseconds): Milliseconds | undefined;
     getRepresentationInitialTime(): Seconds;
-    calculateDurationFromSegments(): Milliseconds;
+    calculateDurationFromSegments(representationId: Representation['id']): Milliseconds;
     get lastDataObtainedTimestamp(): Milliseconds;
     setTarget(time: Milliseconds): void;
     setPreloadOnly(preloadOnly: boolean): void;

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

@@ -1,7 +1,16 @@
-import { HttpConnectionType } from '../../../player/types';
+import { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from '../../../player/types';
 import type ThroughputEstimator from '../../../utils/ThroughputEstimator';
 import { Byte, IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from '@vkontakte/videoplayer-shared';
 import { CommonInit, GenericContainerParser, Segment, SegmentReference } from '../../../providers/utils/parsers/types';
+declare global {
+    interface Navigator {
+        connection: {
+            effectiveType: string;
+            downlink: number;
+            rtt: number;
+        };
+    }
+}
 export declare enum RangeMethod {
     HEADER = 0,
     PARAM = 1
@@ -44,14 +53,24 @@ export declare class Fetcher {
     lastConnectionType$: IValueSubject<HttpConnectionType | undefined>;
     lastConnectionReused$: IValueSubject<boolean | undefined>;
     lastRequestFirstBytes$: IValueSubject<Milliseconds | undefined>;
+    lastConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    lastDownloadMetrics$: IValueSubject<HttpDownloadMetrics | undefined>;
     recoverableError$: ISubject<IError>;
     error$: ISubject<IError>;
     private abortAllController;
     private subscription;
     private compatibilityMode;
     private useEnableSubtitlesParam;
+    private performanceObserver;
+    private pendingConnectionMetrics;
     constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam }: IParams);
     private onHeadersReceived;
+    private setupPerformanceObserver;
+    private processResourceTiming;
+    private estimateNetworkType;
+    private extractConnectionMetrics;
+    private findMatchingRequest;
+    private trackRequestStart;
     fetchManifest: (param_0: string) => Promise<string | null | undefined>;
     fetch: (param_0: string, param_1: FetchParams) => Promise<ArrayBuffer | null | undefined>;
     fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, priority?: Priority): Promise<RepresentationFetchResult<T> | null | undefined>;

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

@@ -1,4 +1,4 @@
-import { IHLSSource, HttpConnectionType, VideoCodec } from '../../../../player/types';
+import { IHLSSource, HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics, VideoCodec } from '../../../../player/types';
 import { LiveStreamStatus } from '../types';
 import { CommonInit, Manifest, Representation, StreamKind, TextRepresentation } from '../../../../providers/utils/parsers/types';
 import StateMachine from '../../../../utils/StateMachine/StateMachine';
@@ -45,6 +45,8 @@ export declare abstract class BasePlayer {
     lastConnectionType$: IValueSubject<HttpConnectionType | undefined>;
     lastConnectionReused$: IValueSubject<boolean | undefined>;
     lastRequestFirstBytes$: IValueSubject<Milliseconds | undefined>;
+    lastConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    lastDownloadMetrics$: IValueSubject<HttpDownloadMetrics | undefined>;
     currentLiveTextRepresentation$: IValueSubject<TextRepresentation | null>;
     private timeoutSourceOpenId;
     isLive$: IValueSubject<boolean>;
@@ -74,7 +76,7 @@ export declare abstract class BasePlayer {
     switchRepresentation(kind: StreamKind, id: Representation['id'], isAuto?: boolean): Promise<void>;
     seek(requestedPosition: Milliseconds, forcePrecise?: boolean): Promise<void>;
     warmUpMediaSourceIfNeeded(position?: Milliseconds | undefined): void;
-    calculateDurationFromSegments(): Milliseconds;
+    calculateDurationFromSegments(representationId: Representation['id']): Milliseconds;
     get isStreamEnded(): boolean;
     getStreams(): Manifest['streams'] | undefined;
     getCodecs(): Manifest['codecs'] | undefined;

package/types/providers/types.d.ts

@@ -1,7 +1,7 @@
 import { ITuningConfig } from '../utils/tuningConfig';
 import { ILogger, ISubject, IValueSubject, Milliseconds, Seconds, IRange, IError, QualityLimits, IWarning, IComponentLogger, ITracer, IRectangle } from '@vkontakte/videoplayer-shared';
 import { IChromecastInitializer } from '../providers/ChromecastProvider/ChromecastInitializer/types';
-import { HttpConnectionType, VideoCodec, AudioCodec, IAudioStream, IAudioTrack, ICueSettings, ISources, IVideoStream, SeekState } from '../player/types';
+import { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics, VideoCodec, AudioCodec, IAudioStream, IAudioTrack, ICueSettings, ISources, IVideoStream, SeekState } from '../player/types';
 import { IExternalTextTrack, IInternalTextTrack, ITextTrack, IVideoTrack, IVolumeState, PlaybackState, PlaybackRate } from '../player/types';
 import { IStateMachine } from '../utils/StateMachine/types';
 import ThroughputEstimator from '../utils/ThroughputEstimator';
@@ -80,6 +80,8 @@ export interface IProviderOutput {
     hostname$: IValueSubject<string | undefined>;
     httpConnectionType$: IValueSubject<HttpConnectionType | undefined>;
     httpConnectionReused$: IValueSubject<boolean | undefined>;
+    httpConnectionMetrics$: IValueSubject<HttpConnectionMetrics | undefined>;
+    httpDownloadMetrics$: IValueSubject<HttpDownloadMetrics | undefined>;
     element$: IValueSubject<HTMLVideoElement | undefined>;
     elementVisible$: IValueSubject<boolean>;
     availableSources$: IValueSubject<ISources | undefined>;

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

@@ -0,0 +1,4 @@
+import { ITuningConfig } from '../../utils/tuningConfig';
+import { Manifest } from './parsers/types';
+/** @mutates streams.video */
+export declare const applyVideoStreamRepresentaionsFilter: (streams: Manifest["streams"], videoStreamRepresentaionsFilter: ITuningConfig["dash"]["videoStreamRepresentaionsFilter"]) => void;

package/types/utils/tuningConfig.d.ts

@@ -124,6 +124,11 @@ export type ITuningConfig = {
         ignoreNetworkErrorsOnLoadInit: boolean;
         bufferTolerance: Milliseconds;
         actionTimeShiftFromSegment: Milliseconds;
+        tickMaintainInterval: Milliseconds;
+        minSafeBufferToPlay: Milliseconds;
+        useBufferHoldingOnlyOnStall: boolean;
+        useNewStallExitPolicy: boolean;
+        videoStreamRepresentaionsFilter: [VideoQuality, number][];
     };
     dashCmafLive: {
         externalStopControl: boolean;