rx-player 4.0.0-dev.2023120600 → 4.0.0-dev.2023121900

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

@@ -43,32 +43,32 @@ var __assign = (this && this.__assign) || function () {
  * This file defines the public API for the RxPlayer.
  * It also starts the different sub-parts of the player on various API calls.
  */
-import { events, getStartDate, } from "../../compat";
+import { events, exitFullscreen, getStartDate, isFullscreen, requestFullscreen, } from "../../compat";
 /* eslint-disable-next-line max-len */
 import canRelyOnVideoVisibilityAndSize from "../../compat/can_rely_on_video_visibility_and_size";
 import config from "../../config";
 import { ErrorCodes, ErrorTypes, formatError, MediaError, } from "../../errors";
 import features, { addFeatures, } from "../../features";
 import log from "../../log";
+import areArraysOfNumbersEqual from "../../utils/are_arrays_of_numbers_equal";
 import arrayIncludes from "../../utils/array_includes";
 import assert from "../../utils/assert";
-import assertUnreachable from "../../utils/assert_unreachable";
 import EventEmitter from "../../utils/event_emitter";
 import idGenerator from "../../utils/id_generator";
 import isNullOrUndefined from "../../utils/is_null_or_undefined";
 import objectAssign from "../../utils/object_assign";
-import { getLeftSizeOfRange } from "../../utils/ranges";
+import { getLeftSizeOfRange, getPlayedSizeOfRange, getSizeOfRange, } from "../../utils/ranges";
 import SharedReference, { createMappedReference, } from "../../utils/reference";
 import TaskCanceller from "../../utils/task_canceller";
 import warnOnce from "../../utils/warn_once";
 import { clearOnStop, disposeDecryptionResources, getKeySystemConfiguration, getCurrentKeySystem, } from "../decrypt";
 import { checkReloadOptions, parseConstructorOptions, parseLoadVideoOptions, } from "./option_utils";
 import PlaybackObserver from "./playback_observer";
-import TracksStore from "./track_management/tracks_store";
+import TrackChoiceManager from "./tracks_management/track_choice_manager";
 import { constructPlayerStateReference, emitPlayPauseEvents, emitSeekEvents, isLoadedState, } from "./utils";
 /* eslint-disable @typescript-eslint/naming-convention */
 var generateContentId = idGenerator();
-var getPictureOnPictureStateRef = events.getPictureOnPictureStateRef, getVideoVisibilityRef = events.getVideoVisibilityRef, getVideoWidthRef = events.getVideoWidthRef;
+var getPageActivityRef = events.getPageActivityRef, getPictureOnPictureStateRef = events.getPictureOnPictureStateRef, getVideoVisibilityRef = events.getVideoVisibilityRef, getVideoWidthRef = events.getVideoWidthRef, onFullscreenChange = events.onFullscreenChange, onTextTrackAdded = events.onTextTrackAdded, onTextTrackRemoved = events.onTextTrackRemoved;
 /**
  * @class Player
  * @extends EventEmitter
@@ -81,8 +81,9 @@ var Player = /** @class */ (function (_super) {
      */
     function Player(options) {
         if (options === void 0) { options = {}; }
+        var _a, _b;
         var _this = _super.call(this) || this;
-        var _a = parseConstructorOptions(options), baseBandwidth = _a.baseBandwidth, limitVideoWidth = _a.limitVideoWidth, maxBufferAhead = _a.maxBufferAhead, maxBufferBehind = _a.maxBufferBehind, throttleVideoBitrateWhenHidden = _a.throttleVideoBitrateWhenHidden, videoElement = _a.videoElement, wantedBufferAhead = _a.wantedBufferAhead, maxVideoBufferSize = _a.maxVideoBufferSize;
+        var _c = parseConstructorOptions(options), initialAudioBitrate = _c.initialAudioBitrate, initialVideoBitrate = _c.initialVideoBitrate, limitVideoWidth = _c.limitVideoWidth, minAudioBitrate = _c.minAudioBitrate, minVideoBitrate = _c.minVideoBitrate, maxAudioBitrate = _c.maxAudioBitrate, maxBufferAhead = _c.maxBufferAhead, maxBufferBehind = _c.maxBufferBehind, maxVideoBitrate = _c.maxVideoBitrate, preferredAudioTracks = _c.preferredAudioTracks, preferredTextTracks = _c.preferredTextTracks, preferredVideoTracks = _c.preferredVideoTracks, throttleWhenHidden = _c.throttleWhenHidden, throttleVideoBitrateWhenHidden = _c.throttleVideoBitrateWhenHidden, videoElement = _c.videoElement, wantedBufferAhead = _c.wantedBufferAhead, maxVideoBufferSize = _c.maxVideoBufferSize, stopAtEnd = _c.stopAtEnd;
         var DEFAULT_UNMUTED_VOLUME = config.getCurrent().DEFAULT_UNMUTED_VOLUME;
         // Workaround to support Firefox autoplay on FF 42.
         // See: https://bugzilla.mozilla.org/show_bug.cgi?id=1194624
@@ -94,6 +95,50 @@ var Player = /** @class */ (function (_super) {
         var destroyCanceller = new TaskCanceller();
         _this._destroyCanceller = destroyCanceller;
         _this._priv_pictureInPictureRef = getPictureOnPictureStateRef(videoElement, destroyCanceller.signal);
+        /** @deprecated */
+        onFullscreenChange(videoElement, function () {
+            /* eslint-disable import/no-deprecated */
+            _this.trigger("fullscreenChange", _this.isFullscreen());
+            /* eslint-enable import/no-deprecated */
+        }, destroyCanceller.signal);
+        /** Store last known TextTrack array linked to the media element. */
+        var prevTextTracks = [];
+        for (var i = 0; i < ((_a = videoElement.textTracks) === null || _a === void 0 ? void 0 : _a.length); i++) {
+            var textTrack = (_b = videoElement.textTracks) === null || _b === void 0 ? void 0 : _b[i];
+            if (!isNullOrUndefined(textTrack)) {
+                prevTextTracks.push(textTrack);
+            }
+        }
+        /** Callback called when a TextTrack element is added or removed. */
+        var onTextTrackChanges = function (_evt) {
+            var evt = _evt;
+            var target = evt.target;
+            var textTrackArr = [];
+            for (var i = 0; i < target.length; i++) {
+                var textTrack = target[i];
+                textTrackArr.push(textTrack);
+            }
+            var oldTextTracks = prevTextTracks;
+            prevTextTracks = textTrackArr;
+            // We can have two consecutive textTrackChanges with the exact same
+            // payload when we perform multiple texttrack operations before the event
+            // loop is freed.
+            if (oldTextTracks.length !== textTrackArr.length) {
+                _this._priv_onNativeTextTracksNext(textTrackArr);
+                return;
+            }
+            for (var i = 0; i < oldTextTracks.length; i++) {
+                if (oldTextTracks[i] !== textTrackArr[i]) {
+                    _this._priv_onNativeTextTracksNext(textTrackArr);
+                    return;
+                }
+            }
+            return;
+        };
+        if (!isNullOrUndefined(videoElement.textTracks)) {
+            onTextTrackAdded(videoElement.textTracks, onTextTrackChanges, destroyCanceller.signal);
+            onTextTrackRemoved(videoElement.textTracks, onTextTrackChanges, destroyCanceller.signal);
+        }
         _this._priv_speed = new SharedReference(videoElement.playbackRate, _this._destroyCanceller.signal);
         _this._priv_preferTrickModeTracks = false;
         _this._priv_contentLock = new SharedReference(false, _this._destroyCanceller.signal);
@@ -104,16 +149,27 @@ var Player = /** @class */ (function (_super) {
             maxVideoBufferSize: new SharedReference(maxVideoBufferSize, _this._destroyCanceller.signal),
         };
         _this._priv_bitrateInfos = {
-            lastBitrates: { audio: baseBandwidth,
-                video: baseBandwidth },
+            lastBitrates: { audio: initialAudioBitrate,
+                video: initialVideoBitrate },
+            minAutoBitrates: { audio: new SharedReference(minAudioBitrate, _this._destroyCanceller.signal),
+                video: new SharedReference(minVideoBitrate, _this._destroyCanceller.signal) },
+            maxAutoBitrates: { audio: new SharedReference(maxAudioBitrate, _this._destroyCanceller.signal),
+                video: new SharedReference(maxVideoBitrate, _this._destroyCanceller.signal) },
+            manualBitrates: { audio: new SharedReference(-1, _this._destroyCanceller.signal),
+                video: new SharedReference(-1, _this._destroyCanceller.signal) },
         };
+        _this._priv_throttleWhenHidden = throttleWhenHidden;
         _this._priv_throttleVideoBitrateWhenHidden = throttleVideoBitrateWhenHidden;
         _this._priv_limitVideoWidth = limitVideoWidth;
         _this._priv_mutedMemory = DEFAULT_UNMUTED_VOLUME;
         _this._priv_currentError = null;
         _this._priv_contentInfos = null;
         _this._priv_contentEventsMemory = {};
+        _this._priv_stopAtEnd = stopAtEnd;
         _this._priv_setPlayerState("STOPPED" /* PLAYER_STATES.STOPPED */);
+        _this._priv_preferredAudioTracks = preferredAudioTracks;
+        _this._priv_preferredTextTracks = preferredTextTracks;
+        _this._priv_preferredVideoTracks = preferredVideoTracks;
         _this._priv_reloadingMetadata = {};
         _this._priv_lastAutoPlay = false;
         return _this;
@@ -227,8 +283,8 @@ var Player = /** @class */ (function (_super) {
      * @param {Object} reloadOpts
      */
     Player.prototype.reload = function (reloadOpts) {
-        var _a, _b, _c;
-        var _d = this._priv_reloadingMetadata, options = _d.options, manifest = _d.manifest, reloadPosition = _d.reloadPosition, reloadInPause = _d.reloadInPause;
+        var _a, _b;
+        var _c = this._priv_reloadingMetadata, options = _c.options, manifest = _c.manifest, reloadPosition = _c.reloadPosition, reloadInPause = _c.reloadInPause;
         if (options === undefined) {
             throw new Error("API: Can't reload without having previously loaded a content.");
         }
@@ -255,13 +311,6 @@ var Player = /** @class */ (function (_super) {
         else if (reloadInPause !== undefined) {
             autoPlay = !reloadInPause;
         }
-        var keySystems;
-        if ((reloadOpts === null || reloadOpts === void 0 ? void 0 : reloadOpts.keySystems) !== undefined) {
-            keySystems = reloadOpts.keySystems;
-        }
-        else if (((_c = this._priv_reloadingMetadata.options) === null || _c === void 0 ? void 0 : _c.keySystems) !== undefined) {
-            keySystems = this._priv_reloadingMetadata.options.keySystems;
-        }
         var newOptions = __assign(__assign({}, options), { initialManifest: manifest });
         if (startAt !== undefined) {
             newOptions.startAt = startAt;
@@ -269,9 +318,6 @@ var Player = /** @class */ (function (_super) {
         if (autoPlay !== undefined) {
             newOptions.autoPlay = autoPlay;
         }
-        if (keySystems !== undefined) {
-            newOptions.keySystems = keySystems;
-        }
         this._priv_initializeContentPlayback(newOptions);
     };
     Player.prototype.createDebugElement = function (element) {
@@ -292,8 +338,7 @@ var Player = /** @class */ (function (_super) {
      */
     Player.prototype._priv_initializeContentPlayback = function (options) {
         var _this = this;
-        var _a, _b, _c, _d;
-        var autoPlay = options.autoPlay, defaultAudioTrackSwitchingMode = options.defaultAudioTrackSwitchingMode, enableFastSwitching = options.enableFastSwitching, initialManifest = options.initialManifest, keySystems = options.keySystems, lowLatencyMode = options.lowLatencyMode, minimumManifestUpdateInterval = options.minimumManifestUpdateInterval, requestConfig = options.requestConfig, onCodecSwitch = options.onCodecSwitch, startAt = options.startAt, transport = options.transport, checkMediaSegmentIntegrity = options.checkMediaSegmentIntegrity, manifestLoader = options.manifestLoader, manifestUpdateUrl = options.manifestUpdateUrl, referenceDateTime = options.referenceDateTime, representationFilter = options.representationFilter, segmentLoader = options.segmentLoader, serverSyncInfos = options.serverSyncInfos, __priv_patchLastSegmentInSidx = options.__priv_patchLastSegmentInSidx, url = options.url;
+        var autoPlay = options.autoPlay, audioTrackSwitchingMode = options.audioTrackSwitchingMode, defaultAudioTrack = options.defaultAudioTrack, defaultTextTrack = options.defaultTextTrack, enableFastSwitching = options.enableFastSwitching, initialManifest = options.initialManifest, keySystems = options.keySystems, lowLatencyMode = options.lowLatencyMode, manualBitrateSwitchingMode = options.manualBitrateSwitchingMode, minimumManifestUpdateInterval = options.minimumManifestUpdateInterval, networkConfig = options.networkConfig, onCodecSwitch = options.onCodecSwitch, startAt = options.startAt, transport = options.transport, transportOptions = options.transportOptions, url = options.url;
         // Perform multiple checks on the given options
         if (this.videoElement === null) {
             throw new Error("the attached video element is disposed");
@@ -303,7 +348,7 @@ var Player = /** @class */ (function (_super) {
         var currentContentCanceller = new TaskCanceller();
         var videoElement = this.videoElement;
         var initializer;
-        var mediaElementTracksStore = null;
+        var mediaElementTrackChoiceManager = null;
         if (!isDirectFile) {
             var transportFn = features.transports[transport];
             if (typeof transportFn !== "function") {
@@ -315,13 +360,27 @@ var Player = /** @class */ (function (_super) {
             if (features.mediaSourceInit === null) {
                 throw new Error("MediaSource streaming not supported");
             }
-            var transportPipelines = transportFn({ lowLatencyMode: lowLatencyMode, checkMediaSegmentIntegrity: checkMediaSegmentIntegrity, manifestLoader: manifestLoader, manifestUpdateUrl: manifestUpdateUrl, referenceDateTime: referenceDateTime, representationFilter: representationFilter, segmentLoader: segmentLoader, serverSyncInfos: serverSyncInfos, __priv_patchLastSegmentInSidx: __priv_patchLastSegmentInSidx });
+            var transportPipelines = transportFn(transportOptions);
+            var offlineRetry = networkConfig.offlineRetry, segmentRetry = networkConfig.segmentRetry, manifestRetry = networkConfig.manifestRetry, manifestRequestTimeout = networkConfig.manifestRequestTimeout, segmentRequestTimeout = networkConfig.segmentRequestTimeout;
             /** Interface used to load and refresh the Manifest. */
-            var manifestRequestSettings = { lowLatencyMode: lowLatencyMode, maxRetry: (_a = requestConfig.manifest) === null || _a === void 0 ? void 0 : _a.maxRetry,
-                requestTimeout: (_b = requestConfig.manifest) === null || _b === void 0 ? void 0 : _b.timeout, minimumManifestUpdateInterval: minimumManifestUpdateInterval, initialManifest: initialManifest };
+            var manifestRequestSettings = { lowLatencyMode: lowLatencyMode, maxRetryRegular: manifestRetry,
+                maxRetryOffline: offlineRetry,
+                requestTimeout: manifestRequestTimeout, minimumManifestUpdateInterval: minimumManifestUpdateInterval, initialManifest: initialManifest };
             var relyOnVideoVisibilityAndSize = canRelyOnVideoVisibilityAndSize();
-            var throttlers = { throttleBitrate: {},
+            var throttlers = { throttle: {},
+                throttleBitrate: {},
                 limitWidth: {} };
+            if (this._priv_throttleWhenHidden) {
+                if (!relyOnVideoVisibilityAndSize) {
+                    log.warn("API: Can't apply throttleWhenHidden because " +
+                        "browser can't be trusted for visibility.");
+                }
+                else {
+                    throttlers.throttle = {
+                        video: createMappedReference(getPageActivityRef(currentContentCanceller.signal), function (isActive) { return isActive ? Infinity : 0; }, currentContentCanceller.signal),
+                    };
+                }
+            }
             if (this._priv_throttleVideoBitrateWhenHidden) {
                 if (!relyOnVideoVisibilityAndSize) {
                     log.warn("API: Can't apply throttleVideoBitrateWhenHidden because " +
@@ -348,16 +407,21 @@ var Player = /** @class */ (function (_super) {
             var adaptiveOptions = {
                 initialBitrates: this._priv_bitrateInfos.lastBitrates,
                 lowLatencyMode: lowLatencyMode,
+                manualBitrates: this._priv_bitrateInfos.manualBitrates,
+                minAutoBitrates: this._priv_bitrateInfos.minAutoBitrates,
+                maxAutoBitrates: this._priv_bitrateInfos.maxAutoBitrates,
                 throttlers: throttlers,
             };
             /** Options used by the TextTrack SegmentBuffer. */
             var textTrackOptions = options.textTrackMode === "native" ?
-                { textTrackMode: "native" } :
+                { textTrackMode: "native",
+                    hideNativeSubtitle: options.hideNativeSubtitle } :
                 { textTrackMode: "html",
                     textTrackElement: options.textTrackElement };
-            var bufferOptions = objectAssign({ enableFastSwitching: enableFastSwitching, onCodecSwitch: onCodecSwitch }, this._priv_bufferOptions);
-            var segmentRequestOptions = { lowLatencyMode: lowLatencyMode, maxRetry: (_c = requestConfig.segment) === null || _c === void 0 ? void 0 : _c.maxRetry,
-                requestTimeout: (_d = requestConfig.segment) === null || _d === void 0 ? void 0 : _d.timeout };
+            var bufferOptions = objectAssign({ audioTrackSwitchingMode: audioTrackSwitchingMode, enableFastSwitching: enableFastSwitching, manualBitrateSwitchingMode: manualBitrateSwitchingMode, onCodecSwitch: onCodecSwitch }, this._priv_bufferOptions);
+            var segmentRequestOptions = { lowLatencyMode: lowLatencyMode, maxRetryRegular: segmentRetry,
+                requestTimeout: segmentRequestTimeout,
+                maxRetryOffline: offlineRetry };
             initializer = new features.mediaSourceInit({
                 adaptiveOptions: adaptiveOptions,
                 autoPlay: autoPlay,
@@ -382,8 +446,8 @@ var Player = /** @class */ (function (_super) {
             else if (isNullOrUndefined(url)) {
                 throw new Error("No URL for a DirectFile content");
             }
-            mediaElementTracksStore =
-                this._priv_initializeMediaElementTracksStore(currentContentCanceller.signal);
+            mediaElementTrackChoiceManager =
+                this._priv_initializeMediaElementTrackChoiceManager(defaultAudioTrack, defaultTextTrack, currentContentCanceller.signal);
             if (currentContentCanceller.isUsed()) {
                 return;
             }
@@ -394,16 +458,18 @@ var Player = /** @class */ (function (_super) {
             contentId: generateContentId(),
             originalUrl: url,
             currentContentCanceller: currentContentCanceller,
-            defaultAudioTrackSwitchingMode: defaultAudioTrackSwitchingMode,
             initializer: initializer,
             isDirectFile: isDirectFile,
             segmentBuffersStore: null,
+            thumbnails: null,
             manifest: null,
             currentPeriod: null,
             activeAdaptations: null,
             activeRepresentations: null,
-            tracksStore: null,
-            mediaElementTracksStore: mediaElementTracksStore,
+            initialAudioTrack: defaultAudioTrack,
+            initialTextTrack: defaultTextTrack,
+            trackChoiceManager: null,
+            mediaElementTrackChoiceManager: mediaElementTrackChoiceManager,
         };
         // Bind events
         initializer.addEventListener("error", function (error) {
@@ -435,8 +501,8 @@ var Player = /** @class */ (function (_super) {
         });
         initializer.addEventListener("reloadingMediaSource", function (payload) {
             contentInfos.segmentBuffersStore = null;
-            if (contentInfos.tracksStore !== null) {
-                contentInfos.tracksStore.resetPeriodObjects();
+            if (contentInfos.trackChoiceManager !== null) {
+                contentInfos.trackChoiceManager.resetPeriods();
             }
             _this._priv_lastAutoPlay = payload.autoPlay;
         });
@@ -449,6 +515,9 @@ var Player = /** @class */ (function (_super) {
         initializer.addEventListener("streamEventSkip", function (streamEventSkip) {
             return _this.trigger("streamEventSkip", streamEventSkip);
         });
+        initializer.addEventListener("decipherabilityUpdate", function (decipherabilityUpdate) {
+            return _this.trigger("decipherabilityUpdate", decipherabilityUpdate);
+        });
         initializer.addEventListener("activePeriodChanged", function (periodInfo) {
             return _this._priv_onActivePeriodChanged(contentInfos, periodInfo);
         });
@@ -464,8 +533,8 @@ var Player = /** @class */ (function (_super) {
         initializer.addEventListener("adaptationChange", function (adaptationInfo) {
             return _this._priv_onAdaptationChange(contentInfos, adaptationInfo);
         });
-        initializer.addEventListener("bitrateEstimateChange", function (bitrateEstimateInfo) {
-            return _this._priv_onBitrateEstimateChange(bitrateEstimateInfo);
+        initializer.addEventListener("bitrateEstimationChange", function (bitrateEstimationInfo) {
+            return _this._priv_onBitrateEstimationChange(bitrateEstimationInfo);
         });
         initializer.addEventListener("manifestReady", function (manifest) {
             return _this._priv_onManifestReady(contentInfos, manifest);
@@ -473,6 +542,21 @@ var Player = /** @class */ (function (_super) {
         initializer.addEventListener("loaded", function (evt) {
             contentInfos.segmentBuffersStore = evt.segmentBuffersStore;
         });
+        initializer.addEventListener("addedSegment", function (evt) {
+            // Manage image tracks
+            // @deprecated
+            var content = evt.content, segmentData = evt.segmentData;
+            if (content.adaptation.type === "image") {
+                if (!isNullOrUndefined(segmentData) &&
+                    segmentData.type === "bif") {
+                    var imageData = segmentData.data;
+                    /* eslint-disable import/no-deprecated */
+                    contentInfos.thumbnails = imageData;
+                    _this.trigger("imageTrackUpdate", { data: contentInfos.thumbnails });
+                    /* eslint-enable import/no-deprecated */
+                }
+            }
+        });
         // Now, that most events are linked, prepare the next content.
         initializer.prepare();
         // Now that the content is prepared, stop previous content and reset state
@@ -588,6 +672,11 @@ var Player = /** @class */ (function (_super) {
                 seekEventsCanceller.linkToSignal(currentContentCanceller.signal);
                 emitSeekEvents(videoElement, playbackObserver, function () { return _this.trigger("seeking", null); }, function () { return _this.trigger("seeked", null); }, seekEventsCanceller.signal);
             }
+            // Previous call could have performed all kind of side-effects, thus,
+            // we re-check the current state associated to the RxPlayer
+            if (_this.state === "ENDED" /* PLAYER_STATES.ENDED */ && _this._priv_stopAtEnd) {
+                _this.stop();
+            }
         }, { emitCurrentValue: true, clearSignal: currentContentCanceller.signal });
         // React to playback conditions change
         playbackObserver.listen(function (observation) {
@@ -616,6 +705,53 @@ var Player = /** @class */ (function (_super) {
     Player.prototype.getError = function () {
         return this._priv_currentError;
     };
+    /**
+     * Returns manifest/playlist object.
+     * null if the player is STOPPED.
+     * @deprecated
+     * @returns {Manifest|null} - The current Manifest (`null` when not known).
+     */
+    Player.prototype.getManifest = function () {
+        warnOnce("getManifest is deprecated." +
+            " Please open an issue if you used this API.");
+        if (this._priv_contentInfos === null) {
+            return null;
+        }
+        return this._priv_contentInfos.manifest;
+    };
+    /**
+     * Returns Adaptations (tracks) for every currently playing type
+     * (audio/video/text...).
+     * @deprecated
+     * @returns {Object|null} - The current Adaptation objects, per type (`null`
+     * when none is known for now.
+     */
+    Player.prototype.getCurrentAdaptations = function () {
+        warnOnce("getCurrentAdaptations is deprecated." +
+            " Please open an issue if you used this API.");
+        if (this._priv_contentInfos === null) {
+            return null;
+        }
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeAdaptations = _a.activeAdaptations;
+        if (currentPeriod === null ||
+            activeAdaptations === null ||
+            isNullOrUndefined(activeAdaptations[currentPeriod.id])) {
+            return null;
+        }
+        return activeAdaptations[currentPeriod.id];
+    };
+    /**
+     * Returns representations (qualities) for every currently playing type
+     * (audio/video/text...).
+     * @deprecated
+     * @returns {Object|null} - The current Representation objects, per type
+     * (`null` when none is known for now.
+     */
+    Player.prototype.getCurrentRepresentations = function () {
+        warnOnce("getCurrentRepresentations is deprecated." +
+            " Please open an issue if you used this API.");
+        return this._priv_getCurrentRepresentations();
+    };
     /**
      * Returns the media DOM element used by the player.
      * You should not its HTML5 API directly and use the player's method instead,
@@ -626,6 +762,26 @@ var Player = /** @class */ (function (_super) {
     Player.prototype.getVideoElement = function () {
         return this.videoElement;
     };
+    /**
+     * If one returns the first native text-track element attached to the media element.
+     * @deprecated
+     * @returns {TextTrack} - The native TextTrack attached (`null` when none)
+     */
+    Player.prototype.getNativeTextTrack = function () {
+        warnOnce("getNativeTextTrack is deprecated." +
+            " Please open an issue if you used this API.");
+        if (this.videoElement === null) {
+            throw new Error("Disposed player");
+        }
+        var videoElement = this.videoElement;
+        var textTracks = videoElement.textTracks;
+        if (textTracks.length > 0) {
+            return videoElement.textTracks[0];
+        }
+        else {
+            return null;
+        }
+    };
     /**
      * Returns the player's current state.
      * @returns {string} - The current Player's state
@@ -693,22 +849,21 @@ var Player = /** @class */ (function (_super) {
         return this._priv_preferTrickModeTracks;
     };
     /**
-     * Returns the URL(s) of the currently considered Manifest, or of the content for
+     * Returns the url of the currently considered Manifest, or of the content for
      * directfile content.
-     * @returns {Array.<string>|undefined} - Current URL. `undefined` if not known
-     * or no URL yet.
+     * @returns {string|undefined} - Current URL. `undefined` if not known or no
+     * URL yet.
      */
-    Player.prototype.getContentUrls = function () {
+    Player.prototype.getUrl = function () {
         if (this._priv_contentInfos === null) {
             return undefined;
         }
         var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, manifest = _a.manifest, originalUrl = _a.originalUrl;
         if (isDirectFile) {
-            return originalUrl === undefined ? undefined :
-                [originalUrl];
+            return originalUrl;
         }
         if (manifest !== null) {
-            return manifest.getUrls();
+            return manifest.getUrl();
         }
         return undefined;
     };
@@ -732,7 +887,7 @@ var Player = /** @class */ (function (_super) {
      * NaN if no video is playing.
      * @returns {Number}
      */
-    Player.prototype.getMediaDuration = function () {
+    Player.prototype.getVideoDuration = function () {
         if (this.videoElement === null) {
             throw new Error("Disposed player");
         }
@@ -744,13 +899,43 @@ var Player = /** @class */ (function (_super) {
      *   - the current time
      * @returns {Number}
      */
-    Player.prototype.getCurrentBufferGap = function () {
+    Player.prototype.getVideoBufferGap = function () {
         if (this.videoElement === null) {
             throw new Error("Disposed player");
         }
         var videoElement = this.videoElement;
         return getLeftSizeOfRange(videoElement.buffered, videoElement.currentTime);
     };
+    /**
+     * Returns in seconds the difference between:
+     *   - the end of the current contiguous loaded range.
+     *   - the start of the current contiguous loaded range.
+     * @returns {Number}
+     */
+    Player.prototype.getVideoLoadedTime = function () {
+        warnOnce("`getVideoLoadedTime` is deprecated and won't be present in the " +
+            "next major version");
+        if (this.videoElement === null) {
+            throw new Error("Disposed player");
+        }
+        var videoElement = this.videoElement;
+        return getSizeOfRange(videoElement.buffered, videoElement.currentTime);
+    };
+    /**
+     * Returns in seconds the difference between:
+     *   - the current time.
+     *   - the start of the current contiguous loaded range.
+     * @returns {Number}
+     */
+    Player.prototype.getVideoPlayedTime = function () {
+        warnOnce("`getVideoPlayedTime` is deprecated and won't be present in the " +
+            "next major version");
+        if (this.videoElement === null) {
+            throw new Error("Disposed player");
+        }
+        var videoElement = this.videoElement;
+        return getPlayedSizeOfRange(videoElement.buffered, videoElement.currentTime);
+    };
     /**
      * Get the current position, in s, in wall-clock time.
      * That is:
@@ -884,47 +1069,115 @@ var Player = /** @class */ (function (_super) {
             return;
         }
         this._priv_preferTrickModeTracks = preferTrickModeTracks;
-        var tracksStore = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.tracksStore;
-        if (!isNullOrUndefined(tracksStore)) {
-            if (preferTrickModeTracks && !tracksStore.isTrickModeEnabled()) {
-                tracksStore.enableVideoTrickModeTracks();
+        var trackChoiceManager = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.trackChoiceManager;
+        if (!isNullOrUndefined(trackChoiceManager)) {
+            if (preferTrickModeTracks && !trackChoiceManager.isTrickModeEnabled()) {
+                trackChoiceManager.enableVideoTrickModeTracks();
             }
-            else if (!preferTrickModeTracks && tracksStore.isTrickModeEnabled()) {
-                tracksStore.disableVideoTrickModeTracks();
+            else if (!preferTrickModeTracks && trackChoiceManager.isTrickModeEnabled()) {
+                trackChoiceManager.disableVideoTrickModeTracks();
             }
         }
     };
     /**
-     * Returns video Representation currently considered for the current Period.
-     *
-     * Returns `null` if no video track is playing for the current Period.
-     *
-     * Returns `undefined` either when are not currently playing any Period or
-     * when we don't know which Representation is playing.
-     * @returns {Object|null|undefined}
+     * Returns all available bitrates for the current video Adaptation.
+     * @returns {Array.<Number>}
      */
-    Player.prototype.getVideoRepresentation = function () {
-        var representations = this.__priv_getCurrentRepresentations();
-        if (representations === null) {
+    Player.prototype.getAvailableVideoBitrates = function () {
+        if (this._priv_contentInfos === null) {
+            return [];
+        }
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeAdaptations = _a.activeAdaptations;
+        if (currentPeriod === null || activeAdaptations === null) {
+            return [];
+        }
+        var adaptations = activeAdaptations[currentPeriod.id];
+        if (adaptations === undefined || isNullOrUndefined(adaptations.video)) {
+            return [];
+        }
+        return adaptations.video.getAvailableBitrates();
+    };
+    /**
+     * Returns all available bitrates for the current audio Adaptation.
+     * @returns {Array.<Number>}
+     */
+    Player.prototype.getAvailableAudioBitrates = function () {
+        if (this._priv_contentInfos === null) {
+            return [];
+        }
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeAdaptations = _a.activeAdaptations;
+        if (currentPeriod === null || activeAdaptations === null) {
+            return [];
+        }
+        var adaptations = activeAdaptations[currentPeriod.id];
+        if (adaptations === undefined || isNullOrUndefined(adaptations.audio)) {
+            return [];
+        }
+        return adaptations.audio.getAvailableBitrates();
+    };
+    /**
+     * Returns the manual audio bitrate set. -1 if in AUTO mode.
+     * @returns {Number}
+     */
+    Player.prototype.getManualAudioBitrate = function () {
+        return this._priv_bitrateInfos.manualBitrates.audio.getValue();
+    };
+    /**
+     * Returns the manual video bitrate set. -1 if in AUTO mode.
+     * @returns {Number}
+     */
+    Player.prototype.getManualVideoBitrate = function () {
+        return this._priv_bitrateInfos.manualBitrates.video.getValue();
+    };
+    /**
+     * Returns currently considered bitrate for video segments.
+     * @returns {Number|undefined}
+     */
+    Player.prototype.getVideoBitrate = function () {
+        var representations = this._priv_getCurrentRepresentations();
+        if (representations === null || isNullOrUndefined(representations.video)) {
             return undefined;
         }
-        return representations.video;
+        return representations.video.bitrate;
     };
     /**
-     * Returns audio Representation currently considered for the current Period.
-     *
-     * Returns `null` if no audio track is playing for the current Period.
-     *
-     * Returns `undefined` either when are not currently playing any Period or
-     * when we don't know which Representation is playing.
-     * @returns {Object|null|undefined}
+     * Returns currently considered bitrate for audio segments.
+     * @returns {Number|undefined}
      */
-    Player.prototype.getAudioRepresentation = function () {
-        var representations = this.__priv_getCurrentRepresentations();
-        if (representations === null) {
+    Player.prototype.getAudioBitrate = function () {
+        var representations = this._priv_getCurrentRepresentations();
+        if (representations === null || isNullOrUndefined(representations.audio)) {
             return undefined;
         }
-        return representations.audio;
+        return representations.audio.bitrate;
+    };
+    /**
+     * Returns minimum wanted video bitrate currently set.
+     * @returns {Number}
+     */
+    Player.prototype.getMinVideoBitrate = function () {
+        return this._priv_bitrateInfos.minAutoBitrates.video.getValue();
+    };
+    /**
+     * Returns minimum wanted audio bitrate currently set.
+     * @returns {Number}
+     */
+    Player.prototype.getMinAudioBitrate = function () {
+        return this._priv_bitrateInfos.minAutoBitrates.audio.getValue();
+    };
+    /**
+     * Returns maximum wanted video bitrate currently set.
+     * @returns {Number}
+     */
+    Player.prototype.getMaxVideoBitrate = function () {
+        return this._priv_bitrateInfos.maxAutoBitrates.video.getValue();
+    };
+    /**
+     * Returns maximum wanted audio bitrate currently set.
+     * @returns {Number}
+     */
+    Player.prototype.getMaxAudioBitrate = function () {
+        return this._priv_bitrateInfos.maxAutoBitrates.audio.getValue();
     };
     /**
      * Play/Resume the current video.
@@ -1015,6 +1268,44 @@ var Player = /** @class */ (function (_super) {
         this.videoElement.currentTime = positionWanted;
         return positionWanted;
     };
+    /**
+     * Returns true if the media element is full screen.
+     * @deprecated
+     * @returns {Boolean}
+     */
+    Player.prototype.isFullscreen = function () {
+        warnOnce("isFullscreen is deprecated." +
+            " Fullscreen management should now be managed by the application");
+        return isFullscreen();
+    };
+    /**
+     * Set/exit fullScreen.
+     * @deprecated
+     * @param {Boolean} [goFull=true] - if false, exit full screen.
+     */
+    Player.prototype.setFullscreen = function (goFull) {
+        if (goFull === void 0) { goFull = true; }
+        warnOnce("setFullscreen is deprecated." +
+            " Fullscreen management should now be managed by the application");
+        if (this.videoElement === null) {
+            throw new Error("Disposed player");
+        }
+        if (goFull) {
+            requestFullscreen(this.videoElement);
+        }
+        else {
+            exitFullscreen();
+        }
+    };
+    /**
+     * Exit from full screen mode.
+     * @deprecated
+     */
+    Player.prototype.exitFullscreen = function () {
+        warnOnce("exitFullscreen is deprecated." +
+            " Fullscreen management should now be managed by the application");
+        exitFullscreen();
+    };
     /**
      * Returns the current player's audio volume on the media element.
      * From 0 (no audio) to 1 (maximum volume).
@@ -1066,6 +1357,74 @@ var Player = /** @class */ (function (_super) {
                 this._priv_mutedMemory);
         }
     };
+    /**
+     * Force the video bitrate to a given value. Act as a ceil.
+     * -1 to set it on AUTO Mode
+     * @param {Number} btr
+     */
+    Player.prototype.setVideoBitrate = function (btr) {
+        this._priv_bitrateInfos.manualBitrates.video.setValue(btr);
+    };
+    /**
+     * Force the audio bitrate to a given value. Act as a ceil.
+     * -1 to set it on AUTO Mode
+     * @param {Number} btr
+     */
+    Player.prototype.setAudioBitrate = function (btr) {
+        this._priv_bitrateInfos.manualBitrates.audio.setValue(btr);
+    };
+    /**
+     * Update the minimum video bitrate the user can switch to.
+     * @param {Number} btr
+     */
+    Player.prototype.setMinVideoBitrate = function (btr) {
+        var maxVideoBitrate = this._priv_bitrateInfos.maxAutoBitrates.video.getValue();
+        if (btr > maxVideoBitrate) {
+            throw new Error("Invalid minimum video bitrate given. " +
+                "Its value, \"".concat(btr, "\" is superior the current maximum ") +
+                "video birate, \"".concat(maxVideoBitrate, "\"."));
+        }
+        this._priv_bitrateInfos.minAutoBitrates.video.setValue(btr);
+    };
+    /**
+     * Update the minimum audio bitrate the user can switch to.
+     * @param {Number} btr
+     */
+    Player.prototype.setMinAudioBitrate = function (btr) {
+        var maxAudioBitrate = this._priv_bitrateInfos.maxAutoBitrates.audio.getValue();
+        if (btr > maxAudioBitrate) {
+            throw new Error("Invalid minimum audio bitrate given. " +
+                "Its value, \"".concat(btr, "\" is superior the current maximum ") +
+                "audio birate, \"".concat(maxAudioBitrate, "\"."));
+        }
+        this._priv_bitrateInfos.minAutoBitrates.audio.setValue(btr);
+    };
+    /**
+     * Update the maximum video bitrate the user can switch to.
+     * @param {Number} btr
+     */
+    Player.prototype.setMaxVideoBitrate = function (btr) {
+        var minVideoBitrate = this._priv_bitrateInfos.minAutoBitrates.video.getValue();
+        if (btr < minVideoBitrate) {
+            throw new Error("Invalid maximum video bitrate given. " +
+                "Its value, \"".concat(btr, "\" is inferior the current minimum ") +
+                "video birate, \"".concat(minVideoBitrate, "\"."));
+        }
+        this._priv_bitrateInfos.maxAutoBitrates.video.setValue(btr);
+    };
+    /**
+     * Update the maximum audio bitrate the user can switch to.
+     * @param {Number} btr
+     */
+    Player.prototype.setMaxAudioBitrate = function (btr) {
+        var minAudioBitrate = this._priv_bitrateInfos.minAutoBitrates.audio.getValue();
+        if (btr < minAudioBitrate) {
+            throw new Error("Invalid maximum audio bitrate given. " +
+                "Its value, \"".concat(btr, "\" is inferior the current minimum ") +
+                "audio birate, \"".concat(minAudioBitrate, "\"."));
+        }
+        this._priv_bitrateInfos.maxAutoBitrates.audio.setValue(btr);
+    };
     /**
      * Set the max buffer size for the buffer behind the current position.
      * Every buffer data before will be removed.
@@ -1140,14 +1499,6 @@ var Player = /** @class */ (function (_super) {
         }
         return getCurrentKeySystem(this.videoElement);
     };
-    Player.prototype.getCurrentPeriod = function () {
-        var _a;
-        var currentPeriod = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.currentPeriod;
-        if (isNullOrUndefined(currentPeriod)) {
-            return null;
-        }
-        return { id: currentPeriod.id, start: currentPeriod.start, end: currentPeriod.end };
-    };
     /**
      * Returns both the name of the key system (e.g. `"com.widevine.alpha"`) and
      * the `MediaKeySystemConfiguration` currently associated to the
@@ -1167,356 +1518,342 @@ var Player = /** @class */ (function (_super) {
         return { keySystem: values[0], configuration: values[1] };
     };
     /**
-     * Returns the list of available Periods for which the current audio, video or
-     * text track can now be changed.
-     * @returns {Array.<Object>}
+     * Returns every available audio tracks for the current Period.
+     * @returns {Array.<Object>|null}
      */
-    Player.prototype.getAvailablePeriods = function () {
+    Player.prototype.getAvailableAudioTracks = function () {
+        var _a;
         if (this._priv_contentInfos === null) {
             return [];
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, tracksStore = _a.tracksStore;
+        var _b = this._priv_contentInfos, currentPeriod = _b.currentPeriod, isDirectFile = _b.isDirectFile, trackChoiceManager = _b.trackChoiceManager, mediaElementTrackChoiceManager = _b.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            return [];
+            return (_a = mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.getAvailableAudioTracks()) !== null && _a !== void 0 ? _a : [];
         }
-        if (tracksStore === null) {
+        if (trackChoiceManager === null || currentPeriod === null) {
             return [];
         }
-        return tracksStore.getAvailablePeriods().slice();
+        return trackChoiceManager.getAvailableAudioTracks(currentPeriod);
     };
     /**
-     * Returns every available audio tracks for a given Period - or the current
-     * one if no `periodId` is given.
-     * @param {string|undefined} [periodId]
-     * @returns {Array.<Object>}
+     * Returns every available text tracks for the current Period.
+     * @returns {Array.<Object>|null}
      */
-    Player.prototype.getAvailableAudioTracks = function (periodId) {
+    Player.prototype.getAvailableTextTracks = function () {
         var _a;
         if (this._priv_contentInfos === null) {
             return [];
         }
-        var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, mediaElementTracksStore = _b.mediaElementTracksStore;
+        var _b = this._priv_contentInfos, currentPeriod = _b.currentPeriod, isDirectFile = _b.isDirectFile, trackChoiceManager = _b.trackChoiceManager, mediaElementTrackChoiceManager = _b.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            return (_a = mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.getAvailableAudioTracks()) !== null && _a !== void 0 ? _a : [];
+            return (_a = mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.getAvailableTextTracks()) !== null && _a !== void 0 ? _a : [];
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, [], function (tcm, periodRef) { var _a; return (_a = tcm.getAvailableAudioTracks(periodRef)) !== null && _a !== void 0 ? _a : []; });
-    };
-    /**
-     * Returns every available text tracks for a given Period - or the current
-     * one if no `periodId` is given.
-     * @param {string|undefined} [periodId]
-     * @returns {Array.<Object>}
-     */
-    Player.prototype.getAvailableTextTracks = function (periodId) {
-        var _a;
-        if (this._priv_contentInfos === null) {
+        if (trackChoiceManager === null || currentPeriod === null) {
             return [];
         }
-        var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, mediaElementTracksStore = _b.mediaElementTracksStore;
-        if (isDirectFile) {
-            return (_a = mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.getAvailableTextTracks()) !== null && _a !== void 0 ? _a : [];
-        }
-        return this._priv_callTracksStoreGetterSetter(periodId, [], function (tcm, periodRef) { var _a; return (_a = tcm.getAvailableTextTracks(periodRef)) !== null && _a !== void 0 ? _a : []; });
+        return trackChoiceManager.getAvailableTextTracks(currentPeriod);
     };
     /**
      * Returns every available video tracks for the current Period.
-     * @param {string|undefined} [periodId]
-     * @returns {Array.<Object>}
+     * @returns {Array.<Object>|null}
      */
-    Player.prototype.getAvailableVideoTracks = function (periodId) {
+    Player.prototype.getAvailableVideoTracks = function () {
         var _a;
         if (this._priv_contentInfos === null) {
             return [];
         }
-        var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, mediaElementTracksStore = _b.mediaElementTracksStore;
+        var _b = this._priv_contentInfos, currentPeriod = _b.currentPeriod, isDirectFile = _b.isDirectFile, trackChoiceManager = _b.trackChoiceManager, mediaElementTrackChoiceManager = _b.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            return (_a = mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.getAvailableVideoTracks()) !== null && _a !== void 0 ? _a : [];
+            return (_a = mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.getAvailableVideoTracks()) !== null && _a !== void 0 ? _a : [];
+        }
+        if (trackChoiceManager === null || currentPeriod === null) {
+            return [];
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, [], function (tcm, periodRef) { var _a; return (_a = tcm.getAvailableVideoTracks(periodRef)) !== null && _a !== void 0 ? _a : []; });
+        return trackChoiceManager.getAvailableVideoTracks(currentPeriod);
     };
     /**
      * Returns currently chosen audio language for the current Period.
-     * @param {string|undefined} [periodId]
-     * @returns {Object|null|undefined}
+     * @returns {string}
      */
-    Player.prototype.getAudioTrack = function (periodId) {
+    Player.prototype.getAudioTrack = function () {
         if (this._priv_contentInfos === null) {
             return undefined;
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            if (mediaElementTracksStore === null) {
+            if (mediaElementTrackChoiceManager === null) {
                 return undefined;
             }
-            return mediaElementTracksStore.getChosenAudioTrack();
+            return mediaElementTrackChoiceManager.getChosenAudioTrack();
+        }
+        if (trackChoiceManager === null || currentPeriod === null) {
+            return undefined;
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.getChosenAudioTrack(periodRef); });
+        return trackChoiceManager.getChosenAudioTrack(currentPeriod);
     };
     /**
      * Returns currently chosen subtitle for the current Period.
-     * @param {string|undefined} [periodId]
-     * @returns {Object|null|undefined}
+     * @returns {string}
      */
-    Player.prototype.getTextTrack = function (periodId) {
+    Player.prototype.getTextTrack = function () {
         if (this._priv_contentInfos === null) {
             return undefined;
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            if (mediaElementTracksStore === null) {
+            if (mediaElementTrackChoiceManager === null) {
                 return undefined;
             }
-            return mediaElementTracksStore.getChosenTextTrack();
+            return mediaElementTrackChoiceManager.getChosenTextTrack();
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.getChosenTextTrack(periodRef); });
+        if (trackChoiceManager === null || currentPeriod === null) {
+            return undefined;
+        }
+        return trackChoiceManager.getChosenTextTrack(currentPeriod);
     };
     /**
      * Returns currently chosen video track for the current Period.
-     * @param {string|undefined} [periodId]
-     * @returns {Object|null|undefined}
+     * @returns {string}
      */
-    Player.prototype.getVideoTrack = function (periodId) {
+    Player.prototype.getVideoTrack = function () {
         if (this._priv_contentInfos === null) {
             return undefined;
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            if (mediaElementTracksStore === null) {
+            if (mediaElementTrackChoiceManager === null) {
                 return undefined;
             }
-            return mediaElementTracksStore.getChosenVideoTrack();
+            return mediaElementTrackChoiceManager.getChosenVideoTrack();
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.getChosenVideoTrack(periodRef); });
+        if (trackChoiceManager === null || currentPeriod === null) {
+            return undefined;
+        }
+        return trackChoiceManager.getChosenVideoTrack(currentPeriod);
     };
     /**
      * Update the audio language for the current Period.
-     * @param {string | object} arg
-     * @throws Error - the current content has no TracksStore.
+     * @param {string} audioId
+     * @throws Error - the current content has no TrackChoiceManager.
      * @throws Error - the given id is linked to no audio track.
      */
-    Player.prototype.setAudioTrack = function (arg) {
-        var _a;
+    Player.prototype.setAudioTrack = function (audioId) {
         if (this._priv_contentInfos === null) {
             throw new Error("No content loaded");
         }
-        var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, mediaElementTracksStore = _b.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
             try {
-                var audioId = typeof arg === "string" ? arg :
-                    arg.trackId;
-                mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.setAudioTrackById(audioId);
+                mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.setAudioTrackById(audioId);
                 return;
             }
             catch (e) {
                 throw new Error("player: unknown audio track");
             }
         }
-        var periodId;
-        var trackId;
-        var switchingMode;
-        var reprsToLock = null;
-        if (typeof arg === "string") {
-            trackId = arg;
+        if (trackChoiceManager === null || currentPeriod === null) {
+            throw new Error("No compatible content launched.");
         }
-        else {
-            trackId = arg.trackId;
-            periodId = arg.periodId;
-            switchingMode = arg.switchingMode;
-            reprsToLock = (_a = arg.lockedRepresentations) !== null && _a !== void 0 ? _a : null;
+        try {
+            trackChoiceManager.setAudioTrackByID(currentPeriod, audioId);
+        }
+        catch (e) {
+            throw new Error("player: unknown audio track");
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) {
-            return tcm.setAudioTrack(periodRef, trackId, switchingMode, reprsToLock);
-        });
     };
     /**
      * Update the text language for the current Period.
-     * @param {string | Object} arg
-     * @throws Error - the current content has no TracksStore.
+     * @param {string} sub
+     * @throws Error - the current content has no TrackChoiceManager.
      * @throws Error - the given id is linked to no text track.
      */
-    Player.prototype.setTextTrack = function (arg) {
+    Player.prototype.setTextTrack = function (textId) {
         if (this._priv_contentInfos === null) {
             throw new Error("No content loaded");
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
             try {
-                var textId = typeof arg === "string" ? arg :
-                    arg.trackId;
-                mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.setTextTrackById(textId);
+                mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.setTextTrackById(textId);
                 return;
             }
             catch (e) {
                 throw new Error("player: unknown text track");
             }
         }
-        var periodId;
-        var trackId;
-        if (typeof arg === "string") {
-            trackId = arg;
+        if (trackChoiceManager === null || currentPeriod === null) {
+            throw new Error("No compatible content launched.");
         }
-        else {
-            trackId = arg.trackId;
-            periodId = arg.periodId;
+        try {
+            trackChoiceManager.setTextTrackByID(currentPeriod, textId);
+        }
+        catch (e) {
+            throw new Error("player: unknown text track");
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.setTextTrack(periodRef, trackId); });
     };
     /**
      * Disable subtitles for the current content.
-     * @param {string|undefined} [periodId]
      */
-    Player.prototype.disableTextTrack = function (periodId) {
+    Player.prototype.disableTextTrack = function () {
         if (this._priv_contentInfos === null) {
             return;
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
-            mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.disableTextTrack();
+            mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.disableTextTrack();
+            return;
+        }
+        if (trackChoiceManager === null || currentPeriod === null) {
             return;
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.disableTrack(periodRef, "text"); });
+        return trackChoiceManager.disableTextTrack(currentPeriod);
     };
     /**
      * Update the video track for the current Period.
-     * @param {string | Object} arg
-     * @throws Error - the current content has no TracksStore.
+     * @param {string} videoId
+     * @throws Error - the current content has no TrackChoiceManager.
      * @throws Error - the given id is linked to no video track.
      */
-    Player.prototype.setVideoTrack = function (arg) {
-        var _a;
+    Player.prototype.setVideoTrack = function (videoId) {
         if (this._priv_contentInfos === null) {
             throw new Error("No content loaded");
         }
-        var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, mediaElementTracksStore = _b.mediaElementTracksStore;
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
         if (isDirectFile) {
             try {
-                var videoId = typeof arg === "string" ? arg :
-                    arg.trackId;
-                mediaElementTracksStore === null || mediaElementTracksStore === void 0 ? void 0 : mediaElementTracksStore.setVideoTrackById(videoId);
+                mediaElementTrackChoiceManager === null || mediaElementTrackChoiceManager === void 0 ? void 0 : mediaElementTrackChoiceManager.setVideoTrackById(videoId);
                 return;
             }
             catch (e) {
                 throw new Error("player: unknown video track");
             }
         }
-        var periodId;
-        var trackId;
-        var switchingMode;
-        var reprsToLock = null;
-        if (typeof arg === "string") {
-            trackId = arg;
+        if (trackChoiceManager === null || currentPeriod === null) {
+            throw new Error("No compatible content launched.");
         }
-        else {
-            trackId = arg.trackId;
-            periodId = arg.periodId;
-            switchingMode = arg.switchingMode;
-            reprsToLock = (_a = arg.lockedRepresentations) !== null && _a !== void 0 ? _a : null;
+        try {
+            trackChoiceManager.setVideoTrackByID(currentPeriod, videoId);
+        }
+        catch (e) {
+            throw new Error("player: unknown video track");
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) {
-            return tcm.setVideoTrack(periodRef, trackId, switchingMode, reprsToLock);
-        });
     };
     /**
      * Disable video track for the current content.
-     * @param {string|undefined} [periodId]
      */
-    Player.prototype.disableVideoTrack = function (periodId) {
+    Player.prototype.disableVideoTrack = function () {
         if (this._priv_contentInfos === null) {
             return;
         }
-        var _a = this._priv_contentInfos, isDirectFile = _a.isDirectFile, mediaElementTracksStore = _a.mediaElementTracksStore;
-        if (isDirectFile && mediaElementTracksStore !== null) {
-            return mediaElementTracksStore.disableVideoTrack();
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, isDirectFile = _a.isDirectFile, trackChoiceManager = _a.trackChoiceManager, mediaElementTrackChoiceManager = _a.mediaElementTrackChoiceManager;
+        if (isDirectFile && mediaElementTrackChoiceManager !== null) {
+            return mediaElementTrackChoiceManager.disableVideoTrack();
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.disableTrack(periodRef, "video"); });
-    };
-    Player.prototype.lockVideoRepresentations = function (arg) {
-        if (this._priv_contentInfos === null) {
-            throw new Error("No content loaded");
-        }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            throw new Error("Cannot lock video Representations in directfile mode.");
-        }
-        var repsId;
-        var periodId;
-        var switchingMode;
-        if (Array.isArray(arg)) {
-            repsId = arg;
-            periodId = undefined;
-        }
-        else {
-            repsId = arg.representations;
-            periodId = arg.periodId;
-            switchingMode = arg.switchingMode;
+        if (trackChoiceManager === null || currentPeriod === null) {
+            return;
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) {
-            return tcm.lockVideoRepresentations(periodRef, { representations: repsId, switchingMode: switchingMode });
-        });
+        return trackChoiceManager.disableVideoTrack(currentPeriod);
     };
-    Player.prototype.lockAudioRepresentations = function (arg) {
-        if (this._priv_contentInfos === null) {
-            throw new Error("No content loaded");
-        }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            throw new Error("Cannot lock audio Representations in directfile mode.");
+    /**
+     * Returns the current list of preferred audio tracks, in preference order.
+     * @returns {Array.<Object>}
+     */
+    Player.prototype.getPreferredAudioTracks = function () {
+        return this._priv_preferredAudioTracks;
+    };
+    /**
+     * Returns the current list of preferred text tracks, in preference order.
+     * @returns {Array.<Object>}
+     */
+    Player.prototype.getPreferredTextTracks = function () {
+        return this._priv_preferredTextTracks;
+    };
+    /**
+     * Returns the current list of preferred text tracks, in preference order.
+     * @returns {Array.<Object>}
+     */
+    Player.prototype.getPreferredVideoTracks = function () {
+        return this._priv_preferredVideoTracks;
+    };
+    /**
+     * Set the list of preferred audio tracks, in preference order.
+     * @param {Array.<Object>} tracks
+     * @param {boolean} shouldApply - `true` if those preferences should be
+     * applied on the currently loaded Period. `false` if it should only
+     * be applied to new content.
+     */
+    Player.prototype.setPreferredAudioTracks = function (tracks, shouldApply) {
+        if (shouldApply === void 0) { shouldApply = false; }
+        if (!Array.isArray(tracks)) {
+            throw new Error("Invalid `setPreferredAudioTracks` argument. " +
+                "Should have been an Array.");
         }
-        var repsId;
-        var periodId;
-        var switchingMode;
-        if (Array.isArray(arg)) {
-            repsId = arg;
-            periodId = undefined;
+        this._priv_preferredAudioTracks = tracks;
+        var contentInfos = this._priv_contentInfos;
+        if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager.setPreferredAudioTracks(tracks, shouldApply);
         }
-        else {
-            repsId = arg.representations;
-            periodId = arg.periodId;
-            switchingMode = arg.switchingMode;
+        else if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager.setPreferredAudioTracks(tracks, shouldApply);
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) {
-            return tcm.lockAudioRepresentations(periodRef, { representations: repsId, switchingMode: switchingMode });
-        });
     };
-    Player.prototype.getLockedVideoRepresentations = function (periodId) {
-        if (this._priv_contentInfos === null) {
-            return null;
-        }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            return null;
+    /**
+     * Set the list of preferred text tracks, in preference order.
+     * @param {Array.<Object>} tracks
+     * @param {boolean} shouldApply - `true` if those preferences should be
+     * applied on the currently loaded Periods. `false` if it should only
+     * be applied to new content.
+     */
+    Player.prototype.setPreferredTextTracks = function (tracks, shouldApply) {
+        if (shouldApply === void 0) { shouldApply = false; }
+        if (!Array.isArray(tracks)) {
+            throw new Error("Invalid `setPreferredTextTracks` argument. " +
+                "Should have been an Array.");
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, null, function (tcm, periodRef) { return tcm.getLockedVideoRepresentations(periodRef); });
-    };
-    Player.prototype.getLockedAudioRepresentations = function (periodId) {
-        if (this._priv_contentInfos === null) {
-            return null;
+        this._priv_preferredTextTracks = tracks;
+        var contentInfos = this._priv_contentInfos;
+        if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager.setPreferredTextTracks(tracks, shouldApply);
         }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            return null;
+        else if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager.setPreferredTextTracks(tracks, shouldApply);
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, null, function (tcm, periodRef) { return tcm.getLockedAudioRepresentations(periodRef); });
     };
-    Player.prototype.unlockVideoRepresentations = function (periodId) {
-        if (this._priv_contentInfos === null) {
-            return;
+    /**
+     * Set the list of preferred text tracks, in preference order.
+     * @param {Array.<Object>} tracks
+     * @param {boolean} shouldApply - `true` if those preferences should be
+     * applied on the currently loaded Period. `false` if it should only
+     * be applied to new content.
+     */
+    Player.prototype.setPreferredVideoTracks = function (tracks, shouldApply) {
+        if (shouldApply === void 0) { shouldApply = false; }
+        if (!Array.isArray(tracks)) {
+            throw new Error("Invalid `setPreferredVideoTracks` argument. " +
+                "Should have been an Array.");
         }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            return;
+        this._priv_preferredVideoTracks = tracks;
+        var contentInfos = this._priv_contentInfos;
+        if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.trackChoiceManager.setPreferredVideoTracks(tracks, shouldApply);
+        }
+        else if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager)) {
+            contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.mediaElementTrackChoiceManager.setPreferredVideoTracks(tracks, shouldApply);
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.unlockVideoRepresentations(periodRef); });
     };
-    Player.prototype.unlockAudioRepresentations = function (periodId) {
+    /**
+     * @returns {Array.<Object>|null}
+     * @deprecated
+     */
+    Player.prototype.getImageTrackData = function () {
+        warnOnce("`getImageTrackData` is deprecated." +
+            "Please use the `parseBifThumbnails` tool instead.");
         if (this._priv_contentInfos === null) {
-            return;
-        }
-        var isDirectFile = this._priv_contentInfos.isDirectFile;
-        if (isDirectFile) {
-            return;
+            return null;
         }
-        return this._priv_callTracksStoreGetterSetter(periodId, undefined, function (tcm, periodRef) { return tcm.unlockAudioRepresentations(periodRef); });
+        /* eslint-disable import/no-deprecated */
+        return this._priv_contentInfos.thumbnails;
+        /* eslint-enable import/no-deprecated */
     };
     /**
      * Get minimum seek-able position.
@@ -1558,12 +1895,6 @@ var Player = /** @class */ (function (_super) {
         }
         return null;
     };
-    // ---- Undocumented Private methods. ----
-    //
-    // Those methods are just here either to allow some tools relying on the
-    // RxPlayer instance to work or to improve the RxPlayer's demo.
-    //
-    // They should not be used by any external code.
     /**
      * /!\ For demo use only! Do not touch!
      *
@@ -1585,58 +1916,16 @@ var Player = /** @class */ (function (_super) {
         }
         return null;
     };
-    /**
-     * /!\ For tools use only! Do not touch!
-     *
-     * Returns manifest/playlist object.
-     * null if the player is STOPPED.
-     * @returns {Manifest|null} - The current Manifest (`null` when not known).
-     */
-    // TODO remove the need for that public method
-    Player.prototype.__priv_getManifest = function () {
-        if (this._priv_contentInfos === null) {
-            return null;
-        }
-        return this._priv_contentInfos.manifest;
-    };
-    // TODO remove the need for that public method
-    Player.prototype.__priv_getCurrentAdaptation = function () {
-        if (this._priv_contentInfos === null) {
-            return null;
-        }
-        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeAdaptations = _a.activeAdaptations;
-        if (currentPeriod === null ||
-            activeAdaptations === null ||
-            isNullOrUndefined(activeAdaptations[currentPeriod.id])) {
-            return null;
-        }
-        return activeAdaptations[currentPeriod.id];
-    };
-    // TODO remove the need for that public method
-    Player.prototype.__priv_getCurrentRepresentations = function () {
-        if (this._priv_contentInfos === null) {
-            return null;
-        }
-        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeRepresentations = _a.activeRepresentations;
-        if (currentPeriod === null ||
-            activeRepresentations === null ||
-            isNullOrUndefined(activeRepresentations[currentPeriod.id])) {
-            return null;
-        }
-        return activeRepresentations[currentPeriod.id];
-    };
-    // ---- Private methods ----
     /**
      * Reset all state properties relative to a playing content.
      */
     Player.prototype._priv_cleanUpCurrentContentState = function () {
         var _this = this;
-        var _a, _b, _c, _d;
+        var _a, _b;
         log.debug("Locking `contentLock` to clean-up the current content.");
         // lock playback of new contents while cleaning up is pending
         this._priv_contentLock.setValue(true);
-        (_b = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.tracksStore) === null || _b === void 0 ? void 0 : _b.dispose();
-        (_d = (_c = this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.mediaElementTracksStore) === null || _d === void 0 ? void 0 : _d.dispose();
+        (_b = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.mediaElementTrackChoiceManager) === null || _b === void 0 ? void 0 : _b.dispose();
         this._priv_contentInfos = null;
         this._priv_contentEventsMemory = {};
         // DRM-related clean-up
@@ -1676,29 +1965,29 @@ var Player = /** @class */ (function (_super) {
         contentInfos.manifest = manifest;
         var cancelSignal = contentInfos.currentContentCanceller.signal;
         this._priv_reloadingMetadata.manifest = manifest;
-        contentInfos.tracksStore = new TracksStore({
+        var initialAudioTrack = contentInfos.initialAudioTrack, initialTextTrack = contentInfos.initialTextTrack;
+        contentInfos.trackChoiceManager = new TrackChoiceManager({
             preferTrickModeTracks: this._priv_preferTrickModeTracks,
-            defaultAudioTrackSwitchingMode: contentInfos.defaultAudioTrackSwitchingMode,
-        });
-        contentInfos.tracksStore.addEventListener("newAvailablePeriods", function (p) {
-            _this.trigger("newAvailablePeriods", p);
         });
-        contentInfos.tracksStore.addEventListener("brokenRepresentationsLock", function (e) {
-            _this.trigger("brokenRepresentationsLock", e);
-        });
-        contentInfos.tracksStore.addEventListener("trackUpdate", function (e) {
-            _this.trigger("trackUpdate", e);
-        });
-        contentInfos.tracksStore.updatePeriodList(manifest);
+        var preferredAudioTracks = initialAudioTrack === undefined ?
+            this._priv_preferredAudioTracks :
+            [initialAudioTrack];
+        contentInfos.trackChoiceManager.setPreferredAudioTracks(preferredAudioTracks, true);
+        var preferredTextTracks = initialTextTrack === undefined ?
+            this._priv_preferredTextTracks :
+            [initialTextTrack];
+        contentInfos.trackChoiceManager.setPreferredTextTracks(preferredTextTracks, true);
+        contentInfos.trackChoiceManager
+            .setPreferredVideoTracks(this._priv_preferredVideoTracks, true);
         manifest.addEventListener("manifestUpdate", function (updates) {
             var _a, _b, _c;
             // Update the tracks chosen if it changed
-            if (!isNullOrUndefined(contentInfos === null || contentInfos === void 0 ? void 0 : contentInfos.tracksStore)) {
-                contentInfos.tracksStore.updatePeriodList(manifest);
+            if (contentInfos.trackChoiceManager !== null) {
+                contentInfos.trackChoiceManager.update();
             }
             var currentPeriod = (_b = (_a = _this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.currentPeriod) !== null && _b !== void 0 ? _b : undefined;
-            var tracksStore = (_c = _this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.tracksStore;
-            if (currentPeriod === undefined || isNullOrUndefined(tracksStore)) {
+            var trackChoiceManager = (_c = _this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.trackChoiceManager;
+            if (currentPeriod === undefined || isNullOrUndefined(trackChoiceManager)) {
                 return;
             }
             for (var _i = 0, _d = updates.updatedPeriods; _i < _d.length; _i++) {
@@ -1707,15 +1996,11 @@ var Player = /** @class */ (function (_super) {
                     if (update.result.addedAdaptations.length > 0 ||
                         update.result.removedAdaptations.length > 0) {
                         // We might have new (or less) tracks, send events just to be sure
-                        var periodRef = tracksStore.getPeriodObjectFromPeriod(currentPeriod);
-                        if (periodRef === undefined) {
-                            return;
-                        }
-                        var audioTracks = tracksStore.getAvailableAudioTracks(periodRef);
+                        var audioTracks = trackChoiceManager.getAvailableAudioTracks(currentPeriod);
                         _this._priv_triggerEventIfNotStopped("availableAudioTracksChange", audioTracks !== null && audioTracks !== void 0 ? audioTracks : [], cancelSignal);
-                        var textTracks = tracksStore.getAvailableTextTracks(periodRef);
+                        var textTracks = trackChoiceManager.getAvailableTextTracks(currentPeriod);
                         _this._priv_triggerEventIfNotStopped("availableTextTracksChange", textTracks !== null && textTracks !== void 0 ? textTracks : [], cancelSignal);
-                        var videoTracks = tracksStore.getAvailableVideoTracks(periodRef);
+                        var videoTracks = trackChoiceManager.getAvailableVideoTracks(currentPeriod);
                         _this._priv_triggerEventIfNotStopped("availableVideoTracksChange", videoTracks !== null && videoTracks !== void 0 ? videoTracks : [], cancelSignal);
                     }
                 }
@@ -1731,7 +2016,7 @@ var Player = /** @class */ (function (_super) {
      * @param {Object} periodInfo
      */
     Player.prototype._priv_onActivePeriodChanged = function (contentInfos, _a) {
-        var _b, _c, _d, _e, _f, _g;
+        var _b, _c, _d, _e, _f, _g, _h, _j;
         var period = _a.period;
         if (contentInfos.contentId !== ((_b = this._priv_contentInfos) === null || _b === void 0 ? void 0 : _b.contentId)) {
             return; // Event for another content
@@ -1740,35 +2025,41 @@ var Player = /** @class */ (function (_super) {
         var cancelSignal = contentInfos.currentContentCanceller.signal;
         if (this._priv_contentEventsMemory.periodChange !== period) {
             this._priv_contentEventsMemory.periodChange = period;
-            this._priv_triggerEventIfNotStopped("periodChange", { start: period.start,
-                end: period.end,
-                id: period.id }, cancelSignal);
+            this._priv_triggerEventIfNotStopped("periodChange", period, cancelSignal);
         }
         this._priv_triggerEventIfNotStopped("availableAudioTracksChange", this.getAvailableAudioTracks(), cancelSignal);
         this._priv_triggerEventIfNotStopped("availableTextTracksChange", this.getAvailableTextTracks(), cancelSignal);
         this._priv_triggerEventIfNotStopped("availableVideoTracksChange", this.getAvailableVideoTracks(), cancelSignal);
-        var tracksStore = (_c = this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.tracksStore;
-        // Emit initial events for the Period
-        if (!isNullOrUndefined(tracksStore)) {
-            var periodRef = tracksStore.getPeriodObjectFromPeriod(period);
-            if (periodRef) {
-                var audioTrack = tracksStore.getChosenAudioTrack(periodRef);
-                this._priv_triggerEventIfNotStopped("audioTrackChange", audioTrack, cancelSignal);
-                var textTrack = tracksStore.getChosenTextTrack(periodRef);
-                this._priv_triggerEventIfNotStopped("textTrackChange", textTrack, cancelSignal);
-                var videoTrack = tracksStore.getChosenVideoTrack(periodRef);
-                this._priv_triggerEventIfNotStopped("videoTrackChange", videoTrack, cancelSignal);
-            }
+        var trackChoiceManager = (_c = this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.trackChoiceManager;
+        // Emit intial events for the Period
+        if (!isNullOrUndefined(trackChoiceManager)) {
+            var audioTrack = trackChoiceManager.getChosenAudioTrack(period);
+            this._priv_triggerEventIfNotStopped("audioTrackChange", audioTrack, cancelSignal);
+            var textTrack = trackChoiceManager.getChosenTextTrack(period);
+            this._priv_triggerEventIfNotStopped("textTrackChange", textTrack, cancelSignal);
+            var videoTrack = trackChoiceManager.getChosenVideoTrack(period);
+            this._priv_triggerEventIfNotStopped("videoTrackChange", videoTrack, cancelSignal);
         }
         else {
             this._priv_triggerEventIfNotStopped("audioTrackChange", null, cancelSignal);
             this._priv_triggerEventIfNotStopped("textTrackChange", null, cancelSignal);
             this._priv_triggerEventIfNotStopped("videoTrackChange", null, cancelSignal);
         }
-        var audioRepresentation = (_e = (_d = this.__priv_getCurrentRepresentations()) === null || _d === void 0 ? void 0 : _d.audio) !== null && _e !== void 0 ? _e : null;
-        this._priv_triggerEventIfNotStopped("audioRepresentationChange", audioRepresentation, cancelSignal);
-        var videoRepresentation = (_g = (_f = this.__priv_getCurrentRepresentations()) === null || _f === void 0 ? void 0 : _f.video) !== null && _g !== void 0 ? _g : null;
-        this._priv_triggerEventIfNotStopped("videoRepresentationChange", videoRepresentation, cancelSignal);
+        this._priv_triggerAvailableBitratesChangeEvent("availableAudioBitratesChange", this.getAvailableAudioBitrates(), cancelSignal);
+        if (contentInfos.currentContentCanceller.isUsed()) {
+            return;
+        }
+        this._priv_triggerAvailableBitratesChangeEvent("availableVideoBitratesChange", this.getAvailableVideoBitrates(), cancelSignal);
+        if (contentInfos.currentContentCanceller.isUsed()) {
+            return;
+        }
+        var audioBitrate = (_f = (_e = (_d = this._priv_getCurrentRepresentations()) === null || _d === void 0 ? void 0 : _d.audio) === null || _e === void 0 ? void 0 : _e.bitrate) !== null && _f !== void 0 ? _f : -1;
+        this._priv_triggerCurrentBitrateChangeEvent("audioBitrateChange", audioBitrate, cancelSignal);
+        if (contentInfos.currentContentCanceller.isUsed()) {
+            return;
+        }
+        var videoBitrate = (_j = (_h = (_g = this._priv_getCurrentRepresentations()) === null || _g === void 0 ? void 0 : _g.video) === null || _h === void 0 ? void 0 : _h.bitrate) !== null && _j !== void 0 ? _j : -1;
+        this._priv_triggerCurrentBitrateChangeEvent("videoBitrateChange", videoBitrate, cancelSignal);
     };
     /**
      * Triggered each times a new "PeriodStream" is ready.
@@ -1781,22 +2072,48 @@ var Player = /** @class */ (function (_super) {
         if (contentInfos.contentId !== ((_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.contentId)) {
             return; // Event for another content
         }
-        var type = value.type, manifest = value.manifest, period = value.period, adaptationRef = value.adaptationRef;
-        var tracksStore = contentInfos.tracksStore;
+        var type = value.type, period = value.period, adaptationRef = value.adaptationRef;
+        var trackChoiceManager = contentInfos.trackChoiceManager;
         switch (type) {
             case "video":
+                if (isNullOrUndefined(trackChoiceManager)) {
+                    log.error("API: TrackChoiceManager not instanciated for a new video period");
+                    adaptationRef.setValue(null);
+                }
+                else {
+                    trackChoiceManager.addPeriod(type, period, adaptationRef);
+                    trackChoiceManager.setInitialVideoTrack(period);
+                }
+                break;
             case "audio":
+                if (isNullOrUndefined(trackChoiceManager)) {
+                    log.error("API: TrackChoiceManager not instanciated for a new ".concat(type, " period"));
+                    adaptationRef.setValue(null);
+                }
+                else {
+                    trackChoiceManager.addPeriod(type, period, adaptationRef);
+                    trackChoiceManager.setInitialAudioTrack(period);
+                }
+                break;
             case "text":
-                if (isNullOrUndefined(tracksStore)) {
-                    log.error("API: TracksStore not instanciated for a new ".concat(type, " period"));
+                if (isNullOrUndefined(trackChoiceManager)) {
+                    log.error("API: TrackChoiceManager not instanciated for a new ".concat(type, " period"));
                     adaptationRef.setValue(null);
                 }
                 else {
-                    tracksStore.addTrackReference(type, manifest, period, adaptationRef);
+                    trackChoiceManager.addPeriod(type, period, adaptationRef);
+                    trackChoiceManager.setInitialTextTrack(period);
                 }
                 break;
             default:
-                assertUnreachable(type);
+                var adaptations = period.adaptations[type];
+                if (!isNullOrUndefined(adaptations) && adaptations.length > 0) {
+                    adaptationRef.setValue(adaptations[0]);
+                }
+                else {
+                    adaptationRef.setValue(null);
+                }
+                break;
         }
     };
     /**
@@ -1810,14 +2127,14 @@ var Player = /** @class */ (function (_super) {
             return; // Event for another content
         }
         var type = value.type, period = value.period;
-        var tracksStore = contentInfos.tracksStore;
-        // Clean-up track choices from TracksStore
+        var trackChoiceManager = contentInfos.trackChoiceManager;
+        // Clean-up track choice from TrackChoiceManager
         switch (type) {
             case "audio":
             case "text":
             case "video":
-                if (!isNullOrUndefined(tracksStore)) {
-                    tracksStore.removeTrackReference(type, period);
+                if (!isNullOrUndefined(trackChoiceManager)) {
+                    trackChoiceManager.removePeriod(type, period);
                 }
                 break;
         }
@@ -1866,27 +2183,27 @@ var Player = /** @class */ (function (_super) {
         else {
             activePeriodAdaptations[type] = adaptation;
         }
-        var tracksStore = contentInfos.tracksStore;
+        var trackChoiceManager = contentInfos.trackChoiceManager;
         var cancelSignal = contentInfos.currentContentCanceller.signal;
-        if (tracksStore !== null &&
+        if (trackChoiceManager !== null &&
             currentPeriod !== null && !isNullOrUndefined(period) &&
             period.id === currentPeriod.id) {
-            var periodRef = tracksStore.getPeriodObjectFromPeriod(period);
-            if (periodRef === undefined) {
-                return;
-            }
             switch (type) {
                 case "audio":
-                    var audioTrack = tracksStore.getChosenAudioTrack(periodRef);
+                    var audioTrack = trackChoiceManager.getChosenAudioTrack(currentPeriod);
                     this._priv_triggerEventIfNotStopped("audioTrackChange", audioTrack, cancelSignal);
+                    var availableAudioBitrates = this.getAvailableAudioBitrates();
+                    this._priv_triggerAvailableBitratesChangeEvent("availableAudioBitratesChange", availableAudioBitrates, cancelSignal);
                     break;
                 case "text":
-                    var textTrack = tracksStore.getChosenTextTrack(periodRef);
+                    var textTrack = trackChoiceManager.getChosenTextTrack(currentPeriod);
                     this._priv_triggerEventIfNotStopped("textTrackChange", textTrack, cancelSignal);
                     break;
                 case "video":
-                    var videoTrack = tracksStore.getChosenVideoTrack(periodRef);
+                    var videoTrack = trackChoiceManager.getChosenVideoTrack(currentPeriod);
                     this._priv_triggerEventIfNotStopped("videoTrackChange", videoTrack, cancelSignal);
+                    var availableVideoBitrates = this.getAvailableVideoBitrates();
+                    this._priv_triggerAvailableBitratesChangeEvent("availableVideoBitratesChange", availableVideoBitrates, cancelSignal);
                     break;
             }
         }
@@ -1901,7 +2218,7 @@ var Player = /** @class */ (function (_super) {
      */
     Player.prototype._priv_onRepresentationChange = function (contentInfos, _a) {
         var _b;
-        var _c;
+        var _c, _d;
         var type = _a.type, period = _a.period, representation = _a.representation;
         if (contentInfos.contentId !== ((_c = this._priv_contentInfos) === null || _c === void 0 ? void 0 : _c.contentId)) {
             return; // Event for another content
@@ -1918,15 +2235,16 @@ var Player = /** @class */ (function (_super) {
         else {
             activePeriodRepresentations[type] = representation;
         }
+        var bitrate = (_d = representation === null || representation === void 0 ? void 0 : representation.bitrate) !== null && _d !== void 0 ? _d : -1;
         if (!isNullOrUndefined(period) &&
             currentPeriod !== null &&
             currentPeriod.id === period.id) {
             var cancelSignal = this._priv_contentInfos.currentContentCanceller.signal;
             if (type === "video") {
-                this._priv_triggerEventIfNotStopped("videoRepresentationChange", representation, cancelSignal);
+                this._priv_triggerCurrentBitrateChangeEvent("videoBitrateChange", bitrate, cancelSignal);
             }
             else if (type === "audio") {
-                this._priv_triggerEventIfNotStopped("audioRepresentationChange", representation, cancelSignal);
+                this._priv_triggerCurrentBitrateChangeEvent("audioBitrateChange", bitrate, cancelSignal);
             }
         }
     };
@@ -1937,14 +2255,22 @@ var Player = /** @class */ (function (_super) {
      *
      * @param {Object} value
      */
-    Player.prototype._priv_onBitrateEstimateChange = function (_a) {
+    Player.prototype._priv_onBitrateEstimationChange = function (_a) {
         var type = _a.type, bitrate = _a.bitrate;
         if (bitrate !== undefined) {
             this._priv_bitrateInfos.lastBitrates[type] = bitrate;
         }
-        // !!! undocumented API :O !!!
-        /* eslint-disable-next-line */
-        this.trigger("__priv_bitrateEstimateChange", { type: type, bitrate: bitrate });
+        this.trigger("bitrateEstimationChange", { type: type, bitrate: bitrate });
+    };
+    /**
+     * Triggered each time a textTrack is added to the video DOM Element.
+     *
+     * Trigger the right Player Event.
+     *
+     * @param {Array.<TextTrackElement>} tracks
+     */
+    Player.prototype._priv_onNativeTextTracksNext = function (tracks) {
+        this.trigger("nativeTextTracksChange", tracks);
     };
     /**
      * Triggered each time the player state updates.
@@ -1983,7 +2309,7 @@ var Player = /** @class */ (function (_super) {
             position: observation.position,
             duration: observation.duration,
             playbackRate: observation.playbackRate,
-            maximumPosition: maximumPosition,
+            maximumBufferTime: maximumPosition,
             // TODO bufferGap may be undefined
             bufferGap: observation.bufferGap === undefined ||
                 !isFinite(observation.bufferGap) ?
@@ -2008,6 +2334,47 @@ var Player = /** @class */ (function (_super) {
         }
         this.trigger("positionUpdate", positionData);
     };
+    /**
+     * Trigger one of the "availableBitratesChange" event only if it changed from
+     * the previously stored value.
+     * @param {string} event
+     * @param {Array.<number>} newVal
+     * @param {Object} currentContentCancelSignal
+     */
+    Player.prototype._priv_triggerAvailableBitratesChangeEvent = function (event, newVal, currentContentCancelSignal) {
+        var prevVal = this._priv_contentEventsMemory[event];
+        if (!currentContentCancelSignal.isCancelled() &&
+            (prevVal === undefined || !areArraysOfNumbersEqual(newVal, prevVal))) {
+            this._priv_contentEventsMemory[event] = newVal;
+            this.trigger(event, newVal);
+        }
+    };
+    /**
+     * Trigger one of the "bitrateChange" event only if it changed from the
+     * previously stored value.
+     * @param {string} event
+     * @param {number} newVal
+     * @param {Object} currentContentCancelSignal
+     */
+    Player.prototype._priv_triggerCurrentBitrateChangeEvent = function (event, newVal, currentContentCancelSignal) {
+        if (!currentContentCancelSignal.isCancelled() &&
+            newVal !== this._priv_contentEventsMemory[event]) {
+            this._priv_contentEventsMemory[event] = newVal;
+            this.trigger(event, newVal);
+        }
+    };
+    Player.prototype._priv_getCurrentRepresentations = function () {
+        if (this._priv_contentInfos === null) {
+            return null;
+        }
+        var _a = this._priv_contentInfos, currentPeriod = _a.currentPeriod, activeRepresentations = _a.activeRepresentations;
+        if (currentPeriod === null ||
+            activeRepresentations === null ||
+            isNullOrUndefined(activeRepresentations[currentPeriod.id])) {
+            return null;
+        }
+        return activeRepresentations[currentPeriod.id];
+    };
     /**
      * @param {string} evt
      * @param {*} arg
@@ -2019,67 +2386,58 @@ var Player = /** @class */ (function (_super) {
         }
     };
     /**
+     * @param {Object} defaultAudioTrack
+     * @param {Object} defaultTextTrack
      * @param {Object} cancelSignal
      * @returns {Object}
      */
-    Player.prototype._priv_initializeMediaElementTracksStore = function (cancelSignal) {
+    Player.prototype._priv_initializeMediaElementTrackChoiceManager = function (defaultAudioTrack, defaultTextTrack, cancelSignal) {
         var _this = this;
         var _a, _b, _c;
-        assert(features.directfile !== null, "Initializing `MediaElementTracksStore` without Directfile feature");
-        assert(this.videoElement !== null, "Initializing `MediaElementTracksStore` on a disposed RxPlayer");
-        var mediaElementTracksStore = new features.directfile.mediaElementTracksStore(this.videoElement);
-        this._priv_triggerEventIfNotStopped("availableAudioTracksChange", mediaElementTracksStore.getAvailableAudioTracks(), cancelSignal);
-        this._priv_triggerEventIfNotStopped("availableVideoTracksChange", mediaElementTracksStore.getAvailableVideoTracks(), cancelSignal);
-        this._priv_triggerEventIfNotStopped("availableTextTracksChange", mediaElementTracksStore.getAvailableTextTracks(), cancelSignal);
-        this._priv_triggerEventIfNotStopped("audioTrackChange", (_a = mediaElementTracksStore.getChosenAudioTrack()) !== null && _a !== void 0 ? _a : null, cancelSignal);
-        this._priv_triggerEventIfNotStopped("textTrackChange", (_b = mediaElementTracksStore.getChosenTextTrack()) !== null && _b !== void 0 ? _b : null, cancelSignal);
-        this._priv_triggerEventIfNotStopped("videoTrackChange", (_c = mediaElementTracksStore.getChosenVideoTrack()) !== null && _c !== void 0 ? _c : null, cancelSignal);
-        mediaElementTracksStore
+        assert(features.directfile !== null, "Initializing `MediaElementTrackChoiceManager` without Directfile feature");
+        assert(this.videoElement !== null, "Initializing `MediaElementTrackChoiceManager` on a disposed RxPlayer");
+        var mediaElementTrackChoiceManager = new features.directfile.mediaElementTrackChoiceManager(this.videoElement);
+        var preferredAudioTracks = defaultAudioTrack === undefined ?
+            this._priv_preferredAudioTracks :
+            [defaultAudioTrack];
+        mediaElementTrackChoiceManager.setPreferredAudioTracks(preferredAudioTracks, true);
+        var preferredTextTracks = defaultTextTrack === undefined ?
+            this._priv_preferredTextTracks :
+            [defaultTextTrack];
+        mediaElementTrackChoiceManager.setPreferredTextTracks(preferredTextTracks, true);
+        mediaElementTrackChoiceManager
+            .setPreferredVideoTracks(this._priv_preferredVideoTracks, true);
+        this._priv_triggerEventIfNotStopped("availableAudioTracksChange", mediaElementTrackChoiceManager.getAvailableAudioTracks(), cancelSignal);
+        this._priv_triggerEventIfNotStopped("availableVideoTracksChange", mediaElementTrackChoiceManager.getAvailableVideoTracks(), cancelSignal);
+        this._priv_triggerEventIfNotStopped("availableTextTracksChange", mediaElementTrackChoiceManager.getAvailableTextTracks(), cancelSignal);
+        this._priv_triggerEventIfNotStopped("audioTrackChange", (_a = mediaElementTrackChoiceManager.getChosenAudioTrack()) !== null && _a !== void 0 ? _a : null, cancelSignal);
+        this._priv_triggerEventIfNotStopped("textTrackChange", (_b = mediaElementTrackChoiceManager.getChosenTextTrack()) !== null && _b !== void 0 ? _b : null, cancelSignal);
+        this._priv_triggerEventIfNotStopped("videoTrackChange", (_c = mediaElementTrackChoiceManager.getChosenVideoTrack()) !== null && _c !== void 0 ? _c : null, cancelSignal);
+        mediaElementTrackChoiceManager
             .addEventListener("availableVideoTracksChange", function (val) {
             return _this.trigger("availableVideoTracksChange", val);
         });
-        mediaElementTracksStore
+        mediaElementTrackChoiceManager
             .addEventListener("availableAudioTracksChange", function (val) {
             return _this.trigger("availableAudioTracksChange", val);
         });
-        mediaElementTracksStore
+        mediaElementTrackChoiceManager
             .addEventListener("availableTextTracksChange", function (val) {
             return _this.trigger("availableTextTracksChange", val);
         });
-        mediaElementTracksStore
+        mediaElementTrackChoiceManager
             .addEventListener("audioTrackChange", function (val) {
             return _this.trigger("audioTrackChange", val);
         });
-        mediaElementTracksStore
+        mediaElementTrackChoiceManager
             .addEventListener("videoTrackChange", function (val) {
             return _this.trigger("videoTrackChange", val);
         });
-        mediaElementTracksStore
+        mediaElementTrackChoiceManager
             .addEventListener("textTrackChange", function (val) {
             return _this.trigger("textTrackChange", val);
         });
-        return mediaElementTracksStore;
-    };
-    Player.prototype._priv_callTracksStoreGetterSetter = function (periodId, defaultValue, cb) {
-        var _a, _b;
-        if (this._priv_contentInfos === null ||
-            this._priv_contentInfos.tracksStore === null) {
-            log.warn("API: Trying to call track API too soon");
-            return defaultValue;
-        }
-        var tracksStore = this._priv_contentInfos.tracksStore;
-        var currentPeriod = (_b = (_a = this._priv_contentInfos) === null || _a === void 0 ? void 0 : _a.currentPeriod) !== null && _b !== void 0 ? _b : undefined;
-        var wantedPeriodId = periodId !== null && periodId !== void 0 ? periodId : currentPeriod === null || currentPeriod === void 0 ? void 0 : currentPeriod.id;
-        if (wantedPeriodId === undefined) {
-            return defaultValue;
-        }
-        var periodRef = wantedPeriodId === (currentPeriod === null || currentPeriod === void 0 ? void 0 : currentPeriod.id) ?
-            tracksStore.getPeriodObjectFromPeriod(currentPeriod) :
-            tracksStore.getPeriodObjectFromId(wantedPeriodId);
-        if (periodRef === undefined) {
-            return defaultValue;
-        }
-        return cb(tracksStore, periodRef);
+        return mediaElementTrackChoiceManager;
     };
     return Player;
 }(EventEmitter));