Short URL: http://html5.org/r/2855
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 2855 | 2009-02-23 11:14 |
Index: source
===================================================================
--- source (revision 2854)
+++ source (revision 2855)
@@ -18963,6 +18963,7 @@
<dd><span>Global attributes</span></dd>
<dd><code title="attr-media-src">src</code></dd>
<dd><code title="attr-video-poster">poster</code></dd>
+ <dd><code title="attr-media-autobuffer">autobuffer</code></dd>
<dd><code title="attr-media-autoplay">autoplay</code></dd>
<dd><code title="attr-media-loop">loop</code></dd>
<dd><code title="attr-media-controls">controls</code></dd>
@@ -19001,6 +19002,7 @@
with associated audio data.</p>
<p>The <code title="attr-media-src">src</code>, <code
+ title="attr-media-autobuffer">autobuffer</code>, <code
title="attr-media-autoplay">autoplay</code>, <code
title="attr-media-loop">loop</code>, and <code
title="attr-media-controls">controls</code> attributes are <span
@@ -19231,6 +19233,7 @@
<dt>Content attributes:</dt>
<dd><span>Global attributes</span></dd>
<dd><code title="attr-media-src">src</code></dd>
+ <dd><code title="attr-media-autobuffer">autobuffer</code></dd>
<dd><code title="attr-media-autoplay">autoplay</code></dd>
<dd><code title="attr-media-loop">loop</code></dd>
<dd><code title="attr-media-controls">controls</code></dd>
@@ -19265,6 +19268,7 @@
whose <span>media data</span> is ostensibly audio data.</p>
<p>The <code title="attr-media-src">src</code>, <code
+ title="attr-media-autobuffer">autobuffer</code>, <code
title="attr-media-autoplay">autoplay</code>, <code
title="attr-media-loop">loop</code>, and <code
title="attr-media-controls">controls</code> attributes are <span
@@ -19483,6 +19487,7 @@
const unsigned short <span title="dom-media-NETWORK_LOADED">NETWORK_LOADED</span> = 3;
const unsigned short <span title="dom-media-NETWORK_NO_SOURCE">NETWORK_NO_SOURCE</span> = 4;
readonly attribute unsigned short <span title="dom-media-networkState">networkState</span>;
+ attribute boolean <span title="dom-media-autobuffer">autobuffer</span>;
readonly attribute float <span title="dom-media-bufferingRate">bufferingRate</span>;
readonly attribute boolean <span title="dom-media-bufferingThrottled">bufferingThrottled</span>;
readonly attribute <span>TimeRanges</span> <span title="dom-media-buffered">buffered</span>;
@@ -19529,6 +19534,7 @@
<p>The <dfn>media element attributes</dfn>, <code
title="attr-media-src">src</code>, <code
+ title="attr-media-autobuffer">autobuffer</code>, <code
title="attr-media-autoplay">autoplay</code>, <code
title="attr-media-loop">loop</code>, and <code
title="attr-media-controls">controls</code>, apply to all <span
@@ -20204,6 +20210,15 @@
title="dom-media-networkState">networkState</code> to <code
title="dom-media-NETWORK_LOADING">NETWORK_LOADING</code>.</p>
+ <p>The <code title="attr-media-autobuffer">autobuffer</code>
+ attribute provides a hint that the author expects that downloading
+ the entire resource optimistically will be worth it, even in the
+ absence of the <code title="attr-media-autoplay">autoplay</code>
+ attribute. In the absence of either attribute, the user agent is
+ likely to find that waiting until the user starts playback before
+ downloading any further content leads to a more efficient use of
+ the network resources.</p>
+
<p>The user agent may use whatever means necessary to fetch the
resource (within the constraints put forward by this and other
specifications); for example, reconnecting to the server in the
@@ -20310,6 +20325,17 @@
flag</span> to false. This stops <span title="delay the load
event">delaying the load event</span>.</p></li>
+ <li><p class="note">This is the point at which a user agent
+ that is attempting to reduce network usage while still fetching
+ the metadata for each <span>media resource</span> would stop
+ buffering, causing the <code
+ title="dom-media-networkState">networkState</code> attribute to
+ switch to the <code
+ title="dom-media-NETWORK_IDLE">NETWORK_IDLE</code> value, if
+ the <span>media element</span> did not have an <code
+ title="attr-media-autobuffer">autobuffer</code> or <code
+ title="attr-media-autoplay">autoplay</code> attribute.</p></li>
+
</ol>
<p class="note">The user agent is <em>required</em> to
@@ -20514,6 +20540,24 @@
title="concept-media-load-algorithm">load algorithm</span>.</p>
<p>The <dfn
+ title="attr-media-autobuffer"><code>autobuffer</code></dfn>
+ attribute is a <span>boolean attribute</span>. Its presence hints to
+ the user agent that the author believes that the <span>media
+ element</span> will likely be used, even though the element does not
+ have an <code title="attr-media-autoplay">autoplay</code>
+ attribute. (The attribute has no effect if used in conjunction with
+ the <code title="attr-media-autoplay">autoplay</code> attribute,
+ though including both is not an error.) This attribute may be
+ ignored altogether. The attribute must be ignored if the <code
+ title="attr-media-autoplay">autoplay</code> attribute is
+ present.</p>
+
+ <p>The <dfn
+ title="dom-media-autobuffer"><code>autobuffer</code></dfn> DOM
+ attribute must <span>reflect</span> the content attribute of the
+ same name.</p>
+
+ <p>The <dfn
title="dom-media-bufferingRate"><code>bufferingRate</code></dfn>
attribute must return the average number of bits received per second
for the current download over the past few seconds. If there is no