Class: shaka.dash.DashParser

Constructor

new DashParser()

Creates a new DASH parser.
Implements:
Source:

Members

averageUpdateDuration_ :shaka.abr.Ewma

An ewma that tracks how long updates take. This is to mitigate issues caused by slow parsing on embedded devices.
Type:
Source:

globalId_ :number

Type:
  • number
Source:

largestPeriodStartTime_ :number

Largest period start time seen.
Type:
  • number
Source:

lastManifestUpdatePeriodIds_ :Array.<string>

Period IDs seen in previous manifest.
Type:
  • Array.<string>
Source:

lowLatencyMode_ :boolean

Type:
  • boolean
Source:

manifestUris_ :Array.<string>

Type:
  • Array.<string>
Source:

minTotalAvailabilityTimeOffset_ :number

The minimum of the availabilityTimeOffset values among the adaptation sets.
Type:
  • number
Source:

periodDurations_ :Object.<string, number>

A map of period ids to their durations
Type:
  • Object.<string, number>
Source:

streamMap_ :Object.<string, !shaka.extern.Stream>

A map of IDs to Stream objects. ID: Period@id,AdaptationSet@id,@Representation@id e.g.: '1,5,23'
Type:
Source:

updatePeriod_ :number

The update period in seconds, or 0 for no updates.
Type:
  • number
Source:

Methods

guessContentType_(mimeType, codecs) → {string}

Guess the content type based on MIME type and codecs.
Parameters:
Name Type Description
mimeType string
codecs string
Source:
Returns:
Type
string

banLocation(uri)

Tells the parser that a location should be banned. This is called on retry.
Parameters:
Name Type Description
uri string
Implements:
Source:

configure(config)

Called by the Player to provide an updated configuration any time the configuration changes. Will be called at least once before start().
Parameters:
Name Type Description
config shaka.extern.ManifestConfiguration
Implements:
Source:

createFrame_(elemnon-null, parentnullable, getBaseUrisnullable) → {shaka.dash.DashParser.InheritanceFrame}

Creates a new inheritance frame for the given element.
Parameters:
Name Type Attributes Description
elem shaka.extern.xml.Node
parent shaka.dash.DashParser.InheritanceFrame <nullable>
getBaseUris ?function(): !Array.<string> <nullable>
Source:
Returns:
Type
shaka.dash.DashParser.InheritanceFrame

emsgSchemeIdUris_(inBandEventStreamsnon-null, emsgSchemeIdUrisnon-null) → {Array.<string>}

Returns a new array of InbandEventStream schemeIdUri containing the union of the ones parsed from inBandEventStreams and the ones provided in emsgSchemeIdUris.
Parameters:
Name Type Description
inBandEventStreams Array.<!shaka.extern.xml.Node> Array of InbandEventStream elements to parse and add to the returned array.
emsgSchemeIdUris Array.<string> Array of parsed InbandEventStream schemeIdUri attributes to add to the returned array.
Source:
Returns:
schemeIdUris Array of parsed InbandEventStream schemeIdUri attributes.
Type
Array.<string>

getStreamsFromSets_(disabled, adaptationSetsnon-null, contentType)

Gets the streams from the given sets or returns an empty array if disabled or no streams are found.
Parameters:
Name Type Description
disabled boolean
adaptationSets Array.<!shaka.dash.DashParser.AdaptationInfo>
contentType string
Source:

makeNetworkRequest_(request, type, contextopt) → {Promise.<shaka.extern.Response>}

Create a networking request. This will manage the request using the parser's operation manager.
Parameters:
Name Type Attributes Description
request shaka.extern.Request
type shaka.net.NetworkingEngine.RequestType
context shaka.extern.RequestContext <optional>
Source:
Returns:
Type
Promise.<shaka.extern.Response>

onExpirationUpdated(sessionId, expiration)

