Constructor
()
Creates an Hls Parser object.
Implements:
Source:
Members
:Map.<string, string> Type:
Source:
:Map.<string, !Map.<string, string>> Type:
Map.<string, !Map.<string, string>>
Source:
:string Type:
Source:
:Map.<string, string> Type:
Source:
:Set.<string>
MIME types without init segment.
Type:
Source:
:string Type:
Properties:
Name
Value
Type
Description
VOD
VOD
string
EVENT
EVENT
string
LIVE
LIVE
string
Source:
:Map.<string, string> Type:
Source:
:Map.<string, string> Type:
Source:
An ewma that tracks how long updates take.
This is to mitigate issues caused by slow parsing on embedded devices.
Type:
Source:
Whether the manifest informs about the codec to use.
Source:
:Set.<string> Type:
Source:
:number Type:
Source:
:Map.<string, string> Type:
Source:
:Map.<string, Map.<string, string>>
A map from closed captions' group id, to a map of closed captions info.
{group id -> {closed captions channel id -> language}}
Type:
Map.<string, Map.<string, string>>
Source:
:Map.<string, string> Type:
Source:
A map from group id to stream infos created from the media tags.
Type:
Source:
:number Type:
Source:
:number
The lowest time value for any of the streams, as defined by the
EXT-X-PROGRAM-DATE-TIME value. Measured in seconds since January 1, 1970.
Type:
Source:
:boolean Type:
Source:
:boolean Type:
Source:
:number Type:
Source:
A cache mapping EXT-X-MAP tag info to the InitSegmentReference created
from the tag.
The key is a string combining the EXT-X-MAP tag's absolute uri, and
its BYTERANGE if available.
Type:
Source:
:string
The master playlist URI, after redirects.
Type:
Source:
:number Type:
Source:
For media playlist lazy-loading to work in livestreams, we have to assume
that each stream of a type (video, audio, etc) has the same mappings of
sequence number to start time.
This map stores those relationships.
Only used during livestreams; we do not assume that VOD content is
aligned in that way.
Type:
Map.<string, !Map.<number, number>>
Source:
:number
The minimum sequence number for generated segments, when ignoring
EXT-X-PROGRAM-DATE-TIME.
Type:
Source:
:boolean Type:
Source:
:number
Partial segments target duration.
Type:
Source:
:number Type:
Source:
:number Type:
Source:
:boolean
Whether the streams have previously been "finalized"; that is to say,
whether we have loaded enough streams to know information about the asset
such as timing information, live status, etc.
Type:
Source:
This timer is used to trigger the start of a manifest update. A manifest
update is async. Once the update is finished, the timer will be restarted
to trigger the next update. The timer will only be started if the content
is live content.
Type:
Source:
A map from (verbatim) media playlist URI to stream infos representing the
playlists.
On update, used to iterate through and update from media playlists.
On initial parse, used to iterate through and determine minimum
timestamps, offsets, and to handle TS rollover.
During parsing, used to avoid duplicates in the async methods
createStreamInfoFromMediaTags_, createStreamInfoFromImageTag_ and
createStreamInfoFromVariantTags_.
Type:
Source:
:boolean
Flag to indicate if any of the media playlists use
EXT-X-PROGRAM-DATE-TIME.
Type:
Source:
:Set.<string>
The values are strings of the form "
- ",
where the URIs are the verbatim media playlist URIs as they appeared in
the master playlist.
Used to avoid duplicates that vary only in their text stream.
Type:
Source:
Methods
See: https://docs.microsoft.com/en-us/playready/packaging/mp4-based-formats-supported-by-playready-clients?tabs=case4
Parameters:
Source:
Returns:
Type
shaka.extern.DrmInfo
(stream, widthnullable , heightnullable , frameRatenullable , videoRangenullable , videoLayoutnullable , colorGamutnullable ) Parameters:
Name
Type
Attributes
Description
stream
shaka.extern.Stream
width
string
<nullable>
height
string
<nullable>
frameRate
string
<nullable>
videoRange
string
<nullable>
videoLayout
string
<nullable>
colorGamut
string
<nullable>
Source:
(uri)
Tells the parser that a location should be banned. This is called on
retry.
Parameters:
Name
Type
Description
uri
string
Implements:
Source:
(playlistnon-null ) Parameters:
Source:
Called by the Player to provide an updated configuration any time the
configuration changes. Will be called at least once before start().
Parameters:
Implements:
Source:
(streamId, variablesnon-null , playlistnon-null , getUris, codecs, type, languageValuenullable , primary, namenullable , channelsCountnullable , closedCaptions, characteristicsnullable , forced, sampleRatenullable , spatialAudio, mimeType, requestBasicInfoopt , allowOverrideMimeTypeopt ) → {Promise.<!shaka.hls.HlsParser.StreamInfo >} Parameters:
Name
Type
Attributes
Default
Description
streamId
number
variables
Map.<string, string>
playlist
shaka.hls.Playlist
getUris
function(): !Array.<string>
codecs
string
type
string
languageValue
string
<nullable>
primary
boolean
name
string
<nullable>
channelsCount
number
<nullable>
closedCaptions
Map.<string, string>
characteristics
string
<nullable>
forced
boolean
sampleRate
number
<nullable>
spatialAudio
boolean
mimeType
string
|
undefined
requestBasicInfo
boolean
<optional>
true
allowOverrideMimeType
boolean
<optional>
true
Source:
Returns:
Type
Promise.<!shaka.hls.HlsParser.StreamInfo >
(initSegmentReference, previousReference, hlsSegmentnon-null , startTime, variablesnon-null , playlistnon-null , type, getUris, aesKeyopt ) → {shaka.media.SegmentReference }
Parses one shaka.hls.Segment object into a shaka.media.SegmentReference.
Parameters:
Source:
Returns:
Type
shaka.media.SegmentReference
(playlistnon-null , mediaSequenceToStartTimenon-null , variablesnon-null , getUris, type) → {{segments: !Array.<!shaka.media.SegmentReference >, bandwidth: (number|undefined)}}
Parses shaka.hls.Segment objects into shaka.media.SegmentReferences and
get the bandwidth necessary for this segments If it's defined in the
playlist.
Parameters:
Name
Type
Description
playlist
shaka.hls.Playlist
mediaSequenceToStartTime
Map.<number, number>
variables
Map.<string, string>
getUris
function(): !Array.<string>
type
string
Source:
Returns:
Type
{segments: !Array.<!shaka.media.SegmentReference >, bandwidth: (number|undefined)}
(streamId, verbatimMediaPlaylistUrisnon-null , codecs, type, languageValuenullable , primary, namenullable , channelsCountnullable , closedCaptions, characteristicsnullable , forced, sampleRatenullable , spatialAudio) → {shaka.hls.HlsParser.StreamInfo } Parameters:
Name
Type
Attributes
Description
streamId
number
verbatimMediaPlaylistUris
Array.<string>
codecs
string
type
string
languageValue
string
<nullable>
primary
boolean
name
string
<nullable>
channelsCount
number
<nullable>
closedCaptions
Map.<string, string>
characteristics
string
<nullable>
forced
boolean
sampleRate
number
<nullable>
spatialAudio
boolean
Source:
Returns:
Type
shaka.hls.HlsParser.StreamInfo
Parse EXT-X-MEDIA media tag into a Stream object.
Parameters:
Name
Type
Attributes
Default
Description
tags
Array.<!shaka.hls.Tag >
groupIdPathwayIdMapping
Map.<string, string>
requireUri
boolean
<optional>
true
Source:
Returns:
Type
shaka.hls.HlsParser.StreamInfo
Create audio and video streamInfos from an 'EXT-X-STREAM-INF' tag and its
related media tags.
Parameters:
Name
Type
Attributes
Description
tags
Array.<!shaka.hls.Tag >
mediaTags
Array.<!shaka.hls.Tag >
resolution
string
<nullable>
frameRate
string
<nullable>
Source:
Returns:
Type
shaka.hls.HlsParser.StreamInfos
Parameters:
Name
Type
Description
mediaTags
Array.<!shaka.hls.Tag >
Media tags from the playlist.
groupIdPathwayIdMapping
Map.<string, string>
Source:
(audioInfosnon-null , videoInfosnon-null , bandwidth, widthnullable , heightnullable , frameRatenullable , videoRangenullable , videoLayoutnullable , drmInfosnon-null , keyIdsnon-null , iFrameStreamsnon-null ) → {Array.<!shaka.extern.Variant >} Parameters:
Source:
Returns:
Type
Array.<!shaka.extern.Variant >
Parameters:
Name
Type
Attributes
Description
tags
Array.<!shaka.hls.Tag >
Variant tags from the playlist.
sessionKeyTags
Array.<!shaka.hls.Tag >
EXT-X-SESSION-KEY tags
from the playlist.
mediaTags
Array.<!shaka.hls.Tag >
EXT-X-MEDIA tags from the
playlist.
getUris
function(): !Array.<string>
variables
Map.<string, string>
<nullable>
iFrameStreams
Array.<!shaka.extern.Stream >
Source:
Returns:
Type
Promise.<!Array.<!shaka.extern.Variant >>
()
Source:
(playlistnon-null ) Parameters:
Source:
(playlistnon-null ) Parameters:
Source:
(playlistnon-null ) Parameters:
Source:
(streamInfosnon-null ) Parameters:
Source:
(tagnon-null ) → {number}
Get the channel count information for an HLS audio track.
CHANNELS specifies an ordered, "/" separated list of parameters.
If the type is audio, the first parameter will be a decimal integer
specifying the number of independent, simultaneous audio channels.
No other channels parameters are currently defined.
Parameters:
Source:
Returns:
Type
number
(tagnon-null , type) → {Map.<string, string>}
Get the closed captions map information for the EXT-X-STREAM-INF tag, to
create the stream info.
Parameters:
Source:
Returns:
closedCaptions
Type
Map.<string, string>
(tagnon-null ) → {Array.<string>}
Get the codecs from the 'EXT-X-STREAM-INF' tag.
Parameters:
Source:
Returns:
codecs
Type
Array.<string>
(segmentnullable , segmentIndex) → {Promise.<{mimeType: ?string, data: ?BufferSource}>} Parameters:
Source:
Returns:
Type
Promise.<{mimeType: ?string, data: ?BufferSource}>
(languageValuenullable ) → {string}
Get the normalized language value.
Parameters:
Name
Type
Attributes
Description
languageValue
string
<nullable>
Source:
Returns:
Type
string
() → {number}
Source:
Returns:
Type
number
Parameters:
Source:
Returns:
Type
Map.<number, number>
() → {number}
Source:
Returns:
Type
number
Get the next msn and part
Parameters:
Source:
Returns:
}
Type
{nextMediaSequence: number, nextPart:number}
(tagsnon-null , tagName) → {shaka.hls.Tag }
Returns a tag with a given name.
Throws an error if tag was not found.
Parameters:
Source:
Returns:
Type
shaka.hls.Tag
(tagnon-null ) → {number}
Get the sample rate information for an HLS audio track.
Parameters:
Source:
Returns:
Type
number
(tagnon-null ) → {string}
Get the type value.
Shaka recognizes the content types 'audio', 'video', 'text', and 'image'.
The HLS 'subtitles' type needs to be mapped to 'text'.
Parameters:
Source:
Returns:
Type
string
() → {number}
Source:
Returns:
Type
number
(contentType, codecs, segmentsnon-null ) → {Promise.<string>}
Attempts to guess stream's mime type.
Parameters:
Source:
Returns:
Type
Promise.<string>
(contentType, codecs) → {string}
Attempts to guess stream's mime type based on content type and URI.
Parameters:
Name
Type
Description
contentType
string
codecs
string
Source:
Returns:
Type
string
(contentType) → {string}
Get a fallback mime type for the content. Used if all the better methods
for determining the mime type have failed.
Parameters:
Name
Type
Description
contentType
string
Source:
Returns:
Type
string
() → {boolean}
There are some values on streams that can only be set once we know about
both the video and audio content, if present.
This checks if there is at least one video downloaded (if the media has
video), and that there is at least one audio downloaded (if the media has
audio).
Source:
Returns:
Type
boolean
(drmTagnon-null , mimeType, getUris, initSegmentRefnullable , variablesopt, nullable ) → {Promise.<?shaka.extern.DrmInfo >}
See: https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis-11#section-5.1
Parameters:
Source:
Returns:
Type
Promise.<?shaka.extern.DrmInfo >
(type) → {boolean} Parameters:
Name
Type
Description
type
string
Source:
Returns:
Type
boolean
(method) → {boolean} Parameters:
Name
Type
Description
method
string
Source:
Returns:
Type
boolean
() → {boolean}
Source:
Returns:
Type
boolean
(tagnon-null ) → {boolean}
Get the spatial audio information for an HLS audio track.
In HLS the channels field indicates the number of audio channels that the
stream has (eg: 2). In the case of Dolby Atmos (EAC-3), the complexity is
expressed with the number of channels followed by the word JOC
(eg: 16/JOC), so 16 would be the number of channels (eg: 7.3.6 layout),
and JOC indicates that the stream has spatial audio. For Dolby AC-4 ATMOS,
it's necessary search ATMOS word.
Parameters:
Source:
See:
Returns:
Type
boolean
Create a networking request. This will manage the request using the
parser's operation manager. If the parser has already been stopped, the
request will not be made.
Parameters:
Source:
Returns:
Type
shaka.net.NetworkingEngine.PendingRequest
(id, codecs, type, languageValuenullable , primary, namenullable , channelsCountnullable , closedCaptions, characteristicsnullable , forced, sampleRatenullable , spatialAudio) → {shaka.extern.Stream }
Creates a stream object with the given parameters.
The parameters that are passed into here are only the things that can be
known without downloading the media playlist; other values must be set
manually on the object after creation.
Parameters:
Name
Type
Attributes
Description
id
number
codecs
string
type
string
languageValue
string
<nullable>
primary
boolean
name
string
<nullable>
channelsCount
number
<nullable>
closedCaptions
Map.<string, string>
characteristics
string
<nullable>
forced
boolean
sampleRate
number
<nullable>
spatialAudio
boolean
Source:
Returns:
Type
shaka.extern.Stream
(streamsnon-null ) Parameters:
Source:
(streamInfonon-null , offset) Parameters:
Source:
(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:
(variant)
Tells the parser that the initial variant has been chosen.
Parameters:
Implements:
Source:
() → {Promise}
Called when the update timer ticks. Because parsing a manifest is async,
this method is async. To work with this, this method will schedule the next
update when it finished instead of using a repeating-start.
Source:
Returns:
Type
Promise
(previousReference, byterangenullable ) → {Array.<number>}
Parse the startByte and endByte.
Parameters:
Source:
Returns:
An array with the start byte and end byte.
Type
Array.<number>
(mediaTagsnon-null )
Parses an array of EXT-X-MEDIA tags, then stores the values of all tags
with TYPE="CLOSED-CAPTIONS" into a map of group id to closed captions.
Parameters:
Source:
(tagsnon-null )
Get the codecs of each variant tag, and store in a map from
audio/video/subtitle group id to the codecs array list.
Parameters:
Name
Type
Description
tags
Array.<!shaka.hls.Tag >
Variant tags from the playlist.
Source:
(playlistnon-null , mimeType, getUris, variablesopt, nullable ) → {Promise.<{drmInfos: !Array.<shaka.extern.DrmInfo >, keyIds: !Set.<string>, encrypted: boolean, aesEncrypted: boolean}>} Parameters:
Name
Type
Attributes
Description
playlist
shaka.hls.Playlist
mimeType
string
getUris
function(): !Array.<string>
variables
Map.<string, string>
<optional>
Source:
Returns:
Type
Promise.<{drmInfos: !Array.<shaka.extern.DrmInfo >, keyIds: !Set.<string>, encrypted: boolean, aesEncrypted: boolean}>
(data) → {Promise}
Parses the manifest.
Parameters:
Name
Type
Description
data
BufferSource
Source:
Returns:
Type
Promise
(tagsnon-null )
Get the variables of each variant tag, and store in a map.
Parameters:
Name
Type
Description
tags
Array.<!shaka.hls.Tag >
Variant tags from the playlist.
Source:
Get the variables of each variant tag, and store in a map.
Parameters:
Name
Type
Description
tags
Array.<!shaka.hls.Tag >
Variant tags from the playlist.
uri
string
Media playlist URI.
Source:
Returns:
Type
Map.<string, string>
(mediaTagsnon-null ) → {Array.<!shaka.extern.Stream >}
Parse Subtitles and Closed Captions from 'EXT-X-MEDIA' tags.
Create text streams for Subtitles, but not Closed Captions.
Parameters:
Name
Type
Description
mediaTags
Array.<!shaka.hls.Tag >
Media tags from the playlist.
Source:
Returns:
Type
Array.<!shaka.extern.Stream >
(tagsnon-null ) → {Promise}
Process EXT-X-CONTENT-STEERING tags.
Parameters:
Source:
Returns:
Type
Promise
Parameters:
Name
Type
Description
tags
Array.<!shaka.hls.Tag >
contentType
string
variables
Map.<string, string>
getUris
function(): !Array.<string>
Source:
(tagsnon-null )
Process EXT-X-SESSION-DATA tags.
Parameters:
Source:
Makes a network request for the manifest and returns a Promise
with the resulting data.
Parameters:
Name
Type
Attributes
Description
uris
Array.<string>
isPlaylist
boolean
<optional>
Source:
Returns:
Type
shaka.net.NetworkingEngine.PendingRequest
(streamnon-null ) Parameters:
Source:
Set media element.
Parameters:
Implements:
Source:
(type) Parameters:
Source:
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 >
() → {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
(streamInfosnon-null )
Synchronize streams by the EXT-X-PROGRAM-DATE-TIME tags attached to their
segments. Also normalizes segment times so that the earliest segment in
any stream is at time 0.
Parameters:
Source:
(streamInfosnon-null , forceopt )
Align the streams by sequence number by dropping early segments. Then
offset the streams to begin at presentation time 0.
Parameters:
Source:
()
Tells the parser to do a manual manifest update. Implementing this is
optional. This is only called when 'emsg' boxes are present.
Implements:
Source:
(streamInfonon-null ) → {Promise}
Updates a stream.
Parameters:
Source:
Returns:
Type
Promise
Type Definitions
DrmParser_
Type:
function(!shaka.hls.Tag, string):?shaka.extern.DrmInfo
Source:
StreamInfo
Contains a stream and information about it.
Type:
{stream : !shaka.extern.Stream , type: string, redirectUris: !Array.<string>, getUris: function(): !Array.<string>, minTimestamp: number, maxTimestamp: number, mediaSequenceToStartTime: !Map.<number, number>, canSkipSegments: boolean, canBlockReload: boolean, hasEndList: boolean, firstSequenceNumber: number, nextMediaSequence: number, nextPart: number, loadedOnce: boolean}
Properties:
Name
Type
Description
stream
shaka.extern.Stream
The Stream itself.
type
string
The type value. Could be 'video', 'audio', 'text', or 'image'.
redirectUris
Array.<string>
The redirect URIs.
getUris
function
The verbatim media playlist URIs, as it appeared in the master playlist.
minTimestamp
number
The minimum timestamp found in the stream.
maxTimestamp
number
The maximum timestamp found in the stream.
mediaSequenceToStartTime
Map.<number, number>
A map of media sequence numbers to media start times.
Only used for VOD content.
canSkipSegments
boolean
True if the server supports delta playlist updates, and we can send a
request for a playlist that can skip older media segments.
canBlockReload
boolean
True if the server supports blocking playlist reload, and we can send a
request for a playlist that can block reload until some segments are
present.
hasEndList
boolean
True if the stream has an EXT-X-ENDLIST tag.
firstSequenceNumber
number
The sequence number of the first reference. Only calculated if needed.
nextMediaSequence
number
The next media sequence.
nextPart
number
The next part.
loadedOnce
boolean
True if the stream has been loaded at least once.
Source:
StreamInfos
Audio and video stream infos.
Type:
Properties:
Source: