RTCPeerConnection.currentRemoteDescription

읽기 속성인 RTCPeerConnection.currentRemoteDescription은 마지막 RTCPeerConnection 이후 가장 최근에 원격 유저와의 네고시에이션 및 연결을 성공적으로 마친 연결의 원격 엔드 포인트를 알려주는 RTCSessionDescription 객체를 반환합니다. 추가적으로 이 속성은 description에 의해 표현되는 마지막 offer 및 answer가 처음 시작되면 ICE 에이전트에 의해 생성이 되었을 수도 있는 모든 ICE candidate들의 리스트를 포함합니다.

currentRemoteDescription를 바꾸기 위해서는,  RTCPeerConnection.setRemoteDescription() (en-US)를 호출해서 이 값이 설정되도록 만들어주는 연속된 이벤트를 활성화하십시오. 왜 바꾸는 것이 바로 적용이 안되는지 및 어떻게 작동하는지 더 자세히 알고 싶다면, Pending and current descriptions in WebRTC connectivity를 참조하십시오.

RTCPeerConnection.remoteDescription (en-US)와 다르게, 이 값은 연결의 로컬 엔드 포인트에 대한 실제 현재 상태를 보여줍니다. remoteDescription은 연결이 현재 어느 상태로 바뀌는지에 대한 설명도 명시 할 수 있습니다.

Syntax

sessionDescription = RTCPeerConnection.currentRemoteDescription;

반환 값

설정이 되어있다면, 연결의 원격 엔드포인트에 대한 현재 설명을 반환합니다. 설정되어있지않으면, 이 값은 null입니다. 

예시

아래 예제는 currentRemoteDescription 를 확인하고 객체의 typesdp 필드를 경고로 띄워줍니다.

var pc = new RTCPeerConnection();var sd = pc.currentRemoteDescription;
if (sd) {
  alert("Local session: type='" +
        sd.type + "'; sdp description='" +
        sd.sdp + "'");
}
else {
  alert("No local session yet.");
}

명세

명세 상태 코멘트
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'RTCPeerConnection.currentRemoteDescription' in that specification.
Candidate Recommendation Initial specification.

브라우저 호환성

BCD tables only load in the browser

참조