Class: shaka.Player

Constructor

new Player(videonon-null, opt_dependencyInjectoropt)

Construct a Player.
Parameters:
Name Type Attributes Description
video HTMLMediaElement Any existing TextTracks attached to this element that were not created by Shaka will be disabled. A new TextTrack may be created to display captions or subtitles.
opt_dependencyInjector function(shaka.Player)= <optional>
 Optional callback which is called to inject mocks into the Player. Used for testing.
Implements:
Extends:
Source:

Members

(private, static, non-null) supportPlugins_ :Object.<string, function(): *>

Type:
  • Object.<string, function(): *>
Source:

(private, static, constant) TextTrackLabel_ :string

Type:
  • string
Source:

(static, constant) version :string

Type:
  • string
Source:

(private) buffering_ :boolean

Type:
  • boolean
Source:

(private) bufferingTime_ :number

Type:
  • number
Source:

(private, nullable) config_ :shakaExtern.PlayerConfiguration

Type:
Source:

(private) defaultAbrManager_ :shakaExtern.AbrManager

Type:
Source:

(private, non-null) deferredSwitches_ :Object.<string, {stream: shakaExtern.Stream, clearBuffer: boolean}>

Type:
Source:

(private) destroyed_ :boolean

Type:
  • boolean
Source:

dispatchTarget :EventTarget

The target of all dispatched events. Defaults to |this|.
Type:
  • EventTarget
Inherited From:
Source:

(private) drmEngine_ :shaka.media.DrmEngine

Type:
Source:

(private) eventManager_ :shaka.util.EventManager

Type:
Source:

(private) lastStatUpdateTimestamp_ :number

Type:
  • number
Source:

(private, non-null) listeners_ :shaka.util.MultiMap.<shaka.util.FakeEventTarget.ListenerType>

Type:
Inherited From:
Source:

(private) loadChain_ :shaka.util.CancelableChain

Type:
Source:

(private, non-null) loadingTextStreamIds_ :Array.<number>

Type:
  • Array.<number>
Source:

(private, nullable) manifest_ :shakaExtern.Manifest

Type:
Source:

(private, nullable) manifestUri_ :string

Type:
  • string
Source:

(private) maxHwRes_ :{width: number, height: number}

Type:
  • {width: number, height: number}
Source:

(private) mediaSource_ :MediaSource

Type:
  • MediaSource
Source:

(private) mediaSourceEngine_ :shaka.media.MediaSourceEngine

Type:
Source:

(private) mediaSourceOpen_ :Promise

Type:
  • Promise
Source:

(private) networkingEngine_ :shaka.net.NetworkingEngine

Type:
Source:

(private) nextExternalStreamId_ :number

Contains an ID for use with creating streams. The manifest parser should start with small IDs, so this starts with a large one.
Type:
  • number
Source:

(private) parser_ :shakaExtern.ManifestParser

Type:
Source:

(private) playhead_ :shaka.media.Playhead

Type:
Source:

(private) playTime_ :number

Type:
  • number
Source:

(private) streamingEngine_ :shaka.media.StreamingEngine

Type:
Source:

(private, non-null) switchHistory_ :Array.<shakaExtern.StreamChoice>

Type:
Source:

(private) switchingPeriods_ :boolean

Type:
  • boolean
Source:

(private) textTrack_ :TextTrack

Type:
  • TextTrack
Source:

(private) unloadChain_ :Promise

Type:
  • Promise
Source:

(private) video_ :HTMLMediaElement

Type:
  • HTMLMediaElement
Source:

Methods

(static) isBrowserSupported() → {boolean}

Return whether the browser provides basic support. If this returns false, Shaka Player cannot be used at all. In this case, do not construct a Player instance and do not use the library.
Source:
Returns:
Type
boolean

(static) probeSupport() → (non-null) {Promise.<shakaExtern.SupportType>}

Probes the browser to determine what features are supported. This makes a number of requests to EME/MSE/etc which may result in user prompts. This should only be used for diagnostics. NOTE: This may show a request to the user for permission.
Source:
See:
Returns:
Type
Promise.<shakaExtern.SupportType>

(static) registerSupportPlugin(name, callback)

Registers a plugin callback that will be called with support(). The callback will return the value that will be stored in the return value from support().
Parameters:
Name Type Description
name string
callback function(): *
Source:

