@vkontakte/videoplayer-core 2.0.85 → 2.0.86-dev.f2e1ec4.0

package/index.d.ts

@@ -94,34 +94,56 @@ interface IPlayer {
  */
 interface IPlayerEvents {
     /**
-     * Плеер получил ссылку и готов к взаимодействию
+     * Плеер получил ссылку и начал полезную работу
      */
     inited$: IObservable<void>;
+    /**
+     * Предзагрузка окончена и плеер готов стартовать немедленно. Если предзагрузка не инициировалась, события не будет
+     */
+    ready$: IObservable<void>;
     /**
      * Видео начало воспроизведение в первый раз
      * Соответствует первому для видео внешнему запуску воспроизведения
      */
     started$: IObservable<void>;
+    /**
+     * Любое начало воспроизведения. Первои и после паузы
+     */
+    playing$: IObservable<void>;
+    /**
+     * Видео на паузе
+     */
+    paused$: IObservable<void>;
+    /**
+     * Плеер остановлен
+     */
+    stopped$: IObservable<void>;
     /**
      * Запрошена пауза
      */
     willPause$: IObservable<void>;
+    /**
+     * Запрошено первый старт воспроизведения
+     */
+    willStart$: IObservable<void>;
     /**
      * Запрошено возобновление воспроизведения после паузы
      */
     willResume$: IObservable<void>;
+    /**
+     * Плеер будет остановлен
+     */
+    willStop$: IObservable<void>;
     /**
      * Плеер будет уничтожен, в момент события можно синхронно запросить последние данные о его состоянии.
      */
     willDestruct$: IObservable<void>;
     /**
-     * Просмотрен промежуток видео.
-     * Параметр содержит диапазон: начальная и конечная позиция просмотра (в секундах от начала ролика).
+     * @deprecated
      */
     watchCoverageRecord$: IObservable<StartEnd<Seconds>>;
     /**
-     * Просмотрен промежуток видео. Промежуток видео, которые были просмотрены пользователем.
-     * Параметр содержит диапазон: начальный и конечный UTC tipestamp?
+     * @deprecated
      */
     watchCoverageLive$: IObservable<StartEnd<Milliseconds>>;
     /**
@@ -173,6 +195,10 @@ interface IPlayerEvents {
     log$: IObservable<ILogEntry>;
 }
 interface IPlayerInfo {
+    /**
+     * Оптимистичный статут плеера. Так например, значение будет равно Playing сразу после вызова play().
+     * Фактическое состояние лучше отслеживать по событиям (например, playing$)
+     */
     playbackState$: IValueObservable<PlaybackState>;
     /**
      * Текущая позиция.
@@ -268,6 +294,10 @@ interface IPlayerInfo {
      * Бесконечный ли стрим
      */
     isLive$: IValueObservable<boolean | undefined>;
+    /**
+     * Играем ли мы сейчас самый актуальный кадр лайва
+     */
+    atLiveEdge$: IValueObservable<boolean | undefined>;
     /**
      * Серверное время текущего кадра
      */
@@ -324,6 +354,10 @@ interface IPlayerInfo {
         width: number;
         height: number;
     } | undefined>;
+    /**
+     * Где сейчас рисуется картинка
+     */
+    surface$: IValueObservable<Surface | undefined>;
 }
 declare enum PlaybackState {
     STOPPED = "stopped",
@@ -441,7 +475,14 @@ declare enum HttpConnectionType {
     QUIC = "quic"
 }
 type FpsByQuality = Partial<Record<VideoQuality, number>>;
-type PlaybackRate = number;
+type PlaybackRate = number;
+declare enum Surface {
+    NONE = "none",
+    INLINE = "inline",
+    FULLSCREEN = "fullscreen",
+    SECOND_SCREEN = "second_screen",
+    PIP = "pip"
+}
 
 type ITuningConfig = {
     throughputEstimator: {
@@ -559,6 +600,7 @@ declare class Player implements IPlayer {
         isEnded$: ValueSubject<boolean>;
         isLooped$: ValueSubject<boolean>;
         isLive$: ValueSubject<boolean | undefined>;
+        atLiveEdge$: ValueSubject<boolean | undefined>;
         liveTime$: ValueSubject<number | undefined>;
         currentFormat$: ValueSubject<VideoFormat | undefined>;
         availableTextTracks$: ValueSubject<ITextTrack[]>;
@@ -569,6 +611,7 @@ declare class Player implements IPlayer {
         hostname$: ValueSubject<string | undefined>;
         httpConnectionType$: ValueSubject<HttpConnectionType | undefined>;
         httpConnectionReused$: ValueSubject<boolean | undefined>;
+        surface$: ValueSubject<Surface>;
         chromecastState$: ValueSubject<ChromecastState>;
         chromecastDeviceName$: ValueSubject<string | undefined>;
         intrinsicVideoSize$: ValueSubject<{
@@ -578,9 +621,15 @@ declare class Player implements IPlayer {
     };
     events: {
         inited$: Subject<void>;
+        ready$: Subject<void>;
         started$: Subject<void>;
-        willPause$: 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>>;
@@ -642,4 +691,4 @@ declare class Player implements IPlayer {
  */
 declare const SDK_VERSION: string;
 
-export { ChromecastState, ExactVideoQuality, HttpConnectionType, IConfig, ICueSettings, IDashSource, IDashURLSource, IExternalTextTrack, IHLSLiveSource, IHLSSource, IMpegSource, IPlayer, IPlayerEvents, IPlayerInfo, ISeekRequest, ISources, ITextTrack, PlaybackRate, PlaybackState, Player, RawSource, SDK_VERSION, URLSource, URLSourceWithSeek, VideoFormat, VideoQuality };
+export { ChromecastState, ExactVideoQuality, HttpConnectionType, IConfig, ICueSettings, IDashSource, IDashURLSource, IExternalTextTrack, IHLSLiveSource, IHLSSource, IMpegSource, IPlayer, IPlayerEvents, IPlayerInfo, ISeekRequest, ISources, ITextTrack, PlaybackRate, PlaybackState, Player, RawSource, SDK_VERSION, Surface, URLSource, URLSourceWithSeek, VideoFormat, VideoQuality };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.85",
+  "version": "2.0.86-dev.f2e1ec4.0",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -49,7 +49,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "^1.0.23",
+    "@vkontakte/videoplayer-shared": "^1.0.24-dev.fd1a076.0",
     "dashjs": "~4.6.0",
     "hls.js": "~1.4.0",
     "lodash": "~4.17.21"