rx-player 4.0.0-beta.0 → 4.0.0-beta.2

package/dist/_esm5.processed/core/api/debug/modules/general_info.d.ts

@@ -0,0 +1,3 @@
+import { CancellationSignal } from "../../../../utils/task_canceller";
+import RxPlayer from "../../public_api";
+export default function constructDebugGeneralInfo(instance: RxPlayer, parentElt: HTMLElement, cancelSignal: CancellationSignal): HTMLElement;

package/dist/_esm5.processed/core/api/debug/modules/general_info.js

@@ -0,0 +1,180 @@
+import { DEFAULT_REFRESH_INTERVAL } from "../constants";
+import { createCompositeElement, createElement, createMetricTitle, isExtendedMode, } from "../utils";
+export default function constructDebugGeneralInfo(instance, parentElt, cancelSignal) {
+    var generalInfoElt = createElement("div");
+    var adaptationsElt = createElement("div");
+    var representationsElt = createElement("div");
+    updateGeneralInfo();
+    var generalInfoItv = setInterval(function () {
+        updateGeneralInfo();
+    }, DEFAULT_REFRESH_INTERVAL);
+    cancelSignal.register(function () {
+        clearInterval(generalInfoItv);
+    });
+    return createCompositeElement("div", [
+        generalInfoElt,
+        adaptationsElt,
+        representationsElt,
+    ]);
+    function updateGeneralInfo() {
+        var _a, _b, _c, _d, _e;
+        var videoElement = instance.getVideoElement();
+        if (videoElement === null) {
+            // disposed player. Clean-up everything
+            generalInfoElt.innerHTML = "";
+            adaptationsElt.innerHTML = "";
+            representationsElt.innerHTML = "";
+            clearInterval(generalInfoItv);
+            return;
+        }
+        else {
+            var currentTime = instance.getPosition();
+            var bufferGap = instance.getCurrentBufferGap();
+            var bufferGapStr = bufferGap === Infinity ? "0" : bufferGap.toFixed(2);
+            var valuesLine1 = [
+                ["ct", currentTime.toFixed(2)],
+                ["bg", bufferGapStr],
+                ["rs", String(videoElement.readyState)],
+                ["pr", String(videoElement.playbackRate)],
+                ["sp", String(instance.getPlaybackRate())],
+                ["pa", String(videoElement.paused ? 1 : 0)],
+                ["en", String(videoElement.ended ? 1 : 0)],
+                ["li", String(instance.isLive() ? 1 : 0)],
+                ["wba", String(instance.getWantedBufferAhead())],
+                ["st", "\"".concat(instance.getPlayerState(), "\"")],
+            ];
+            var valuesLine2 = [];
+            var ks = instance.getKeySystemConfiguration();
+            if (ks !== null) {
+                valuesLine2.push(["ks", ks.keySystem]);
+            }
+            var mbb = instance.getMaxBufferBehind();
+            if (mbb !== Infinity) {
+                valuesLine2.push(["mbb", String(mbb)]);
+            }
+            var mba = instance.getMaxBufferAhead();
+            if (mba !== Infinity) {
+                valuesLine2.push(["mba", String(mba)]);
+            }
+            var mbs = instance.getMaxVideoBufferSize();
+            if (mbs !== Infinity) {
+                valuesLine2.push(["mbs", String(mbs)]);
+            }
+            var minPos = instance.getMinimumPosition();
+            if (minPos !== null) {
+                valuesLine1.push(["mip", minPos.toFixed(2)]);
+                valuesLine2.push(["dmi", (currentTime - minPos).toFixed(2)]);
+            }
+            var maxPos = instance.getMaximumPosition();
+            if (maxPos !== null) {
+                valuesLine1.push(["map", maxPos.toFixed(2)]);
+                valuesLine2.push(["dma", (maxPos - currentTime).toFixed(2)]);
+            }
+            var valuesLine3 = [];
+            var error = instance.getError();
+            if (error !== null) {
+                valuesLine3.push(["er", "\"".concat(String(error), "\"")]);
+            }
+            generalInfoElt.innerHTML = "";
+            for (var _i = 0, _f = [valuesLine1, valuesLine2, valuesLine3]; _i < _f.length; _i++) {
+                var valueSet = _f[_i];
+                if (valueSet.length > 0) {
+                    var lineInfoElt = createElement("div");
+                    for (var _g = 0, valueSet_1 = valueSet; _g < valueSet_1.length; _g++) {
+                        var value = valueSet_1[_g];
+                        lineInfoElt.appendChild(createMetricTitle(value[0]));
+                        lineInfoElt.appendChild(createElement("span", {
+                            textContent: value[1] + " ",
+                        }));
+                    }
+                    generalInfoElt.appendChild(lineInfoElt);
+                }
+            }
+            if (isExtendedMode(parentElt)) {
+                var url = (_a = instance.getContentUrls()) === null || _a === void 0 ? void 0 : _a[0];
+                if (url !== undefined) {
+                    var reducedUrl = url.length > 100 ?
+                        url.substring(0, 99) + "…" :
+                        url;
+                    generalInfoElt.appendChild(createCompositeElement("div", [
+                        createMetricTitle("url"),
+                        createElement("span", {
+                            textContent: reducedUrl,
+                        }),
+                    ]));
+                }
+            }
+        }
+        if (isExtendedMode(parentElt)) {
+            var videoId = instance.getAvailableVideoTracks().map(function (_a) {
+                var id = _a.id, active = _a.active;
+                return active ? "*".concat(id) : id;
+            });
+            var audioId = instance.getAvailableAudioTracks().map(function (_a) {
+                var id = _a.id, active = _a.active;
+                return active ? "*".concat(id) : id;
+            });
+            var textId = instance.getAvailableTextTracks().map(function (_a) {
+                var id = _a.id, active = _a.active;
+                return active ? "*".concat(id) : id;
+            });
+            adaptationsElt.innerHTML = "";
+            if (videoId.length > 0) {
+                var textContent = "".concat(videoId.length, ":").concat(videoId.join(" "), " ");
+                if (textContent.length > 100) {
+                    textContent = textContent.substring(0, 98) + "… ";
+                }
+                var videoAdaps = createCompositeElement("div", [
+                    createMetricTitle("vt"),
+                    createElement("span", { textContent: textContent }),
+                ]);
+                adaptationsElt.appendChild(videoAdaps);
+            }
+            if (audioId.length > 0) {
+                var textContent = "".concat(audioId.length, ":").concat(audioId.join(" "), " ");
+                if (textContent.length > 100) {
+                    textContent = textContent.substring(0, 98) + "… ";
+                }
+                var audioAdaps = createCompositeElement("div", [
+                    createMetricTitle("at"),
+                    createElement("span", { textContent: textContent }),
+                ]);
+                adaptationsElt.appendChild(audioAdaps);
+            }
+            if (textId.length > 0) {
+                var textContent = "".concat(textId.length, ":").concat(textId.join(" "), " ");
+                if (textContent.length > 100) {
+                    textContent = textContent.substring(0, 98) + "… ";
+                }
+                var textAdaps = createCompositeElement("div", [
+                    createMetricTitle("tt"),
+                    createElement("span", { textContent: textContent }),
+                ]);
+                adaptationsElt.appendChild(textAdaps);
+            }
+            var videoBitrates = (_c = (_b = instance.getVideoTrack()) === null || _b === void 0 ? void 0 : _b.representations.map(function (r) {
+                return r.bitrate;
+            }).filter(function (bitrate) { return bitrate !== undefined; })) !== null && _c !== void 0 ? _c : [];
+            var audioBitrates = (_e = (_d = instance.getAudioTrack()) === null || _d === void 0 ? void 0 : _d.representations.map(function (r) {
+                return r.bitrate;
+            }).filter(function (bitrate) { return bitrate !== undefined; })) !== null && _e !== void 0 ? _e : [];
+            representationsElt.innerHTML = "";
+            if (videoBitrates.length > 0) {
+                representationsElt.appendChild(createMetricTitle("vb"));
+                representationsElt.appendChild(createElement("span", {
+                    textContent: videoBitrates.join(" ") + " ",
+                }));
+            }
+            if (audioBitrates.length > 0) {
+                representationsElt.appendChild(createMetricTitle("ab"));
+                representationsElt.appendChild(createElement("span", {
+                    textContent: audioBitrates.join(" ") + " ",
+                }));
+            }
+        }
+        else {
+            adaptationsElt.innerHTML = "";
+            representationsElt.innerHTML = "";
+        }
+    }
+}

