[giow] (0) Allow UAs to rate-control udp data streams. Also, add note…

…s about adding binary support for this API

git-svn-id: http://svn.whatwg.org/webapps@6160 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

@@ -74758,7 +74758,7 @@ <h3 id=peer-to-peer-connections><span class=secno>9.4 </span>Peer-to-peer connec
   const unsigned short <a href=#dom-peerconnection-closed title=dom-PeerConnection-CLOSED>CLOSED</a> = 3;
   readonly attribute unsigned short <a href=#dom-peerconnection-readystate title=dom-PeerConnection-readyState>readyState</a>;
 
-  void <a href=#dom-peerconnection-send title=dom-PeerConnection-send>send</a>(in DOMString text);
+  void <a href=#dom-peerconnection-send title=dom-PeerConnection-send>send</a>(in DOMString text); <!-- v2: binary -->
   void <a href=#dom-peerconnection-addstream title=dom-PeerConnection-addStream>addStream</a>(in <a href=#stream>Stream</a> stream);
   void <a href=#dom-peerconnection-removestream title=dom-PeerConnection-removeStream>removeStream</a>(in <a href=#stream>Stream</a> stream);
   readonly attribute <a href=#stream>Stream</a>[] <a href=#dom-peerconnection-localstreams title=dom-PeerConnection-localStreams>localStreams</a>;
@@ -74873,7 +74873,7 @@ <h3 id=peer-to-peer-connections><span class=secno>9.4 </span>Peer-to-peer connec
 
    <dt><var title="">connection</var> . <code title=dom-PeerConnection-send><a href=#dom-peerconnection-send>send</a></code>(<var title="">text</var>)</dt>
 
-   <dd>
+   <dd> <!-- v2: binary -->
 
     <p>Attempts to send the given text to the remote peer. This uses
     UDP, which is inherently unreliable; there is no guarantee that
@@ -75303,7 +75303,7 @@ <h3 id=peer-to-peer-connections><span class=secno>9.4 </span>Peer-to-peer connec
   <p>When the <dfn id=dom-peerconnection-send title=dom-PeerConnection-send><code title="">send()</code></dfn> method is invoked, the
   user agent must run the following steps:</p>
 
-  <ol><li><p>Let <var title="">message</var> be the method's first
+  <ol><!-- v2: binary --><li><p>Let <var title="">message</var> be the method's first
    argument.</li>
 
    <li><p>If the <code><a href=#peerconnection>PeerConnection</a></code> object's
@@ -75324,6 +75324,11 @@ <h3 id=peer-to-peer-connections><span class=secno>9.4 </span>Peer-to-peer connec
    not an <a href=#active-data-udp-media-stream>active data UDP media stream</a>, abort these
    steps. No message is sent.</li>
 
+   <li><p>If the user agent is rate-limiting packets sent using this
+   API, and sending the data packet at this time would exceed the
+   limit, then abort these steps. User agents may report this to the
+   user, e.g. in a development console.</li>
+
    <li><p><a href=#transmit-a-data-packet-to-a-peer>Transmit a data packet to a peer</a> using the
    <code><a href=#peerconnection>PeerConnection</a></code>'s <a href=#peerconnection-data-udp-media-stream><code>PeerConnection</code>
    data UDP media stream</a> with <var title="">data</var> as the
@@ -75593,7 +75598,7 @@ <h3 id=the-data-stream><span class=secno>9.5 </span>The data stream</h3>
   stream</a> is received, the user agent must run the following
   steps:</p>
 
-  <ol><li><p>Let <var title="">hashed masked message with nonce</var> be the UDP
+  <ol><!-- v2: binary --><li><p>Let <var title="">hashed masked message with nonce</var> be the UDP
    packet's data.</li>
 
    <li><p>If <var title="">hashed masked message with nonce</var> is

index

@@ -74773,7 +74773,7 @@ interface <dfn id=peerconnection>PeerConnection</dfn> {
   const unsigned short <a href=#dom-peerconnection-closed title=dom-PeerConnection-CLOSED>CLOSED</a> = 3;
   readonly attribute unsigned short <a href=#dom-peerconnection-readystate title=dom-PeerConnection-readyState>readyState</a>;
 
-  void <a href=#dom-peerconnection-send title=dom-PeerConnection-send>send</a>(in DOMString text);
+  void <a href=#dom-peerconnection-send title=dom-PeerConnection-send>send</a>(in DOMString text); <!-- v2: binary -->
   void <a href=#dom-peerconnection-addstream title=dom-PeerConnection-addStream>addStream</a>(in <a href=#stream>Stream</a> stream);
   void <a href=#dom-peerconnection-removestream title=dom-PeerConnection-removeStream>removeStream</a>(in <a href=#stream>Stream</a> stream);
   readonly attribute <a href=#stream>Stream</a>[] <a href=#dom-peerconnection-localstreams title=dom-PeerConnection-localStreams>localStreams</a>;
@@ -74888,7 +74888,7 @@ interface <dfn id=signalingcallback>SignalingCallback</dfn> {
 
    <dt><var title="">connection</var> . <code title=dom-PeerConnection-send><a href=#dom-peerconnection-send>send</a></code>(<var title="">text</var>)</dt>
 
-   <dd>
+   <dd> <!-- v2: binary -->
 
     <p>Attempts to send the given text to the remote peer. This uses
     UDP, which is inherently unreliable; there is no guarantee that
@@ -75318,7 +75318,7 @@ interface <dfn id=signalingcallback>SignalingCallback</dfn> {
   <p>When the <dfn id=dom-peerconnection-send title=dom-PeerConnection-send><code title="">send()</code></dfn> method is invoked, the
   user agent must run the following steps:</p>
 
-  <ol><li><p>Let <var title="">message</var> be the method's first
+  <ol><!-- v2: binary --><li><p>Let <var title="">message</var> be the method's first
    argument.</li>
 
    <li><p>If the <code><a href=#peerconnection>PeerConnection</a></code> object's
@@ -75339,6 +75339,11 @@ interface <dfn id=signalingcallback>SignalingCallback</dfn> {
    not an <a href=#active-data-udp-media-stream>active data UDP media stream</a>, abort these
    steps. No message is sent.</li>
 
+   <li><p>If the user agent is rate-limiting packets sent using this
+   API, and sending the data packet at this time would exceed the
+   limit, then abort these steps. User agents may report this to the
+   user, e.g. in a development console.</li>
+
    <li><p><a href=#transmit-a-data-packet-to-a-peer>Transmit a data packet to a peer</a> using the
    <code><a href=#peerconnection>PeerConnection</a></code>'s <a href=#peerconnection-data-udp-media-stream><code>PeerConnection</code>
    data UDP media stream</a> with <var title="">data</var> as the
@@ -75608,7 +75613,7 @@ local.onaddstream = function (event) {
   stream</a> is received, the user agent must run the following
   steps:</p>
 
-  <ol><li><p>Let <var title="">hashed masked message with nonce</var> be the UDP
+  <ol><!-- v2: binary --><li><p>Let <var title="">hashed masked message with nonce</var> be the UDP
    packet's data.</li>
 
    <li><p>If <var title="">hashed masked message with nonce</var> is

source

@@ -85499,7 +85499,7 @@ interface <dfn>PeerConnection</dfn> {
   const unsigned short <span title="dom-PeerConnection-CLOSED">CLOSED</span> = 3;
   readonly attribute unsigned short <span title="dom-PeerConnection-readyState">readyState</span>;
 
-  void <span title="dom-PeerConnection-send">send</span>(in DOMString text);
+  void <span title="dom-PeerConnection-send">send</span>(in DOMString text); <!-- v2: binary -->
   void <span title="dom-PeerConnection-addStream">addStream</span>(in <span>Stream</span> stream);
   void <span title="dom-PeerConnection-removeStream">removeStream</span>(in <span>Stream</span> stream);
   readonly attribute <span>Stream</span>[] <span title="dom-PeerConnection-localStreams">localStreams</span>;
@@ -85629,7 +85629,7 @@ interface <dfn>SignalingCallback</dfn> {
 
    <dt><var title="">connection</var> . <code title="dom-PeerConnection-send">send</code>(<var title="">text</var>)</dt>
 
-   <dd>
+   <dd> <!-- v2: binary -->
 
     <p>Attempts to send the given text to the remote peer. This uses
     UDP, which is inherently unreliable; there is no guarantee that
@@ -86142,7 +86142,7 @@ interface <dfn>SignalingCallback</dfn> {
   title="">send()</code></dfn> method is invoked, the
   user agent must run the following steps:</p>
 
-  <ol>
+  <ol> <!-- v2: binary -->
 
    <li><p>Let <var title="">message</var> be the method's first
    argument.</p></li>
@@ -86166,6 +86166,11 @@ interface <dfn>SignalingCallback</dfn> {
    not an <span>active data UDP media stream</span>, abort these
    steps. No message is sent.</p></li>
 
+   <li><p>If the user agent is rate-limiting packets sent using this
+   API, and sending the data packet at this time would exceed the
+   limit, then abort these steps. User agents may report this to the
+   user, e.g. in a development console.</p></li>
+
    <li><p><span>Transmit a data packet to a peer</span> using the
    <code>PeerConnection</code>'s <span><code>PeerConnection</code>
    data UDP media stream</span> with <var title="">data</var> as the
@@ -86490,7 +86495,7 @@ local.onaddstream = function (event) {
   stream</span> is received, the user agent must run the following
   steps:</p>
 
-  <ol>
+  <ol> <!-- v2: binary -->
 
    <li><p>Let <var title="">hashed masked message with nonce</var> be the UDP
    packet's data.</p></li>