4.1.20. onicecandidate Event (Événement onicecandidate)

4.1.20. onicecandidate Event (Événement onicecandidate)

L'événement onicecandidate est envoyé à l'application dans deux situations: (1) lorsque l'agent ICE a découvert un nouveau candidat ICE local autorisé pendant la collecte ICE, comme indiqué dans la Section 3.5.1 et sous réserve des restrictions discutées dans la Section 3.5.3, ou (2) lorsqu'une phase de collecte ICE se termine. L'événement contient un seul objet IceCandidate, tel que défini dans la Section 3.5.2.1.

Dans le premier cas, le candidat nouvellement découvert est reflété dans l'objet IceCandidate, et tous ses champs DOIVENT être non nuls. Ce candidat sera également ajouté à la description locale actuelle et/ou en attente conformément aux règles définies pour Trickle ICE.

Dans le second cas, l'objet IceCandidate de l'événement DOIT avoir son champ candidat défini sur null pour indiquer que la phase de collecte actuelle est terminée, c'est-à-dire qu'il n'y aura plus d'événements onicecandidate dans cette phase. Cependant, le champ ufrag de l'IceCandidate DOIT être spécifié pour indiquer quelle génération de candidats ICE se termine. L'index de section "m=" et les champs MID de l'IceCandidate PEUVENT être spécifiés pour indiquer que l'événement s'applique à une section "m=" spécifique, ou définis sur null pour indiquer qu'il s'applique à toutes les sections "m=" dans la génération de candidats ICE actuelle. Cet événement peut être utilisé par l'application pour générer une indication de fin de candidats, telle que définie dans [RFC8838], Section 13.