W3C home > Mailing lists > Public > public-html-commits@w3.org > December 2011

html5/spec Overview.html,1.5457,1.5458

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 09 Dec 2011 21:46:56 +0000
To: public-html-commits@w3.org
Message-Id: <E1RZ8HR-0001Fk-4D@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv4802

Modified Files:
	Overview.html 
Log Message:
Define the meaning of preload='' values while the video is playing. (whatwg r6858)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5457
retrieving revision 1.5458
diff -u -d -r1.5457 -r1.5458
--- Overview.html	9 Dec 2011 20:13:15 -0000	1.5457
+++ Overview.html	9 Dec 2011 21:46:52 -0000	1.5458
@@ -23915,18 +23915,23 @@
    algorithm</a>.</li>
 
   </ol></div><hr><p>The <dfn id="attr-media-preload" title="attr-media-preload"><code>preload</code></dfn>
-  attribute is an <a href="#enumerated-attribute">enumerated attribute</a>. The following table
-  lists the keywords and states for the attribute &mdash; the keywords
-  in the left column map to the states in the cell in the second
-  column on the same row as the keyword.<table><thead><tr><th> Keyword
+  attribute is an <a href="#enumerated-attribute">enumerated attribute</a>. The following
+  table lists the keywords and states for the attribute &mdash; the
+  keywords in the left column map to the states in the cell in the
+  second column on the same row as the keyword. The attribute can be
+  changed even once the <a href="#media-resource">media resource</a> is being buffered
+  or played; the descriptions in the table below are to be interpreted
+  with that in mind.<table><thead><tr><th> Keyword
      <th> State
      <th> Brief description
    <tbody><tr><td><dfn id="attr-media-preload-none" title="attr-media-preload-none"><code>none</code></dfn>
      <td><dfn id="attr-media-preload-none-state" title="attr-media-preload-none-state">None</dfn>
      <td>Hints to the user agent that either the author does not expect the user to need the media resource, or that the server wants to minimise unnecessary traffic.
+         This state does not provide a hint regarding how aggressively to actually download the media resource if buffering starts anyway (e.g. once the user hits "play").
     <tr><td><dfn id="attr-media-preload-metadata" title="attr-media-preload-metadata"><code>metadata</code></dfn>
      <td><dfn id="attr-media-preload-metadata-state" title="attr-media-preload-metadata-state">Metadata</dfn>
      <td>Hints to the user agent that the author does not expect the user to need the media resource, but that fetching the resource metadata (dimensions, first frame, track list, duration, etc) is reasonable. If the user agent precisely fetches no more than the metadata, then the <a href="#media-element">media element</a> will end up with its <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute set to <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code>; typically though, some frames will be obtained as well and it will probably be <code title="dom-media-HAVE_CURRENT_DATA"><a href="#dom-media-have_current_data">HAVE_CURRENT_DATA</a></code> or <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code>.
+         When the media resource is playing, hints to the user agent that bandwidth is to be considered scarce, e.g. suggesting throttling the download so that the media data is obtained at the slowest possible rate that still maintains consistent playback.
     <tr><td><dfn id="attr-media-preload-auto" title="attr-media-preload-auto"><code>auto</code></dfn>
      <td><dfn id="attr-media-preload-auto-state" title="attr-media-preload-auto-state">Automatic</dfn>
      <td>Hints to the user agent that the user agent can put the user's needs first without risk to the server, up to and including optimistically downloading the entire resource.
@@ -23934,7 +23939,11 @@
   attribute's <i>missing value default</i> is user-agent defined,
   though the <a href="#attr-media-preload-metadata-state" title="attr-media-preload-metadata-state">Metadata</a> state is
   suggested as a compromise between reducing server load and providing
-  an optimal user experience.<div class="impl">
+  an optimal user experience.<p class="note">Authors might switch the attribute from "<code title="attr-media-preload-none"><a href="#attr-media-preload-none">none</a></code>" or "<code title="attr-media-preload-metadata"><a href="#attr-media-preload-metadata">metadata</a></code>" to "<code title="attr-media-preload-auto"><a href="#attr-media-preload-auto">auto</a></code>" dynamically once the
+  user begins playback. For example, on a page with many videos this
+  might be used to indicate that the many videos are not to be
+  downloaded unless requested, but they once one <em>is</em> requested
+  it is to be downloaded aggressively.<div class="impl">
 
   <p>The <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code> attribute is
   intended to provide a hint to the user agent about what the author
Received on Friday, 9 December 2011 21:47:00 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 9 December 2011 21:47:02 GMT