Short URL: http://html5.org/r/7138
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 7138 | 2012-06-15 22:31 |
Index: source
===================================================================
--- source (revision 7137)
+++ source (revision 7138)
@@ -32752,27 +32752,27 @@
<dt><dfn title="dom-media-HAVE_NOTHING"><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
- <dd>No information regarding the <span>media resource</span> is
+ <dd><p>No information regarding the <span>media resource</span> is
available. No data for the <span>current playback position</span>
is available. <span title="media element">Media elements</span>
whose <code title="dom-media-networkState">networkState</code>
attribute are set to <code
title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</code> are always in
the <code title="dom-media-HAVE_NOTHING">HAVE_NOTHING</code>
- state.</dd>
+ state.</p></dd>
<dt><dfn title="dom-media-HAVE_METADATA"><code>HAVE_METADATA</code></dfn> (numeric value 1)</dt>
- <dd>Enough of the resource has been obtained that the duration of
+ <dd><p>Enough of the resource has been obtained that the duration of
the resource is available. In the case of a <code>video</code>
element, the dimensions of the video are also available. The API
will no longer throw an exception when seeking. No <span>media
data</span> is available for the immediate <span>current playback
- position</span>.</dd>
+ position</span>.</p></dd>
<dt><dfn title="dom-media-HAVE_CURRENT_DATA"><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
- <dd>Data for the immediate <span>current playback position</span>
+ <dd><p>Data for the immediate <span>current playback position</span>
is available, but either not enough data is available that the user
agent could successfully advance the <span>current playback
position</span> in the <span>direction of playback</span> at all
@@ -32783,11 +32783,11 @@
agent having data from the current frame, but not the next frame,
when the <span>current playback position</span> is at the end of
the current frame; and to when <span title="ended
- playback">playback has ended</span>.</dd>
+ playback">playback has ended</span>.</p></dd>
<dt><dfn title="dom-media-HAVE_FUTURE_DATA"><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
- <dd>Data for the immediate <span>current playback position</span>
+ <dd><p>Data for the immediate <span>current playback position</span>
is available, as well as enough data for the user agent to advance
the <span>current playback position</span> in the <span>direction
of playback</span> at least a little without immediately reverting
@@ -32801,18 +32801,34 @@
<span>current playback position</span> is in the middle of a frame.
The user agent cannot be in this state if <span title="ended
playback">playback has ended</span>, as the <span>current playback
- position</span> can never advance in this case.</dd>
+ position</span> can never advance in this case.</p></dd>
<dt><dfn title="dom-media-HAVE_ENOUGH_DATA"><code>HAVE_ENOUGH_DATA</code></dfn> (numeric value 4)</dt>
- <dd>All the conditions described for the <code
- title="dom-media-HAVE_FUTURE_DATA">HAVE_FUTURE_DATA</code> state
- are met, and, in addition, the user agent estimates that data is
- being fetched at a rate where the <span>current playback
- position</span>, if it were to advance at the <span>effective
- playback rate</span>, would not overtake the available data before
- playback reaches the end of the <span>media resource</span>.</dd>
+ <dd>
+ <p>All the conditions described for the <code
+ title="dom-media-HAVE_FUTURE_DATA">HAVE_FUTURE_DATA</code> state
+ are met, and, in addition, either of the following conditions is
+ also true:</p>
+
+ <ul>
+
+ <li>The user agent estimates that data is being fetched at a rate
+ where the <span>current playback position</span>, if it were to
+ advance at the <span>effective playback rate</span>, would not
+ overtake the available data before playback reaches the end of
+ the <span>media resource</span>.</li>
+
+ <li>The user agent has entered a state where waiting longer will
+ not result in further data being obtained, and therefore nothing
+ would be gained by delaying playback any further. (For example,
+ the buffer might be full.)</li>
+
+ </ul>
+
+ </dd>
+
</dl>
<p class="note">In practice, the difference between <code