This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage 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 specification changes.
Draft
This page is not complete.
The RTCIceCandidate
interface of the the WebRTC API represents a candidate Internet Connectivity Establishment (ICE) server for establishing an RTCPeerConnection
.
Constructors
RTCIceCandidate()
- Creates an
RTCIceCandidate
object.
Properties
RTCIceCandidate.candidate
Read only- A
DOMString
representing the transport address for the candidate that can be used for connectivity checks. The format of this address is acandidate-attribute
as defined in RFC 5245. This string is empty (""
) if theRTCIceCandidate
represents a "end of candidates" indicator. RTCIceCandidate.foundation
Read only- Returns a unique identifier that allows ICE to correlate candidates that appear on multiple
RTCIceTransport
objects. RTCIceCandidate.ip
Read only- Returns the IP address of the candidate.
RTCIceCandidate.port
Read only- Returns the port of the candidate.
RTCIceCandidate.priority
Read only- Returns the assigned priority of the candidate.
RTCIceCandidate.protocol
Read only- Returns the protocol used by the candidate, either udp or tcp.
RTCIceCandidate.relatedAddress
Read only- For a candidate that is derived from another, such as a relay or reflexive candidate, the
relatedAddress
is the IP address of the candidate that it is derived from. For host candidates, therelatedAddress
isnull
. RTCIceCandidate.relatedPort
Read only- For a candidate that is derived from another, such as a relay or reflexive candidate, the
relatedPort
is the port of the candidate that it is derived from. For host candidates, therelatedPort
isnull
. RTCIceCandidate.sdpMid
Read 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.sdpMLineIndex
Read 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.tcpType
Read only- If
protocol
istcp
,tcpType
represents the type of TCP candidate. Otherwise,tcpType
isnull
. RTCIceCandidate.type
Read only- One of
host
,srflx
,prflx
, orrelay
.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidate' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 22 (22) |
Feature | Android | Android Webview | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|---|
Basic support | ? | (Yes) | (Yes) | (Yes) |