rx-player 4.1.0 → 4.2.0-dev.2024080600

package/dist/commonjs/main_thread/init/media_source_content_initializer.js

@@ -29,6 +29,17 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -77,10 +88,12 @@ var __values = (this && this.__values) || function(o) {
     throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+var is_codec_supported_1 = require("../../compat/is_codec_supported");
 var may_media_element_fail_on_undecipherable_data_1 = require("../../compat/may_media_element_fail_on_undecipherable_data");
 var should_reload_media_source_on_decipherability_update_1 = require("../../compat/should_reload_media_source_on_decipherability_update");
 var config_1 = require("../../config");
 var adaptive_1 = require("../../core/adaptive");
+var cmcd_1 = require("../../core/cmcd");
 var fetchers_1 = require("../../core/fetchers");
 var create_content_time_boundaries_observer_1 = require("../../core/main/common/create_content_time_boundaries_observer");
 var DecipherabilityFreezeDetector_1 = require("../../core/main/common/DecipherabilityFreezeDetector");
@@ -92,9 +105,9 @@ var log_1 = require("../../log");
 var are_arrays_of_numbers_equal_1 = require("../../utils/are_arrays_of_numbers_equal");
 var assert_1 = require("../../utils/assert");
 var create_cancellable_promise_1 = require("../../utils/create_cancellable_promise");
+var is_null_or_undefined_1 = require("../../utils/is_null_or_undefined");
 var noop_1 = require("../../utils/noop");
 var object_assign_1 = require("../../utils/object_assign");
-var reference_1 = require("../../utils/reference");
 var sync_or_async_1 = require("../../utils/sync_or_async");
 var task_canceller_1 = require("../../utils/task_canceller");
 var decrypt_1 = require("../decrypt");
@@ -132,8 +145,11 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
         _this._settings = settings;
         _this._initCanceller = new task_canceller_1.default();
         _this._manifest = null;
+        _this._decryptionCapabilities = { status: "uninitialized", value: null };
         var urls = settings.url === undefined ? undefined : [settings.url];
-        _this._manifestFetcher = new fetchers_1.ManifestFetcher(urls, settings.transport, settings.manifestRequestSettings);
+        _this._cmcdDataBuilder =
+            settings.cmcd === undefined ? null : new cmcd_1.default(settings.cmcd);
+        _this._manifestFetcher = new fetchers_1.ManifestFetcher(urls, settings.transport, __assign(__assign({}, settings.manifestRequestSettings), { lowLatencyMode: settings.lowLatencyMode, cmcdDataBuilder: _this._cmcdDataBuilder }));
         return _this;
     }
     /**
@@ -171,11 +187,9 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
         this.prepare(); // Load Manifest if not already done
         /** Translate errors coming from the media element into RxPlayer errors. */
         (0, throw_on_media_error_1.default)(mediaElement, function (error) { return _this._onFatalError(error); }, this._initCanceller.signal);