Tells the parser that the expiration time of an EME session has changed. Implementing this is optional.
Parameters:
Name Type Description
sessionId string
expiration number
Implements:
Source:

onInitialVariantChosen(variant)

Tells the parser that the initial variant has been chosen.
Parameters:
Name Type Description
variant shaka.extern.Variant
Implements:
Source:

onUpdate_() → {Promise}

Called when the update timer ticks.
Source:
Returns:
Type
Promise

parseAdaptationSet_(context, elemnon-null) → {shaka.dash.DashParser.AdaptationInfo}

Parses an AdaptationSet XML element.
Parameters:
Name Type Description
context shaka.dash.DashParser.Context
elem shaka.extern.xml.Node The AdaptationSet element.
Source:
Returns:
Type
shaka.dash.DashParser.AdaptationInfo

parseAudioChannels_(audioChannelConfigsnon-null) → {number}

Parameters:
Name Type Description
audioChannelConfigs Array.<!shaka.extern.xml.Node> An array of AudioChannelConfiguration elements.
Source:
Returns:
The number of audio channels, or null if unknown.
Type
number

parseEventStream_(periodStart, periodDurationnullable, elemnon-null, availabilityStart)

Parses an EventStream element.
Parameters:
Name Type Attributes Description
periodStart number
periodDuration number <nullable>
elem shaka.extern.xml.Node
availabilityStart number
Source:

parseManifest_(data, finalManifestUri) → {Promise}

Parses the manifest XML. This also handles updates and will update the stored manifest.
Parameters:
Name Type Description
data BufferSource
finalManifestUri string The final manifest URI, which may differ from this.manifestUri_ if there has been a redirect.
Source:
Returns:
Type
Promise

parsePeriod_(context, getBaseUris, periodInfo) → {shaka.extern.Period}

Parses a Period XML element. Unlike the other parse methods, this is not given the Node; it is given a PeriodInfo structure. Also, partial parsing was done before this was called so start and duration are valid.
Parameters:
Name Type Description
context shaka.dash.DashParser.Context
getBaseUris function(): !Array.<string>
periodInfo shaka.dash.DashParser.PeriodInfo
Source:
Returns:
Type
shaka.extern.Period

parsePeriods_(context, getBaseUris, mpdnon-null) → {{periods: !Array.<shaka.extern.Period>, duration: ?number, durationDerivedFromPeriods: boolean}}

Reads and parses the periods from the manifest. This first does some partial parsing so the start and duration is available when parsing children.
Parameters:
Name Type Description
context shaka.dash.DashParser.Context
getBaseUris function(): !Array.<string>
mpd shaka.extern.xml.Node
Source:
Returns:
Type
{periods: !Array.<shaka.extern.Period>, duration: ?number, durationDerivedFromPeriods: boolean}

parseRepresentation_(context, contentProtection, kind, language, label, isPrimary, rolesnon-null, closedCaptions, nodenon-null, accessibilityPurposenullable) → {shaka.extern.Stream}

Parses a Representation XML element.
Parameters:
Name Type Attributes Description
context shaka.dash.DashParser.Context
contentProtection shaka.dash.ContentProtection.Context
kind string | undefined
language string
label string
isPrimary boolean
roles Array.<string>
closedCaptions Map.<string, string>
node shaka.extern.xml.Node
accessibilityPurpose shaka.media.ManifestParser.AccessibilityPurpose <nullable>
Source:
Returns:
The Stream, or null when there is a non-critical parsing error.
Type
shaka.extern.Stream

parseServiceDescription_(mpdnon-null) → {shaka.extern.ServiceDescription}

Reads maxLatency and maxPlaybackRate properties from service description element.
Parameters:
Name Type Description
mpd shaka.extern.xml.Node
Source:
Returns:
Type
shaka.extern.ServiceDescription

parseUtcTiming_(getBaseUris, elemsnon-null) → {Promise.<number>}

