View as markdown
Copy for LLM Open in ChatGPT Open in Claude Open in Perplexity

Media

Experimental

This domain allows detailed inspection of media elements.

Commands

Media.enable

Enables the Media domain

Media.disable

Disables the Media domain.

Events

Media.playerPropertiesChanged

This can be called multiple times, and can be used to set / override /
remove player properties. A null propValue indicates removal.

Parameters
Name Type Description
playerId PlayerId
properties array<PlayerProperty>

Media.playerEventsAdded

Send events as a list, allowing them to be batched on the browser for less
congestion. If batched, events must ALWAYS be in chronological order.

Parameters
Name Type Description
playerId PlayerId
events array<PlayerEvent>

Media.playerMessagesLogged

Send a list of any messages that need to be delivered.

Parameters
Name Type Description
playerId PlayerId
messages array<PlayerMessage>

Media.playerErrorsRaised

Send a list of any errors that need to be delivered.

Parameters
Name Type Description
playerId PlayerId
errors array<PlayerError>

Media.playerCreated

Called whenever a player is created, or when a new agent joins and receives
a list of active players. If an agent is restored, it will receive one
event for each active player.

Parameters
Name Type Description
player Player

Types

PlayerId

(string)

Players will get an ID that is unique within the agent context.

Timestamp

(number)

PlayerMessage

(object)

Have one type per entry in MediaLogRecord::Type
Corresponds to kMessage

Properties
Name Type Description
level string Keep in sync with MediaLogMessageLevel
We are currently keeping the message level 'error' separate from the
PlayerError type because right now they represent different things,
this one being a DVLOG(ERROR) style log message that gets printed
based on what log level is selected in the UI, and the other is a
representation of a media::PipelineStatus object. Soon however we're
going to be moving away from using PipelineStatus for errors and
introducing a new error type which should hopefully let us integrate
the error log level into the PlayerError type.
message string

PlayerProperty

(object)

Corresponds to kMediaPropertyChange

Properties
Name Type Description
name string
value string

PlayerEvent

(object)

Corresponds to kMediaEventTriggered

Properties
Name Type Description
timestamp Timestamp
value string

PlayerErrorSourceLocation

(object)

Represents logged source line numbers reported in an error.
NOTE: file and line are from chromium c++ implementation code, not js.

Properties
Name Type Description
file string
line integer

PlayerError

(object)

Corresponds to kMediaError

Properties
Name Type Description
errorType string
code integer Code is the numeric enum entry for a specific set of error codes, such
as PipelineStatusCodes in media/base/pipeline_status.h
stack array<PlayerErrorSourceLocation> A trace of where this error was caused / where it passed through.
cause array<PlayerError> Errors potentially have a root cause error, ie, a DecoderError might be
caused by an WindowsError
data object Extra data attached to an error, such as an HRESULT, Video Codec, etc.

Player

(object)
Properties
Name Type Description
playerId PlayerId
domNodeId (optional) DOM.BackendNodeId

Summary