rx-player 3.33.0 → 3.33.1

package/src/parsers/manifest/dash/common/__tests__/parse_availability_start_time.test.ts

@@ -1,63 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import parseAvailabilityStartTime from "../parse_availability_start_time";
-
-describe("parseAvailabilityStartTime", function() {
-  it("should return 0 for a non-dynamic MPD", () => {
-    expect(parseAvailabilityStartTime({ type: "static" }, 100)).toEqual(0);
-    expect(parseAvailabilityStartTime({}, 100)).toEqual(0);
-    expect(parseAvailabilityStartTime({ type: "static" })).toEqual(0);
-    expect(parseAvailabilityStartTime({})).toEqual(0);
-
-    expect(parseAvailabilityStartTime({
-      type: "static",
-      availabilityStartTime: 5,
-    })).toEqual(0);
-
-    expect(parseAvailabilityStartTime({
-      type: "static",
-      availabilityStartTime: 5,
-    }, 10)).toEqual(0);
-  });
-
-  it("should return the availabilityStartTime if set for dynamic contents", () => {
-    expect(parseAvailabilityStartTime({
-      type: "dynamic",
-      availabilityStartTime: 5,
-    })).toEqual(5);
-    expect(parseAvailabilityStartTime({
-      type: "dynamic",
-      availabilityStartTime: 6,
-    }, 100)).toEqual(6);
-  });
-
-  /* eslint-disable max-len */
-  it("should return the referenceDateTime if set and no availabilityStartTime if set for dynamic contents", () => {
-  /* eslint-enable max-len */
-    expect(parseAvailabilityStartTime({
-      type: "dynamic",
-    }, 100)).toEqual(100);
-  });
-
-  /* eslint-disable max-len */
-  it("should return `0` if neither a referenceDateTime is given nor an availabilityStartTime is set for dynamic contents", () => {
-  /* eslint-enable max-len */
-    expect(parseAvailabilityStartTime({
-      type: "dynamic",
-    })).toEqual(0);
-  });
-});

package/src/parsers/manifest/dash/common/attach_trickmode_track.ts

@@ -1,55 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { SUPPORTED_ADAPTATIONS_TYPE } from "../../../../manifest";
-import {
-  IParsedAdaptation,
-  IParsedAdaptations,
-} from "../../types";
-
-/**
- * Attach trick mode tracks to adaptations by assigning to the trickModeTracks
- * property an array of trick mode track adaptations.
- * @param {Object} adaptations
- * @param {Array.<Object>} trickModeTracks
- * @returns {void}
- */
-function attachTrickModeTrack(
-  adaptations: IParsedAdaptations,
-  trickModeTracks: Array<{ adaptation: IParsedAdaptation;
-                           trickModeAttachedAdaptationIds: string[]; }>
-): void {
-  for (const track of trickModeTracks) {
-    const { adaptation, trickModeAttachedAdaptationIds } = track;
-    for (const trickModeAttachedAdaptationId of trickModeAttachedAdaptationIds) {
-      for (const adaptationType of SUPPORTED_ADAPTATIONS_TYPE) {
-        const adaptationsByType = adaptations[adaptationType];
-        if (adaptationsByType !== undefined) {
-          for (const adaptationByType of adaptationsByType) {
-            if (adaptationByType.id === trickModeAttachedAdaptationId) {
-              if (adaptationByType.trickModeTracks === undefined) {
-                adaptationByType.trickModeTracks = [];
-              }
-              adaptationByType.trickModeTracks.push(adaptation);
-            }
-          }
-        }
-      }
-    }
-  }
-}
-
-export default attachTrickModeTrack;

package/src/parsers/manifest/dash/common/convert_supplemental_codecs.ts

@@ -1,32 +0,0 @@
-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: string
-) : string {
-
-  if (isNonEmptyString(val)) {
-    return val
-      .trim()
-      .replace(supplementalCodecSeparator, ", ");
-  }
-  return "";
-}
-
-

package/src/parsers/manifest/dash/common/flatten_overlapping_periods.ts

