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

html5/spec Overview.html,1.1661,1.1662

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 01 Dec 2008 09:53:27 +0000
To: public-html-commits@w3.org
Message-Id: <E1L75T5-00059r-HJ@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv19813

Modified Files:
	Overview.html 
Log Message:
Clarify the requirement that UAs must make the 'duration' attribute accurate before playing any media.. (whatwg r2491)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1661
retrieving revision 1.1662
diff -u -d -r1.1661 -r1.1662
--- Overview.html	1 Dec 2008 07:54:42 -0000	1.1661
+++ Overview.html	1 Dec 2008 09:53:24 -0000	1.1662
@@ -14332,7 +14332,12 @@
 
          </li>
 
-        </ol></dd>
+        </ol><p class=note>The user agent is <em>required</em> to
+        determine the duration of the <a href=#media-resource>media resource</a> and
+        go through this step before playing.</p> <!-- actually defined
+        in the 'duration' section -->
+
+       </dd>
 
 
        <dt>If the connection is interrupted, causing the user agent to
@@ -14515,16 +14520,21 @@
   same attribute at later times.<h5 id=offsets-into-the-media-resource><span class=secno>4.8.10.6 </span>Offsets into the media resource</h5><p>The <dfn id=dom-media-duration title=dom-media-duration><code>duration</code></dfn>
   attribute must return the length of the <a href=#media-resource>media resource</a>,
   in seconds. If no <a href=#media-data>media data</a> is available, then the
-  attributes must return 0. If <a href=#media-data>media data</a> is available
-  but the length is not known, the attribute must return the
-  Not-a-Number (NaN) value. If the <a href=#media-resource>media resource</a> is
-  known to be unbounded (e.g. a streaming radio), then the attribute
-  must return the positive Infinity value.<p id=durationChange>When the length of the <a href=#media-resource>media
-  resource</a> changes (e.g. from being unknown to known, or from
-  indeterminate to known, or from a previously established length to a
-  new length) the user agent must <a href=#queue-a-task>queue a task</a> to
-  <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-durationchange><a href=#event-durationchange>durationchange</a></code> at the
-  <a href=#media-element>media element</a>.<p><a href=#media-element title="media element">Media elements</a> have a
+  attributes must return the Not-a-Number (NaN) value. If the
+  <a href=#media-resource>media resource</a> is known to be unbounded (e.g. a
+  streaming radio), then the attribute must return the positive
+  Infinity value.<p>The user agent must determine the duration of the <a href=#media-resource>media
+  resource</a> before playing any part of the <a href=#media-data>media
+  data</a> and before setting <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> to a value equal to
+  or greater than <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code>, even if doing
+  so requires seeking to multiple parts of the resource.<p id=durationChange>When the length of the <a href=#media-resource>media
+  resource</a> changes (e.g. from being unknown to known, or from a
+  previously established length to a new length) the user agent must
+  <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called
+  <code title=event-durationchange><a href=#event-durationchange>durationchange</a></code> at the
+  <a href=#media-element>media element</a>.<p class=example>If an "infinite" stream ends for some reason,
+  then the duration would change from positive Infinity to the time of
+  the last frame or sample in the stream.<p><a href=#media-element title="media element">Media elements</a> have a
   <dfn id=current-playback-position>current playback position</dfn>, which must initially be
   zero. The current position is a time.<p>The <dfn id=dom-media-currenttime title=dom-media-currentTime><code>currentTime</code></dfn>
   attribute must, on getting, return the <a href=#current-playback-position>current playback
@@ -44139,32 +44149,32 @@
   L. Carlson, Laura Wisewell, Laurens Holst, Lee Kowalkowski, Leif
   Halvard Silli, Lenny Domnitser, L&eacute;onard Bouchet, Leons
   Petrazickis, Logan<!-- on moz irc -->, Loune, Maciej Stachowiak,
-  Magnus Kristiansen<!-- Dashiva -->, Malcolm Rowe, Mark Nottingham,
-  Mark Rowe<!--bdash-->, Mark Schenk, Martijn Wargers, Martin Atkins,
-  Martin D&uuml;rst, Martin Honnen, Masataka Yakura, Mathieu Henri,
-  Matthew Gregan, Matthew Mastracci, Matthew Raymond, Matthew Thomas,
-  Mattias Waldau, Max Romantschuk, Michael 'Ratt' Iannarelli, Michael
-  A. Nachbaur, Michael A. Puls II<!--Shadow2531-->, Michael Carter,
-  Michael Gratton, Michael Nordman, Michael Powers, Michael(tm) Smith,
-  Michel Fortin, Michiel van der Blonk, Mihai &#350;ucan<!-- from
-  ROBO Design -->, Mike Brown, Mike Dierken<!-- S. Mike Dierken -->,
-  Mike Dixon, Mike Schinkel, Mike Shaver, Mikko Rantalainen, Neil
-  Deakin, Neil Soiffer, Olaf Hoffmann, Olav Junker Kj&aelig;r, Oliver
-  Hunt, Peter Karlsson, Peter Kasting, Philip J&auml;genstedt, Philip
-  Taylor, Philip TAYLOR<!-- a different one -->, Rachid Finge, Rajas
-  Moonka, Ralf Stoltze, Ralph Giles, Raphael Champeimont, Rene
-  Saarsoo, Richard Ishida, Rimantas Liubertas, Robert Blaut, Robert
-  O'Callahan, Robert Sayre, Roman Ivanov, Ryan King, S. Mike Dierken,
-  Sam Kuper, Sam Ruby, Sam Weinig, Scott Hess, Sean Knapp, Shaun
-  Inman, Silvia Pfeiffer, Simon Pieters, Stefan Haustein, Steffen
-  Meschkat, Stephen Ma, Steve Faulkner, Steve Runyon, Steven Garrity,
-  Stewart Brodie, Stuart Parmenter, Sunava Dutta, Tantek &Ccedil;elik,
-  Terrence Wood, Thomas Broyer, Thomas O'Connor, Tim Altman, Tim
-  Johansson, Travis Leithead, Tyler Close, Vladimir
-  Vuki&#263;evi&#263;, Wakaba, Wayne Pollock, Wellington Fernando
-  de Macedo, William Swanson, Wolfram Kriesing, Yi-An Huang, and
-  &Oslash;istein E. Andersen, for their useful and substantial
-  comments.<p>Thanks also to everyone who has ever posted about HTML5 to their
+  Magnus Kristiansen<!-- Dashiva -->, Maik Merten, Malcolm Rowe, Mark
+  Nottingham, Mark Rowe<!--bdash-->, Mark Schenk, Martijn Wargers,
+  Martin Atkins, Martin D&uuml;rst, Martin Honnen, Masataka Yakura,
+  Mathieu Henri, Matthew Gregan, Matthew Mastracci, Matthew Raymond,
+  Matthew Thomas, Mattias Waldau, Max Romantschuk, Michael 'Ratt'
+  Iannarelli, Michael A. Nachbaur, Michael A. Puls
+  II<!--Shadow2531-->, Michael Carter, Michael Gratton, Michael
+  Nordman, Michael Powers, Michael(tm) Smith, Michel Fortin, Michiel
+  van der Blonk, Mihai &#350;ucan<!-- from ROBO Design -->, Mike
+  Brown, Mike Dierken<!-- S. Mike Dierken -->, Mike Dixon, Mike
+  Schinkel, Mike Shaver, Mikko Rantalainen, Neil Deakin, Neil Soiffer,
+  Olaf Hoffmann, Olav Junker Kj&aelig;r, Oliver Hunt, Peter Karlsson,
+  Peter Kasting, Philip J&auml;genstedt, Philip Taylor, Philip
+  TAYLOR<!-- a different one -->, Rachid Finge, Rajas Moonka, Ralf
+  Stoltze, Ralph Giles, Raphael Champeimont, Rene Saarsoo, Richard
+  Ishida, Rimantas Liubertas, Robert Blaut, Robert O'Callahan, Robert
+  Sayre, Roman Ivanov, Ryan King, S. Mike Dierken, Sam Kuper, Sam
+  Ruby, Sam Weinig, Scott Hess, Sean Knapp, Shaun Inman, Silvia
+  Pfeiffer, Simon Pieters, Stefan Haustein, Steffen Meschkat, Stephen
+  Ma, Steve Faulkner, Steve Runyon, Steven Garrity, Stewart Brodie,
+  Stuart Parmenter, Sunava Dutta, Tantek &Ccedil;elik, Terrence Wood,
+  Thomas Broyer, Thomas O'Connor, Tim Altman, Tim Johansson, Travis
+  Leithead, Tyler Close, Vladimir Vuki&#263;evi&#263;, Wakaba,
+  Wayne Pollock, Wellington Fernando de Macedo, William Swanson,
+  Wolfram Kriesing, Yi-An Huang, and &Oslash;istein E. Andersen, for
+  their useful and substantial comments.<p>Thanks also to everyone who has ever posted about HTML5 to their
   blogs, public mailing lists, or forums, including the <a href=http://lists.w3.org/Archives/Public/public-html/>W3C
   public-html list</a> and the <a href=http://www.whatwg.org/mailing-list>various WHATWG lists</a>.
 
Received on Monday, 1 December 2008 09:53:36 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 1 December 2008 09:53:36 GMT