RTCPeerConnection: свойство iceGatheringState

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

Свойство iceGatheringState только для чтения интерфейса RTCPeerConnection возвращает строку, описывающую общее состояние сбора ICE для этого соединения. Это позволяет, например, определить, когда сбор ICE-кандидатов завершен.

Вы можете отслеживать изменения значения этого свойства, наблюдая за событием типа icegatheringstatechange.

Обратите внимание, что iceGatheringState представляет собой общее состояние сбора соединения, включая каждый RTCIceTransport, используемый каждым RTCRtpSender и каждым RTCRtpReceiver во всем соединении. Это контрастирует с RTCIceTransport.gatheringState, которое представляет состояние сбора для одного транспорта.

Значение

Возможные значения:

new: Соединение peer было только что создано и еще не выполнило никаких сетевых операций.
gathering: Агент ICE находится в процессе сбора кандидатов для соединения.
complete: Агент ICE завершил сбор кандидатов. Если происходит что-то, что требует сбора новых кандидатов, например, добавление нового интерфейса или нового ICE-сервера, состояние вернется к gathering для сбора этих кандидатов.

Пример

const pc = new RTCPeerConnection();
const state = pc.iceGatheringState;

Спецификации

Спецификация
WebRTC: Реальное общение в браузерах # dom-peerconnection-ice-gathering-state

Совместимость браузеров

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`iceGatheringState`	25	15	22	15	11	25	24	14	11	1.5	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/iceGatheringState