[html5] r7150 - [giow] (0) Define textTrack.inBandMetadataTrackDispatchType Fixing https://www.w [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Jun 27 22:11:07 PDT 2012


Author: ianh
Date: 2012-06-27 22:11:05 -0700 (Wed, 27 Jun 2012)
New Revision: 7150

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Define textTrack.inBandMetadataTrackDispatchType
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=13359
Affected topics: HTML, Video Text Tracks, Video and Audio

Modified: complete.html
===================================================================
--- complete.html	2012-06-27 21:23:20 UTC (rev 7149)
+++ complete.html	2012-06-28 05:11:05 UTC (rev 7150)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 27 June 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 28 June 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -3174,7 +3174,7 @@
   rendered, even if, unbeknownst to the implementation, the image also
   contained animation data.</p>
 
-  <p class=example>A MPEG4 video file would not be considered to be
+  <p class=example>A MPEG-4 video file would not be considered to be
   in a supported format if the compression format used was not
   supported, even if the implementation could determine the dimensions
   of the movie from the file's metadata.</p>
@@ -31514,7 +31514,7 @@
   be set to false (not selected). The <a href=#concept-media-load-resource title=concept-media-load-resource>resource fetch algorithm</a>
   can override this.</p>
 
-  <p>The <dfn id=dom-audiotrack-id title=dom-AudioTrack-id><code>AudioTrack.id</code></dfn> and <dfn id=dom-videotrack-id title=dom-VideoTrack-id><code>VideTrack.id</code></dfn>
+  <p>The <dfn id=dom-audiotrack-id title=dom-AudioTrack-id><code>AudioTrack.id</code></dfn> and <dfn id=dom-videotrack-id title=dom-VideoTrack-id><code>VideoTrack.id</code></dfn>
   attributes must return the identifier of the track, if it has one,
   or the empty string otherwise. If the <a href=#media-resource>media resource</a> is
   in a format that supports the <cite>Media Fragments URI</cite>
@@ -31523,6 +31523,9 @@
   used as the name of a track in the track dimension of such a
   fragment identifier. <a href=#refsMEDIAFRAG>[MEDIAFRAG]</a></p>
 
+  <p class=example>For example, in Ogg files, this would be the Name
+  header field of the track. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a></p>
+
   <p>The <dfn id=dom-audiotrack-kind title=dom-AudioTrack-kind><code>AudioTrack.kind</code></dfn> and
   <dfn id=dom-videotrack-kind title=dom-VideoTrack-kind><code>VideoTrack.kind</code></dfn>
   attributes must return the category of the track, if it has one, or
@@ -31541,9 +31544,10 @@
   and must only be returned for <code><a href=#videotrack>VideoTrack</a></code> objects if
   they are appropriate for video.</p>
 
-  <p>For Ogg files, the Role header of the track gives the relevant
-  metadata. For DASH media resources, the <code title="">Role</code>
-  element conveys the information. For WebM, only the <code title="">FlagDefault</code> element currently maps to a value. <a href=#refsOGGROLE>[OGGROLE]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
+  <p>For Ogg files, the Role header field of the track gives the
+  relevant metadata. For DASH media resources, the <code title="">Role</code> element conveys the information. For WebM, only
+  the <code title="">FlagDefault</code> element currently maps to a
+  value. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
 
   </div>
 
@@ -32698,6 +32702,32 @@
 
    </dd>
 
+   <dt><dfn id=text-track-in-band-metadata-track-dispatch-type title="text track in-band metadata track dispatch type">An in-band metadata track dispatch type</dfn>
+
+   <dd>
+
+    <p>This is a string extracted from the <a href=#media-resource>media resource</a>
+    specifically for in-band metadata tracks to enable such tracks to
+    be dispatched to different scripts in the document.</p>
+
+    <p class=example>For example, a traditional TV station broadcast
+    streamed on the Web and augmented with Web-specific interactive
+    features could include text tracks with metadata for ad
+    targetting, trivia game data during game shows, player states
+    during sports games, recipe information during food programs, and
+    so forth. As each program starts and ends, new tracks might be
+    added or removed from the stream, and as each one is added, the
+    user agent could bind them to dedicated script modules using the
+    value of this attribute.</p>
+
+    <p>Other than for in-band metadata text tracks, the <a href=#text-track-in-band-metadata-track-dispatch-type title="text track in-band metadata track dispatch type">in-band
+    metadata track dispatch type</a> is the empty string. How this
+    value is populated for different media formats is described in
+    <a href=#steps-to-expose-a-media-resource-specific-text-track>steps to expose a media-resource-specific text
+    track</a>.</p>
+
+   </dd>
+
    <dt><dfn id=text-track-language title="text track language">A language</dfn>
 
    <dd>