addEventListener(type, listener, opt_capturingopt)

Add an event listener to this object.
Parameters:
Name Type Attributes Description
type string The event type to listen for.
listener shaka.util.FakeEventTarget.ListenerType The callback or listener object to invoke.
opt_capturing boolean <optional>
 Ignored. FakeEventTargets do not have parents, so events neither capture nor bubble.
Inherited From:
Source:

addTextTrack(uri, language, kind, mime, opt_codecopt) → (non-null) {Promise.<shakaExtern.Track>}

Adds the given text track to the current Period. Load() must resolve before calling. The current Period or the presentation must have a duration. This returns a Promise that will resolve when the track can be switched to and will resolve with the track that was created.
Parameters:
Name Type Attributes Description
uri string
language string
kind string
mime string
opt_codec string <optional>
Source:
Returns:
Type
Promise.<shakaExtern.Track>

(private) applyConfig_()

Apply config changes.
Source:

cancelTrickPlay()

Cancel trick-play.
Source:

(private) canSwitch_()

Callback from StreamingEngine.
Source:

(private) chooseStreams_(periodnon-null, streamSetsByTypenon-null, opt_chooseAllopt) → (non-null) {Object.<string, !shakaExtern.Stream>}

Chooses streams from the given Period.
Parameters:
Name Type Attributes Description
period shakaExtern.Period
streamSetsByType Object.<string, shakaExtern.StreamSet>
opt_chooseAll boolean <optional>
 If true, choose streams from all stream sets.
Source:
Returns:
A map of stream types to chosen streams.
Type
Object.<string, !shakaExtern.Stream>

(private) chooseStreamsAndSwitch_(periodnon-null)

Chooses streams from the given Period and switches to them. Called after a config change, a new text stream, or a key status event.
Parameters:
Name Type Description
period shakaExtern.Period
Source:

(private) configOverrides_() → (non-null) {Object}

Source:
Returns:
Type
Object

configure(confignon-null)

Configure the Player instance. The config object passed in need not be complete. It will be merged with the existing Player configuration. Config keys and types will be checked. If any problems with the config object are found, errors will be reported through logs.
Parameters:
Name Type Description
config Object This should follow the form of shakaExtern.PlayerConfiguration, but you may omit any field you do not wish to change.
Source:

createDrmEngine() → (non-null) {shaka.media.DrmEngine}

Creates a new instance of DrmEngine. This can be replaced by tests to create fake instances instead.
Source:
Returns:
Type
shaka.media.DrmEngine

createMediaSource() → (non-null) {Promise}

Create and open MediaSource. Potentially slow.
Source:
Returns:
Type
Promise

createMediaSourceEngine() → (non-null) {shaka.media.MediaSourceEngine}

Creates a new instance of MediaSourceEngine. This can be replaced by tests to create fake instances instead.
Source:
Returns:
Type
shaka.media.MediaSourceEngine

createNetworkingEngine() → (non-null) {shaka.net.NetworkingEngine}

Creates a new instance of NetworkingEngine. This can be replaced by tests to create fake instances instead.
Source:
Returns:
Type
shaka.net.NetworkingEngine

createPlayhead(opt_startTimeopt) → (non-null) {shaka.media.Playhead}

Creates a new instance of Playhead. This can be replaced by tests to create fake instances instead.
Parameters:
Name Type Attributes Description
opt_startTime number <optional>
Source:
Returns:
Type
shaka.media.Playhead

createStreamingEngine() → (non-null) {shaka.media.StreamingEngine}

Creates a new instance of StreamingEngine. This can be replaced by tests to create fake instances instead.
Source:
Returns:
Type
shaka.media.StreamingEngine

(private) defaultConfig_() → {shakaExtern.PlayerConfiguration}

Source:
Returns:
Type
shakaExtern.PlayerConfiguration

(private) deferredSwitch_(streamsByTypenon-null, opt_clearBufferopt)

Switches to the given streams, deferring switches if needed.
Parameters:
Name Type Attributes Description
streamsByType Object.<string, shakaExtern.Stream>
opt_clearBuffer boolean <optional>
Source:

destroy() → (non-null) {Promise}

After destruction, a Player object cannot be used again.
Implements:
Source:
Returns:
Type
Promise

(private) destroyStreaming_() → (non-null) {Promise}

