rx-player 3.33.0 → 3.33.1

package/src/parsers/manifest/dash/js-parser/parse_from_document.ts

@@ -1,129 +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 assertUnreachable from "../../../../utils/assert_unreachable";
-import isNullOrUndefined from "../../../../utils/is_null_or_undefined";
-import parseMpdIr, {
-  IIrParserResponse,
-  ILoadedXlinkData,
-  IMPDParserArguments,
-} from "../common";
-import { IPeriodIntermediateRepresentation } from "../node_parser_types";
-import { IDashParserResponse, ILoadedResource } from "../parsers_types";
-import {
-  createMPDIntermediateRepresentation,
-} from "./node_parsers/MPD";
-import {
-  createPeriodIntermediateRepresentation,
-} from "./node_parsers/Period";
-
-/**
- * Parse MPD through the JS parser, on a `Document` instance.
- * @param {Document} document - Original manifest as returned by the server
- * @param {Object} args - Various parsing options and information.
- * @returns {Object} - Response returned by the DASH-JS parser.
- */
-export default function parseFromDocument(
-  document: Document,
-  args : IMPDParserArguments
-) : IDashParserResponse<string> {
-  const root = document.documentElement;
-  if (isNullOrUndefined(root) || root.nodeName !== "MPD") {
-    throw new Error("DASH Parser: document root should be MPD");
-  }
-
-  const [mpdIR,
-         warnings] = createMPDIntermediateRepresentation(root);
-  const ret = parseMpdIr(mpdIR, args, warnings);
-  return processReturn(ret);
-
-  /**
-   * Handle `parseMpdIr` return values, asking for resources if they are needed
-   * and pre-processing them before continuing parsing.
-   *
-   * @param {Object} initialRes
-   * @returns {Object}
-   */
-  function processReturn(initialRes : IIrParserResponse) : IDashParserResponse<string> {
-    if (initialRes.type === "done") {
-      return initialRes;
-    } else if (initialRes.type === "needs-clock") {
-      return {
-        type: "needs-resources",
-        value: {
-          urls: [initialRes.value.url],
-          format: "string",
-          continue(
-            loadedClock : Array<ILoadedResource<string>>
-          ) : IDashParserResponse<string> {
-            if (loadedClock.length !== 1) {
-              throw new Error("DASH parser: wrong number of loaded ressources.");
-            }
-            const newRet = initialRes.value.continue(loadedClock[0].responseData);
-            return processReturn(newRet);
-          },
-        },
-      };
-    } else if (initialRes.type === "needs-xlinks") {
-      return {
-        type: "needs-resources",
-        value: {
-          urls: initialRes.value.xlinksUrls,
-          format: "string",
-          continue(
-            loadedXlinks : Array<ILoadedResource<string>>
-          ) : IDashParserResponse<string> {
-            const resourceInfos : ILoadedXlinkData[] = [];
-            for (let i = 0; i < loadedXlinks.length; i++) {
-              const { responseData: xlinkResp,
-                      receivedTime,
-                      sendingTime,
-                      url } = loadedXlinks[i];
-              if (!xlinkResp.success) {
-                throw xlinkResp.error;
-              }
-              const wrappedData = "<root>" + xlinkResp.data + "</root>";
-              const dataAsXML = new DOMParser().parseFromString(wrappedData, "text/xml");
-              if (dataAsXML == null || dataAsXML.children.length === 0) {
-                throw new Error("DASH parser: Invalid external ressources");
-              }
-              const periods = dataAsXML.children[0].children;
-              const periodsIR : IPeriodIntermediateRepresentation[] = [];
-              const periodsIRWarnings : Error[] = [];
-              for (let j = 0; j < periods.length; j++) {
-                if (periods[j].nodeType === Node.ELEMENT_NODE) {
-                  const [periodIR, periodWarnings] =
-                    createPeriodIntermediateRepresentation(periods[j]);
-                  periodsIRWarnings.push(...periodWarnings);
-                  periodsIR.push(periodIR);
-                }
-              }
-              resourceInfos.push({ url,
-                                   receivedTime,
-                                   sendingTime,
-                                   parsed: periodsIR,
-                                   warnings: periodsIRWarnings });
-            }
-            const newRet = initialRes.value.continue(resourceInfos);
-            return processReturn(newRet);
-          },
-        },
-      };
-    } else {
-      assertUnreachable(initialRes);
-    }
-  }
-}

package/src/parsers/manifest/dash/node_parser_types.ts

@@ -1,431 +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.
- */
-
-/**
- * Those are types used when generating the MPD "Intermediate Representation"
- * which is an intermediate step between parsing the MPD (in XML) and generating
- * the RxPlayer's internal representation of a Manifest.
- *
- * This way, we can without much development cost only create a parser's
- * "front-end" - which will just generate those object - to then depend on the
- * already existing "back-end".
- */
-
-/** Intermediate Representation for the `<MPD>` element in an MPD. */
-export interface IMPDIntermediateRepresentation {
-  /** Contains data about the element's children. */
-  children : IMPDChildren;
-  /** Contains data about the element's attributes. */
-  attributes : IMPDAttributes;
-}
-
-/** Intermediate representation for the root's children nodes. */
-export interface IMPDChildren {
-  /**
-   * Root URL on which further relative URLs make reference.
-   *
-   * This is the content of all `BaseURL` elements encountered in this MPD node,
-   * from the first encountered to the last encountered.
-   */
-  baseURLs : IBaseUrlIntermediateRepresentation[];
-  /**
-   * Location(s) at which the Manifest can be refreshed.
-   *
-   * This is the content of all `Location` elements encountered in this MPD
-   * node,
-   * from the first encountered to the last encountered.
-   */
-  locations : string[];
-  /**
-   * Temporal subdivisions in that Manifest.
-   *
-   * This is the content of all `Period` elements encountered in this MPD node,
-   * from the first encountered to the last encountered.
-   */
-  periods : IPeriodIntermediateRepresentation[];
-  /**
-   * Gives way to synchronize a clock to the server time.
-   *
-   * This is the content of all `UTCTiming` elements encountered in this MPD
-   * node, from the first encountered to the last encountered.
-   */
-  utcTimings : IScheme[];
-}
-
-/* Intermediate representation for the root's attributes. */
-export interface IMPDAttributes {
-  /**
-   * value of the `id` attribute.
-   * `undefined` if no `id` attribute was found on this MPD node.
-   */
-  id? : string;
-  /**
-   * value of the `profiles` attribute.
-   * `undefined` if no `profiles` attribute was found on this MPD node.
-   */
-  profiles? : string;
-  /**
-   * value of the `type` attribute.
-   * `undefined` if no `id` attribute was found on this MPD node.
-   */
-  type? : string;
-  availabilityStartTime? : number;
-  availabilityEndTime? : number;
-  publishTime? : number;
-  duration? : number; // mediaPresentationDuration
-  minimumUpdatePeriod? : number;
-  minBufferTime? : number;
-  timeShiftBufferDepth? : number;
-  suggestedPresentationDelay? : number;
-  maxSegmentDuration? : number;
-  maxSubsegmentDuration? : number;
-
-  /**
-   * XML namespaces linked to the `<MPD>` element.
-   *
-   * This property is only needed when the EventStream's `<Event>` elements are
-   * not parsed through the browser's DOMParser API, and thus might depend on
-   * parent namespaces to be parsed correctly.
-   */
-  namespaces? : Array<{ key: string;
-                        value: string; }>;
-}
-
-/** Intermediate representation of an encountered Period node. */
-export interface IPeriodIntermediateRepresentation {
-  /** Children nodes for that Representation node. */
-  children : IPeriodChildren;
-  /** Attributes on that Representation nodes. */
-  attributes : IPeriodAttributes;
-}
-
-/** Intermediate representation for a Period node's children nodes. */
-export interface IPeriodChildren {
-  /**
-   * Available "tracks" in that Period.
-   *
-   * This is the content of all `AdaptationSet` elements encountered in this
-   * node, from the first encountered to the last encountered.
-   */
-  adaptations : IAdaptationSetIntermediateRepresentation[];
-  /**
-   * Root URL on which further relative URLs make reference.
-   *
-   * This is the content of all `BaseURL` elements encountered in this node,
-   * from the first encountered to the last encountered.
-   */
-  baseURLs : IBaseUrlIntermediateRepresentation[];
-  /**
-   * Provide a template with which we will be able to request segments.
-   */
-  segmentTemplate? : ISegmentTemplateIntermediateRepresentation | undefined;
-  /**
-   * Allows to signal events linked to this Period.
-   *
-   * This is the content of all `EventStream` elements encountered in this
-   * node, from the first encountered to the last encountered.
-   */
-  eventStreams : IEventStreamIntermediateRepresentation[];
-}
-
-/* Intermediate representation for A Period node's attributes. */
-export interface IPeriodAttributes {
-  /**
-   * value of the `id` attribute.
-   * `undefined` if no `id` attribute was found on this Period node.
-   */
-  id? : string;
-  /**
-   * value of the `start` attribute, converted into an integer.
-   * `undefined` if no `id` attribute was found on this Period node or if we
-   * could not parse it.
-   */
-  start? : number;
-  /**
-   * value of the `duration` attribute, converted into an integer.
-   * `undefined` if no `id` attribute was found on this Period node or if we
-   * could not parse it.
-   */
-  duration? : number;
-  bitstreamSwitching? : boolean;
-  availabilityTimeComplete?: boolean;
-  availabilityTimeOffset?: number;
-  xlinkHref? : string;
-  xlinkActuate? : string;
-
-  /**
-   * XML namespaces linked to the `<Period>` element.
-   *
-   * This property is only needed when the EventStream's `<Event>` elements are
-   * not parsed through the browser's DOMParser API, and thus might depend on
-   * parent namespaces to be parsed correctly.
-   */
-  namespaces? : Array<{ key: string;
-                        value: string; }>;
-}
-
-/** AdaptationSet once parsed into its intermediate representation. */
-export interface IAdaptationSetIntermediateRepresentation {
-  children : IAdaptationSetChildren;
-  attributes : IAdaptationSetAttributes;
-}
-
-export interface IAdaptationSetChildren {
-  // required
-  baseURLs : IBaseUrlIntermediateRepresentation[];
-  representations : IRepresentationIntermediateRepresentation[];
-
-  // optional
-  accessibilities? : IScheme[] | undefined;
-  contentComponent? : IContentComponentAttributes | undefined;
-  contentProtections? : IContentProtectionIntermediateRepresentation[] | undefined;
-  essentialProperties? : IScheme[] | undefined;
-  inbandEventStreams? : IScheme[] | undefined;
-  roles? : IScheme[];
-  supplementalProperties? : IScheme[] | undefined;
-
-  segmentBase? : ISegmentBaseIntermediateRepresentation | undefined;
-  segmentList? : ISegmentListIntermediateRepresentation | undefined;
-  segmentTemplate? : ISegmentTemplateIntermediateRepresentation | undefined;
-  label? : string | undefined;
-}
-
-/* Intermediate representation for An AdaptationSet node's attributes. */
-export interface IAdaptationSetAttributes {
-  audioSamplingRate? : string;
-  bitstreamSwitching? : boolean;
-  codecs? : string;
-  codingDependency? : boolean;
-  contentType? : string;
-  frameRate? : string;
-  group? : number;
-  height? : number;
-  id? : string;
-  language? : string;
-  maxBitrate? : number;
-  maxFrameRate? : string;
-  maxHeight? : number;
-  maxPlayoutRate? : number;
-  maxWidth? : number;
-  maximumSAPPeriod? : number;
-  mimeType? : string;
-  minBitrate? : number;
-  minFrameRate? : string;
-  minHeight? : number;
-  minWidth? : number;
-  par? : string;
-  profiles? : string;
-  selectionPriority? : number;
-  segmentAlignment? : number|boolean;
-  segmentProfiles? : string;
-  subsegmentAlignment? : number|boolean;
-  supplementalCodecs?: string;
-  width? : number;
-  availabilityTimeComplete?: boolean;
-  availabilityTimeOffset?: number;
-  label?: string;
-}
-
-export interface IRepresentationIntermediateRepresentation {
-  children : IRepresentationChildren;
-  attributes : IRepresentationAttributes;
-}
-
-export interface IRepresentationChildren {
-  // required
-  baseURLs : IBaseUrlIntermediateRepresentation[];
-
-  // optional
-  contentProtections? : IContentProtectionIntermediateRepresentation[];
-  inbandEventStreams? : IScheme[];
-  segmentBase? : ISegmentBaseIntermediateRepresentation;
-  segmentList? : ISegmentListIntermediateRepresentation;
-  segmentTemplate? : ISegmentTemplateIntermediateRepresentation;
-  supplementalProperties? : IScheme[] | undefined;
-}
-
-/* Intermediate representation for A Representation node's attributes. */
-export interface IRepresentationAttributes {
-  audioSamplingRate? : string;
-  bitrate? : number;
-  codecs? : string;
-  codingDependency? : boolean;
-  frameRate? : string;
-  height? : number;
-  id? : string;
-  maxPlayoutRate? : number;
-  maximumSAPPeriod? : number;
-  mimeType? : string;
-  profiles? : string;
-  qualityRanking? : number;
-  segmentProfiles? : string;
-  supplementalCodecs?: string;
-  width? : number;
-  availabilityTimeComplete?: boolean;
-  availabilityTimeOffset?: number;
-}
-
-export interface ISegmentBaseIntermediateRepresentation {
-  availabilityTimeComplete?: boolean;
-  availabilityTimeOffset?: number;
-  duration? : number;
-  indexRange?: [number, number];
-  indexRangeExact?: boolean;
-  initialization?: IInitializationAttributes;
-  media?: string;
-  presentationTimeOffset?: number;
-  startNumber? : number;
-  endNumber? : number;
-  timescale?: number;
-}
-
-export interface ISegmentListIntermediateRepresentation {
-  list: ISegmentUrlIntermediateRepresentation[];
-  availabilityTimeComplete?: boolean;
-  availabilityTimeOffset?: number;
-  duration? : number;
-  indexRange?: [number, number];
-  indexRangeExact?: boolean;
-  initialization?: IInitializationAttributes;
-  media?: string;
-  presentationTimeOffset?: number;
-  startNumber? : number;
-  endNumber? : number;
-  timescale?: number;
-}
-
-export interface ISegmentUrlIntermediateRepresentation {
-  media?: string;
-  mediaRange?: [number, number];
-  index?: string;
-  indexRange?: [number, number];
-}
-
-export interface IInitializationAttributes {
-  range?: [number, number];
-  media?: string;
-}
-
-/** The ContentComponent once parsed. */
-export interface IContentComponentAttributes {
-  id?: string;
-  language?: string;
-  contentType?: string;
-  par?: string;
-}
-
-export interface IContentProtectionIntermediateRepresentation {
-  children : IContentProtectionChildren;
-  attributes : IContentProtectionAttributes;
-}
-
-export interface IContentProtectionChildren {
-  cencPssh : Uint8Array[];
-}
-
-export interface IContentProtectionAttributes {
-  schemeIdUri? : string;
-  value? : string;
-  keyId? : Uint8Array;
-}
-
-export interface ISegmentTemplateIntermediateRepresentation {
-  availabilityTimeComplete? : boolean | undefined;
-  availabilityTimeOffset? : number | undefined;
-  bitstreamSwitching? : boolean | undefined;
-  duration? : number | undefined;
-  index? : string | undefined;
-  indexRange?: [number, number] | undefined;
-  indexRangeExact? : boolean | undefined;
-  media? : string | undefined;
-  presentationTimeOffset? : number | undefined;
-  startNumber? : number | undefined;
-  endNumber? : number | undefined;
-  timescale? : number | undefined;
-  initialization? : { media?: string } | undefined;
-  timeline? : ISegmentTimelineElement[] | undefined;
-  timelineParser? : ITimelineParser | undefined;
-}
-
-export interface ISegmentTimelineElement {
-  start : number;
-  duration : number;
-  repeatCount : number;
-}
-
-/** Intermediate representation for a BaseURL node. */
-export interface IBaseUrlIntermediateRepresentation {
-  /**
-   * The URL itself.
-   *
-   * This is the inner content of a BaseURL node.
-   */
-  value: string;
-}
-
-/** Intermediate representation for a Node following a "scheme" format. */
-export interface IScheme {
-  /**
-   * Content of the `schemeIdUri` attribute for that scheme.
-   *
-   * `undefined` if no `schemeIdUri` attribute has been found.
-   */
-  schemeIdUri? : string | undefined;
-  /** Inner content of that scheme. */
-  value? : string | undefined;
-}
-
-export interface IEventStreamIntermediateRepresentation {
-  /** Contains data about the element's children. */
-  children : IEventStreamChildren;
-  /** Contains data about the element's attributes. */
-  attributes : IEventStreamAttributes;
-}
-
-export interface IEventStreamAttributes {
-  schemeIdUri? : string | undefined;
-  timescale? : number | undefined;
-  value? : string | undefined;
-
-  /**
-   * XML namespaces linked to the `<EventStream>` element.
-   *
-   * This property is only needed when the EventStream's `<Event>` elements are
-   * not parsed through the browser's DOMParser API, and thus might depend on
-   * parent namespaces to be parsed correctly.
-   */
-  namespaces? : Array<{ key: string; value: string }> | undefined;
-}
-
-export interface IEventStreamChildren {
-  events : IEventStreamEventIntermediateRepresentation[];
-}
-
-export interface IEventStreamEventIntermediateRepresentation {
-  id?: string;
-  presentationTime? : number;
-  duration? : number;
-
-  /**
-   * The `<Event>` element itself.
-   * Can be in two forms:
-   *   - Either as an Element instance directly
-   *   - Either as the Element's UTF-8 textual representation.
-   */
-  eventStreamData? : Element | ArrayBuffer;
-}
-
-export type ITimelineParser = () => HTMLCollection;

