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

package/dist/es2017/compat/patch_webkit_source_buffer.js

@@ -13,8 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import nextTick from "next-tick";
 import EventEmitter from "../utils/event_emitter";
+import queueMicrotask from "../utils/queue_microtask";
 import globalScope from "./global_scope";
 import isNode from "./is_node";
 // TODO This is the last ugly side-effect here.
@@ -41,7 +41,7 @@ export default function patchWebkitSourceBuffer() {
         sourceBufferWebkitProto._listeners = [];
         sourceBufferWebkitProto._emitUpdate =
             function (eventName, val) {
-                nextTick(() => {
+                queueMicrotask(() => {
                     /* eslint-disable no-invalid-this */
                     this.trigger(eventName, val);
                     this.updating = false;

package/dist/es2017/core/api/option_utils.d.ts

@@ -103,6 +103,8 @@ declare function checkReloadOptions(options?: {
         position?: number;
         relative?: number;
     };
+    keySystems?: IKeySystemOption[];
+    autoPlay?: boolean;
 }): void;
 /**
  * Parse options given to loadVideo and set default options as found

package/dist/es2017/core/api/option_utils.js

@@ -139,6 +139,12 @@ function checkReloadOptions(options) {
         ((_d = options === null || options === void 0 ? void 0 : options.reloadAt) === null || _d === void 0 ? void 0 : _d.relative) !== undefined) {
         throw new Error("API: reload - Invalid 'reloadAt.relative' option format.");
     }
+    if (!Array.isArray(options === null || options === void 0 ? void 0 : options.keySystems) && (options === null || options === void 0 ? void 0 : options.keySystems) !== undefined) {
+        throw new Error("API: reload - Invalid 'keySystems' option format.");
+    }
+    if ((options === null || options === void 0 ? void 0 : options.autoPlay) !== undefined && typeof options.autoPlay !== "boolean") {
+        throw new Error("API: reload - Invalid 'autoPlay' option format.");
+    }
 }
 /**
  * Parse options given to loadVideo and set default options as found

package/dist/es2017/core/api/public_api.d.ts

@@ -16,7 +16,7 @@
 import { IErrorCode, IErrorType } from "../../errors";
 import { IFeature } from "../../features";
 import Manifest, { Adaptation, Representation } from "../../manifest";
-import { IAudioRepresentation, IAudioTrack, IAudioTrackSetting, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBrokenRepresentationsLockContext, IConstructorOptions, IKeySystemConfigurationOutput, ILoadVideoOptions, ILockedAudioRepresentationsSettings, ILockedVideoRepresentationsSettings, ITrackUpdateEventPayload, IRepresentationListUpdateContext, IPeriod, IPeriodChangeEvent, IPlayerError, IPlayerState, IPositionUpdate, IStreamEvent, ITextTrack, IVideoRepresentation, ITextTrackSetting, IVideoTrack, IVideoTrackSetting } from "../../public_types";
+import { IAudioRepresentation, IAudioTrack, IAudioTrackSetting, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBrokenRepresentationsLockContext, IConstructorOptions, IKeySystemConfigurationOutput, IKeySystemOption, ILoadVideoOptions, ILockedAudioRepresentationsSettings, ILockedVideoRepresentationsSettings, ITrackUpdateEventPayload, IRepresentationListUpdateContext, IPeriod, IPeriodChangeEvent, IPlayerError, IPlayerState, IPositionUpdate, IStreamEvent, ITextTrack, IVideoRepresentation, ITextTrackSetting, IVideoTrack, IVideoTrackSetting } from "../../public_types";
 import EventEmitter, { IListener } from "../../utils/event_emitter";
 import Logger from "../../utils/logger";
 import { IBufferedChunk, IBufferType } from "../segment_buffers";
@@ -159,6 +159,7 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
             position?: number;
             relative?: number;
         };
+        keySystems?: IKeySystemOption[];
         autoPlay?: boolean;
     }): void;
     createDebugElement(element: HTMLElement): {

package/dist/es2017/core/api/public_api.js

@@ -91,7 +91,7 @@ class Player extends EventEmitter {
         // 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 */ "4.0.0-dev.2023110700";
+        this.version = /* PLAYER_VERSION */ "4.0.0-dev.2023111400";
         this.log = log;
         this.state = "STOPPED";
         this.videoElement = videoElement;
@@ -186,7 +186,7 @@ class Player extends EventEmitter {
      * @param {Object} reloadOpts
      */
     reload(reloadOpts) {
-        var _a, _b;
+        var _a, _b, _c;
         const { options, manifest, reloadPosition, reloadInPause } = this._priv_reloadingMetadata;
         if (options === undefined) {
             throw new Error("API: Can't reload without having previously loaded a content.");
@@ -214,6 +214,13 @@ class Player extends EventEmitter {
         else if (reloadInPause !== undefined) {
             autoPlay = !reloadInPause;
         }
+        let keySystems;
+        if ((reloadOpts === null || reloadOpts === void 0 ? void 0 : reloadOpts.keySystems) !== undefined) {
+            keySystems = reloadOpts.keySystems;
+        }
+        else if (((_c = this._priv_reloadingMetadata.options) === null || _c === void 0 ? void 0 : _c.keySystems) !== undefined) {
+            keySystems = this._priv_reloadingMetadata.options.keySystems;
+        }
         const newOptions = Object.assign(Object.assign({}, options), { initialManifest: manifest });
         if (startAt !== undefined) {
             newOptions.startAt = startAt;
@@ -221,6 +228,9 @@ class Player extends EventEmitter {
         if (autoPlay !== undefined) {
             newOptions.autoPlay = autoPlay;
         }
+        if (keySystems !== undefined) {
+            newOptions.keySystems = keySystems;
+        }
         this._priv_initializeContentPlayback(newOptions);
     }
     createDebugElement(element) {
@@ -2097,5 +2107,5 @@ class Player extends EventEmitter {
         }
     }
 }
-Player.version = /* PLAYER_VERSION */ "4.0.0-dev.2023110700";
+Player.version = /* PLAYER_VERSION */ "4.0.0-dev.2023111400";
 export default Player;

package/dist/es2017/core/segment_buffers/implementations/text/html/text_track_cues_store.js

@@ -15,6 +15,22 @@
  */
 import assert from "../../../../../utils/assert";
 import { areNearlyEqual, getCuesAfter, getCuesBefore, removeCuesInfosBetween, } from "./utils";
+/**
+ * first or last IHTMLCue in a group can have a slighlty different start
+ * or end time than the start or end time of the ICuesGroup due to parsing
+ * approximation.
+ * DELTA_CUES_GROUP defines the tolerance level when comparing the start/end
+ * of a IHTMLCue to the start/end of a ICuesGroup.
+ * Having this value too high may lead to have unwanted subtitle displayed
+ * Having this value too low may lead to have subtitles not displayed
+ */
+const DELTA_CUES_GROUP = 1e-3;
+/**
+ * segment_duration / RELATIVE_DELTA_RATIO = relative_delta
+ *
+ * relative_delta is the tolerance to determine if two segements are the same
+ */
+const RELATIVE_DELTA_RATIO = 5;
 /**
  * Manage the buffer of the HTMLTextSegmentBuffer.
  * Allows to add, remove and recuperate cues at given times.
@@ -57,6 +73,18 @@ export default class TextTrackCuesStore {
                         ret.push(cues[j].element);
                     }
                 }
+                // first or last IHTMLCue in a group can have a slighlty different start
+                // or end time than the start or end time of the ICuesGroup due to parsing
+                // approximation.
+                // Add a tolerance of 1ms to fix this issue
+                if (ret.length === 0 && cues.length > 0) {
+                    for (let j = 0; j < cues.length; j++) {
+                        if (areNearlyEqual(time, cues[j].start, DELTA_CUES_GROUP)
+                            || areNearlyEqual(time, cues[j].end, DELTA_CUES_GROUP)) {
+                            ret.push(cues[j].element);
+                        }
+                    }
+                }
                 return ret;
             }
         }
@@ -143,6 +171,11 @@ export default class TextTrackCuesStore {
     insert(cues, start, end) {
         const cuesBuffer = this._cuesBuffer;
         const cuesInfosToInsert = { start, end, cues };
+        // it's preferable to have a delta depending on the duration of the segment
+        // if the delta is one fifth of the length of the segment:
+        // a segment of [0, 2] is the "same" segment as [0, 2.1]
+        // but [0, 0.04] is not the "same" segement as [0,04, 0.08]
+        const relativeDelta = Math.abs(start - end) / RELATIVE_DELTA_RATIO;
         /**
          * Called when we found the index of the next cue relative to the cue we
          * want to insert (that is a cue starting after its start or at the same
@@ -154,7 +187,7 @@ export default class TextTrackCuesStore {
         function onIndexOfNextCueFound(indexOfNextCue) {
             const nextCue = cuesBuffer[indexOfNextCue];
             if (nextCue === undefined || // no cue
-                areNearlyEqual(cuesInfosToInsert.end, nextCue.end)) // samey end
+                areNearlyEqual(cuesInfosToInsert.end, nextCue.end, relativeDelta)) // samey end
              {
                 //   ours:            |AAAAA|
                 //   the current one: |BBBBB|
@@ -190,8 +223,8 @@ export default class TextTrackCuesStore {
         for (let cueIdx = 0; cueIdx < cuesBuffer.length; cueIdx++) {
             let cuesInfos = cuesBuffer[cueIdx];
             if (start < cuesInfos.end) {
-                if (areNearlyEqual(start, cuesInfos.start)) {
-                    if (areNearlyEqual(end, cuesInfos.end)) {
+                if (areNearlyEqual(start, cuesInfos.start, relativeDelta)) {
+                    if (areNearlyEqual(end, cuesInfos.end, relativeDelta)) {
                         // exact same segment
                         //   ours:            |AAAAA|
                         //   the current one: |BBBBB|
@@ -239,7 +272,7 @@ export default class TextTrackCuesStore {
                         cuesBuffer.splice(cueIdx, 0, cuesInfosToInsert);
                         return;
                     }
-                    else if (areNearlyEqual(end, cuesInfos.start)) {
+                    else if (areNearlyEqual(end, cuesInfos.start, relativeDelta)) {
                         // our cue goes just before the current one:
                         //   ours:            |AAAAAAA|
                         //   the current one:         |BBBB|
@@ -251,7 +284,7 @@ export default class TextTrackCuesStore {
                         cuesBuffer.splice(cueIdx, 0, cuesInfosToInsert);
                         return;
                     }
-                    else if (areNearlyEqual(end, cuesInfos.end)) {
+                    else if (areNearlyEqual(end, cuesInfos.end, relativeDelta)) {
                         //   ours:            |AAAAAAA|
                         //   the current one:    |BBBB|
                         //   Result:          |AAAAAAA|
@@ -279,7 +312,7 @@ export default class TextTrackCuesStore {
                     return;
                 }
                 // else -> start > cuesInfos.start
-                if (areNearlyEqual(cuesInfos.end, end)) {
+                if (areNearlyEqual(cuesInfos.end, end, relativeDelta)) {
                     //   ours:              |AAAAAA|
                     //   the current one: |BBBBBBBB|
                     //   Result:          |BBAAAAAA|
@@ -315,6 +348,21 @@ export default class TextTrackCuesStore {
                 }
             }
         }
+        if (cuesBuffer.length) {
+            const lastCue = cuesBuffer[cuesBuffer.length - 1];
+            if (areNearlyEqual(lastCue.end, start, relativeDelta)) {
+                // Match the end of the previous cue to the start of the following one
+                // if they are close enough. If there is a small gap between two segments
+                // it can lead to having no subtitles for a short time, this is noticeable when
+                // two successive segments displays the same text, making it diseappear
+                // and reappear quickly, which gives the impression of blinking
+                //
+                //   ours:                   |AAAAA|
+                //   the current one: |BBBBB|...
+                //   Result:          |BBBBBBBAAAAA|
+                lastCue.end = start;
+            }
+        }
         // no cues group has the end after our current start.
         // These cues should be the last one
         cuesBuffer.push(cuesInfosToInsert);

package/dist/es2017/core/segment_buffers/implementations/text/html/utils.d.ts

@@ -18,9 +18,10 @@ import { ICuesGroup, IHTMLCue } from "./types";
  * @see MAX_DELTA_BUFFER_TIME
  * @param {Number} a
  * @param {Number} b
+ * @param {Number} delta
  * @returns {Boolean}
  */
-export declare function areNearlyEqual(a: number, b: number): boolean;
+export declare function areNearlyEqual(a: number, b: number, delta?: number): boolean;
 /**
  * Get all cues which have data before the given time.
  * @param {Object} cues

package/dist/es2017/core/segment_buffers/implementations/text/html/utils.js

@@ -44,6 +44,21 @@
  * Setting a value too high might lead to two segments targeting different times
  * to be wrongly believed to target the same time. In worst case scenarios, this
  * could lead to wanted text tracks being removed.
+ *
+ * When comparing 2 segments s1 and s2, you may want to take into account the duration
+ * of the segments:
+ *   - if s1 is [0, 2] and s2 is [0, 2.1] s1 and s2 can be considered as nearly equal as
+ *     there is a relative difference of: (2.1-2) / 2 = 5%;
+ *     Formula: (end_s1 - end_s2) / duration_s2 = relative_difference
+ *   - if s1 is [0, 0.04] and s2 is [0.04, 0.08] s1 and s2 may not considered as nearly
+ *     equal as there is a relative difference of: (0.04-0.08) / 0.04 = 100%
+ *
+ * To compare relatively to the duration of a segment you can provide and additional
+ * parameter "delta" that remplace MAX_DELTA_BUFFER_TIME.
+ * If parameter "delta" is higher than MAX_DELTA_BUFFER_TIME, MAX_DELTA_BUFFER_TIME
+ * is used instead of delta. This ensure that segments are nearly equal when comparing
+ * relatively AND absolutely.
+ *
  * @type Number
  */
 const MAX_DELTA_BUFFER_TIME = 0.2;
@@ -51,10 +66,11 @@ const MAX_DELTA_BUFFER_TIME = 0.2;
  * @see MAX_DELTA_BUFFER_TIME
  * @param {Number} a
  * @param {Number} b
+ * @param {Number} delta
  * @returns {Boolean}
  */
-export function areNearlyEqual(a, b) {
-    return Math.abs(a - b) <= MAX_DELTA_BUFFER_TIME;
+export function areNearlyEqual(a, b, delta = MAX_DELTA_BUFFER_TIME) {
+    return Math.abs(a - b) <= Math.min(delta, MAX_DELTA_BUFFER_TIME);
 }
 /**
  * Get all cues which have data before the given time.

package/dist/es2017/core/stream/adaptation/adaptation_stream.js

@@ -1,4 +1,3 @@
-import nextTick from "next-tick";
 import config from "../../../config";
 import { formatError } from "../../../errors";
 import log from "../../../log";
@@ -6,6 +5,7 @@ import assertUnreachable from "../../../utils/assert_unreachable";
 import cancellableSleep from "../../../utils/cancellable_sleep";
 import noop from "../../../utils/noop";
 import objectAssign from "../../../utils/object_assign";
+import queueMicrotask from "../../../utils/queue_microtask";
 import SharedReference, { createMappedReference, } from "../../../utils/reference";
 import TaskCanceller from "../../../utils/task_canceller";
 import RepresentationStream from "../representation";
@@ -133,7 +133,7 @@ export default function AdaptationStream({ playbackObserver, content, options, r
                 // conditions where the inner logic would be called synchronously before
                 // the next observation (which may reflect very different playback conditions)
                 // is actually received.
-                return nextTick(() => {
+                return queueMicrotask(() => {
                     playbackObserver.listen(() => {
                         if (fnCancelSignal.isCancelled()) {
                             return;

package/dist/es2017/core/stream/orchestrator/stream_orchestrator.js

@@ -13,10 +13,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import nextTick from "next-tick";
 import config from "../../../config";
 import { MediaError } from "../../../errors";
 import log from "../../../log";
+import queueMicrotask from "../../../utils/queue_microtask";
 import { createMappedReference, } from "../../../utils/reference";
 import SortedList from "../../../utils/sorted_list";
 import TaskCanceller from "../../../utils/task_canceller";
@@ -265,7 +265,7 @@ export default function StreamOrchestrator(content, playbackObserver, representa
             // Schedule micro task before checking the last playback observation
             // to reduce the risk of race conditions where the next observation
             // was going to be emitted synchronously.
-            nextTick(() => {
+            queueMicrotask(() => {
                 var _a;
                 if (orchestratorCancelSignal.isCancelled()) {
                     return;
@@ -430,7 +430,7 @@ export default function StreamOrchestrator(content, playbackObserver, representa
                             // conditions where the inner logic would be called synchronously before
                             // the next observation (which may reflect very different playback
                             // conditions) is actually received.
-                            return nextTick(() => {
+                            return queueMicrotask(() => {
                                 if (innerCancelSignal.isCancelled()) {
                                     return;
                                 }

package/dist/es2017/core/stream/period/period_stream.js

@@ -13,11 +13,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import nextTick from "next-tick";
 import config from "../../../config";
 import { formatError, MediaError, } from "../../../errors";
 import log from "../../../log";
 import objectAssign from "../../../utils/object_assign";
+import queueMicrotask from "../../../utils/queue_microtask";
 import { getLeftSizeOfBufferedTimeRange } from "../../../utils/ranges";
 import SharedReference from "../../../utils/reference";
 import TaskCanceller, { CancellationError, } from "../../../utils/task_canceller";
@@ -253,7 +253,7 @@ export default function PeriodStream({ bufferType, content, garbageCollectors, p
         // is actually received.
         // It can happen when `askForMediaSourceReload` is called as a side-effect of
         // the same event that triggers the playback observation to be emitted.
-        nextTick(() => {
+        queueMicrotask(() => {
             playbackObserver.listen(() => {
                 if (cancelSignal.isCancelled()) {
                     return;

package/dist/es2017/manifest/representation.js

@@ -27,6 +27,7 @@ class Representation {
      * @param {Object} args
      */
     constructor(args, opts) {
+        var _a;
         this.id = args.id;
         this.uniqueId = generateRepresentationUniqueId();
         this.bitrate = args.bitrate;
@@ -55,12 +56,24 @@ class Representation {
         this.cdnMetadata = args.cdnMetadata;
         this.index = args.index;
         if (opts.type === "audio" || opts.type === "video") {
-            const mimeTypeStr = this.getMimeTypeString();
-            const isSupported = isCodecSupported(mimeTypeStr);
-            if (!isSupported) {
-                log.info("Unsupported Representation", mimeTypeStr, this.id, this.bitrate);
+            this.isSupported = false;
+            // Supplemental codecs are defined as backwards-compatible codecs enhancing
+            // the experience of a base layer codec
+            if (args.supplementalCodecs !== undefined) {
+                const supplementalCodecMimeTypeStr = `${(_a = this.mimeType) !== null && _a !== void 0 ? _a : ""};codecs="${args.supplementalCodecs}"`;
+                if (isCodecSupported(supplementalCodecMimeTypeStr)) {
+                    this.codec = args.supplementalCodecs;
+                    this.isSupported = true;
+                }
+            }
+            if (!this.isSupported) {
+                const mimeTypeStr = this.getMimeTypeString();
+                const isSupported = isCodecSupported(mimeTypeStr);
+                if (!isSupported) {
+                    log.info("Unsupported Representation", mimeTypeStr, this.id, this.bitrate);
+                }
+                this.isSupported = isSupported;
             }
-            this.isSupported = isSupported;
         }
         else {
             this.isSupported = true; // TODO for other types

package/dist/es2017/parsers/manifest/dash/common/convert_supplemental_codecs.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts SCTE 214 supplemental codec string into RFC4281 codec string
+ *
+ * The returned value is a codec string respecting RFC6381
+ *
+ * SCTE 214 defines supplemental codecs as a whitespace-separated multiple list of
+ * codec strings
+ *
+ * RFC6381 defines codecs as a comma-separated list of codec strings.
+ *
+ * This two syntax differs and this parser is used to convert SCTE214
+ * to be compliant with what MSE APIs expect
+ *
+ * @param {string} val - The codec string to parse
+ * @returns { Array.<string | undefined | null>}
+ */
+export declare function convertSupplementalCodecsToRFC6381(val: string): string;

package/dist/es2017/parsers/manifest/dash/common/convert_supplemental_codecs.js

@@ -0,0 +1,26 @@
+import isNonEmptyString from "../../../../utils/is_non_empty_string";
+const supplementalCodecSeparator = /[, ]+/g;
+/**
+ * Converts SCTE 214 supplemental codec string into RFC4281 codec string
+ *
+ * The returned value is a codec string respecting RFC6381
+ *
+ * SCTE 214 defines supplemental codecs as a whitespace-separated multiple list of
+ * codec strings
+ *
+ * RFC6381 defines codecs as a comma-separated list of codec strings.
+ *
+ * This two syntax differs and this parser is used to convert SCTE214
+ * to be compliant with what MSE APIs expect
+ *
+ * @param {string} val - The codec string to parse
+ * @returns { Array.<string | undefined | null>}
+ */
+export function convertSupplementalCodecsToRFC6381(val) {
+    if (isNonEmptyString(val)) {
+        return val
+            .trim()
+            .replace(supplementalCodecSeparator, ", ");
+    }
+    return "";
+}

package/dist/es2017/parsers/manifest/dash/common/flatten_overlapping_periods.js

@@ -65,6 +65,11 @@ export default function flattenOverlappingPeriods(parsedPeriods) {
                 // `lastFlattenedPeriod` has now a negative or `0` duration.
                 // Remove it, consider the next Period in its place, and re-start the loop.
                 flattenedPeriods.pop();
+                if (flattenedPeriods.length === 0) {
+                    // There's no remaining Period to compare to `parsedPeriod`
+                    break;
+                }
+                // Take the previous Period as reference and compare it now to `parsedPeriod`
                 lastFlattenedPeriod = flattenedPeriods[flattenedPeriods.length - 1];
             }
         }

package/dist/es2017/parsers/manifest/dash/common/parse_representations.js

@@ -16,6 +16,7 @@
 import log from "../../../../log";
 import arrayFind from "../../../../utils/array_find";
 import objectAssign from "../../../../utils/object_assign";
+import { convertSupplementalCodecsToRFC6381 } from "./convert_supplemental_codecs";
 import { getWEBMHDRInformation } from "./get_hdr_information";
 import parseRepresentationIndex from "./parse_representation_index";
 import resolveBaseURLs from "./resolve_base_urls";
@@ -80,19 +81,19 @@ export default function parseRepresentations(representationsIR, adaptation, cont
     const parsedRepresentations = [];
     for (const representation of representationsIR) {
         // Compute Representation ID
-        let representationID = representation.attributes.id != null ?
+        let representationID = representation.attributes.id !== undefined ?
             representation.attributes.id :
             (String(representation.attributes.bitrate) +
-                (representation.attributes.height != null ?
+                (representation.attributes.height !== undefined ?
                     (`-${representation.attributes.height}`) :
                     "") +
-                (representation.attributes.width != null ?
+                (representation.attributes.width !== undefined ?
                     (`-${representation.attributes.width}`) :
                     "") +
-                (representation.attributes.mimeType != null ?
+                (representation.attributes.mimeType !== undefined ?
                     (`-${representation.attributes.mimeType}`) :
                     "") +
-                (representation.attributes.codecs != null ?
+                (representation.attributes.codecs !== undefined ?
                     (`-${representation.attributes.codecs}`) :
                     ""));
         // Avoid duplicate IDs
@@ -114,7 +115,7 @@ export default function parseRepresentations(representationsIR, adaptation, cont
         const representationIndex = parseRepresentationIndex(representation, reprIndexCtxt);
         // Find bitrate
         let representationBitrate;
-        if (representation.attributes.bitrate == null) {
+        if (representation.attributes.bitrate === undefined) {
             log.warn("DASH: No usable bitrate found in the Representation.");
             representationBitrate = 0;
         }
@@ -141,45 +142,56 @@ export default function parseRepresentations(representationsIR, adaptation, cont
         }
         // Add optional attributes
         let codecs;
-        if (representation.attributes.codecs != null) {
+        if (representation.attributes.codecs !== undefined) {
             codecs = representation.attributes.codecs;
         }
-        else if (adaptation.attributes.codecs != null) {
+        else if (adaptation.attributes.codecs !== undefined) {
             codecs = adaptation.attributes.codecs;
         }
-        if (codecs != null) {
+        if (codecs !== undefined) {
             codecs = codecs === "mp4a.40.02" ? "mp4a.40.2" : codecs;
             parsedRepresentation.codecs = codecs;
         }
-        if (representation.attributes.frameRate != null) {
+        let supplementalCodecs;
+        if (representation.attributes.supplementalCodecs !== undefined) {
+            supplementalCodecs = representation.attributes.supplementalCodecs;
+        }
+        else if (adaptation.attributes.supplementalCodecs !== undefined) {
+            supplementalCodecs = adaptation.attributes.supplementalCodecs;
+        }
+        if (supplementalCodecs !== undefined) {
+            parsedRepresentation.supplementalCodecs =
+                convertSupplementalCodecsToRFC6381(supplementalCodecs);
+        }
+        if (representation.attributes.frameRate !== undefined) {
             parsedRepresentation.frameRate =
                 representation.attributes.frameRate;
         }
-        else if (adaptation.attributes.frameRate != null) {
+        else if (adaptation.attributes.frameRate !== undefined) {
             parsedRepresentation.frameRate =
                 adaptation.attributes.frameRate;
         }
-        if (representation.attributes.height != null) {
+        if (representation.attributes.height !== undefined) {
             parsedRepresentation.height =
                 representation.attributes.height;
         }
-        else if (adaptation.attributes.height != null) {
+        else if (adaptation.attributes.height !== undefined) {
             parsedRepresentation.height =
                 adaptation.attributes.height;
         }
-        if (representation.attributes.mimeType != null) {
+        if (representation.attributes.mimeType !== undefined) {
             parsedRepresentation.mimeType =
                 representation.attributes.mimeType;
         }
-        else if (adaptation.attributes.mimeType != null) {
+        else if (adaptation.attributes.mimeType !== undefined) {
             parsedRepresentation.mimeType =
                 adaptation.attributes.mimeType;
         }
-        if (representation.attributes.width != null) {
+        if (representation.attributes.width !== undefined) {
             parsedRepresentation.width =
                 representation.attributes.width;
         }
-        else if (adaptation.attributes.width != null) {
+        else if (adaptation.attributes.width !== undefined) {
             parsedRepresentation.width =
                 adaptation.attributes.width;
         }

package/dist/es2017/parsers/manifest/dash/js-parser/node_parsers/AdaptationSet.js

@@ -240,6 +240,9 @@ function parseAdaptationSetAttributes(root) {
             case "codecs":
                 parsedAdaptation.codecs = attribute.value;
                 break;
+            case "scte214:supplementalCodecs":
+                parsedAdaptation.supplementalCodecs = attribute.value;
+                break;
             case "codingDependency":
                 parseValue(attribute.value, { asKey: "codingDependency",
                     parser: parseBoolean,

package/dist/es2017/parsers/manifest/dash/js-parser/node_parsers/Representation.js

@@ -149,6 +149,9 @@ function parseRepresentationAttributes(representationElement) {
                     parser: parseMPDInteger,
                     dashName: "qualityRanking" });
                 break;
+            case "scte214:supplementalCodecs":
+                attributes.supplementalCodecs = attr.value;
+                break;
             case "segmentProfiles":
                 attributes.segmentProfiles = attr.value;
                 break;

package/dist/es2017/parsers/manifest/dash/node_parser_types.d.ts

@@ -217,6 +217,7 @@ export interface IAdaptationSetAttributes {
     segmentAlignment?: number | boolean;
     segmentProfiles?: string;
     subsegmentAlignment?: number | boolean;
+    supplementalCodecs?: string;
     width?: number;
     availabilityTimeComplete?: boolean;
     availabilityTimeOffset?: number;
@@ -249,6 +250,7 @@ export interface IRepresentationAttributes {
     profiles?: string;
     qualityRanking?: number;
     segmentProfiles?: string;
+    supplementalCodecs?: string;
     width?: number;
     availabilityTimeComplete?: boolean;
     availabilityTimeOffset?: number;

package/dist/es2017/parsers/manifest/dash/wasm-parser/ts/generators/AdaptationSet.js

@@ -222,6 +222,10 @@ export function generateAdaptationSetAttrParser(adaptationAttrs, linearMemory) {
                 adaptationAttrs.codecs =
                     parseString(textDecoder, linearMemory.buffer, ptr, len);
                 break;
+            case 77 /* AttributeName.SupplementalCodecs */:
+                adaptationAttrs.supplementalCodecs =
+                    parseString(textDecoder, linearMemory.buffer, ptr, len);
+                break;
             case 2 /* AttributeName.Profiles */:
                 adaptationAttrs.profiles =
                     parseString(textDecoder, linearMemory.buffer, ptr, len);

package/dist/es2017/parsers/manifest/dash/wasm-parser/ts/generators/Representation.js

@@ -122,6 +122,10 @@ export function generateRepresentationAttrParser(representationAttrs, linearMemo
                 representationAttrs.codecs =
                     parseString(textDecoder, linearMemory.buffer, ptr, len);
                 break;
+            case 77 /* AttributeName.SupplementalCodecs */:
+                representationAttrs.supplementalCodecs =
+                    parseString(textDecoder, linearMemory.buffer, ptr, len);
+                break;
             case 5 /* AttributeName.CodingDependency */:
                 representationAttrs.codingDependency =
                     new DataView(linearMemory.buffer).getUint8(0) === 0;

package/dist/es2017/parsers/manifest/dash/wasm-parser/ts/types.d.ts

@@ -140,5 +140,6 @@ export declare const enum AttributeName {
     QueryBeforeStart = 73,
     ProxyServerUrl = 74,
     DefaultServiceLocation = 75,
-    EndNumber = 76
+    EndNumber = 76,
+    SupplementalCodecs = 77
 }

package/dist/es2017/parsers/manifest/types.d.ts

@@ -154,6 +154,7 @@ export interface IParsedRepresentation {
     hdrInfo?: IHDRInformation | undefined;
     /** `true` if audio has Dolby Atmos. */
     isSpatialAudio?: boolean | undefined;
+    supplementalCodecs?: string | undefined;
 }
 /** Every possible types an Adaptation can have. */
 export type IParsedAdaptationType = "audio" | "video" | "text";