Destroy members responsible for streaming.
Source:
Returns:
Type
Promise

dispatchEvent(eventnon-null) → {boolean}

Dispatch an event from this object.
Parameters:
Name Type Description
event Event The event to be dispatched from this object.
Inherited From:
Source:
Returns:
True if the default action was prevented.
Type
boolean

drmInfo() → (nullable) {shakaExtern.DrmInfo}

Get the DrmInfo used to initialize EME. This returns null when not using EME.
Source:
Returns:
Type
shakaExtern.DrmInfo

(private) filterPeriod_(period)

Parameters:
Name Type Description
period shakaExtern.Period
Source:

getConfiguration() → {shakaExtern.PlayerConfiguration}

Return a copy of the current configuration. Modifications of the returned value will not affect the Player's active configuration. You must call player.configure() to make changes.
Source:
Returns:
Type
shakaExtern.PlayerConfiguration

getManifestUri() → (nullable) {string}

Source:
Returns:
If a manifest is loaded, returns the manifest URI given in the last call to load(). Otherwise, returns null.
Type
string

getMediaElement() → {HTMLMediaElement}

Source:
Returns:
A reference to the HTML Media Element passed in during initialization.
Type
HTMLMediaElement

getNetworkingEngine() → {shaka.net.NetworkingEngine}

Source:
Returns:
A reference to the Player's networking engine. Applications may use this to make requests through Shaka's networking plugins.
Type
shaka.net.NetworkingEngine

getPlaybackRate() → {number}

Gets the current effective playback rate. If using trick play, it will return the current trick play rate; otherwise, it will return the video playback rate.
Source:
Returns:
Type
number

getStats() → {shakaExtern.Stats}

Return playback and adaptation stats.
Source:
Returns:
Type
shakaExtern.Stats

getTracks() → (non-null) {Array.<shakaExtern.Track>}

Return a list of audio, video, and text tracks available for the current Period. If there are multiple Periods, then you must seek to the Period before being able to switch.
Source:
Returns:
Type
Array.<shakaExtern.Track>

(private) initialize_()

Initialize the Player.
Source:

isBuffering() → {boolean}

Source:
Returns:
True if the Player is in a buffering state.
Type
boolean

isInProgress() → {boolean}

Source:
Returns:
True if the current stream is in-progress VOD. False otherwise.
Type
boolean

isLive() → {boolean}

Source:
Returns:
True if the current stream is live. False otherwise.
Type
boolean

isTextTrackVisible() → {boolean}

Source:
Returns:
True if the current text track is visible.
Type
boolean

keySystem() → {string}

Get the key system currently being used by EME. This returns the empty string if not using EME.
Source:
Returns:
Type
string

load(manifestUri, opt_startTimeopt, opt_manifestParserFactoryopt) → (non-null) {Promise}

Load a manifest.
Parameters:
Name Type Attributes Description
manifestUri string
opt_startTime number <optional>
 Optional start time, in seconds, to begin playback. Defaults to 0 for VOD and to the live edge for live.
opt_manifestParserFactory shakaExtern.ManifestParser.Factory <optional>
 Optional manifest parser factory to override auto-detection or use an unregistered parser.
Source:
Returns:
Resolved when the manifest has been loaded and playback has begun; rejected when an error occurs or the call was interrupted by destroy(), unload() or another call to load().
Type
Promise

(private) onAdaptation_()

Dispatches a 'adaptation' event.
Source:

(private) onBuffering_(buffering)

Callback from Playhead.
Parameters:
Name Type Description
buffering boolean
Source:

(private) onChooseStreams_(periodnon-null) → (non-null) {Object.<string, !shakaExtern.Stream>}

Callback from StreamingEngine.
Parameters:
Name Type Description
period shakaExtern.Period
Source:
Returns:
A map of stream types to chosen streams.
Type
Object.<string, !shakaExtern.Stream>

(private) onError_(errornon-null)

Parameters:
Name Type Description
error shaka.util.Error
Source:

(private) onEvent_(eventnon-null)

Parameters:
Name Type Description
event Event
Source:

(private) onKeyStatus_(keyStatusMapnon-null)

Parameters:
Name Type Description
keyStatusMap Object.<string, string> A map of hex key IDs to statuses.
Source:

(private) onSeek_()

