TsgcICEClient › Methods › ProcessCandidates

ProcessCandidates Method

Runs ICE connectivity checks against the queued candidate pairs and nominates the first pair that succeeds.

Syntax

procedure ProcessCandidates;

Remarks

Starts the ICE connectivity-check phase (RFC 8445 section 6). The agent walks the ordered check list built from local candidates (gathered by GatherCandidates) and remote candidates (added through AddRTCIceCandidate), sending STUN binding requests over each pair. Incoming binding requests are reported via OnICEReceiveBindingRequest; peer responses trigger either OnICECandidatePairNominated (pair validated and selected for media) or OnICECandidatePairFailed.

Pacing, retransmission and the maximum number of active pairs are bounded by ICEOptions.CheckList.MaxCandidatePairs. Call the method once both sides have exchanged candidates; with trickle ICE you may also call it each time new remote candidates arrive.

Example

oICE.OnICECandidatePairNominated := OnPairNominated;
oICE.OnICECandidatePairFailed    := OnPairFailed;
oICE.ProcessCandidates;

Back to Methods