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

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

@@ -34,7 +34,6 @@ 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
@@ -141,13 +140,16 @@ function createVideoTracks(videoTracks) {
 }
 /**
  * Manage video, audio and text tracks for current direct file content.
- * @class MediaElementTracksStore
+ * @class MediaElementTrackChoiceManager
  */
-var MediaElementTracksStore = /** @class */ (function (_super) {
-    __extends(MediaElementTracksStore, _super);
-    function MediaElementTracksStore(mediaElement) {
+var MediaElementTrackChoiceManager = /** @class */ (function (_super) {
+    __extends(MediaElementTrackChoiceManager, _super);
+    function MediaElementTrackChoiceManager(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.
@@ -163,19 +165,58 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
         _this._textTracks =
             _this._nativeTextTracks !== undefined ? createTextTracks(_this._nativeTextTracks) :
                 [];
-        _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._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._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
      */
-    MediaElementTracksStore.prototype.setAudioTrackById = function (id) {
+    MediaElementTrackChoiceManager.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) {
@@ -189,7 +230,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
     /**
      * Disable the currently-active text track, if one.
      */
-    MediaElementTracksStore.prototype.disableTextTrack = function () {
+    MediaElementTrackChoiceManager.prototype.disableTextTrack = function () {
         disableTextTracks(this._textTracks);
         this._textTrackLockedOn = null;
     };
@@ -199,7 +240,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Throws if the wanted text track is not found.
      * @param {string|number|undefined} id
      */
-    MediaElementTracksStore.prototype.setTextTrackById = function (id) {
+    MediaElementTrackChoiceManager.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;
@@ -219,7 +260,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
     /**
      * Disable the currently-active video track, if one.
      */
-    MediaElementTracksStore.prototype.disableVideoTrack = function () {
+    MediaElementTrackChoiceManager.prototype.disableVideoTrack = function () {
         disableVideoTracks(this._videoTracks);
         this._videoTrackLockedOn = null;
     };
@@ -229,7 +270,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Throws if the wanted video track is not found.
      * @param {string|number|undefined} id
      */
-    MediaElementTracksStore.prototype.setVideoTrackById = function (id) {
+    MediaElementTrackChoiceManager.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) {
@@ -246,11 +287,12 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which audio track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTracksStore.prototype.getChosenAudioTrack = function () {
-        var currentAudioTrack = this._getCurrentAudioTrack();
-        return isNullOrUndefined(currentAudioTrack) ?
-            currentAudioTrack :
-            currentAudioTrack.track;
+    MediaElementTrackChoiceManager.prototype.getChosenAudioTrack = function () {
+        var chosenPrivateAudioTrack = this._getPrivateChosenAudioTrack();
+        if (chosenPrivateAudioTrack != null) {
+            return chosenPrivateAudioTrack.track;
+        }
+        return chosenPrivateAudioTrack;
     };
     /**
      * Returns the currently active text track.
@@ -258,11 +300,12 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which text track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTracksStore.prototype.getChosenTextTrack = function () {
-        var currentTextTrack = this._getCurrentTextTrack();
-        return isNullOrUndefined(currentTextTrack) ?
-            currentTextTrack :
-            currentTextTrack.track;
+    MediaElementTrackChoiceManager.prototype.getChosenTextTrack = function () {
+        var chosenPrivateTextTrack = this._getPrivateChosenTextTrack();
+        if (chosenPrivateTextTrack != null) {
+            return chosenPrivateTextTrack.track;
+        }
+        return chosenPrivateTextTrack;
     };
     /**
      * Returns the currently active video track.
@@ -270,17 +313,18 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Returns `undefined` if we cannot know which video track is active.
      * @returns {Object|null|undefined}
      */
-    MediaElementTracksStore.prototype.getChosenVideoTrack = function () {
-        var currentVideoTrack = this._getCurrentVideoTrack();
-        return isNullOrUndefined(currentVideoTrack) ?
-            currentVideoTrack :
-            currentVideoTrack.track;
+    MediaElementTrackChoiceManager.prototype.getChosenVideoTrack = function () {
+        var chosenPrivateVideoTrack = this._getPrivateChosenVideoTrack();
+        if (chosenPrivateVideoTrack != null) {
+            return chosenPrivateVideoTrack.track;
+        }
+        return chosenPrivateVideoTrack;
     };
     /**
      * Returns a description of every available audio tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTracksStore.prototype.getAvailableAudioTracks = function () {
+    MediaElementTrackChoiceManager.prototype.getAvailableAudioTracks = function () {
         return this._audioTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -295,7 +339,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Returns a description of every available text tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTracksStore.prototype.getAvailableTextTracks = function () {
+    MediaElementTrackChoiceManager.prototype.getAvailableTextTracks = function () {
         return this._textTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -311,7 +355,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * Returns a description of every available video tracks.
      * @returns {Array.<Object>}
      */
-    MediaElementTracksStore.prototype.getAvailableVideoTracks = function () {
+    MediaElementTrackChoiceManager.prototype.getAvailableVideoTracks = function () {
         return this._videoTracks.map(function (_a) {
             var track = _a.track, nativeTrack = _a.nativeTrack;
             return { id: track.id,
@@ -320,9 +364,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
         });
     };
     /**
-     * Free the resources used by the MediaElementTracksStore.
+     * Free the resources used by the MediaElementTrackChoiceManager.
      */
-    MediaElementTracksStore.prototype.dispose = function () {
+    MediaElementTrackChoiceManager.prototype.dispose = function () {
         if (this._nativeVideoTracks !== undefined) {
             this._nativeVideoTracks.onchange = null;
             this._nativeVideoTracks.onaddtrack = null;
@@ -346,7 +390,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * `null` if no audio track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTracksStore.prototype._getCurrentAudioTrack = function () {
+    MediaElementTrackChoiceManager.prototype._getPrivateChosenAudioTrack = function () {
         if (this._nativeAudioTracks === undefined) {
             return undefined;
         }
@@ -364,7 +408,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * `null` if no video track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTracksStore.prototype._getCurrentVideoTrack = function () {
+    MediaElementTrackChoiceManager.prototype._getPrivateChosenVideoTrack = function () {
         if (this._nativeVideoTracks === undefined) {
             return undefined;
         }
@@ -382,7 +426,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * `null` if no text track is chosen.
      * @returns {Object|undefined|null}
      */
-    MediaElementTracksStore.prototype._getCurrentTextTrack = function () {
+    MediaElementTrackChoiceManager.prototype._getPrivateChosenTextTrack = function () {
         if (this._nativeTextTracks === undefined) {
             return undefined;
         }
@@ -397,19 +441,12 @@ var MediaElementTracksStore = /** @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
      */
-    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 {
+    MediaElementTrackChoiceManager.prototype._setOptimalAudioTrack = function () {
+        // First check if the last set track is available, set it if that's the case
+        if (this._audioTrackLockedOn !== undefined) {
             for (var i = 0; i < this._audioTracks.length; i++) {
                 var nativeTrack = this._audioTracks[i].nativeTrack;
                 if (nativeTrack === this._audioTrackLockedOn) {
@@ -418,21 +455,46 @@ var MediaElementTracksStore = /** @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.
      */
-    MediaElementTracksStore.prototype._setPreviouslyLockedTextTrack = function () {
-        if (this._textTrackLockedOn === undefined) {
-            return;
-        }
-        else if (this._textTrackLockedOn === null) {
+    MediaElementTrackChoiceManager.prototype._setOptimalTextTrack = function () {
+        // First check if the last set track is available, set it if that's the case
+        if (this._textTrackLockedOn === null) {
             disableTextTracks(this._textTracks);
             return;
         }
-        else {
+        else if (this._textTrackLockedOn !== undefined) {
             for (var i = 0; i < this._textTracks.length; i++) {
                 var nativeTrack = this._textTracks[i].nativeTrack;
                 if (nativeTrack === this._textTrackLockedOn) {
@@ -445,21 +507,54 @@ var MediaElementTracksStore = /** @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
      */
-    MediaElementTracksStore.prototype._setPreviouslyLockedVideoTrack = function () {
-        if (this._videoTrackLockedOn === undefined) {
-            return;
-        }
-        else if (this._videoTrackLockedOn === null) {
+    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) {
             disableVideoTracks(this._videoTracks);
             return;
         }
-        else {
+        else if (this._videoTrackLockedOn !== undefined) {
             for (var i = 0; i < this._videoTracks.length; i++) {
                 var nativeTrack = this._videoTracks[i].nativeTrack;
                 if (nativeTrack === this._videoTrackLockedOn) {
@@ -468,12 +563,36 @@ var MediaElementTracksStore = /** @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.
      */
-    MediaElementTracksStore.prototype._handleNativeTracksCallbacks = function () {
+    MediaElementTrackChoiceManager.prototype._handleNativeTracksCallbacks = function () {
         var _this = this;
         if (this._nativeAudioTracks !== undefined) {
             this._nativeAudioTracks.onaddtrack = function () {
@@ -482,9 +601,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     var newAudioTracks = createAudioTracks(_this._nativeAudioTracks);
                     if (areTrackArraysDifferent(_this._audioTracks, newAudioTracks)) {
                         _this._audioTracks = newAudioTracks;
-                        _this._setPreviouslyLockedAudioTrack();
+                        _this._setOptimalAudioTrack();
                         _this.trigger("availableAudioTracksChange", _this.getAvailableAudioTracks());
-                        var chosenAudioTrack = _this._getCurrentAudioTrack();
+                        var chosenAudioTrack = _this._getPrivateChosenAudioTrack();
                         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;
@@ -499,7 +618,7 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     if (areTrackArraysDifferent(_this._audioTracks, newAudioTracks)) {
                         _this._audioTracks = newAudioTracks;
                         _this.trigger("availableAudioTracksChange", _this.getAvailableAudioTracks());
-                        var chosenAudioTrack = _this._getCurrentAudioTrack();
+                        var chosenAudioTrack = _this._getPrivateChosenAudioTrack();
                         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;
@@ -534,9 +653,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     var newTextTracks = createTextTracks(_this._nativeTextTracks);
                     if (areTrackArraysDifferent(_this._textTracks, newTextTracks)) {
                         _this._textTracks = newTextTracks;
-                        _this._setPreviouslyLockedTextTrack();
+                        _this._setOptimalTextTrack();
                         _this.trigger("availableTextTracksChange", _this.getAvailableTextTracks());
-                        var chosenTextTrack = _this._getCurrentTextTrack();
+                        var chosenTextTrack = _this._getPrivateChosenTextTrack();
                         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;
@@ -550,9 +669,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     var newTextTracks = createTextTracks(_this._nativeTextTracks);
                     if (areTrackArraysDifferent(_this._textTracks, newTextTracks)) {
                         _this._textTracks = newTextTracks;
-                        _this._setPreviouslyLockedTextTrack();
+                        _this._setOptimalTextTrack();
                         _this.trigger("availableTextTracksChange", _this.getAvailableTextTracks());
-                        var chosenTextTrack = _this._getCurrentTextTrack();
+                        var chosenTextTrack = _this._getPrivateChosenTextTrack();
                         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;
@@ -587,9 +706,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     var newVideoTracks = createVideoTracks(_this._nativeVideoTracks);
                     if (areTrackArraysDifferent(_this._videoTracks, newVideoTracks)) {
                         _this._videoTracks = newVideoTracks;
-                        _this._setPreviouslyLockedVideoTrack();
+                        _this._setOptimalVideoTrack();
                         _this.trigger("availableVideoTracksChange", _this.getAvailableVideoTracks());
-                        var chosenVideoTrack = _this._getCurrentVideoTrack();
+                        var chosenVideoTrack = _this._getPrivateChosenVideoTrack();
                         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;
@@ -603,9 +722,9 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
                     var newVideoTracks = createVideoTracks(_this._nativeVideoTracks);
                     if (areTrackArraysDifferent(_this._videoTracks, newVideoTracks)) {
                         _this._videoTracks = newVideoTracks;
-                        _this._setPreviouslyLockedVideoTrack();
+                        _this._setOptimalVideoTrack();
                         _this.trigger("availableVideoTracksChange", _this.getAvailableVideoTracks());
-                        var chosenVideoTrack = _this._getCurrentVideoTrack();
+                        var chosenVideoTrack = _this._getPrivateChosenVideoTrack();
                         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;
@@ -639,15 +758,15 @@ var MediaElementTracksStore = /** @class */ (function (_super) {
      * `this._audioTracks` array.
      * @param {number} index}
      */
-    MediaElementTracksStore.prototype._enableAudioTrackFromIndex = function (index) {
+    MediaElementTrackChoiceManager.prototype._enableAudioTrackFromIndex = function (index) {
         enableAudioTrack(this._audioTracks.map(function (_a) {
             var nativeTrack = _a.nativeTrack;
             return nativeTrack;
         }), index);
     };
-    return MediaElementTracksStore;
+    return MediaElementTrackChoiceManager;
 }(EventEmitter));
-export default MediaElementTracksStore;
+export default MediaElementTrackChoiceManager;
 /**
  * Disable all text track elements in the given array from showing.
  * @param {Array.<Object>} textTracks