@@ -1,87 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import log from "../../../../log";
-import { IParsedPeriod } from "../../types";
-
-/**
- * Avoid periods to overlap.
- *
- * According to DASH guidelines, if a period has media duration longer than
- * the distance between the start of this period and the start of the next period,
- * use of start times implies that the client will start the playout of the next
- * period at the time stated, rather than finishing the playout of the last period.
- *
- * Even if that case if defined when period last(s) segment(s) is/are a bit longer,
- * it can be meaningful when two periods are overlapping. We will always shorten
- * the first period, and even erase it if its duration is equal to zero.
- *
- * Example (Periods are numbered under their manifest order) :
- *
- * [ Period 1 ][ Period 2 ]       ------>  [ Period 1 ][ Period 3 ]
- *             [ Period 3 ]
- *
- * [ Period 1 ][ Period 2 ]       ------>  [ Period 1 ][  2  ][ Period 3 ]
- *                  [ Period 3 ]
- *
- * [ Period 1 ][ Period 2 ]       ------>  [  1  ][      Period 3     ]
- *        [      Period 3     ]
- *
- * @param {Array.<Object>} parsedPeriods
- * @return {Array.<Object>}
- */
-export default function flattenOverlappingPeriods(
-  parsedPeriods: IParsedPeriod[]
-): IParsedPeriod[] {
-  if (parsedPeriods.length === 0) {
-    return [];
-  }
-  const flattenedPeriods : IParsedPeriod[] = [parsedPeriods[0]];
-  for (let i = 1; i < parsedPeriods.length; i++) {
-    const parsedPeriod = parsedPeriods[i];
-    let lastFlattenedPeriod = flattenedPeriods[flattenedPeriods.length - 1];
-    while (
-      lastFlattenedPeriod.duration === undefined ||
-      (lastFlattenedPeriod.start + lastFlattenedPeriod.duration) > parsedPeriod.start
-    ) {
-      log.warn("DASH: Updating overlapping Periods.",
-               lastFlattenedPeriod?.start,
-               parsedPeriod.start);
-      lastFlattenedPeriod.duration = parsedPeriod.start - lastFlattenedPeriod.start;
-      lastFlattenedPeriod.end = parsedPeriod.start;
-      if (lastFlattenedPeriod.duration > 0) {
-        // Note: Calling `break` to quit the while loop should theoritically be
-        // unnecessary as the previous operations should ensure we do not re-enter
-        // the loop's condition.
-        // Yet we dit encounter infinite loops without it because of float-related
-        // rounding errors.
-        break;
-      } else {
-        // `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];
-      }
-    }
-    flattenedPeriods.push(parsedPeriod);
-  }
-  return flattenedPeriods;
-}

package/src/parsers/manifest/dash/common/get_clock_offset.ts

@@ -1,41 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import log from "../../../../log";
-
-/**
- * Get difference between the server's clock, in milliseconds and the return of
- * the JS function `performance.now`.
- * This property allows to calculate the server time at any moment.
- *
- * `undefined` if we could not define such offset (in which case, you could have
- * to rely on the user's clock instead).
- *
- * For example, a response of 1000 would mean that performance.now() is 1 second
- * behind the server's time.
- * @param {string} serverClock
- * @returns {number|undefined}
- */
-export default function getClockOffset(
-  serverClock: string
-): number | undefined {
-  const httpOffset = Date.parse(serverClock) - performance.now();
-  if (isNaN(httpOffset)) {
-    log.warn("DASH Parser: Invalid clock received: ", serverClock);
-    return undefined;
-  }
-  return httpOffset;
-}

package/src/parsers/manifest/dash/common/get_hdr_information.ts

@@ -1,94 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * Information about the HDR characteristic of a content.
- */
-export interface IParsedWEBMHDRInformation {
-  /**
-   * It is the bit depth used for encoding color for a pixel.
-   *
-   * It is used to ask to the user agent if the color depth is supported by the
-   * output device.
-   */
-  colorDepth: number;
-  /**
-   * It is the HDR eotf. It is the transfer function having the video signal as
-   * input and converting it into the linear light output of the display. The
-   * conversion is done within the display device.
-   *
-   * It may be used here to ask the MediaSource if it supported.
-   */
-  eotf: "pq" | "hlg";
-  /**
-   * It is the video color space used for encoding. An HDR content may not have
-   * a wide color gamut.
-   *
-   * It may be used to ask about output device color space support.
-   */
-  colorSpace: "rec2020" | undefined;
-}
-
-/**
- * Extract the webm HDR information out of the codec string.
- * The syntax of the codec string is defined in VP Codec ISO Media File Format
- * Binding, in the section Codecs Parameter String.
- * @param {string} codecString
- * @returns {Object | undefined}
- */
-export function getWEBMHDRInformation(
-  codecString: string
-): undefined | IParsedWEBMHDRInformation {
-  // cccc.PP.LL.DD.CC[.cp[.tc[.mc[.FF]]]]
-  const [cccc, _PP, _LL, DD, _CC, cp, tc, mc] = codecString.split(".");
-  if (cccc !== "vp08" &&
-      cccc !== "vp09" &&
-      cccc !== "vp10") {
-    return undefined;
-  }
-
-  let colorDepth: number | undefined;
-  let eotf: "pq" | "hlg" | undefined;
-  let colorSpace: "rec2020" | undefined;
-
-  if (DD !== undefined &&
-      DD === "10" ||
-      DD === "12") {
-    colorDepth = parseInt(DD, 10);
-  }
-
-  if (tc !== undefined) {
-    if (tc === "16") {
-      eotf = "pq";
-    } else if (tc === "18") {
-      eotf = "hlg";
-    }
-  }
-
-  if (cp !== undefined &&
-      mc !== undefined &&
-      cp === "09" &&
-      mc === "09") {
-    colorSpace = "rec2020";
-  }
-
-  if (colorDepth === undefined ||
-      eotf === undefined) {
-    return undefined;
-  }
-
-  return { colorDepth, eotf, colorSpace };
-}

