rx-player 4.1.0 → 4.2.0-dev.2024080600

package/src/experimental/tools/mediaCapabilitiesProber/__tests__/probers/defaultCodecFinder.test.ts

@@ -44,7 +44,7 @@ describe("MediaCapabilitiesProber probers - findDefaultVideoCodec", () => {
     expect(() => {
       findDefaultVideoCodec();
     }).toThrowError("No default video codec found.");
-    expect(mockIsTypeSupported).toHaveBeenCalledTimes(3);
+    expect(mockIsTypeSupported).toHaveBeenCalledTimes(4);
   });
 
   it("should throw because no MediaSource", async () => {

package/src/experimental/tools/mediaCapabilitiesProber/api/index.ts

@@ -58,7 +58,7 @@ const mediaCapabilitiesProber = {
    * @param {string} level
    */
   set LogLevel(level: string) {
-    log.setLevel(level);
+    log.setLevel(level, log.getFormat());
   },
 
   /**

package/src/experimental/tools/mediaCapabilitiesProber/probers/defaultCodecsFinder.ts

@@ -27,6 +27,7 @@ export function findDefaultVideoCodec(): string {
   const videoCodecs = [
     'video/mp4;codecs="avc1.4d401e"',
     'video/mp4;codecs="avc1.42e01e"',
+    'video/mp4;codecs="hvc1.1.6.L93.B0"',
     'video/webm;codecs="vp8"',
   ];
   /* eslint-disable @typescript-eslint/unbound-method */

package/src/features/features_object.ts

@@ -22,7 +22,6 @@ import type { IFeaturesObject } from "./types";
  */
 const features: IFeaturesObject = {
   dashParsers: { wasm: null, native: null, fastJs: null },
-  codecSupportProber: null,
   createDebugElement: null,
   directfile: null,
   decrypt: null,

package/src/features/list/__tests__/dash.test.ts

@@ -1,6 +1,5 @@
 import { describe, it, expect } from "vitest";
 import MediaSourceContentInitializer from "../../../main_thread/init/media_source_content_initializer";
-import mainCodecSupportProber from "../../../mse/main_codec_support_prober";
 import nativeDashParser from "../../../parsers/manifest/dash/native-parser";
 import DASHFeature from "../../../transports/dash";
 import type { IFeaturesObject } from "../../types";
@@ -18,10 +17,8 @@ describe("Features list - DASH", () => {
       transports: { dash: DASHFeature },
       dashParsers: { native: nativeDashParser, fastJs: null, wasm: null },
       mainThreadMediaSourceInit: MediaSourceContentInitializer,
-      codecSupportProber: mainCodecSupportProber,
     });
     expect(featureObject.transports.dash).toBe(DASHFeature);
     expect(featureObject.mainThreadMediaSourceInit).toBe(MediaSourceContentInitializer);
-    expect(featureObject.codecSupportProber).toBe(mainCodecSupportProber);
   });
 });

package/src/features/list/__tests__/smooth.test.ts

@@ -1,6 +1,5 @@
 import { describe, it, expect } from "vitest";
 import MediaSourceContentInitializer from "../../../main_thread/init/media_source_content_initializer";
-import mainCodecSupportProber from "../../../mse/main_codec_support_prober";
 import SmoothFeature from "../../../transports/smooth";
 import type { IFeaturesObject } from "../../types";
 import addSmoothFeature from "../smooth";
@@ -12,10 +11,8 @@ describe("Features list - Smooth", () => {
     expect(featureObject).toEqual({
       transports: { smooth: SmoothFeature },
       mainThreadMediaSourceInit: MediaSourceContentInitializer,
-      codecSupportProber: mainCodecSupportProber,
     });
     expect(featureObject.transports.smooth).toBe(SmoothFeature);
     expect(featureObject.mainThreadMediaSourceInit).toBe(MediaSourceContentInitializer);
-    expect(featureObject.codecSupportProber).toBe(mainCodecSupportProber);
   });
 });

package/src/features/list/dash.ts

@@ -15,7 +15,6 @@
  */
 
 import MediaSourceContentInitializer from "../../main_thread/init/media_source_content_initializer";
-import mainCodecSupportProber from "../../mse/main_codec_support_prober";
 import dashJsParser from "../../parsers/manifest/dash/native-parser";
 import dash from "../../transports/dash";
 import type { IFeaturesObject } from "../types";
