JSDoc: Class: shaka.util.StreamUtils

Constructor

new StreamUtils()

A set of utility functions for dealing with Streams and Manifests.

Source:

lib/util/stream_utils.js, line 24

Members

DecodingAttributes :string

Type:

string

Properties:

Name	Value	Type
`SMOOTH`	smooth	string
`POWER`	powerEfficient	string
`BANDWIDTH`	bandwidth	string

Source:

lib/util/stream_utils.js, line 1504

nextTrackId_ :number

Type:

number

Source:

lib/util/stream_utils.js, line 1499

Methods

applyRestrictions(variantsnon-null, restrictions, maxHwRes) → {boolean}

Parameters:

Name	Type	Description
`variants`	Array.<shaka.extern.Variant>
`restrictions`	shaka.extern.Restrictions
`maxHwRes`	{width: number, height: number}

Source:

lib/util/stream_utils.js, line 380

Returns:

Whether the tracks changed.

Type: boolean

areStreamsCompatible_(s0, s1) → {boolean}

Parameters:

Name	Type	Description
`s0`	shaka.extern.Stream
`s1`	shaka.extern.Stream

Source:

lib/util/stream_utils.js, line 855

Returns:

Type: boolean

chooseCodecsAndFilterManifest(manifestnon-null, preferredVideoCodecsnon-null, preferredAudioCodecsnon-null, preferredAudioChannelCount, preferredDecodingAttributesnon-null)

In case of multiple usable codecs, choose one based on lowest average bandwidth and filter out the rest. Also filters out variants that have too many audio channels.

Parameters:

Name	Type	Description
`manifest`	shaka.extern.Manifest
`preferredVideoCodecs`	Array.<string>
`preferredAudioCodecs`	Array.<string>
`preferredAudioChannelCount`	number
`preferredDecodingAttributes`	Array.<string>

Source:

lib/util/stream_utils.js, line 35

chooseCodecsByDecodingAttributes_(variantsByCodecsnon-null, attributesnon-null) → {string}

Choose the codecs by configured preferred decoding attributes.

Parameters:

Name	Type	Description
`variantsByCodecs`	shaka.util.MultiMap.<shaka.extern.Variant>
`attributes`	Array.<string>

Source:

lib/util/stream_utils.js, line 178

Returns:

Type: string

chooseCodecsByMediaCapabilitiesInfo_(variantsByCodecsnon-null, attribute) → {shaka.util.MultiMap.<shaka.extern.Variant>}

Choose the best codecs by configured preferred MediaCapabilitiesInfo attributes.

Parameters:

Name	Type	Description
`variantsByCodecs`	shaka.util.MultiMap.<shaka.extern.Variant>
`attribute`	string

Source:

lib/util/stream_utils.js, line 210

Returns:

Type: shaka.util.MultiMap.<shaka.extern.Variant>

choosePreferredCodecs(variantsnon-null, preferredVideoCodecsnon-null, preferredAudioCodecsnon-null) → {Array.<shaka.extern.Variant>}

Choose the codecs by configured preferred audio and video codecs.

Parameters:

Name	Type	Description
`variants`	Array.<shaka.extern.Variant>
`preferredVideoCodecs`	Array.<string>
`preferredAudioCodecs`	Array.<string>

Source:

lib/util/stream_utils.js, line 145

Returns:

Type: Array.<shaka.extern.Variant>

filterByRestrictions(manifestnon-null, restrictions, maxHwResolution)

Filter the variants in |manifest| to only include the variants that meet the given restrictions.

Parameters:

Name	Type	Description
`manifest`	shaka.extern.Manifest
`restrictions`	shaka.extern.Restrictions
`maxHwResolution`	{width: number, height:number}

Source:

lib/util/stream_utils.js, line 307

filterImageStreams_(manifest)

Alters the given Manifest to filter out any unsupported image streams.

Parameters:

Name	Type	Description
`manifest`	shaka.extern.Manifest

Source:

lib/util/stream_utils.js, line 818

filterManifest(drmEngine, currentVariantnullable, manifest)

Alters the given Manifest to filter out any unplayable streams.

Parameters:

Name	Type	Attributes
`drmEngine`	shaka.media.DrmEngine
`currentVariant`	shaka.extern.Variant	<nullable>
`manifest`	shaka.extern.Manifest

Source:

lib/util/stream_utils.js, line 404

filterManifestByCurrentVariant(currentVariantnullable, manifest)

Alters the given Manifest to filter out any streams uncompatible with the current variant.

Parameters:

Name	Type	Attributes	Description
`currentVariant`	shaka.extern.Variant	<nullable>
`manifest`	shaka.extern.Manifest

Source:

lib/util/stream_utils.js, line 758

filterManifestByMediaCapabilities(manifest, usePersistentLicenses)

Alters the given Manifest to filter out any streams unsupported by the platform via MediaCapabilities.decodingInfo() API.

Parameters:

Name	Type	Description
`manifest`	shaka.extern.Manifest
`usePersistentLicenses`	boolean

Source:

lib/util/stream_utils.js, line 422

filterStreamsByLanguageAndRole(streamsnon-null, preferredLanguage, preferredRole, preferredForced) → {Array.<!shaka.extern.Stream>}

Chooses streams according to the given config.

Parameters:

Name	Type	Description
`streams`	Array.<shaka.extern.Stream>
`preferredLanguage`	string
`preferredRole`	string
`preferredForced`	boolean

Source:

lib/util/stream_utils.js, line 1307

Returns:

Type: Array.<!shaka.extern.Stream>

filterTextStreams_(manifest)

Alters the given Manifest to filter out any unsupported text streams.

Parameters:

Name	Type	Description
`manifest`	shaka.extern.Manifest

Source:

lib/util/stream_utils.js, line 795

filterTextStreamsByRole_(textStreamsnon-null, preferredRole) → {Array.<shaka.extern.Stream>}

Filter text Streams by role.

Parameters:

Name	Type	Description
`textStreams`	Array.<shaka.extern.Stream>
`preferredRole`	string

Source:

lib/util/stream_utils.js, line 1395

Returns:

Type: Array.<shaka.extern.Stream>

filterVariantsByAudioChannelCount(variantsnon-null, preferredAudioChannelCount) → {Array.<!shaka.extern.Variant>}

Filters variants according to the given audio channel count config.

Parameters:

Name	Type	Description
`variants`	Array.<shaka.extern.Variant>
`preferredAudioChannelCount`	number

Source:

lib/util/stream_utils.js, line 1259

Returns:

Type: Array.<!shaka.extern.Variant>

filterVariantsByDensity_(variantsByCodecsnon-null) → {shaka.util.MultiMap.<shaka.extern.Variant>}

Filters variants by density. Get variants by codecs map with the max density where all codecs are present.

Parameters:

Name	Type	Description
`variantsByCodecs`	shaka.util.MultiMap.<shaka.extern.Variant>

Source:

lib/util/stream_utils.js, line 102

Returns:

Type: shaka.util.MultiMap.<shaka.extern.Variant>

findCodecsByLowestBandwidth_(variantsByCodecsnon-null) → {string}

Find the lowest-bandwidth (best) codecs. Compute the average bandwidth for each group of variants.

Parameters:

Name	Type	Description
`variantsByCodecs`	shaka.util.MultiMap.<shaka.extern.Variant>

Source:

lib/util/stream_utils.js, line 246

Returns:

Type: string

getCorrectAudioCodecs_(codecs) → {string}

Generates the correct audio codec for MediaDecodingConfiguration and for MediaSource.isTypeSupported.

Parameters:

Name	Type	Description
`codecs`	string

Source:

lib/util/stream_utils.js, line 722

Returns:

Type: string

getDecodingConfigs_(variantnon-null, usePersistentLicenses, srcEquals) → {Array.<!MediaDecodingConfiguration>}

Generate a MediaDecodingConfiguration object to get the decodingInfo results for each variant.

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant
`usePersistentLicenses`	boolean
`srcEquals`	boolean

Source:

lib/util/stream_utils.js, line 543

Returns:

Type: Array.<!MediaDecodingConfiguration>

getDecodingInfosForVariants(variantsnon-null, usePersistentLicenses, srcEquals)

Get the decodingInfo results of the variants via MediaCapabilities. This should be called after the DrmEngine is created and configured, and before DrmEngine sets the mediaKeys.

Parameters:

Name	Type	Description
`variants`	Array.<shaka.extern.Variant>
`usePersistentLicenses`	boolean
`srcEquals`	boolean

Source:

lib/util/stream_utils.js, line 499

getPlayableVariants(variantsnon-null) → {Array.<!shaka.extern.Variant>}

Filters out unplayable variants.

Parameters:

Name	Type	Description
`variants`	Array.<!shaka.extern.Variant>

Source:

lib/util/stream_utils.js, line 1245

Returns:

Type: Array.<!shaka.extern.Variant>

getStreamSummaryString_(stream) → {string}

Returns a string of an audio or video stream for log printing.

Parameters:

Name	Type	Description
`stream`	shaka.extern.Stream

Source:

lib/util/stream_utils.js, line 1472

Returns:

Type: string

getVariantCodecs_(variantnon-null) → {string}

Get a string representing all codecs used in a variant.

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant

Source:

lib/util/stream_utils.js, line 281

Returns:

Type: string

getVariantsByCodecs_(variantsnon-null) → {shaka.util.MultiMap.<shaka.extern.Variant>}

Get variants by codecs.

Parameters:

Name	Type	Description
`variants`	Array.<shaka.extern.Variant>

Source:

lib/util/stream_utils.js, line 83

Returns:

Type: shaka.util.MultiMap.<shaka.extern.Variant>

getVariantStreams(variant) → {Array.<shaka.extern.Stream>}

Get all non-null streams in the variant as an array.

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant

Source:

lib/util/stream_utils.js, line 1432

Returns:

Type: Array.<shaka.extern.Stream>

getVariantSummaryString_(variant) → {string}

Returns a string of a variant, with the attribute values of its audio and/or video streams for log printing.

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant

Source:

lib/util/stream_utils.js, line 1453

Returns:

Type: string

html5AudioTrackToTrack(audioTrack) → {shaka.extern.Track}

Parameters:

Name	Type	Description
`audioTrack`	AudioTrack

Source:

lib/util/stream_utils.js, line 1158

Returns:

Type: shaka.extern.Track

html5TextTrackToTrack(textTrack) → {shaka.extern.Track}

Parameters:

Name	Type	Description
`textTrack`	TextTrack

Source:

lib/util/stream_utils.js, line 1130

Returns:

Type: shaka.extern.Track

html5TrackId(html5Track) → {number}

Generate and return an ID for this track, since the ID field is optional.

Parameters:

Name	Type	Description
`html5Track`	TextTrack \| AudioTrack

Source:

lib/util/stream_utils.js, line 1118

Returns:

The generated ID.

Type: number

html5TrackToGenericShakaTrack_(html5Track) → {shaka.extern.Track}

Creates a Track object with non-type specific fields filled out. The caller is responsible for completing the Track object with any type-specific information (audio or text).

Parameters:

Name	Type	Description
`html5Track`	TextTrack \| AudioTrack

Source:

lib/util/stream_utils.js, line 1189

Returns:

Type: shaka.extern.Track

imageStreamToTrack(stream) → {shaka.extern.Track}

Parameters:

Name	Type	Description
`stream`	shaka.extern.Stream

Source:

lib/util/stream_utils.js, line 1044

Returns:

Type: shaka.extern.Track

isAudio(stream) → {boolean}

Checks if the given stream is an audio stream.

Parameters:

Name	Type	Description
`stream`	shaka.extern.Stream

Source:

lib/util/stream_utils.js, line 1408

Returns:

Type: boolean

isPlayable(variantnon-null) → {boolean}

Determines if the given variant is playable.

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant

Source:

lib/util/stream_utils.js, line 1235

Returns:

Type: boolean

isVideo(stream) → {boolean}

Checks if the given stream is a video stream.

Parameters:

Name	Type	Description
`stream`	shaka.extern.Stream

Source:

lib/util/stream_utils.js, line 1420

Returns:

Type: boolean

meetsRestrictions(variant, restrictions, maxHwRes) → {boolean}

Parameters:

Name	Type	Description
`variant`	shaka.extern.Variant
`restrictions`	shaka.extern.Restrictions	Configured restrictions from the user.
`maxHwRes`	{width: number, height: number}	The maximum resolution the hardware can handle. This is applied separately from user restrictions because the setting should not be easily replaced by the user's configuration.

Source:

lib/util/stream_utils.js, line 324

Returns:

Type: boolean

patchVp9(codec) → {string}

MediaCapabilities supports 'vp09...' codecs, but not 'vp9'. Translate vp9 codec strings into 'vp09...', to allow such content to play with mediaCapabilities enabled.