- From: Anant Narayanan via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 13 Aug 2012 19:14:23 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2011/webrtc/editor
In directory hutz:/tmp/cvs-serv19898/editor
Modified Files:
webrtc.html webrtc.js
Added Files:
webrtc-20120813.html
Log Message:
Updating draft to github version webrtc-20120813.html
--- NEW FILE: webrtc-20120813.html ---
<!DOCTYPE html>
<html lang="en">
<head>
<title>WebRTC 1.0: Real-time Communication Between Browsers</title>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<!--
After making changes to this document in the github repo, run:
./publish.sh webrtc.html
to publish a new editor's draft to the W3C CVS. This assumes your
CVS checkout is located at ../2011/webrtc, you can specify the location
as the second argument, for example:
./publish.sh webrtc.html ~/path/to/w3/2011/webrtc
-->
<script class="remove" src="http://www.w3.org/Tools/respec/respec-w3c-common"
type="text/javascript">
// keep this comment
</script>
[...2762 lines suppressed...]
<li>Updated the LocalMediaStream.stop() algorithm to implicitly use the
end track algorithm.</li>
<li>Replaced an occurrence the term finished track with ended track (to
align with rest of spec).</li>
<li>Moved (and extended) the explanation about track references and media
sources from LocalMediaStream to MediaStreamTrack.</li>
</ol>
</section>
<section class="appendix">
<h2>Acknowledgements</h2>
<p>The editors wish to thank the Working Group chairs, Harald Alvestrand
and Stefan Håkansson, for their support.</p>
</section>
</body>
</html>
Index: webrtc.html
===================================================================
RCS file: /sources/public/2011/webrtc/editor/webrtc.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- webrtc.html 21 Jul 2012 05:00:26 -0000 1.20
+++ webrtc.html 13 Aug 2012 19:14:21 -0000 1.21
@@ -5,52 +5,13 @@
<title>WebRTC 1.0: Real-time Communication Between Browsers</title>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<!--
- === NOTA BENE ===
- For the three scripts below, if your spec resides on dev.w3 you can check them
- out in the same tree and use relative links so that they'll work offline.
-
- To tag a new releas in git hub
-
- Once the version is checked in and ready to go, you tag it with (need
- to chance the 20110823 to correct date )
-
- git tag -a v20120323 -m "This is release 20120323"
-
- Tags are not transferred by default with the push so you have to
- add a - -tags parameter to the push so it looks like. Note you need to
- remoce the space between the - and -tag to make a double dash.
-
- git push - -tags
-
- or alternatively you can push just the new tag with
-
- git push origin v20120323
-
-
- To generate the dated version of the specification:
-
- Open this doc in Mozilla.
-
- Do a CTRL-ALT-SHIFT-S
-
- Select "XHMTL( source)" from dialog box. This will pop a new tab with
- generated version of the document.
-
- This will open a new tab with generated html. Copy and paste this to
- a new file. Note if you use Chrome or Safari, this step will not
- work. What will happen is the paste will have the original document,
- not what was displayed in the window that you did the copy on.
-
- Rename the new file to the correct day such as
- webrtc-broken-20111003.html then search for and edit the links for
- "This version" and "Previos version". Add the new file into CVS and
- check in.
-
- Once everyone is happy, the webrtc-broken.html and
- webrtc-broken-20111003.html files can be copied to
- webrtc.html and webrtc-20111003.html
- respectively in the ../editor/. directory.
- -->
+ After making changes to this document in the github repo, run:
+ ./publish.sh webrtc.html
+ to publish a new editor's draft to the W3C CVS. This assumes your
+ CVS checkout is located at ../2011/webrtc, you can specify the location
+ as the second argument, for example:
+ ./publish.sh webrtc.html ~/path/to/w3/2011/webrtc
+ -->
<script class="remove" src="http://www.w3.org/Tools/respec/respec-w3c-common"
type="text/javascript">
@@ -364,6 +325,10 @@
<section>
<h4>AudioMediaStreamTrack</h4>
+ <p class="issue">ISSUE: The DTMF API is having a bunch of list discussion
+ and will probably change. </p>
+
+
<p>The <code><a>AudioMediaStreamTrack</a></code> is a specialization of
of a normal <code><a>MediaStreamTrack</a></code> that only carries audio
and is extended to have the capability to send and/or receive DTMF
@@ -1027,8 +992,12 @@
<section>
<h3>RTCPeerConnection Interface</h3>
+ <p class="issue">ISSUE: "optional optional" occurs twice several times
+ in the following class description.</p>
+
<dl class="idl" title=
- "[Constructor (RTCConfiguration configuration, optional MediaConstraints constraints)] interface RTCPeerConnection">
+ "[Constructor (RTCConfiguration configuration, optional MediaConstraints
+ constraints)] interface RTCPeerConnection : EventTarget ">
<!--
<dt>void getCapabilities ( RTCSessionDescriptionCallback
successCallback )</dt>
@@ -1662,7 +1631,6 @@
time the iceState changes.</dd>
</dl>
- <dl class="idl" title="RTCPeerConnection implements EventTarget"></dl>
</section>
</section>
</section>
@@ -1840,16 +1808,53 @@
</div>
</section>
+
+ <section>
+ <h3>Call Flow Browser to Browser </h3>
+
+ <p class="note">Editor Note: This example flow needs to be discussed on the
+ list and is likely wrong in many ways.</p>
+
+ <p>This shows an example of one possible call flow between two
+ browsers. This does not show every callback that gets fired but instead
+ tries to reduce it down to only show the key events and messages. </p>
+
+ <p><img alt="A MediaStream" src="images/ladder-2party-simple.svg" width=
+ "100%"></p>
+
+ <p> The following flow show a more complete set of the callbacks and events
+ that happen. </p>
+
+ <p><img alt="A MediaStream" src="images/ladder-2party-full.svg" width=
+ "100%"></p>
+ </section>
+
+
+ <section>
+ <h3>Call Flow Browser to MCU </h3>
+
+ <p class="note">Editor Note: This example flow needs to be discussed on the
+ list and is likely wrong in many ways.</p>
+
+ <p>This shows an example of one possible call flow between a centralized
+ conferencing server and a browsers. This does not show every callback that
+ gets fired but instead tries to reduce it down to only show the key events
+ and messages. </p>
+
+ <p><img alt="A MediaStream" src="images/ladder-mcu-simple.svg" width=
+ "100%"></p>
+
+ </section>
+
+
+
<section>
<h2>Peer-to-peer Data API</h2>
<p>The Peer-to-peer Data API lets a web application send and receive
generic application data peer-to-peer.</p>
- <div class="issue" title="hello">
- <p>ISSUES (this should not be considered as a complete list of open
- issues)</p>
-
+ <div class="issue" title="More Open Issue">
<ul>
<li>Data channel setup signaling (signaling via SDP and application
specific signaling channel or first channel via SDP and consecutive
@@ -2635,7 +2640,7 @@
<h2>Change Log</h2>
<p>This section will be removed before publication.</p>
-
+
<!-- Why do the first two headings automatically convert to <h2>? -->
<h3>Changes since Jul 20, 2012</h3>
@@ -2647,7 +2652,9 @@
<li>Added correlating lines to candidate structure.</li>
<li>Converted setLocalDescription and setRemoteDescription to be asynchronous.</li>
- </ol>
+
+ <li>Added call flows.</li>
+ </ol>
<h3>Changes since Jul 13, 2012</h3>
Index: webrtc.js
===================================================================
RCS file: /sources/public/2011/webrtc/editor/webrtc.js,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- webrtc.js 21 Jul 2012 05:01:34 -0000 1.1
+++ webrtc.js 13 Aug 2012 19:14:21 -0000 1.2
@@ -1,78 +1,75 @@
- var respecConfig = {
- // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
- //specStatus: "Member-SUBM",
- specStatus: "ED",
+var respecConfig = {
+ // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
+ specStatus: "ED",
- // the specification's short name, as in http://www.w3.org/TR/short-name/
- shortName: "webrtc",
- // if your specification has a subtitle that goes below the main
- // formal title, define it here
- // subtitle : "an excellent document",
+ // the specification's short name, as in http://www.w3.org/TR/short-name/
+ shortName: "webrtc",
+
+ // if your specification has a subtitle that goes below the main
+ // formal title, define it here
+ // subtitle : "an excellent document",
- // if you wish the publication date to be other than today, set this
- // publishDate: "2012-05-28",
+ // if you wish the publication date to be other than today, set this
+ // publishDate: "2012-05-28",
- // new ability to override the copyright completely
- overrideCopyright: "<p class='copyright'>Initial Author of this Specification was Ian Hickson, Google Inc., with the following copyright statement:<br /> © Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and Opera Software ASA. You are granted a license to use, reproduce and create derivative works of this document.</p> <p class='copyright'>All subsequent changes since 26 July 2011 done by the W3C WebRTC Working Group are under the following <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a>:<br />© 2011-2012 <a href='http://www.w3.org/'><acronym title='World Wide Web Consortium'>W3C</acronym></a><sup>®</sup> (<a href='http://www.csail.mit.edu/'><acronym title='Massachusetts Institute of Technology'>MIT</acronym></a>, <a href='http://www.ercim.eu/'><acronym title='European Research Consortium for Informatics and Mathematics'>ERCIM</acronym></a>, <a href='http://www.keio.ac.jp/'>Keio</a>), All Rights Reserved. <a href='http://www.w.org/Consortium/Legal/copyright-documents'>Document use</a> rules apply.</p> <p class='copyright'>For the entire publication on the W3C site the <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer'>liability</a> and <a href='http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks'>trademark</a> rules apply.</p>",
+ // new ability to override the copyright completely
+ overrideCopyright: "<p class='copyright'>Initial Author of this Specification was Ian Hickson, Google Inc., with the following copyright statement:<br /> © Copyright 2004-2011 Apple Computer, Inc., Mozilla Foundation, and Opera Software ASA. You are granted a license to use, reproduce and create derivative works of this document.</p> <p class='copyright'>All subsequent changes since 26 July 2011 done by the W3C WebRTC Working Group are under the following <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Copyright'>Copyright</a>:<br />© 2011-2012 <a href='http://www.w3.org/'><acronym title='World Wide Web Consortium'>W3C</acronym></a><sup>®</sup> (<a href='http://www.csail.mit.edu/'><acronym title='Massachusetts Institute of Technology'>MIT</acronym></a>, <a href='http://www.ercim.eu/'><acronym title='European Research Consortium for Informatics and Mathematics'>ERCIM</acronym></a>, <a href='http://www.keio.ac.jp/'>Keio</a>), All Rights Reserved. <a href='http://www.w3.org/ConsortiumLegal/copyright-documents'>Document use</a> rules apply.</p> <p class='copyright'>For the entire publication on the W3C site the <a href='http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer'>liability</a> and <a href='http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks'>trademark</a> rules apply.</p>",
- // if the specification's copyright date is a range of years, specify
- // the start date here:
- // copyrightStart: "2005",
+ // if the specification's copyright date is a range of years, specify
+ // the start date here:
+ // copyrightStart: "2005",
- // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
- // and its maturity status
- previousPublishDate: "2012-01-12",
- previousMaturity: "ED",
- previousURI: "http://dev.w3.org/2011/webrtc/editor/webrtc-20120530.html",
+ // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
+ // and its maturity status
+ previousMaturity: "ED",
+ previousURI: "http://dev.w3.org/2011/webrtc/editor/webrtc-20120720.html",
- // if there a publicly available Editor's Draft, this is the link
- edDraftURI: "http://dev.w3.org/2011/webrtc/editor/webrtc.html",
+ // if there a publicly available Editor's Draft, this is the link
+ edDraftURI: "http://dev.w3.org/2011/webrtc/editor/webrtc.html",
- // if this is a LCWD, uncomment and set the end of its review period
- // lcEnd: "2009-08-05",
+ // if this is a LCWD, uncomment and set the end of its review period
+ // lcEnd: "2009-08-05",
- // if you want to have extra CSS, append them to this list
- // it is RECOMMENDED that the respec.css stylesheet be kept
+ // if you want to have extra CSS, append them to this list
+ // it is RECOMMENDED that the respec.css stylesheet be kept
// extraCSS: ["ReSpec.js/css/respec.css"],
- // extraCSS: ["../../../2009/dap/ReSpec.js/css/respec.css"],
-
- // editors, add as many as you like
- // only "name" is REQUIRED
- editors: [
- // { name: "Your Name", url: "http://example.org/",
- // company: "Your Company", companyURL: "http://example.com/" },
- { name: "Adam Bergkvist", company: "Ericsson" },
- { name: "Daniel C. Burnett", company: "Voxeo" },
- { name: "Cullen Jennings", company: "Cisco" },
- { name: "Anant Narayanan", company: "Mozilla" },
- ],
+ // extraCSS: ["../../../2009/dap/ReSpec.js/css/respec.css"],
- // authors, add as many as you like.
- // This is optional, uncomment if you have authors as well as editors.
- // only "name" is REQUIRED. Same format as editors.
+ // editors, add as many as you like
+ // only "name" is REQUIRED
+ editors: [
+ // { name: "Your Name", url: "http://example.org/",
+ // company: "Your Company", companyURL: "http://example.com/" },
+ { name: "Adam Bergkvist", company: "Ericsson" },
+ { name: "Daniel C. Burnett", company: "Voxeo" },
+ { name: "Cullen Jennings", company: "Cisco" },
+ { name: "Anant Narayanan", company: "Mozilla" },
+ ],
- //authors: [
- // { name: "Your Name", url: "http://example.org/",
- // company: "Your Company", companyURL: "http://example.com/" },
- // { name: "Cullen Jennings", company: "Cisco" },
- //],
-
- // name of the WG
- wg: "Web Real-Time Communications Working Group",
-
- // URI of the public WG page
- wgURI: "http://www.w3.org/2011/04/webrtc/",
-
- // name (without the @w3c.org) of the public mailing to which comments are due
- wgPublicList: "public-webrtc",
-
- // URI of the patent status for this WG, for Rec-track documents
- // !!!! IMPORTANT !!!!
- // This is important for Rec-track documents, do not copy a patent URI from a random
- // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
- // Team Contact.
- wgPatentURI: "http://www.w3.org/2004/01/pp-impl/47318/status",
- };
+ // authors, add as many as you like.
+ // This is optional, uncomment if you have authors as well as editors.
+ // only "name" is REQUIRED. Same format as editors.
+ //authors: [
+ // { name: "Your Name", url: "http://example.org/",
+ // company: "Your Company", companyURL: "http://example.com/" }
+ //],
+
+ // name of the WG
+ wg: "Web Real-Time Communications Working Group",
+
+ // URI of the public WG page
+ wgURI: "http://www.w3.org/2011/04/webrtc/",
+
+ // name (without the @w3c.org) of the public mailing to which comments are due
+ wgPublicList: "public-webrtc",
+
+ // URI of the patent status for this WG, for Rec-track documents
+ // !!!! IMPORTANT !!!!
+ // This is important for Rec-track documents, do not copy a patent URI from a random
+ // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
+ // Team Contact.
+ wgPatentURI: "http://www.w3.org/2004/01/pp-impl/47318/status",
+};
Received on Monday, 13 August 2012 19:14:26 UTC