@vkontakte/videoplayer-core 2.0.103 → 2.0.104

package/package.json

@@ -1,39 +1,39 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.103",
+  "version": "2.0.104",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",
   "license": "GPL-3.0",
   "main": "./esnext.cjs.js",
   "module": "./esnext.esm.js",
-  "types": "./index.d.ts",
+  "types": "./types/index.d.ts",
   "type": "module",
   "exports": {
     ".": {
       "import": "./esnext.esm.js",
       "require": "./esnext.cjs.js",
-      "types": "./index.d.ts"
+      "types": "./types/index.d.ts"
     },
     "./evergreen": {
       "import": "./evergreen.esm.js",
       "require": "./evergreen.cjs.js",
-      "types": "./index.d.ts"
+      "types": "./types/index.d.ts"
     },
     "./esnext": {
       "import": "./esnext.esm.js",
       "require": "./esnext.cjs.js",
-      "types": "./index.d.ts"
+      "types": "./types/index.d.ts"
     },
     "./es2018": {
       "import": "./es2018.esm.js",
       "require": "./es2018.cjs.js",
-      "types": "./index.d.ts"
+      "types": "./types/index.d.ts"
     },
     "./es2015": {
       "import": "./es2015.esm.js",
       "require": "./es2015.cjs.js",
-      "types": "./index.d.ts"
+      "types": "./types/index.d.ts"
     },
     "./evergreen.esm.js": "./evergeen.esm.js",
     "./esnext.esm.js": "./esnext.esm.js",

package/types/enums/AndroidPreferredFormat.d.ts

@@ -0,0 +1,8 @@
+export declare enum AndroidPreferredFormat {
+    DASH = "dash",
+    HLS = "hls",
+    MPEG = "mpeg",
+    DASH_ANY_MPEG = "dash_any_mpeg",
+    DASH_ANY_WEBM = "dash_any_webm",
+    DASH_SEP = "dash_sep"
+}

package/types/enums/WebmCodecStrategy.d.ts

@@ -0,0 +1,7 @@
+export declare enum WebmCodecStrategy {
+    VP9 = "vp9",
+    AV1 = "av1",
+    NONE = "none",
+    SMOOTH = "smooth",
+    POWER_EFFICIENT = "power_efficient"
+}

package/types/env.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/types/index.d.ts

@@ -0,0 +1,12 @@
+import { VERSION } from './env';
+import { VideoFormat, IMpegSource, IDashSource, IHLSSource, IDashURLSource, IHLSLiveSource, ISeekRequest, URLSource, RawSource, URLSourceWithSeek, Surface } from './player/types';
+import Player from './player/Player';
+import { IPlayer, PlaybackState, IPlayerInfo, IPlayerEvents, IConfig, ISources, ICueSettings, ChromecastState, HttpConnectionType, IExternalTextTrack, ITextTrack, PlaybackRate } from './player/types';
+import type { IOptionalTuningConfig } from './utils/tuningConfig';
+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';
+/**
+ * @deprecated
+ */
+declare const SDK_VERSION: string;
+export { Player, IPlayer, PlaybackState, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ChromecastState, HttpConnectionType, Surface, Subscription, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, VideoFormat, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, VideoQuality, ExactVideoQuality, Observable, Subject, ValueSubject, IRange, ISeekRequest, ICueSettings, VERSION, SDK_VERSION, PlaybackRate, };

package/types/player/Player.d.ts

@@ -0,0 +1,173 @@
+import { IOptionalTuningConfig } from '../utils/tuningConfig';
+import { IError, ILogEntry, Seconds, Subject, ValueSubject, QualityLimits, VideoQuality } from '@vkontakte/videoplayer-shared';
+import { ChromecastState, HttpConnectionType, IAudioTrack, IConfig, ICueSettings, IExternalTextTrack, IPlayer, ISeekRequest, ISources, ITextTrack, PlaybackRate, PlaybackState, StartEnd, Surface, VideoFormat } from './types';
+export default class Player implements IPlayer {
+    private subscription;
+    private domContainer;
+    private providerContainer?;
+    private chromecastInitializer;
+    private logger;
+    private abrLogger;
+    private config;
+    private tuning;
+    private throughputEstimator;
+    private isPlaybackStarted;
+    private initedAt;
+    private hasLiveOffsetByPaused;
+    private hasLiveOffsetByPausedTimer;
+    private desiredState;
+    info: {
+        playbackState$: ValueSubject<PlaybackState>;
+        position$: ValueSubject<number>;
+        duration$: ValueSubject<number>;
+        muted$: ValueSubject<boolean>;
+        volume$: ValueSubject<number>;
+        availableQualities$: ValueSubject<VideoQuality[]>;
+        availableQualitiesFps$: ValueSubject<Partial<Record<VideoQuality, number>>>;
+        availableAudioTracks$: ValueSubject<IAudioTrack[]>;
+        isAudioAvailable$: ValueSubject<boolean>;
+        currentQuality$: ValueSubject<VideoQuality | undefined>;
+        isAutoQualityEnabled$: ValueSubject<boolean>;
+        autoQualityLimitingAvailable$: ValueSubject<boolean>;
+        autoQualityLimits$: ValueSubject<QualityLimits>;
+        currentPlaybackRate$: ValueSubject<number>;
+        currentBuffer$: ValueSubject<StartEnd<number>>;
+        isBuffering$: ValueSubject<boolean>;
+        isStalled$: ValueSubject<boolean>;
+        isEnded$: ValueSubject<boolean>;
+        isLooped$: ValueSubject<boolean>;
+        isLive$: ValueSubject<boolean | undefined>;
+        canChangePlaybackSpeed$: ValueSubject<boolean | undefined>;
+        atLiveEdge$: ValueSubject<boolean | undefined>;
+        atLiveDurationEdge$: ValueSubject<boolean | undefined>;
+        liveTime$: ValueSubject<number | undefined>;
+        liveBufferTime$: ValueSubject<number | undefined>;
+        currentFormat$: ValueSubject<VideoFormat | undefined>;
+        availableTextTracks$: ValueSubject<ITextTrack[]>;
+        currentTextTrack$: ValueSubject<string | undefined>;
+        throughputEstimation$: ValueSubject<number | undefined>;
+        rttEstimation$: ValueSubject<number | undefined>;
+        videoBitrate$: ValueSubject<number | undefined>;
+        hostname$: ValueSubject<string | undefined>;
+        httpConnectionType$: ValueSubject<HttpConnectionType | undefined>;
+        httpConnectionReused$: ValueSubject<boolean | undefined>;
+        surface$: ValueSubject<Surface>;
+        chromecastState$: ValueSubject<ChromecastState>;
+        chromecastDeviceName$: ValueSubject<string | undefined>;
+        intrinsicVideoSize$: ValueSubject<{
+            width: number;
+            height: number;
+        } | undefined>;
+        availableSources$: ValueSubject<ISources | undefined>;
+        is3DVideo$: ValueSubject<boolean>;
+        currentVideoSegmentLength$: ValueSubject<number>;
+        currentAudioSegmentLength$: ValueSubject<number>;
+    };
+    events: {
+        inited$: Subject<void>;
+        ready$: Subject<void>;
+        started$: Subject<void>;
+        playing$: Subject<void>;
+        paused$: Subject<void>;
+        stopped$: Subject<void>;
+        willStart$: Subject<void>;
+        willResume$: Subject<void>;
+        willPause$: Subject<void>;
+        willStop$: Subject<void>;
+        willDestruct$: Subject<void>;
+        watchCoverageRecord$: Subject<StartEnd<number>>;
+        watchCoverageLive$: Subject<StartEnd<number>>;
+        managedError$: Subject<IError>;
+        fatalError$: Subject<IError>;
+        ended$: Subject<void>;
+        looped$: Subject<number>;
+        seeked$: Subject<void>;
+        willSeek$: Subject<ISeekRequest>;
+        firstBytes$: Subject<number>;
+        firstFrame$: Subject<number>;
+        canplay$: Subject<number>;
+        log$: Subject<ILogEntry>;
+    };
+    experimental: {
+        element$: ValueSubject<HTMLElement | undefined>;
+        tuningConfigName$: ValueSubject<string[]>;
+        enableDebugTelemetry$: ValueSubject<boolean>;
+        dumpTelemetry: (receiver: (value: Record<string, any>) => void) => void;
+    };
+    constructor(tuning?: IOptionalTuningConfig);
+    initVideo(config: IConfig): IPlayer;
+    destroy(): void;
+    prepare(): IPlayer;
+    play(): IPlayer;
+    pause(): IPlayer;
+    stop(): IPlayer;
+    seekTime(time: Seconds, forcePrecise?: boolean): IPlayer;
+    /**
+     * NOTE: Сейчас вызов `seekPercent` до получения `duration` не сработает.
+     * @param percent: number [0, 1];
+     */
+    seekPercent(percent: number): IPlayer;
+    setVolume(percent: number): IPlayer;
+    setMuted(isMuted: boolean): IPlayer;
+    setQuality(quality: VideoQuality): IPlayer;
+    setAutoQuality(enable: boolean): IPlayer;
+    setAutoQualityLimits(limits: QualityLimits): IPlayer;
+    setPlaybackRate(playbackRate: PlaybackRate): IPlayer;
+    setExternalTextTracks(tracks: Omit<IExternalTextTrack, 'type'>[]): IPlayer;
+    selectTextTrack(id: ITextTrack['id'] | undefined): IPlayer;
+    setTextTrackCueSettings(settings: ICueSettings): IPlayer;
+    setLooped(isLooped: boolean): IPlayer;
+    toggleChromecast(): void;
+    /**
+     * Starts 3D-camera constant rotation
+     * Base rotation speed is provided through the tuning config
+     *
+     * @param mx - camera X rotation speed multiplier
+     * @param my - camera Y rotation speed multiplier
+     *
+     * 1 - positive direction
+     * 0.5 - half speed in positive direction
+     * 0 - no rotation
+     * -1 negative direction
+     * -2 double speed in negative direction
+     *
+     * Limitations:
+     *    When camera reaches angles 180 or -180 in vertical direction it stops.
+     *    z-axis is frozen for now
+     *
+     * Set all zeroes to stop the camera rotation
+     *    startCameraManualRotation(0, 0);
+     */
+    startCameraManualRotation(mx: number, my: number): this;
+    /**
+     * Rotates 3d-camera to given angles relative to current position
+     */
+    stopCameraManualRotation(immediate?: boolean): this;
+    /**
+     * Rotates 3d-camera to given angles relative to current position
+     * using mouse deltas and scene fov
+     */
+    moveCameraFocusPX(dxpx: number, dypx: number): this;
+    /**
+     * "Holds" camera so that it can not perform movement without manual control
+     */
+    holdCamera(): this;
+    /**
+     * "Releases" the camera so that it can move using its internal logic
+     */
+    releaseCamera(): this;
+    getExactTime(): Seconds;
+    getAllLogs(): ILogEntry[];
+    private getScene3D;
+    private setIntrinsicVideoSize;
+    private initDesiredStateSubscriptions;
+    private initProviderContainerSubscription;
+    private initChromecastSubscription;
+    private initStartingVideoTrack;
+    private setStartingVideoTrack;
+    private initLogs;
+    private initDebugTelemetry;
+    private initWakeLock;
+    private setVideoTrackIdByQuality;
+    private getActiveLiveDelay;
+}