hixie: Add <video audio=muted>. (whatwg r5636)

hixie: Add <video audio=muted>. (whatwg r5636)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4511&r2=1.4512&f=h
http://html5.org/tools/web-apps-tracker?from=5635&to=5636

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4511
retrieving revision 1.4512
diff -u -d -r1.4511 -r1.4512
--- Overview.html 15 Oct 2010 00:18:35 -0000 1.4511
+++ Overview.html 15 Oct 2010 21:28:59 -0000 1.4512
@@ -63,7 +63,8 @@
    h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
    h1 + h2, hr + h2.no-toc { page-break-before: auto; }
 
-   p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; }
+   p  > span:not([title=""]):not([class="XXX"]):not([class="impl"]):not([class="note"]),
+   li > span:not([title=""]):not([class="XXX"]):not([class="impl"]):not([class="note"]), { border-bottom: solid #9999CC; }
 
    div.head { margin: 0 0 1em; padding: 1em 0 0 0; }
    div.head p { margin: 0; }
@@ -20694,6 +20695,7 @@
    <dd><code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code></dd>
    <dd><code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code></dd>
    <dd><code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code></dd>
+   <dd><code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code></dd>
    <dd><code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code></dd>
    <dd><code title="attr-dim-width"><a href="#attr-dim-width">width</a></code></dd>
    <dd><code title="attr-dim-height"><a href="#attr-dim-height">height</a></code></dd>
@@ -20705,6 +20707,7 @@
   readonly attribute unsigned long <a href="#dom-video-videowidth" title="dom-video-videoWidth">videoWidth</a>;
   readonly attribute unsigned long <a href="#dom-video-videoheight" title="dom-video-videoHeight">videoHeight</a>;
            attribute DOMString <a href="#dom-video-poster" title="dom-video-poster">poster</a>;
+           attribute boolean <a href="#dom-media-audio" title="dom-media-audio">audio</a>; <!-- attr-media-audio -->
 };</pre>
    </dd>
   </dl><p>A <code><a href="#video">video</a></code> element is used for playing videos or
@@ -20722,7 +20725,9 @@
   overlays) into their media streams.<p>The <code><a href="#video">video</a></code> element is a <a href="#media-element">media element</a>
   whose <a href="#media-data">media data</a> is ostensibly video data, possibly
   with associated audio data.<p>The <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code> attributes are <a href="#media-element-attributes" title="media element attributes">the attributes common to all media
-  elements</a>.<p>The <dfn id="attr-video-poster" title="attr-video-poster"><code>poster</code></dfn>
+  elements</a>. The <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code>
+  attribute <a href="#attr-media-audio" title="attr-media-audio">controls the audio
+  channel</a>.<p>The <dfn id="attr-video-poster" title="attr-video-poster"><code>poster</code></dfn>
   attribute gives the address of an image file that the user agent can
   show while no video data is available. The attribute, if present,
   must contain a <a href="#valid-non-empty-url-potentially-surrounded-by-spaces">valid non-empty URL potentially surrounded by
@@ -20740,9 +20745,6 @@
   (typically one of the first non-blank frames) that gives the user an
   idea of what the video is like.<div class="impl">
 
-  <p>The <dfn id="dom-video-poster" title="dom-video-poster"><code>poster</code></dfn> IDL
-  attribute must <a href="#reflect">reflect</a> the <code title="attr-video-poster"><a href="#attr-video-poster">poster</a></code> content attribute.</p>
-
   <hr><p>When no video data is available (the element's <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute is either
   <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, or <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> but no video
   data has yet been obtained at all), the <code><a href="#video">video</a></code> element
@@ -20880,6 +20882,12 @@
   agents could disable screensavers while video playback is in
   progress.</p>
 
+  <hr><p>The <dfn id="dom-video-poster" title="dom-video-poster"><code>poster</code></dfn> IDL
+  attribute must <a href="#reflect">reflect</a> the <code title="attr-video-poster"><a href="#attr-video-poster">poster</a></code> content attribute.</p>
+
+  <p>The <dfn id="dom-media-audio" title="dom-media-audio"><code>audio</code></dfn> IDL
+  attribute must <a href="#reflect">reflect</a> the <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> content attribute.</p>
+
   </div><div class="example">
 
    <p>This example shows how to detect when a video has failed to play
