The remote
property of the RTCIceCandidatePair
dictionary specifies the RTCIceCandidate
describing the configuration of the remote end of a viable WebRTC connection.
Syntax
remoteCandidate = RTCIceCandidatePair.remote;
Value
An RTCIceCandidate
which describes the configuration of the remote end of a viable pair of ICE candidates. The RTCIceCandidatePair
is returned by the RTCIceTransport
method getSelectedCandidatePair()
.
Example
This one-line example simply obtains the current candidate pair and then from that gets the remote candidate.
var candidatePair = pc.getSenders()[0].transport.transport.getSelectedCandidatePair(); var remoteCandidate = candidatePair.remote;
The RTCIceTransport
is found by getting the list of RTCRtpSender
objects for the RTCPeerConnection
pc
. In the first RTCRtpSender
, we get the RTCDtlsTransport
over which the media data is being transmitted and finally, from that, the RTCIceTransport
.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidatePair.remote' in that specification. |
Candidate Recommendation | Initial specification. |
Browser compatibility
No compatibility data found. Please contribute data for "api.RTCIceCandidatePair.remote" (depth: 1) to the MDN compatibility data repository.