@@ -33143,6 +33173,58 @@
    label in that data, then the <a href=#text-track-label title="text track
    label">label</a> must be set to the empty string.</li>
 
+   <li>
+
+    <p>If the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
+    kind">kind</a> is <code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>, then set the
+    <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch type</a> as
+    follows, based on the type of the <a href=#media-resource>media resource</a>:</p>
+
+    <dl class=switch><dt>If the <a href=#media-resource>media resource</a> is an Ogg file</dt>
+
+     <dd>The <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the value of the Name header field. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a></dd>
+
+     <dt>If the <a href=#media-resource>media resource</a> is an WebM file</dt>
+
+     <dd>The <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the value of the <code title="">CodecID</code> element. <a href=#refsWEBMCG>[WEBMCG]</a></dd>
+
+     <dt>If the <a href=#media-resource>media resource</a> is an MPEG-4 file</dt>
+
+     <dd>Let the 
+     first <code title="">stsd</code> box of the
+     first <code title="">stbl</code> box of the
+     first <code title="">minf</code> box of the
+     first <code title="">mdia</code> box of the
+     first <code title="">trak</code> box of the
+     first <code title="">moov</code> box
+     of the file be the <i>stsd box</i>, if any.
+
+     If the file has no <i>stsd box</i>, or if the <i>stsd box</i> has
+     neither a <code title="">mett</code> box nor a <code title="">metx</code> box, then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band
+     metadata track dispatch type</a> must be set to the empty
+     string.
+
+     Otherwise, if the <i>stsd box</i> has a <code title="">mett</code> box then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band
+     metadata track dispatch type</a> must be set to the
+     concatenation of the string "<code title="">mett</code>", a
+     U+0020 SPACE character, and the value of the first <code title="">mime_format</code> field of the first <code title="">mett</code> box of the <i>stsd box</i>, or the empty
+     string if that field is absent in that box.
+
+     Otherwise, if the <i>stsd box</i> has no <code title="">mett</code> box but has a <code title="">metx</code> box
+     then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the concatenation of the string "<code title="">metx</code>", a U+0020 SPACE character, and the value of
+     the first <code title="">namespace</code> field of the first
+     <code title="">metx</code> box of the <i>stsd box</i>, or the
+     empty string if that field is absent in that box.
+
+     <a href=#refsMPEG4>[MPEG4]</a>
+
+     </dd>
+
+    </dl></li>
+
    <li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
    parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
    cues</a>, and begin updating it dynamically as
@@ -33207,15 +33289,15 @@
   <table><thead><tr><th>State
      <th>String
    <tbody><tr><td><a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>Subtitles</a>
-     <td><code title=dom-timedtrack-kind-subtitles>subtitles</code>
+     <td><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
     <tr><td><a href=#attr-track-kind-captions title=attr-track-kind-captions>Captions</a>
-     <td><code title=dom-timedtrack-kind-captions>captions</code>
+     <td><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
     <tr><td><a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>Descriptions</a>
-     <td><code title=dom-timedtrack-kind-descriptions>descriptions</code>
+     <td><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
     <tr><td><a href=#attr-track-kind-chapters title=attr-track-kind-chapters>Chapters</a>
-     <td><code title=dom-timedtrack-kind-chapters>chapters</code>
+     <td><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
     <tr><td><a href=#attr-track-kind-metadata title=attr-track-kind-metadata>Metadata</a>
-     <td><code title=dom-timedtrack-kind-metadata>metadata</code>
+     <td><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
   </table><p>The <a href=#text-track-label>text track label</a> is the element's <a href=#track-label>track
   label</a>.</p>
 
@@ -33630,6 +33712,7 @@
   readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
   readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
   readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
+  readonly attribute DOMString <a href=#dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType</a>;
 
            attribute <a href=#texttrackmode>TextTrackMode</a> <a href=#dom-texttrack-mode title=dom-TextTrack-mode>mode</a>;
 
@@ -33660,6 +33743,11 @@
     <p>Returns the <a href=#text-track-language>text track language</a> string.</p>
    </dd>
 
+   <dt><var title="">textTrack</var> . <code title=dom-TextTrack-inBandMetadataTrackDispatchType><a href=#dom-texttrack-inbandmetadatatrackdispatchtype>inBandMetadataTrackDispatchType</a></code></dt>
+   <dd>
+    <p>Returns the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch type</a> string.</p>
+   </dd>
+
    <dt><var title="">textTrack</var> . <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <a href=#text-track-mode>text track mode</a>, represented by a
@@ -33723,6 +33811,11 @@
   <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
   represents.</p>
 
+  <p>The <dfn id=dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType<code></code></dfn>
+  attribute must return the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track
+  dispatch type</a> of the <a href=#text-track>text track</a> that the
+  <code><a href=#texttrack>TextTrack</a></code> object represents.</p>
+
   <p>The <dfn id=dom-texttrack-mode title=dom-TextTrack-mode><code>mode</code></dfn>
   attribute, on getting, must return the string corresponding to the
   <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text track</a> that the
@@ -34578,7 +34671,7 @@
   the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>
   <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
   track showing by default">showing by default</a> and whose
-  <a href=#text-track-kind>text track kind</a> is <code title=dom-timedtrack-kind-chapters>chapters</code> should be used.
+  <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> should be used.
   Such tracks must be interpreted according to the <a href=#rules-for-constructing-the-chapter-tree-from-a-text-track>rules for
   constructing the chapter tree from a text track</a>.</p>
 
@@ -102673,6 +102766,10 @@
    <dt id=refsMIMESNIFF>[MIMESNIFF]</dt>
    <dd><cite><a href=http://mimesniff.spec.whatwg.org/>MIME Sniffing</a></cite>, A. Barth, I. Hickson. WHATWG.</dd>
 
+   <dt id=refsMPEG4>[MPEG4]</dt>
+   <dd><cite><a href="">ISO/IEC 14496-12: ISO base media file format</a></cite>. ISO/IEC.</dd>
+   <!-- search for ["Box Structure was and subsequent clauses were re-organized"] to find it -->
+
    <dt id=refsMQ>[MQ]</dt>
    <!--
    <dd><cite><a href="http://www.w3.org/TR/css3-mediaqueries/">Media
@@ -102687,7 +102784,7 @@
    <dd>(Non-normative) <cite><a href=https://developer.mozilla.org/en/Gecko_Plugin_API_Reference>Gecko
    Plugin API Reference</a></cite>. Mozilla.</dd>
 
-   <dt id=refsOGGROLE>[OGGROLE]</dt>
+   <dt id=refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</dt>
    <dd><cite><a href=http://wiki.xiph.org/SkeletonHeaders>SkeletonHeaders</a></cite>. Xiph.Org.</dd>
 
    <dt id=refsOPENSEARCH>[OPENSEARCH]</dt>

Modified: index
===================================================================
--- index	2012-06-27 21:23:20 UTC (rev 7149)
+++ index	2012-06-28 05:11:05 UTC (rev 7150)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 27 June 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 28 June 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -3174,7 +3174,7 @@
   rendered, even if, unbeknownst to the implementation, the image also
   contained animation data.</p>
 
-  <p class=example>A MPEG4 video file would not be considered to be
+  <p class=example>A MPEG-4 video file would not be considered to be
   in a supported format if the compression format used was not
   supported, even if the implementation could determine the dimensions
   of the movie from the file's metadata.</p>
@@ -31514,7 +31514,7 @@
   be set to false (not selected). The <a href=#concept-media-load-resource title=concept-media-load-resource>resource fetch algorithm</a>
   can override this.</p>
 
-  <p>The <dfn id=dom-audiotrack-id title=dom-AudioTrack-id><code>AudioTrack.id</code></dfn> and <dfn id=dom-videotrack-id title=dom-VideoTrack-id><code>VideTrack.id</code></dfn>
+  <p>The <dfn id=dom-audiotrack-id title=dom-AudioTrack-id><code>AudioTrack.id</code></dfn> and <dfn id=dom-videotrack-id title=dom-VideoTrack-id><code>VideoTrack.id</code></dfn>
   attributes must return the identifier of the track, if it has one,
   or the empty string otherwise. If the <a href=#media-resource>media resource</a> is
   in a format that supports the <cite>Media Fragments URI</cite>
@@ -31523,6 +31523,9 @@
   used as the name of a track in the track dimension of such a
   fragment identifier. <a href=#refsMEDIAFRAG>[MEDIAFRAG]</a></p>
 
