RTCIceCandidate object

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The RTCIceCandidate object includes information relating to an ICE candidate.

Standards information

Dictionary of RTCIceCandidate members:

dictionary RTCIceCandidate {
	DOMString		foundation;
	unsigned long		priority;
	DOMString		ip;
	RTCIceProtocol		protocol;
	unsigned short		port;
	RTCIceCandidateType	type;
	RTCIceTcpCandidateType	tcpType;
	DOMString		relatedAddress = "";
	unsigned short		relatedPort;
 DOMString msMTurnSessionId;
};
Dictionary MemberTypeDescription
foundationDOMStringA unique identifier that allows ICE to correlate candidates that appear on multiple RTCIceTransports.
ipDOMStringThe IP address of the candidate.
msMTurnSessionIdDOMString
portunsigned shortThe port for the candidate.
priorityunsigned longThe assigned priority of the candidate (automatically populated by the browser).
protocolRTCIceProtocolThe protocol of the ICE candidate. Values can be UDP or TCP (examples and advantages).
ValueDescription
UDPA UDP candidate, as described in [RFC5245]. User Datagram Protocol is a connectionless protocol within TCP/IP that corresponds to the transport layer in the ISO/OSI reference model.
TCPA TCP candidate, as described in [RFC6544]. Transmission Control Protocol is a protocol used with the Internet Protocol (IP) to send data in the form of message units between computers over the Internet. TCP handles keeping track of the individual units of data (called packets) that a message is divided into for efficient routing through the Internet.

 

relatedAddressDOMStringFor candidates that are derived from others, such as relay or reflexive candidates, the relatedAddress refers to the candidate that these are derived from. For host candidates, the relatedAddress is set to the empty string.
relatedPortunsigned shortFor candidates that are derived from others, such as relay or reflexive candidates, the relatedPort refers to the host candidate that these are derived from. For host candidates, the relatedPort is null.
tcpTypeRTCIceTcpCandidateTypeThe type of ICE TCP candidate, as described in [RFC6544]. Browsers MUST gather active TCP candidates and only active TCP candidates. Servers and other endpoints MAY gather active, passive or S-O (simultaneous-open) candidates.
ValueDescription
activeAn active TCP candidate is one for which the transport will attempt to open an outbound connection but will not receive incoming connection requests.
passiveA passive TCP candidate is one for which the transport will receive incoming connection attempts but not attempt a connection.
soAn S-O candidate is one for which the transport will attempt to open a connection simultaneously with its peer.

 

typeRTCIceCandidateTypeThe type of the ICE candidate.
ValueDescription
hostA host candidate.
srflxA server reflexive candidate.
prflxA peer reflexive candidate.
relayA relay candidate.

 

 

EXAMPLE

{
	foundation: "contoso",
	priority: 7985354112,
	ip: "192.0.2.33",
	protocol: "udp",
	port: 10000,
	type: "host"
};

See also

RTCIceGatherer

 

 

Show: