RTCPeerConnection.restartIce()

WebRTC API의 RTCPeerConnection (en-US) 인터페이스에서는 restartIce() 메소드를 제공해서 연결의 양쪽에서 ICE candidate의 재수집 요청을 간단하게 할 수 있게 만들어줍니다.

restartIce()가 반환을 한 뒤에는, offer가 시그널링 메커니즘을 통해 전달되고, 원격 피어가 받은 offer를 description으로 설정을 하게 됩니다.이 과정이 완료되면, createOffer() (en-US)에 대한 다음 호출로 반환된 offer가 로컬 피어 (로컬로 설정이 된 경우)와 원격 피어에서 ICE 재시작을 발생시키도록 설정됩니다.

restartIce()는 RTCPeerConnection에 대한 negotiationneeded (en-US) 이벤트를 발생시켜서 어플리케이션이 신호 채널을 통해서 협상을 수행하도록 합니다.

만약 협상이 롤백 현상이나 수신받은 offer가 이미 협상 중으로 인해 실패하게되면, RTCPeerConnection (en-US)가 ICE 재시작 요청을 했다는 것을 자동으로 기억합니다. 다음번에 연결의 signalingState (en-US)가 stable로 바뀌게되면, 연결 인터페이스가 negotiationneeded (en-US) 이벤트를 발생시킵니다. 이 과정은 ICE 재시작 과정이 온전히 완료될 때까지 반복됩니다.

RTCPeerConnection.restartIce();

pc.addEventListener("iceconnectionstatechange", (event) => {
  if (pc.iceConnectionState === "failed") {
    /* possibly reconfigure the connection in some way here */
    /* then request ICE restart */
    pc.restartIce();
  }
});