[html5] r6160 - [giow] (0) Allow UAs to rate-control udp data streams. Also, add notes about add [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue May 31 13:32:16 PDT 2011
Author: ianh
Date: 2011-05-31 13:32:14 -0700 (Tue, 31 May 2011)
New Revision: 6160
Modified:
complete.html
index
source
Log:
[giow] (0) Allow UAs to rate-control udp data streams. Also, add notes about adding binary support for this API
Modified: complete.html
===================================================================
--- complete.html 2011-05-31 20:01:59 UTC (rev 6159)
+++ complete.html 2011-05-31 20:32:14 UTC (rev 6160)
@@ -74758,7 +74758,7 @@
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 @@
<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 @@
<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 @@
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 @@
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
Modified: index
===================================================================
--- index 2011-05-31 20:01:59 UTC (rev 6159)
+++ index 2011-05-31 20:32:14 UTC (rev 6160)
@@ -74773,7 +74773,7 @@
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 @@
<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 @@
<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 @@
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 @@
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
Modified: source
===================================================================
--- source 2011-05-31 20:01:59 UTC (rev 6159)
+++ source 2011-05-31 20:32:14 UTC (rev 6160)
@@ -85499,7 +85499,7 @@
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 @@
<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 @@
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 @@
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 @@
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>
More information about the Commit-Watchers
mailing list