@gcorevideo/player 2.12.2 → 2.14.0

package/dist/index.js

@@ -42163,8 +42163,8 @@ function canPlayHls(source, mimeType) {
     return HlsPlayback.canPlay(source, mimeType);
 }
 
-function buildMediaSourcesList(sources, priorityTransport = 'auto') {
-    const [preferred, rest] = sources.reduce(priorityTransport === 'dash' || priorityTransport === 'auto'
+function buildMediaSourcesList(sources, priorityTransport = 'dash') {
+    const [preferred, rest] = sources.reduce(priorityTransport === 'dash'
         ? (acc, item) => {
             if (canPlayDash(item.source, item.mimeType)) {
                 acc[0].push(item);
@@ -42198,7 +42198,6 @@ function guessMimeType(s) {
     if (s.endsWith('.m3u8')) {
         return 'application/vnd.apple.mpegurl';
     }
-    throw new Error('Unrecognized media source type');
 }
 
 const T = 'GPlayer';
@@ -42568,12 +42567,70 @@ class Player {
     }
 }
 
-var version$1 = "2.12.2";
+/**
+ * @internal
+ */
+class _MockPlayback extends EventLite {
+    options;
+    i18n;
+    playerError;
+    constructor(options, i18n, playerError) {
+        super();
+        this.options = options;
+        this.i18n = i18n;
+        this.playerError = playerError;
+    }
+    get name() {
+        return 'mock';
+    }
+    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) {
+        this.emit(event, ...args);
+    }
+}
+
+var version$1 = "2.14.0";
 
 var packages = {
 	"": {
 		name: "@gcorevideo/player",
-		version: "2.12.2",
+		version: "2.14.0",
 		license: "Apache-2.0",
 		dependencies: {
 			"@clappr/core": "^0.11.3",
@@ -46604,4 +46661,4 @@ function version() {
     };
 }
 
-export { PlaybackErrorCode, Player, PlayerEvent, setTracer, version };
+export { PlaybackErrorCode, Player, PlayerEvent, _MockPlayback, setTracer, version };

package/dist/player.d.ts

@@ -8,6 +8,7 @@
  * @packageDocumentation
  */
 
+import EventLite from 'event-lite';
 import { setTracer } from '@gcorevideo/utils';
 
 /**
@@ -16,6 +17,11 @@ import { setTracer } from '@gcorevideo/utils';
  */
 export declare type DashSettings = Record<string, unknown>;
 
+/**
+ * @beta
+ */
+export declare type ErrorLevel = 'FATAL' | 'WARN' | 'INFO';
+
 /**
  * @beta
  */
@@ -24,12 +30,64 @@ export declare type LangTag = string;
 /**
  * @beta
  */
-export declare type MediaTransport = 'dash' | 'hls' | 'mpegts';
+export declare type MediaTransport = 'dash' | 'hls';
+
+/**
+ * @internal
+ */
+export declare class _MockPlayback extends EventLite {
+    protected options: any;
+    readonly i18n: any;
+    protected playerError?: any | undefined;
+    constructor(options: any, i18n: any, playerError?: any | undefined);
+    get name(): string;
+    consent(): void;
+    play(): void;
+    pause(): void;
+    stop(): void;
+    destroy(): void;
+    seek(): void;
+    seekPercentage(): void;
+    getDuration(): number;
+    enterPiP(): void;
+    exitPiP(): void;
+    getPlaybackType(): string;
+    getStartTimeOffset(): number;
+    getCurrentTime(): number;
+    isHighDefinitionInUse(): boolean;
+    mute(): void;
+    unmute(): void;
+    volume(): void;
+    configure(): void;
+    attemptAutoPlay(): boolean;
+    canAutoPlay(): boolean;
+    onResize(): boolean;
+    trigger(event: string, ...args: any[]): void;
+}
 
 /**
  * @beta
  */
-export declare type PlaybackModule = 'dash' | 'hls' | 'native';
+export declare interface PlaybackError {
+    code: PlaybackErrorCode;
+    description: string;
+    level: ErrorLevel;
+    message: string;
+}
+
+/**
+ * @beta
+ */
+export declare enum PlaybackErrorCode {
+    Generic = 0,
+    MediaSourceUnavailable = 1,
+    QualityLevelUnavailable = 2
+}
+
+/**
+ * @beta
+ */
+export declare type PlaybackModule = 'dash' | 'hls' | 'html5_video';
 
 /**
  * Type of a stream playback
@@ -143,7 +201,8 @@ export declare class Player {
     private events;
     private buildCoreOptions;
     private configurePlaybacks;
-    private selectMediaSource;
+    private buildMediaSourcesList;
+    private bindContainerEventListeners;
 }
 
 /**
@@ -228,7 +287,7 @@ export declare interface PlayerConfig extends Record<string, unknown> {
     playbackType?: PlaybackType;
     /**
      * Preferred transport protocol when multiple sources are available.
-     * @defaultValue 'auto'
+     * @defaultValue 'dash'
      */
     priorityTransport?: TransportPreference;
     /**
@@ -238,7 +297,7 @@ export declare interface PlayerConfig extends Record<string, unknown> {
     /**
      * Localization strings for the player UI.
      */
-    strings: TranslationSettings;
+    strings?: TranslationSettings;
 }
 
 /**
@@ -315,7 +374,7 @@ export declare interface PlayerMediaSourceDesc {
  */
 export declare type PlayerPlugin = {
     new (...args: any[]): unknown;
-    type: 'core' | 'container';
+    name: string;
 };
 
 /**
@@ -332,7 +391,7 @@ export { setTracer }
 
 /**
  * For the plugin development
- * @internal
+ * @beta
  */
 export declare type TimePosition = {
     current: TimeValue;
@@ -341,7 +400,7 @@ export declare type TimePosition = {
 
 /**
  * For the plugin development
- * @internal
+ * @beta
  */
 export declare type TimeProgress = TimePosition & {
     start: number;
@@ -349,15 +408,16 @@ export declare type TimeProgress = TimePosition & {
 
 /**
  * For the plugin development
- * @internal
+ * @beta
  */
 export declare type TimeUpdate = TimePosition & {
     firstFragDateTime: number;
 };
 
 /**
+ * Playback time in seconds since the beginning of the stream (or a segment for the live streams)
  * For the plugin development
- * @internal
+ * @beta
  */
 export declare type TimeValue = number;
 
@@ -390,7 +450,7 @@ export declare type TranslationSettings = Partial<Record<LangTag, Record<Transla
 /**
  * @beta
  */
-export declare type TransportPreference = MediaTransport | 'auto';
+export declare type TransportPreference = MediaTransport;
 
 /**
  * Version information about the gplayer and its main dependencies

package/docs/api/player.errorlevel.md

@@ -0,0 +1,15 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [ErrorLevel](./player.errorlevel.md)
+
+## ErrorLevel type
+
+> 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.
+> 
+
+
+**Signature:**
+
+```typescript
+export type ErrorLevel = 'FATAL' | 'WARN' | 'INFO';
+```

package/docs/api/player.md

@@ -51,6 +51,17 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[PlaybackErrorCode](./player.playbackerrorcode.md)
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
 [PlayerEvent](./player.playerevent.md)
 
 
@@ -103,6 +114,17 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[PlaybackError](./player.playbackerror.md)
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
 [PlayerConfig](./player.playerconfig.md)
 
 
@@ -148,6 +170,17 @@ Description
 **_(BETA)_** [DASH.js settings](https://cdn.dashjs.org/latest/jsdoc/module-Settings.html)
 
 
+</td></tr>
+<tr><td>
+
+[ErrorLevel](./player.errorlevel.md)
+
+
+</td><td>
+
+**_(BETA)_**
+
+
 </td></tr>
 <tr><td>
 
@@ -258,6 +291,50 @@ Description
 **_(BETA)_**
 
 
+</td></tr>
+<tr><td>
+
+[TimePosition](./player.timeposition.md)
+
+
+</td><td>
+
+**_(BETA)_** For the plugin development
+
+
+</td></tr>
+<tr><td>
+
+[TimeProgress](./player.timeprogress.md)
+
+
+</td><td>
+
+**_(BETA)_** For the plugin development
+
+
+</td></tr>
+<tr><td>
+
+[TimeUpdate](./player.timeupdate.md)
+
+
+</td><td>
+
+**_(BETA)_** For the plugin development
+
+
+</td></tr>
+<tr><td>
+
+[TimeValue](./player.timevalue.md)
+
+
+</td><td>
+
+**_(BETA)_** Playback time in seconds since the beginning of the stream (or a segment for the live streams) For the plugin development
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/player.mediatransport.md

@@ -11,5 +11,5 @@
 **Signature:**
 
 ```typescript
-export type MediaTransport = 'dash' | 'hls' | 'mpegts';
+export type MediaTransport = 'dash' | 'hls';
 ```

package/docs/api/player.playbackerror.code.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackError](./player.playbackerror.md) &gt; [code](./player.playbackerror.code.md)
+
+## PlaybackError.code 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.
+> 
+
+**Signature:**
+
+```typescript
+code: PlaybackErrorCode;
+```

package/docs/api/player.playbackerror.description.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackError](./player.playbackerror.md) &gt; [description](./player.playbackerror.description.md)
+
+## PlaybackError.description 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.
+> 
+
+**Signature:**
+
+```typescript
+description: string;
+```

package/docs/api/player.playbackerror.level.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackError](./player.playbackerror.md) &gt; [level](./player.playbackerror.level.md)
+
+## PlaybackError.level 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.
+> 
+
+**Signature:**
+
+```typescript
+level: ErrorLevel;
+```

package/docs/api/player.playbackerror.md

@@ -0,0 +1,116 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackError](./player.playbackerror.md)
+
+## PlaybackError 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.
+> 
+
+
+**Signature:**
+
+```typescript
+export interface PlaybackError 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[code](./player.playbackerror.code.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[PlaybackErrorCode](./player.playbackerrorcode.md)
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
+[description](./player.playbackerror.description.md)
+
+
+</td><td>
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
+[level](./player.playbackerror.level.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[ErrorLevel](./player.errorlevel.md)
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
+[message](./player.playbackerror.message.md)
+
+
+</td><td>
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+</tbody></table>

package/docs/api/player.playbackerror.message.md

@@ -0,0 +1,14 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackError](./player.playbackerror.md) &gt; [message](./player.playbackerror.message.md)
+
+## PlaybackError.message 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.
+> 
+
+**Signature:**
+
+```typescript
+message: string;
+```

package/docs/api/player.playbackerrorcode.md

@@ -0,0 +1,83 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackErrorCode](./player.playbackerrorcode.md)
+
+## PlaybackErrorCode enum
+
+> 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.
+> 
+
+
+**Signature:**
+
+```typescript
+export declare enum PlaybackErrorCode 
+```
+
+## Enumeration Members
+
+<table><thead><tr><th>
+
+Member
+
+
+</th><th>
+
+Value
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+Generic
+
+
+</td><td>
+
+`0`
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
+MediaSourceUnavailable
+
+
+</td><td>
+
+`1`
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+<tr><td>
+
+QualityLevelUnavailable
+
+
+</td><td>
+
+`2`
+
+
+</td><td>
+
+**_(BETA)_**
+
+
+</td></tr>
+</tbody></table>

package/docs/api/player.playbackmodule.md

@@ -11,5 +11,5 @@
 **Signature:**
 
 ```typescript
-export type PlaybackModule = 'dash' | 'hls' | 'native';
+export type PlaybackModule = 'dash' | 'hls' | 'html5_video';
 ```

package/docs/api/player.playerconfig.md

@@ -246,7 +246,7 @@ boolean
 </td></tr>
 <tr><td>
 
-[strings](./player.playerconfig.strings.md)
+[strings?](./player.playerconfig.strings.md)
 
 
 </td><td>
@@ -259,7 +259,7 @@ boolean
 
 </td><td>
 
-**_(BETA)_** Localization strings for the player UI.
+**_(BETA)_** _(Optional)_ Localization strings for the player UI.
 
 
 </td></tr>

package/docs/api/player.playerconfig.strings.md

@@ -12,5 +12,5 @@ Localization strings for the player UI.
 **Signature:**
 
 ```typescript
-strings: TranslationSettings;
+strings?: TranslationSettings;
 ```

package/docs/api/player.playerplugin.md

@@ -12,6 +12,6 @@
 ```typescript
 export type PlayerPlugin = {
     new (...args: any[]): unknown;
-    type: 'core' | 'container';
+    name: string;
 };
 ```