WebRTC: 브라우저에서의 실시간 통신

iceServers의 타입은 sequence<RTCIceServer>이며, 기본값은 []이다.

STUN 및 TURN 서버와 같이 ICE에서 사용할 수 있는 서버를 설명하는 객체 배열이다. ICE 서버 수가 구현에서 정의한 제한을 초과하면 임계값을 넘는 ICE 서버를 무시한다. 구현에서 정의한 이 제한은 최소 32여야 한다.

iceTransportPolicy의 타입은 RTCIceTransportPolicy이며, 기본값은 "all"이다.

ICE 에이전트가 사용할 수 있는 후보를 나타낸다.

bundlePolicy의 타입은 RTCBundlePolicy이며, 기본값은 "balanced"이다.

ICE 후보를 수집할 때 사용할 미디어 번들링 정책을 나타낸다.

rtcpMuxPolicy의 타입은 RTCRtcpMuxPolicy이며, 기본값은 "require"이다.

ICE 후보를 수집할 때 사용할 rtcp-mux 정책을 나타낸다.

certificates의 타입은 sequence<RTCCertificate>이며, 기본값은 []이다.

RTCPeerConnection이 인증에 사용하는 인증서 집합이다.

이 매개변수에 유효한 값은 generateCertificate() 함수를 호출하여 생성한다.

주어진 DTLS 연결은 하나의 인증서만 사용하지만 이 속성을 사용하면 호출자가 서로 다른 알고리즘을 지원하는 여러 인증서를 제공할 수 있다. 최종 인증서는 허용되는 인증서를 설정하는 DTLS 핸드셰이크를 기반으로 선택한다. RTCPeerConnection 구현은 주어진 연결에 사용할 인증서를 선택한다. 인증서 선택 방법은 이 명세의 범위를 벗어난다.

참고

기존 구현은 제공된 첫 번째 인증서만 사용하며 나머지는 무시한다.

이 값이 없으면 각 RTCPeerConnection 인스턴스에 대해 기본 인증서 집합을 생성한다.

이 옵션을 사용하면 애플리케이션이 키 연속성을 설정할 수 있다. RTCCertificate는 [INDEXEDDB]에 영구 저장하고 재사용할 수 있다. 영구 저장과 재사용은 키 생성 비용도 방지한다.

이 구성 옵션의 값은 처음 선택된 후에는 변경할 수 없다.

iceCandidatePoolSize의 타입은 octet이며, 기본값은 0이다.

[RFC9429] (제 3.5.4절 및 제 4.1.1절)에서 정의한 미리 가져온 ICE 풀의 크기이다.

urls의 타입은 (DOMString or sequence<DOMString>)이며, 필수이다.

[RFC7064] 및 [RFC7065]에서 정의한 STUN 또는 TURN URI나 기타 URI 타입이다.

username의 타입은 DOMString이다.

이 RTCIceServer 객체가 TURN 서버를 나타내는 경우 이 속성은 해당 TURN 서버에 사용할 사용자 이름을 지정한다.

credential의 타입은 DOMString이다.

이 RTCIceServer 객체가 TURN 서버를 나타내는 경우 이 속성은 해당 TURN 서버에 사용할 자격 증명을 지정한다.

credential은 [RFC5389] 제10.2절에 설명된 장기 인증 비밀번호를 나타낸다.

iceRestart의 타입은 boolean이며, 기본값은 false이다.

이 딕셔너리 멤버의 값이 true이거나 관련 RTCPeerConnection 객체의 [[LocalIceCredentialsToReplace]] 슬롯이 비어 있지 않으면 생성된 설명에는 현재 자격 증명 (currentLocalDescription 속성의 SDP에 표시됨)과 다른 ICE 자격 증명이 포함된다. 생성된 설명을 적용하면 [RFC5245] 제9.1.1.1절에 설명된 대로 ICE가 다시 시작된다.

이 딕셔너리 멤버의 값이 false이고 관련 RTCPeerConnection 객체의 [[LocalIceCredentialsToReplace]] 슬롯이 비어 있으며 currentLocalDescription 속성에 유효한 ICE 자격 증명이 있으면 생성된 설명에는 currentLocalDescription 속성의 현재 값과 동일한 ICE 자격 증명이 포함된다.

참고

iceConnectionState가 "failed"로 전이될 때 ICE를 다시 시작하는 것이 좋다. 애플리케이션은 추가로 iceConnectionState가 "disconnected"로 전이되는 것을 수신 대기한 다음 다른 정보 소스(예: getStats를 사용하여 다음 몇 초 동안 송수신된 바이트 수가 증가하는지 측정)를 이용해 ICE를 다시 시작하는 것이 적절한지 판단할 수 있다.

localDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

localDescription 속성은 [[PendingLocalDescription]]이 null이 아니면 이를 반드시 반환하고, 그렇지 않으면 [[CurrentLocalDescription]]을 반드시 반환해야 한다.

[[CurrentLocalDescription]].sdp와 [[PendingLocalDescription]].sdp는 대응하는 setLocalDescription 호출에 전달된 sdp 값과 문자열 단위로 동일하지 않을 수 있음에 유의한다 (즉, SDP가 구문 분석되고 다시 형식화되며 ICE 후보가 추가될 수 있다).

currentLocalDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

currentLocalDescription 속성은 [[CurrentLocalDescription]]을 반드시 반환해야 한다.

이는 RTCPeerConnection이 마지막으로 stable 상태로 전환되었을 때 성공적으로 협상된 로컬 설명과, 제안 또는 응답이 생성된 이후 ICE 에이전트가 생성한 모든 로컬 후보를 나타낸다.

pendingLocalDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

pendingLocalDescription 속성은 [[PendingLocalDescription]]을 반드시 반환해야 한다.

이는 현재 협상 중인 로컬 설명과, 제안 또는 응답이 생성된 이후 ICE 에이전트가 생성한 모든 로컬 후보를 나타낸다. RTCPeerConnection이 stable 상태이면 값은 null이다.

remoteDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

remoteDescription 속성은 [[PendingRemoteDescription]]이 null이 아니면 이를 반드시 반환하고, 그렇지 않으면 [[CurrentRemoteDescription]]을 반드시 반환해야 한다.

[[CurrentRemoteDescription]].sdp와 [[PendingRemoteDescription]].sdp는 대응하는 setRemoteDescription 호출에 전달된 sdp 값과 문자열 단위로 동일하지 않을 수 있음에 유의한다 (즉, SDP가 구문 분석되고 다시 형식화되며 ICE 후보가 추가될 수 있다).

currentRemoteDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

currentRemoteDescription 속성은 [[CurrentRemoteDescription]]을 반드시 반환해야 한다.

이는 RTCPeerConnection이 마지막으로 stable 상태로 전환되었을 때 성공적으로 협상된 최종 원격 설명과, 제안 또는 응답이 생성된 이후 addIceCandidate()를 통해 제공된 모든 원격 후보를 나타낸다.

