@gcorevideo/player 2.21.1 → 2.21.4

package/lib/plugins/subtitles/Subtitles.js

@@ -1,4 +1,4 @@
-import { Events, UICorePlugin, Browser, template, $, } from '@clappr/core';
+import { Events, UICorePlugin, Browser, template, $ } from '@clappr/core';
 import { reportError, trace } from '@gcorevideo/utils';
 import assert from 'assert';
 import { CLAPPR_VERSION } from '../../build.js';
@@ -9,9 +9,8 @@ import comboboxHTML from '../../../assets/subtitles/combobox.ejs';
 import stringHTML from '../../../assets/subtitles/string.ejs';
 import { isFullscreen } from '../utils.js';
 const VERSION = '2.19.14';
-const LOCAL_STORAGE_SUBTITLES_ID = 'gplayer.plugins.subtitles.selected';
-const T = 'plugins.subtitles';
-const NO_TRACK = { language: 'off' };
+const LOCAL_STORAGE_CC_ID = 'gplayer.plugins.cc.selected';
+const T = 'plugins.cc';
 /**
  * `PLUGIN` that provides a UI to select the subtitles when available.
  * @beta
@@ -21,36 +20,32 @@ const NO_TRACK = { language: 'off' };
  *
  * - {@link MediaControl}
  *
- * Configuration options:
- *
- * - subtitles.language - The language of the subtitles to select by default.
- *
+ * Configuration options -  {@link ClosedCaptionsPluginSettings}
  * @example
  * ```ts
- * import { Subtitles } from '@gcorevideo/player'
+ * import { ClosedCaptions } from '@gcorevideo/player'
  *
- * Player.registerPlugin(Subtitles)
+ * Player.registerPlugin(ClosedCaptions)
  *
  * new Player({
  *   ...
- *   subtitles: {
+ *   cc: {
  *     language: 'en',
  *   },
  * })
  * ```
  */
 export class Subtitles extends UICorePlugin {
-    currentLevel = null;
     isPreselectedApplied = false;
     isShowing = false;
-    track = { ...NO_TRACK };
-    tracks = null;
-    $string = null;
+    track = null;
+    tracks = [];
+    $line = null;
     /**
      * @internal
      */
     get name() {
-        return 'subtitles';
+        return 'subtitles'; // TODO rename to 'cc'
     }
     /**
      * @internal
@@ -71,8 +66,7 @@ export class Subtitles extends UICorePlugin {
      */
     get attributes() {
         return {
-            class: this.name,
-            'data-subtitles': '',
+            class: 'media-control-cc',
         };
     }
     /**
@@ -80,28 +74,34 @@ export class Subtitles extends UICorePlugin {
      */
     get events() {
         return {
-            'click [data-subtitles-select]': 'onLevelSelect',
-            'click [data-subtitles-button]': 'onShowLevelSelectMenu',
+            'click [data-cc-select]': 'onItemSelect',
+            'click [data-cc-button]': 'toggleMenu',
         };
     }
     get preselectedLanguage() {
-        return this.core.options.subtitles?.language ?? 'off';
+        return this.core.options.cc?.language ?? this.core.options.subtitles?.language ?? '';
     }
     /**
      * @internal
      */
     bindEvents() {
+        this.listenTo(this.core, Events.CORE_READY, this.onCoreReady);
+        this.listenTo(this.core, Events.CORE_RESIZE, this.playerResize);
+        this.listenTo(this.core, Events.CORE_ACTIVE_CONTAINER_CHANGED, this.onContainerChanged);
+    }
+    onCoreReady() {
+        trace(`${T} onCoreReady`);
         const mediaControl = this.core.getPlugin('media_control');
         assert(mediaControl, 'media_control plugin is required');
-        this.listenTo(this.core, Events.CORE_RESIZE, this.playerResize);
-        this.listenTo(this.core, Events.CORE_ACTIVE_CONTAINER_CHANGED, this.bindPlaybackEvents);
         this.listenTo(mediaControl, Events.MEDIACONTROL_RENDERED, this.render);
-        this.listenTo(mediaControl, Events.MEDIACONTROL_HIDE, this.hideSelectLevelMenu);
+        this.listenTo(mediaControl, Events.MEDIACONTROL_HIDE, this.hideMenu);
     }
-    bindPlaybackEvents() {
+    onContainerChanged() {
+        trace(`${T} onContainerChanged`);
         this.listenTo(this.core.activeContainer, Events.CONTAINER_FULLSCREEN, this.playerResize);
-        this.listenToOnce(this.core.activePlayback, Events.PLAYBACK_PLAY, this.getTracks);
         this.listenTo(this.core.activeContainer, 'container:advertisement:start', this.onStartAd);
+        this.listenTo(this.core.activePlayback, Events.PLAYBACK_SUBTITLE_AVAILABLE, this.onSubtitleAvailable);
+        this.listenTo(this.core.activePlayback, Events.PLAYBACK_SUBTITLE_CHANGED, this.onSubtitleChanged);
         // fix for iOS
         const video = this.core.activePlayback.el;
         assert(video, 'video element is required');
@@ -116,20 +116,50 @@ export class Subtitles extends UICorePlugin {
             }
         });
     }