package/dist/_esm5.processed/core/api/debug/modules/segment_buffer_content.d.ts

@@ -0,0 +1,4 @@
+import { CancellationSignal } from "../../../../utils/task_canceller";
+import { IBufferType } from "../../../segment_buffers";
+import RxPlayer from "../../public_api";
+export default function createSegmentBufferGraph(instance: RxPlayer, bufferType: IBufferType, title: string, parentElt: HTMLElement, cancelSignal: CancellationSignal): HTMLElement;

package/dist/_esm5.processed/core/api/debug/modules/segment_buffer_content.js

@@ -0,0 +1,121 @@
+import isNullOrUndefined from "../../../../utils/is_null_or_undefined";
+import SegmentBufferGraph from "../buffer_graph";
+import { DEFAULT_REFRESH_INTERVAL } from "../constants";
+import { createElement, createGraphCanvas, createMetricTitle, isExtendedMode, } from "../utils";
+export default function createSegmentBufferGraph(instance, bufferType, title, parentElt, cancelSignal) {
+    var bufferGraphWrapper = createElement("div");
+    var bufferTitle = createMetricTitle(title);
+    var canvasElt = createGraphCanvas();
+    var currentRangeRepInfoElt = createElement("div");
+    var loadingRangeRepInfoElt = createElement("div");
+    var bufferGraph = new SegmentBufferGraph(canvasElt);
+    var intervalId = setInterval(update, DEFAULT_REFRESH_INTERVAL);
+    cancelSignal.register(function () {
+        clearInterval(intervalId);
+    });
+    bufferGraphWrapper.appendChild(bufferTitle);
+    bufferGraphWrapper.appendChild(canvasElt);
+    bufferGraphWrapper.appendChild(currentRangeRepInfoElt);
+    bufferGraphWrapper.appendChild(loadingRangeRepInfoElt);
+    bufferGraphWrapper.style.padding = "5px 0px";
+    update();
+    return bufferGraphWrapper;
+    function update() {
+        var _a, _b, _c, _d;
+        if (instance.getVideoElement() === null) {
+            // disposed player. Clean-up everything
+            bufferGraphWrapper.style.display = "none";
+            bufferGraphWrapper.innerHTML = "";
+            clearInterval(intervalId);
+            return;
+        }
+        var showAllInfo = isExtendedMode(parentElt);
+        var inventory = instance.__priv_getSegmentBufferContent(bufferType);
+        if (inventory === null) {
+            bufferGraphWrapper.style.display = "none";
+            currentRangeRepInfoElt.innerHTML = "";
+            loadingRangeRepInfoElt.innerHTML = "";
+        }
+        else {
+            bufferGraphWrapper.style.display = "block";
+            var currentTime = instance.getPosition();
+            var width = Math.min(parentElt.clientWidth - 150, 600);
+            bufferGraph.update({
+                currentTime: currentTime,
+                minimumPosition: (_a = instance.getMinimumPosition()) !== null && _a !== void 0 ? _a : undefined,
+                maximumPosition: (_b = instance.getMaximumPosition()) !== null && _b !== void 0 ? _b : undefined,
+                inventory: inventory,
+                width: width,
+                height: 10,
+            });
+            if (!showAllInfo) {
+                currentRangeRepInfoElt.innerHTML = "";
+                loadingRangeRepInfoElt.innerHTML = "";
+                return;
+            }
+            currentRangeRepInfoElt.innerHTML = "";
+            for (var i = 0; i < inventory.length; i++) {
+                var rangeInfo = inventory[i];
+                var bufferedStart = rangeInfo.bufferedStart, bufferedEnd = rangeInfo.bufferedEnd, infos = rangeInfo.infos;
+                if (bufferedStart !== undefined && bufferedEnd !== undefined &&
+                    currentTime >= bufferedStart && currentTime < bufferedEnd) {
+                    currentRangeRepInfoElt.appendChild(createMetricTitle("play"));
+                    currentRangeRepInfoElt.appendChild(createElement("span", {
+                        textContent: constructRepresentationInfo(infos),
+                    }));
+                    break;
+                }
+            }
+            loadingRangeRepInfoElt.innerHTML = "";
+            var rep = (_c = instance.__priv_getCurrentRepresentations()) === null || _c === void 0 ? void 0 : _c[bufferType];
+            var adap = (_d = instance.__priv_getCurrentAdaptation()) === null || _d === void 0 ? void 0 : _d[bufferType];
+            var manifest = instance.__priv_getManifest();
+            if (manifest !== null && !isNullOrUndefined(rep) && !isNullOrUndefined(adap)) {
+                var period = manifest.getPeriodForTime(currentTime);
+                if (period !== undefined) {
+                    loadingRangeRepInfoElt.appendChild(createMetricTitle("load"));
+                    loadingRangeRepInfoElt.appendChild(createElement("span", {
+                        textContent: constructRepresentationInfo({
+                            period: period,
+                            adaptation: adap,
+                            representation: rep,
+                        }),
+                    }));
+                }
+            }
+        }
+    }
+}
+function constructRepresentationInfo(content) {
+    var _a;
+    var period = content.period;
+    var _b = content.adaptation, language = _b.language, isAudioDescription = _b.isAudioDescription, isClosedCaption = _b.isClosedCaption, isTrickModeTrack = _b.isTrickModeTrack, isSignInterpreted = _b.isSignInterpreted, bufferType = _b.type;
+    var _c = content.representation, id = _c.id, height = _c.height, width = _c.width, bitrate = _c.bitrate, codec = _c.codec;
+    var representationInfo = "\"".concat(id, "\" ");
+    if (height !== undefined && width !== undefined) {
+        representationInfo += "".concat(width, "x").concat(height, " ");
+    }
+    if (bitrate !== undefined) {
+        representationInfo += "(".concat((bitrate / 1000).toFixed(0), "kbps) ");
+    }
+    if (codec !== undefined) {
+        representationInfo += "c:\"".concat(codec, "\" ");
+    }
+    if (language !== undefined) {
+        representationInfo += "l:\"".concat(language, "\" ");
+    }
+    if (bufferType === "video" && typeof isSignInterpreted === "boolean") {
+        representationInfo += "si:".concat(isSignInterpreted ? 1 : 0, " ");
+    }
+    if (bufferType === "video" && typeof isTrickModeTrack === "boolean") {
+        representationInfo += "tm:".concat(isTrickModeTrack ? 1 : 0, " ");
+    }
+    if (bufferType === "audio" && typeof isAudioDescription === "boolean") {
+        representationInfo += "ad:".concat(isAudioDescription ? 1 : 0, " ");
+    }
+    if (bufferType === "text" && typeof isClosedCaption === "boolean") {
+        representationInfo += "cc:".concat(isClosedCaption ? 1 : 0, " ");
+    }
+    representationInfo += "p:".concat(period.start, "-").concat((_a = period.end) !== null && _a !== void 0 ? _a : "?");
+    return representationInfo;
+}