@@ -30,7 +29,6 @@ function addDASHFeature(features: IFeaturesObject): void {
   }
   features.dashParsers.native = dashJsParser;
   features.mainThreadMediaSourceInit = MediaSourceContentInitializer;
-  features.codecSupportProber = mainCodecSupportProber;
 }
 
 export { addDASHFeature as DASH };

package/src/features/list/dash_wasm.ts

@@ -16,7 +16,6 @@
 
 import type { IFeaturesObject } from "../../features/types";
 import MediaSourceContentInitializer from "../../main_thread/init/media_source_content_initializer";
-import mainCodecSupportProber from "../../mse/main_codec_support_prober";
 import type { IDashWasmParserOptions } from "../../parsers/manifest/dash/wasm-parser";
 import DashWasmParser from "../../parsers/manifest/dash/wasm-parser";
 import dash from "../../transports/dash";
@@ -29,7 +28,6 @@ const dashWasmFeature = {
     }
     features.dashParsers.wasm = dashWasmParser;
     features.mainThreadMediaSourceInit = MediaSourceContentInitializer;
-    features.codecSupportProber = mainCodecSupportProber;
   },
 
   initialize(opts: IDashWasmParserOptions): Promise<void> {

package/src/features/list/smooth.ts

@@ -15,7 +15,6 @@
  */
 
 import MediaSourceContentInitializer from "../../main_thread/init/media_source_content_initializer";
-import mainCodecSupportProber from "../../mse/main_codec_support_prober";
 import smooth from "../../transports/smooth";
 import type { IFeaturesObject } from "../types";
 
@@ -28,7 +27,6 @@ function addSmoothFeature(features: IFeaturesObject): void {
     features.transports.smooth = smooth;
   }
   features.mainThreadMediaSourceInit = MediaSourceContentInitializer;
-  features.codecSupportProber = mainCodecSupportProber;
 }
 
 export { addSmoothFeature as SMOOTH };

package/src/features/types.ts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import type { IMediaElement } from "../compat/browser_compatibility_types";
 import type { SegmentSink } from "../core/segment_sinks";
 import type ContentDecryptor from "../main_thread/decrypt";
 import type DirectFileContentInitializer from "../main_thread/init/directfile_content_initializer";
@@ -23,7 +24,6 @@ import type HTMLTextDisplayer from "../main_thread/text_displayer/html";
 import type NativeTextDisplayer from "../main_thread/text_displayer/native/native_text_displayer";
 import type MediaElementTracksStore from "../main_thread/tracks_store/media_element_tracks_store";
 import type { IRxPlayer } from "../main_thread/types";