+  <p class=example>For example, in Ogg files, this would be the Name
+  header field of the track. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a></p>
+
   <p>The <dfn id=dom-audiotrack-kind title=dom-AudioTrack-kind><code>AudioTrack.kind</code></dfn> and
   <dfn id=dom-videotrack-kind title=dom-VideoTrack-kind><code>VideoTrack.kind</code></dfn>
   attributes must return the category of the track, if it has one, or
@@ -31541,9 +31544,10 @@
   and must only be returned for <code><a href=#videotrack>VideoTrack</a></code> objects if
   they are appropriate for video.</p>
 
-  <p>For Ogg files, the Role header of the track gives the relevant
-  metadata. For DASH media resources, the <code title="">Role</code>
-  element conveys the information. For WebM, only the <code title="">FlagDefault</code> element currently maps to a value. <a href=#refsOGGROLE>[OGGROLE]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
+  <p>For Ogg files, the Role header field of the track gives the
+  relevant metadata. For DASH media resources, the <code title="">Role</code> element conveys the information. For WebM, only
+  the <code title="">FlagDefault</code> element currently maps to a
+  value. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
 
   </div>
 
@@ -32698,6 +32702,32 @@
 
    </dd>
 
+   <dt><dfn id=text-track-in-band-metadata-track-dispatch-type title="text track in-band metadata track dispatch type">An in-band metadata track dispatch type</dfn>
+
+   <dd>
+
+    <p>This is a string extracted from the <a href=#media-resource>media resource</a>
+    specifically for in-band metadata tracks to enable such tracks to
+    be dispatched to different scripts in the document.</p>
+
+    <p class=example>For example, a traditional TV station broadcast
+    streamed on the Web and augmented with Web-specific interactive
+    features could include text tracks with metadata for ad
+    targetting, trivia game data during game shows, player states
+    during sports games, recipe information during food programs, and
+    so forth. As each program starts and ends, new tracks might be
+    added or removed from the stream, and as each one is added, the
+    user agent could bind them to dedicated script modules using the
+    value of this attribute.</p>
+
+    <p>Other than for in-band metadata text tracks, the <a href=#text-track-in-band-metadata-track-dispatch-type title="text track in-band metadata track dispatch type">in-band
+    metadata track dispatch type</a> is the empty string. How this
+    value is populated for different media formats is described in
+    <a href=#steps-to-expose-a-media-resource-specific-text-track>steps to expose a media-resource-specific text
+    track</a>.</p>
+
+   </dd>
+
    <dt><dfn id=text-track-language title="text track language">A language</dfn>
 
    <dd>
@@ -33143,6 +33173,58 @@
    label in that data, then the <a href=#text-track-label title="text track
    label">label</a> must be set to the empty string.</li>
 
+   <li>
+
+    <p>If the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
+    kind">kind</a> is <code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>, then set the
+    <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch type</a> as
+    follows, based on the type of the <a href=#media-resource>media resource</a>:</p>
+
+    <dl class=switch><dt>If the <a href=#media-resource>media resource</a> is an Ogg file</dt>
+
+     <dd>The <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the value of the Name header field. <a href=#refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</a></dd>
+
+     <dt>If the <a href=#media-resource>media resource</a> is an WebM file</dt>
+
+     <dd>The <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the value of the <code title="">CodecID</code> element. <a href=#refsWEBMCG>[WEBMCG]</a></dd>
+
+     <dt>If the <a href=#media-resource>media resource</a> is an MPEG-4 file</dt>
+
+     <dd>Let the 
+     first <code title="">stsd</code> box of the
+     first <code title="">stbl</code> box of the
+     first <code title="">minf</code> box of the
+     first <code title="">mdia</code> box of the
+     first <code title="">trak</code> box of the
+     first <code title="">moov</code> box
+     of the file be the <i>stsd box</i>, if any.
+
+     If the file has no <i>stsd box</i>, or if the <i>stsd box</i> has
+     neither a <code title="">mett</code> box nor a <code title="">metx</code> box, then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band
+     metadata track dispatch type</a> must be set to the empty
+     string.
+
+     Otherwise, if the <i>stsd box</i> has a <code title="">mett</code> box then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band
+     metadata track dispatch type</a> must be set to the
+     concatenation of the string "<code title="">mett</code>", a
+     U+0020 SPACE character, and the value of the first <code title="">mime_format</code> field of the first <code title="">mett</code> box of the <i>stsd box</i>, or the empty
+     string if that field is absent in that box.
+
+     Otherwise, if the <i>stsd box</i> has no <code title="">mett</code> box but has a <code title="">metx</code> box
+     then the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch
+     type</a> must be set to the concatenation of the string "<code title="">metx</code>", a U+0020 SPACE character, and the value of
+     the first <code title="">namespace</code> field of the first
+     <code title="">metx</code> box of the <i>stsd box</i>, or the
+     empty string if that field is absent in that box.
+
+     <a href=#refsMPEG4>[MPEG4]</a>
+
+     </dd>
+
+    </dl></li>
+
    <li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
    parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
    cues</a>, and begin updating it dynamically as
