This structure describes an ICE candidate. ICE candidate is a transport address that is to be tested by ICE procedures in order to determine its suitability for usage for receipt of media. Candidates also have properties - their type (server reflexive, relayed or host), priority, foundation, and base.
IP address of this candidate. For host candidates, this represents the local address of the socket. For reflexive candidates, the value will be the public address allocated in NAT router for the host candidate and as reported in MAPPED-ADDRESS or XOR-MAPPED-ADDRESS attribute of STUN Binding request. For relayed candidate, the value will be the address allocated in the TURN server by STUN Allocate request.
Base address of this candidate. "Base" refers to the address an agent sends from for a particular candidate. For host candidates, the base is the same as the host candidate itself. For reflexive candidates, the base is the local IP address of the socket. For relayed candidates, the base address is the transport address allocated in the TURN server for this candidate.
The component ID of this candidate. Note that component IDs starts with one for RTP and two for RTCP. In other words, it's not zero based.
The foundation string, which is an identifier which value will be equivalent for two candidates that are of the same type, share the same base, and come from the same STUN server. The foundation is used to optimize ICE performance in the Frozen algorithm.
Local preference value, which typically is 65535.
The candidate's priority, a 32-bit unsigned value which value will be calculated by the ICE session when a candidate is registered to the ICE session.
Related address, which is used for informational only and is not used in any way by the ICE session.
Status of this candidate. The value will be PJ_SUCCESS if candidate address has been resolved successfully, PJ_EPENDING when the address resolution process is in progress, or other value when the address resolution has completed with failure.
Transport ID to be used to send packets for this candidate.
The documentation for this struct was generated from the following file: