4.1.20. onicecandidate Event (onicecandidate-Ereignis)

4.1.20. onicecandidate Event (onicecandidate-Ereignis)

Das onicecandidate-Ereignis wird in zwei Situationen an die Anwendung gesendet: (1) wenn der ICE-Agent während der ICE-Sammlung einen neuen zulässigen lokalen ICE-Kandidaten entdeckt hat, wie in Abschnitt 3.5.1 beschrieben und unter Berücksichtigung der in Abschnitt 3.5.3 diskutierten Einschränkungen, oder (2) wenn eine ICE-Sammelphase abgeschlossen ist. Das Ereignis enthält ein einzelnes IceCandidate-Objekt, wie in Abschnitt 3.5.2.1 definiert.

Im ersten Fall wird der neu entdeckte Kandidat im IceCandidate-Objekt widergespiegelt, und alle seine Felder MÜSSEN nicht null sein. Dieser Kandidat wird auch zur aktuellen und/oder ausstehenden lokalen Beschreibung gemäß den für Trickle ICE definierten Regeln hinzugefügt.

Im zweiten Fall MUSS das IceCandidate-Objekt des Ereignisses sein Kandidatenfeld auf null gesetzt haben, um anzuzeigen, dass die aktuelle Sammelphase abgeschlossen ist, d.h. es werden keine weiteren onicecandidate-Ereignisse in dieser Phase auftreten. Das ufrag-Feld des IceCandidate MUSS jedoch angegeben werden, um anzuzeigen, welche ICE-Kandidatengeneration endet. Der "m="-Abschnittsindex und die MID-Felder des IceCandidate KÖNNEN angegeben werden, um anzuzeigen, dass das Ereignis für einen bestimmten "m="-Abschnitt gilt, oder auf null gesetzt werden, um anzuzeigen, dass es für alle "m="-Abschnitte in der aktuellen ICE-Kandidatengeneration gilt. Dieses Ereignis kann von der Anwendung verwendet werden, um eine End-of-Candidates-Anzeige zu generieren, wie in [RFC8838], Abschnitt 13 definiert.