diff options
Diffstat (limited to 'files/es/web/api/rtcpeerconnection/cantrickleicecandidates/index.html')
-rw-r--r-- | files/es/web/api/rtcpeerconnection/cantrickleicecandidates/index.html | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/files/es/web/api/rtcpeerconnection/cantrickleicecandidates/index.html b/files/es/web/api/rtcpeerconnection/cantrickleicecandidates/index.html new file mode 100644 index 0000000000..d455433b6c --- /dev/null +++ b/files/es/web/api/rtcpeerconnection/cantrickleicecandidates/index.html @@ -0,0 +1,87 @@ +--- +title: RTCPeerConnection.canTrickleIceCandidates +slug: Web/API/RTCPeerConnection/canTrickleIceCandidates +translation_of: Web/API/RTCPeerConnection/canTrickleIceCandidates +--- +<div>{{APIRef("WebRTC")}}</div> + +<p><span class="seoSummary">La propiedad <strong>{{domxref("RTCPeerConnection")}}</strong> es de solo lectura <code><strong>canTrickleIceCandidates</strong></code> , </span>devuelve un <span class="seoSummary"> {{jsxref("Boolean")}} que indica si el par remoto puede aceptar o no <a href="https://tools.ietf.org/html/draft-ietf-mmusic-trickle-ice">candidatos ICE</a>.</span></p> + +<p><strong>ICE trickling</strong> is the process of continuing to send candidates after the initial offer or answer has already been sent to the other peer.</p> + +<p>This property is only set after having called {{domxref("RTCPeerConnection.setRemoteDescription()")}}. Ideally, your signaling protocol provides a way to detect trickling support, so that you don't need to rely on this property. A WebRTC browser will always support trickle ICE. If trickling isn't supported, or you aren't able to tell, you can check for a falsy value for this property and then wait until the value of {{domxref("RTCPeerConnection.iceGatheringState", "iceGatheringState")}} changes to <code>"completed"</code> before creating and sending the initial offer. That way, the offer contains all of the candidates.</p> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox notranslate"> var <em>canTrickle</em> = <em>RTCPeerConnection</em>.canTrickleIceCandidates;</pre> + +<h3 id="Value">Value</h3> + +<p>A {{jsxref("Boolean")}} that is <code>true</code> if the remote peer can accept trickled ICE candidates and <code>false</code> if it cannot. If no remote peer has been established, this value is <code>null</code>.</p> + +<div class="note"> +<p><strong>Note:</strong> This property's value is determined once the local peer has called {{domxref("RTCPeerConnection.setRemoteDescription()")}}; the provided description is used by the ICE agent to determine whether or not the remote peer supports trickled ICE candidates.</p> +</div> + +<h2 id="Example">Example</h2> + +<pre class="brush: js notranslate">var pc = new RTCPeerConnection(); +// The following code might be used to handle an offer from a peer when +// it isn't known whether it supports trickle ICE. +pc.setRemoteDescription(remoteOffer) + .then(_ => pc.createAnswer()) + .then(answer => pc.setLocalDescription(answer)) + .then(_ => + if (pc.canTrickleIceCandidates) { + return pc.localDescription; + } + return new Promise(r => { + pc.addEventListener('icegatheringstatechange', e => { + if (e.target.iceGatheringState === 'complete') { + r(pc.localDescription); + } + }); + }); + }) + .then(answer => sendAnswerToPeer(answer)) // signaling message + .catch(e => handleError(e)); + +pc.addEventListener('icecandidate', e => { + if (pc.canTrickleIceCandidates) { + sendCandidateToPeer(e.candidate); // signaling message + } +}); +</pre> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{ SpecName('WebRTC 1.0', '#dom-rtcpeerconnection-cantrickleicecandidates', 'RTCPeerConnection.canTrickleIceCandidates') }}</td> + <td>{{ Spec2('WebRTC 1.0') }}</td> + <td>Initial specification.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.RTCPeerConnection.canTrickleIceCandidates")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li><a href="/en-US/docs/Web/Guide/API/WebRTC">WebRTC</a></li> + <li>{{domxref("RTCPeerConnection.addIceCandidate()")}}</li> + <li><a href="/en-US/docs/Web/API/WebRTC_API/Session_lifetime">Lifetime of a WebRTC session</a></li> +</ul> |