package/src/parsers/manifest/dash/parsers_types.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 { IParsedManifest } from "../types";
-
-export { IMPDParserArguments } from "./common";
-
-/** Response returned by a DASH MPD parser. */
-export type IDashParserResponse<T extends string | ArrayBuffer> =
-  IDashParserNeedsResources<T> |
-  IDashParserResponseDone;
-
-/** Response when the MPD parser has been able to parse the whole MPD. */
-export interface IDashParserResponseDone {
-  /** Identify this type of response. */
-  type : "done";
-  value : {
-    /** The parsed MPD under a IParsedManifest format. */
-    parsed : IParsedManifest;
-    /** Non-fatal errors encountered when parsing the MPD. */
-    warnings : Error[];
-  };
-}
-
-/**
- * Response when the MPD parser needs to load some resources before continuing
- * parsing the MPD.
- */
-export interface IDashParserNeedsResources<T extends string | ArrayBuffer> {
-  /** Identify this type of response. */
-  type : "needs-resources";
-  value : {
-    /** The URLs of each needed resource. */
-    urls : string[];
-    /** The format under which all those resources should be loaded. */
-    format : T extends string ? "string" :
-                                "arraybuffer";
-    /**
-     * Callback to call with the fetched resources data in argument to continue
-     * parsing the MPD.
-     *
-     * The element of the `loadedResources` array should be in the same order
-     * than the resources in the `urls` array.
-     */
-    continue : (
-      loadedResources : Array<ILoadedResource<T>>
-    ) => IDashParserResponse<string> | IDashParserResponse<ArrayBuffer>;
-  };
-}
-
-export type IResponseData<T> =
-  { success: true; data: T } |
-  { success: false; error: Error };
-
-/** Format a loaded resource should take. */
-export interface ILoadedResource<T extends string | ArrayBuffer> {
-  /**
-   * The URL of the loaded resource (post-redirection if one).
-   * `undefined` if unknown or inexistant.
-   */
-  url? : string | undefined;
-  /**
-   * The time, in terms of `performance.now()`, at which the resource was
-   * starting to be fetched.
-   * `undefined` if unknown or not applicable.
-   */
-  sendingTime? : number | undefined;
-  /**
-   * The time, in terms of `performance.now()`, at which the resource was
-   * fully-fetched.
-   * `undefined` if unknown or not applicable.
-   */
-  receivedTime? : number | undefined;
-  /** The loaded resource itself, under the right format.
-   * Or an error, when fetching ressources.
-   */
-  responseData : IResponseData<T>;
-}

package/src/parsers/manifest/dash/wasm-parser/Cargo.lock

@@ -1,25 +0,0 @@
-# This file is automatically @generated by Cargo.
-# It is not intended for manual editing.
-version = 3
-
-[[package]]
-name = "memchr"
-version = "2.3.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0ee1c47aaa256ecabcaea351eae4a9b01ef39ed810004e298d2511ed284b1525"
-
-[[package]]
-name = "mpd-node-parser"
-version = "0.1.0"
-dependencies = [
- "quick-xml",
-]
-
-[[package]]
-name = "quick-xml"
-version = "0.30.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eff6510e86862b57b210fd8cbe8ed3f0d7d600b9c2863cd4549a2e033c66e956"
-dependencies = [
- "memchr",
-]

package/src/parsers/manifest/dash/wasm-parser/Cargo.toml

@@ -1,16 +0,0 @@
-[package]
-name = "mpd-node-parser"
-version = "0.1.0"
-authors = ["Paul Berberian <pea.berberian@gmail.com>"]
-edition = "2018"
-
-[lib]
-path = "rs/lib.rs"
-crate-type = ["cdylib"]
-
-[profile.release]
-lto = true
-opt-level = 3
-
-[dependencies]
-quick-xml = "0.30.0"