RTCPeerConnection: событие icegatheringstatechange

Событие icegatheringstatechange отправляется обработчику событий onicegatheringstatechange на объекте RTCPeerConnection, когда изменяется состояние процесса сбора кандидатов ICE. Это означает, что изменилось значение свойства соединения iceGatheringState.

Когда ICE начинает сбор кандидатов соединения, значение меняется с new на gathering, чтобы указать, что начался процесс сбора конфигураций кандидатов для соединения. Когда значение меняется на complete, все транспортные средства, составляющие RTCPeerConnection, завершили сбор кандидатов ICE.

Это событие не отменяется и не распространяется.

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика событий.

addEventListener("icegatheringstatechange", (event) => {});

onicegatheringstatechange = (event) => {};

Общее Event.

В этом примере создаётся обработчик событий icegatheringstatechange.

pc.onicegatheringstatechange = (ev) => {
  let connection = ev.target;

  switch (connection.iceGatheringState) {
    case "gathering":
      /* collection of candidates has begun */
      break;
    case "complete":
      /* collection of candidates is finished */
      break;
  }
};

Аналогично, можно использовать addEventListener() для добавления обработчика событий icegatheringstatechange:

pc.addEventListener(
  "icegatheringstatechange",
  (ev) => {
    let connection = ev.target;

    switch (connection.iceGatheringState) {
      case "gathering":
        // collection of candidates has begun
        break;
      case "complete":
        // collection of candidates is finished
        break;
    }
  },
  false,
);

• API WebRTC
• Сигнальные сообщения и видеозвонки
• Подключение WebRTC
• Срок действия сеанса WebRTC