-        /** Send content protection initialization data to the decryption logic. */
-        var protectionRef = new reference_1.default(null, this._initCanceller.signal);
-        this._initializeMediaSourceAndDecryption(mediaElement, protectionRef)
+        this._initializeMediaSourceAndDecryption(mediaElement)
             .then(function (initResult) {
-            return _this._onInitialMediaSourceReady(mediaElement, initResult.mediaSource, playbackObserver, initResult.drmSystemId, protectionRef, initResult.unlinkMediaSource);
+            return _this._onInitialMediaSourceReady(mediaElement, initResult.mediaSource, playbackObserver, initResult.drmSystemId, initResult.unlinkMediaSource);
         })
             .catch(function (err) {
             _this._onFatalError(err);
@@ -201,13 +215,13 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
         this._initCanceller.cancel();
         this.trigger("error", err);
     };
-    MediaSourceContentInitializer.prototype._initializeMediaSourceAndDecryption = function (mediaElement, protectionRef) {
+    MediaSourceContentInitializer.prototype._initializeMediaSourceAndDecryption = function (mediaElement) {
         var _this = this;
         var initCanceller = this._initCanceller;
         return (0, create_cancellable_promise_1.default)(initCanceller.signal, function (resolve) {
             var keySystems = _this._settings.keySystems;
             /** Initialize decryption capabilities. */
-            var drmInitRef = (0, initialize_content_decryption_1.default)(mediaElement, keySystems, protectionRef, {
+            var _a = (0, initialize_content_decryption_1.default)(mediaElement, keySystems, {
                 onWarning: function (err) { return _this.trigger("warning", err); },
                 onError: function (err) { return _this._onFatalError(err); },
                 onBlackListProtectionData: function (val) {
@@ -262,7 +276,36 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                         });
                     }); })().catch(noop_1.default);
                 },
-            }, initCanceller.signal);
+                onCodecSupportUpdate: function () {
+                    var _a, _b;
+                    var syncManifest = (_a = _this._manifest) === null || _a === void 0 ? void 0 : _a.syncValue;
+                    if ((0, is_null_or_undefined_1.default)(syncManifest)) {
+                        // The Manifest is not yet fetched, but we will be able to check
+                        // the codecs once it is the case
+                        (_b = _this._manifest) === null || _b === void 0 ? void 0 : _b.getValueAsAsync().then(function (loadedManifest) {
+                            if (_this._initCanceller.isUsed()) {
+                                return;
+                            }
+                            _this._refreshManifestCodecSupport(loadedManifest);
+                        }, noop_1.default);
+                    }
+                    else {
+                        _this._refreshManifestCodecSupport(syncManifest);
+                    }
+                },
+            }, initCanceller.signal), drmInitRef = _a.statusRef, contentDecryptor = _a.contentDecryptor;
+            if (contentDecryptor.enabled) {
+                _this._decryptionCapabilities = {
+                    status: "enabled",
+                    value: contentDecryptor.value,
+                };
+            }
+            else {
+                _this._decryptionCapabilities = {
+                    status: "disabled",
+                    value: contentDecryptor.value,
+                };
+            }
             drmInitRef.onUpdate(function (drmStatus, stopListeningToDrmUpdates) {
                 if (drmStatus.initializationState.type === "uninitialized") {
                     return;
@@ -305,8 +348,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
             }, { emitCurrentValue: true, clearSignal: initCanceller.signal });
         });
     };