Parses an array of UTCTiming elements.
Parameters:
Name Type Description
getBaseUris function(): !Array.<string>
elems Array.<!shaka.extern.xml.Node>
Source:
Returns:
Type
Promise.<number>

processManifest_(mpdnon-null, finalManifestUri) → {Promise}

Takes a formatted MPD and converts it into a manifest.
Parameters:
Name Type Description
mpd shaka.extern.xml.Node
finalManifestUri string The final manifest URI, which may differ from this.manifestUri_ if there has been a redirect.
Source:
Returns:
Type
Promise

requestForTiming_(getBaseUris, uri, method) → {Promise.<number>}

Makes a request to the given URI and calculates the clock offset.
Parameters:
Name Type Description
getBaseUris function(): !Array.<string>
uri string
method string
Source:
Returns:
Type
Promise.<number>

requestManifest_() → {Promise.<number>}

Makes a network request for the manifest and parses the resulting data.
Source:
Returns:
Resolves with the time it took, in seconds, to fulfill the request and parse the data.
Type
Promise.<number>

requestSegment_(urisnon-null, startBytenullable, endBytenullable, isInit) → {Promise.<BufferSource>}

Makes a network request on behalf of SegmentBase.createStreamInfo.
Parameters:
Name Type Attributes Description
uris Array.<string>
startByte number <nullable>
endByte number <nullable>
isInit boolean
Source:
Returns:
Type
Promise.<BufferSource>

setUpdateTimer_(offset)

Sets the update timer. Does nothing if the manifest does not specify an update period.
Parameters:
Name Type Description
offset number An offset, in seconds, to apply to the manifest's update period.
Source:

start(uri, playerInterface) → {Promise.<shaka.extern.Manifest>}

Initialize and start the parser. When |start| resolves, it should return the initial version of the manifest. |start| will only be called once. If |stop| is called while |start| is pending, |start| should reject.
Parameters:
Name Type Description
uri string The URI of the manifest.
playerInterface shaka.extern.ManifestParser.PlayerInterface The player interface contains the callbacks and members that the parser can use to communicate with the player and outside world.
Implements:
Source:
Returns:
Type
Promise.<shaka.extern.Manifest>

stop() → {Promise}

Tell the parser that it must stop and free all internal resources as soon as possible. Only once all internal resources are stopped and freed will the promise resolve. Once stopped a parser will not be started again. The parser should support having |stop| called multiple times and the promise should always resolve.
Implements:
Source:
Returns:
Type
Promise

update()

Tells the parser to do a manual manifest update. Implementing this is optional. This is only called when 'emsg' boxes are present.
Implements:
Source:

verifyRepresentation_(frame) → {boolean}

Verifies that a Representation has exactly one Segment* element. Prints warnings if there is a problem.
Parameters:
Name Type Description
frame shaka.dash.DashParser.InheritanceFrame
Source:
Returns:
True if the Representation is usable; otherwise return false.
Type
boolean

Type Definitions

AdaptationInfo

Contains information about an AdaptationSet element.
Type:
  • {id: string, contentType: ?string, language: string, main: boolean, streams: !Array.<shaka.extern.Stream>, drmInfos: !Array.<shaka.extern.DrmInfo>, trickModeFor: ?string, representationIds: !Array.<string>}
Properties:
Name Type Attributes Description
id string The unique ID of the adaptation set.
contentType string <nullable>
The content type of the AdaptationSet.
language string The language of the AdaptationSet.
main boolean Whether the AdaptationSet has the 'main' type.
streams Array.<shaka.extern.Stream> The streams this AdaptationSet contains.
drmInfos Array.<shaka.extern.DrmInfo> The DRM info for the AdaptationSet.
trickModeFor string <nullable>
If non-null, this AdaptationInfo represents trick mode tracks. This property is the ID of the normal AdaptationSet these tracks should be associated with.
representationIds Array.<string> An array of the IDs of the Representations this AdaptationSet contains.
Source:

Context