package/dist/_esm5.processed/core/api/debug/modules/segment_buffer_size.d.ts

@@ -0,0 +1,3 @@
+import { CancellationSignal } from "../../../../utils/task_canceller";
+import RxPlayer from "../../public_api";
+export default function createSegmentBufferSizeGraph(instance: RxPlayer, parentElt: HTMLElement, cancelSignal: CancellationSignal): HTMLElement;

package/dist/_esm5.processed/core/api/debug/modules/segment_buffer_size.js

@@ -0,0 +1,35 @@
+import BufferSizeGraph from "../buffer_size_graph";
+import { DEFAULT_REFRESH_INTERVAL } from "../constants";
+import { createElement, createGraphCanvas, createMetricTitle, } from "../utils";
+export default function createSegmentBufferSizeGraph(instance, parentElt, cancelSignal) {
+    var bufferSizeGraphWrapperElt = createElement("div");
+    var bufferSizeTitle = createMetricTitle("bgap");
+    var canvasElt = createGraphCanvas();
+    var bufferSizeGraph = new BufferSizeGraph(canvasElt);
+    var intervalId = setInterval(addBufferSize, DEFAULT_REFRESH_INTERVAL);
+    cancelSignal.register(function () {
+        clearInterval(intervalId);
+    });
+    bufferSizeGraphWrapperElt.appendChild(bufferSizeTitle);
+    bufferSizeGraphWrapperElt.appendChild(canvasElt);
+    bufferSizeGraphWrapperElt.style.padding = "7px 0px";
+    addBufferSize();
+    return bufferSizeGraphWrapperElt;
+    function addBufferSize() {
+        if (instance.getVideoElement() === null) {
+            // disposed player. Clean-up everything
+            bufferSizeGraphWrapperElt.innerHTML = "";
+            clearInterval(intervalId);
+            return;
+        }
+        var bufferGap = instance.getCurrentBufferGap();
+        if (bufferGap === Infinity) {
+            bufferSizeGraph.pushBufferSize(0);
+        }
+        else {
+            bufferSizeGraph.pushBufferSize(bufferGap);
+        }
+        var width = Math.min(parentElt.clientWidth - 150, 600);
+        bufferSizeGraph.reRender(width, 10);
+    }
+}

package/dist/_esm5.processed/core/api/debug/render.d.ts

@@ -0,0 +1,3 @@
+import { CancellationSignal } from "../../../utils/task_canceller";
+import RxPlayer from "../public_api";
+export default function renderDebugElement(parentElt: HTMLElement, instance: RxPlayer, cancelSignal: CancellationSignal): void;

package/dist/_esm5.processed/core/api/debug/render.js

@@ -0,0 +1,32 @@
+import constructDebugGeneralInfo from "./modules/general_info";
+import createSegmentBufferGraph from "./modules/segment_buffer_content";
+import createSegmentBufferSizeGraph from "./modules/segment_buffer_size";
+import { createCompositeElement, createElement } from "./utils";
+export default function renderDebugElement(parentElt, instance, cancelSignal) {
+    var debugElementTitleElt = createElement("div", {
+        textContent: "RxPlayer Debug Information",
+    });
+    debugElementTitleElt.style.fontWeight = "bold";
+    debugElementTitleElt.style.borderBottom = "1px solid white";
+    debugElementTitleElt.style.marginBottom = "5px";
+    debugElementTitleElt.style.fontStyle = "italic";
+    var debugWrapperElt = createCompositeElement("div", [
+        debugElementTitleElt,
+        constructDebugGeneralInfo(instance, parentElt, cancelSignal),
+        createSegmentBufferGraph(instance, "video", "vbuf", parentElt, cancelSignal),
+        createSegmentBufferGraph(instance, "audio", "abuf", parentElt, cancelSignal),
+        createSegmentBufferGraph(instance, "text", "tbuf", parentElt, cancelSignal),
+        createSegmentBufferSizeGraph(instance, parentElt, cancelSignal),
+    ]);
+    debugWrapperElt.style.backgroundColor = "#00000099";
+    debugWrapperElt.style.padding = "7px";
+    debugWrapperElt.style.fontSize = "13px";
+    debugWrapperElt.style.fontFamily = "mono, monospace";
+    debugWrapperElt.style.color = "white";
+    debugWrapperElt.style.display = "inline-block";
+    debugWrapperElt.style.bottom = "0px";
+    parentElt.appendChild(debugWrapperElt);
+    cancelSignal.register(function () {
+        parentElt.removeChild(debugWrapperElt);
+    });
+}