-import type { ICodecSupportProber } from "../mse";
 import type {
   IDashParserResponse,
   IMPDParserArguments,
@@ -46,7 +46,7 @@ import type { CancellationSignal } from "../utils/task_canceller";
  * @returns {Object} - `SegmentSink` implementation.
  */
 export type IHTMLTextTracksBuffer = new (
-  mediaElement: HTMLMediaElement,
+  mediaElement: IMediaElement,
   textTrackElement: HTMLElement,
 ) => SegmentSink;
 
@@ -59,7 +59,7 @@ export type IHTMLTextTracksBuffer = new (
  * tracks will be displayed will also be linked to this `HTMLMediaElement`.
  * @returns {Object} - `SegmentSink` implementation.
  */
-export type INativeTextTracksBuffer = new (mediaElement: HTMLMediaElement) => SegmentSink;
+export type INativeTextTracksBuffer = new (mediaElement: IMediaElement) => SegmentSink;
 
 export type IDashNativeParser = (
   dom: Document,
@@ -93,14 +93,6 @@ export type IDebugElementFn = (
  * an application.
  */
 export interface IFeaturesObject {
-  /**
-   * Interface checking for codec support in an MSE (Media Source Extensions)
-   * context.
-   *
-   * Works both for environments with and without the necessary MSE API such
-   * as WebWorkers.
-   */
-  codecSupportProber: ICodecSupportProber | null;
   /**
    * Feature allowing to load so-called "directfile" contents, which are
    * contents natively decodable by the browser.

package/src/index.ts

@@ -56,9 +56,9 @@ Player.addFeatures([
   HTML_SRT_PARSER,
 ]);
 if (isDebugModeEnabled()) {
-  logger.setLevel("DEBUG");
+  logger.setLevel("DEBUG", "standard");
 } else if ((__ENVIRONMENT__.CURRENT_ENV as number) === (__ENVIRONMENT__.DEV as number)) {
-  logger.setLevel(__LOGGER_LEVEL__.CURRENT_LEVEL);
+  logger.setLevel(__LOGGER_LEVEL__.CURRENT_LEVEL, "standard");
 }
 export default Player;
 

package/src/main_thread/README.md

@@ -31,7 +31,7 @@ Those modules are:
 
   Ease up text/audio/video track switching to provide a simple-to-use API.
 
-  It as another sister block the `MediaElementTracksStore`
+  It has another sister block the `MediaElementTracksStore`
   (./tracks_store/media_element_tracks_store.ts), has the same role but for "directfile"
   contents - which are contents directly played by the browser (by setting the media file
   as the `src` of a media element).

package/src/main_thread/api/__tests__/option_utils.test.ts

@@ -238,6 +238,7 @@ describe("API - parseLoadVideoOptions", () => {
     __priv_manifestUpdateUrl: undefined,
     __priv_patchLastSegmentInSidx: undefined,
     checkMediaSegmentIntegrity: undefined,
+    checkManifestIntegrity: undefined,
     defaultAudioTrackSwitchingMode: undefined,
     autoPlay: false,
     enableFastSwitching: true,

package/src/main_thread/api/__tests__/utils.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect } from "vitest";
+import type { IMediaElement } from "../../../compat/browser_compatibility_types";
 import config from "../../../config";
 import { getLoadedContentState } from "../utils";
 
@@ -10,7 +11,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 0,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
 
     // we can just do every possibility here
     expect(getLoadedContentState(mediaElement, null)).toBe("ENDED");
@@ -34,7 +35,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 10, // worst case -> currentTime === duration
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, null)).toBe("PLAYING");
   });
 
@@ -45,7 +46,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 10, // worst case -> currentTime === duration
       paused: true,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, null)).toBe("PAUSED");
   });
 
@@ -56,7 +57,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 5,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "buffering")).toBe("BUFFERING");
     fakeProps.paused = true;
     expect(getLoadedContentState(mediaElement, "buffering")).toBe("BUFFERING");
@@ -69,7 +70,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 5,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "freezing")).toBe("FREEZING");
     fakeProps.paused = true;
     expect(getLoadedContentState(mediaElement, "freezing")).toBe("FREEZING");
@@ -82,7 +83,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 5,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "not-ready")).toBe("BUFFERING");
     fakeProps.paused = true;
     expect(getLoadedContentState(mediaElement, "not-ready")).toBe("BUFFERING");
@@ -95,7 +96,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 5,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "seeking")).toBe("SEEKING");
     fakeProps.paused = true;
     expect(getLoadedContentState(mediaElement, "seeking")).toBe("SEEKING");
@@ -108,7 +109,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 10,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "seeking")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement, "buffering")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement, "not-ready")).toBe("ENDED");
@@ -127,7 +128,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 10 - config.getCurrent().FORCED_ENDED_THRESHOLD,
       paused: false,
     };
-    const mediaElement = fakeProps as HTMLMediaElement;
+    const mediaElement = fakeProps as IMediaElement;
     expect(getLoadedContentState(mediaElement, "seeking")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement, "buffering")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement, "not-ready")).toBe("ENDED");
@@ -145,7 +146,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: 10 - config.getCurrent().FORCED_ENDED_THRESHOLD,
       paused: false,
     };
-    const mediaElement1 = fakeProps1 as HTMLMediaElement;
+    const mediaElement1 = fakeProps1 as IMediaElement;
     expect(getLoadedContentState(mediaElement1, "seeking")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement1, "buffering")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement1, "not-ready")).toBe("ENDED");
@@ -162,7 +163,7 @@ describe("API - getLoadedContentState", () => {
       currentTime: config.getCurrent().FORCED_ENDED_THRESHOLD + 10,
       paused: false,
     };
-    const mediaElement2 = fakeProps2 as HTMLMediaElement;
+    const mediaElement2 = fakeProps2 as IMediaElement;
     expect(getLoadedContentState(mediaElement2, "seeking")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement2, "buffering")).toBe("ENDED");
     expect(getLoadedContentState(mediaElement2, "not-ready")).toBe("ENDED");

package/src/main_thread/api/option_utils.ts

@@ -19,6 +19,7 @@
  * throw if something is wrong, and return a normalized option object.
  */
 
+import type { IMediaElement } from "../../compat/browser_compatibility_types";
 import config from "../../config";
 import log from "../../log";
 import type {
@@ -33,6 +34,7 @@ import type {
   ISegmentLoader,
   IServerSyncInfos,
   IRxPlayerMode,
+  ICmcdOptions,
 } from "../../public_types";
 import arrayIncludes from "../../utils/array_includes";
 import isNullOrUndefined from "../../utils/is_null_or_undefined";
@@ -56,7 +58,7 @@ export interface IParsedConstructorOptions {
   videoResolutionLimit: "videoElement" | "screen" | "none";
   throttleVideoBitrateWhenHidden: boolean;
 
-  videoElement: HTMLMediaElement;
+  videoElement: IMediaElement;
   baseBandwidth: number;
 }
 
@@ -78,12 +80,14 @@ interface IParsedLoadVideoOptionsBase {
   defaultAudioTrackSwitchingMode: IAudioTrackSwitchingMode | undefined;
   onCodecSwitch: "continue" | "reload";
   checkMediaSegmentIntegrity?: boolean | undefined;
+  checkManifestIntegrity?: boolean | undefined;
   manifestLoader?: IManifestLoader | undefined;
   referenceDateTime?: number | undefined;
   representationFilter?: IRepresentationFilter | string | undefined;
   segmentLoader?: ISegmentLoader | undefined;
   serverSyncInfos?: IServerSyncInfos | undefined;
   mode: IRxPlayerMode;
+  cmcd: ICmcdOptions | undefined;
   __priv_manifestUpdateUrl?: string | undefined;
   __priv_patchLastSegmentInSidx?: boolean | undefined;
 }
@@ -130,7 +134,7 @@ function parseConstructorOptions(
   let wantedBufferAhead: number;
   let maxVideoBufferSize: number;
 
-  let videoElement: HTMLMediaElement;
+  let videoElement: IMediaElement;
   let baseBandwidth: number;
 
   const {
@@ -191,7 +195,10 @@ function parseConstructorOptions(
 
   if (isNullOrUndefined(options.videoElement)) {
     videoElement = document.createElement("video");
-  } else if (options.videoElement instanceof HTMLMediaElement) {
+  } else if (
+    options.videoElement.nodeName.toLowerCase() === "video" ||
+    options.videoElement.nodeName.toLowerCase() === "audio"
+  ) {
     videoElement = options.videoElement;
   } else {
     throw new Error("Invalid videoElement parameter. Should be a HTMLMediaElement.");
@@ -436,6 +443,7 @@ function parseLoadVideoOptions(options: ILoadVideoOptions): IParsedLoadVideoOpti
     /* eslint-enable @typescript-eslint/no-unsafe-assignment */
     /* eslint-enable @typescript-eslint/no-unsafe-member-access */
     checkMediaSegmentIntegrity: options.checkMediaSegmentIntegrity,
+    checkManifestIntegrity: options.checkManifestIntegrity,
     autoPlay,
     defaultAudioTrackSwitchingMode,
     enableFastSwitching,
@@ -456,6 +464,7 @@ function parseLoadVideoOptions(options: ILoadVideoOptions): IParsedLoadVideoOpti
     transport,
     mode,
     url,
+    cmcd: options.cmcd,
   };
 }
 

package/src/main_thread/api/public_api.ts

@@ -19,6 +19,7 @@
  * It also starts the different sub-parts of the player on various API calls.
  */
 
+import type { IMediaElement } from "../../compat/browser_compatibility_types";
 import canRelyOnVideoVisibilityAndSize from "../../compat/can_rely_on_video_visibility_and_size";
 import type { IPictureInPictureEvent } from "../../compat/event_listeners";
 import {
@@ -167,13 +168,13 @@ class Player extends EventEmitter<IPublicAPIEvent> {
    * This is used to check that a video element is not shared between multiple instances.
    * Use of a WeakSet ensure the object is garbage collected if it's not used anymore.
    */
-  private static _priv_currentlyUsedVideoElements = new WeakSet<HTMLMediaElement>();
+  private static _priv_currentlyUsedVideoElements = new WeakSet<IMediaElement>();
 
   /**
    * Media element attached to the RxPlayer.
    * Set to `null` when the RxPlayer is disposed.
    */
-  public videoElement: HTMLMediaElement | null; // null on dispose
+  public videoElement: IMediaElement | null; // null on dispose
 
   /** Logger the RxPlayer uses.  */
   public readonly log: Logger;
@@ -322,7 +323,21 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     return log.getLevel();
   }
   static set LogLevel(logLevel: string) {
-    log.setLevel(logLevel);
+    log.setLevel(logLevel, log.getFormat());
+  }
+
+  /**
+   * Current log format.
+   * Should be either (by verbosity ascending):
+   *   - "standard": Regular log messages.
+   *   - "full": More verbose format, including a timestamp and a namespace.
+   * Any other value will be translated to "standard".
+   */
+  static get LogFormat(): string {
+    return log.getFormat();
+  }
+  static set LogFormat(format: string) {
+    log.setLevel(log.getLevel(), format);
   }
 
   /**
@@ -338,7 +353,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
    * @param videoElement the video element to register.
    * @throws Error - Throws if the element is already used by another player instance.
    */
-  private static _priv_registerVideoElement(videoElement: HTMLMediaElement) {
+  private static _priv_registerVideoElement(videoElement: IMediaElement) {
     if (Player._priv_currentlyUsedVideoElements.has(videoElement)) {
       const errorMessage =
         "The video element is already attached to another RxPlayer instance." +
@@ -360,7 +375,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
    * Deregister the video element of the set of elements currently in use.
    * @param videoElement the video element to deregister.
    */
-  static _priv_deregisterVideoElement(videoElement: HTMLMediaElement) {
+  static _priv_deregisterVideoElement(videoElement: IMediaElement) {
     if (Player._priv_currentlyUsedVideoElements.has(videoElement)) {
       Player._priv_currentlyUsedVideoElements.delete(videoElement);
     }
@@ -394,7 +409,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     // See: https://bugzilla.mozilla.org/show_bug.cgi?id=1194624
     videoElement.preload = "auto";
 
-    this.version = /* PLAYER_VERSION */ "4.1.0";
+    this.version = /* PLAYER_VERSION */ "4.2.0-dev.2024080600";
     this.log = log;
     this.state = "STOPPED";
     this.videoElement = videoElement;
@@ -458,6 +473,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
         muted: videoElement.muted,
       });
     };
+
     videoElement.addEventListener("volumechange", onVolumeChange);
     destroyCanceller.signal.register(() => {
       videoElement.removeEventListener("volumechange", onVolumeChange);
@@ -531,6 +547,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
         value: {
           dashWasmUrl: workerSettings.dashWasmUrl,
           logLevel: log.getLevel(),
+          logFormat: log.getFormat(),
           sendBackLogs: isDebugModeEnabled(),
           date: Date.now(),
           timestamp: getMonotonicTimeStamp(),
@@ -540,7 +557,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
       });
       log.addEventListener(
         "onLogLevelChange",
-        (logLevel) => {
+        (logInfo) => {
           if (this._priv_worker === null) {
             return;
           }
@@ -548,7 +565,8 @@ class Player extends EventEmitter<IPublicAPIEvent> {
           this._priv_worker.postMessage({
             type: MainThreadMessageType.LogLevelUpdate,
             value: {
-              logLevel,
+              logLevel: logInfo.level,
+              logFormat: logInfo.format,
               sendBackLogs: isDebugModeEnabled(),
             },
           });
@@ -730,6 +748,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
   private _priv_initializeContentPlayback(options: IParsedLoadVideoOptions): void {
     const {
       autoPlay,
+      cmcd,
       defaultAudioTrackSwitchingMode,
       enableFastSwitching,
       initialManifest,
@@ -741,6 +760,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
       startAt,
       transport,
       checkMediaSegmentIntegrity,
+      checkManifestIntegrity,
       manifestLoader,
       referenceDateTime,
       segmentLoader,
@@ -884,6 +904,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
         const transportPipelines = transportFn({
           lowLatencyMode,
           checkMediaSegmentIntegrity,
+          checkManifestIntegrity,
           manifestLoader,
           referenceDateTime,
           representationFilter,
@@ -896,6 +917,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
           adaptiveOptions,
           autoPlay,
           bufferOptions,
+          cmcd,
           keySystems,
           lowLatencyMode,
           transport: transportPipelines,
@@ -924,6 +946,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
         const transportOptions = {
           lowLatencyMode,
           checkMediaSegmentIntegrity,
+          checkManifestIntegrity,
           referenceDateTime,
           serverSyncInfos,
           manifestLoader: undefined,
@@ -936,6 +959,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
           adaptiveOptions,
           autoPlay,
           bufferOptions,
+          cmcd,
           keySystems,
           lowLatencyMode,
           transportOptions,
@@ -1042,6 +1066,10 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     initializer.addEventListener("manifestUpdate", (updates) =>
       this._priv_onManifestUpdate(contentInfos, updates),
     );
+
+    initializer.addEventListener("codecSupportUpdate", () =>
+      this._priv_onCodecSupportUpdate(contentInfos),
+    );
     initializer.addEventListener("decipherabilityUpdate", (updates) =>
       this._priv_onDecipherabilityUpdate(contentInfos, updates),
     );
@@ -1249,9 +1277,11 @@ class Player extends EventEmitter<IPublicAPIEvent> {
    * @returns {HTMLMediaElement|null} - The HTMLMediaElement used (`null` when
    * disposed)
    */
+  /* eslint-disable @typescript-eslint/no-restricted-types */
   getVideoElement(): HTMLMediaElement | null {
-    return this.videoElement;
+    return this.videoElement as HTMLMediaElement;
   }
+  /* eslint-enable @typescript-eslint/no-restricted-types */
 
   /**
    * Returns the player's current state.
@@ -1425,8 +1455,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     }
     if (manifest !== null) {
       const currentTime = this.videoElement.currentTime;
-      const ast =
-        manifest.availabilityStartTime !== undefined ? manifest.availabilityStartTime : 0;
+      const ast = manifest.availabilityStartTime ?? 0;
       return currentTime + ast;
     }
     return 0;
@@ -2532,6 +2561,20 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     }
   }
 
+  /**
+   * Triggered each times the support for a codec has changed in the manifest.
+   * When triggered, the track store may need to consider selecting a new track.
+   *
+   * @param {Object} contentInfos
+   */
+  private _priv_onCodecSupportUpdate(contentInfos: IPublicApiContentInfos) {
+    const tStore = contentInfos?.tracksStore;
+    if (isNullOrUndefined(tStore)) {
+      return;
+    }
+    tStore.onManifestCodecSupportUpdate();
+  }
+
   private _priv_onDecipherabilityUpdate(
     contentInfos: IPublicApiContentInfos,
     elts: IDecipherabilityStatusChangedElement[],
@@ -2539,7 +2582,6 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     if (contentInfos === null || contentInfos.manifest === null) {
       return;
     }
-
     if (!isNullOrUndefined(contentInfos?.tracksStore)) {
       contentInfos.tracksStore.onDecipherabilityUpdates();
     }
@@ -3193,7 +3235,7 @@ class Player extends EventEmitter<IPublicAPIEvent> {
     }
   }
 }
-Player.version = /* PLAYER_VERSION */ "4.1.0";
+Player.version = /* PLAYER_VERSION */ "4.2.0-dev.2024080600";
 
 /** Every events sent by the RxPlayer's public API. */
 interface IPublicAPIEvent {

package/src/main_thread/api/utils.ts

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import type { IMediaElement } from "../../compat/browser_compatibility_types";
 import config from "../../config";
 import type {
   IPlaybackObservation,
@@ -40,7 +41,7 @@ import type { ContentInitializer, IStallingSituation } from "../init";
  * remove all listeners this function has registered.
  */
 export function emitSeekEvents(
-  mediaElement: HTMLMediaElement | null,
+  mediaElement: IMediaElement | null,
   playbackObserver: IReadOnlyPlaybackObserver<IPlaybackObservation>,
   onSeeking: () => void,
   onSeeked: () => void,
@@ -82,7 +83,7 @@ export function emitSeekEvents(
  * remove all listeners this function has registered.
  */
 export function emitPlayPauseEvents(
-  mediaElement: HTMLMediaElement | null,
+  mediaElement: IMediaElement | null,
   onPlay: () => void,
   onPause: () => void,
   cancelSignal: CancellationSignal,
@@ -114,7 +115,7 @@ export const enum PLAYER_STATES {
 
 export function constructPlayerStateReference(
   initializer: ContentInitializer,
-  mediaElement: HTMLMediaElement,
+  mediaElement: IMediaElement,
   playbackObserver: IReadOnlyPlaybackObserver<IPlaybackObservation>,
   cancelSignal: CancellationSignal,
 ): IReadOnlySharedReference<IPlayerState> {
@@ -212,7 +213,7 @@ export function constructPlayerStateReference(
  * @returns {string}
  */
 export function getLoadedContentState(
-  mediaElement: HTMLMediaElement,
+  mediaElement: IMediaElement,
   stalledStatus: IStallingSituation | null,
 ): IPlayerState {
   const { FORCED_ENDED_THRESHOLD } = config.getCurrent();