RTCPeerConnection: событие negotiationneeded

Событие negotiationneeded отправляется в RTCPeerConnection, когда требуется переговор для подключения через канал сигнализации. Это происходит как при первоначальной настройке соединения, так и в любой момент, когда изменения в среде связи требуют повторной настройки соединения.

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

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

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

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

onnegotiationneeded = (event) => {};

Общее событие Event.

В этом примере мы используем addEventListener() для создания обработчика событий negotiationneeded. Его задача — создать предложение SDP и отправить его через канал сигнализации удалённому узлу.

pc.addEventListener(
  "negotiationneeded",
  (ev) => {
    pc.createOffer()
      .then((offer) => pc.setLocalDescription(offer))
      .then(() =>
        sendSignalingMessage({
          type: "video-offer",
          sdp: pc.localDescription,
        }),
      )
      .catch((err) => {
        // handle error
      });
  },
  false,
);

После создания предложения локальный конец настраивается с помощью вызова RTCPeerConnection.setLocalDescription(); затем сообщение сигнализации создаётся и отправляется удалённому узлу через сервер сигнализации, чтобы поделиться этим предложением с другим узлом. Другой узел должен распознать это сообщение и последовать за ним, создав собственный RTCPeerConnection, установив удалённое описание с помощью setRemoteDescription(), а затем создав ответ, который нужно будет отправить предложению.

Вы также можете установить обработчик событий negotiationneeded, назначив функцию обработчика события свойству onnegotiationneeded:

pc.onnegotiationneeded = (ev) => {
  pc.createOffer()
    .then((offer) => pc.setLocalDescription(offer))
    .then(() =>
      sendSignalingMessage({
        type: "video-offer",
        sdp: pc.localDescription,
      }),
    )
    .catch((err) => {
      // handle error
    });
};

Более подробный пример см. в Начало переговоров.

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