@@ -33207,15 +33289,15 @@
   <table><thead><tr><th>State
      <th>String
    <tbody><tr><td><a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>Subtitles</a>
-     <td><code title=dom-timedtrack-kind-subtitles>subtitles</code>
+     <td><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
     <tr><td><a href=#attr-track-kind-captions title=attr-track-kind-captions>Captions</a>
-     <td><code title=dom-timedtrack-kind-captions>captions</code>
+     <td><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
     <tr><td><a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>Descriptions</a>
-     <td><code title=dom-timedtrack-kind-descriptions>descriptions</code>
+     <td><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
     <tr><td><a href=#attr-track-kind-chapters title=attr-track-kind-chapters>Chapters</a>
-     <td><code title=dom-timedtrack-kind-chapters>chapters</code>
+     <td><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
     <tr><td><a href=#attr-track-kind-metadata title=attr-track-kind-metadata>Metadata</a>
-     <td><code title=dom-timedtrack-kind-metadata>metadata</code>
+     <td><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
   </table><p>The <a href=#text-track-label>text track label</a> is the element's <a href=#track-label>track
   label</a>.</p>
 
@@ -33630,6 +33712,7 @@
   readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
   readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
   readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
+  readonly attribute DOMString <a href=#dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType</a>;
 
            attribute <a href=#texttrackmode>TextTrackMode</a> <a href=#dom-texttrack-mode title=dom-TextTrack-mode>mode</a>;
 
@@ -33660,6 +33743,11 @@
     <p>Returns the <a href=#text-track-language>text track language</a> string.</p>
    </dd>
 
+   <dt><var title="">textTrack</var> . <code title=dom-TextTrack-inBandMetadataTrackDispatchType><a href=#dom-texttrack-inbandmetadatatrackdispatchtype>inBandMetadataTrackDispatchType</a></code></dt>
+   <dd>
+    <p>Returns the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track dispatch type</a> string.</p>
+   </dd>
+
    <dt><var title="">textTrack</var> . <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <a href=#text-track-mode>text track mode</a>, represented by a
@@ -33723,6 +33811,11 @@
   <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
   represents.</p>
 
+  <p>The <dfn id=dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType<code></code></dfn>
+  attribute must return the <a href=#text-track-in-band-metadata-track-dispatch-type>text track in-band metadata track
+  dispatch type</a> of the <a href=#text-track>text track</a> that the
+  <code><a href=#texttrack>TextTrack</a></code> object represents.</p>
+
   <p>The <dfn id=dom-texttrack-mode title=dom-TextTrack-mode><code>mode</code></dfn>
   attribute, on getting, must return the string corresponding to the
   <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text track</a> that the
@@ -34578,7 +34671,7 @@
   the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>
   <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
   track showing by default">showing by default</a> and whose
-  <a href=#text-track-kind>text track kind</a> is <code title=dom-timedtrack-kind-chapters>chapters</code> should be used.
+  <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> should be used.
   Such tracks must be interpreted according to the <a href=#rules-for-constructing-the-chapter-tree-from-a-text-track>rules for
   constructing the chapter tree from a text track</a>.</p>
 
@@ -102673,6 +102766,10 @@
    <dt id=refsMIMESNIFF>[MIMESNIFF]</dt>
    <dd><cite><a href=http://mimesniff.spec.whatwg.org/>MIME Sniffing</a></cite>, A. Barth, I. Hickson. WHATWG.</dd>
 
+   <dt id=refsMPEG4>[MPEG4]</dt>
+   <dd><cite><a href="">ISO/IEC 14496-12: ISO base media file format</a></cite>. ISO/IEC.</dd>
+   <!-- search for ["Box Structure was and subsequent clauses were re-organized"] to find it -->
+
    <dt id=refsMQ>[MQ]</dt>
    <!--
    <dd><cite><a href="http://www.w3.org/TR/css3-mediaqueries/">Media
