RTCPeerConnection: свойство signalingState

Чтение только свойство signalingState интерфейса RTCPeerConnection возвращает строковое значение, описывающее состояние процесса сигнализации на локальном конце соединения во время подключения или повторного подключения к другому узлу. См. Сигнализацию на странице жизненного цикла сеанса WebRTC.

Поскольку процесс сигнализации представляет собой конечный автомат, возможность проверки того, что ваш код находится в ожидаемом состоянии при получении сообщений, может помочь избежать неожиданных и предотвратимых сбоев. Например, если вы получаете ответ, а signalingState не находится в состоянии "have-local-offer", вы знаете, что что-то не так, так как вы должны получать ответы только после создания предложения, но до получения ответа и передачи его в RTCPeerConnection.setLocalDescription(). Ваш код будет более надежным, если вы будете следить за несоответствиями состояний и обрабатывать их надлежащим образом.

Это значение также может быть полезным во время отладки.

Кроме того, при изменении значения этого свойства событие signalingstatechange отправляется экземпляру RTCPeerConnection.

Допустимые строковые значения:

stable

Нет текущего обмена предложениями и ответами. Это может означать, что объект RTCPeerConnection новый, в этом случае и localDescription, и remoteDescription имеют значение null; это также может означать, что согласование завершено и соединение установлено.

have-local-offer

Локальный узел вызвал RTCPeerConnection.setLocalDescription(), передав SDP, представляющий предложение (обычно созданное вызовом RTCPeerConnection.createOffer()), и предложение было успешно применено.

have-remote-offer

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

have-local-pranswer

Предложение, отправленное удаленным узлом, было применено, и был создан ответ (обычно вызовом RTCPeerConnection.createAnswer()) и применён вызовом RTCPeerConnection.setLocalDescription(). Этот предварительный ответ описывает поддерживаемые форматы медиа и т. д., но может не содержать полный набор кандидатов ICE. Дополнительные кандидаты будут доставлены отдельно позже.

have-remote-pranswer

Предварительный ответ был получен и успешно применён в ответ на предложение, ранее отправленное и установленное вызовом setLocalDescription().

closed

RTCPeerConnection был закрыт.

• Жизненный цикл сеанса WebRTC
• RTCPeerConnection
• signalingstatechange
• WebRTC