@@ -21410,7 +21418,7 @@
   <a href="#mutabletimedtrack">MutableTimedTrack</a> <a href="#dom-media-addtrack" title="dom-media-addTrack">addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
 <!--KEEP-START w3c-html--><!--TT-->
 };</pre><p>The <dfn id="media-element-attributes">media element attributes</dfn>, <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code>, apply to all <a href="#media-element" title="media element">media elements</a>. They are defined in
-  this section.</p><!-- proposed v2 (actually v3!) features:
+  this section.</p><!-- attr-media-audio --><!-- proposed v2 (actually v3!) features:
     * frame forward / backwards / step(n) while paused
     * hasAudio, hasVideo, hasCaptions, etc
     * per-frame control: get current frame; set current frame
@@ -25187,6 +25195,48 @@
   event</a> named <code title="event-media-volumechange"><a href="#event-media-volumechange">volumechange</a></code> at the <a href="#media-element">media
   element</a>.</p>
 
+  </div><p>The <dfn id="attr-media-audio" title="attr-media-audio"><code>audio</code></dfn>
+  attribute on the <code><a href="#video">video</a></code> element controls the default
+  state of the audio channel of the <a href="#media-resource">media resource</a>,
+  potentially overriding user preferences.<p>The <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> attribute, if
+  specified, must have a value that is an <a href="#unordered-set-of-unique-space-separated-tokens">unordered set of
+  unique space-separated tokens</a>, which are <a href="#ascii-case-insensitive">ASCII
+  case-insensitive</a>. The tokens must be from the following list
+  (currently, only one allowed token is defined):<dl><dt><dfn id="attr-media-audio-keyword-muted" title="attr-media-audio-keyword-muted"><code>muted</code></dfn></dt>
+
+   <dd>
+
+    <p>Causes the user agent to override the user's preferences, if
+    any, and always default the video to muted.</p>
+
+   </dd>
+
+  </dl><p class="note">A future version of this specification will probably
+  introduce new values here, e.g. to control the default volume, or to
+  select a default audio track.<div class="impl">
+
+  <p>When a <code><a href="#video">video</a></code> element is created, if it has an <code title="attr-media-audio"><a href="#attr-media-audio">audio</a></code> attribute specified, the user
+  agent must <a href="#split-a-string-on-spaces" title="split a string on spaces">split the
+  attribute's value on spaces</a>; if any of the tokens are an
+  <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string <code title="attr-media-audio-keyword-muted"><a href="#attr-media-audio-keyword-muted">muted</a></code>, the user agent
+  must then set the <code title="dom-media-muted"><a href="#dom-media-muted">muted</a></code>
+  attribute to true, overriding any user preference.</p>
+
+  <!-- attr-media-audio
+  <p>The <dfn title="dom-media-audio"><code>audio</code></dfn> IDL
+  attribute must <span>reflect</span> the content attribute of the
+  same name.</p>
+  -->
+
+  </div><p class="note">This attribute has no dynamic effect (it only
+  controls the default state of the element).<div class="example">
+
+   <p>This video (an advertisment) autoplays, but to avoid annoying
+   users, it does so without sound, and allows the user to turn the
+   sound on.</p>
+
+   <pre>&lt;video src="adverts.cgi?kind=video" controls autoplay loop audio=muted&gt;&lt;/video&gt;</pre>
+
   </div><h5 id="time-ranges"><span class="secno">4.8.10.12 </span>Time ranges</h5><p>Objects implementing the <code><a href="#timeranges">TimeRanges</a></code> interface
   represent a list of ranges (periods) of time.<pre class="idl">interface <dfn id="timeranges">TimeRanges</dfn> {
   readonly attribute unsigned long <a href="#dom-timeranges-length" title="dom-TimeRanges-length">length</a>;

Received on Friday, 15 October 2010 21:29:51 UTC