@@ -102687,7 +102784,7 @@
    <dd>(Non-normative) <cite><a href=https://developer.mozilla.org/en/Gecko_Plugin_API_Reference>Gecko
    Plugin API Reference</a></cite>. Mozilla.</dd>
 
-   <dt id=refsOGGROLE>[OGGROLE]</dt>
+   <dt id=refsOGGSKELETONHEADERS>[OGGSKELETONHEADERS]</dt>
    <dd><cite><a href=http://wiki.xiph.org/SkeletonHeaders>SkeletonHeaders</a></cite>. Xiph.Org.</dd>
 
    <dt id=refsOPENSEARCH>[OPENSEARCH]</dt>

Modified: source
===================================================================
--- source	2012-06-27 21:23:20 UTC (rev 7149)
+++ source	2012-06-28 05:11:05 UTC (rev 7150)
@@ -2046,7 +2046,7 @@
   rendered, even if, unbeknownst to the implementation, the image also
   contained animation data.</p>
 
-  <p class="example">A MPEG4 video file would not be considered to be
+  <p class="example">A MPEG-4 video file would not be considered to be
   in a supported format if the compression format used was not
   supported, even if the implementation could determine the dimensions
   of the movie from the file's metadata.</p>
@@ -34390,7 +34390,7 @@
 
   <p>The <dfn
   title="dom-AudioTrack-id"><code>AudioTrack.id</code></dfn> and <dfn
-  title="dom-VideoTrack-id"><code>VideTrack.id</code></dfn>
+  title="dom-VideoTrack-id"><code>VideoTrack.id</code></dfn>
   attributes must return the identifier of the track, if it has one,
   or the empty string otherwise. If the <span>media resource</span> is
   in a format that supports the <cite>Media Fragments URI</cite>
@@ -34399,6 +34399,10 @@
   used as the name of a track in the track dimension of such a
   fragment identifier. <a href="#refsMEDIAFRAG">[MEDIAFRAG]</a></p>
 
+  <p class="example">For example, in Ogg files, this would be the Name
+  header field of the track. <a
+  href="#refsOGGSKELETONHEADERS">[OGGSKELETONHEADERS]</a></p>
+
   <p>The <dfn
   title="dom-AudioTrack-kind"><code>AudioTrack.kind</code></dfn> and
   <dfn title="dom-VideoTrack-kind"><code>VideoTrack.kind</code></dfn>
@@ -34418,12 +34422,12 @@
   and must only be returned for <code>VideoTrack</code> objects if
   they are appropriate for video.</p>
 
-  <p>For Ogg files, the Role header of the track gives the relevant
-  metadata. For DASH media resources, the <code title="">Role</code>
-  element conveys the information. For WebM, only the <code
-  title="">FlagDefault</code> element currently maps to a value. <a
-  href="#refsOGGROLE">[OGGROLE]</a> <a href="#refsDASH">[DASH]</a> <a
-  href="#refsWEBMCG">[WEBMCG]</a></p>
+  <p>For Ogg files, the Role header field of the track gives the
+  relevant metadata. For DASH media resources, the <code
+  title="">Role</code> element conveys the information. For WebM, only
+  the <code title="">FlagDefault</code> element currently maps to a
+  value. <a href="#refsOGGSKELETONHEADERS">[OGGSKELETONHEADERS]</a> <a
+  href="#refsDASH">[DASH]</a> <a href="#refsWEBMCG">[WEBMCG]</a></p>
 
   </div>
 
@@ -35775,6 +35779,33 @@
 
    </dd>
 
+   <dt><dfn title="text track in-band metadata track dispatch type">An in-band metadata track dispatch type</dfn>
+
+   <dd>
+
+    <p>This is a string extracted from the <span>media resource</span>
+    specifically for in-band metadata tracks to enable such tracks to
+    be dispatched to different scripts in the document.</p>
+
+    <p class="example">For example, a traditional TV station broadcast
+    streamed on the Web and augmented with Web-specific interactive
+    features could include text tracks with metadata for ad
+    targetting, trivia game data during game shows, player states
+    during sports games, recipe information during food programs, and
+    so forth. As each program starts and ends, new tracks might be
+    added or removed from the stream, and as each one is added, the
+    user agent could bind them to dedicated script modules using the
+    value of this attribute.</p>
+
+    <p>Other than for in-band metadata text tracks, the <span
+    title="text track in-band metadata track dispatch type">in-band
+    metadata track dispatch type</span> is the empty string. How this
+    value is populated for different media formats is described in
+    <span>steps to expose a media-resource-specific text
+    track</span>.</p>
+
+   </dd>
+
    <dt><dfn title="text track language">A language</dfn>
 
    <dd>