package/dist/_esm5.processed/core/api/debug/utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Create an HTML element.
+ * @param {string} elementName - The element's name, like `"div"` for example.
+ * @param {Object} [options={}] - Optional attributes for the element.
+ * @param {string} [options.textContent] - Inner text for that element.
+ * @param {string} [options.className] - Value for a `class` attribute
+ * associated to this element.
+ * @param {string} [options.href] - Value for a `href` attribute
+ * associated to this element.
+ * @returns {HTMLElement}
+ */
+export declare function createElement(elementName: "input", opts?: CreateElementOptions | undefined): HTMLInputElement;
+export declare function createElement(elementName: "button", opts?: CreateElementOptions | undefined): HTMLButtonElement;
+export declare function createElement(elementName: "a", opts?: CreateElementOptions | undefined): HTMLLinkElement;
+export declare function createElement(elementName: "canvas", opts?: CreateElementOptions | undefined): HTMLCanvasElement;
+export declare function createElement(elementName: string, opts?: CreateElementOptions | undefined): HTMLElement;
+interface CreateElementOptions {
+    textContent?: string | undefined;
+    className?: string | undefined;
+}
+/**
+ * Create an HTML element which may contain mutiple HTML sub-elements.
+ * @param {string} rootElementName - The element's name, like `"div"` for
+ * example.
+ * @param {Array.<string|HTMLElement>} parts - The HTML sub-elements, in order.
+ * Those can also just be strings, in which case only text nodes (and no actual
+ * HTMLElement) will be added at this place.
+ * @param {Object} [options={}] - Optional attributes for the element.
+ * @param {string} [options.className] - Value for a `class` attribute
+ * associated to this element.
+ * @returns {HTMLElement}
+ */
+export declare function createCompositeElement(rootElementName: string, parts: Array<HTMLElement | string>, { className }?: {
+    className?: string;
+} | undefined): HTMLElement;
+export declare function isExtendedMode(parentElt: HTMLElement): boolean;
+export declare function createMetricTitle(title: string): HTMLElement;
+export declare function createGraphCanvas(): HTMLCanvasElement;
+export {};

package/dist/_esm5.processed/core/api/debug/utils.js

@@ -0,0 +1,57 @@
+export function createElement(elementName, _a) {
+    var _b = _a === void 0 ? {} : _a, textContent = _b.textContent, className = _b.className;
+    var elt = document.createElement(elementName);
+    if (className !== undefined) {
+        elt.className = className;
+    }
+    if (textContent !== undefined) {
+        elt.textContent = textContent;
+    }
+    return elt;
+}
+/**
+ * Create an HTML element which may contain mutiple HTML sub-elements.
+ * @param {string} rootElementName - The element's name, like `"div"` for
+ * example.
+ * @param {Array.<string|HTMLElement>} parts - The HTML sub-elements, in order.
+ * Those can also just be strings, in which case only text nodes (and no actual
+ * HTMLElement) will be added at this place.
+ * @param {Object} [options={}] - Optional attributes for the element.
+ * @param {string} [options.className] - Value for a `class` attribute
+ * associated to this element.
+ * @returns {HTMLElement}
+ */
+export function createCompositeElement(rootElementName, parts, _a) {
+    var _b = _a === void 0 ? {} : _a, className = _b.className;
+    var elt = document.createElement(rootElementName);
+    if (className !== undefined) {
+        elt.className = className;
+    }
+    for (var _i = 0, parts_1 = parts; _i < parts_1.length; _i++) {
+        var subElt = parts_1[_i];
+        if (typeof subElt === "string") {
+            elt.appendChild(document.createTextNode(subElt));
+        }
+        else {
+            elt.appendChild(subElt);
+        }
+    }
+    return elt;
+}
+export function isExtendedMode(parentElt) {
+    return parentElt.clientHeight > 400;
+}
+export function createMetricTitle(title) {
+    var elt = createElement("span", {
+        textContent: title + "/",
+    });
+    elt.style.fontWeight = "bold";
+    return elt;
+}
+export function createGraphCanvas() {
+    var canvasElt = createElement("canvas");
+    canvasElt.style.border = "1px solid white";
+    canvasElt.style.height = "15px";
+    canvasElt.style.marginLeft = "2px";
+    return canvasElt;
+}

