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

package/dist/_esm5.processed/core/api/{tracks_management/media_element_track_choice_manager.js → track_management/media_element_tracks_store.js}

@@ -34,6 +34,7 @@ var __extends = (this && this.__extends) || (function () {
  */
 import { enableAudioTrack } from "../../../compat";
 import EventEmitter from "../../../utils/event_emitter";
+import isNullOrUndefined from "../../../utils/is_null_or_undefined";
 import normalizeLanguage from "../../../utils/languages";
 /**
  * Check if track array is different from an other one
@@ -140,16 +141,13 @@ function createVideoTracks(videoTracks) {
 }
 /**
  * Manage video, audio and text tracks for current direct file content.
- * @class MediaElementTrackChoiceManager
+ * @class MediaElementTracksStore
  */
-var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
-    __extends(MediaElementTrackChoiceManager, _super);
-    function MediaElementTrackChoiceManager(mediaElement) {
+var MediaElementTracksStore = /** @class */ (function (_super) {
+    __extends(MediaElementTracksStore, _super);
+    function MediaElementTracksStore(mediaElement) {
         var _a, _b, _c;
         var _this = _super.call(this) || this;
-        _this._preferredAudioTracks = [];
-        _this._preferredTextTracks = [];
-        _this._preferredVideoTracks = [];
         // TODO In practice, the audio/video/text tracks API are not always implemented on
         // the media element, although Typescript HTMLMediaElement types tend to mean
         // that can't be undefined.
@@ -165,58 +163,19 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
         _this._textTracks =
             _this._nativeTextTracks !== undefined ? createTextTracks(_this._nativeTextTracks) :
                 [];
-        _this._lastEmittedNativeAudioTrack = (_a = _this._getPrivateChosenAudioTrack()) === null || _a === void 0 ? void 0 : _a.nativeTrack;
-        _this._lastEmittedNativeVideoTrack = (_b = _this._getPrivateChosenVideoTrack()) === null || _b === void 0 ? void 0 : _b.nativeTrack;
-        _this._lastEmittedNativeTextTrack = (_c = _this._getPrivateChosenTextTrack()) === null || _c === void 0 ? void 0 : _c.nativeTrack;
+        _this._lastEmittedNativeAudioTrack = (_a = _this._getCurrentAudioTrack()) === null || _a === void 0 ? void 0 : _a.nativeTrack;
+        _this._lastEmittedNativeVideoTrack = (_b = _this._getCurrentVideoTrack()) === null || _b === void 0 ? void 0 : _b.nativeTrack;
+        _this._lastEmittedNativeTextTrack = (_c = _this._getCurrentTextTrack()) === null || _c === void 0 ? void 0 : _c.nativeTrack;
         _this._handleNativeTracksCallbacks();
         return _this;
     }
-    /**
-     * Set the list of preferred audio tracks, in preference order.
-     * @param {Array.<Object>} preferredAudioTracks
-     * @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.
-     */
-    MediaElementTrackChoiceManager.prototype.setPreferredAudioTracks = function (preferredAudioTracks, shouldApply) {
-        this._preferredAudioTracks = preferredAudioTracks;
-        if (shouldApply) {
-            this._applyAudioPreferences();
-        }
-    };
-    /**
-     * Set the list of preferred text tracks, in preference order.
-     * @param {Array.<Object>} preferredTextTracks
-     * @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.
-     */
-    MediaElementTrackChoiceManager.prototype.setPreferredTextTracks = function (preferredTextTracks, shouldApply) {
-        this._preferredTextTracks = preferredTextTracks;
-        if (shouldApply) {
-            this._applyTextPreferences();
-        }
-    };
-    /**
-     * Set the list of preferred video tracks, in preference order.
-     * @param {Array.<Object>} preferredVideoTracks
-     * @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.
-     */
-    MediaElementTrackChoiceManager.prototype.setPreferredVideoTracks = function (preferredVideoTracks, shouldApply) {
-        this._preferredVideoTracks = preferredVideoTracks;
-        if (shouldApply) {
-            this._applyVideoPreferences();
-        }
-    };
     /**
      * Update the currently active audio track by setting the wanted audio track's
      * ID property.
      * Throws if the wanted audio track is not found.
      * @param {string|number|undefined} id
      */
-    MediaElementTrackChoiceManager.prototype.setAudioTrackById = function (id) {
+    MediaElementTracksStore.prototype.setAudioTrackById = function (id) {
         for (var i = 0; i < this._audioTracks.length; i++) {
             var _a = this._audioTracks[i], track = _a.track, nativeTrack = _a.nativeTrack;
             if (track.id === id) {
@@ -230,7 +189,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
     /**
      * Disable the currently-active text track, if one.
      */
-    MediaElementTrackChoiceManager.prototype.disableTextTrack = function () {
+    MediaElementTracksStore.prototype.disableTextTrack = function () {
         disableTextTracks(this._textTracks);
         this._textTrackLockedOn = null;
     };
@@ -240,7 +199,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Throws if the wanted text track is not found.
      * @param {string|number|undefined} id
      */
-    MediaElementTrackChoiceManager.prototype.setTextTrackById = function (id) {
+    MediaElementTracksStore.prototype.setTextTrackById = function (id) {
         var hasSetTrack = false;
         for (var i = 0; i < this._textTracks.length; i++) {
             var _a = this._textTracks[i], track = _a.track, nativeTrack = _a.nativeTrack;
@@ -260,7 +219,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
     /**
      * Disable the currently-active video track, if one.
      */
-    MediaElementTrackChoiceManager.prototype.disableVideoTrack = function () {
+    MediaElementTracksStore.prototype.disableVideoTrack = function () {
         disableVideoTracks(this._videoTracks);
         this._videoTrackLockedOn = null;
     };
@@ -270,7 +229,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Throws if the wanted video track is not found.
      * @param {string|number|undefined} id
      */
-    MediaElementTrackChoiceManager.prototype.setVideoTrackById = function (id) {
+    MediaElementTracksStore.prototype.setVideoTrackById = function (id) {
         for (var i = 0; i < this._videoTracks.length; i++) {
             var _a = this._videoTracks[i], track = _a.track, nativeTrack = _a.nativeTrack;
             if (track.id === id) {
@@ -287,12 +246,11 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which audio track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTrackChoiceManager.prototype.getChosenAudioTrack = function () {
-        var chosenPrivateAudioTrack = this._getPrivateChosenAudioTrack();
-        if (chosenPrivateAudioTrack != null) {
-            return chosenPrivateAudioTrack.track;
-        }
-        return chosenPrivateAudioTrack;
+    MediaElementTracksStore.prototype.getChosenAudioTrack = function () {
+        var currentAudioTrack = this._getCurrentAudioTrack();
+        return isNullOrUndefined(currentAudioTrack) ?
+            currentAudioTrack :
+            currentAudioTrack.track;
     };
     /**
      * Returns the currently active text track.
@@ -300,12 +258,11 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which text track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTrackChoiceManager.prototype.getChosenTextTrack = function () {
-        var chosenPrivateTextTrack = this._getPrivateChosenTextTrack();
-        if (chosenPrivateTextTrack != null) {
-            return chosenPrivateTextTrack.track;
-        }
-        return chosenPrivateTextTrack;
+    MediaElementTracksStore.prototype.getChosenTextTrack = function () {
+        var currentTextTrack = this._getCurrentTextTrack();
+        return isNullOrUndefined(currentTextTrack) ?
+            currentTextTrack :
+            currentTextTrack.track;
     };
     /**
      * Returns the currently active video track.
@@ -313,18 +270,17 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which video track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTrackChoiceManager.prototype.getChosenVideoTrack = function () {
-        var chosenPrivateVideoTrack = this._getPrivateChosenVideoTrack();
-        if (chosenPrivateVideoTrack != null) {
-            return chosenPrivateVideoTrack.track;
-        }
-        return chosenPrivateVideoTrack;
+    MediaElementTracksStore.prototype.getChosenVideoTrack = function () {
+        var currentVideoTrack = this._getCurrentVideoTrack();
+        return isNullOrUndefined(currentVideoTrack) ?
+            currentVideoTrack :
+            currentVideoTrack.track;
     };
     /**
      * Returns a description of every available audio tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTrackChoiceManager.prototype.getAvailableAudioTracks = function () {
+    MediaElementTracksStore.prototype.getAvailableAudioTracks = function () {
         return this._audioTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -339,7 +295,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Returns a description of every available text tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTrackChoiceManager.prototype.getAvailableTextTracks = function () {
+    MediaElementTracksStore.prototype.getAvailableTextTracks = function () {
         return this._textTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -355,7 +311,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * Returns a description of every available video tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTrackChoiceManager.prototype.getAvailableVideoTracks = function () {
+    MediaElementTracksStore.prototype.getAvailableVideoTracks = function () {
         return this._videoTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -364,9 +320,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
         });
     };
     /**
-     * Free the resources used by the MediaElementTrackChoiceManager.
+     * Free the resources used by the MediaElementTracksStore.
      */
-    MediaElementTrackChoiceManager.prototype.dispose = function () {
+    MediaElementTracksStore.prototype.dispose = function () {
         if (this._nativeVideoTracks !== undefined) {
             this._nativeVideoTracks.onchange = null;
             this._nativeVideoTracks.onaddtrack = null;
@@ -390,7 +346,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * `null` if no audio track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTrackChoiceManager.prototype._getPrivateChosenAudioTrack = function () {
+    MediaElementTracksStore.prototype._getCurrentAudioTrack = function () {
         if (this._nativeAudioTracks === undefined) {
             return undefined;
         }
@@ -408,7 +364,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * `null` if no video track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTrackChoiceManager.prototype._getPrivateChosenVideoTrack = function () {
+    MediaElementTracksStore.prototype._getCurrentVideoTrack = function () {
         if (this._nativeVideoTracks === undefined) {
             return undefined;
         }
@@ -426,7 +382,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * `null` if no text track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTrackChoiceManager.prototype._getPrivateChosenTextTrack = function () {
+    MediaElementTracksStore.prototype._getCurrentTextTrack = function () {
         if (this._nativeTextTracks === undefined) {
             return undefined;
         }
@@ -441,12 +397,19 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
     /**
      * Iterate over every available audio tracks on the media element and either:
      *   - if the last manually set audio track is found, set that one.
-     *   - if not, set the most preferred one
      *   - if we still do not find an optimal track, let the one chosen by default
      */
-    MediaElementTrackChoiceManager.prototype._setOptimalAudioTrack = function () {
-        // First check if the last set track is available, set it if that's the case
-        if (this._audioTrackLockedOn !== undefined) {
+    MediaElementTracksStore.prototype._setPreviouslyLockedAudioTrack = function () {
+        if (this._audioTrackLockedOn === undefined) {
+            return;
+        }
+        else if (this._audioTrackLockedOn === null) {
+            for (var i = 0; i < this._audioTracks.length; i++) {
+                var nativeTrack = this._audioTracks[i].nativeTrack;
+                nativeTrack.enabled = false;
+            }
+        }
+        else {
             for (var i = 0; i < this._audioTracks.length; i++) {
                 var nativeTrack = this._audioTracks[i].nativeTrack;
                 if (nativeTrack === this._audioTrackLockedOn) {
@@ -455,46 +418,21 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                 }
             }
         }
-        this._applyAudioPreferences();
-    };
-    /**
-     * Try to find a track corresponding to the audio track preferences:
-     *   - if found, set it as the active track
-     *   - if not found, let the chosen audio track by default
-     */
-    MediaElementTrackChoiceManager.prototype._applyAudioPreferences = function () {
-        // Re-set the last manually set audio track
-        this._audioTrackLockedOn = undefined;
-        var preferredAudioTracks = this._preferredAudioTracks;
-        for (var i = 0; i < preferredAudioTracks.length; i++) {
-            var track = preferredAudioTracks[i];
-            if (track !== null && track.language !== undefined) {
-                var normalized = normalizeLanguage(track.language);
-                for (var j = 0; j < this._audioTracks.length; j++) {
-                    var audioTrack = this._audioTracks[j];
-                    if (audioTrack.track.normalized === normalized &&
-                        audioTrack.track.audioDescription === track.audioDescription) {
-                        this._enableAudioTrackFromIndex(j);
-                        return;
-                    }
-                }
-            }
-        }
-        // else just let the default one instead
     };
     /**
      * Iterate over every available text tracks on the media element and either:
      *   - if the last manually set text track is found, set that one.
-     *   - if not, set the most preferred one
      *   - if we still do not find an optimal track, just disable it.
      */
-    MediaElementTrackChoiceManager.prototype._setOptimalTextTrack = function () {
-        // First check if the last set track is available, set it if that's the case
-        if (this._textTrackLockedOn === null) {
+    MediaElementTracksStore.prototype._setPreviouslyLockedTextTrack = function () {
+        if (this._textTrackLockedOn === undefined) {
+            return;
+        }
+        else if (this._textTrackLockedOn === null) {
             disableTextTracks(this._textTracks);
             return;
         }
-        else if (this._textTrackLockedOn !== undefined) {
+        else {
             for (var i = 0; i < this._textTracks.length; i++) {
                 var nativeTrack = this._textTracks[i].nativeTrack;
                 if (nativeTrack === this._textTrackLockedOn) {
@@ -507,54 +445,21 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                 }
             }
         }
-        // Else set the preferred one
-        this._applyTextPreferences();
-    };
-    /**
-     * Try to find a track corresponding to the text track preferences:
-     *   - if found, set it as the active track
-     *   - if not found, let the chosen text track by default
-     */
-    MediaElementTrackChoiceManager.prototype._applyTextPreferences = function () {
-        // Re-set the last manually set audio track
-        this._textTrackLockedOn = undefined;
-        var preferredTextTracks = this._preferredTextTracks;
-        for (var i = 0; i < preferredTextTracks.length; i++) {
-            var track = preferredTextTracks[i];
-            if (track === null) {
-                disableTextTracks(this._textTracks);
-                return;
-            }
-            var normalized = normalizeLanguage(track.language);
-            for (var j = 0; j < this._textTracks.length; j++) {
-                var textTrack = this._textTracks[j];
-                if (textTrack.track.normalized === normalized &&
-                    textTrack.track.closedCaption === track.closedCaption) {
-                    // disable the rest
-                    disableAllTextTracksBut(this._textTracks, textTrack.nativeTrack);
-                    if (textTrack.nativeTrack.mode !== "showing") {
-                        textTrack.nativeTrack.mode = "showing";
-                    }
-                    return;
-                }
-            }
-        }
-        // Else just disable text tracks
-        disableTextTracks(this._textTracks);
     };
     /**
      * Iterate over every available video tracks on the media element and either:
      *   - if the last manually set video track is found, set that one.
-     *   - if not, set the most preferred one
      *   - if we still do not find an optimal track, let the one chosen by default
      */
-    MediaElementTrackChoiceManager.prototype._setOptimalVideoTrack = function () {
-        // 1. first check if the last set track is available, set it if that's the case
-        if (this._videoTrackLockedOn === null) {
+    MediaElementTracksStore.prototype._setPreviouslyLockedVideoTrack = function () {
+        if (this._videoTrackLockedOn === undefined) {
+            return;
+        }
+        else if (this._videoTrackLockedOn === null) {
             disableVideoTracks(this._videoTracks);
             return;
         }
-        else if (this._videoTrackLockedOn !== undefined) {
+        else {
             for (var i = 0; i < this._videoTracks.length; i++) {
                 var nativeTrack = this._videoTracks[i].nativeTrack;
                 if (nativeTrack === this._videoTrackLockedOn) {
@@ -563,36 +468,12 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                 }
             }
         }
-        // Else set the preferred one
-        this._applyVideoPreferences();
-    };
-    /**
-     * Try to find a track corresponding to the text track preferences:
-     *   - if found, set it as the active track
-     *   - if not found, let the chosen text track by default
-     */
-    MediaElementTrackChoiceManager.prototype._applyVideoPreferences = function () {
-        // Re-set the last manually set video track
-        this._videoTrackLockedOn = undefined;
-        // NOTE: As we cannot access either codec information or sign interpretation
-        // information easily about the different codecs. It is the same case than
-        // if we had only tracks where those were set to undefined.
-        // Based on that, we should disable the video track as long as one of the
-        // set preferrence is "no video track" (i.e. `null`) as this is the only
-        // constraint that we know we can respect.
-        // Else, just chose the first track.
-        var preferredVideoTracks = this._preferredVideoTracks;
-        var hasNullPreference = preferredVideoTracks.some(function (p) { return p === null; });
-        if (hasNullPreference) {
-            disableVideoTracks(this._videoTracks);
-        }
-        // else just let the default one instead
     };
     /**
      * Monitor native tracks add, remove and change callback and trigger the
      * change events.
      */
-    MediaElementTrackChoiceManager.prototype._handleNativeTracksCallbacks = function () {
+    MediaElementTracksStore.prototype._handleNativeTracksCallbacks = function () {
         var _this = this;
         if (this._nativeAudioTracks !== undefined) {
             this._nativeAudioTracks.onaddtrack = function () {
@@ -601,9 +482,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     var newAudioTracks = createAudioTracks(_this._nativeAudioTracks);
                     if (areTrackArraysDifferent(_this._audioTracks, newAudioTracks)) {
                         _this._audioTracks = newAudioTracks;
-                        _this._setOptimalAudioTrack();
+                        _this._setPreviouslyLockedAudioTrack();
                         _this.trigger("availableAudioTracksChange", _this.getAvailableAudioTracks());
-                        var chosenAudioTrack = _this._getPrivateChosenAudioTrack();
+                        var chosenAudioTrack = _this._getCurrentAudioTrack();
                         if ((chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.nativeTrack) !== _this._lastEmittedNativeAudioTrack) {
                             _this.trigger("audioTrackChange", (_a = chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeAudioTrack = (_b = chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -618,7 +499,7 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     if (areTrackArraysDifferent(_this._audioTracks, newAudioTracks)) {
                         _this._audioTracks = newAudioTracks;
                         _this.trigger("availableAudioTracksChange", _this.getAvailableAudioTracks());
-                        var chosenAudioTrack = _this._getPrivateChosenAudioTrack();
+                        var chosenAudioTrack = _this._getCurrentAudioTrack();
                         if ((chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.nativeTrack) !== _this._lastEmittedNativeAudioTrack) {
                             _this.trigger("audioTrackChange", (_a = chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeAudioTrack = (_b = chosenAudioTrack === null || chosenAudioTrack === void 0 ? void 0 : chosenAudioTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -653,9 +534,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     var newTextTracks = createTextTracks(_this._nativeTextTracks);
                     if (areTrackArraysDifferent(_this._textTracks, newTextTracks)) {
                         _this._textTracks = newTextTracks;
-                        _this._setOptimalTextTrack();
+                        _this._setPreviouslyLockedTextTrack();
                         _this.trigger("availableTextTracksChange", _this.getAvailableTextTracks());
-                        var chosenTextTrack = _this._getPrivateChosenTextTrack();
+                        var chosenTextTrack = _this._getCurrentTextTrack();
                         if ((chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.nativeTrack) !== _this._lastEmittedNativeTextTrack) {
                             _this.trigger("textTrackChange", (_a = chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeTextTrack = (_b = chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -669,9 +550,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     var newTextTracks = createTextTracks(_this._nativeTextTracks);
                     if (areTrackArraysDifferent(_this._textTracks, newTextTracks)) {
                         _this._textTracks = newTextTracks;
-                        _this._setOptimalTextTrack();
+                        _this._setPreviouslyLockedTextTrack();
                         _this.trigger("availableTextTracksChange", _this.getAvailableTextTracks());
-                        var chosenTextTrack = _this._getPrivateChosenTextTrack();
+                        var chosenTextTrack = _this._getCurrentTextTrack();
                         if ((chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.nativeTrack) !== _this._lastEmittedNativeTextTrack) {
                             _this.trigger("textTrackChange", (_a = chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeTextTrack = (_b = chosenTextTrack === null || chosenTextTrack === void 0 ? void 0 : chosenTextTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -706,9 +587,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     var newVideoTracks = createVideoTracks(_this._nativeVideoTracks);
                     if (areTrackArraysDifferent(_this._videoTracks, newVideoTracks)) {
                         _this._videoTracks = newVideoTracks;
-                        _this._setOptimalVideoTrack();
+                        _this._setPreviouslyLockedVideoTrack();
                         _this.trigger("availableVideoTracksChange", _this.getAvailableVideoTracks());
-                        var chosenVideoTrack = _this._getPrivateChosenVideoTrack();
+                        var chosenVideoTrack = _this._getCurrentVideoTrack();
                         if ((chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.nativeTrack) !== _this._lastEmittedNativeVideoTrack) {
                             _this.trigger("videoTrackChange", (_a = chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeVideoTrack = (_b = chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -722,9 +603,9 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
                     var newVideoTracks = createVideoTracks(_this._nativeVideoTracks);
                     if (areTrackArraysDifferent(_this._videoTracks, newVideoTracks)) {
                         _this._videoTracks = newVideoTracks;
-                        _this._setOptimalVideoTrack();
+                        _this._setPreviouslyLockedVideoTrack();
                         _this.trigger("availableVideoTracksChange", _this.getAvailableVideoTracks());
-                        var chosenVideoTrack = _this._getPrivateChosenVideoTrack();
+                        var chosenVideoTrack = _this._getCurrentVideoTrack();
                         if ((chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.nativeTrack) !== _this._lastEmittedNativeVideoTrack) {
                             _this.trigger("videoTrackChange", (_a = chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.track) !== null && _a !== void 0 ? _a : null);
                             _this._lastEmittedNativeVideoTrack = (_b = chosenVideoTrack === null || chosenVideoTrack === void 0 ? void 0 : chosenVideoTrack.nativeTrack) !== null && _b !== void 0 ? _b : null;
@@ -758,15 +639,15 @@ var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
      * `this._audioTracks` array.
      * @param {number} index}
      */
-    MediaElementTrackChoiceManager.prototype._enableAudioTrackFromIndex = function (index) {
+    MediaElementTracksStore.prototype._enableAudioTrackFromIndex = function (index) {
         enableAudioTrack(this._audioTracks.map(function (_a) {
             var nativeTrack = _a.nativeTrack;
             return nativeTrack;
         }), index);
     };
-    return MediaElementTrackChoiceManager;
+    return MediaElementTracksStore;
 }(EventEmitter));
-export default MediaElementTrackChoiceManager;
+export default MediaElementTracksStore;
 /**
  * Disable all text track elements in the given array from showing.
  * @param {Array.<Object>} textTracks

package/dist/_esm5.processed/core/api/track_management/track_dispatcher.d.ts

@@ -0,0 +1,84 @@
+import Manifest, { Adaptation } from "../../../manifest";
+import EventEmitter from "../../../utils/event_emitter";
+import SharedReference, { IReadOnlySharedReference } from "../../../utils/reference";
+import { IAdaptationChoice, IRepresentationsChoice, ITrackSwitchingMode } from "../../stream";
+/**
+ * Class handling track changes and quality locking for a single Period and
+ * Adaptation type.
+ * @class TrackDispatcher
+ */
+export default class TrackDispatcher extends EventEmitter<ITrackDispatcherEvent> {
+    /**
+     * `Manifest` object linked to the current content handled by the
+     * `TrackDispatcher`.
+     * Needed to subscribe to various events.
+     */
+    private readonly _manifest;
+    /**
+     * Reference through which the wanted track will be emitted.
+     * `null` is emitted if no track for that type is wanted.
+     */
+    private readonly _adaptationRef;
+    /**
+     * Last values emitted through `adaptationRef`.
+     * This value is mutated just before `adaptationRef` is "nexted".
+     *
+     * Storing this information allows to detect if some potential
+     * side-effects already led to the "nexting" of `adaptationRef` with the wanted
+     * settings, preventing the the `TrackDispatcher` from doing it again.
+     */
+    private _lastEmitted;
+    /** Interface allowing to clean-up resources when they are not needed anymore. */
+    private _canceller;
+    /**
+     * Create a new `TrackDispatcher` by giving its Reference and an initial track
+     * setting.
+     * This constructor will update the Reference with the right preferences
+     * synchronously.
+     * @param {Object} manifest
+     * @param {Object} adaptationRef
+     * @param {Object|null} initialTrackInfo
+     */
+    constructor(manifest: Manifest, adaptationRef: SharedReference<IAdaptationChoice | null | undefined>, initialTrackInfo: ITrackSetting | null);
+    /**
+     * Update the wanted track on the Reference linked to this `TrackDispatcher`.
+     * @param {Object|null} newTrackInfo
+     */
+    updateTrack(newTrackInfo: ITrackSetting | null): void;
+    /**
+     * Create a shared reference which will emit the wanted locked Representations
+     * based on the current capabilities and the last user settings.
+     *
+     * @param {Object} trackInfo
+     * @returns {Object}
+     */
+    private _constructLockedRepresentationsReference;
+    /**
+     * Free the resources (e.g. `Manifest` event listeners) linked to this
+     * `TrackDispatcher`.
+     */
+    dispose(): void;
+}
+export interface ITrackDispatcherEvent {
+    /**
+     * Event sent when given locked Representations cannot be respected because
+     * none of them are currently "playable".
+     */
+    noPlayableLockedRepresentation: null;
+}
+/** Define a new Track preference given to the `TrackDispatcher`. */
+export interface ITrackSetting {
+    /** Contains the `Adaptation` wanted by the user. */
+    adaptation: Adaptation;
+    /** "Switching mode" in which the track switch should happen. */
+    switchingMode: ITrackSwitchingMode;
+    /**
+     * Contains the last locked `Representation`s for this `Adaptation` wanted
+     * by the user.
+     * `null` if no Representation is locked.
+     *
+     * Can be updated continuously while the `TrackDispatcher` is in possession
+     * of this shared reference.
+     */
+    lockedRepresentations: IReadOnlySharedReference<IRepresentationsChoice | null>;
+}