@vkontakte/videoplayer-core 2.0.173 → 2.0.174-dev.477cdf9b9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.173",
+  "version": "2.0.174-dev.477cdf9b9.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-dev.477cdf9b9.0"
   }
 }

package/types/index.d.ts

@@ -3,7 +3,7 @@ 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 } from "./player/types";
+import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, ICueSettings, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
 import { PlaybackState, ChromecastState, HttpConnectionType } from "./player/types";
 import type { IOptionalTuningConfig } from "./utils/tuningConfig";
 export { clientChecker, isMobile } from "./utils/ClientChecker";
@@ -15,5 +15,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 };
+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 { Player, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };

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/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

@@ -252,6 +252,8 @@ export type ITuningConfig = {
 		maxQualityForFirstSegmentPreload: ExactVideoQuality;
 		/** Включает отправку телеметрии трейсера (resume) при превышении stall watchdog */
 		tracerResumeOnUnexpectedStall: boolean;
+		/** Включает отправку телеметрии трейсера (resume) при выборе ABR качества не выше lowQualityTelemetryLimit */
+		tracerResumeOnLowQuality: boolean;
 		/**
 		* Эксперимент: при `true` отключает `await this.reinitDecoderIfNeeded(shouldForceSeek)`
 		* внутри `stallWatchdogIntervalCallback`. По умолчанию `false` — текущее поведение
@@ -315,6 +317,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 +366,7 @@ export type ITuningConfig = {
 	* include-threshold - записываем столлы длинее stallIgnoreThreshold
 	*/
 	stallHandlingStrategy: "verbose" | "exclude-threshold" | "include-threshold";
+	stallIgnoreOnPause: boolean;
 	gapWatchdogInterval: Milliseconds;
 	requestQuick: boolean;
 	/** @deprecated HLS.js удалён, флаг ничего не делает */