[html5] r2331 - [gow] (2) Allow UAs to not autoplay.

[whatwg at whatwg.org]

Author: ianh
Date: 2008-10-14 17:45:23 -0700 (Tue, 14 Oct 2008)
New Revision: 2331

Modified:
   index
   source
Log:
[gow] (2) Allow UAs to not autoplay.

Modified: index
===================================================================
--- index	2008-10-15 00:26:52 UTC (rev 2330)
+++ index	2008-10-15 00:45:23 UTC (rev 2331)
@@ -17517,15 +17517,25 @@
 
    <dt>If the new ready state is <code title=dom-media-HAVE_ENOUGH_DATA><a href=#dom-media-have_enough_data>HAVE_ENOUGH_DATA</a></code></dt>
 
-   <dd><p>The user agent must <a href=#fire-a-simple-event>fire a simple event</a> called
-   <code title=event-canplaythrough><a href=#event-canplaythrough>canplaythrough</a></code> event.
-   <!-- XXX make sure it fires after canplay when fixing queueing here -->
-   If the
-   <a href=#autoplaying-flag>autoplaying flag</a> is true, and the <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> attribute is true, and the
-   <a href=#media-element>media element</a> has an <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute specified,
-   then the user agent must also set the <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> attribute to false and
-   <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-play><a href=#event-play>play</a></code>.</dd>
+   <dd>
 
+    <p>The user agent must <a href=#fire-a-simple-event>fire a simple event</a> called
+    <code title=event-canplaythrough><a href=#event-canplaythrough>canplaythrough</a></code> event.</p>
+    <!-- XXX make sure it fires after canplay when fixing queueing here -->
+
+    <p>If the <a href=#autoplaying-flag>autoplaying flag</a> is true, and the <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> attribute is true, and the
+    <a href=#media-element>media element</a> has an <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute specified,
+    then the user agent may also set the <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> attribute to false and
+    <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-play><a href=#event-play>play</a></code>.</p>
+
+    <p class=note>User agents are not required to autoplay, and it
+    is suggested that user agents honor user preferences on the
+    matter. Authors are urged to use the <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code> attribute rather than
+    using script to force the video to play, so as to allow the user
+    to override the behavior if so desired.</p>
+
+   </dd>
+
   </dl><p class=note>It is possible for the ready state of a media
   element to jump between these states discontinuously. For example,
   the state of a media element can jump straight from <code title=dom-media-HAVE_SOME_DATA><a href=#dom-media-have_some_data>HAVE_SOME_DATA</a></code> to <code title=dom-media-HAVE_ENOUGH_DATA><a href=#dom-media-have_enough_data>HAVE_ENOUGH_DATA</a></code> without

Modified: source
===================================================================
--- source	2008-10-15 00:26:52 UTC (rev 2330)
+++ source	2008-10-15 00:45:23 UTC (rev 2331)
@@ -18842,19 +18842,30 @@
    <dt>If the new ready state is <code
    title="dom-media-HAVE_ENOUGH_DATA">HAVE_ENOUGH_DATA</code></dt>
 
-   <dd><p>The user agent must <span>fire a simple event</span> called
-   <code title="event-canplaythrough">canplaythrough</code> event.
-   <!-- XXX make sure it fires after canplay when fixing queueing here -->
-   If the
-   <span>autoplaying flag</span> is true, and the <code
-   title="dom-media-paused">paused</code> attribute is true, and the
-   <span>media element</span> has an <code
-   title="attr-media-autoplay">autoplay</code> attribute specified,
-   then the user agent must also set the <code
-   title="dom-media-paused">paused</code> attribute to false and
-   <span>fire a simple event</span> called <code
-   title="event-play">play</code>.</p></dd>
+   <dd>
 
+    <p>The user agent must <span>fire a simple event</span> called
+    <code title="event-canplaythrough">canplaythrough</code> event.</p>
+    <!-- XXX make sure it fires after canplay when fixing queueing here -->
+
+    <p>If the <span>autoplaying flag</span> is true, and the <code
+    title="dom-media-paused">paused</code> attribute is true, and the
+    <span>media element</span> has an <code
+    title="attr-media-autoplay">autoplay</code> attribute specified,
+    then the user agent may also set the <code
+    title="dom-media-paused">paused</code> attribute to false and
+    <span>fire a simple event</span> called <code
+    title="event-play">play</code>.</p>
+
+    <p class="note">User agents are not required to autoplay, and it
+    is suggested that user agents honor user preferences on the
+    matter. Authors are urged to use the <code
+    title="attr-media-autoplay">autoplay</code> attribute rather than
+    using script to force the video to play, so as to allow the user
+    to override the behavior if so desired.</p>
+
+   </dd>
+
   </dl>
 
   <p class="note">It is possible for the ready state of a media