requestMediaKeySystemAccess method

Requests access to the specified Key System.

Syntax

var retval = navigator.requestMediaKeySystemAccess(keySystem, supportedConfigurations);

Parameters

keySystem

Type: DOMString

The Key System for which access is being requested.

supportedConfigurations

Type: sequence<MediaKeySystemConfiguration>

A sequence of MediaKeySystemConfiguration configurations to try in order. The first element with a satisfiable configuration will be use.

Return value

Type: Promise<MediaKeySystemAccess>

A promise for a MediaKeySystemAccess object.

Standards information

Remarks

As of Microsoft Edge, this method is supported. For more information on EME implementation updates in Microsoft Edge, see Encrypted Media Extensions updates.

Dictionary of MediaKeySystemConfiguration members:

Dictionary MemberTypeDescription
audioCapabilitiessequence<MediaKeySystemMediaCapability>A list of supported audio type and capability pairs. See dictionary members below.
distinctiveIdentifierMediaKeysRequirementDefault is "optional". Whether a persistent Distinctive Identifier is required. See table below for enumeration description.
initDataTypessequence<DOMString>A list of supported Initialization Data Type names.
persistentStateMediaKeysRequirementDefault is "optional". Whether the ability to persist state is required.
videoCapabilitiessequence<MediaKeySystemMediaCapability>A list of supported video type and capability pairs. See dictionary members below.

 

MediaKeysRequirement Enumeration:

NameDescription
requiredThe returned object must support this feature.
optionalThe returned object may support and use this feature.
not-allowedThe returned object must function without using this feature and must not use it at any time.

 

Dictionary of MediaKeySystemMediaCapability members:

Dictionary MemberTypeDescription
contentTypeDOMStringDefaults to "". The content type must not be the empty string.
robustnessDOMStringDefaults to "". The robustness level associated with the content type. An empty string indicates that any ability to decrypt and decode the content type is acceptable.

 

See also

navigator

 

 

Show: