[EME] Fix Web IDL syntax and clarify "usable key".
authorDavid Dorwin <ddorwin@google.com>
Fri, 07 Mar 2014 17:51:08 -0800
changeset 256 6002558bc417
parent 255 9e9a5189294e
child 257 1430b5598fb0
[EME] Fix Web IDL syntax and clarify "usable key".
encrypted-media/encrypted-media.html
encrypted-media/encrypted-media.xml
--- a/encrypted-media/encrypted-media.html	Fri Mar 07 17:41:14 2014 -0800
+++ b/encrypted-media/encrypted-media.html	Fri Mar 07 17:51:08 2014 -0800
@@ -313,7 +313,7 @@
   <a href="#dom-mediakeysession">MediaKeySession</a> <a href="#dom-createsession">createSession</a>(DOMString contentType, Uint8Array initData);
   <a href="#dom-mediakeysession">MediaKeySession</a> <a href="#dom-loadsession">loadSession</a>(DOMString sessionId);
 
-  static bool <a href="#dom-istypesupported">isTypeSupported</a>(DOMstring <a href="#key-system">keySystem</a>, DOMString? contentType);
+  static bool <a href="#dom-istypesupported">isTypeSupported</a>(DOMstring <a href="#key-system">keySystem</a>, optional DOMString contentType);
 };
 
 interface <dfn id="dom-mediakeysession">MediaKeySession</dfn> : <a href="http://www.w3.org/TR/dom/#eventtarget">EventTarget</a> {
@@ -978,9 +978,10 @@
 <p>If <var title="true">cdm</var> has at least one <code><a href="#dom-mediakeysession">MediaKeySession</a></code> in the <code><a href="#dom-statepending">PENDING</a></code> or <code><a href="#dom-stateready">READY</a></code> state, run the following steps:</p>
               <p class="non-normative">This check ensures the <var title="true">cdm</var> has finished loading and is a prequisite for a matching key being available.</p>
             <ol>
-              <li><p>Let <var title="true">block key ID</var> be be the key ID for the current block.</p></li>
+              <li><p>Let <var title="true">block key ID</var> be the key ID of the current block <span class="non-normative">(as specified by the container)</span>.</p></li>
               <li>
 <p>Use <var title="true">cdm</var> to decrypt the block by following the steps for the first matching condition from the following list:</p>
+                <p class="non-normative">In the following steps, a key is considered usable if it is valid as determined by the CDM. For example, a key is not usable if its license has expired.</p>
                 <dl class="switch">
                 <dt>If any session has a usable key for <var title="">block key ID</var>
 </dt>
--- a/encrypted-media/encrypted-media.xml	Fri Mar 07 17:41:14 2014 -0800
+++ b/encrypted-media/encrypted-media.xml	Fri Mar 07 17:51:08 2014 -0800
@@ -310,7 +310,7 @@
   <precoderef>MediaKeySession</precoderef> <premethodref>createSession</premethodref>(DOMString contentType, Uint8Array initData);
   <precoderef>MediaKeySession</precoderef> <premethodref>loadSession</premethodref>(DOMString sessionId);
 
-  static bool <premethodref>isTypeSupported</premethodref>(DOMstring <a href="#key-system">keySystem</a>, DOMString? contentType);
+  static bool <premethodref>isTypeSupported</premethodref>(DOMstring <a href="#key-system">keySystem</a>, optional DOMString contentType);
 };
 
 interface <precodedfn>MediaKeySession</precodedfn> : <dom4ref name="eventtarget">EventTarget</dom4ref> {
@@ -938,8 +938,9 @@
             <li><p>If <var title="true">cdm</var> has at least one <coderef>MediaKeySession</coderef> in the <coderef prefix="state">PENDING</coderef> or <coderef prefix="state">READY</coderef> state, run the following steps:</p>
               <p class="non-normative">This check ensures the <var title="true">cdm</var> has finished loading and is a prequisite for a matching key being available.</p>
             <ol>
-              <li><p>Let <var title="true">block key ID</var> be be the key ID for the current block.</p></li>
+              <li><p>Let <var title="true">block key ID</var> be the key ID of the current block <span class="non-normative">(as specified by the container)</span>.</p></li>
               <li><p>Use <var title="true">cdm</var> to decrypt the block by following the steps for the first matching condition from the following list:</p>
+                <p class="non-normative">In the following steps, a key is considered usable if it is valid as determined by the CDM. For example, a key is not usable if its license has expired.</p>
                 <dl class="switch">
                 <dt>If any session has a usable key for <var title="">block key ID</var></dt>
                 <dd>Run the following steps: