@vkontakte/videoplayer-core 2.0.62 → 2.0.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.62",
+  "version": "2.0.63",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",

package/packages/sdk/src/providers/types.d.ts

@@ -58,6 +58,7 @@ export interface IProviderOutput {
     error$: ISubject<IError>;
     endedEvent$: ISubject<void>;
     loopedEvent$: ISubject<Seconds>;
-    firstBytesEvent$: ISubject<number>;
-    firstFrameEvent$: ISubject<number>;
+    firstBytesEvent$: ISubject<void>;
+    firstFrameEvent$: ISubject<void>;
+    canplay$: ISubject<void>;
 }

package/player/Player.d.ts

@@ -15,6 +15,7 @@ export default class Player implements IPlayer {
     private tuning;
     private throughputEstimator;
     private isPlaybackStarted;
+    private initedAt;
     private desiredState;
     info: {
         playbackState$: ValueSubject<PlaybackState>;
@@ -52,6 +53,7 @@ export default class Player implements IPlayer {
         } | undefined>;
     };
     events: {
+        inited$: Subject<void>;
         started$: Subject<boolean>;
         startAttempt$: Subject<StartStatus>;
         willPause$: Subject<void>;
@@ -67,6 +69,7 @@ export default class Player implements IPlayer {
         willSeek$: Subject<ISeekRequest>;
         firstBytes$: Subject<number>;
         firstFrame$: Subject<number>;
+        canplay$: Subject<number>;
         log$: Subject<ILogEntry>;
     };
     experimental: {

package/player/types.d.ts

@@ -66,6 +66,10 @@ export interface IPlayer {
  * остальные - в момент окончания действия.
  */
 export interface IPlayerEvents {
+    /**
+     * Плеер получил ссылку и готов к взаимодействию
+     */
+    inited$: IObservable<void>;
     /**
      * Видео начало воспроизведение в первый раз
      * Соответствует первому для видео внешнему запуску воспроизведения
@@ -126,15 +130,21 @@ export interface IPlayerEvents {
      * Получен первый кусок контента от сервера раздачи видео
      * Событие поддерживается не во всех провайдерах (т.к. не все способы проигрывания видео поддерживают такой интерфейс)
      *
-     * Содержит время в миллисекундах: сколько прошло с момента отправки запроса за видео данными (ping)
+     * Содержит время в миллисекундах: сколько прошло с момента инициализации
      */
-    firstBytes$: IObservable<number>;
+    firstBytes$: IObservable<Milliseconds>;
     /**
      * Показан первый кадр
      *
-     * Содержит время в миллисекундах: сколько прошло времени с момента старта воспроизведения
+     * Содержит время в миллисекундах: сколько прошло времени с инициализации
+     */
+    firstFrame$: IObservable<Milliseconds>;
+    /**
+     * Плеер готов начать воспроизведение
+     *
+     * Содержит время в миллисекундах: сколько прошло времени с инициализации
      */
-    firstFrame$: IObservable<number>;
+    canplay$: IObservable<Milliseconds>;
     /**
      * Логи для отладки
      */

package/providers/DashLiveProvider/utils/LiveDashPlayer.d.ts

@@ -0,0 +1,135 @@
+import { Milliseconds } from '@vkontakte/videoplayer-shared';
+import { IRepresentation } from '../types';
+interface IParams {
+    videoElement: HTMLVideoElement;
+    playerCallback: (...args: any) => void;
+    config: {
+        minBuffer: Milliseconds;
+        lowLatencyMinBuffer: Milliseconds;
+        minBufferSegments: number;
+        lowLatencyMinBufferSegments: number;
+        maxParallelRequests: number;
+    };
+    logger: (...args: any[]) => void;
+}
+export default class LiveDashPlayer {
+    private paused;
+    private autoQuality;
+    private maxAutoQuality;
+    private buffering;
+    private destroyed;
+    private videoPlayStarted;
+    private lowLatency;
+    private rep?;
+    private bitrate;
+    private manifest;
+    private bitrateSwitcher?;
+    private filesFetcher?;
+    private sourceBuffer?;
+    private mediaSource?;
+    private currentManifestEntry?;
+    private manifestRequest?;
+    private manifestRefetchTimer?;
+    private bufferStates;
+    private downloadRate?;
+    private sourceJitter;
+    private chunkRateEstimator;
+    private manifestUrl;
+    private urlResolver;
+    private params;
+    constructor(params: IParams);
+    attachSource(manifestUrl: string): void;
+    /**
+     * switch to auto quality
+     */
+    setAutoQualityEnabled(enabled: boolean): void;
+    setMaxAutoQuality(height: number | undefined): void;
+    /**
+     * switch quality by name
+     */
+    switchByName(name: string): void;
+    /**
+     * seek to actual video position
+     */
+    catchUp(): void;
+    stop(): void;
+    pause(): void;
+    play(onPlayNotAllowed?: () => void): void;
+    startPlay(targetQ: IRepresentation, autoQuality: boolean): void;
+    /**
+     * destroy player
+     */
+    destroy(): void;
+    reinit(newManifestUrl: string): void;
+    /**
+     * if all retries fail...
+     */
+    private _handleNetworkError;
+    /**
+     * Retry request
+     */
+    private _retryCallback;
+    /**
+     * how many seconds are there in the buffer
+     */
+    private _getBufferSizeSec;
+    /**
+     * send buffering notification to player
+     */
+    private _notifyBuffering;
+    /**
+     * initialize video tag, add necessary event listeners
+     * @private
+     */
+    private _initVideo;
+    /**
+     * there may be small gaps of several milliseconds when switching quality
+     * we jump over these gaps here
+     */
+    private _fixupStall;
+    /**
+     * return best quality for rate
+     */
+    private _selectQuality;
+    private shouldPlay;
+    /**
+     * set video source
+     */
+    private _setVideoSrc;
+    /**
+     * initialize player with target quality
+     */
+    private _initPlayerWith;
+    /**
+     * represents specific quality stream
+     */
+    private _representation;
+    /**
+     * switch to quality
+     * TODO: Если новое качество выше старого – переключиться сразу. Если хуже, доиграть буфер
+     */
+    private _switchToQuality;
+    /**
+     * check if quality is available
+     */
+    private _qualityAvailable;
+    /**
+     * analyze bitrate data and switch qualities accordingly
+     */
+    private _initBitrateSwitcher;
+    /**
+     * load and parse manifest file
+     */
+    private _fetchManifest;
+    private _playVideoElement;
+    /**
+     * update internal state when manifest was received from remote
+     */
+    private _handleManifestUpdate;
+    /**
+     * schedule manifest update after delay
+     */
+    private _refetchManifest;
+    private _initManifest;
+}
+export {};

package/providers/DashProvider/utils/DashLite.d.ts

@@ -0,0 +1,60 @@
+import { Milliseconds } from '@vkontakte/videoplayer-shared';
+import HttpVideoBuffer from "../../../utils/buffer/HttpVideoBuffer";
+import { IDashConfig, IRef, IRepresentation } from '../types';
+interface IParams {
+    video: HTMLVideoElement;
+    buffer: HttpVideoBuffer;
+    selectRepresentation: (representations: IRepresentation[]) => IRepresentation;
+    onManifestReady: (representations: IRepresentation[]) => void;
+    onIdxRequestPing: (ping: Milliseconds) => void;
+    onResponseHeaders: (headers: Headers) => void;
+    onBandwidthChange: (payload: {
+        size: number;
+        duration: number;
+        speed: number;
+    }) => void;
+    onRepresentationPlay: (representation: IRepresentation) => void;
+    onError: (id: string, message: string, thrown?: Error | unknown) => void;
+    config: IDashConfig;
+    onDashCallback?: (eventName: string, param?: any) => any;
+}
+export default class DashLite {
+    private _params;
+    private _representations;
+    private _appendVector;
+    private _currentRepresentation?;
+    private _stream;
+    private _lastLoadOffset?;
+    private _loopTimeout?;
+    private _cachingPaused;
+    private _duration;
+    private STREAM_END_THRESHOLD;
+    private _video;
+    private _buffer;
+    private _onDashCallback;
+    private _config;
+    constructor(params: IParams);
+    /**
+     * Parse duration from ISO8601 string.
+     * @see https://en.wikipedia.org/wiki/ISO_8601#Durations
+     * @see https://github.com/moment/moment/blob/develop/src/lib/duration/create.js#L13
+     */
+    _parseDurationFromISO8601(input: string): number;
+    getRepresentations(): IRepresentation[];
+    attachSource(manifestUrl: string, failoverHosts?: string[]): void;
+    attachManifest(manifestString: string, failoverHosts?: string[], origin?: string): void;
+    _loadInitAndSidx(representation: IRepresentation, cb?: () => void): void;
+    startPlay(representation: IRepresentation): void;
+    _loadRef(representation: IRepresentation, fromTime: number, needToSeek?: boolean, forcePrecise?: boolean): void;
+    setQualityByRepresentation(newRepresentation: IRepresentation, force?: boolean): void;
+    setQuality(index: number): void;
+    pauseCaching(): void;
+    resumeCaching(): void;
+    seek(time: number, forcePrecise?: boolean): void;
+    updateRefsForCurrentTime(): void;
+    _findRef(time: number): IRef | undefined;
+    _isLastRef(ref: IRef): boolean;
+    _findBufferRangeEnd(time: number): number;
+    destroy(): void;
+}
+export {};

package/providers/ProviderContainer/index.d.ts

@@ -31,8 +31,9 @@ export default class ProviderContainer implements IProviderContainer {
         seekedEvent$: Subject<void>;
         loopedEvent$: Subject<number>;
         endedEvent$: Subject<void>;
-        firstBytesEvent$: Subject<number>;
-        firstFrameEvent$: Subject<number>;
+        firstBytesEvent$: Subject<void>;
+        firstFrameEvent$: Subject<void>;
+        canplay$: Subject<void>;
         isLive$: ValueSubject<undefined>;
         liveTime$: ValueSubject<undefined>;
         availableTextTracks$: ValueSubject<never[]>;

package/providers/utils/observableVideo.d.ts

@@ -1,4 +1,4 @@
-import { Milliseconds, Seconds, IObservable, IError } from '@vkontakte/videoplayer-shared';
+import { Seconds, IObservable, IError } from '@vkontakte/videoplayer-shared';
 import { IVolumeState } from "../../player/types";
 import { IRange } from "../../utils/range";
 interface IObservableVideo {
@@ -11,15 +11,14 @@ interface IObservableVideo {
     seeked$: IObservable<undefined>;
     seeking$: IObservable<undefined>;
     progress$: IObservable<undefined>;
-    loadedMetadata$: IObservable<undefined>;
-    loadedData$: IObservable<undefined>;
     timeUpdate$: IObservable<Seconds>;
     durationChange$: IObservable<Seconds>;
+    loadStart$: IObservable<void>;
+    loadedMetadata$: IObservable<undefined>;
+    loadedData$: IObservable<undefined>;
     isBuffering$: IObservable<boolean>;
     currentBuffer$: IObservable<IRange<Seconds>>;
     volumeState$: IObservable<IVolumeState>;
-    firstBytes$: IObservable<Milliseconds>;
-    firstFrame$: IObservable<Milliseconds>;
 }
 export declare const observe: (video: HTMLVideoElement) => IObservableVideo;
 export {};

package/providers/utils/firstBytesEventForVideoElement.d.ts

@@ -1,3 +0,0 @@
-import { IObservable, Milliseconds } from '@vkontakte/videoplayer-shared';
-declare const _default: (video: HTMLVideoElement) => IObservable<Milliseconds>;
-export default _default;

package/providers/utils/firstFrameEvent.d.ts

@@ -1,3 +0,0 @@
-import { IObservable } from '@vkontakte/videoplayer-shared';
-declare const _default: (video: HTMLVideoElement) => IObservable<number>;
-export default _default;