rx-player 3.25.2 → 3.26.3-dev.2022021400

package/src/parsers/manifest/dash/common/indexes/list.ts

@@ -21,6 +21,7 @@ import {
 } from "../../../../../manifest";
 import { IEMSG } from "../../../../containers/isobmff";
 import { getTimescaledRange } from "../../../utils/index_helpers";
+import { IResolvedBaseUrl } from "../resolve_base_urls";
 import getInitSegment from "./get_init_segment";
 import { createIndexURLs } from "./tokens";
 
@@ -36,7 +37,7 @@ export interface IListIndex {
    */
   duration : number;
   /** Byte range for a possible index of segments in the server. */
-  indexRange?: [number, number];
+  indexRange?: [number, number] | undefined;
   /**
    * Temporal offset, in the current timescale (see timescale), to add to the
    * presentation time (time a segment has at decoding time) to obtain the
@@ -55,14 +56,14 @@ export interface IListIndex {
     /** URLs to access the initialization segment. */
     mediaURLs: string[] | null;
     /** possible byte range to request it. */
-    range?: [number, number];
-  };
+    range?: [number, number] | undefined;
+  } | undefined;
   /** Information on the list of segments for this index. */
   list: Array<{
     /** URLs of the segment. */
     mediaURLs : string[] | null;
     /** Possible byte-range of the segment. */
-    mediaRange? : [number, number];
+    mediaRange? : [number, number] | undefined;
   }>;
   /**
    * Timescale to convert a time given here into seconds.
@@ -77,12 +78,12 @@ export interface IListIndex {
  * Most of the properties here are already defined in IListIndex.
  */
 export interface IListIndexIndexArgument {
-  duration? : number;
-  indexRange?: [number, number];
-  initialization?: { media? : string;
-                     range? : [number, number]; };
-  list: Array<{ media? : string;
-                mediaRange? : [number, number]; }>;
+  duration? : number | undefined;
+  indexRange?: [number, number] | undefined;
+  initialization?: { media? : string | undefined;
+                     range? : [number, number] | undefined; };
+  list: Array<{ media? : string | undefined;
+                mediaRange? : [number, number] | undefined; }>;
   /**
    * Offset present in the index to convert from the mediaTime (time declared in
    * the media segments and in this index) to the presentationTime (time wanted
@@ -97,8 +98,8 @@ export interface IListIndexIndexArgument {
    * The time given here is in the current
    * timescale (see timescale)
    */
-  presentationTimeOffset? : number;
-  timescale? : number;
+  presentationTimeOffset? : number | undefined;
+  timescale? : number | undefined;
 }
 
 /** Aditional context needed by a SegmentList RepresentationIndex. */
@@ -106,11 +107,11 @@ export interface IListIndexContextArgument {
   /** Start of the period concerned by this RepresentationIndex, in seconds. */
   periodStart : number;
   /** Base URL for the Representation concerned. */
-  representationBaseURLs : string[];
+  representationBaseURLs : IResolvedBaseUrl[];
   /** ID of the Representation concerned. */
-  representationId? : string;
+  representationId? : string | undefined;
   /** Bitrate of the Representation concerned. */
-  representationBitrate? : number;
+  representationBitrate? : number | undefined;
   /* Function that tells if an EMSG is whitelisted by the manifest */
   isEMSGWhitelisted: (inbandEvent: IEMSG) => boolean;
 }