package/src/parsers/manifest/dash/common/get_http_utc-timing_url.ts

@@ -1,46 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { IMPDIntermediateRepresentation } from "../node_parser_types";
-
-type ISupportedHttpUtcTimingScheme =
-  {
-    schemeIdUri : "urn:mpeg:dash:utc:http-iso:2014";
-    value : string;
-  } |
-  {
-    schemeIdUri : "urn:mpeg:dash:utc:http-xsdate:2014";
-    value : string;
-  };
-
-/**
- * @param {Object} mpdIR
- * @returns {string|undefined}
- */
-export default function getHTTPUTCTimingURL(
-  mpdIR : IMPDIntermediateRepresentation
-) : string|undefined {
-  const UTCTimingHTTP = mpdIR.children.utcTimings
-    .filter((utcTiming) : utcTiming is ISupportedHttpUtcTimingScheme =>
-      (
-        utcTiming.schemeIdUri === "urn:mpeg:dash:utc:http-iso:2014" ||
-        utcTiming.schemeIdUri === "urn:mpeg:dash:utc:http-xsdate:2014"
-      ) && utcTiming.value !== undefined
-    );
-
-  return UTCTimingHTTP.length > 0 ? UTCTimingHTTP[0].value :
-                                    undefined;
-}

package/src/parsers/manifest/dash/common/get_minimum_and_maximum_positions.ts

@@ -1,39 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { IParsedPeriod } from "../../types";
-import getMaximumPositions from "../../utils/get_maximum_positions";
-import getMinimumPosition from "../../utils/get_minimum_position";
-
-/**
- * @param {Object} periods
- * @returns {Array.<number>}
- */
-export default function getMinimumAndMaximumPositions(
-  periods: IParsedPeriod[]
-) : { minimumSafePosition : number | undefined;
-      maximumSafePosition : number | undefined;
-      maximumUnsafePosition : number | undefined; } {
-  if (periods.length === 0) {
-    throw new Error("DASH Parser: no period available for a dynamic content");
-  }
-
-  const minimumSafePosition = getMinimumPosition(periods);
-  const maxPositions = getMaximumPositions(periods);
-  return { minimumSafePosition,
-           maximumSafePosition: maxPositions.safe,
-           maximumUnsafePosition: maxPositions.unsafe };
-}

package/src/parsers/manifest/dash/common/get_periods_time_infos.ts