@@ -36264,6 +36295,72 @@
    label in that data, then the <span title="text track
    label">label</span> must be set to the empty string.</p></li>
 
+   <li>
+
+    <p>If the new <span>text track</span>'s <span title="text track
+    kind">kind</span> is <code
+    title="dom-TextTrack-kind-metadata">metadata</code>, then set the
+    <span>text track in-band metadata track dispatch type</span> as
+    follows, based on the type of the <span>media resource</span>:</p>
+
+    <dl class="switch"> 
+
+     <dt>If the <span>media resource</span> is an Ogg file</dt>
+
+     <dd>The <span>text track in-band metadata track dispatch
+     type</span> must be set to the value of the Name header field. <a
+     href="#refsOGGSKELETONHEADERS">[OGGSKELETONHEADERS]</a></dd>
+
+     <dt>If the <span>media resource</span> is an WebM file</dt>
+
+     <dd>The <span>text track in-band metadata track dispatch
+     type</span> must be set to the value of the <code
+     title="">CodecID</code> element. <a
+     href="#refsWEBMCG">[WEBMCG]</a></dd>
+
+     <dt>If the <span>media resource</span> is an MPEG-4 file</dt>
+
+     <dd>Let the 
+     first <code title="">stsd</code> box of the
+     first <code title="">stbl</code> box of the
+     first <code title="">minf</code> box of the
+     first <code title="">mdia</code> box of the
+     first <code title="">trak</code> box of the
+     first <code title="">moov</code> box
+     of the file be the <i>stsd box</i>, if any.
+
+     If the file has no <i>stsd box</i>, or if the <i>stsd box</i> has
+     neither a <code title="">mett</code> box nor a <code
+     title="">metx</code> box, then the <span>text track in-band
+     metadata track dispatch type</span> must be set to the empty
+     string.
+
+     Otherwise, if the <i>stsd box</i> has a <code
+     title="">mett</code> box then the <span>text track in-band
+     metadata track dispatch type</span> must be set to the
+     concatenation of the string "<code title="">mett</code>", a
+     U+0020 SPACE character, and the value of the first <code
+     title="">mime_format</code> field of the first <code
+     title="">mett</code> box of the <i>stsd box</i>, or the empty
+     string if that field is absent in that box.
+
+     Otherwise, if the <i>stsd box</i> has no <code
+     title="">mett</code> box but has a <code title="">metx</code> box
+     then the <span>text track in-band metadata track dispatch
+     type</span> must be set to the concatenation of the string "<code
+     title="">metx</code>", a U+0020 SPACE character, and the value of
+     the first <code title="">namespace</code> field of the first
+     <code title="">metx</code> box of the <i>stsd box</i>, or the
+     empty string if that field is absent in that box.
+
+     <a href="#refsMPEG4">[MPEG4]</a>
+
+     </dd>
+
+    </dl>
+
+   </li>
+
    <li><p>Populate the new <span>text track</span>'s <span
    title="text track list of cues">list of cues</span> with the cues
    parsed so far, folllowing the <span>guidelines for exposing
@@ -36339,19 +36436,19 @@
    <tbody>
     <tr>
      <td><span title="attr-track-kind-subtitles">Subtitles</span>
-     <td><code title="dom-timedtrack-kind-subtitles">subtitles</code>
+     <td><code title="dom-TextTrack-kind-subtitles">subtitles</code>
     <tr>
      <td><span title="attr-track-kind-captions">Captions</span>
-     <td><code title="dom-timedtrack-kind-captions">captions</code>
+     <td><code title="dom-TextTrack-kind-captions">captions</code>
     <tr>
      <td><span title="attr-track-kind-descriptions">Descriptions</span>
-     <td><code title="dom-timedtrack-kind-descriptions">descriptions</code>
+     <td><code title="dom-TextTrack-kind-descriptions">descriptions</code>
     <tr>
      <td><span title="attr-track-kind-chapters">Chapters</span>
-     <td><code title="dom-timedtrack-kind-chapters">chapters</code>
+     <td><code title="dom-TextTrack-kind-chapters">chapters</code>
     <tr>
      <td><span title="attr-track-kind-metadata">Metadata</span>
