RTCPeerConnection: iceGatheringState プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。
iceGatheringState は RTCPeerConnection インターフェイスの読み取り専用プロパティで、この接続の ICE 集合状態全体を説明する文字列を返します。
これにより、例えば、ICE 候補の集合が完了したタイミングを検知することができます。
このプロパティの値が変更されたことを検知するには、icegatheringstatechange 型のイベントを監視します。
なお、iceGatheringState は、全接続におけるすべての RTCRtpSender と RTCRtpReceiver が使用する RTCIceTransport をすべて含む、接続全体の収集状態を表します。
この状態に対し、RTCIceTransport.gatheringState は、単一のトランスポートの収集状態を表します。