RTCPeerConnection.currentLocalDescription

읽기 속성인 RTCPeerConnection.currentLocalDescription 은 가장 최근에 RTCPeerConnection (en-US)가 성공적으로 네고시에이션을 마치고 원격 피어와 연결된, 연결인터페이스의 로컬 엔드를 설명하는 RTCSessionDescription (en-US) 객체를 반환합니다. 이외에도 설명에 의해 offer 혹은 answer가 처음으로 인스턴스화 되면 ICE 에이전트에 의해 이미 생성됬을수도 있는 ICE candidate 목록이 포함되어 있습니다.

currentLocalDescription을 바꾸기 위해서는, 이 값을 설정하도록 연쇄 이벤트를 작동시키는 RTCPeerConnection.setLocalDescription()를 호출하십시오. 이 연쇄 이벤트가 어떻게 값을 바꾸고, 왜 즉시 값이 바뀌지 않는지에 대해 궁금하다면, Pending and current descriptions (en-US)를 살펴보십시오.

참고: RTCPeerConnection.localDescription와 다르게, currentLocalDescription는 연결 인터페이스의 로컬 엔드에 대한 현재 상태를 나타내는 값 입니다. localDescription은 연결 인터페이스가 현재 어떤 상태로 전환 중인지를 설명하는 값을 명시 할 수 있습니다.

Syntax

js
sessionDescription = RTCPeerConnection.currentLocalDescription;

반환 값

연결이 설정된 경우, 연결의 로컬 엔드에 대한 가장 최신 설명입니다. 성공적으로 연결이 설정이 되지 않았다면, 반환 값은 null 입니다.

예시

이 예시는 currentLocalDescription을 확인하고, RTCSessionDescription (en-US) 객체의 type 및 sdp 필드를 담고 있는 경고 메세지를 출력합니다.

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

명세

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-currentlocaldesc

브라우저 호환성

BCD tables only load in the browser

참고: currentLocalDescription와 pendingLocalDescription (en-US)기능은 최근에 추가 되었습니다. 따라서, 이 기능을 지원하지 않는 브라우저에서는 localDescription를 사용하십시오.

참조