-     <td><code title="dom-timedtrack-kind-metadata">metadata</code>
+     <td><code title="dom-TextTrack-kind-metadata">metadata</code>
   </table>
 
   <p>The <span>text track label</span> is the element's <span>track
@@ -36826,6 +36923,7 @@
   readonly attribute DOMString <span title="dom-TextTrack-kind">kind</span>;
   readonly attribute DOMString <span title="dom-TextTrack-label">label</span>;
   readonly attribute DOMString <span title="dom-TextTrack-language">language</span>;
+  readonly attribute DOMString <span title="dom-TextTrack-inBandMetadataTrackDispatchType">inBandMetadataTrackDispatchType</span>;
 
            attribute <span>TextTrackMode</span> <span title="dom-TextTrack-mode">mode</span>;
 
@@ -36858,6 +36956,11 @@
     <p>Returns the <span>text track language</span> string.</p>
    </dd>
 
+   <dt><var title="">textTrack</var> . <code title="dom-TextTrack-inBandMetadataTrackDispatchType">inBandMetadataTrackDispatchType</code></dt>
+   <dd>
+    <p>Returns the <span>text track in-band metadata track dispatch type</span> string.</p>
+   </dd>
+
    <dt><var title="">textTrack</var> . <code title="dom-TextTrack-mode">mode</code> [ = <var title="">value</var> ]</dt>
    <dd>
     <p>Returns the <span>text track mode</span>, represented by a
@@ -36926,6 +37029,12 @@
   <span>text track</span> that the <code>TextTrack</code> object
   represents.</p>
 
+  <p>The <dfn
+  title="dom-TextTrack-inBandMetadataTrackDispatchType">inBandMetadataTrackDispatchType<code></code></dfn>
+  attribute must return the <span>text track in-band metadata track
+  dispatch type</span> of the <span>text track</span> that the
+  <code>TextTrack</code> object represents.</p>
+
   <p>The <dfn title="dom-TextTrack-mode"><code>mode</code></dfn>
   attribute, on getting, must return the string corresponding to the
   <span>text track mode</span> of the <span>text track</span> that the
@@ -37983,7 +38092,7 @@
   text</span> or <span>WebVTT cue text</span> as their <span>cue
   payload</span>; <span>WebVTT metadata text</span> cues are only
   useful for scripted applications (using the <code
-  title="dom-timedtrack-kind-metadata">metadata</code> <span>text
+  title="dom-TextTrack-kind-metadata">metadata</code> <span>text
   track kind</span>).</p>
 
   <p>A <span>WebVTT file</span> whose cues all have a <span>cue
@@ -40273,7 +40382,7 @@
   <span title="text track showing">showing</span> or <span title="text
   track showing by default">showing by default</span> and whose
   <span>text track kind</span> is <code
-  title="dom-timedtrack-kind-chapters">chapters</code> should be used.
+  title="dom-TextTrack-kind-chapters">chapters</code> should be used.
   Such tracks must be interpreted according to the <span>rules for
   constructing the chapter tree from a text track</span>.</p>
 
@@ -120419,6 +120528,10 @@
    <dt id="refsMIMESNIFF">[MIMESNIFF]</dt>
    <dd><cite><a href="http://mimesniff.spec.whatwg.org/">MIME Sniffing</a></cite>, A. Barth, I. Hickson. WHATWG.</dd>
 
+   <dt id="refsMPEG4">[MPEG4]</dt>
+   <dd><cite><a href="">ISO/IEC 14496-12: ISO base media file format</a></cite>. ISO/IEC.</dd>
+   <!-- search for ["Box Structure was and subsequent clauses were re-organized"] to find it -->
+
    <dt id="refsMQ">[MQ]</dt>
    <!--
    <dd><cite><a href="http://www.w3.org/TR/css3-mediaqueries/">Media
@@ -120440,7 +120553,7 @@
    Work in progress. <!--!-->
    </dd>
 
-   <dt id="refsOGGROLE">[OGGROLE]</dt>
+   <dt id="refsOGGSKELETONHEADERS">[OGGSKELETONHEADERS]</dt>
    <dd><cite><a href="http://wiki.xiph.org/SkeletonHeaders">SkeletonHeaders</a></cite>. Xiph.Org.</dd>
 
    <dt id="refsOPENSEARCH">[OPENSEARCH]</dt>




More information about the Commit-Watchers mailing list