A selectedcandidatepairchange
event is sent to an RTCIceTransport
when the ICE agent selects a new pair of candidates that describe the endpoints of a viable connection. The pair of candidates is in turn described by an RTCIceCandidatePair
object which contains one RTCIceCandidate
representing the local end of the connection, and another representing the remote end of the connection.
Together, the candidates can be used to establish a connection to be used by the RTCIceTransport
, and, by extension, by an RTCPeerConnection
.
Bubbles | No |
---|---|
Cancelable | No |
Interface | Event |
Event handler property | onselectedcandidatepairchange |
Examples
This example creates an event handler for selectedcandidatepairchange
that updates a display providing the user information about the progress of the ICE negotiation for an RTCPeerConnection
called pc
.
let iceTransport = pc.getSenders[0].transport.iceTransport; let localProtoElem = document.getElementById("local-protocol"); let remoteProtoElem = document.getElementById("remote-protocol"); iceTransport.addEventListener("selectedcandidatepairchange", ev => { let pair = iceTransport.getSelectedCandidatePair(); localProtoElem.innerText = pair.local.protocol.toUpperCase(); remoteProtoElem.innerText = pair.remote.protocol.toUpperCase(); }, false)
This can also be done by setting the onselectedcandidatepairchange
event handler property directly.
let iceTransport = pc.getSenders[0].transport.iceTransport; let localProtoElem = document.getElementById("local-protocol"); let remoteProtoElem = document.getElementById("remote-protocol"); iceTransport.onselectedcandidatepairchange = ev => { let pair = iceTransport.getSelectedCandidatePair(); localProtoElem.innerText = pair.local.protocol.toUpperCase(); remoteProtoElem.innerText = pair.remote.protocol.toUpperCase(); }
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'selectedcandidatepairchange' in that specification. |
Candidate Recommendation |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
selectedcandidatepairchange event | Chrome No support No | Edge No support No | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- No support
- No support