HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/2855

File a bug

SVNBugCommentTime (UTC)
2855[Gecko] [Webkit] Add the autobuffer='' attribute as a hint to browsers.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

|