-    getTracks() {
-        if (this.core.activePlayback) {
-            try {
-                const tracks = this.core.activePlayback.el
-                    .textTracks;
-                if (tracks.length > 0) {
-                    this.setTracks(tracks);
-                }
+    onSubtitleAvailable() {
+        trace(`${T} onSubtitleAvailable`);
+        this.applyTracks();
+    }
+    onSubtitleChanged({ id }) {
+        trace(`${T} onSubtitleChanged`, { id });
+        if (id === -1) {
+            this.clearSubtitleText();
+        }
+        for (const track of this.tracks) {
+            if (track.id === id) {
+                track.track.mode = 'showing';
+                this.setSubtitleText(this.getSubtitleText(track.track));
+                track.track.oncuechange = (e) => {
+                    try {
+                        if (track.track.activeCues?.length) {
+                            const html = track.track.activeCues[0].getCueAsHTML();
+                            this.setSubtitleText(html);
+                        }
+                        else {
+                            this.clearSubtitleText();
+                        }
+                    }
+                    catch (error) {
+                        reportError(error);
+                    }
+                };
             }
-            catch (error) {
-                reportError(error);
+            else {
+                track.track.oncuechange = null;
+                track.track.mode = 'hidden';
             }
         }
     }
+    applyTracks() {
+        try {
+            this.tracks = this.core.activePlayback.closedCaptionsTracks;
+            this.applyPreselectedSubtitles();
+            this.render();
+        }
+        catch (error) {
+            reportError(error);
+        }
+    }
     onStartAd() {
         if (this.isShowing && this.core.activeContainer) {
             this.hide();
@@ -141,10 +171,11 @@ export class Subtitles extends UICorePlugin {
         this.stopListening(this.core.activeContainer, 'container:advertisement:finish', this.onFinishAd);
     }
     playerResize() {
+        trace(`${T} playerResize`);
         const shouldShow = this.core.activeContainer &&
             isFullscreen(this.core.activeContainer.el) &&
-            this.currentLevel &&
-            this.currentLevel.mode &&
+            this.track &&
+            this.track.track.mode &&
             Browser.isiOS &&
             this.isShowing;
         if (shouldShow) {
@@ -163,10 +194,10 @@ export class Subtitles extends UICorePlugin {
     hide() {
         this.isShowing = false;
         this.renderIcon();
-        this.$string.hide();
+        this.$line.hide();
         if (this.tracks) {
             for (const t of this.tracks) {
-                t.mode = 'hidden';
+                t.track.mode = 'hidden';
             }
         }
     }
@@ -178,28 +209,25 @@ export class Subtitles extends UICorePlugin {
         this.renderIcon();
         if (this.core.activeContainer &&
             isFullscreen(this.core.activeContainer.el) &&
-            this.currentLevel &&
-            this.currentLevel.mode &&
+            this.track &&
+            this.track.track.mode &&
             Browser.isiOS) {
-            this.$string.hide();
-            this.currentLevel.mode = 'showing';
+            this.$line.hide();
+            this.track.track.mode = 'showing';
         }
         else {
-            this.$string.show();
+            this.$line.show();
         }
     }
     shouldRender() {
-        return !!(this.tracks && this.tracks.length > 0);
+        return this.tracks?.length > 0;
     }
     resizeFont() {
-        if (!this.core.activeContainer) {
-            return;
-        }
-        if (!this.$string) {
+        if (!this.$line) {
             return;
         }
         const skinWidth = this.core.activeContainer.$el.width();
-        this.$string.find('p').css('font-size', skinWidth * 0.03);
+        this.$line.find('p').css('font-size', skinWidth * 0.03);
     }
     /**
      * @internal
@@ -211,143 +239,83 @@ export class Subtitles extends UICorePlugin {
         if (!this.shouldRender()) {
             return this;
         }
-        trace(`${T} render`, {
-            tracks: this.tracks?.length,
-            track: this.track?.language,
-        });
         const mediaControl = this.core.getPlugin('media_control');
-        assert(mediaControl, 'media_control plugin is required');
         this.$el.html(Subtitles.template({ tracks: this.tracks }));
-        this.core.activeContainer.$el.find('.subtitle-string').remove();
-        this.$string = $(Subtitles.templateString());
+        this.core.activeContainer.$el.find('#cc-line').remove();
+        this.$line = $(Subtitles.templateString());
         this.resizeFont();
-        this.core.activeContainer.$el.append(this.$string[0]);
-        const ss = mediaControl.getElement('subtitlesSelector');
-        if (ss && ss.length > 0) {
-            ss.append(this.el);
-        }
-        else {
-            mediaControl.getRightPanel().append(this.el);
-        }
-        this.updateCurrentLevel(this.track);
-        this.highlightCurrentSubtitles();
-        this.applyPreselectedSubtitles();
+        this.core.activeContainer.$el.append(this.$line);
+        mediaControl.putElement('cc', this.el);
+        this.updateSelection();
         this.renderIcon();
         return this;
     }
-    setTracks(tracks) {
-        this.tracks = tracks;
-        this.render();
-    }
-    findLevelBy(id) {
-        if (this.tracks) {
-            for (const track of this.tracks) {
-                if (track.language === id) {
-                    return track; // TODO TrackInfo?
-                }
-            }
-        }
+    findById(id) {
+        return this.tracks.find((track) => track.id === id) ?? null;
     }
-    selectLevel(id) {
+    selectItem(item) {
         this.clearSubtitleText();
-        this.track = this.findLevelBy(id) || { ...NO_TRACK };
-        this.hideSelectLevelMenu();
-        if (!this.track) {
-            this.track = { language: 'off' };
-        }
-        this.updateCurrentLevel(this.track);
-    }
-    onLevelSelect(event) {
-        const id = event.target.dataset.subtitlesSelect;
-        if (id) {
-            localStorage.setItem(LOCAL_STORAGE_SUBTITLES_ID, id);
-            this.selectLevel(id);
-        }
+        this.track = item;
+        this.hideMenu();
+        this.updateSelection();
+    }
+    onItemSelect(event) {
+        const id = event.target.dataset.ccSelect ?? '-1';
+        trace(`${T} onItemSelect`, { id });
+        localStorage.setItem(LOCAL_STORAGE_CC_ID, id);
+        this.selectItem(this.findById(Number(id)));
         return false;
     }
     applyPreselectedSubtitles() {
         if (!this.isPreselectedApplied) {
             this.isPreselectedApplied = true;
+            if (!this.preselectedLanguage) {
+                return;
+            }
             setTimeout(() => {
-                this.selectLevel(this.preselectedLanguage);
-            }, 300);
+                this.selectItem(this.tracks.find((t) => t.track.language === this.preselectedLanguage) ?? null);
+            }, 300); // TODO why delay?
         }
     }
-    onShowLevelSelectMenu() {
-        trace(`${T} onShowLevelSelectMenu`);
-        this.toggleContextMenu();
-    }
-    hideSelectLevelMenu() {
+    hideMenu() {
         ;
-        this.$('[data-subtitles] ul').hide();
+        this.$('[data-cc] ul').hide();
     }
-    toggleContextMenu() {
-        this.$('[data-subtitles] ul').toggle();
+    toggleMenu() {
+        trace(`${T} toggleMenu`);
+        this.$('[data-cc] ul').toggle();
     }
-    buttonElement() {
-        return this.$('[data-subtitles] button');
+    itemElement(id) {
+        return this.$(`ul li a[data-cc-select="${id}"]`).parent();
     }
-    levelElement(id) {
-        return this.$('[data-subtitles] ul a' + (id ? '[data-subtitles-select="' + id + '"]' : '')).parent();
-    }
-    startLevelSwitch() {
-        this.buttonElement().addClass('changing');
-    }
-    stopLevelSwitch() {
-        this.buttonElement().removeClass('changing');
+    allItemElements() {
+        return this.$('[data-cc] li');
     }
     selectSubtitles() {
-        if (!this.currentLevel) {
-            return;
-        }
-        if (this.tracks) {
-            for (let i = 0; i < this.tracks.length; i++) {
-                const track = this.tracks[i];
-                if (track.language === this.currentLevel.language) {
-                    track.mode = 'showing';
-                    const currentTime = this.core.activePlayback?.getCurrentTime() ?? 0;
-                    const cues = track.cues;
-                    let subtitleText = '';
-                    if (cues && cues.length) {
-                        for (const cue of cues) {
-                            if (currentTime >= cue.startTime && currentTime <= cue.endTime) {
-                                subtitleText +=
-                                    cue.getCueAsHTML().textContent + '\n';
-                            }
-                        }
-                    }
-                    this.setSubtitleText(subtitleText);
-                    track.oncuechange = (e) => {
-                        try {
-                            if (track.activeCues?.length) {
-                                const html = track.activeCues[0].getCueAsHTML();
-                                this.setSubtitleText(html);
-                            }
-                            else {
-                                this.clearSubtitleText();
-                            }
-                        }
-                        catch (error) {
-                            // console.error(error);
-                            reportError(error);
-                        }
-                    };
-                    continue;
+        const trackId = this.track ? this.track.id : -1;
+        this.core.activePlayback.closedCaptionsTrackId = trackId;
+    }
+    getSubtitleText(track) {
+        const currentTime = this.core.activePlayback?.getCurrentTime() ?? 0;
+        const cues = track.cues;
+        const lines = [];
+        if (cues && cues.length) {
+            for (const cue of cues) {
+                if (currentTime >= cue.startTime && currentTime <= cue.endTime) {
+                    lines.push(cue.getCueAsHTML().textContent);
                 }
-                this.tracks[i].oncuechange = null;
-                this.tracks[i].mode = 'hidden';
             }
         }
+        return lines.join('\n');
     }
     setSubtitleText(text) {
-        this.$string.find('p').html(text);
+        this.$line.find('p').html(text);
     }
     clearSubtitleText() {
         this.setSubtitleText('');
     }
-    updateCurrentLevel(track) {
-        this.currentLevel = track;
-        if (track.language === 'off') {
+    updateSelection() {
+        if (!this.track) {
             this.hide();
         }
         else {
@@ -357,20 +325,21 @@ export class Subtitles extends UICorePlugin {
         this.highlightCurrentSubtitles();
     }
     highlightCurrentSubtitles() {
-        this.levelElement().removeClass('current');
-        this.levelElement().find('a').removeClass('gcore-skin-active');
-        if (this.currentLevel) {
-            const currentLevelElement = this.levelElement(this.currentLevel.language);
-            currentLevelElement.addClass('current');
-            currentLevelElement.find('a').addClass('gcore-skin-active');
-        }
+        this.allItemElements()
+            .removeClass('current')
+            .find('a')
+            .removeClass('gcore-skin-active');
+        trace(`${T} highlightCurrentSubtitles`, {
+            track: this.track?.id,
+        });
+        const currentLevelElement = this.itemElement(this.track ? this.track.id : -1);
+        currentLevelElement
+            .addClass('current')
+            .find('a')
+            .addClass('gcore-skin-active');
     }
     renderIcon() {
         const icon = this.isShowing ? subtitlesOnIcon : subtitlesOffIcon;
-        this.core
-            .getPlugin('media_control')
-            .getElement('subtitlesSelector')
-            ?.find('span.subtitle-text')
-            .html(icon);
+        this.$el.find('span.cc-text').html(icon);
     }
 }

package/lib/testUtils.d.ts

@@ -65,29 +65,31 @@ export declare function createSpinnerPlugin(): Events<string | symbol, any> & {
 export declare function createMockPlayback(name?: string): Events<string | symbol, any> & {
     name: string;
     currentLevel: number;
+    dvrEnabled: boolean;
     levels: never[];
     consent(): void;
     play(): void;
     pause(): void;
     stop(): void;
-    destroy(): void;
-    seek(): void;
-    seekPercentage(): void;
-    getDuration(): 100;
-    enterPiP(): void;
-    exitPiP(): void;
-    getPlaybackType(): "live";
-    getStartTimeOffset(): 0;
-    getCurrentTime(): 0;
-    isHighDefinitionInUse(): false;
-    mute(): void;
-    unmute(): void;
-    volume(): void;
-    configure(): void;
-    attemptAutoPlay(): true;
-    canAutoPlay(): true;
-    onResize(): true;
-    trigger(event: string, ...args: any[]): void;
+    destroy: import("vitest").Mock<(...args: any[]) => any>;
+    seek: import("vitest").Mock<(...args: any[]) => any>;
+    seekPercentage: import("vitest").Mock<(...args: any[]) => any>;
+    getDuration: import("vitest").Mock<(...args: any[]) => any>;
+    enterPiP: import("vitest").Mock<(...args: any[]) => any>;
+    exitPiP: import("vitest").Mock<(...args: any[]) => any>;
+    getPlaybackType: import("vitest").Mock<(...args: any[]) => any>;
+    getStartTimeOffset: import("vitest").Mock<(...args: any[]) => any>;
+    getCurrentTime: import("vitest").Mock<(...args: any[]) => any>;
+    isHighDefinitionInUse: import("vitest").Mock<(...args: any[]) => any>;
+    mute: import("vitest").Mock<(...args: any[]) => any>;
+    unmute: import("vitest").Mock<(...args: any[]) => any>;
+    volume: import("vitest").Mock<(...args: any[]) => any>;
+    configure: import("vitest").Mock<(...args: any[]) => any>;
+    attemptAutoPlay: import("vitest").Mock<(...args: any[]) => any>;
+    canAutoPlay: import("vitest").Mock<(...args: any[]) => any>;
+    onResize: import("vitest").Mock<(...args: any[]) => any>;
+    setPlaybackRate: import("vitest").Mock<(...args: any[]) => any>;
+    trigger: <T extends string | symbol>(event: T, ...args: any[]) => boolean;
 };
 export declare function createMockContainer(playback?: any): Events<string | symbol, any> & {
     el: HTMLDivElement;
@@ -95,6 +97,8 @@ export declare function createMockContainer(playback?: any): Events<string | sym
     $el: any;
     getDuration: import("vitest").Mock<(...args: any[]) => any>;
     getPlugin: import("vitest").Mock<(...args: any[]) => any>;
+    getPlaybackType: import("vitest").Mock<(...args: any[]) => any>;
+    isDvrInUse: import("vitest").Mock<(...args: any[]) => any>;
     isPlaying: import("vitest").Mock<(...args: any[]) => any>;
     play: import("vitest").Mock<(...args: any[]) => any>;
     seek: import("vitest").Mock<(...args: any[]) => any>;

package/lib/testUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../src/testUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,MAAM,MAAM,eAAe,CAAA;AAElC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,MAAM;IAErC,SAAS,CAAC,OAAO,EAAE,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,GAAG;IAClB,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG;gBAFjB,OAAO,EAAE,GAAG,EACb,IAAI,EAAE,GAAG,EACR,WAAW,CAAC,EAAE,GAAG,YAAA;IAK7B,IAAI,IAAI,WAEP;IAED,OAAO;IAEP,IAAI;IAEJ,KAAK;IAEL,IAAI;IAEJ,OAAO;IAEP,IAAI;IAEJ,cAAc;IAEd,WAAW;IAIX,QAAQ;IAER,OAAO;IAEP,eAAe;IAIf,kBAAkB;IAIlB,cAAc;IAId,qBAAqB;IAIrB,IAAI;IAEJ,MAAM;IAEN,MAAM;IAEN,SAAS;IAET,eAAe;IAIf,WAAW;IAIX,QAAQ;IAIR,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;CAGtC;AAED,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,SAAS,GAAE,GAA2B;;;;;;;;;;;;;;;;EAqBvC;AAED,wBAAgB,gBAAgB;;;EAK/B;AAED,wBAAgB,mBAAmB;;;;;;EAKlC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;mBA2C7B,MAAM,WAAW,GAAG,EAAE;EAIxC;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,GAA0B;;;;;;;;;;EAcvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,gBAqB/C"}
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../src/testUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,MAAM,MAAM,eAAe,CAAA;AAElC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,MAAM;IAErC,SAAS,CAAC,OAAO,EAAE,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,GAAG;IAClB,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG;gBAFjB,OAAO,EAAE,GAAG,EACb,IAAI,EAAE,GAAG,EACR,WAAW,CAAC,EAAE,GAAG,YAAA;IAK7B,IAAI,IAAI,WAEP;IAED,OAAO;IAEP,IAAI;IAEJ,KAAK;IAEL,IAAI;IAEJ,OAAO;IAEP,IAAI;IAEJ,cAAc;IAEd,WAAW;IAIX,QAAQ;IAER,OAAO;IAEP,eAAe;IAIf,kBAAkB;IAIlB,cAAc;IAId,qBAAqB;IAIrB,IAAI;IAEJ,MAAM;IAEN,MAAM;IAEN,SAAS;IAET,eAAe;IAIf,WAAW;IAIX,QAAQ;IAIR,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;CAGtC;AAED,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,SAAS,GAAE,GAA2B;;;;;;;;;;;;;;;;EAqBvC;AAED,wBAAgB,gBAAgB;;;EAK/B;AAED,wBAAgB,mBAAmB;;;;;;EAKlC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B/C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,GAA0B;;;;;;;;;;;;EAgBvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,gBAqB/C"}

package/lib/testUtils.js

@@ -98,47 +98,31 @@ export function createMockPlayback(name = 'mock') {
     return Object.assign(emitter, {
         name,
         currentLevel: -1,
+        dvrEnabled: false,
         levels: [],
         consent() { },
         play() { },
         pause() { },
         stop() { },
-        destroy() { },
-        seek() { },
-        seekPercentage() { },
-        getDuration() {
-            return 100;
-        },
-        enterPiP() { },
-        exitPiP() { },
-        getPlaybackType() {
-            return 'live';
-        },
-        getStartTimeOffset() {
-            return 0;
-        },
-        getCurrentTime() {
-            return 0;
-        },
-        isHighDefinitionInUse() {
-            return false;
-        },
-        mute() { },
-        unmute() { },
-        volume() { },
-        configure() { },
-        attemptAutoPlay() {
-            return true;
-        },
-        canAutoPlay() {
-            return true;
-        },
-        onResize() {
-            return true;
-        },
-        trigger(event, ...args) {
-            emitter.emit(event, ...args);
-        },
+        destroy: vi.fn(),
+        seek: vi.fn(),
+        seekPercentage: vi.fn(),
+        getDuration: vi.fn().mockImplementation(() => 100),
+        enterPiP: vi.fn(),
+        exitPiP: vi.fn(),
+        getPlaybackType: vi.fn().mockImplementation(() => 'live'),
+        getStartTimeOffset: vi.fn().mockImplementation(() => 0),
+        getCurrentTime: vi.fn().mockImplementation(() => 0),
+        isHighDefinitionInUse: vi.fn().mockImplementation(() => false),
+        mute: vi.fn(),
+        unmute: vi.fn(),
+        volume: vi.fn(),
+        configure: vi.fn(),
+        attemptAutoPlay: vi.fn().mockImplementation(() => true),
+        canAutoPlay: vi.fn().mockImplementation(() => true),
+        onResize: vi.fn().mockImplementation(() => true),
+        setPlaybackRate: vi.fn(),
+        trigger: emitter.emit,
     });
 }
 export function createMockContainer(playback = createMockPlayback()) {
@@ -150,6 +134,8 @@ export function createMockContainer(playback = createMockPlayback()) {
         $el: $(el),
         getDuration: vi.fn().mockReturnValue(0),
         getPlugin: vi.fn(),
+        getPlaybackType: vi.fn().mockReturnValue('live'),
+        isDvrInUse: vi.fn().mockReturnValue(false),
         isPlaying: vi.fn().mockReturnValue(false),
         play: vi.fn(),
         seek: vi.fn(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gcorevideo/player",
-  "version": "2.21.1",
+  "version": "2.21.4",
   "description": "Gcore JavaScript video player",
   "main": "dist/index.js",
   "type": "module",

package/src/index.plugins.ts

@@ -25,7 +25,8 @@ export * from "./plugins/share/Share.js";
 export * from "./plugins/skip-time/SkipTime.js";
 export * from "./plugins/spinner-three-bounce/SpinnerThreeBounce.js";
 export * from "./plugins/source-controller/SourceController.js";
-export * from "./plugins/subtitles/Subtitles.js";
+export * from "./plugins/subtitles/ClosedCaptions.js";
+export { ClosedCaptions as Subtitles } from "./plugins/subtitles/ClosedCaptions.js"; // TODO remove in future versions
 export * from "./plugins/telemetry/Telemetry.js";
 export * from "./plugins/thumbnails/Thumbnails.js";
 // _ vast-ads

package/src/index.ts

@@ -6,7 +6,7 @@
  * It is built on top of the {@link https://github.com/clappr/clappr | Clappr} library and provides a framework for building custom integrations.
  * Start with {@link Player} for more information.
  *
- * Various plugins (marked with `PLUGIN` keyword) are available to extend the player with additional features.
+ * Various plugins (marked with `PLUGIN` keyword) are available to extend the core functionality with additional features.
  * @example
  * ```ts
  * import { Player, MediaControl, ErrorScreen } from '@gcorevideo/player'

package/src/playback/BasePlayback.ts

@@ -7,6 +7,10 @@ import { PlaybackErrorCode } from '../playback.types.js'
  * @internal
  */
 export class BasePlayback extends HTML5Video {
+  get isHTML5Video() {
+    return true
+  }
+
   createError(errorData: any, options?: ErrorOptions) {
     const i18n =
       this.i18n ||

package/src/playback/dash-playback/DashPlayback.ts

@@ -416,6 +416,7 @@ export default class DashPlayback extends BasePlayback {
     this.trigger(Events.PLAYBACK_STATS_ADD, { dvr: status })
   }
 
+  // TODO move to the base class
   override _updateSettings() {
     if (this._playbackType === Playback.VOD) {
       // @ts-expect-error