pendingRemoteDescription 유형: RTCSessionDescription, 읽기 전용, null 허용

pendingRemoteDescription 속성은 [[PendingRemoteDescription]]을 반드시 반환해야 한다.

이는 현재 협상 중인 원격 설명과, 제안 또는 응답이 생성된 이후 addIceCandidate()를 통해 제공된 모든 원격 후보를 나타낸다. RTCPeerConnection이 stable 상태이면 값은 null이다.

signalingState의 유형: RTCSignalingState, 읽기 전용

signalingState 속성은 RTCPeerConnection 객체의 [[SignalingState]]을 반드시 반환해야 한다.

iceGatheringState 유형: RTCIceGatheringState, 읽기 전용

iceGatheringState 속성은 RTCPeerConnection 객체의 [[IceGatheringState]]을 반드시 반환해야 한다.

iceConnectionState 유형: RTCIceConnectionState, 읽기 전용

iceConnectionState 속성은 RTCPeerConnection 객체의 [[IceConnectionState]]을 반드시 반환해야 한다.

connectionState 유형: RTCPeerConnectionState, 읽기 전용

connectionState 속성은 RTCPeerConnection 객체의 [[ConnectionState]]을 반드시 반환해야 한다.

canTrickleIceCandidates의 유형: boolean, 읽기 전용, null 허용

canTrickleIceCandidates 속성은 원격 피어가 Trickle ICE 후보를 수락할 수 있는지를 나타낸다 [RFC8838]. 이 값은 [RFC9429] (4.1.17절 )에 정의된 대로 원격 설명이 Trickle ICE 지원을 나타내는지에 따라 결정된다. setRemoteDescription이 완료되기 전에는 이 값이 null이다.

onnegotiationneeded의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 negotiationneeded이다.

onicecandidate의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 icecandidate이다.

onicecandidateerror의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 icecandidateerror이다.

onsignalingstatechange의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 signalingstatechange이다.

oniceconnectionstatechange의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 iceconnectionstatechange

onicegatheringstatechange의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 icegatheringstatechange이다.

onconnectionstatechange의 유형: EventHandler

이 이벤트 처리기의 이벤트 유형은 connectionstatechange이다.

createOffer

createOffer 메서드는 이 RTCPeerConnection에 연결된 로컬 MediaStreamTrack의 설명, 이 구현이 지원하는 코덱/RTP/RTCP 기능, ICE 에이전트와 DTLS 연결의 매개변수를 포함하여 세션에 지원되는 구성이 담긴 RFC 3264 제안을 포함하는 SDP 블롭을 생성한다. 생성되는 제안을 추가로 제어하기 위해 options 매개변수를 제공할 수 있다.

시스템의 리소스가 제한된 경우(예: 디코더 수가 유한한 경우), createOffer는 시스템의 현재 상태를 반영하는 제안을 반환해야 한다. 그래야 setLocalDescription이 해당 리소스를 확보하려고 할 때 성공한다. 세션 설명은 반환된 프로미스의 이행 콜백이 끝날 때까지 오류를 발생시키지 않고 setLocalDescription에서 사용할 수 있는 상태를 반드시 유지해야 한다.

SDP 생성은 [RFC9429]에 설명된 적절한 제안 생성 절차를 반드시 따라야 한다. 다만 이 경우 사용자 에이전트는 RFC9429의 목적상 stopping 트랜시버를 stopped로 반드시 취급해야 한다.

생성된 SDP는 제안이므로 세션에서 지원하거나 선호하는 코덱/RTP/RTCP 기능의 전체 집합을 포함한다 (사용할 특정 협상 하위 집합만 포함하는 응답과는 다르다). 세션이 설정된 후 createOffer가 호출되는 경우, createOffer는 트랙 추가 또는 제거처럼 마지막으로 완료된 제안-응답 교환 이후 세션에 적용된 모든 변경 사항을 통합하여 현재 세션과 호환되는 제안을 생성한다. 변경 사항이 없으면 제안에는 현재 로컬 설명의 기능과 갱신된 제안에서 추가로 협상할 수 있는 기능이 포함된다.

생성된 SDP에는 ICE 에이전트의 usernameFragment, password 및 ICE 옵션([RFC5245] 14절에 정의됨)이 포함되며, 에이전트가 수집한 모든 로컬 후보도 포함될 수 있다.

RTCPeerConnection의 configuration에 있는 certificates 값은 애플리케이션이 RTCPeerConnection에 구성한 인증서를 제공한다. 이러한 인증서는 모든 기본 인증서와 함께 인증서 지문 집합을 생성하는 데 사용된다. 이 인증서 지문은 SDP 구성에 사용된다.

SDP 생성 과정은 기반 시스템의 미디어 기능 중 일부를 노출하며, 이는 일반적으로 기기에 관한 지속적인 교차 출처 정보를 제공한다. 따라서 애플리케이션의 핑거프린팅 노출 면적이 증가한다. 개인정보 보호에 민감한 환경에서 브라우저는 공통 기능 하위 집합에만 일치하는 SDP를 생성하는 등의 완화책을 고려할 수 있다.

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

2. connection.[[IsClosed]]가 true이면, 새로 생성된 InvalidStateError로 거부된 프로미스를 반환한다.

3. connection으로 제안을 생성한 결과를 connection의 작업 체인에 연결한 결과를 반환한다.

connection이 주어졌을 때 제안을 생성하려면 다음 단계를 실행한다:

1. connection.[[SignalingState]]이 "stable"도 아니고 "have-local-offer"도 아니면, 새로 생성된 InvalidStateError로 거부된 프로미스를 반환한다.

2. p를 새 프로미스로 한다.

3. 병렬로, connection과 p가 주어졌을 때의 제안을 생성하는 병렬 단계를 시작한다.

4. p를 반환한다.

connection과 프로미스 p가 주어졌을 때의 제안을 생성하는 병렬 단계는 다음과 같다:

1. connection이 인증서 집합을 사용하여 생성되지 않았고 아직 인증서가 생성되지 않았다면, 인증서가 생성될 때까지 기다린다.

2. [RFC9429] (4.1.8절 )에 설명된 대로, 제안을 생성하는 데 필요한 현재 사용 가능한 리소스를 확인하기 위해 제안자의 시스템 상태를 검사한다.

3. 이 검사가 어떤 이유로든 실패하면 새로 생성된 OperationError로 p를 거부하고 이 단계들을 중단한다.

4. connection과 p가 주어졌을 때의 제안 생성의 최종 단계를 실행하는 태스크를 대기열에 추가한다.

connection과 프로미스 p가 주어졌을 때의 제안 생성의 최종 단계는 다음과 같다:

1. connection.[[IsClosed]]가 true이면 이 단계들을 중단한다.

2. connection이 제안자의 시스템 상태를 추가로 검사해야 하는 방식으로 수정되었다면, 병렬로 connection과 p가 주어진 제안을 생성하는 병렬 단계를 다시 시작하고 이 단계들을 중단한다.

   참고

   예를 들어 오디오 RTCRtpTransceiver만 connection에 추가된 상태에서 createOffer가 호출되었지만, 제안을 생성하는 병렬 단계를 수행하는 동안 비디오 RTCRtpTransceiver가 추가되어 비디오 시스템 리소스를 추가로 검사해야 하는 경우가 이에 해당할 수 있다.

3. 이전 검사에서 얻은 정보와 connection 및 그 RTCRtpTransceiver들의 현재 상태를 바탕으로, [RFC9429] (5.2절 )에 설명된 SDP 제안 sdpString을 생성한다.

   1. [RFC8843] 7절에 설명된 대로 번들링을 사용하는 경우 (RTCBundlePolicy 참조), BUNDLE 그룹을 협상하려면 제안자 태그가 지정된 m= 섹션을 선택해야 한다. 사용자 에이전트는 트랜시버 집합에서 중지되지 않은 첫 번째 트랜시버에 대응하는 m= 섹션을 제안자 태그가 지정된 m= 섹션으로 반드시 선택해야 한다. 이렇게 하면 원격 엔드포인트가 SDP를 구문 분석하지 않고도 어떤 트랜시버가 제안자 태그가 지정된 m= 섹션인지 예측할 수 있다.

   2. filteredCodecs를 transceiver.[[PreferredCodecs]]에 다음 필터를 적용한 결과로 한다. 필터링은 코덱 선호도의 순서를 변경해서는 안 된다:

      1. kind를 transceiver의 [[Receiver]]의 [[ReceiverTrack]]의 kind로 한다.

      3. transceiver.direction이 "sendonly" 또는 "sendrecv"이면, ignoreLevels를 true로 설정한 코덱 사전 일치 알고리즘을 사용하여 kind의 구현된 송신 코덱 목록에 포함되지 않은 코덱을 제외한다.

      4. transceiver.direction이 "recvonly" 또는 "sendrecv"이면, ignoreLevels를 true로 설정한 코덱 사전 일치 알고리즘을 사용하여 kind의 구현된 수신 코덱 목록에 포함되지 않은 코덱을 제외한다.

      미디어 설명과 연결된 트랜시버 transceiver의 코덱 선호도는 filteredCodecs가 비어 있지 않으면 그 값으로 정의되고, 그렇지 않으면 설정되지 않은 것으로 정의된다.

   3. RTCRtpSender의 [[SendEncodings]] 슬롯의 길이가 1보다 크면, RTCRtpSender의 [[SendEncodings]]에 주어진 각 인코딩에 대해 대응하는 미디어 섹션에 a=rid send 줄을 추가하고, encodings 필드에 지정된 것과 같은 순서로 RID를 나열하는 a=simulcast:send 줄을 추가한다. RID 제한은 설정하지 않는다.

      참고

      [RFC8853] 5.2절은 a=simulcast 줄에 있는 RID의 순서가 제안된 선호 순서를 나타낸다고 규정한다. 브라우저가 모든 인코딩을 전송하지 않기로 결정하면 목록의 마지막 인코딩부터 전송을 중지할 것으로 예상해야 한다.

4. offer를 새로 생성된 RTCSessionDescriptionInit 사전으로 한다. 이 사전의 type 멤버는 문자열 "offer"로 초기화하고, sdp 멤버는 sdpString으로 초기화한다.

5. [[LastCreatedOffer]] 내부 슬롯을 sdpString으로 설정한다.

6. p를 offer로 이행한다.

createAnswer

createAnswer 메서드는 원격 구성의 매개변수와 호환되는 세션 지원 구성을 포함한 [SDP] 응답을 생성한다. createOffer와 마찬가지로 반환되는 SDP 블롭에는 이 RTCPeerConnection에 연결된 로컬 MediaStreamTrack의 설명, 이 세션에 대해 협상된 코덱/RTP/RTCP 옵션, ICE 에이전트가 수집한 모든 후보가 포함된다. 생성되는 응답을 추가로 제어하기 위해 options 매개변수를 제공할 수 있다.

createOffer와 마찬가지로 반환되는 설명은 시스템의 현재 상태를 반영하는 것이 좋다. 세션 설명은 반환된 프로미스의 이행 콜백이 끝날 때까지 오류를 발생시키지 않고 setLocalDescription에서 사용할 수 있는 상태를 반드시 유지해야 한다.

생성된 SDP는 응답이므로, 대응하는 제안과 함께 미디어 평면을 설정하는 방법을 지정하는 특정 코덱/RTP/RTCP 구성을 포함한다. SDP 생성은 [RFC9429]에 설명된 적절한 응답 생성 절차를 반드시 따라야 한다.

생성된 SDP에는 ICE 에이전트의 usernameFragment, password 및 ICE 옵션([RFC5245] 14절에 정의됨)이 포함되며, 에이전트가 수집한 모든 로컬 후보도 포함될 수 있다.

RTCPeerConnection의 configuration에 있는 certificates 값은 애플리케이션이 RTCPeerConnection에 구성한 인증서를 제공한다. 이러한 인증서는 모든 기본 인증서와 함께 인증서 지문 집합을 생성하는 데 사용된다. 이 인증서 지문은 SDP 구성에 사용된다.

응답은 [RFC9429] (4.1.10.1절 )에 설명된 대로 type을 "pranswer"로 설정하여 임시 응답으로 표시할 수 있다.

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

2. connection.[[IsClosed]]가 true이면, 새로 생성된 InvalidStateError로 거부된 프로미스를 반환한다.

3. connection으로 응답을 생성한 결과를 connection의 작업 체인에 연결한 결과를 반환한다.

connection이 주어졌을 때 응답을 생성하려면 다음 단계를 실행한다:

1. connection.[[SignalingState]]이 "have-remote-offer"도 아니고 "have-local-pranswer"도 아니면, 새로 생성된 InvalidStateError로 거부된 프로미스를 반환한다.

2. p를 새 프로미스로 한다.

3. 병렬로, connection과 p가 주어졌을 때의 응답을 생성하는 병렬 단계를 시작한다.

4. p를 반환한다.

connection과 프로미스 p가 주어졌을 때의 응답을 생성하는 병렬 단계는 다음과 같다:

1. connection이 인증서 집합을 사용하여 생성되지 않았고 아직 인증서가 생성되지 않았다면, 인증서가 생성될 때까지 기다린다.

2. [RFC9429] (4.1.9절 )에 설명된 대로, 응답을 생성하는 데 필요한 현재 사용 가능한 리소스를 확인하기 위해 응답자의 시스템 상태를 검사한다.

3. 이 검사가 어떤 이유로든 실패하면 새로 생성된 OperationError로 p를 거부하고 이 단계들을 중단한다.

4. p가 주어졌을 때의 응답 생성의 최종 단계를 실행하는 태스크를 대기열에 추가한다.

프로미스 p가 주어졌을 때의 응답 생성의 최종 단계는 다음과 같다:

1. connection.[[IsClosed]]가 true이면 이 단계들을 중단한다.

2. connection이 응답자의 시스템 상태를 추가로 검사해야 하는 방식으로 수정되었다면, 병렬로 connection과 p가 주어진 응답을 생성하는 병렬 단계를 다시 시작하고 이 단계들을 중단한다.

   참고

   예를 들어 RTCRtpTransceiver의 방향이 "recvonly"일 때 createAnswer가 호출되었지만, 응답을 생성하는 병렬 단계를 수행하는 동안 방향이 "sendrecv"로 변경되어 비디오 인코딩 리소스를 추가로 검사해야 하는 경우가 이에 해당할 수 있다.

3. 이전 검사에서 얻은 정보와 connection 및 그 RTCRtpTransceiver들의 현재 상태를 바탕으로, [RFC9429] (5.3절 )에 설명된 SDP 응답 sdpString을 생성한다.

   후보 수정 26:createAnswer()의 encodings와 sLD(answer)의 SendEncodings 가지치기. (PR #2801)

   후보 수정 27:쉼표로 구분된 rid 대안 무시. (PR #2813)

   현재 및 향후 표시 현재 표시향후 표시

   1. m= 섹션과 연결된 트랜시버의 코덱 선호도는 다음 필터링이 적용된 RTCRtpTransceiver.[[PreferredCodecs]]의 값으로 정의된다([[PreferredCodecs]]가 비어 있으면 설정되지 않은 것으로 정의된다):

      1. direction이 "sendrecv"이면, RTCRtpSender.getCapabilities(kind).codecs와 RTCRtpReceiver.getCapabilities(kind).codecs의 교집합에 포함되지 않은 코덱을 제외한다.

      2. direction이 "sendonly"이면, RTCRtpSender.getCapabilities(kind).codecs에 포함되지 않은 코덱을 제외한다.

      3. direction이 "recvonly"이면, RTCRtpReceiver.getCapabilities(kind).codecs에 포함되지 않은 코덱을 제외한다.

      필터링은 코덱 선호도의 순서를 변경해서는 안 된다.

   2. RTCRtpSender의 [[SendEncodings]] 슬롯의 길이가 1보다 크면, RTCRtpSender의 [[SendEncodings]]에 지정된 각 인코딩에 대해 대응하는 미디어 섹션에 a=rid send 줄을 추가하고, RID를 encodings 필드에 지정된 것과 같은 순서로 나열하는 a=simulcast:send 줄을 추가한다. RID 제한은 설정하지 않는다.

   3. filteredCodecs를 transceiver.[[PreferredCodecs]]에 다음 필터를 적용한 결과로 한다. 필터링은 코덱 선호도의 순서를 변경해서는 안 된다:

      1. kind를 transceiver의 [[Receiver]]의 [[ReceiverTrack]]의 kind로 한다.

      2. transceiver.direction이 "sendonly" 또는 "sendrecv"이면, ignoreLevels를 true로 설정한 코덱 사전 일치 알고리즘을 사용하여 kind의 구현된 송신 코덱 목록에 포함되지 않은 코덱을 제외한다.

      3. transceiver.direction이 "recvonly" 또는 "sendrecv"이면, ignoreLevels를 true로 설정한 코덱 사전 일치 알고리즘을 사용하여 kind의 구현된 수신 코덱 목록에 포함되지 않은 코덱을 제외한다.

      미디어 설명과 연결된 트랜시버 transceiver의 코덱 선호도는 filteredCodecs가 비어 있지 않으면 그 값으로 정의되고, 그렇지 않으면 설정되지 않은 것으로 정의된다.

   4. 이것이 동시 송출 수신 제안에 대한 응답이면, 동시 송출 수신을 요청하는 각 미디어 섹션에 대해 다음 단계를 실행한다:

      1. a=simulcast 속성에 RID의 쉼표로 구분된 대안이 포함되어 있으면 첫 번째 항목을 제외한 나머지를 모두 제거한다.

      2. a=simulcast 속성에 이름이 같은 RID가 있으면 첫 번째 항목을 제외한 나머지를 모두 제거한다. RID 제한은 설정하지 않는다.

      3. 대응하는 트랜시버의 [[Sender]].[[SendEncodings]]에서 찾을 수 없는 RID를 응답의 미디어 섹션에서 제외한다.

      참고

      setRemoteDescription(offer)가 송신자의 제안된 엔벌로프를 설정하면, 송신자의 [[SendEncodings]]은 "have-remote-offer"에서 갱신되어 롤백에 노출된다. 그러나 송신자에 대해 동시 송출 엔벌로프가 설정된 후에는, 송신자의 [[SendEncodings]]에 대한 이후의 가지치기는 이 응답이 setLocalDescription으로 설정될 때 발생한다.

4. answer를 새로 생성된 RTCSessionDescriptionInit 사전으로 한다. 이 사전의 type 멤버는 문자열 "answer"로 초기화하고, sdp 멤버는 sdpString으로 초기화한다.

5. [[LastCreatedAnswer]] 내부 슬롯을 sdpString으로 설정한다.

6. p를 answer로 이행한다.

setLocalDescription

setLocalDescription 메서드는 제공된 RTCLocalSessionDescriptionInit을 로컬 설명으로 적용하도록 RTCPeerConnection에 지시한다.

이 API는 로컬 미디어 상태를 변경한다. 애플리케이션이 한 미디어 형식에서 호환되지 않는 다른 형식으로 변경하도록 제안하려는 시나리오를 성공적으로 처리하기 위해, RTCPeerConnection은 최종 응답을 받을 때까지 현재 로컬 설명과 보류 중인 로컬 설명을 모두 동시에 사용할 수 있도록 반드시 지원해야 한다 (예: 두 설명에 모두 존재하는 코덱을 지원해야 한다). 최종 응답을 받으면 RTCPeerConnection은 보류 중인 로컬 설명을 완전히 채택하거나, 원격 측이 변경을 거부했다면 현재 설명으로 롤백할 수 있다.

설명 전달은 선택 사항이다. 생략하면 setLocalDescription은 필요에 따라 암시적으로 제안을 생성하거나 응답을 생성한다. [RFC9429] (5.4절 )에 명시된 것처럼 SDP가 포함된 설명을 전달하는 경우, 해당 SDP는 createOffer 또는 createAnswer에서 반환된 이후 변경되어서는 안 된다.

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. description을 메서드의 첫 번째 인수로 한다.

2. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

3. sdp를 description.sdp로 한다.

4. 다음 단계들을 connection의 작업 체인에 연결한 결과를 반환한다:

   1. type을 description.type이 있으면 그 값으로 한다. 없고 connection.[[SignalingState]]이 "stable", "have-local-offer" 또는 "have-remote-pranswer" 중 하나이면 "offer"로 한다. 그렇지 않으면 "answer"로 한다.

   2. type이 "offer"이고, sdp가 빈 문자열이 아니며 connection.[[LastCreatedOffer]]와 같지 않으면, 새로 생성된 InvalidModificationError로 거부된 프로미스를 반환하고 이 단계들을 중단한다.

   3. type이 "answer" 또는 "pranswer"이고, sdp가 빈 문자열이 아니며 connection.[[LastCreatedAnswer]]와 같지 않으면, 새로 생성된 InvalidModificationError로 거부된 프로미스를 반환하고 이 단계들을 중단한다.

   4. sdp가 빈 문자열이고 type이 "offer"이면 다음 하위 단계를 실행한다:

      1. sdp를 connection.[[LastCreatedOffer]]의 값으로 설정한다.

      2. sdp가 빈 문자열이거나 더 이상 connection의 제안자의 시스템 상태를 정확히 나타내지 않으면, p를 connection으로 제안을 생성한 결과로 하고, p에 첫 번째 인수가 나타내는 로컬 세션 설명을 설정하는 이행 단계로 반응한 결과를 반환한다.

   5. sdp가 빈 문자열이고 type이 "answer" 또는 "pranswer"이면, 다음 하위 단계를 실행한다:

      1. sdp를 connection.[[LastCreatedAnswer]]의 값으로 설정한다.

      2. sdp가 빈 문자열이거나 더 이상 connection의 응답자의 시스템 상태를 정확히 나타내지 않으면, p를 connection으로 응답을 생성한 결과로 하고, 다음 이행 단계로 p에 반응한 결과를 반환한다:

         1. answer를 이 이행 단계의 첫 번째 인수로 한다.

         2. {type, answer.sdp}가 나타내는 로컬 세션 설명을 설정한 결과를 반환한다.

   6. {type, sdp}가 나타내는 로컬 세션 설명을 설정한 결과를 반환한다.

참고

[RFC9429] (5.9절 )에 명시된 것처럼 이 메서드를 호출하면 ICE 에이전트의 ICE 후보 수집 절차가 시작될 수 있다.

setRemoteDescription

setRemoteDescription 메서드는 제공된 RTCSessionDescriptionInit을 원격 제안 또는 응답으로 적용하도록 RTCPeerConnection에 지시한다. 이 API는 로컬 미디어 상태를 변경한다.

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. description을 메서드의 첫 번째 인수로 한다.

2. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

3. 다음 단계들을 connection의 작업 체인에 연결한 결과를 반환한다:

   1. description.type이 "offer"이고 [RFC9429] (5.5절 및 5.6절 )에 설명된 현재 connection.[[SignalingState]]에 유효하지 않으면 다음 하위 단계를 실행한다:

      1. p를 {type: "rollback"}이 나타내는 로컬 세션 설명을 설정한 결과로 한다.

      2. p에 description을 원격 세션 설명으로 설정하는 이행 단계로 반응한 결과를 반환하고, 이 단계들을 중단한다.

   2. description을 원격 세션 설명으로 설정한 결과를 반환한다.

addIceCandidate

addIceCandidate 메서드는 원격 후보를 ICE 에이전트에 제공한다. 이 메서드는 candidate 멤버가 빈 문자열인 상태로 호출하면 원격 후보의 끝을 나타내는 데도 사용할 수 있다. 이 메서드가 사용하는 인수의 멤버는 candidate, sdpMid, sdpMLineIndex, 그리고 usernameFragment뿐이며, 나머지는 무시된다. 이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. candidate를 메서드의 인수로 한다.

2. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

3. candidate.candidate가 빈 문자열이 아니고, candidate.sdpMid와 candidate.sdpMLineIndex가 모두 null이면, 새로 생성된 TypeError로 거부된 프로미스를 반환한다.

4. 다음 단계들을 connection의 작업 체인에 연결한 결과를 반환한다:

   1. remoteDescription이 null이면 새로 생성된 InvalidStateError로 거부된 프로미스를 반환한다.

   2. candidate.sdpMid가 null이 아니면 다음 단계를 실행한다:

      1. candidate.sdpMid가 remoteDescription에 있는 어떤 미디어 설명의 mid와도 같지 않으면, 새로 생성된 OperationError로 거부된 프로미스를 반환한다.

   3. 그렇지 않고 candidate.sdpMLineIndex가 null이 아니면 다음 단계를 실행한다:

      1. candidate.sdpMLineIndex가 remoteDescription의 미디어 설명 수 이상이면, 새로 생성된 OperationError로 거부된 프로미스를 반환한다.

   4. candidate.sdpMid 또는 candidate.sdpMLineIndex 중 하나가 remoteDescription에서 연결된 트랜시버가 stopped인 미디어 설명을 나타내면, undefined로 이행된 프로미스를 반환한다.

   5. candidate.usernameFragment가 null이 아니고, 적용된 원격 설명의 대응하는 미디어 설명에 존재하는 어떤 사용자 이름 프래그먼트와도 같지 않으면, 새로 생성된 OperationError로 거부된 프로미스를 반환한다.

   6. p를 새 프로미스로 한다.

   7. 병렬로, 후보가 관리상 금지되지 않았다면, [RFC9429] (4.1.19절 )에 설명된 대로 ICE 후보 candidate를 추가한다. ICE 세대를 식별하려면 candidate.usernameFragment를 사용한다. usernameFragment가 null이면 가장 최근 ICE 세대에 대해 candidate를 처리한다.

      candidate.candidate가 빈 문자열이면 candidate를 대응하는 미디어 설명과 ICE 후보 세대에 대한 후보 끝 표시로 처리한다. candidate.sdpMid와 candidate.sdpMLineIndex가 모두 null이면 이 후보 끝 표시는 모든 미디어 설명에 적용된다.

      1. candidate를 성공적으로 추가하지 못했다면 사용자 에이전트는 다음 단계를 실행하는 태스크를 반드시 대기열에 추가해야 한다:

         1. connection.[[IsClosed]]가 true이면 이 단계들을 중단한다.

         2. 새로 생성된 OperationError로 p를 거부하고 이 단계들을 중단한다.

      2. candidate가 성공적으로 적용되었거나 후보가 관리상 금지된 경우, 사용자 에이전트는 다음 단계를 실행하는 태스크를 반드시 대기열에 추가해야 한다:

         1. connection.[[IsClosed]]가 true이면 이 단계들을 중단한다.

         2. connection.[[PendingRemoteDescription]]이 null이 아니고 candidate가 처리된 ICE 세대를 나타내면, candidate를 connection.[[PendingRemoteDescription]].sdp에 추가한다.

         3. connection.[[CurrentRemoteDescription]]이 null이 아니고 candidate가 처리된 ICE 세대를 나타내면, candidate를 connection.[[CurrentRemoteDescription]].sdp에 추가한다.

         4. p를 undefined로 이행한다.

   8. p를 반환한다.

UA가 이 주소에 대한 연결 시도를 허용하지 않기로 결정한 경우 후보는 관리상 금지된 것이다.

개인정보 보호를 위해 개발자에게 주소/포트의 차단 여부를 알리지 않는다. 해당 주소에서 응답이 전혀 없는 것과 정확히 같은 방식으로 동작한다.

UA는 [Fetch]의 잘못된 포트 차단 목록에 있는 주소로의 연결을 반드시 금지해야 하며, 다른 주소로의 연결도 금지하도록 선택할 수 있다.

RTCConfiguration의 iceTransportPolicy 멤버가 relay이면, mDNS 후보나 DNS 후보처럼 외부 확인이 필요한 후보는 반드시 금지해야 한다.

참고

WebIDL 처리로 인해 addIceCandidate(null)은 기본 사전이 존재하는 호출로 해석된다. 위 알고리즘에서 이는 모든 미디어 설명과 ICE 후보 세대에 대한 후보 끝을 나타낸다. 이는 레거시 사유로 의도된 동작이다.

restartIce

restartIce 메서드는 ICE를 다시 시작해야 한다고 RTCPeerConnection에 알린다. 이후 createOffer 호출은 [RFC5245] 9.1.1.1절에 설명된 대로 ICE를 다시 시작하는 설명을 생성한다.

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. connection을 메서드가 호출된 RTCPeerConnection으로 한다.

2. connection.[[LocalIceCredentialsToReplace]]를 비운 다음, connection.[[CurrentLocalDescription]]에서 찾은 모든 ICE 자격 증명과 connection.[[PendingLocalDescription]]에서 찾은 모든 ICE 자격 증명([RFC5245] 15.4절에 정의된 ice-ufrag 및 ice-pwd)으로 채운다.

3. connection의 협상 필요 플래그를 갱신한다.

getConfiguration

이 RTCPeerConnection 객체의 현재 구성을 나타내는 RTCConfiguration 객체를 반환한다.

이 메서드가 호출되면 사용자 에이전트는 [[Configuration]] 내부 슬롯에 저장된 RTCConfiguration 객체를 반드시 반환해야 한다.

setConfiguration

setConfiguration 메서드는 이 RTCPeerConnection 객체의 구성을 갱신한다. 여기에는 ICE 에이전트의 구성 변경도 포함된다. [RFC9429] (3.5.1절 )에 명시된 것처럼 ICE 구성이 새 수집 단계를 요구하는 방식으로 변경되면 ICE를 다시 시작해야 한다.

setConfiguration 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. connection을 메서드가 호출된 RTCPeerConnection으로 한다.

2. connection.[[IsClosed]]가 true이면 다음 예외를 던진다: InvalidStateError.

3. configuration이 지정한 구성을 설정한다.

close

close 메서드가 호출되면 사용자 에이전트는 다음 단계를 반드시 실행해야 한다:

1. connection을 메서드가 호출된 RTCPeerConnection 객체로 한다.

2. connection과 false 값을 사용하여 연결을 닫는다.

connection과 불리언 disappear가 주어졌을 때 연결을 닫는 알고리즘은 다음과 같다:

1. connection.[[IsClosed]]가 true이면 이 단계들을 중단한다.

2. connection.[[IsClosed]]를 true로 설정한다.

3. connection.[[SignalingState]]을 "closed"로 설정한다. 이때는 어떤 이벤트도 발생하지 않는다.

4. transceivers를 CollectTransceivers 알고리즘을 실행한 결과로 한다. transceivers의 모든 RTCRtpTransceiver transceiver에 대해 다음 단계를 실행한다:

   1. transceiver.[[Stopped]]가 true이면 이 하위 단계들을 중단한다.

   2. transceiver와 disappear를 사용하여 RTCRtpTransceiver를 중지한다.

5. connection의 각 RTCDataChannel의 [[ReadyState]] 슬롯을 "closed"로 설정한다.

   참고

   RTCDataChannel은 갑자기 닫히며 닫기 절차는 호출되지 않는다.

6. connection.[[SctpTransport]]가 null이 아니면 SCTP ABORT 청크를 전송하여 기반 SCTP 연결을 해제하고, [[SctpTransportState]]을 "closed"로 설정한다.

7. connection의 각 RTCDtlsTransport의 [[DtlsTransportState]] 슬롯을 "closed"로 설정한다.

8. connection의 ICE 에이전트를 제거하여 활성 ICE 처리를 즉시 종료하고 관련 리소스 (예: TURN 권한)를 해제한다.

9. connection의 각 RTCIceTransport의 [[IceTransportState]] 슬롯을 "closed"로 설정한다.

10. connection.[[IceConnectionState]]을 "closed"로 설정한다. 이때는 어떤 이벤트도 발생하지 않는다.

11. connection.[[ConnectionState]]을 "closed"로 설정한다. 이때는 어떤 이벤트도 발생하지 않는다.

constructor()

RTCSessionDescription() 생성자는 사전 인수 description을 받으며, 그 내용은 새로운 RTCSessionDescription 객체를 초기화하는 데 사용된다. 이 생성자는 더 이상 사용되지 않으며 레거시 호환성을 위해서만 존재한다.

type의 형식은 RTCSdpType이며 읽기 전용

이 세션 기술의 유형이다.

sdp의 형식은 DOMString이며 읽기 전용이고 기본값은 ""

SDP [SDP]의 문자열 표현이다.

toJSON()

호출되면 [WEBIDL]의 기본 toJSON 단계를 실행한다.

type의 형식은 RTCSdpType이며 필수이다

이 세션 기술의 유형이다.

sdp의 형식은 DOMString

SDP [SDP]의 문자열 표현이다. type이 "rollback"이면 이 멤버는 사용되지 않는다.

type의 형식은 RTCSdpType

이 기술의 유형이다. 존재하지 않으면 setLocalDescription은 다음을 기반으로 유형을 추론한다: RTCPeerConnection의 [[SignalingState]].

sdp의 형식은 DOMString

SDP [SDP]의 문자열 표현이다. type이 "rollback"이면 이 멤버는 사용되지 않는다.

constructor()

RTCIceCandidate() 생성자는 사전 인수 candidateInitDict를 받으며, 그 내용은 새 RTCIceCandidate 객체를 초기화하는 데 사용된다.

호출되면 다음 단계를 실행한다.

1. candidateInitDict의 sdpMid 및 sdpMLineIndex 멤버가 모두 null이면 다음 예외를 던진다: TypeError.

2. candidateInitDict로 RTCIceCandidate를 생성한 결과를 반환한다.

candidateInitDict 사전으로 RTCIceCandidate를 생성하려면 다음 단계를 실행한다.

1. iceCandidate를 새로 생성한 RTCIceCandidate 객체로 한다.
2. iceCandidate의 다음 속성에 대해 null로 초기화된 내부 슬롯을 생성한다. foundation, component, priority, address, protocol, port, type, tcpType, relatedAddress 및 relatedPort.
3. iceCandidate의 다음 속성에 대해 candidateInitDict에서 같은 이름을 가진 멤버의 값으로 초기화된 내부 슬롯을 생성한다. candidate, sdpMid, sdpMLineIndex, usernameFragment.
4. candidate를 candidateInitDict의 candidate 사전 멤버로 한다. candidate가 빈 문자열이 아니면 다음 단계를 실행한다.
   1. candidate를 candidate-attribute 문법을 사용하여 파싱한다.
   2. candidate-attribute 파싱에 실패하면 이 단계들을 중단한다.
   3. 파싱 결과의 필드 중 iceCandidate의 대응 속성에 유효하지 않은 값을 나타내는 것이 있으면 이 단계들을 중단한다.
   4. iceCandidate의 대응 내부 슬롯을 파싱 결과의 필드 값으로 설정한다.
5. iceCandidate를 반환한다.

참고

RTCIceCandidate 생성자는 candidateInitDict의 사전 멤버에 대해 기본적인 파싱과 형식 검사만 수행한다. candidate, sdpMid, sdpMLineIndex, usernameFragment의 형식 적합성 및 대응하는 세션 기술과의 일치 여부에 대한 상세 검증은 RTCIceCandidate 객체를 addIceCandidate()에 전달할 때 수행된다.

하위 호환성을 유지하기 위해 candidate 속성을 파싱할 때 발생하는 모든 오류는 무시된다. 이 경우 candidate 속성은 candidateInitDict에 제공된 원시 candidate 문자열을 보유하지만, foundation, priority 등의 파생 속성은 null로 설정된다.

아래 속성 대부분은 [RFC5245] 15.1절에 정의되어 있다.

candidate의 형식은 DOMString이며 읽기 전용이다.

[RFC5245] 15.1절에 정의된 candidate-attribute를 담는다. 이 RTCIceCandidate가 후보 종료 표시 또는 피어 반사형 원격 후보를 나타내면 candidate는 빈 문자열이다.

sdpMid의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

null이 아니면 이 후보가 연결된 미디어 구성요소에 대해 [RFC5888]에 정의된 미디어 스트림 “식별 태그”를 포함한다.

sdpMLineIndex의 형식은 unsigned short이며 읽기 전용이고 null을 허용한다.

null이 아니면 SDP에서 이 후보가 연결된 미디어 설명의 인덱스(0부터 시작)를 나타낸다.

foundation의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

여러 RTCIceTransport에 나타나는 후보를 ICE가 서로 연관 지을 수 있게 하는 고유 식별자이다.

component의 형식은 RTCIceComponent이며 읽기 전용이고 null을 허용한다.

후보에 할당된 네트워크 구성요소 (“rtp” 또는 “rtcp”)이다. 이는 candidate-attribute의 component-id 필드에 대응하며, RTCIceComponent에 정의된 문자열 표현으로 디코딩된다.

priority의 형식은 unsigned long이며 읽기 전용이고 null을 허용한다.

후보에 할당된 우선순위이다.

address의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

IPv4 주소, IPv6 주소 및 정규화된 도메인 이름(FQDN)을 허용하는 후보의 주소이다. 이는 candidate-attribute의 connection-address 필드에 대응한다.

예를 들어 [[SelectedCandidatePair]].remote를 통해 원격 후보가 노출될 수 있다. 기본적으로 사용자 에이전트는 노출되는 모든 원격 후보의 address 속성을 null로 반드시 유지해야 한다. 웹 애플리케이션이 addIceCandidate를 사용하여 RTCPeerConnection 인스턴스에 주소를 알려 주면 사용자 에이전트는 새로 알게 된 해당 주소를 가진 원격 후보를 나타내는 그 RTCPeerConnection 인스턴스의 모든 RTCIceCandidate에서 address 속성 값을 노출할 수 있다.

참고

ICE를 통해 수집되어 RTCIceCandidate 인스턴스에서 애플리케이션에 표시되는 후보의 주소는 WebRTC를 지원하지 않는 브라우저에서 사용자가 예상했을 수 있는 것보다 기기와 사용자에 관한 더 많은 정보(예: 위치, 로컬 네트워크 토폴로지)를 드러낼 수 있다.

이 주소는 항상 애플리케이션에 노출되고 잠재적으로 통신 상대방에게도 노출되며, 특정한 사용자 동의 없이도 노출될 수 있다 (예: 데이터 채널과 함께 사용하는 피어 연결 또는 미디어 수신 전용 연결).

또한 이 주소는 일시적 또는 영구적인 교차 출처 상태로 사용될 수 있으므로 기기의 지문 식별 표면을 넓힌다.

애플리케이션은 RTCConfiguration의 iceTransportPolicy 멤버를 통해 ICE 에이전트가 릴레이 후보만 보고하도록 강제함으로써 일시적 또는 영구적으로 통신 상대방에게 주소가 노출되지 않게 할 수 있다.

애플리케이션 자체에 노출되는 주소를 제한하기 위해 브라우저는 [RFC8828]에 정의된 대로 로컬 주소 공유에 관한 다양한 정책을 사용자에게 제공할 수 있다.

protocol의 형식은 RTCIceProtocol이며 읽기 전용이고 null을 허용한다.

후보의 프로토콜 (“udp”/“tcp”)이다. 이는 candidate-attribute의 transport 필드에 대응한다.

port의 형식은 unsigned short이며 읽기 전용이고 null을 허용한다.

후보의 포트이다.

type의 형식은 RTCIceCandidateType이며 읽기 전용이고 null을 허용한다.

후보의 유형이다. 이는 candidate-attribute의 candidate-types 필드에 대응한다.

tcpType의 형식은 RTCIceTcpCandidateType이며 읽기 전용이고 null을 허용한다.

protocol이 “tcp”이면 tcpType은 TCP 후보의 유형을 나타낸다. 그렇지 않으면 tcpType은 null이다. 이는 candidate-attribute의 tcp-type 필드에 대응한다.

relatedAddress의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

릴레이 후보나 반사형 후보처럼 다른 후보에서 파생된 후보의 경우 relatedAddress는 그 후보가 파생된 원본 후보의 IP 주소이다. 호스트 후보의 경우 relatedAddress는 null이다. 이는 candidate-attribute의 rel-address 필드에 대응한다.

relatedPort의 형식은 unsigned short이며 읽기 전용이고 null을 허용한다.

릴레이 후보나 반사형 후보처럼 다른 후보에서 파생된 후보의 경우 relatedPort는 그 후보가 파생된 원본 후보의 포트이다. 호스트 후보의 경우 relatedPort는 null이다. 이는 candidate-attribute의 rel-port 필드에 대응한다.

usernameFragment의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

[RFC5245] 15.4절에 정의된 ufrag를 담는다.

후보 추가 사항 16:RTCIceCandidate.relayProtocol 추가 (PR #2763)

현재 및 향후 내용 표시 현재 내용 표시향후 내용 표시

relayProtocol의 형식은 RTCIceServerTransportProtocol이며 읽기 전용이고 null을 허용한다.

유형이 “relay”인 로컬 후보의 경우, 이는 엔드포인트가 TURN 서버와 통신하는 데 사용하는 프로토콜이다. 그 밖의 모든 후보에서는 null이다.

후보 추가 사항 23:RTCIceCandidate.url 추가 (PR #2773)

현재 및 향후 내용 표시 현재 내용 표시향후 내용 표시

url의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

유형이 “srflx” 또는 “relay”인 로컬 후보의 경우, 이는 후보를 얻은 ICE 서버의 URL이다. 그 밖의 모든 후보에서는 null이다.

toJSON()

RTCIceCandidate 인터페이스의 toJSON() 연산을 호출하려면 다음 단계를 실행한다.

1. json을 새 RTCIceCandidateInit 사전으로 한다.
2. «candidate, sdpMid, sdpMLineIndex, usernameFragment»의 각 속성 식별자 attr에 대해 다음 단계를 실행한다.
   1. 이 RTCIceCandidate 객체가 주어졌을 때 attr로 식별되는 속성의 기저 값을 가져온 결과를 value로 한다.
   2. json[attr]을 value로 설정한다.
3. json을 반환한다.

candidate의 형식은 DOMString이며 기본값은 ""이다.

[RFC5245] 15.1절에 정의된 candidate-attribute를 담는다. 이것이 후보 종료 표시를 나타내면 candidate는 빈 문자열이다.

sdpMid의 형식은 DOMString이며 null을 허용하고 기본값은 null이다.

null이 아니면 이 후보가 연결된 미디어 구성요소에 대해 [RFC5888]에 정의된 미디어 스트림 “식별 태그”를 포함한다.

sdpMLineIndex의 형식은 unsigned short이며 null을 허용하고 기본값은 null이다.

null이 아니면 SDP에서 이 후보가 연결된 미디어 설명의 인덱스(0부터 시작)를 나타낸다.

usernameFragment의 형식은 DOMString이며 null을 허용하고 기본값은 null이다.

null이 아니면 [RFC5245] 15.4절에 정의된 ufrag를 담는다.

RTCPeerConnectionIceEvent.constructor()

candidate의 형식은 RTCIceCandidate이며 읽기 전용이고 null을 허용한다.

candidate 속성은 이벤트를 발생시킨 새 ICE 후보를 담은 RTCIceCandidate 객체이다.

후보 수집 종료를 나타내기 위해 이벤트가 생성되면 이 속성은 null로 설정된다.

참고

미디어 구성요소가 여러 개여도 null 후보를 포함하는 이벤트는 하나만 발생한다.

url의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

url 속성은 이 후보를 수집하는 데 사용된 STUN 또는 TURN 서버를 식별하는 STUN 또는 TURN URL이다. 후보가 STUN 또는 TURN 서버에서 수집되지 않았으면 이 매개변수는 null로 설정된다.

후보 수정 사항 23:RTCPeerConnectionIceEvent.url을 사용 중단으로 표시 (PR #2773)

현재 및 향후 내용 표시 현재 내용 표시향후 내용 표시

이 속성은 사용이 중단되었으며, 이전 버전과의 호환성을 위해서만 존재한다. 후보의 url을 사용하는 것이 좋다.

candidate의 형식은 RTCIceCandidate이며 null을 허용한다.

candidate 속성에 대해서는 RTCPeerConnectionIceEvent 인터페이스의 해당 설명을 참조한다.

url의 형식은 DOMString이며 null을 허용한다.

url 속성은 이 후보를 수집하는 데 사용된 STUN 또는 TURN 서버를 식별하는 STUN 또는 TURN URL이다.

RTCPeerConnectionIceErrorEvent.constructor()

address의 형식은 DOMString이며 읽기 전용이고 null을 허용한다.

address 속성은 STUN 또는 TURN 서버와 통신하는 데 사용된 로컬 IP 주소이다.

다중 홈 시스템에서는 서버에 연결하기 위해 여러 인터페이스가 사용될 수 있으며, 이 속성을 통해 애플리케이션은 어느 인터페이스에서 실패가 발생했는지 알아낼 수 있다.

로컬 IP 주소 값이 로컬 후보의 일부로 이미 노출되어 있지 않으면 address 속성은 null로 설정된다.

port의 형식은 unsigned short이며 읽기 전용이고 null을 허용한다.

port 속성은 STUN 또는 TURN 서버와 통신하는 데 사용된 포트이다.

address 속성이 null이면 port 속성도 null로 설정된다.

url의 형식은 DOMString이며 읽기 전용이다.

url 속성은 실패가 발생한 STUN 또는 TURN 서버를 식별하는 STUN 또는 TURN URL이다.

errorCode의 형식은 unsigned short이며 읽기 전용이다.

errorCode 속성은 STUN 또는 TURN 서버가 반환한 숫자형 STUN 오류 코드이다 [STUN-PARAMETERS].

서버에 도달할 수 있는 호스트 후보가 없으면 errorCode는 STUN 오류 코드 범위를 벗어난 값 701로 설정된다. 이 오류는 RTCIceGatheringState가 “gathering”인 동안 각 서버 URL에 대해 한 번만 발생한다.

errorText의 형식은 USVString이며 읽기 전용이다.

errorText 속성은 STUN 또는 TURN 서버가 반환한 STUN 사유 텍스트이다 [STUN-PARAMETERS].

서버에 도달할 수 없으면 errorText는 오류의 상세 정보를 제공하는 구현별 값으로 설정된다.

address의 형식은 DOMString이며 null을 허용한다.

STUN 또는 TURN 서버와 통신하는 데 사용된 로컬 주소이거나 null이다.

port의 형식은 unsigned short이며 null을 허용한다.

STUN 또는 TURN 서버와 통신하는 데 사용된 로컬 포트이거나 null이다.

url의 형식은 DOMString이다.

실패가 발생한 STUN 또는 TURN 서버를 식별하는 STUN 또는 TURN URL이다.

errorCode의 형식은 unsigned short이며 필수이다.

STUN 또는 TURN 서버가 반환한 숫자형 STUN 오류 코드이다.

errorText의 형식은 USVString이다.

STUN 또는 TURN 서버가 반환한 STUN 사유 텍스트이다.