-    MediaSourceContentInitializer.prototype._onInitialMediaSourceReady = function (mediaElement, initialMediaSource, playbackObserver, drmSystemId, protectionRef, initialMediaSourceCanceller) {
-        var _a;
+    MediaSourceContentInitializer.prototype._onInitialMediaSourceReady = function (mediaElement, initialMediaSource, playbackObserver, drmSystemId, initialMediaSourceCanceller) {
         return __awaiter(this, void 0, void 0, function () {
             /**
              * Load the content defined by the Manifest in the mediaSource given at the
@@ -329,7 +371,6 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                     representationEstimator: representationEstimator,
                     segmentFetcherCreator: segmentFetcherCreator,
                     speed: speed,
-                    protectionRef: protectionRef,
                     bufferOptions: subBufferOptions,
                 };
                 bufferOnMediaSource(opts, onReloadMediaSource, currentCanceller.signal);
@@ -356,26 +397,27 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                     });
                 }
             }
-            var _b, adaptiveOptions, autoPlay, bufferOptions, lowLatencyMode, segmentRequestOptions, speed, startAt, textTrackOptions, transport, initCanceller, manifest, _c, _e_1, initialTime, representationEstimator, subBufferOptions, segmentFetcherCreator, bufferOnMediaSource, triggerEvent, onFatalError;
+            var _a, adaptiveOptions, autoPlay, bufferOptions, lowLatencyMode, segmentRequestOptions, speed, startAt, textTrackOptions, transport, initCanceller, manifest, _b, _e_1, initialTime, representationEstimator, subBufferOptions, segmentFetcherCreator, bufferOnMediaSource, triggerEvent, onFatalError;
             var _this = this;
+            var _c;
             return __generator(this, function (_d) {
                 switch (_d.label) {
                     case 0:
-                        _b = this._settings, adaptiveOptions = _b.adaptiveOptions, autoPlay = _b.autoPlay, bufferOptions = _b.bufferOptions, lowLatencyMode = _b.lowLatencyMode, segmentRequestOptions = _b.segmentRequestOptions, speed = _b.speed, startAt = _b.startAt, textTrackOptions = _b.textTrackOptions, transport = _b.transport;
+                        _a = this._settings, adaptiveOptions = _a.adaptiveOptions, autoPlay = _a.autoPlay, bufferOptions = _a.bufferOptions, lowLatencyMode = _a.lowLatencyMode, segmentRequestOptions = _a.segmentRequestOptions, speed = _a.speed, startAt = _a.startAt, textTrackOptions = _a.textTrackOptions, transport = _a.transport;
                         initCanceller = this._initCanceller;
                         (0, assert_1.default)(this._manifest !== null);
                         _d.label = 1;
                     case 1:
                         _d.trys.push([1, 5, , 6]);
-                        if (!((_a = this._manifest.syncValue) !== null && _a !== void 0)) return [3 /*break*/, 2];
-                        _c = _a;
+                        if (!((_c = this._manifest.syncValue) !== null && _c !== void 0)) return [3 /*break*/, 2];
+                        _b = _c;
                         return [3 /*break*/, 4];
                     case 2: return [4 /*yield*/, this._manifest.getValueAsAsync()];
                     case 3:
-                        _c = (_d.sent());
+                        _b = (_d.sent());
                         _d.label = 4;
                     case 4:
-                        manifest = _c;
+                        manifest = _b;
                         return [3 /*break*/, 6];
                     case 5:
                         _e_1 = _d.sent();
@@ -383,16 +425,21 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                     case 6:
                         manifest.addEventListener("manifestUpdate", function (updates) {
                             _this.trigger("manifestUpdate", updates);
+                            _this._refreshManifestCodecSupport(manifest);
                         }, initCanceller.signal);
                         manifest.addEventListener("decipherabilityUpdate", function (elts) {
                             _this.trigger("decipherabilityUpdate", elts);
                         }, initCanceller.signal);
+                        manifest.addEventListener("supportUpdate", function () {
+                            _this.trigger("codecSupportUpdate", null);
+                        }, initCanceller.signal);
                         log_1.default.debug("Init: Calculating initial time");
                         initialTime = (0, get_initial_time_1.default)(manifest, lowLatencyMode, startAt);
                         log_1.default.debug("Init: Initial time calculated:", initialTime);
                         representationEstimator = (0, adaptive_1.default)(adaptiveOptions);
                         subBufferOptions = (0, object_assign_1.default)({ textTrackOptions: textTrackOptions, drmSystemId: drmSystemId }, bufferOptions);
-                        segmentFetcherCreator = new fetchers_1.SegmentFetcherCreator(transport, segmentRequestOptions, initCanceller.signal);
+                        segmentFetcherCreator = new fetchers_1.SegmentFetcherCreator(transport, this._cmcdDataBuilder, segmentRequestOptions, initCanceller.signal);
+                        this._refreshManifestCodecSupport(manifest);
                         this.trigger("manifestReady", manifest);
                         if (initCanceller.isUsed()) {
                             return [2 /*return*/];
@@ -415,8 +462,8 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
      */
     MediaSourceContentInitializer.prototype._startBufferingOnMediaSource = function (args, onReloadOrder, cancelSignal) {
         var _this = this;
-        var _a;
-        var autoPlay = args.autoPlay, bufferOptions = args.bufferOptions, initialTime = args.initialTime, manifest = args.manifest, mediaElement = args.mediaElement, mediaSource = args.mediaSource, playbackObserver = args.playbackObserver, protectionRef = args.protectionRef, representationEstimator = args.representationEstimator, segmentFetcherCreator = args.segmentFetcherCreator, speed = args.speed;
+        var _a, _b;
+        var autoPlay = args.autoPlay, bufferOptions = args.bufferOptions, initialTime = args.initialTime, manifest = args.manifest, mediaElement = args.mediaElement, mediaSource = args.mediaSource, playbackObserver = args.playbackObserver, representationEstimator = args.representationEstimator, segmentFetcherCreator = args.segmentFetcherCreator, speed = args.speed;
         var initialPeriod = (_a = manifest.getPeriodForTime(initialTime)) !== null && _a !== void 0 ? _a : manifest.getNextPeriod(initialTime);
         if (initialPeriod === undefined) {
             var error = new errors_1.MediaError("MEDIA_STARTING_TIME_NOT_FOUND", "Wanted starting time not found in the Manifest.");
@@ -444,7 +491,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
         cancelSignal.register(function () {
             segmentSinksStore.disposeAll();
         });
-        var _b = (0, initial_seek_and_play_1.default)({
+        var _c = (0, initial_seek_and_play_1.default)({
             mediaElement: mediaElement,
             playbackObserver: playbackObserver,
             startTime: initialTime,
@@ -453,7 +500,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                 _this.trigger("warning", err);
             },
             isDirectfile: false,
-        }, cancelSignal), autoPlayResult = _b.autoPlayResult, initialPlayPerformed = _b.initialPlayPerformed;
+        }, cancelSignal), autoPlayResult = _c.autoPlayResult, initialPlayPerformed = _c.initialPlayPerformed;
         if (cancelSignal.isCancelled()) {
             return;
         }
@@ -484,6 +531,11 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
             initialPlayPerformed: initialPlayPerformed,
             speed: speed,
         }, cancelSignal);
+        (_b = this._cmcdDataBuilder) === null || _b === void 0 ? void 0 : _b.startMonitoringPlayback(coreObserver);
+        cancelSignal.register(function () {
+            var _a;
+            (_a = _this._cmcdDataBuilder) === null || _a === void 0 ? void 0 : _a.stopMonitoringPlayback();
+        });
         var rebufferingController = this._createRebufferingController(playbackObserver, manifest, speed, cancelSignal);
         var decipherabilityFreezeDetector = new DecipherabilityFreezeDetector_1.default(segmentSinksStore);
         if (may_media_element_fail_on_undecipherable_data_1.default) {
@@ -671,7 +723,11 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                     }
                     self.trigger("periodStreamCleared", value);
                 },
-                bitrateEstimateChange: function (value) { return self.trigger("bitrateEstimateChange", value); },
+                bitrateEstimateChange: function (value) {
+                    var _a;
+                    (_a = self._cmcdDataBuilder) === null || _a === void 0 ? void 0 : _a.updateThroughput(value.type, value.bitrate);
+                    self.trigger("bitrateEstimateChange", value);
+                },
                 needsMediaSourceReload: function (payload) {
                     reloadMediaSource(payload.timeOffset, payload.minimumPosition, payload.maximumPosition);
                 },
@@ -682,7 +738,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                         var lastObservation = coreObserver.getReference().getValue();
                         var position = lastObservation.position.isAwaitingFuturePosition()
                             ? lastObservation.position.getWanted()
-                            : (_a = coreObserver.getCurrentTime()) !== null && _a !== void 0 ? _a : lastObservation.position.getPolled();
+                            : ((_a = coreObserver.getCurrentTime()) !== null && _a !== void 0 ? _a : lastObservation.position.getPolled());
                         var isPaused = (_c = (_b = lastObservation.paused.pending) !== null && _b !== void 0 ? _b : coreObserver.getIsPaused()) !== null && _c !== void 0 ? _c : lastObservation.paused.last;
                         onReloadOrder({ position: position, autoPlay: !isPaused });
                     }
@@ -690,7 +746,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                         var lastObservation = coreObserver.getReference().getValue();
                         var position = lastObservation.position.isAwaitingFuturePosition()
                             ? lastObservation.position.getWanted()
-                            : (_d = coreObserver.getCurrentTime()) !== null && _d !== void 0 ? _d : lastObservation.position.getPolled();
+                            : ((_d = coreObserver.getCurrentTime()) !== null && _d !== void 0 ? _d : lastObservation.position.getPolled());
                         // simple seek close to the current position
                         // to flush the buffers
                         if (position + 0.001 < lastObservation.duration) {
@@ -703,10 +759,19 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
                 },
                 encryptionDataEncountered: function (value) {
                     var e_1, _a;
+                    if (self._decryptionCapabilities.status === "disabled") {
+                        self._onFatalError(self._decryptionCapabilities.value);
+                        return;
+                    }
+                    else if (self._decryptionCapabilities.status === "uninitialized") {
+                        // Should never happen
+                        log_1.default.error("Init: received encryption data without known decryption capabilities");
+                        return;
+                    }
                     try {
                         for (var value_1 = __values(value), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
                             var protectionData = value_1_1.value;
-                            protectionRef.setValue(protectionData);
+                            self._decryptionCapabilities.value.onInitializationData(protectionData);
                             if (cancelSignal.isCancelled()) {
                                 return; // Previous call has stopped streams due to a side-effect
                             }
@@ -737,7 +802,7 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
             var lastObservation = coreObserver.getReference().getValue();
             var currentPosition = lastObservation.position.isAwaitingFuturePosition()
                 ? lastObservation.position.getWanted()
-                : (_a = coreObserver.getCurrentTime()) !== null && _a !== void 0 ? _a : lastObservation.position.getPolled();
+                : ((_a = coreObserver.getCurrentTime()) !== null && _a !== void 0 ? _a : lastObservation.position.getPolled());
             var isPaused = (_c = (_b = lastObservation.paused.pending) !== null && _b !== void 0 ? _b : coreObserver.getIsPaused()) !== null && _c !== void 0 ? _c : lastObservation.paused.last;
             var position = currentPosition + deltaPosition;
             if (minimumPosition !== undefined) {
@@ -784,6 +849,76 @@ var MediaSourceContentInitializer = /** @class */ (function (_super) {
         rebufferingController.start();
         return rebufferingController;
     };
+    /**
+     * Evaluates a list of codecs to determine their support status.
+     *
+     * @param {Array} codecsToCheck - The list of codecs to check.
+     * @returns {Array} - The list of evaluated codecs with their support status updated.
+     */
+    MediaSourceContentInitializer.prototype.getCodecsSupportInfo = function (codecsToCheck) {
+        var _this = this;
+        var codecsSupportInfo = codecsToCheck.map(function (codecToCheck) {
+            var _a;
+            var inputCodec = "".concat(codecToCheck.mimeType, ";codecs=\"").concat(codecToCheck.codec, "\"");
+            var isSupported = (0, is_codec_supported_1.default)(inputCodec);
+            if (!isSupported) {
+                return {
+                    mimeType: codecToCheck.mimeType,
+                    codec: codecToCheck.codec,
+                    supported: false,
+                    supportedIfEncrypted: false,
+                };
+            }
+            /**
+             * `true` if the codec is supported when encrypted, `false` if it is not
+             * supported, or `undefined` if we cannot obtain that information.
+             */
+            var supportedIfEncrypted;
+            if (_this._decryptionCapabilities.status === "uninitialized") {
+                supportedIfEncrypted = undefined;
+            }
+            else if (_this._decryptionCapabilities.status === "disabled") {
+                // It's ambiguous here, but let's say that no ContentDecryptor means that
+                // the codec is supported by it.
+                supportedIfEncrypted = true;
+            }
+            else {
+                var contentDecryptor = _this._decryptionCapabilities.value;
+                if (contentDecryptor.getState() !== decrypt_1.ContentDecryptorState.Initializing) {
+                    // No information is available regarding the support status.
+                    // Defaulting to assume the codec is supported.
+                    supportedIfEncrypted =
+                        (_a = contentDecryptor.isCodecSupported(codecToCheck.mimeType, codecToCheck.codec)) !== null && _a !== void 0 ? _a : true;
+                }
+            }
+            return {
+                mimeType: codecToCheck.mimeType,
+                codec: codecToCheck.codec,
+                supported: isSupported,
+                supportedIfEncrypted: supportedIfEncrypted,
+            };
+        });
+        return codecsSupportInfo;
+    };
+    /**
+     * Update the support status of all Representations in the Manifest.
+     *
+     * To call anytime either the Manifest is linked to new codecs or new means
+     * to test for codec support are available.
+     * @param {Object} manifest
+     */
+    MediaSourceContentInitializer.prototype._refreshManifestCodecSupport = function (manifest) {
+        var codecsToTest = manifest.getCodecsWithUnknownSupport();
+        var codecsSupportInfo = this.getCodecsSupportInfo(codecsToTest);
+        if (codecsSupportInfo.length > 0) {
+            try {
+                manifest.updateCodecSupport(codecsSupportInfo);
+            }
+            catch (err) {
+                this._onFatalError(err);
+            }
+        }
+    };
     return MediaSourceContentInitializer;
 }(types_1.ContentInitializer));
 exports.default = MediaSourceContentInitializer;

package/dist/commonjs/main_thread/init/multi_thread_content_initializer.d.ts

@@ -1,10 +1,12 @@
-import type { IAdaptiveRepresentationSelectorArguments, IManifestFetcherSettings } from "../../core/types";
+import type { IMediaElement } from "../../compat/browser_compatibility_types";
+import type { IAdaptiveRepresentationSelectorArguments } from "../../core/types";
 import type { IManifestMetadata } from "../../manifest";
 import MainMediaSourceInterface from "../../mse/main_media_source_interface";
 import type { IMediaElementPlaybackObserver } from "../../playback_observer";
-import type { IKeySystemOption } from "../../public_types";
+import type { ICmcdOptions, IInitialManifest, IKeySystemOption } from "../../public_types";
 import type { ITransportOptions } from "../../transports";
 import type { IReadOnlySharedReference } from "../../utils/reference";
+import type IContentDecryptor from "../decrypt";
 import type { ITextDisplayerOptions } from "./types";
 import { ContentInitializer } from "./types";
 import type { IInitialTimeOptions } from "./utils/get_initial_time";
@@ -62,10 +64,17 @@ export default class MultiThreadContentInitializer extends ContentInitializer {
      * @param {HTMLMediaElement} mediaElement
      * @param {Object} playbackObserver
      */
-    start(mediaElement: HTMLMediaElement, playbackObserver: IMediaElementPlaybackObserver): void;
+    start(mediaElement: IMediaElement, playbackObserver: IMediaElementPlaybackObserver): void;
     dispose(): void;
     private _onFatalError;
     private _initializeContentDecryption;
+    /**
+     * Retrieves all unknown codecs from the current manifest, checks these unknown codecs
+     * to determine if they are supported, updates the manifest with the support
+     * status of these codecs, and forwards the list of supported codecs to the web worker.
+     * @param manifest
+     */
+    private _updateCodecSupport;
     private _hasTextBufferFeature;
     private _reload;
     /**
@@ -160,6 +169,12 @@ export interface IMultiThreadContentInitializerContentInfos {
      * Set to `null` when those considerations are not taken yet.
      */
     initialPlayPerformed: IReadOnlySharedReference<boolean> | null;
+    /**
+     * Set to the initialized `ContentDecryptor` instance linked to that content.
+     *
+     * Set to `null` when those considerations are not taken.
+     */
+    contentDecryptor: IContentDecryptor | null;
 }
 /** Arguments to give to the `InitializeOnMediaSource` function. */
 export interface IInitializeArguments {
@@ -186,6 +201,10 @@ export interface IInitializeArguments {
         /** Behavior when a new video and/or audio codec is encountered. */
         onCodecSwitch: "continue" | "reload";
     };
+    /**
+     * When set to an object, enable "Common Media Client Data", or "CMCD".
+     */
+    cmcd?: ICmcdOptions | undefined;
     /** Every encryption configuration set. */
     keySystems: IKeySystemOption[];
     /** `true` to play low-latency contents optimally. */
@@ -197,7 +216,30 @@ export interface IInitializeArguments {
         representationFilter: string | undefined;
     };
     /** Settings linked to Manifest requests. */
-    manifestRequestSettings: IManifestFetcherSettings;
+    manifestRequestSettings: {
+        /** Maximum number of time a request on error will be retried. */
+        maxRetry: number | undefined;
+        /**
+         * Timeout after which request are aborted and, depending on other options,
+         * retried.
+         * To set to `-1` for no timeout.
+         * `undefined` will lead to a default, large, timeout being used.
+         */
+        requestTimeout: number | undefined;
+        /**
+         * Connection timeout, in milliseconds, after which the request is canceled
+         * if the responses headers has not being received.
+         * Do not set or set to "undefined" to disable it.
+         */
+        connectionTimeout: number | undefined;
+        /** Limit the frequency of Manifest updates. */
+        minimumManifestUpdateInterval: number;
+        /**
+         * Potential first Manifest to rely on, allowing to skip the initial Manifest
+         * request.
+         */
+        initialManifest: IInitialManifest | undefined;
+    };
     /** Configuration for the segment requesting logic. */
     segmentRequestOptions: {
         lowLatencyMode: boolean;

package/dist/commonjs/main_thread/init/multi_thread_content_initializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi_thread_content_initializer.d.ts","sourceRoot":"","sources":["../../../../src/main_thread/init/multi_thread_content_initializer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"multi_thread_content_initializer.d.ts","sourceRoot":"","sources":["../../../../src/main_thread/init/multi_thread_content_initializer.ts"],"names":[],"mappings":"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"}