This article needs a technical review. How you can help.
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The RTCIceCandidate interface of the the WebRTC API represents a candidate internet connectivity establishment (ICE) server for establishing an RTCPeerConnection.
Constructors
RTCIceCandidate()- Creates an
RTCIceCandidateobject.
Properties
RTCIceCandidate.candidateRead only- Returns a transport address for the candidate that can be used for connectivity checks. The format of this address is a
candidate-attributeas defined in RTC 5245. RTCIceCandidate.foundationRead only- Returns a unique identifier that allows ICE to correlate candidates that appear on multiple
RTCIceTransportobjects. RTCIceCandidate.ipRead only- Returns the IP address of the candidate.
RTCIceCandidate.portRead only- Returns the port of the candidate.
RTCIceCandidate.priorityRead only- Returns the assigned priority of the candidate.
RTCIceCandidate.protocolRead only- Returns the protocol used by the candidate, either udp or tcp.
RTCIceCandidate.relatedAddressRead only- For a candidate that is derived from another, such as a relay or reflexive candidate, the
relatedAddressis the IP address of the candidate that it is derived from. For host candidates, therelatedAddressisnull. RTCIceCandidate.relatedPortRead only- For a candidate that is derived from another, such as a relay or reflexive candidate, the
relatedPortis the port of the candidate that it is derived from. For host candidates, therelatedPortisnull. RTCIceCandidate.sdpMidRead only- If not
null, this contains the identifier of the "media stream identification" (as defined in RFC 5888) for the media component this candidate is associated with. RTCIceCandidate.sdpMLineIndexRead only- If not
null, this indicates the index (starting at zero) of the media description (as defined in RFC 4566) in the SDP this candidate is associated with. RTCIceCandidate.tcpTypeRead only- If
protocolistcp,tcpTyperepresents the type of TCP candidate. Otherwise,tcpTypeisnull. RTCIceCandidate.typeRead only- One of
host,srflx,prflx, orrelay.
Specifications
| Specification | Status | Comment |
|---|---|---|
| WebRTC 1.0: Real-time Communication Between Browser | Working Draft | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | (Yes) |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | (Yes) |