<section>

<h3><dfn>Navigator</dfn> Extension: <code>requestMediaKeySystemAccess()</code></h3>

partial interface Navigator {

[SecureContext] Promise&lt;MediaKeySystemAccess&gt; requestMediaKeySystemAccess (DOMString keySystem, sequence&lt;MediaKeySystemConfiguration&gt; supportedConfigurations);

};</pre><section><h2>Methods</h2><dl class="methods" data-dfn-for="Navigator" data-link-for="Navigator"><dt><dfn><code>requestMediaKeySystemAccess</code></dfn></dt><dd>

</td></tr><tr><td class="prmName">supportedConfigurations</td><td class="prmType"><code>sequence&lt;MediaKeySystemConfiguration&gt;</code></td><td class="prmNullFalse"><span role="img" aria-label="False">✘</span></td><td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td><td class="prmDesc">

A sequence of <a>MediaKeySystemConfiguration</a> configurations to try in order.

The first element with a satisfiable configuration will be used.

<section>

<h4>Algorithms</h4>

<section>

<h3><a>MediaKeySystemConfiguration</a> dictionary</h3>

"required",

"optional",

"not-allowed"

<dt>When returned by a <a>MediaKeySystemAccess</a> object</dt>

<dd>CDM instances created by the object MUST NOT use this feature.</dd>

</dl>

DOMString label = "";

sequence&lt;DOMString&gt; initDataTypes = [];

sequence&lt;MediaKeySystemMediaCapability&gt; audioCapabilities = [];

<section>

<h3><dfn>MediaKeySystemMediaCapability</dfn> dictionary</h3>

<pre class="idl">dictionary MediaKeySystemMediaCapability {

DOMString contentType = "";

DOMString? encryptionScheme = null;

</div>

</dd>

</dl>

<p>In order for the capability represented by this object to be considered supported, <a def-id="capability-contentType"></a> MUST NOT be the empty string and its entire value, including all codecs, MUST be supported with <a def-id="capability-robustness"></a>.</p>

<p class="note">If any of a set of codecs is acceptable, use a separate instances of this dictionary for each codec.</p>

<h2><dfn>MediaKeySystemAccess</dfn> Interface</h2>

<p>The MediaKeySystemAccess object provides access to a <a def-id="keysystem"></a>.</p>

readonly attribute DOMString keySystem;

MediaKeySystemConfiguration getConfiguration ();

Promise&lt;MediaKeys&gt; createMediaKeys ();

</li>

<li><p>Return <var>promise</var>.</p></li>

</ol>

</section>

<p>For methods that return a promise, all errors are reported asynchronously by rejecting the returned Promise. This includes [[WEBIDL]] type mapping errors.</p>

<p>The steps of an algorithm are always aborted when rejecting a promise.</p>

"temporary",

"persistent-license"

};</pre>

See <a def-id="session-storage"></a>.

</p>

</td></tr>

<h2>Methods</h2>

<dl class="methods" data-dfn-for="MediaKeys" data-link-for="MediaKeys">

<dt><dfn><code>createSession</code></dfn></dt><dd>

</dd>

</dl>

</section>

<h3>Algorithms</h3>

<section id="is-persistent-session-type">

<h4>Is persistent session type?</h4>

<p>For methods that return a promise, all errors are reported asynchronously by rejecting the returned Promise. This includes [[WEBIDL]] type mapping errors.</p>

<p>The following steps of an algorithm are always aborted when rejecting a promise.</p>

"internal-error",

"closed-by-application",

"release-acknowledged",

If the closed session is still needed for some reason, the application developer should consider some strategy to reduce the number of sessions needed or proactively close unneeded sessions.

</p>

</div>

readonly attribute DOMString sessionId;

readonly attribute unrestricted double expiration;

readonly attribute Promise&lt;MediaKeySessionClosedReason&gt; closed;

</li>

<li><p>Return <var>promise</var>.</p></li>

</ol>

<section>

<h2><dfn>MediaKeyStatusMap</dfn> Interface</h2>

<p>The MediaKeyStatusMap object is a read-only map of <a def-id="key-id">key IDs</a> to the current status of the associated key.</p>

<p>A key's status is independent of whether the key is currently being used and of media data.</p>

<p class="note">For example, if a key has output requirements that cannot currently be met, the key's status should be <a def-id="status-output-downscaled"></a> or <a def-id="status-output-restricted"></a>, as appropriate, regardless of whether that key has been or is currently needed to decrypt media data.</p>

iterable&lt;BufferSource,MediaKeyStatus&gt;;

readonly attribute unsigned long size;

boolean has (BufferSource keyId);

order than the first <var>m</var> octets of <var>B</var> or those octets are equal and <var>m</var> &lt; <var>n</var>.

</p>

</section>

"usable",

"expired",

"released",

</td></tr><tr><td><dfn><code id="idl-def-MediaKeyStatus.internal-error">internal-error</code></dfn></td><td>

The key is not currently <a def-id="usable-for-decryption"></a> because of an error in the CDM unrelated to the other values.

This value is not actionable by the application.

</section>

<section>

<h3><a>MediaKeyMessageEvent</a></h3>

<p>The MediaKeyMessageEvent object is used for the <a def-id="message"></a> event.</p>

<p>Events are constructed as defined in <a def-id="constructing-events"></a> [[DOM]].</p>

"license-request",

"license-renewal",

"license-release",

<table class="simple" data-dfn-for="MediaKeyMessageType" data-link-for="MediaKeyMessageType"><tbody><tr><th colspan="2">Enumeration description</th></tr><tr><td><dfn><code id="idl-def-MediaKeyMessageType.license-request">license-request</code></dfn></td><td>The message contains a request for a new license.</td></tr><tr><td><dfn><code id="idl-def-MediaKeyMessageType.license-renewal">license-renewal</code></dfn></td><td>The message contains a request to renew an existing license.</td></tr><tr><td><dfn><code id="idl-def-MediaKeyMessageType.license-release">license-release</code></dfn></td><td>The message contains a <a def-id="record-of-license-destruction"></a>.</td></tr><tr><td><dfn><code id="idl-def-MediaKeyMessageType.individualization-request">individualization-request</code></dfn></td><td>

The message contains a request for <a href="#app-assisted-individualization">App-Assisted Individualization</a> (or re-individualization).<br>

As with all other messages, any identifiers in the message MUST be <a href="#per-origin-per-profile-identifiers">distinctive per origin and profile</a> and MUST NOT be <a def-id="distinctive-permanent-identifier-maybe-plural"></a>.

interface MediaKeyMessageEvent : Event {

constructor(DOMString type, MediaKeyMessageEventInit eventInitDict);

readonly attribute MediaKeyMessageType messageType;

</p>

</dd><dt><dfn><code>message</code></dfn> of type <span class="idlAttrType">{{ArrayBuffer}}</span>, readonly </dt><dd>

The message from the CDM. Messages are Key System-specific.

<section>

<h4><dfn>MediaKeyMessageEventInit</dfn></h4>

required MediaKeyMessageType messageType;

required ArrayBuffer message;

};</pre><section><h2>Dictionary <a class="idlType">MediaKeyMessageEventInit</a> Members</h2><dl class="dictionary-members" data-dfn-for="MediaKeyMessageEventInit" data-link-for="MediaKeyMessageEventInit"><dt><dfn><code>messageType</code></dfn> of type <span class="idlMemberType"><a>MediaKeyMessageType</a></span></dt><dd>

The type of the message.

</dd><dt><dfn><code>message</code></dfn> of type <span class="idlMemberType">{{ArrayBuffer}}</span></dt><dd>

The message.

</section>

</section>

<p>For methods that return a promise, all errors are reported asynchronously by rejecting the returned Promise. This includes [[WEBIDL]] type mapping errors.</p>

<p>The steps of an algorithm are always aborted when rejecting a promise.</p>

[SecureContext] readonly attribute MediaKeys? mediaKeys;

attribute EventHandler onencrypted;

attribute EventHandler onwaitingforkey;

</ol>

<table class="parameters"><tbody><tr><th>Parameter</th><th>Type</th><th>Nullable</th><th>Optional</th><th>Description</th></tr><tr><td class="prmName">mediaKeys</td><td class="prmType"><code>MediaKeys</code></td><td class="prmNullTrue"><span role="img" aria-label="True">✔</span></td><td class="prmOptFalse"><span role="img" aria-label="False">✘</span></td><td class="prmDesc">

A <!-- Restore when https://github.com/w3c/respec/issues/893 is fixed. <a> -->MediaKeys<!-- </a> --> object.

<section>

<h3><a>MediaEncryptedEvent</a></h3>

<p>The MediaEncryptedEvent object is used for the <a def-id="encrypted"></a> event.</p>

<p>Events are constructed as defined in <a def-id="constructing-events"></a> [[DOM]].</p>

interface MediaEncryptedEvent : Event {

constructor(DOMString type, optional MediaEncryptedEventInit eventInitDict = {});

readonly attribute DOMString initDataType;

Indicates the <a def-id="initialization-data-type"></a> of the <a def-id="initialization-data"></a> contained in the <a def-id="encrypted-event-initdata-attribute"></a> attribute.

</dd><dt><dfn><code>initData</code></dfn> of type <span class="idlAttrType">{{ArrayBuffer}}</span>, readonly , nullable</dt><dd>

The <a def-id="initialization-data"></a> for the event.

<section>

<h4><dfn>MediaEncryptedEventInit</dfn></h4>

DOMString initDataType = "";

ArrayBuffer? initData = null;

};</pre><section><h2>Dictionary <a class="idlType">MediaEncryptedEventInit</a> Members</h2><dl class="dictionary-members" data-dfn-for="MediaEncryptedEventInit" data-link-for="MediaEncryptedEventInit"><dt><dfn><code>initDataType</code></dfn> of type <span class="idlMemberType">{{DOMString}}</span>, defaulting to <code>""</code></dt><dd>

The <a def-id="initialization-data-type"></a>.

</dd><dt><dfn><code>initData</code></dfn> of type <span class="idlMemberType">{{ArrayBuffer}}</span>, nullable, defaulting to <code>null</code></dt><dd>

The <a def-id="initialization-data"></a>.

</section>

</section>