rx-player 3.29.0-dev.2022090500 → 3.29.0-dev.2022091600

package/CHANGELOG.md

@@ -1,24 +1,28 @@
 # Changelog
 
-## v3.29.0-dev.2022090500 (2022-09-05)
+## v3.29.0-dev.2022091600 (2022-09-16)
 
 ### Features
 
   - add `networkConfig.segmentRequestTimeout` and `networkConfig.manifestRequestTimeout` options to loadVideo to configure the timeout of respectively segment and manifest requests [#1156]
   - add `timeout` property to the first argument communicated to a `segmentLoader` (from `loadVideo`'s `transportOptions`) [#1156]
   - add `timeout` property to a new third argument communicated to a `manifestLoader` (from `loadVideo`'s `transportOptions`) [#1156]
+  - add `keySystems[].onKeyExpiration` to `loadVideo` options to configure the behavior the RxPlayer should have on key expiration [#1157]
+  - add `keyStatuses` property to an `EncryptedMediaError` with the `KEY_STATUS_CHANGE_ERROR` code to communicate which key id and key statuses caused issues. [#1157]
 
 ### Bug fixes
 
   - Compat/Directfile: Fix an issue with LG TV when playing multiple directfile contents with the `stopAtEnd` player option set to `true` [#1154]
   - Compat: To work around an issue on LG TVs, also specify a request timeout manually through a `setTimeout` call when XMLHttpRequests are created for Manifest and segment requests [#1152]
   - Compat: Fix issue with Samsung TVs where starting playback on a discontinuity could lead to infinite rebuffering [#1140]
+  - Compat: For `"directfile"` contents, also consider `AudioTrack` with a `description` (without an "s") as audio-description audio tracks to work-around what seems to be a Safari typo [#1160]
   - Better handle valid reverse playback use cases by not skipping gaps when the playback rate has been set to `0` or a negative value [#1138]
   - DRM: When using persistent licenses, create new MediaKeySession when `load` resolves with `false`, instead of relying the same, to fix issues with such persistent sessions [#1139]
 
 ### Other improvements
 
   - In the experimental "local" transport, add `incomingRanges` property to signal the time ranges of remaining data, allowing better discontinuity handling and duration estimates for sill-loading dowloaded contents [#1151]
+  - Only send through `"warning"` events, just one `EncryptedMediaError` with a `KEY_STATUS_CHANGE_ERROR` code when multiple ones arises at the same time [#1157]
 
 ## v3.28.0 (2022-07-12)
 

package/VERSION

@@ -1 +1 @@
-3.29.0-dev.2022090500
+3.29.0-dev.2022091600

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

@@ -269,14 +269,14 @@ function checkReloadOptions(options) {
  * @returns {Object}
  */
 function parseLoadVideoOptions(options) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g;
     var url;
     var transport;
     var keySystems;
     var textTrackMode;
     var textTrackElement;
     var startAt;
-    var _g = config.getCurrent(), DEFAULT_AUDIO_TRACK_SWITCHING_MODE = _g.DEFAULT_AUDIO_TRACK_SWITCHING_MODE, DEFAULT_AUTO_PLAY = _g.DEFAULT_AUTO_PLAY, DEFAULT_CODEC_SWITCHING_BEHAVIOR = _g.DEFAULT_CODEC_SWITCHING_BEHAVIOR, DEFAULT_ENABLE_FAST_SWITCHING = _g.DEFAULT_ENABLE_FAST_SWITCHING, DEFAULT_MANUAL_BITRATE_SWITCHING_MODE = _g.DEFAULT_MANUAL_BITRATE_SWITCHING_MODE, DEFAULT_SHOW_NATIVE_SUBTITLE = _g.DEFAULT_SHOW_NATIVE_SUBTITLE, DEFAULT_TEXT_TRACK_MODE = _g.DEFAULT_TEXT_TRACK_MODE;
+    var _h = config.getCurrent(), DEFAULT_AUDIO_TRACK_SWITCHING_MODE = _h.DEFAULT_AUDIO_TRACK_SWITCHING_MODE, DEFAULT_AUTO_PLAY = _h.DEFAULT_AUTO_PLAY, DEFAULT_CODEC_SWITCHING_BEHAVIOR = _h.DEFAULT_CODEC_SWITCHING_BEHAVIOR, DEFAULT_ENABLE_FAST_SWITCHING = _h.DEFAULT_ENABLE_FAST_SWITCHING, DEFAULT_MANUAL_BITRATE_SWITCHING_MODE = _h.DEFAULT_MANUAL_BITRATE_SWITCHING_MODE, DEFAULT_SHOW_NATIVE_SUBTITLE = _h.DEFAULT_SHOW_NATIVE_SUBTITLE, DEFAULT_TEXT_TRACK_MODE = _h.DEFAULT_TEXT_TRACK_MODE;
     if (isNullOrUndefined(options)) {
         throw new Error("No option set on loadVideo");
     }
@@ -363,8 +363,8 @@ function parseLoadVideoOptions(options) {
             "Please use the `TextTrackRenderer` tool instead.");
         var supplementaryTextTracks = Array.isArray(options.supplementaryTextTracks) ?
             options.supplementaryTextTracks : [options.supplementaryTextTracks];
-        for (var _h = 0, supplementaryTextTracks_1 = supplementaryTextTracks; _h < supplementaryTextTracks_1.length; _h++) {
-            var supplementaryTextTrack = supplementaryTextTracks_1[_h];
+        for (var _j = 0, supplementaryTextTracks_1 = supplementaryTextTracks; _j < supplementaryTextTracks_1.length; _j++) {
+            var supplementaryTextTrack = supplementaryTextTracks_1[_j];
             if (typeof supplementaryTextTrack.language !== "string" ||
                 typeof supplementaryTextTrack.mimeType !== "string" ||
                 typeof supplementaryTextTrack.url !== "string") {
@@ -379,8 +379,8 @@ function parseLoadVideoOptions(options) {
             "Please use the `parseBifThumbnails` tool instead.");
         var supplementaryImageTracks = Array.isArray(options.supplementaryImageTracks) ?
             options.supplementaryImageTracks : [options.supplementaryImageTracks];
-        for (var _j = 0, supplementaryImageTracks_1 = supplementaryImageTracks; _j < supplementaryImageTracks_1.length; _j++) {
-            var supplementaryImageTrack = supplementaryImageTracks_1[_j];
+        for (var _k = 0, supplementaryImageTracks_1 = supplementaryImageTracks; _k < supplementaryImageTracks_1.length; _k++) {
+            var supplementaryImageTrack = supplementaryImageTracks_1[_k];
             if (typeof supplementaryImageTrack.mimeType !== "string" ||
                 typeof supplementaryImageTrack.url !== "string") {
                 throw new Error("Invalid supplementary image track given. " +
@@ -448,11 +448,7 @@ function parseLoadVideoOptions(options) {
             startAt = options.startAt;
         }
     }
-    var networkConfig = isNullOrUndefined(options.networkConfig) ?
-        {} :
-        { manifestRetry: options.networkConfig.manifestRetry,
-            offlineRetry: options.networkConfig.offlineRetry,
-            segmentRetry: options.networkConfig.segmentRetry };
+    var networkConfig = (_g = options.networkConfig) !== null && _g !== void 0 ? _g : {};
     // TODO without cast
     /* eslint-disable @typescript-eslint/consistent-type-assertions */
     return { autoPlay: autoPlay, defaultAudioTrack: defaultAudioTrack, defaultTextTrack: defaultTextTrack, enableFastSwitching: enableFastSwitching, hideNativeSubtitle: hideNativeSubtitle, keySystems: keySystems, initialManifest: initialManifest, lowLatencyMode: lowLatencyMode, manualBitrateSwitchingMode: manualBitrateSwitchingMode, audioTrackSwitchingMode: audioTrackSwitchingMode, minimumManifestUpdateInterval: minimumManifestUpdateInterval, networkConfig: networkConfig, onCodecSwitch: onCodecSwitch, startAt: startAt, textTrackElement: textTrackElement, textTrackMode: textTrackMode, transport: transport, transportOptions: transportOptions, url: url };

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

@@ -38,7 +38,7 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
     readonly log: Logger;
     /**
      * Current state of the RxPlayer.
-     * Please use `getPlayerState()` instead.
+     * Please use `getLoadedContentState()` instead.
      */
     state: IPlayerState;
     /**
@@ -351,9 +351,9 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      *
      * Note that switching to or getting out of a trickmode video track may
      * lead to the player being a brief instant in a `"RELOADING"` state (notified
-     * through `playerStateChange` events and the `getPlayerState` method). When in
-     * that state, a black screen may be displayed and multiple RxPlayer APIs will
-     * not be usable.
+     * through `playerStateChange` events and the `getLoadedContentState` method).
+     * When in that state, a black screen may be displayed and multiple RxPlayer
+     * APIs will not be usable.
      *
      * @param {Number} rate
      * @param {Object} opts

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

@@ -63,11 +63,10 @@ import warnOnce from "../../utils/warn_once";
 import { clearOnStop, disposeDecryptionResources, getCurrentKeySystem, } from "../decrypt";
 import { ManifestFetcher, SegmentFetcherCreator, } from "../fetchers";
 import initializeMediaSourcePlayback from "../init";
-import emitSeekEvents from "./emit_seek_events";
-import getPlayerState, { PLAYER_STATES, } from "./get_player_state";
 import { checkReloadOptions, parseConstructorOptions, parseLoadVideoOptions, } from "./option_utils";
 import PlaybackObserver from "./playback_observer";
-import TrackChoiceManager from "./track_choice_manager";
+import TrackChoiceManager from "./tracks_management/track_choice_manager";
+import { emitSeekEvents, getLoadedContentState, } from "./utils";
 /* eslint-disable @typescript-eslint/naming-convention */
 var getPageActivityRef = events.getPageActivityRef, getPictureOnPictureStateRef = events.getPictureOnPictureStateRef, getVideoVisibilityRef = events.getVideoVisibilityRef, getVideoWidthRef = events.getVideoWidthRef, onFullscreenChange$ = events.onFullscreenChange$, onTextTrackChanges$ = events.onTextTrackChanges$;
 /**
@@ -88,7 +87,7 @@ var Player = /** @class */ (function (_super) {
         // Workaround to support Firefox autoplay on FF 42.
         // See: https://bugzilla.mozilla.org/show_bug.cgi?id=1194624
         videoElement.preload = "auto";
-        _this.version = /* PLAYER_VERSION */ "3.29.0-dev.2022090500";
+        _this.version = /* PLAYER_VERSION */ "3.29.0-dev.2022091600";
         _this.log = log;
         _this.state = "STOPPED";
         _this.videoElement = videoElement;
@@ -160,7 +159,7 @@ var Player = /** @class */ (function (_super) {
         _this._priv_contentInfos = null;
         _this._priv_contentEventsMemory = {};
         _this._priv_stopAtEnd = stopAtEnd;
-        _this._priv_setPlayerState(PLAYER_STATES.STOPPED);
+        _this._priv_setPlayerState("STOPPED" /* PLAYER_STATES.STOPPED */);
         _this._priv_preferredAudioTracks = preferredAudioTracks;
         _this._priv_preferredTextTracks = preferredTextTracks;
         _this._priv_preferredVideoTracks = preferredVideoTracks;
@@ -227,8 +226,8 @@ var Player = /** @class */ (function (_super) {
             this._priv_contentInfos.currentContentCanceller.cancel();
         }
         this._priv_cleanUpCurrentContentState();
-        if (this.state !== PLAYER_STATES.STOPPED) {
-            this._priv_setPlayerState(PLAYER_STATES.STOPPED);
+        if (this.state !== "STOPPED" /* PLAYER_STATES.STOPPED */) {
+            this._priv_setPlayerState("STOPPED" /* PLAYER_STATES.STOPPED */);
         }
     };
     /**
@@ -550,18 +549,18 @@ var Player = /** @class */ (function (_super) {
             stateChangingEvent$.pipe(startWith(null)),
         ]).pipe(takeUntil(stoppedContent$), map(function (_a) {
             var stalledStatus = _a[0];
-            return getPlayerState(videoElement, stalledStatus);
+            return getLoadedContentState(videoElement, stalledStatus);
         }));
         /** Emit all player "state" updates. */
-        var playerState$ = observableConcat(observableOf(PLAYER_STATES.LOADING), // Begin with LOADING
+        var playerState$ = observableConcat(observableOf("LOADING" /* PLAYER_STATES.LOADING */), // Begin with LOADING
         loaded$.pipe(switchMap(function (_, i) {
             var isFirstLoad = i === 0;
             return observableMerge(
             // Purposely subscribed first so a RELOADING triggered synchronously
             // after a LOADED state is catched.
-            reloading$.pipe(map(function () { return PLAYER_STATES.RELOADING; })), 
+            reloading$.pipe(map(function () { return "RELOADING" /* PLAYER_STATES.RELOADING */; })), 
             // Only switch to LOADED state for the first (i.e. non-RELOADING) load
-            isFirstLoad ? observableOf(PLAYER_STATES.LOADED) :
+            isFirstLoad ? observableOf("LOADED" /* PLAYER_STATES.LOADED */) :
                 EMPTY, 
             // Purposely put last so any other state change happens after we've
             // already switched to LOADED
@@ -569,7 +568,7 @@ var Player = /** @class */ (function (_super) {
             // For the first load, we prefer staying at the LOADED state over
             // PAUSED when autoPlay is disabled.
             // For consecutive loads however, there's no LOADED state.
-            skipWhile(function (state) { return isFirstLoad && state === PLAYER_STATES.PAUSED; })));
+            skipWhile(function (state) { return isFirstLoad && state === "PAUSED" /* PLAYER_STATES.PAUSED */; })));
         }))).pipe(distinctUntilChanged());
         var playbackSubscription;
         stoppedContent$.subscribe(function () {
@@ -606,7 +605,7 @@ var Player = /** @class */ (function (_super) {
                     log.info("API: Previous playback finished. Stopping and cleaning-up...");
                     contentInfos.currentContentCanceller.cancel();
                     _this._priv_cleanUpCurrentContentState();
-                    _this._priv_setPlayerState(PLAYER_STATES.STOPPED);
+                    _this._priv_setPlayerState("STOPPED" /* PLAYER_STATES.STOPPED */);
                 }
             },
         });
@@ -911,9 +910,9 @@ var Player = /** @class */ (function (_super) {
      *
      * Note that switching to or getting out of a trickmode video track may
      * lead to the player being a brief instant in a `"RELOADING"` state (notified
-     * through `playerStateChange` events and the `getPlayerState` method). When in
-     * that state, a black screen may be displayed and multiple RxPlayer APIs will
-     * not be usable.
+     * through `playerStateChange` events and the `getLoadedContentState` method).
+     * When in that state, a black screen may be displayed and multiple RxPlayer
+     * APIs will not be usable.
      *
      * @param {Number} rate
      * @param {Object} opts
@@ -1881,7 +1880,7 @@ var Player = /** @class */ (function (_super) {
         this._priv_cleanUpCurrentContentState();
         this._priv_currentError = formattedError;
         log.error("API: The player stopped because of an error", error instanceof Error ? error : "");
-        this._priv_setPlayerState(PLAYER_STATES.STOPPED);
+        this._priv_setPlayerState("STOPPED" /* PLAYER_STATES.STOPPED */);
         // TODO This condition is here because the eventual callback called when the
         // player state is updated can launch a new content, thus the error will not
         // be here anymore, in which case triggering the "error" event is unwanted.
@@ -2219,7 +2218,7 @@ var Player = /** @class */ (function (_super) {
             log.warn("API: Cannot perform time update: no content loaded.");
             return;
         }
-        if (this.state === PLAYER_STATES.RELOADING) {
+        if (this.state === "RELOADING" /* PLAYER_STATES.RELOADING */) {
             return;
         }
         var _b = this._priv_contentInfos, isDirectFile = _b.isDirectFile, manifest = _b.manifest;
@@ -2295,5 +2294,5 @@ var Player = /** @class */ (function (_super) {
     };
     return Player;
 }(EventEmitter));
-Player.version = /* PLAYER_VERSION */ "3.29.0-dev.2022090500";
+Player.version = /* PLAYER_VERSION */ "3.29.0-dev.2022091600";
 export default Player;

package/dist/_esm5.processed/core/api/{media_element_track_choice_manager.d.ts → tracks_management/media_element_track_choice_manager.d.ts}

@@ -13,8 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { IAudioTrack, ITextTrack, IVideoTrack, IAudioTrackPreference, ITextTrackPreference, IVideoTrackPreference, IAvailableVideoTrack, IAvailableAudioTrack, IAvailableTextTrack } from "../../public_types";
-import EventEmitter from "../../utils/event_emitter";
+import { IAudioTrack, ITextTrack, IVideoTrack, IAudioTrackPreference, ITextTrackPreference, IVideoTrackPreference, IAvailableVideoTrack, IAvailableAudioTrack, IAvailableTextTrack } from "../../../public_types";
+import EventEmitter from "../../../utils/event_emitter";
 /** Events emitted by the MediaElementTrackChoiceManager. */
 interface IMediaElementTrackChoiceManagerEvents {
     availableVideoTracksChange: IAvailableVideoTrack[];

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

@@ -28,9 +28,9 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-import assert from "../../utils/assert";
-import EventEmitter from "../../utils/event_emitter";
-import normalizeLanguage from "../../utils/languages";
+import assert from "../../../utils/assert";
+import EventEmitter from "../../../utils/event_emitter";
+import normalizeLanguage from "../../../utils/languages";
 /**
  * Check if track array is different from an other one
  * @param {Array.<Object>} oldTrackArray
@@ -69,7 +69,10 @@ function createAudioTracks(audioTracks) {
             occurences.toString();
         languagesOccurences[language] = occurences + 1;
         var track = { language: audioTrack.language, id: id, normalized: normalizeLanguage(audioTrack.language),
-            audioDescription: audioTrack.kind === "descriptions",
+            audioDescription: audioTrack.kind === "descriptions" ||
+                // Safari seem to prefer the non-standard singular
+                // version, funnily enough
+                audioTrack.kind === "description",
             representations: [] };
         newAudioTracks.push({ track: track, nativeTrack: audioTrack });
     }

package/dist/_esm5.processed/core/api/{track_choice_manager.d.ts → tracks_management/track_choice_manager.d.ts}

@@ -18,8 +18,8 @@
  * switching for an easier API management.
  */
 import { Subject } from "rxjs";
-import { Adaptation, Period } from "../../manifest";
-import { IAudioTrack, IAudioTrackPreference, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, ITextTrack, ITextTrackPreference, IVideoTrack, IVideoTrackPreference } from "../../public_types";
+import { Adaptation, Period } from "../../../manifest";
+import { IAudioTrack, IAudioTrackPreference, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, ITextTrack, ITextTrackPreference, IVideoTrack, IVideoTrackPreference } from "../../../public_types";
 /**
  * Manage audio and text tracks for all active periods.
  * Choose the audio and text tracks for each period and record this choice.

package/dist/_esm5.processed/core/api/{track_choice_manager.js → tracks_management/track_choice_manager.js}

@@ -13,13 +13,13 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import log from "../../log";
-import arrayFind from "../../utils/array_find";
-import arrayIncludes from "../../utils/array_includes";
-import isNullOrUndefined from "../../utils/is_null_or_undefined";
-import normalizeLanguage from "../../utils/languages";
-import SortedList from "../../utils/sorted_list";
-import takeFirstSet from "../../utils/take_first_set";
+import log from "../../../log";
+import arrayFind from "../../../utils/array_find";
+import arrayIncludes from "../../../utils/array_includes";
+import isNullOrUndefined from "../../../utils/is_null_or_undefined";
+import normalizeLanguage from "../../../utils/languages";
+import SortedList from "../../../utils/sorted_list";
+import takeFirstSet from "../../../utils/take_first_set";
 /**
  * Transform an array of IAudioTrackPreference into an array of
  * INormalizedPreferredAudioTrack to be exploited by the TrackChoiceManager.

package/dist/_esm5.processed/core/api/{emit_seek_events.d.ts → utils.d.ts}

@@ -14,6 +14,8 @@
  * limitations under the License.
  */
 import { Observable } from "rxjs";
+import { IPlayerState } from "../../public_types";
+import { IStallingSituation } from "../init";
 import { IPlaybackObservation } from "./playback_observer";
 /**
  * Returns Observable which will emit:
@@ -24,4 +26,25 @@ import { IPlaybackObservation } from "./playback_observer";
  * @param {Observable} observation$
  * @returns {Observable}
  */
-export default function emitSeekEvents(mediaElement: HTMLMediaElement | null, observation$: Observable<IPlaybackObservation>): Observable<"seeking" | "seeked">;
+export declare function emitSeekEvents(mediaElement: HTMLMediaElement | null, observation$: Observable<IPlaybackObservation>): Observable<"seeking" | "seeked">;
+/** Player state dictionnary. */
+export declare const enum PLAYER_STATES {
+    STOPPED = "STOPPED",
+    LOADED = "LOADED",
+    LOADING = "LOADING",
+    PLAYING = "PLAYING",
+    PAUSED = "PAUSED",
+    ENDED = "ENDED",
+    BUFFERING = "BUFFERING",
+    SEEKING = "SEEKING",
+    RELOADING = "RELOADING"
+}
+/**
+ * Get state string for a _loaded_ content.
+ * @param {HTMLMediaElement} mediaElement
+ * @param {Object} stalledStatus - Current stalled state:
+ *   - null when not stalled
+ *   - a description of the situation if stalled.
+ * @returns {string}
+ */
+export declare function getLoadedContentState(mediaElement: HTMLMediaElement, stalledStatus: IStallingSituation | null): IPlayerState;

package/dist/_esm5.processed/core/api/{emit_seek_events.js → utils.js}

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import { defer as observableDefer, EMPTY, filter, map, merge as observableMerge, startWith, switchMap, take, } from "rxjs";
+import config from "../../config";
 /**
  * Returns Observable which will emit:
  *   - `"seeking"` when we are seeking in the given mediaElement
@@ -23,7 +24,7 @@ import { defer as observableDefer, EMPTY, filter, map, merge as observableMerge,
  * @param {Observable} observation$
  * @returns {Observable}
  */
-export default function emitSeekEvents(mediaElement, observation$) {
+export function emitSeekEvents(mediaElement, observation$) {
     return observableDefer(function () {
         if (mediaElement === null) {
             return EMPTY;
@@ -38,3 +39,33 @@ export default function emitSeekEvents(mediaElement, observation$) {
         return observableMerge(isSeeking$, hasSeeked$);
     });
 }
+/**
+ * Get state string for a _loaded_ content.
+ * @param {HTMLMediaElement} mediaElement
+ * @param {Object} stalledStatus - Current stalled state:
+ *   - null when not stalled
+ *   - a description of the situation if stalled.
+ * @returns {string}
+ */
+export function getLoadedContentState(mediaElement, stalledStatus) {
+    var FORCED_ENDED_THRESHOLD = config.getCurrent().FORCED_ENDED_THRESHOLD;
+    if (mediaElement.ended) {
+        return "ENDED" /* PLAYER_STATES.ENDED */;
+    }
+    if (stalledStatus !== null) {
+        // On some old browsers (e.g. Chrome 54), the browser does not
+        // emit an 'ended' event in some conditions. Detect if we
+        // reached the end by comparing the current position and the
+        // duration instead.
+        var gapBetweenDurationAndCurrentTime = Math.abs(mediaElement.duration -
+            mediaElement.currentTime);
+        if (FORCED_ENDED_THRESHOLD != null &&
+            gapBetweenDurationAndCurrentTime < FORCED_ENDED_THRESHOLD) {
+            return "ENDED" /* PLAYER_STATES.ENDED */;
+        }
+        return stalledStatus === "seeking" ? "SEEKING" /* PLAYER_STATES.SEEKING */ :
+            "BUFFERING" /* PLAYER_STATES.BUFFERING */;
+    }
+    return mediaElement.paused ? "PAUSED" /* PLAYER_STATES.PAUSED */ :
+        "PLAYING" /* PLAYER_STATES.PLAYING */;
+}

package/dist/_esm5.processed/core/decrypt/content_decryptor.d.ts

@@ -143,6 +143,16 @@ export default class ContentDecryptor extends EventEmitter<IContentDecryptorEven
      */
     private _processInitializationData;
     private _tryToUseAlreadyCreatedSession;
+    /**
+     * Callback that should be called if an error that made the current
+     * `ContentDecryptor` instance unusable arised.
+     * This callbacks takes care of resetting state and sending the right events.
+     *
+     * Once called, no further actions should be taken.
+     *
+     * @param {*} err - The error object which describes the issue. Will be
+     * formatted and sent in an "error" event.
+     */
     private _onFatalError;
     /**
      * Return `true` if the `ContentDecryptor` has either been disposed or
@@ -150,8 +160,24 @@ export default class ContentDecryptor extends EventEmitter<IContentDecryptorEven
      * @returns {boolean}
      */
     private _isStopped;
+    /**
+     * Start processing the next initialization data of the `_initDataQueue` if it
+     * isn't lock.
+     */
     private _processCurrentInitDataQueue;
+    /**
+     * Lock new initialization data (from the `_initDataQueue`) from being
+     * processed until `_unlockInitDataQueue` is called.
+     *
+     * You may want to call this method when performing operations which may have
+     * an impact on the handling of other initialization data.
+     */
     private _lockInitDataQueue;
+    /**
+     * Unlock `_initDataQueue` and start processing the first element.
+     *
+     * Should have no effect if the `_initDataQueue` was not locked.
+     */
     private _unlockInitDataQueue;
 }
 /** Events sent by the `ContentDecryptor`, in a `{ event: payload }` format. */