@@ -1,91 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { IPeriodIntermediateRepresentation } from "../node_parser_types";
-
-/** Time information from a Period. */
-interface IPeriodTimeInformation {
-  /** Time in seconds at which the Period starts. */
-  periodStart: number;
-  /** Difference in seconds between the Period's end and its start. */
-  periodDuration?: number | undefined;
-  /** Time in seconds at which the Period ends. */
-  periodEnd?: number | undefined;
-}
-
-/** Additionnal context needed to retrieve the period time information. */
-export interface IParsedPeriodsContext {
-  /** Value of MPD@availabilityStartTime. */
-  availabilityStartTime : number;
-  /** Value of MPD@mediaPresentationDuration. */
-  duration? : number | undefined;
-  /** `true` if MPD@type is equal to "dynamic". */
-  isDynamic : boolean;
-}
-
-/**
- * Get periods time information from current, next and previous
- * periods.
- * @param {Array.<Object>} periodsIR
- * @param {Object} manifestInfos
- * @return {Array.<Object>}
- */
-export default function getPeriodsTimeInformation(
-  periodsIR : IPeriodIntermediateRepresentation[],
-  manifestInfos : IParsedPeriodsContext
-): IPeriodTimeInformation[] {
-  const periodsTimeInformation: IPeriodTimeInformation[] = [];
-  periodsIR.forEach((currentPeriod, i) => {
-
-    let periodStart : number;
-    if (currentPeriod.attributes.start != null) {
-      periodStart = currentPeriod.attributes.start;
-    } else {
-      if (i === 0) {
-        periodStart = (!manifestInfos.isDynamic ||
-                       manifestInfos.availabilityStartTime == null) ?
-                         0 :
-                         manifestInfos.availabilityStartTime;
-      } else {
-        // take time information from previous period
-        const prevPeriodInfos =
-          periodsTimeInformation[periodsTimeInformation.length - 1];
-        if (prevPeriodInfos != null && prevPeriodInfos.periodEnd != null) {
-          periodStart = prevPeriodInfos.periodEnd;
-        } else {
-          throw new Error("Missing start time when parsing periods.");
-        }
-      }
-    }
-
-    let periodDuration : number | undefined;
-    const nextPeriod = periodsIR[i + 1];
-    if (currentPeriod.attributes.duration != null) {
-      periodDuration = currentPeriod.attributes.duration;
-    } else if (i === periodsIR.length - 1) {
-      periodDuration = manifestInfos.duration;
-    } else if (nextPeriod.attributes.start != null) {
-      periodDuration = nextPeriod.attributes.start - periodStart;
-    }
-
-    const periodEnd = periodDuration != null ? (periodStart + periodDuration) :
-                                               undefined;
-    periodsTimeInformation.push({ periodStart,
-                                  periodDuration,
-                                  periodEnd });
-  });
-  return periodsTimeInformation;
-}

package/src/parsers/manifest/dash/common/index.ts

@@ -1,40 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import {
-  BaseRepresentationIndex,
-  ListRepresentationIndex,
-  TemplateRepresentationIndex,
-  TimelineRepresentationIndex,
-} from "./indexes";
-import parseMpdIr, {
-  IIrParserResponse,
-  ILoadedXlinkData,
-  IMPDParserArguments,
-} from "./parse_mpd";
-
-export default parseMpdIr;
-export {
-  IIrParserResponse,
-  ILoadedXlinkData,
-  IMPDParserArguments,
-};
-export {
-  BaseRepresentationIndex,
-  ListRepresentationIndex,
-  TemplateRepresentationIndex,
-  TimelineRepresentationIndex,
-};

package/src/parsers/manifest/dash/common/indexes/__tests__/tokens.test.ts

@@ -1,60 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import {
-  createDashUrlDetokenizer,
-  replaceRepresentationDASHTokens,
-} from "../tokens";
-
-describe("dash parser tokens helpers", function() {
-  describe("createDashUrlDetokenizer", () => {
-    it("should correctly parse time token", function() {
-      expect(createDashUrlDetokenizer(1000, undefined)("Example_Token_$Time$"))
-        .toBe("Example_Token_1000");
-    });
-    it("should correctly parse number token", function() {
-      expect(createDashUrlDetokenizer(1000, 3)("Example_Token_$Number$"))
-        .toBe("Example_Token_3");
-    });
-    it("should correctly parse both time and number token", function() {
-      expect(createDashUrlDetokenizer(1000, 3)("Example_Token_$Number$_$Time$"))
-        .toBe("Example_Token_3_1000");
-    });
-    it("should not replace undefined tokens", function() {
-      expect(createDashUrlDetokenizer(1000, 3)("Example_Token_$Nmber$_$ime$"))
-        .toBe("Example_Token_$Nmber$_$ime$");
-    });
-    it("should return segment name if no token", function() {
-      expect(createDashUrlDetokenizer(undefined, undefined)("Example_Token"))
-        .toBe("Example_Token");
-    });
-  });
-
-  describe("replaceRepresentationDASHTokens", () => {
-    it("should correctly parse ID token", function() {
-      expect(replaceRepresentationDASHTokens("Example_$RepresentationID$", "fakeId"))
-        .toBe("Example_fakeId");
-    });
-    it("should correctly parse bitrate token", function() {
-      expect(replaceRepresentationDASHTokens("Example_$Bandwidth$", "", 3000))
-        .toBe("Example_3000");
-    });
-    it("should return segment name if no token", function() {
-      expect(replaceRepresentationDASHTokens("Example_Token"))
-        .toBe("Example_Token");
-    });
-  });
-});