[html5] r7138 - [giow] (2) Allow UAs that have downloaded at least two frames of video to go int [...]

whatwg at whatwg.org whatwg at whatwg.org
Fri Jun 15 15:31:12 PDT 2012


Author: ianh
Date: 2012-06-15 15:31:11 -0700 (Fri, 15 Jun 2012)
New Revision: 7138

Modified:
   complete.html
   index
   source
Log:
[giow] (2) Allow UAs that have downloaded at least two frames of video to go into the canplaythrough mode if they aren't going to bother getting any more however long the app and user wait.
Affected topics: Video and Audio

Modified: complete.html
===================================================================
--- complete.html	2012-06-15 20:54:56 UTC (rev 7137)
+++ complete.html	2012-06-15 22:31:11 UTC (rev 7138)
@@ -30130,7 +30130,7 @@
 
   <dl><dt><dfn id=dom-media-have_nothing title=dom-media-HAVE_NOTHING><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
 
-   <dd>No information regarding the <a href=#media-resource>media resource</a> is
+   <dd><p>No information regarding the <a href=#media-resource>media resource</a> is
    available. No data for the <a href=#current-playback-position>current playback position</a>
    is available. <a href=#media-element title="media element">Media elements</a>
    whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code>
@@ -30140,7 +30140,7 @@
 
    <dt><dfn id=dom-media-have_metadata 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><a href=#the-video-element>video</a></code>
    element, the dimensions of the video are also available. The API
    will no longer throw an exception when seeking. No <a href=#media-data>media
@@ -30149,7 +30149,7 @@
 
    <dt><dfn id=dom-media-have_current_data title=dom-media-HAVE_CURRENT_DATA><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
 
-   <dd>Data for the immediate <a href=#current-playback-position>current playback position</a>
+   <dd><p>Data for the immediate <a href=#current-playback-position>current playback position</a>
    is available, but either not enough data is available that the user
    agent could successfully advance the <a href=#current-playback-position>current playback
    position</a> in the <a href=#direction-of-playback>direction of playback</a> at all
@@ -30163,7 +30163,7 @@
 
    <dt><dfn id=dom-media-have_future_data title=dom-media-HAVE_FUTURE_DATA><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
 
-   <dd>Data for the immediate <a href=#current-playback-position>current playback position</a>
+   <dd><p>Data for the immediate <a href=#current-playback-position>current playback position</a>
    is available, as well as enough data for the user agent to advance
    the <a href=#current-playback-position>current playback position</a> in the <a href=#direction-of-playback>direction
    of playback</a> at least a little without immediately reverting
@@ -30181,13 +30181,25 @@
 
    <dt><dfn id=dom-media-have_enough_data 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><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code> state
-   are met, and, in addition, the user agent estimates that data is
-   being fetched at a rate where the <a href=#current-playback-position>current playback
-   position</a>, if it were to advance at the <a href=#effective-playback-rate>effective
-   playback rate</a>, would not overtake the available data before
-   playback reaches the end of the <a href=#media-resource>media resource</a>.</dd>
+   <dd>
 
+   <p>All the conditions described for the <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></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 <a href=#current-playback-position>current playback position</a>, if it were to
+     advance at the <a href=#effective-playback-rate>effective playback rate</a>, would not
+     overtake the available data before playback reaches the end of
+     the <a href=#media-resource>media resource</a>.</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 title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> and <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> is
   negligible. Really the only time the difference is relevant is when
   painting a <code><a href=#the-video-element>video</a></code> element onto a <code><a href=#the-canvas-element>canvas</a></code>,

Modified: index
===================================================================
--- index	2012-06-15 20:54:56 UTC (rev 7137)
+++ index	2012-06-15 22:31:11 UTC (rev 7138)
@@ -30130,7 +30130,7 @@
 
   <dl><dt><dfn id=dom-media-have_nothing title=dom-media-HAVE_NOTHING><code>HAVE_NOTHING</code></dfn> (numeric value 0)</dt>
 
-   <dd>No information regarding the <a href=#media-resource>media resource</a> is
+   <dd><p>No information regarding the <a href=#media-resource>media resource</a> is
    available. No data for the <a href=#current-playback-position>current playback position</a>
    is available. <a href=#media-element title="media element">Media elements</a>
    whose <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code>
@@ -30140,7 +30140,7 @@
 
    <dt><dfn id=dom-media-have_metadata 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><a href=#the-video-element>video</a></code>
    element, the dimensions of the video are also available. The API
    will no longer throw an exception when seeking. No <a href=#media-data>media
@@ -30149,7 +30149,7 @@
 
    <dt><dfn id=dom-media-have_current_data title=dom-media-HAVE_CURRENT_DATA><code>HAVE_CURRENT_DATA</code></dfn> (numeric value 2)</dt>
 
-   <dd>Data for the immediate <a href=#current-playback-position>current playback position</a>
+   <dd><p>Data for the immediate <a href=#current-playback-position>current playback position</a>
    is available, but either not enough data is available that the user
    agent could successfully advance the <a href=#current-playback-position>current playback
    position</a> in the <a href=#direction-of-playback>direction of playback</a> at all
@@ -30163,7 +30163,7 @@
 
    <dt><dfn id=dom-media-have_future_data title=dom-media-HAVE_FUTURE_DATA><code>HAVE_FUTURE_DATA</code></dfn> (numeric value 3)</dt>
 
-   <dd>Data for the immediate <a href=#current-playback-position>current playback position</a>
+   <dd><p>Data for the immediate <a href=#current-playback-position>current playback position</a>
    is available, as well as enough data for the user agent to advance
    the <a href=#current-playback-position>current playback position</a> in the <a href=#direction-of-playback>direction
    of playback</a> at least a little without immediately reverting
@@ -30181,13 +30181,25 @@
 
    <dt><dfn id=dom-media-have_enough_data 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><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code> state
-   are met, and, in addition, the user agent estimates that data is
-   being fetched at a rate where the <a href=#current-playback-position>current playback
-   position</a>, if it were to advance at the <a href=#effective-playback-rate>effective
-   playback rate</a>, would not overtake the available data before
-   playback reaches the end of the <a href=#media-resource>media resource</a>.</dd>
+   <dd>
 
+   <p>All the conditions described for the <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></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 <a href=#current-playback-position>current playback position</a>, if it were to
+     advance at the <a href=#effective-playback-rate>effective playback rate</a>, would not
+     overtake the available data before playback reaches the end of
+     the <a href=#media-resource>media resource</a>.</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 title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> and <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code> is
   negligible. Really the only time the difference is relevant is when
   painting a <code><a href=#the-video-element>video</a></code> element onto a <code><a href=#the-canvas-element>canvas</a></code>,

Modified: source
===================================================================
--- source	2012-06-15 20:54:56 UTC (rev 7137)
+++ source	2012-06-15 22:31:11 UTC (rev 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




More information about the Commit-Watchers mailing list