Contains context data for the streams. This is designed to be shallow-copyable, so the parser must overwrite (not modify) each key as the parser moves through the manifest and the parsing context changes.
Type:
Properties:
Name Type Attributes Description
dynamic boolean True if the MPD is dynamic (not all segments available at once)
presentationTimeline shaka.media.PresentationTimeline The PresentationTimeline.
period shaka.dash.DashParser.InheritanceFrame <nullable>
The inheritance from the Period element.
periodInfo shaka.dash.DashParser.PeriodInfo <nullable>
The Period info for the current Period.
adaptationSet shaka.dash.DashParser.InheritanceFrame <nullable>
The inheritance from the AdaptationSet element.
representation shaka.dash.DashParser.InheritanceFrame <nullable>
The inheritance from the Representation element.
bandwidth number The bandwidth of the Representation, or zero if missing.
indexRangeWarningGiven boolean True if the warning about SegmentURL@indexRange has been printed.
availabilityTimeOffset number The sum of the availabilityTimeOffset values that apply to the element.
profiles Array.<string> Profiles of DASH are defined to enable interoperability and the signaling of the use of features.
Source:

GenerateSegmentIndexFunction

An async function which generates and returns a SegmentIndex.
Type:
Source:

InheritanceFrame

A collection of elements and properties which are inherited across levels of a DASH manifest.
Type:
  • {segmentBase: ?shaka.extern.xml.Node, segmentList: ?shaka.extern.xml.Node, segmentTemplate: ?shaka.extern.xml.Node, getBaseUris: function(): !Array.<string>, width: (number|undefined), height: (number|undefined), contentType: string, mimeType: string, codecs: string, frameRate: (number|undefined), pixelAspectRatio: (string|undefined), emsgSchemeIdUris: !Array.<string>, id: ?string, language: ?string, numChannels: ?number, audioSamplingRate: ?number, availabilityTimeOffset: number, segmentSequenceCadence: number}
Properties:
Name Type Attributes Description
segmentBase shaka.extern.xml.Node <nullable>
The XML node for SegmentBase.
segmentList shaka.extern.xml.Node <nullable>
The XML node for SegmentList.
segmentTemplate shaka.extern.xml.Node <nullable>
The XML node for SegmentTemplate.
getBaseUris function Function than returns an array of absolute base URIs for the frame.
width number | undefined The inherited width value.
height number | undefined The inherited height value.
contentType string The inherited media type.
mimeType string The inherited MIME type value.
codecs string The inherited codecs value.
frameRate number | undefined The inherited framerate value.
pixelAspectRatio string | undefined The inherited pixel aspect ratio value.
emsgSchemeIdUris Array.<string> emsg registered schemeIdUris.
id string <nullable>
The ID of the element.
language string <nullable>
The original language of the element.
numChannels number <nullable>
The number of audio channels, or null if unknown.
audioSamplingRate number <nullable>
Specifies the maximum sampling rate of the content, or null if unknown.
availabilityTimeOffset number Specifies the total availabilityTimeOffset of the segment, or 0 if unknown.
segmentSequenceCadence number Specifies the cadence of independent segments in Segment Sequence Representation.
Source:

PeriodInfo

Contains information about a Period element.
Type:
Properties:
Name Type Attributes Description
start number The start time of the period.
duration number <nullable>
The duration of the period; or null if the duration is not given. This will be non-null for all periods except the last.
node shaka.extern.xml.Node The XML Node for the Period.
isLastPeriod boolean Whether this Period is the last one in the manifest.
Source:

RequestSegmentCallback

Type:
  • function(!Array.<string>, ?number, ?number, boolean): !Promise.<BufferSource>
Source:

StreamInfo

Contains information about a Stream. This is passed from the createStreamInfo methods.
Type:
Properties:
Name Type Description
generateSegmentIndex shaka.dash.DashParser.GenerateSegmentIndexFunction An async function to create the SegmentIndex for the stream.
Source: