@gcorevideo/player 2.26.9 → 2.28.0

package/dist/index.embed.js

@@ -42579,6 +42579,7 @@ class HTML5Video extends BasePlayback {
         super._onEnded();
     }
     _handleBufferingEvents() {
+        // TODO use the logic from the base class to detect if it's stalled or resumed, because in the latter case the current behavior is not correct
         if (!this.stallTimerId) {
             this.stallTimerId = setTimeout(() => {
                 this.stallTimerId = null;
@@ -42830,6 +42831,29 @@ class Player {
     isPlaying() {
         return this.player?.isPlaying() ?? false;
     }
+    /**
+     * Loads new media source
+     * @param mediaSources - list of media sources to use
+     * @beta
+     */
+    load(mediaSources) {
+        if (mediaSources.length === 0) {
+            throw new Error('No media sources provided');
+        }
+        const ms = mediaSources.map((s) => wrapSource(s));
+        const sourceController = this.player?.core.activePlayback.getPlugin('source_controller');
+        if (sourceController) {
+            sourceController.setMediaSource(ms);
+            return;
+        }
+        if (this.player) {
+            this.player.load(ms, ms[0].mimeType ?? '');
+            return;
+        }
+        this.configure({
+            sources: mediaSources,
+        });
+    }
     /**
      * Mutes the sound of the video.
      */
@@ -45407,13 +45431,16 @@ class CmcdConfig extends CorePlugin {
     constructor(core) {
         super(core);
         this.sid = this.options.cmcd?.sessionId ?? generateSessionId();
-        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+        this.setContentId();
     }
     /**
      * @internal
      */
     bindEvents() {
-        this.listenTo(this.core, Events$1.CORE_CONTAINERS_CREATED, () => this.updateSettings(this.core.containers[0]));
+        this.listenTo(this.core, Events$1.CORE_CONTAINERS_CREATED, () => {
+            this.setContentId();
+            this.updateSettings(this.core.containers[0]);
+        });
     }
     /**
      * Returns the current `sid` and `cid` values.
@@ -45438,7 +45465,7 @@ class CmcdConfig extends CorePlugin {
                                 sid: this.sid,
                                 cid: this.cid,
                             },
-                        }
+                        },
                     },
                 });
                 break;
@@ -45460,6 +45487,9 @@ class CmcdConfig extends CorePlugin {
     generateContentId() {
         return new URL(this.core.options.source ?? this.core.options.sources[0].source).pathname.slice(0, 64);
     }
+    setContentId() {
+        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+    }
 }
 
 var mousetrap = {exports: {}};
@@ -49934,9 +49964,6 @@ function noSync(cb) {
  *
  * ```
  *
- * This plugin does not expose any public methods apart from required by the Clappr plugin interface.
- * It is supposed to work autonomously.
- *
  * @example
  * ```ts
  * import { SourceController } from '@gcorevideo/player'
@@ -50012,11 +50039,24 @@ class SourceController extends CorePlugin {
         if (this.core.options.source !== undefined) {
             // prevent Clappr from loading all sources simultaneously
             this.core.options.sources = [this.core.options.source];
+            this.core.options.source = undefined; // TODO test
         }
         else {
             this.core.options.sources = this.core.options.sources.slice(0, 1);
         }
     }
+    /**
+     * Set new media source.
+     *
+     * @param sourcesList - The list of new media source URLs
+     * @beta
+     * @remarks
+     * Triggers a reload of the playback module, container and all container plugins.
+     */
+    setMediaSource(sourcesList) {
+        this.sourcesList = sourcesList;
+        this.core.load(sourcesList, this.core.options.mimeType);
+    }
     /**
      * @internal
      */

package/dist/index.js

@@ -42740,6 +42740,7 @@ class HTML5Video extends BasePlayback {
         super._onEnded();
     }
     _handleBufferingEvents() {
+        // TODO use the logic from the base class to detect if it's stalled or resumed, because in the latter case the current behavior is not correct
         if (!this.stallTimerId) {
             this.stallTimerId = setTimeout(() => {
                 this.stallTimerId = null;
@@ -42994,6 +42995,29 @@ class Player {
     isPlaying() {
         return this.player?.isPlaying() ?? false;
     }
+    /**
+     * Loads new media source
+     * @param mediaSources - list of media sources to use
+     * @beta
+     */
+    load(mediaSources) {
+        if (mediaSources.length === 0) {
+            throw new Error('No media sources provided');
+        }
+        const ms = mediaSources.map((s) => wrapSource(s));
+        const sourceController = this.player?.core.activePlayback.getPlugin('source_controller');
+        if (sourceController) {
+            sourceController.setMediaSource(ms);
+            return;
+        }
+        if (this.player) {
+            this.player.load(ms, ms[0].mimeType ?? '');
+            return;
+        }
+        this.configure({
+            sources: mediaSources,
+        });
+    }
     /**
      * Mutes the sound of the video.
      */
@@ -43265,7 +43289,7 @@ class Player {
     }
 }
 
-var version$1 = "2.26.9";
+var version$1 = "2.28.0";
 
 var packages = {
 	"node_modules/@clappr/core": {
@@ -45843,13 +45867,16 @@ class CmcdConfig extends CorePlugin {
     constructor(core) {
         super(core);
         this.sid = this.options.cmcd?.sessionId ?? generateSessionId();
-        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+        this.setContentId();
     }
     /**
      * @internal
      */
     bindEvents() {
-        this.listenTo(this.core, Events$1.CORE_CONTAINERS_CREATED, () => this.updateSettings(this.core.containers[0]));
+        this.listenTo(this.core, Events$1.CORE_CONTAINERS_CREATED, () => {
+            this.setContentId();
+            this.updateSettings(this.core.containers[0]);
+        });
     }
     /**
      * Returns the current `sid` and `cid` values.
@@ -45874,7 +45901,7 @@ class CmcdConfig extends CorePlugin {
                                 sid: this.sid,
                                 cid: this.cid,
                             },
-                        }
+                        },
                     },
                 });
                 break;
@@ -45896,6 +45923,9 @@ class CmcdConfig extends CorePlugin {
     generateContentId() {
         return new URL(this.core.options.source ?? this.core.options.sources[0].source).pathname.slice(0, 64);
     }
+    setContentId() {
+        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+    }
 }
 
 var mousetrap = {exports: {}};
@@ -51283,9 +51313,6 @@ function noSync(cb) {
  *
  * ```
  *
- * This plugin does not expose any public methods apart from required by the Clappr plugin interface.
- * It is supposed to work autonomously.
- *
  * @example
  * ```ts
  * import { SourceController } from '@gcorevideo/player'
@@ -51361,11 +51388,24 @@ class SourceController extends CorePlugin {
         if (this.core.options.source !== undefined) {
             // prevent Clappr from loading all sources simultaneously
             this.core.options.sources = [this.core.options.source];
+            this.core.options.source = undefined; // TODO test
         }
         else {
             this.core.options.sources = this.core.options.sources.slice(0, 1);
         }
     }
+    /**
+     * Set new media source.
+     *
+     * @param sourcesList - The list of new media source URLs
+     * @beta
+     * @remarks
+     * Triggers a reload of the playback module, container and all container plugins.
+     */
+    setMediaSource(sourcesList) {
+        this.sourcesList = sourcesList;
+        this.core.load(sourcesList, this.core.options.mimeType);
+    }
     /**
      * @internal
      */

package/dist/player.d.ts

@@ -777,6 +777,7 @@ export declare class ClapprStats extends ContainerPlugin {
         };
         private updateSettings;
         private generateContentId;
+        private setContentId;
     }
 
     /**
@@ -2059,6 +2060,12 @@ export declare class ClapprStats extends ContainerPlugin {
          * Indicates the playing state.
          */
         isPlaying(): boolean;
+        /**
+         * Loads new media source
+         * @param mediaSources - list of media sources to use
+         * @beta
+         */
+        load(mediaSources: PlayerMediaSource[]): void;
         /**
          * Mutes the sound of the video.
          */
@@ -2808,9 +2815,6 @@ export declare class ClapprStats extends ContainerPlugin {
      *
      * ```
      *
-     * This plugin does not expose any public methods apart from required by the Clappr plugin interface.
-     * It is supposed to work autonomously.
-     *
      * @example
      * ```ts
      * import { SourceController } from '@gcorevideo/player'
@@ -2840,6 +2844,15 @@ export declare class ClapprStats extends ContainerPlugin {
          * @param core - The Clappr core instance.
          */
         constructor(core: Core);
+        /**
+         * Set new media source.
+         *
+         * @param sourcesList - The list of new media source URLs
+         * @beta
+         * @remarks
+         * Triggers a reload of the playback module, container and all container plugins.
+         */
+        setMediaSource(sourcesList: PlayerMediaSourceDesc[]): void;
         /**
          * @internal
          */

package/docs/api/player.player.load.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [load](./player.player.load.md)
+
+## Player.load() method
+
+> 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.
+> 
+
+Loads new media source
+
+**Signature:**
+
+```typescript
+load(mediaSources: PlayerMediaSource[]): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+mediaSources
+
+
+</td><td>
+
+[PlayerMediaSource](./player.playermediasource.md)<!-- -->\[\]
+
+
+</td><td>
+
+list of media sources to use
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/api/player.player.md

@@ -207,6 +207,20 @@ Indicates muted state of the video.
 Indicates the playing state.
 
 
+</td></tr>
+<tr><td>
+
+[load(mediaSources)](./player.player.load.md)
+
+
+</td><td>
+
+
+</td><td>
+
+**_(BETA)_** Loads new media source
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/player.sourcecontroller.md

@@ -52,7 +52,6 @@ sources_list:
                  +-------------------+
 
 ```
-This plugin does not expose any public methods apart from required by the Clappr plugin interface. It is supposed to work autonomously.
 
 ## Example
 
@@ -94,5 +93,39 @@ Description
 Constructs a new instance of the `SourceController` class
 
 
+</td></tr>
+</tbody></table>
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[setMediaSource(sourcesList)](./player.sourcecontroller.setmediasource.md)
+
+
+</td><td>
+
+
+</td><td>
+
+**_(BETA)_** Set new media source.
+
+
 </td></tr>
 </tbody></table>

package/docs/api/player.sourcecontroller.setmediasource.md

@@ -0,0 +1,60 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [SourceController](./player.sourcecontroller.md) &gt; [setMediaSource](./player.sourcecontroller.setmediasource.md)
+
+## SourceController.setMediaSource() method
+
+> 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.
+> 
+
+Set new media source.
+
+**Signature:**
+
+```typescript
+setMediaSource(sourcesList: PlayerMediaSourceDesc[]): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+sourcesList
+
+
+</td><td>
+
+[PlayerMediaSourceDesc](./player.playermediasourcedesc.md)<!-- -->\[\]
+
+
+</td><td>
+
+The list of new media source URLs
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+
+## Remarks
+
+Triggers a reload of the playback module, container and all container plugins.
+

package/lib/Player.d.ts

@@ -1,4 +1,4 @@
-import type { ContainerSize, PlayerPluginConstructor } from './types.js';
+import type { ContainerSize, PlayerMediaSource, PlayerPluginConstructor } from './types.js';
 import { PlayerConfig, PlayerEvent } from './types.js';
 import { PlaybackError, TimePosition } from './playback.types.js';
 /**
@@ -126,6 +126,12 @@ export declare class Player {
      * Indicates the playing state.
      */
     isPlaying(): boolean;
+    /**
+     * Loads new media source
+     * @param mediaSources - list of media sources to use
+     * @beta
+     */
+    load(mediaSources: PlayerMediaSource[]): void;
     /**
      * Mutes the sound of the video.
      */

package/lib/Player.d.ts.map

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

package/lib/Player.js

@@ -172,6 +172,29 @@ export class Player {
     isPlaying() {
         return this.player?.isPlaying() ?? false;
     }
+    /**
+     * Loads new media source
+     * @param mediaSources - list of media sources to use
+     * @beta
+     */
+    load(mediaSources) {
+        if (mediaSources.length === 0) {
+            throw new Error('No media sources provided');
+        }
+        const ms = mediaSources.map((s) => wrapSource(s));
+        const sourceController = this.player?.core.activePlayback.getPlugin('source_controller');
+        if (sourceController) {
+            sourceController.setMediaSource(ms);
+            return;
+        }
+        if (this.player) {
+            this.player.load(ms, ms[0].mimeType ?? '');
+            return;
+        }
+        this.configure({
+            sources: mediaSources,
+        });
+    }
     /**
      * Mutes the sound of the video.
      */

package/lib/playback/HTML5Video.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HTML5Video.d.ts","sourceRoot":"","sources":["../../src/playback/HTML5Video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAA;AAMzE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,YAAY;IAClD,OAAO,CAAC,YAAY,CAAuB;IAE3C;;OAEG;IACM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,YAAY;IAkBlD,UAAU;IAIV,QAAQ;IAQR,sBAAsB;IAiBtB,UAAU;IAQV,QAAQ;IAQjB,IAAI,WAAW,IAAI,UAAU,EAAE,CAgB9B;IAGD,IAAI,iBAAiB,sBAiBpB;IAED,gBAAgB,CAAC,EAAE,EAAE,MAAM;CAa5B"}
+{"version":3,"file":"HTML5Video.d.ts","sourceRoot":"","sources":["../../src/playback/HTML5Video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAA;AAMzE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,YAAY;IAClD,OAAO,CAAC,YAAY,CAAuB;IAE3C;;OAEG;IACM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,YAAY;IAkBlD,UAAU;IAIV,QAAQ;IAQR,sBAAsB;IAkBtB,UAAU;IAQV,QAAQ;IAQjB,IAAI,WAAW,IAAI,UAAU,EAAE,CAgB9B;IAGD,IAAI,iBAAiB,sBAiBpB;IAED,gBAAgB,CAAC,EAAE,EAAE,MAAM;CAa5B"}

package/lib/playback/HTML5Video.js

@@ -33,6 +33,7 @@ export default class HTML5Video extends BasePlayback {
         super._onEnded();
     }
     _handleBufferingEvents() {
+        // TODO use the logic from the base class to detect if it's stalled or resumed, because in the latter case the current behavior is not correct
         if (!this.stallTimerId) {
             this.stallTimerId = setTimeout(() => {
                 this.stallTimerId = null;

package/lib/plugins/cmcd-config/CmcdConfig.d.ts

@@ -64,5 +64,6 @@ export declare class CmcdConfig extends CorePlugin {
     };
     private updateSettings;
     private generateContentId;
+    private setContentId;
 }
 //# sourceMappingURL=CmcdConfig.d.ts.map

package/lib/plugins/cmcd-config/CmcdConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmcdConfig.d.ts","sourceRoot":"","sources":["../../../src/plugins/cmcd-config/CmcdConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,IAAI,EAAE,UAAU,EAAU,MAAM,cAAc,CAAA;AA4BrE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,GAAG,CAAQ;IAEnB,OAAO,CAAC,GAAG,CAAK;IAEhB;;OAEG;IACH,IAAI,IAAI,WAEP;IAED;;OAEG;IACH,IAAI,OAAO,WAEV;IAED;;OAEG;IACH,IAAI,gBAAgB,WAEnB;gBAEW,IAAI,EAAE,IAAI;IAMtB;;OAEG;IACM,UAAU;IAMnB;;;;OAIG;IACH,SAAS,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;YAO3B,cAAc;IAgC5B,OAAO,CAAC,iBAAiB;CAK1B"}
+{"version":3,"file":"CmcdConfig.d.ts","sourceRoot":"","sources":["../../../src/plugins/cmcd-config/CmcdConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,IAAI,EAAE,UAAU,EAAU,MAAM,cAAc,CAAA;AA4BrE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,GAAG,CAAQ;IAEnB,OAAO,CAAC,GAAG,CAAK;IAEhB;;OAEG;IACH,IAAI,IAAI,WAEP;IAED;;OAEG;IACH,IAAI,OAAO,WAEV;IAED;;OAEG;IACH,IAAI,gBAAgB,WAEnB;gBAEW,IAAI,EAAE,IAAI;IAMtB;;OAEG;IACM,UAAU;IAOnB;;;;OAIG;IACH,SAAS,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;YAO3B,cAAc;IAgC5B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY;CAGrB"}

package/lib/plugins/cmcd-config/CmcdConfig.js

@@ -66,13 +66,16 @@ export class CmcdConfig extends CorePlugin {
     constructor(core) {
         super(core);
         this.sid = this.options.cmcd?.sessionId ?? generateSessionId();
-        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+        this.setContentId();
     }
     /**
      * @internal
      */
     bindEvents() {
-        this.listenTo(this.core, Events.CORE_CONTAINERS_CREATED, () => this.updateSettings(this.core.containers[0]));
+        this.listenTo(this.core, Events.CORE_CONTAINERS_CREATED, () => {
+            this.setContentId();
+            this.updateSettings(this.core.containers[0]);
+        });
     }
     /**
      * Returns the current `sid` and `cid` values.
@@ -97,7 +100,7 @@ export class CmcdConfig extends CorePlugin {
                                 sid: this.sid,
                                 cid: this.cid,
                             },
-                        }
+                        },
                     },
                 });
                 break;
@@ -119,4 +122,7 @@ export class CmcdConfig extends CorePlugin {
     generateContentId() {
         return new URL(this.core.options.source ?? this.core.options.sources[0].source).pathname.slice(0, 64);
     }
+    setContentId() {
+        this.cid = this.options.cmcd?.contentId ?? this.generateContentId();
+    }
 }

package/lib/plugins/source-controller/SourceController.d.ts

@@ -1,4 +1,5 @@
 import { CorePlugin, type Core as ClapprCore } from '@clappr/core';
+import { type PlayerMediaSourceDesc } from '../../types.js';
 /**
  * `PLUGIN` that is managing the automatic failover between media sources.
  * @public
@@ -42,9 +43,6 @@ import { CorePlugin, type Core as ClapprCore } from '@clappr/core';
  *
  * ```
  *
- * This plugin does not expose any public methods apart from required by the Clappr plugin interface.
- * It is supposed to work autonomously.
- *
  * @example
  * ```ts
  * import { SourceController } from '@gcorevideo/player'
@@ -74,6 +72,15 @@ export declare class SourceController extends CorePlugin {
      * @param core - The Clappr core instance.
      */
     constructor(core: ClapprCore);
+    /**
+     * Set new media source.
+     *
+     * @param sourcesList - The list of new media source URLs
+     * @beta
+     * @remarks
+     * Triggers a reload of the playback module, container and all container plugins.
+     */
+    setMediaSource(sourcesList: PlayerMediaSourceDesc[]): void;
     /**
      * @internal
      */

package/lib/plugins/source-controller/SourceController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceController.d.ts","sourceRoot":"","sources":["../../../src/plugins/source-controller/SourceController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,KAAK,IAAI,IAAI,UAAU,EACxB,MAAM,cAAc,CAAA;AAwBrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAwC9C,OAAO,CAAC,WAAW,CAA8B;IAEjD,OAAO,CAAC,kBAAkB,CAAI;IAE9B,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,MAAM,CAAQ;IAEtB,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,IAAI,CAAiB;IAE7B;;OAEG;IACH,IAAI,IAAI,WAEP;IAED;;OAEG;IACH,IAAI,gBAAgB;;MAEnB;IAED;;OAEG;gBACS,IAAI,EAAE,UAAU;IAW5B;;OAEG;IACM,UAAU;IAWnB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,2BAA2B;IAiDnC,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,MAAM,KAAK,OAAO,WAEjB;CACF"}
+{"version":3,"file":"SourceController.d.ts","sourceRoot":"","sources":["../../../src/plugins/source-controller/SourceController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,KAAK,IAAI,IAAI,UAAU,EACxB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAsB3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAwC9C,OAAO,CAAC,WAAW,CAA8B;IAEjD,OAAO,CAAC,kBAAkB,CAAI;IAE9B,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,MAAM,CAAQ;IAEtB,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,IAAI,CAAiB;IAE7B;;OAEG;IACH,IAAI,IAAI,WAEP;IAED;;OAEG;IACH,IAAI,gBAAgB;;MAEnB;IAED;;OAEG;gBACS,IAAI,EAAE,UAAU;IAY5B;;;;;;;OAOG;IACH,cAAc,CAAC,WAAW,EAAE,qBAAqB,EAAE;IAKnD;;OAEG;IACM,UAAU;IAWnB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,2BAA2B;IAiDnC,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,MAAM,KAAK,OAAO,WAEjB;CACF"}

package/lib/plugins/source-controller/SourceController.js

@@ -54,9 +54,6 @@ function noSync(cb) {
  *
  * ```
  *
- * This plugin does not expose any public methods apart from required by the Clappr plugin interface.
- * It is supposed to work autonomously.
- *
  * @example
  * ```ts
  * import { SourceController } from '@gcorevideo/player'
@@ -132,11 +129,24 @@ export class SourceController extends CorePlugin {
         if (this.core.options.source !== undefined) {
             // prevent Clappr from loading all sources simultaneously
             this.core.options.sources = [this.core.options.source];
+            this.core.options.source = undefined; // TODO test
         }
         else {
             this.core.options.sources = this.core.options.sources.slice(0, 1);
         }
     }
+    /**
+     * Set new media source.
+     *
+     * @param sourcesList - The list of new media source URLs
+     * @beta
+     * @remarks
+     * Triggers a reload of the playback module, container and all container plugins.
+     */
+    setMediaSource(sourcesList) {
+        this.sourcesList = sourcesList;
+        this.core.load(sourcesList, this.core.options.mimeType);
+    }
     /**
      * @internal
      */

package/package.json

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