TheEncrypted Media Extensions API provides interfaces for controlling the playback of content which is subject to a digital restrictions management scheme.

Access to this API is provided throughNavigator.requestMediaKeySystemAccess().

Interfaces

MediaEncryptedEvent

Represents a specificencrypted event thrown when aHTMLMediaElement encounters some initialization data.

MediaKeyMessageEvent

Contains the content and related data when the content decryption module (CDM) generates a message for the session.

MediaKeys

Represents a set of keys that an associatedHTMLMediaElement can use for decryption of media data during playback.

MediaKeySession

Represents a context for message exchange with a content decryption module (CDM).

MediaKeyStatusMap

A read-only map of media key statuses by key IDs.

MediaKeySystemAccess

Provides access to a key system for decryption and/or a content protection provider.

Extensions to other interfaces

The Encrypted Media Extensions API extends the following APIs, adding the listed features.

HTMLMediaElement

HTMLMediaElement.mediaKeysRead only

Provides aMediaKeys object that represents the set of keys that the element can use for decryption of media data during playback.

HTMLMediaElement.setMediaKeys()

Sets theMediaKeys that will be used to decrypt media during playback.

encrypted event

Event that is fired on aHTMLMediaElement when initialization data is encountered in the media, indicating that it is encrypted.

Navigator

Navigator.requestMediaKeySystemAccess()

Returns aPromise that fulfils to aMediaKeySystemAccess object that can be used to access a particular media key system, which can in turn be used to create keys for decrypting a media stream.

Specifications

Browser compatibility