@gcorevideo/player 2.17.0 → 2.18.0

package/docs/api/player.qualitylevel.md

@@ -2,19 +2,116 @@
 
 [Home](./index.md) > [@gcorevideo/player](./player.md) > [QualityLevel](./player.qualitylevel.md)
 
-## QualityLevel type
+## QualityLevel interface
 
 > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
+A level of quality within a media source.
 
 **Signature:**
 
 ```typescript
-export type QualityLevel = {
-    level: number;
-    width: number;
-    height: number;
-    bitrate: number;
-};
+export interface QualityLevel 
 ```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[bitrate](./player.qualitylevel.bitrate.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+**_(BETA)_** Bitrate of the video, bps.
+
+
+</td></tr>
+<tr><td>
+
+[height](./player.qualitylevel.height.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+**_(BETA)_** Height of the video, pixels.
+
+
+</td></tr>
+<tr><td>
+
+[level](./player.qualitylevel.level.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+**_(BETA)_** Zero-based index of the quality level.
+
+
+</td></tr>
+<tr><td>
+
+[width](./player.qualitylevel.width.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+**_(BETA)_** Width of the video, pixels.
+
+
+</td></tr>
+</tbody></table>

package/docs/api/player.qualitylevel.width.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [QualityLevel](./player.qualitylevel.md) &gt; [width](./player.qualitylevel.width.md)
+
+## QualityLevel.width property
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+> 
+
+Width of the video, pixels.
+
+**Signature:**
+
+```typescript
+width: number;
+```

package/docs/api/player.timeposition.current.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TimePosition](./player.timeposition.md) &gt; [current](./player.timeposition.current.md)
+
+## TimePosition.current property
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+> 
+
+Current playback time, 0..duration, seconds.
+
+**Signature:**
+
+```typescript
+current: TimeValue;
+```

package/docs/api/player.timeposition.md

@@ -2,20 +2,78 @@
 
 [Home](./index.md) > [@gcorevideo/player](./player.md) > [TimePosition](./player.timeposition.md)
 
-## TimePosition type
+## TimePosition interface
 
 > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
-For the plugin development
+Current playback time and total duration of the media.
 
 **Signature:**
 
 ```typescript
-export type TimePosition = {
-    current: TimeValue;
-    total: TimeValue;
-};
+export interface TimePosition 
 ```
-**References:** [TimeValue](./player.timevalue.md)
 
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[current](./player.timeposition.current.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[TimeValue](./player.timevalue.md)
+
+
+</td><td>
+
+**_(BETA)_** Current playback time, 0..duration, seconds.
+
+
+</td></tr>
+<tr><td>
+
+[total](./player.timeposition.total.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[TimeValue](./player.timevalue.md)
+
+
+</td><td>
+
+**_(BETA)_** Total duration of the media, seconds.
+
+
+</td></tr>
+</tbody></table>

package/docs/api/player.timeposition.total.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [TimePosition](./player.timeposition.md) &gt; [total](./player.timeposition.total.md)
+
+## TimePosition.total property
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+> 
+
+Total duration of the media, seconds.
+
+**Signature:**
+
+```typescript
+total: TimeValue;
+```

package/docs/api/player.timevalue.md

@@ -7,7 +7,7 @@
 > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
-Playback time in seconds since the beginning of the stream (or a segment for the live streams) For the plugin development
+Playback time in seconds since the beginning of the stream (or a segment for the live streams)
 
 **Signature:**
 

package/docs/api/player.translationsettings.md

@@ -7,7 +7,7 @@
 > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
-\[language\]\[key\] =<!-- -->&gt; string
+Localization strings for the player UI.
 
 **Signature:**
 
@@ -16,6 +16,12 @@ export type TranslationSettings = Partial<Record<LangTag, Record<TranslationKey,
 ```
 **References:** [LangTag](./player.langtag.md)<!-- -->, [TranslationKey](./player.translationkey.md)
 
+## Remarks
+
+The keys are language codes, and the values are objects with keys being the translation keys and values being the translations.
+
+This dictionary is used to localize the player UI, including the error messages and is shared across all the player components (including the plugins).
+
 ## Example
 
 

package/docs/api/player.transportpreference.md

@@ -7,6 +7,7 @@
 > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
+Preferred media delivery protocol
 
 **Signature:**
 

package/lib/Player.d.ts

@@ -1,20 +1,31 @@
-import type { PlayerPlugin } from './types.js';
+import type { ContainerSize, PlayerPlugin } from './types.js';
 import { PlayerConfig, PlayerEvent } from './types.js';
+import { PlaybackError, TimePosition } from './playback.types.js';
 /**
  * @beta
  */
-export type PlayerEventHandler<T extends PlayerEvent> = () => void;
+export type PlayerEventParams<E extends PlayerEvent> = E extends PlayerEvent.Seek ? [number] : E extends PlayerEvent.VolumeUpdate ? [number] : E extends PlayerEvent.TimeUpdate ? [TimePosition] : E extends PlayerEvent.Resize ? [{
+    width: number;
+    height: number;
+}] : E extends PlayerEvent.Fullscreen ? [boolean] : E extends PlayerEvent.Error ? [PlaybackError] : [];
 /**
+ * Type of a listener callback function for a player event.
+ * See the description of the event parameters in {@link PlayerEvent}.
+ * @beta
+ */
+export type PlayerEventHandler<E extends PlayerEvent> = (...args: PlayerEventParams<E>) => void;
+/**
+ * Module to perform the playback.
  * @beta
  */
 export type PlaybackModule = 'dash' | 'hls' | 'html5_video';
 /**
  * The main component to use in the application code.
+ * @beta
  * @remarks
  * The Player object provides very basic API to control playback.
  * To build a sophisticated UI, use the plugins framework to tap into the Clappr core.
  * {@link https://github.com/clappr/clappr/wiki/Architecture}
- * @beta
  */
 export declare class Player {
     private config;
@@ -27,16 +38,16 @@ export declare class Player {
     constructor(config: PlayerConfig);
     /**
      * Adds a listener to a player event
-     * @param event - See {@link PlayerEvent}
-     * @param handler - See {@link PlayerEventHandler}
+     * @param event - event type, see {@link PlayerEvent}
+     * @param handler - a callback function to handle the event
      */
-    on<T extends PlayerEvent>(event: T, handler: PlayerEventHandler<T>): void;
+    on<E extends PlayerEvent>(event: E, handler: PlayerEventHandler<E>): void;
     /**
      * Removes a previously added event listener
      * @param event - See {@link PlayerEvent}
-     * @param handler - See {@link PlayerEventHandler}
+     * @param handler - a callback attached earlier to that event type
      */
-    off<T extends PlayerEvent>(event: T, handler: PlayerEventHandler<T>): void;
+    off<E extends PlayerEvent>(event: E, handler: PlayerEventHandler<E>): void;
     /**
      * Configures the player.
      *
@@ -101,7 +112,13 @@ export declare class Player {
      */
     isDvrEnabled(): boolean;
     /**
-     * Indicates the playing state of the player.
+     * Indicates whether DVR is in use.
+     * @remarks
+     * DVR mode, if it is enabled, is triggered we a user seeks behind the live edge.
+     */
+    isDvrInUse(): boolean;
+    /**
+     * Indicates the playing state.
      */
     isPlaying(): boolean;
     /**
@@ -124,13 +141,10 @@ export declare class Player {
      * Resizes the player container element and everything within it.
      * @param newSize - new size of the player
      * @remarks
-     * Use this method when the player itself does not detect the change in size of its container element.
+     * Use this method when the player itself does not detect properly the change in size of its container element.
      * It can be a case for orientation change on some mobile devices.
      */
-    resize(newSize: {
-        width: number;
-        height: number;
-    }): void;
+    resize(newSize: ContainerSize): void;
     /**
      * Seeks to the given time.
      * @param time - time to seek to in seconds (since the beginning of the stream)
@@ -176,10 +190,12 @@ export declare class Player {
     private setConfig;
     private initPlayer;
     private tuneIn;
+    private safeTriggerEvent;
     private events;
     private buildCoreOptions;
     private configurePlaybacks;
     private buildMediaSourcesList;
     private bindContainerEventListeners;
+    private bindSizeManagementListeners;
 }
 //# sourceMappingURL=Player.d.ts.map

package/lib/Player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../src/Player.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAOtD;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,MAAM,IAAI,CAAA;AAelE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,CAAA;AAI3D;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAgC;IAE9C,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,MAAM,CAA4B;IAE1C,OAAO,CAAC,KAAK,CAAQ;IAErB,OAAO,CAAC,QAAQ,CAA2B;IAE3C,OAAO,CAAC,aAAa,CAA6C;IAElE,OAAO,CAAC,OAAO,CAAQ;gBAEX,MAAM,EAAE,YAAY;IAOhC;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAIlE;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAInE;;;;;;;;;OASG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,IAAI;IAoB1C;;OAEG;IACH,OAAO;IAgBP;;;;;;OAMG;IACH,cAAc,IAAI,MAAM;IAOxB;;;;;;OAMG;IACH,WAAW,IAAI,MAAM;IAOrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,IAAI;IAIJ;;OAEG;IACH,MAAM;IAIN;;OAEG;IACH,KAAK;IAIL;;OAEG;IACH,IAAI;IAIJ;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIjD;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM;IAIjB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAMnB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;IAMxB;;OAEG;IACH,IAAI;IAIJ;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY;IAI1C;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,YAAY;IAI5C,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;YAqBJ,MAAM;IAwEpB,OAAO,CAAC,MAAM,CAiDb;IAED,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,2BAA2B;CAcpC"}
+{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../src/Player.ts"],"names":[],"mappings":"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"}

package/lib/Player.js

@@ -18,11 +18,11 @@ const DEFAULT_OPTIONS = {
 };
 /**
  * The main component to use in the application code.
+ * @beta
  * @remarks
  * The Player object provides very basic API to control playback.
  * To build a sophisticated UI, use the plugins framework to tap into the Clappr core.
  * {@link https://github.com/clappr/clappr/wiki/Architecture}
- * @beta
  */
 export class Player {
     config = DEFAULT_OPTIONS;
@@ -40,8 +40,8 @@ export class Player {
     }
     /**
      * Adds a listener to a player event
-     * @param event - See {@link PlayerEvent}
-     * @param handler - See {@link PlayerEventHandler}
+     * @param event - event type, see {@link PlayerEvent}
+     * @param handler - a callback function to handle the event
      */
     on(event, handler) {
         this.emitter.on(event, handler);
@@ -49,7 +49,7 @@ export class Player {
     /**
      * Removes a previously added event listener
      * @param event - See {@link PlayerEvent}
-     * @param handler - See {@link PlayerEventHandler}
+     * @param handler - a callback attached earlier to that event type
      */
     off(event, handler) {
         this.emitter.off(event, handler);
@@ -163,7 +163,15 @@ export class Player {
         return this.player?.isDvrEnabled() ?? false;
     }
     /**
-     * Indicates the playing state of the player.
+     * Indicates whether DVR is in use.
+     * @remarks
+     * DVR mode, if it is enabled, is triggered we a user seeks behind the live edge.
+     */
+    isDvrInUse() {
+        return this.player?.isDvrInUse() ?? false;
+    }
+    /**
+     * Indicates the playing state.
      */
     isPlaying() {
         return this.player?.isPlaying() ?? false;
@@ -196,7 +204,7 @@ export class Player {
      * Resizes the player container element and everything within it.
      * @param newSize - new size of the player
      * @remarks
-     * Use this method when the player itself does not detect the change in size of its container element.
+     * Use this method when the player itself does not detect properly the change in size of its container element.
      * It can be a case for orientation change on some mobile devices.
      */
     resize(newSize) {
@@ -293,32 +301,7 @@ export class Player {
         const player = this.player;
         this.bindContainerEventListeners(player);
         player.core.on(ClapprEvents.CORE_ACTIVE_CONTAINER_CHANGED, () => this.bindContainerEventListeners(player), null);
-        player.core.on(ClapprEvents.CORE_SCREEN_ORIENTATION_CHANGED, ({ orientation }) => {
-            trace(`${T} CORE_SCREEN_ORIENTATION_CHANGED`, {
-                orientation,
-                rootNode: {
-                    width: this.rootNode?.clientWidth,
-                    height: this.rootNode?.clientHeight,
-                },
-            });
-            if (Browser.isiOS && this.rootNode) {
-                player.core.resize({
-                    width: this.rootNode.clientWidth,
-                    height: this.rootNode.clientHeight,
-                });
-            }
-        }, null);
-        player.core.on(ClapprEvents.CORE_RESIZE, ({ width, height }) => {
-            trace(`${T} CORE_RESIZE`, {
-                width,
-                height,
-            });
-        }, null);
-        player.core.on(ClapprEvents.CORE_FULLSCREEN, (isFullscreen) => {
-            trace(`${T} CORE_FULLSCREEN`, {
-                isFullscreen,
-            });
-        }, null);
+        this.bindSizeManagementListeners(player);
         if (this.config.autoPlay) {
             setTimeout(() => {
                 trace(`${T} autoPlay`, {
@@ -336,6 +319,15 @@ export class Player {
             reportError(e);
         }
     }
+    safeTriggerEvent(event, ...args) {
+        try {
+            this.emitter.emit(event, ...args);
+        }
+        catch (e) {
+            reportError(e);
+        }
+    }
+    // TODO test
     events = {
         onReady: () => {
             trace(`${T} onReady`, {
@@ -352,42 +344,29 @@ export class Player {
             // TODO ensure that CORE_ACTIVE_CONTAINER_CHANGED does not get caught before onReady
             setTimeout(() => this.tuneIn(), 0);
         },
-        onResize: (newSize) => {
-            trace(`${T} onResize`, {
-                newSize,
-            });
-        },
         onPlay: () => {
-            try {
-                this.emitter.emit(PlayerEvent.Play);
-            }
-            catch (e) {
-                reportError(e);
-            }
+            this.safeTriggerEvent(PlayerEvent.Play);
         },
         onPause: () => {
-            try {
-                this.emitter.emit(PlayerEvent.Pause);
-            }
-            catch (e) {
-                reportError(e);
-            }
+            this.safeTriggerEvent(PlayerEvent.Pause);
         },
         onEnded: () => {
-            try {
-                this.emitter.emit(PlayerEvent.Ended);
-            }
-            catch (e) {
-                reportError(e);
-            }
+            this.safeTriggerEvent(PlayerEvent.Ended);
+        },
+        onSeek: (time) => {
+            this.safeTriggerEvent(PlayerEvent.Seek, time);
         },
         onStop: () => {
-            try {
-                this.emitter.emit(PlayerEvent.Stop);
-            }
-            catch (e) {
-                reportError(e);
-            }
+            this.safeTriggerEvent(PlayerEvent.Stop);
+        },
+        onVolumeUpdate: (volume) => {
+            this.safeTriggerEvent(PlayerEvent.VolumeUpdate, volume);
+        },
+        onTimeUpdate: (time) => {
+            this.safeTriggerEvent(PlayerEvent.TimeUpdate, time);
+        },
+        onError: (error) => {
+            this.safeTriggerEvent(PlayerEvent.Error, error);
         },
     };
     buildCoreOptions(rootNode) {
@@ -415,6 +394,7 @@ export class Player {
                 mute: this.config.mute,
                 crossOrigin: 'anonymous', // TODO
                 hlsjsConfig: {
+                    // TODO
                     debug: this.config.debug === 'all' || this.config.debug === 'hls',
                 },
             },
@@ -423,7 +403,7 @@ export class Player {
             width: rootNode.clientWidth,
             source: source ? source.source : undefined,
             mimeType: source ? source.mimeType : undefined,
-            sources, // prevent Clappr from loading all sources simultaneously
+            sources,
             strings: this.config.strings,
         };
         return coreOptions;
@@ -437,9 +417,6 @@ export class Player {
         this.config.sources.map((s) => wrapSource(s)), this.config.priorityTransport);
     }
     bindContainerEventListeners(player) {
-        trace(`${T} bindContainerEventListeners`, {
-            activePlayback: player.core.activePlayback?.name,
-        });
         if (Browser.isiOS && player.core.activePlayback) {
             player.core.activePlayback.$el.on('webkitendfullscreen', () => {
                 try {
@@ -451,4 +428,34 @@ export class Player {
             });
         }
     }
+    bindSizeManagementListeners(player) {
+        player.core.on(ClapprEvents.CORE_SCREEN_ORIENTATION_CHANGED, ({ orientation }) => {
+            trace(`${T} on CORE_SCREEN_ORIENTATION_CHANGED`, {
+                orientation,
+                rootNode: {
+                    width: this.rootNode?.clientWidth,
+                    height: this.rootNode?.clientHeight,
+                },
+            });
+            if (Browser.isiOS && this.rootNode) {
+                player.core.resize({
+                    width: this.rootNode.clientWidth,
+                    height: this.rootNode.clientHeight,
+                });
+            }
+        }, null);
+        player.core.on(ClapprEvents.CORE_RESIZE, ({ width, height }) => {
+            trace(`${T} on CORE_RESIZE`, {
+                width,
+                height,
+            });
+            this.safeTriggerEvent(PlayerEvent.Resize, { width, height });
+        }, null);
+        player.core.on(ClapprEvents.CORE_FULLSCREEN, (isFullscreen) => {
+            trace(`${T} CORE_FULLSCREEN`, {
+                isFullscreen,
+            });
+            this.safeTriggerEvent(PlayerEvent.Fullscreen, isFullscreen);
+        }, null);
+    }
 }

package/lib/internal.types.d.ts

@@ -1,5 +1,5 @@
 import type { CorePlugin, ContainerPlugin, Playback as ClapprPlayback } from "@clappr/core";
-import { PlaybackType, PlayerDebugTag, PlayerMediaSource } from "./types";
+import { ContainerSize, PlaybackType, PlayerDebugTag, PlayerMediaSource } from "./types";
 import { PlaybackError } from "./playback.types";
 type ExternalTrack = {
     kind?: "subtitles" | "captions";
@@ -34,6 +34,7 @@ export interface CorePlaybackConfig {
     mute?: boolean;
     playInline: boolean;
     preload?: 'metadata' | 'auto' | 'none';
+    recycleVideo?: boolean;
     shakaConfiguration?: ShakaConfig;
 }
 /**
@@ -41,10 +42,7 @@ export interface CorePlaybackConfig {
  */
 export type CorePlayerEvents = {
     onReady?: () => void;
-    onResize?: (data: {
-        width: number;
-        height: number;
-    }) => void;
+    onResize?: (data: ContainerSize) => void;
     onPlay?: (metadata: unknown) => void;
     onPause?: (metadata: unknown) => void;
     onStop?: (metadata: unknown) => void;

package/lib/internal.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.types.d.ts","sourceRoot":"","sources":["../src/internal.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal.types.d.ts","sourceRoot":"","sources":["../src/internal.types.ts"],"names":[],"mappings":"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"}