package/dist/_esm5.processed/core/api/playback_observer.js

@@ -114,6 +114,7 @@ var PlaybackObserver = /** @class */ (function () {
      */
     PlaybackObserver.prototype.setCurrentTime = function (time) {
         this._internalSeeksIncoming.push(time);
+        log.info("API: Seeking internally", time);
         this._mediaElement.currentTime = time;
     };
     /**
@@ -154,7 +155,7 @@ var PlaybackObserver = /** @class */ (function () {
      */
     PlaybackObserver.prototype.listen = function (cb, options) {
         var _a;
-        if (this._canceller.isUsed || ((_a = options === null || options === void 0 ? void 0 : options.clearSignal) === null || _a === void 0 ? void 0 : _a.isCancelled) === true) {
+        if (this._canceller.isUsed() || ((_a = options === null || options === void 0 ? void 0 : options.clearSignal) === null || _a === void 0 ? void 0 : _a.isCancelled()) === true) {
             return noop;
         }
         this._observationRef.onUpdate(cb, {
@@ -565,7 +566,8 @@ function generateReadOnlyObserver(src, transform, cancellationSignal) {
         },
         listen: function (cb, options) {
             var _a;
-            if (cancellationSignal.isCancelled || ((_a = options === null || options === void 0 ? void 0 : options.clearSignal) === null || _a === void 0 ? void 0 : _a.isCancelled) === true) {
+            if (cancellationSignal.isCancelled() ||
+                ((_a = options === null || options === void 0 ? void 0 : options.clearSignal) === null || _a === void 0 ? void 0 : _a.isCancelled()) === true) {
                 return;
             }
             mappedRef.onUpdate(cb, {

package/dist/_esm5.processed/core/api/public_api.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 import { IErrorCode, IErrorType } from "../../errors";
-import Manifest from "../../manifest";
-import { IAudioRepresentation, IAudioTrack, IAudioTrackSetting, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBrokenRepresentationsLockContext, IConstructorOptions, IKeySystemConfigurationOutput, ILoadVideoOptions, ILockedAudioRepresentationsSettings, ILockedVideoRepresentationsSettings, ITrackUpdateEventPayload, IPeriod, IPeriodChangeEvent, IPlayerError, IPlayerState, IPositionUpdate, IStreamEvent, ITextTrack, IVideoRepresentation, ITextTrackSetting, IVideoTrack, IVideoTrackSetting } from "../../public_types";
+import Manifest, { Adaptation, Representation } from "../../manifest";
+import { IAudioRepresentation, IAudioTrack, IAudioTrackSetting, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBrokenRepresentationsLockContext, IConstructorOptions, IKeySystemConfigurationOutput, ILoadVideoOptions, ILockedAudioRepresentationsSettings, ILockedVideoRepresentationsSettings, ITrackUpdateEventPayload, IRepresentationListUpdateContext, IPeriod, IPeriodChangeEvent, IPlayerError, IPlayerState, IPositionUpdate, IStreamEvent, ITextTrack, IVideoRepresentation, ITextTrackSetting, IVideoTrack, IVideoTrackSetting } from "../../public_types";
 import EventEmitter, { IListener } from "../../utils/event_emitter";
 import Logger from "../../utils/logger";
 import { IBufferedChunk, IBufferType } from "../segment_buffers";
@@ -95,6 +95,10 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * It should refer to the last content being played.
      */
     private _priv_reloadingMetadata;
+    /**
+     * Store last value of autoPlay, from the last load or reload.
+     */
+    private _priv_lastAutoPlay;
     /** All possible Error types emitted by the RxPlayer. */
     static get ErrorTypes(): Record<IErrorType, IErrorType>;
     /** All possible Error codes emitted by the RxPlayer. */
@@ -151,6 +155,9 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
         };
         autoPlay?: boolean;
     }): void;
+    createDebugElement(element: HTMLElement): {
+        dispose(): void;
+    };
     /**
      * From given options, initialize content playback.
      * @param {Object} options
@@ -175,6 +182,26 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * @returns {string} - The current Player's state
      */
     getPlayerState(): string;
+    /**
+     * Returns true if a content is loaded.
+     * @returns {Boolean} - `true` if a content is loaded, `false` otherwise.
+     */
+    isContentLoaded(): boolean;
+    /**
+     * Returns true if the player is buffering.
+     * @returns {Boolean} - `true` if the player is buffering, `false` otherwise.
+     */
+    isBuffering(): boolean;
+    /**
+     * Returns the play/pause status of the player :
+     *   - when `LOADING` or `RELOADING`, returns the scheduled play/pause condition
+     *     for when loading is over,
+     *   - in other states, returns the `<video>` element .paused value,
+     *   - if the player is disposed, returns `true`.
+     * @returns {Boolean} - `true` if the player is paused or will be after loading,
+     * `false` otherwise.
+     */
+    isPaused(): boolean;
     /**
      * Returns true if both:
      *   - a content is loaded
@@ -247,6 +274,12 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * @returns {Number}
      */
     getPosition(): number;
+    /**
+     * Returns the last stored content position, in seconds.
+     *
+     * @returns {number|undefined}
+     */
+    getLastStoredContentPosition(): number | undefined;
     /**
      * Returns the current playback rate at which the video plays.
      * @returns {Number}
@@ -539,6 +572,8 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * @returns {Manifest|null} - The current Manifest (`null` when not known).
      */
     __priv_getManifest(): Manifest | null;
+    __priv_getCurrentAdaptation(): Partial<Record<IBufferType, Adaptation | null>> | null;
+    __priv_getCurrentRepresentations(): Partial<Record<IBufferType, Representation | null>> | null;
     /**
      * Reset all state properties relative to a playing content.
      */
@@ -613,7 +648,6 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * @param {Object} observation
      */
     private _priv_triggerPositionUpdate;
-    private _priv_getCurrentRepresentations;
     /**
      * @param {string} evt
      * @param {*} arg
@@ -626,6 +660,26 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      */
     private _priv_initializeMediaElementTracksStore;
     private _priv_callTracksStoreGetterSetter;
+    /**
+     * Method to call when some event lead to a high for possibility that the
+     * available tracks for the given type have changed.
+     * Send the corresponding `available*Tracks` change event with the last
+     * available tracks.
+     *
+     * @param {string} trackType
+     * @param {Object|undefined} [oPeriodRef] - optional period object used by the
+     * `tracksStore` API, allows to optimize the method by bypassing this step.
+     */
+    private _priv_onAvailableTracksMayHaveChanged;
+    /**
+     * Method to call when a fatal error lead to the stopping of the current
+     * content.
+     *
+     * @param {*} err - The error encountered.
+     * @param {Object} contentInfos - The `IPublicApiContentInfos` object linked
+     * to the content for which the error was received.
+     */
+    private _priv_onFatalError;
 }
 /** Every events sent by the RxPlayer's public API. */
 interface IPublicAPIEvent {
@@ -643,9 +697,12 @@ interface IPublicAPIEvent {
     availableAudioTracksChange: IAvailableAudioTrack[];
     availableTextTracksChange: IAvailableTextTrack[];
     availableVideoTracksChange: IAvailableVideoTrack[];
+    play: null;
+    pause: null;
     newAvailablePeriods: IPeriod[];
     brokenRepresentationsLock: IBrokenRepresentationsLockContext;
     trackUpdate: ITrackUpdateEventPayload;
+    representationListUpdate: IRepresentationListUpdateContext;
     seeking: null;
     seeked: null;
     streamEvent: IStreamEvent;