diff --git a/index.html b/index.html index d734a15..d48c8cc 100644 --- a/index.html +++ b/index.html @@ -88,6 +88,7 @@

RTCIceGatherOptions Dictionary

dictionary RTCIceGatherOptions {
              RTCIceTransportPolicy     gatherPolicy;
              sequence<RTCIceServer> iceServers;
+             sequence<DOMString>? networkIds;
 };

Dictionary RTCIceGatherOptions Members

@@ -105,6 +106,13 @@

Dictionary RTCIceGatherOptions Members

provide default ICE servers, and applications can desire to restrict communications to the local LAN, iceServers need not be set.

+
networkIds of type sequence<DOMString>
+
+

If set and non-null, ICE gathering will be limited to the network + interfaces specfied by the network IDs (obtained by + calling getLocalCandidates().

+
@@ -118,8 +126,13 @@

Interface Definition

void start (RTCIceParameters remoteParameters, optional RTCIceRole role = "controlled"); void stop (); void addRemoteCandidate (RTCIceCandidate remoteCandidate); + void retainLocalCandidate (RTCIceCandidate localCandidate); + void removeLocalCandidate (RTCIceCandidate localCandidate); + sequence<RTCIceCandidatePair> getCandidatePairs(); + RTCIceTransport fork (); attribute EventHandler onerror; - attribute EventHandler onicecandidate; + attribute EventHandler onlocalcandidate; + attribute EventHandler onchecksent; };

Constructors

@@ -145,12 +158,18 @@

Attributes

"MUST">MUST be fired if an error occurs in the gathering of ICE candidates (such as if TURN credentials are invalid).

-
onicecandidate of type onlocalcandidate of type EventHandler

This event handler utilizes the event handler event type icecandidate.

+
onchecksent of type EventHandler
+
+

This event handler utilizes the event handler event type + icecheck. +

@@ -441,6 +460,275 @@

Methods

Return type: void +
removeLocalCandidate
+
+

Removes the given local candidate. This will trigger + the removal of all candidate pairs with the given local + candidate, the prevention of pairing with the given + local candidate, and prevention of any network activity + using the given local candidate.

+ + + + + + + + + + + + + + + + + +
ParameterTypeNullableOptionalDescription
localCandidateRTCIceCandidate✘✘
+
+ Return type: void +
+
+
retainLocalCandidate
+
+

Cause the RTCIceTransport to not automatically remove + the local candidate due to ICE pruning (such as when a + candidate pair with a different local candidate is + selected). But the local candidate may be removed if it + completely fails (such as a network interface going + away).

+ + + + + + + + + + + + + + + + + +
ParameterTypeNullableOptionalDescription
localCandidateRTCIceCandidate✘✘
+
+ Return type: void +
+
+
getCandidatePairs()
+
+

Return all the candidate pairs.

+
+ Return type: sequence<RTCIceCandidatePair> +
+
+
fork()
+
+

Create a new RTCIceTransport that is the same as if + constructor with a constructor except that the local ICE + candidates already in the existing RTCIceTransport are + shared with the new RTCIceTransport. Future calls to + gather() for either of the transports does not affect + the other (only the local candidates from before the + fork are shared).

+
+ Return type: RTCIceTransport +
+
+ +
+ + +
+

Interface Definition

+
+ 
[Exposed=Window]
+partial interface RTCIceCandidate {
+    readonly        attribute DOMString? networkId;
+    // TODO: Add reference to https://wicg.github.io/netinfo/#dom-networkinformation
+    readonly        attribute NetworkInformation? networkInfo;
+};
+
+

Attributes

+
+
networkId of type DOMString
+
+ An ID of the network interface for use in gathering + options. It needs to be unique enough to fulfill that + purpose, but otherwise the value is not significant. +
+
networkInfo of type NetworkInformation
+
+ Information about the network interface. +
+
+
+
+
+
+

Interface Definition

+
+ 
[Exposed=Window]
+// TODO: Change RTCIceCandidatePair to an interface in WebRTC 1.0, or rename this.
+partial interface RTCIceCandidatePair {
+    void setMinCheckInterval(double seconds);
+    void setFrozen(bool frozen);
+    void select();
+    Promise nominate();
+    Promise waitForReceiveTimeout(double seconds);	    
+};
+
+

Methods

+
+
setMinCheckInterval
+
+

Causes the RTCIceTransport to send ICE checks using + this candidate pair no more frequently than indicated by + the given interval (given in seconds). The + RTCIceTransport may always send less frequently than + specified.

+ + + + + + + + + + + + + + + + + +
ParameterTypeNullableOptionalDescription
secondsdouble✘✘
+
+ Return type: void +
+
+
setFrozen
+
+

Freezes or unfreezes the candidate pair. When frozen, + no ICE checks will be sent over it.

+ + + + + + + + + + + + + + + + + +
ParameterTypeNullableOptionalDescription
frozenboolean✘✘
+
+ Return type: void +
+
+
select
+
+

Selects the candidate pair. Once this is called + once, the RTCIceTransport will no longer automatically + select candidate pairs and the only way to change the + selected candidate pair will be calling select() again + will change the selected candidate pair again.

+
+ Return type: void +
+
+
nominate
+
+

Nominates the candidate pair by sending a nomination + to the remote side. Resolves the returned promise once + the nomination has been sent or once it has been + determined that it is impossible to nominate (for + example, if aggressive nomination and renomination are + both unavailable due to the ICE options and a nomination + has already been sent.

+
+ Return type: Promise<boolean> +
+
+
waitForReceiveTimeout
+
+

Wait until no network pacekts have been received for + more than the given timeout. This allows the detection + of network outage. If called a second time on the same + RTCIceTransport, the previous call's promise is rejected + immediately. Thus, only one pending wait per + IceTransport is allowed at a time.

+ + + + + + + + + + + + + + + + + +
ParameterTypeNullableOptionalDescription
secondsdouble✘✘
+
+ Return type: void +
+
+
+
+
+
+

Interface Definition

+
+ 
[Exposed=Window]
+interface RTCIceCheck {
+    readonly        attribute Promise response;
+};
+
+

Attributes

+
+
response of type boolean
+
+ A promise that resolves when the RTCIceTransport + receives a response to the check. Resolves with a true + value if the response is successful and false if the + response was an error. +
@@ -523,6 +811,12 @@

Event summary

A new RTCIceCandidate is made available to the script. + + icehceck + RTCIceCheckEvent + A new RTCIceChecke is made available to the + script. +