@@ -145,8 +146,9 @@ export default class ListRepresentationIndex implements IRepresentationIndex {
     const timescale = index.timescale ?? 1;
     const indexTimeOffset = presentationTimeOffset - periodStart * timescale;
 
+    const urlSources : string[] = representationBaseURLs.map(b => b.url);
     const list = index.list.map((lItem) => ({
-      mediaURLs: createIndexURLs(representationBaseURLs,
+      mediaURLs: createIndexURLs(urlSources,
                                  lItem.media,
                                  representationId,
                                  representationBitrate),
@@ -158,7 +160,7 @@ export default class ListRepresentationIndex implements IRepresentationIndex {
                     indexRange: index.indexRange,
                     initialization: index.initialization == null ?
                       undefined :
-                      { mediaURLs: createIndexURLs(representationBaseURLs,
+                      { mediaURLs: createIndexURLs(urlSources,
                                                    index.initialization.media,
                                                    representationId,
                                                    representationBitrate),
@@ -207,6 +209,7 @@ export default class ListRepresentationIndex implements IRepresentationIndex {
           end: time + durationInSeconds,
           mediaURLs,
           timestampOffset: -(index.indexTimeOffset / timescale),
+          complete: true,
           privateInfos: { isEMSGWhitelisted:
                             this._isEMSGWhitelisted } };
       segments.push(segment);

package/src/parsers/manifest/dash/common/indexes/template.ts

@@ -21,6 +21,7 @@ import {
 } from "../../../../../manifest";
 import { IEMSG } from "../../../../containers/isobmff";
 import ManifestBoundsCalculator from "../manifest_bounds_calculator";
+import { IResolvedBaseUrl } from "../resolve_base_urls";
 import getInitSegment from "./get_init_segment";
 import isPeriodFulfilled from "./is_period_fulfilled";
 import {
@@ -48,14 +49,14 @@ export interface ITemplateIndex {
    */
   timescale : number;
   /** Byte range for a possible index of segments in the server. */
-  indexRange?: [number, number];
+  indexRange?: [number, number] | undefined;
   /** Information on the initialization segment. */
   initialization? : {
     /** URLs to access the initialization segment. */
     mediaURLs: string[] | null;
     /** possible byte range to request it. */
-    range?: [number, number];
-  };
+    range?: [number, number] | undefined;
+  } | undefined;
   /**
    * URL base to access any segment.
    * Can contain token to replace to convert it to real URLs.
@@ -90,7 +91,7 @@ export interface ITemplateIndex {
    */
   presentationTimeOffset : number;
   /** Number from which the first segments in this index starts with. */
-  startNumber? : number;
+  startNumber? : number | undefined;
 }
 
 /**
@@ -98,14 +99,15 @@ export interface ITemplateIndex {
  * Most of the properties here are already defined in ITemplateIndex.
  */
 export interface ITemplateIndexIndexArgument {
-  duration? : number;
-  indexRange?: [number, number];
-  initialization?: { media? : string;
-                     range? : [number, number]; };
-  media? : string;
-  presentationTimeOffset? : number;
-  startNumber? : number;
-  timescale? : number;
+  duration? : number | undefined;
+  indexRange?: [number, number] | undefined;
+  initialization?: { media? : string | undefined;
+                     range? : [number, number] | undefined; } |
+                   undefined;
+  media? : string | undefined;
+  presentationTimeOffset? : number | undefined;
+  startNumber? : number | undefined;
+  timescale? : number | undefined;
 }
 
 /** Aditional context needed by a SegmentTemplate RepresentationIndex. */
@@ -122,11 +124,11 @@ export interface ITemplateIndexContextArgument {
   /** Whether the corresponding Manifest can be updated and changed. */
   isDynamic : boolean;
   /** Base URL for the Representation concerned. */
-  representationBaseURLs : string[];
+  representationBaseURLs : IResolvedBaseUrl[];
   /** ID of the Representation concerned. */
-  representationId? : string;
+  representationId? : string | undefined;
   /** Bitrate of the Representation concerned. */
-  representationBitrate? : number;
+  representationBitrate? : number | undefined;
   /* Function that tells if an EMSG is whitelisted by the manifest */
   isEMSGWhitelisted: (inbandEvent: IEMSG) => boolean;
 }
@@ -149,9 +151,9 @@ export default class TemplateRepresentationIndex implements IRepresentationIndex
   /** Absolute start of the Period, in seconds. */
   private _periodStart : number;
   /** Difference between the end time of the Period and its start time, in timescale. */
-  private _scaledPeriodEnd? : number;
+  private _scaledPeriodEnd : number | undefined;
   /** Minimum availabilityTimeOffset concerning the segments of this Representation. */
-  private _availabilityTimeOffset? : number;
+  private _availabilityTimeOffset : number | undefined;
   /** Whether the corresponding Manifest can be updated and changed. */
   private _isDynamic : boolean;
   /* Function that tells if an EMSG is whitelisted by the manifest */
@@ -177,7 +179,12 @@ export default class TemplateRepresentationIndex implements IRepresentationIndex
             isEMSGWhitelisted } = context;
     const timescale = index.timescale ?? 1;
 
-    this._availabilityTimeOffset = availabilityTimeOffset;
+    const minBaseUrlAto = representationBaseURLs.length === 0 ?
+      0 :
+      representationBaseURLs.reduce((acc, rbu) => {
+        return Math.min(acc, rbu.availabilityTimeOffset);
+      }, Infinity);
+    this._availabilityTimeOffset = availabilityTimeOffset + minBaseUrlAto;
 
     this._manifestBoundsCalculator = manifestBoundsCalculator;
     this._aggressiveMode = aggressiveMode;
@@ -192,18 +199,19 @@ export default class TemplateRepresentationIndex implements IRepresentationIndex
       throw new Error("Invalid SegmentTemplate: no duration");
     }
 
+    const urlSources : string[] = representationBaseURLs.map(b => b.url);
     this._index = { duration: index.duration,
                     timescale,
                     indexRange: index.indexRange,
                     indexTimeOffset,
                     initialization: index.initialization == null ?
                       undefined :
-                      { mediaURLs: createIndexURLs(representationBaseURLs,
+                      { mediaURLs: createIndexURLs(urlSources,
                                                    index.initialization.media,
                                                    representationId,
                                                    representationBitrate),
                         range: index.initialization.range },
-                    mediaURLs: createIndexURLs(representationBaseURLs,
+                    mediaURLs: createIndexURLs(urlSources,
                                                index.media,
                                                representationId,
                                                representationBitrate),
@@ -257,8 +265,7 @@ export default class TemplateRepresentationIndex implements IRepresentationIndex
     const segments : ISegment[] = [];
 
     // number corresponding to the Period's start
-    const numberOffset = startNumber == null ? 1 :
-                                               startNumber;
+    const numberOffset = startNumber ?? 1;
 
     // calcul initial time from Period start, where the first segment would have
     // the `0` number
@@ -293,6 +300,7 @@ export default class TemplateRepresentationIndex implements IRepresentationIndex
                      scaledDuration: realDuration / timescale,
                      mediaURLs: detokenizedURLs,
                      timestampOffset: -(index.indexTimeOffset / timescale),
+                     complete: true,
                      privateInfos: {
                        isEMSGWhitelisted: this._isEMSGWhitelisted,
                      } };

package/src/parsers/manifest/dash/common/indexes/timeline/construct_timeline_from_elements.ts

@@ -52,7 +52,7 @@ export default function constructTimelineFromElements(
                                                           previousItem,
                                                           nextItem,
                                                           scaledPeriodStart);
-    if (timelineElement != null) {
+    if (timelineElement !== null) {
       timeline.push(timelineElement);
     }
   }

package/src/parsers/manifest/dash/common/indexes/timeline/convert_element_to_index_segment.ts

@@ -15,6 +15,7 @@
  */
 
 import log from "../../../../../../log";
+import isNullOrUndefined from "../../../../../../utils/is_null_or_undefined";
 import { IIndexSegment } from "../../../../utils/index_helpers";
 
 /**
@@ -40,23 +41,23 @@ export default function convertElementsToIndexSegment(
   let start = item.start;
   let duration = item.duration;
   const repeatCount = item.repeatCount;
-  if (start == null) {
-    if (previousItem == null) {
+  if (start === undefined) {
+    if (previousItem === null) {
       start = timelineStart;
-    } else if (previousItem.duration != null) {
+    } else if (!isNullOrUndefined(previousItem.duration)) {
       start = previousItem.start +
               (previousItem.duration * (previousItem.repeatCount + 1));
     }
   }
-  if ((duration == null || isNaN(duration)) &&
-      nextItem != null && nextItem.start != null && !isNaN(nextItem.start) &&
-      start != null && !isNaN(start)
+  if ((duration === undefined || isNaN(duration)) &&
+      nextItem !== null && nextItem.start !== undefined && !isNaN(nextItem.start) &&
+      start !== undefined && !isNaN(start)
   ) {
     duration = nextItem.start - start;
   }
-  if ((start != null && !isNaN(start)) &&
-      (duration != null && !isNaN(duration)) &&
-      (repeatCount == null || !isNaN(repeatCount))
+  if ((start !== undefined && !isNaN(start)) &&
+      (duration !== undefined && !isNaN(duration)) &&
+      (repeatCount === undefined || !isNaN(repeatCount))
   ) {
     return { start,
              duration,

package/src/parsers/manifest/dash/common/indexes/timeline/timeline_representation_index.ts

@@ -38,6 +38,7 @@ import isSegmentStillAvailable from "../../../../utils/is_segment_still_availabl
 import updateSegmentTimeline from "../../../../utils/update_segment_timeline";
 import { ISegmentTimelineElement } from "../../../node_parser_types";
 import ManifestBoundsCalculator from "../../manifest_bounds_calculator";
+import { IResolvedBaseUrl } from "../../resolve_base_urls";
 import getInitSegment from "../get_init_segment";
 import getSegmentsFromTimeline from "../get_segments_from_timeline";
 import isPeriodFulfilled from "../is_period_fulfilled";
@@ -54,8 +55,10 @@ const { MIN_DASH_S_ELEMENTS_TO_PARSE_UNSAFELY } = config;
  * given media time.
  */
 export interface ITimelineIndex {
+  /** If `false`, the last segment anounced might be still incomplete. */
+  availabilityTimeComplete : boolean;
   /** Byte range for a possible index of segments in the server. */
-  indexRange?: [number, number];
+  indexRange?: [number, number] | undefined;
   /**
    * Temporal offset, in the current timescale (see timescale), to add to the
    * presentation time (time a segment has at decoding time) to obtain the
@@ -74,15 +77,15 @@ export interface ITimelineIndex {
     /** URLs to access the initialization segment. */
     mediaURLs: string[] | null;
     /** possible byte range to request it. */
-    range?: [number, number];
-  };
+    range?: [number, number] | undefined;
+  } | undefined;
   /**
    * Base URL(s) to access any segment. Can contain tokens to replace to convert
    * it to real URLs.
    */
   mediaURLs : string[] | null ;
   /** Number from which the first segments in this index starts with. */
-  startNumber? : number;
+  startNumber? : number | undefined;
   /**
    * Every segments defined in this index.
    * `null` at the beginning as this property is parsed lazily (only when first
@@ -114,11 +117,13 @@ export interface ITimelineIndex {
  * Most of the properties here are already defined in ITimelineIndex.
  */
 export interface ITimelineIndexIndexArgument {
-  indexRange?: [number, number];
-  initialization? : { media? : string; range?: [number, number] };
-  media? : string;
-  startNumber? : number;
-  timescale? : number;
+  indexRange?: [number, number] | undefined;
+  initialization? : { media? : string | undefined;
+                      range?: [number, number] | undefined; } |
+                    undefined;
+  media? : string | undefined;
+  startNumber? : number | undefined;
+  timescale? : number | undefined;
   /**
    * Offset present in the index to convert from the mediaTime (time declared in
    * the media segments and in this index) to the presentationTime (time wanted
@@ -133,19 +138,21 @@ export interface ITimelineIndexIndexArgument {
    * The time given here is in the current
    * timescale (see timescale)
    */
-  presentationTimeOffset? : number;
+  presentationTimeOffset? : number | undefined;
 
-  timelineParser? : () => HTMLCollection;
-  timeline? : ISegmentTimelineElement[];
+  timelineParser? : (() => HTMLCollection) | undefined;
+  timeline? : ISegmentTimelineElement[] | undefined;
 }
 
 /** Aditional context needed by a SegmentTimeline RepresentationIndex. */
 export interface ITimelineIndexContextArgument {
+  /** If `false`, the last segment anounced might be still incomplete. */
+  availabilityTimeComplete : boolean;
   /** Allows to obtain the minimum and maximum positions of a content. */
   manifestBoundsCalculator : ManifestBoundsCalculator;
-  /** Start of the period concerned by this RepresentationIndex, in seconds. */
+  /** Start of the period linked to this RepresentationIndex, in seconds. */
   periodStart : number;
-  /** End of the period concerned by this RepresentationIndex, in seconds. */
+  /** End of the period linked to this RepresentationIndex, in seconds. */
   periodEnd : number|undefined;
   /** Whether the corresponding Manifest can be updated and changed. */
   isDynamic : boolean;
@@ -153,13 +160,13 @@ export interface ITimelineIndexContextArgument {
    * Time (in terms of `performance.now`) at which the XML file containing this
    * index was received
    */
-  receivedTime? : number;
+  receivedTime? : number | undefined;
   /** Base URL for the Representation concerned. */
-  representationBaseURLs : string[];
+  representationBaseURLs : IResolvedBaseUrl[];
   /** ID of the Representation concerned. */
-  representationId? : string;
+  representationId? : string | undefined;
   /** Bitrate of the Representation concerned. */
-  representationBitrate? : number;
+  representationBitrate? : number | undefined;
   /**
    * The parser should take this previous version of the
    * `TimelineRepresentationIndex` - which was from the same Representation
@@ -169,13 +176,18 @@ export interface ITimelineIndexContextArgument {
    * Use with moderation.
    */
   unsafelyBaseOnPreviousRepresentation : Representation | null;
-  /* Function that tells if an EMSG is whitelisted by the manifest */
+  /** Function that tells if an EMSG is whitelisted by the manifest */
   isEMSGWhitelisted: (inbandEvent: IEMSG) => boolean;
+  /**
+   * Set to `true` if the linked Period is the chronologically last one in the
+   * Manifest.
+   */
+  isLastPeriod : boolean;
 }
 
 export interface ILastSegmentInformation {
   /** End of the timeline on `time`, timescaled. */
-  lastPosition? : number;
+  lastPosition? : number | undefined;
 
   /** Defines the time at which `lastPosition` was last calculated. */
   time : number;
@@ -219,6 +231,9 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
   /* Function that tells if an EMSG is whitelisted by the manifest */
   private _isEMSGWhitelisted: (inbandEvent: IEMSG) => boolean;
 
+  /** `true` if the linked Period is the chronologically last one in the Manifest. */
+  private _isLastPeriod: boolean;
+
   /**
    * @param {Object} index
    * @param {Object} context
@@ -231,8 +246,10 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
       throw new Error("The given index is not compatible with a " +
                       "TimelineRepresentationIndex.");
     }
-    const { manifestBoundsCalculator,
+    const { availabilityTimeComplete,
+            manifestBoundsCalculator,
             isDynamic,
+            isLastPeriod,
             representationBaseURLs,
             representationId,
             representationBitrate,
@@ -251,6 +268,7 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
     this._manifestBoundsCalculator = manifestBoundsCalculator;
 
     this._isEMSGWhitelisted = isEMSGWhitelisted;
+    this._isLastPeriod = isLastPeriod;
     this._lastUpdate = context.receivedTime == null ?
                                  performance.now() :
                                  context.receivedTime;
@@ -269,18 +287,20 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
 
     this._isDynamic = isDynamic;
     this._parseTimeline = index.timelineParser ?? null;
-    this._index = { indexRange: index.indexRange,
+    const urlSources : string[] = representationBaseURLs.map(b => b.url);
+    this._index = { availabilityTimeComplete,
+                    indexRange: index.indexRange,
                     indexTimeOffset,
                     initialization: index.initialization == null ?
                       undefined :
                       {
-                        mediaURLs: createIndexURLs(representationBaseURLs,
+                        mediaURLs: createIndexURLs(urlSources,
                                                    index.initialization.media,
                                                    representationId,
                                                    representationBitrate),
                         range: index.initialization.range,
                       },
-                    mediaURLs: createIndexURLs(representationBaseURLs,
+                    mediaURLs: createIndexURLs(urlSources,
                                                index.media,
                                                representationId,
                                                representationBitrate),
@@ -446,6 +466,7 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
     this._scaledPeriodEnd = newIndex._scaledPeriodEnd;
     this._lastUpdate = newIndex._lastUpdate;
     this._manifestBoundsCalculator = newIndex._manifestBoundsCalculator;
+    this._isLastPeriod = newIndex._isLastPeriod;
   }
 
   /**
@@ -460,11 +481,16 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
     if (newIndex._index.timeline === null) {
       newIndex._index.timeline = newIndex._getTimeline();
     }
-    updateSegmentTimeline(this._index.timeline, newIndex._index.timeline);
+    const hasReplaced = updateSegmentTimeline(this._index.timeline,
+                                              newIndex._index.timeline);
+    if (hasReplaced) {
+      this._index.startNumber = newIndex._index.startNumber;
+    }
     this._isDynamic = newIndex._isDynamic;
     this._scaledPeriodStart = newIndex._scaledPeriodStart;
     this._scaledPeriodEnd = newIndex._scaledPeriodEnd;
     this._lastUpdate = newIndex._lastUpdate;
+    this._isLastPeriod = newIndex._isLastPeriod;
   }
 
   /**
@@ -474,7 +500,13 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
    * @returns {Boolean}
    */
   isFinished() : boolean {
-    if (!this._isDynamic) {
+    if (!this._isDynamic || !this._isLastPeriod) {
+      // Either the content is not dynamic, in which case no new segment will
+      // be generated, either it is but this index is not linked to the current
+      // last Period in the MPD, in which case it is inferred that it has been
+      // completely generated. Note that this second condition might break very
+      // very rare use cases where old Periods are still being generated, yet it
+      // should fix more cases than it breaks.
       return true;
     }
 
@@ -523,7 +555,11 @@ export default class TimelineRepresentationIndex implements IRepresentationIndex
       return; // we don't know yet
     }
     const scaledFirstPosition = toIndexTime(firstPosition, this._index);
-    clearTimelineFromPosition(this._index.timeline, scaledFirstPosition);
+    const nbEltsRemoved = clearTimelineFromPosition(this._index.timeline,
+                                                    scaledFirstPosition);
+    if (this._index.startNumber !== undefined) {
+      this._index.startNumber += nbEltsRemoved;
+    }
   }
 
   static getIndexEnd(timeline : IIndexSegment[],

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

@@ -47,7 +47,7 @@ function processFormatedToken(
 }
 
 /**
- * @param {string} representationURL
+ * @param {string} baseURLs
  * @param {string|undefined} media
  * @param {string|undefined} id
  * @param {number|undefined} bitrate
@@ -89,7 +89,7 @@ export function replaceRepresentationDASHTokens(
     return path
       .replace(/\$\$/g, "$")
       .replace(/\$RepresentationID\$/g, String(id))
-      .replace(/\$Bandwidth(|\%0(\d+)d)\$/g,
+      .replace(/\$Bandwidth(\%0(\d+)d)?\$/g,
                processFormatedToken(bitrate === undefined ? 0 :
                                                             bitrate));
   }
@@ -121,13 +121,13 @@ export function createDashUrlDetokenizer(
     } else {
       return url
         .replace(/\$\$/g, "$")
-        .replace(/\$Number(|\%0(\d+)d)\$/g, (_x, _y, widthStr : string) => {
+        .replace(/\$Number(\%0(\d+)d)?\$/g, (_x, _y, widthStr : string) => {
           if (nb === undefined) {
             throw new Error("Segment number not defined in a $Number$ scheme");
           }
           return processFormatedToken(nb)(_x, _y, widthStr);
         })
-        .replace(/\$Time(|\%0(\d+)d)\$/g, (_x, _y, widthStr : string) => {
+        .replace(/\$Time(\%0(\d+)d)?\$/g, (_x, _y, widthStr : string) => {
           if (time === undefined) {
             throw new Error("Segment time not defined in a $Time$ scheme");
           }

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

@@ -30,8 +30,8 @@ const SUPPORTED_TEXT_TYPES = ["subtitle", "caption"];
 
 /** Structure of a parsed "scheme-like" element in the MPD. */
 interface IScheme {
-  schemeIdUri? : string;
-  value? : string;
+  schemeIdUri? : string | undefined;
+  value? : string | undefined;
 }
 
 /**

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

@@ -47,7 +47,7 @@ export default class ManifestBoundsCalculator {
   /**
    * @param {Object} args
    */
-  constructor(args : { timeShiftBufferDepth? : number;
+  constructor(args : { timeShiftBufferDepth : number | undefined;
                        isDynamic : boolean; }
   ) {
     this._isDynamic = args.isDynamic;