W3cubDocs

/DOM

Encrypted Media Extensions API

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Interfaces

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 associated HTMLMediaElement can use for decryption of media data during playback.
MediaKeySession
Represents a context for message exchange with a content decryption module (CDM).
MediaKeyStatusMap
Is 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.
MediaKeySystemConfiguration
Provides configuration information about the media key system.

Specifications

Specification Status Comment
Encrypted Media Extensions Recommendation Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 42
42
The spec requires that the passed supportedConfigurations option contain at least one of audioCapabilities or videoCapabilities, and that said parameters include a codec string.
The function does not exist in insecure contexts. This was not enforced until Chrome 58.
Yes Yes
Yes
Starting in Firefox 55, if neither audioCapabilities nor videoCapabilities is specified in supportedConfigurations, a warning is output to the web console.
In addition, starting in Firefox 55, if in supportedConfigurations, either audioCapabilities's or videoCapabilities's contentType value doesn't specify a "codecs" substring to define allowed codecs within the media wrapper, a warning is output to the web console. See note below table for example and correction.
In the future, if neither audioCapabilities nor videoCapabilities is specified in the supportedConfigurations, a NotSupported exception will be thrown.
? 29
29
The spec requires that the passed supportedConfigurations option contain at least one of audioCapabilities or videoCapabilities, and that said parameters include a codec string.
The function does not exist in insecure contexts. This was not enforced until Opera 45.
?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 43
43
The spec requires that the passed supportedConfigurations option contain at least one of audioCapabilities or videoCapabilities, and that said parameters include a codec string.
The function does not exist in insecure contexts. This was not enforced until version 58.
42
42
The spec requires that the passed supportedConfigurations option contain at least one of audioCapabilities or videoCapabilities, and that said parameters include a codec string.
The function does not exist in insecure contexts. This was not enforced until Chrome 58.
Yes Yes
Yes
Starting in Firefox 55, if neither audioCapabilities nor videoCapabilities is specified in supportedConfigurations, a warning is output to the web console.
In addition, starting in Firefox 55, if in supportedConfigurations, either audioCapabilities's or videoCapabilities's contentType value doesn't specify a "codecs" substring to define allowed codecs within the media wrapper, a warning is output to the web console. See note below table for example and correction.
In the future, if neither audioCapabilities nor videoCapabilities is specified in the supportedConfigurations, a NotSupported exception will be thrown.
29
29
The spec requires that the passed supportedConfigurations option contain at least one of audioCapabilities or videoCapabilities, and that said parameters include a codec string.
The function does not exist in insecure contexts. This was not enforced until Opera 45.
? ?

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Encrypted_Media_Extensions_API