Callback from Playhead.
Source:

(private) onSegmentDownloaded_(startTimeMs, endTimeMs, numBytes)

Callback from NetworkingEngine.
Parameters:
Name Type Description
startTimeMs number
endTimeMs number
numBytes number
Source:

(private) onTextTrackVisibility_()

Source:

(private) onTracksChanged_()

Dispatches a 'trackschanged' event.
Source:

(private) onVideoError_(eventnon-null)

Parameters:
Name Type Description
event Event
Source:

removeEventListener(type, listener, opt_capturingopt)

Remove an event listener from this object.
Parameters:
Name Type Attributes Description
type string The event type for which you wish to remove a listener.
listener shaka.util.FakeEventTarget.ListenerType The callback or listener object to remove.
opt_capturing boolean <optional>
 Ignored. FakeEventTargets do not have parents, so events neither capture nor bubble.
Inherited From:
Source:

resetConfiguration()

Reset configuration to default.
Source:

(private) resetStreaming_() → (non-null) {Promise}

Reset the streaming system.
Source:
Returns:
Type
Promise

seekRange() → {{start: number, end: number}}

Get the seekable range for the current stream.
Source:
Returns:
Type
{start: number, end: number}

selectTrack(track, opt_clearBufferopt)

Select a specific track. For audio or video, this disables adaptation. Note that AdaptationEvents are not fired for manual track selections.
Parameters:
Name Type Attributes Description
track shakaExtern.Track
opt_clearBuffer boolean <optional>
Source:

setMaxHardwareResolution(width, height)

Set the maximum resolution that the platform's hardware can handle. This will be called automatically by shaka.cast.CastReceiver to enforce limitations of the Chromecast hardware.
Parameters:
Name Type Description
width number
height number
Source:

setTextTrackVisibility(on)

Set the visibility of the current text track, if any.
Parameters:
Name Type Description
on boolean
Source:

(private) switch_(streamsByTypenon-null, opt_clearBufferopt)

Callback from AbrManager.
Parameters:
Name Type Attributes Description
streamsByType Object.<string, !shakaExtern.Stream>
opt_clearBuffer boolean <optional>
Source:

trickPlay(rate)

Skip through the content without playing. Simulated using repeated seeks. Trick play will be canceled automatically if the playhead hits the beginning or end of the seekable range for the content.
Parameters:
Name Type Description
rate number The playback rate to simulate. For example, a rate of 2.5 would result in 2.5 seconds of content being skipped every second. To trick-play backward, use a negative rate.
Source:

unload() → (non-null) {Promise}

Unload the current manifest and make the Player available for re-use.
Source:
Returns:
Resolved when streaming has stopped and the previous content, if any, has been unloaded.
Type
Promise

(private) updateStats_()

Source:

Events

AdaptationEvent

Fired when an automatic adaptation causes the active tracks to change. Does not fire when the application calls selectTrack().
Properties:
Name Type Description
type string 'adaptation'
Source:

BufferingEvent

Fired when the player's buffering state changes.
Properties:
Name Type Description
type string 'buffering'
buffering boolean True when the Player enters the buffering state. False when the Player leaves the buffering state.
Source:

EmsgEvent

Fired when a non-typical emsg is found in a segment.
Properties:
Name Type Description
type string 'emsg'
detail shakaExtern.EmsgInfo An object which contains the content of the emsg box.
Source:

ErrorEvent

Fired when a playback error occurs.
Properties:
Name Type Description
type string 'error'
detail shaka.util.Error An object which contains details on the error. The error's 'category' and 'code' properties will identify the specific error that occured. In an uncompiled build, you can also use the 'message' and 'stack' properties to debug.
Source:

LoadingEvent

Fired when the player begins loading. Used by the Cast receiver to determine idle state.
Properties:
Name Type Description
type string 'loading'
Source:

TextTrackVisibilityEvent

Fired when text track visibility changes.
Properties:
Name Type Description
type string 'texttrackvisibility'
Source:

TracksChangedEvent

Fired when the list of tracks changes. For example, this will happen when changing periods or when track restrictions change.
Properties:
Name Type Description
type string 'trackschanged'
Source:

UnloadingEvent

Fired when the player unloads or fails to load. Used by the Cast receiver to determine idle state.
Properties:
Name Type Description
type string 'unloading'
Source: