4.1.20. onicecandidate Event (Evento onicecandidate)

4.1.20. onicecandidate Event (Evento onicecandidate)

L'evento onicecandidate viene inviato all'applicazione in due situazioni: (1) quando l'agente ICE ha scoperto un nuovo candidato ICE locale consentito durante la raccolta ICE, come delineato nella Sezione 3.5.1 e soggetto alle restrizioni discusse nella Sezione 3.5.3, o (2) quando una fase di raccolta ICE si completa. L'evento contiene un singolo oggetto IceCandidate, come definito nella Sezione 3.5.2.1.

Nel primo caso, il candidato appena scoperto è riflesso nell'oggetto IceCandidate e tutti i suoi campi DEVONO essere non nulli. Questo candidato verrà anche aggiunto alla descrizione locale corrente e/o in sospeso secondo le regole definite per Trickle ICE.

Nel secondo caso, l'oggetto IceCandidate dell'evento DEVE avere il suo campo candidate impostato su null per indicare che la fase di raccolta corrente è completa, cioè non ci saranno ulteriori eventi onicecandidate in questa fase. Tuttavia, il campo ufrag dell'IceCandidate DEVE essere specificato per indicare quale generazione di candidati ICE sta terminando. L'indice della sezione "m=" e i campi MID dell'IceCandidate POSSONO essere specificati per indicare che l'evento si applica a una sezione "m=" specifica, o impostati su null per indicare che si applica a tutte le sezioni "m=" nella generazione di candidati ICE corrente. Questo evento può essere utilizzato dall'applicazione per generare un'indicazione di fine candidati, come definito in [RFC8838], Sezione 13.