RTCPeerConnection: localDescription-Eigenschaft
Die schreibgeschützte Eigenschaft localDescription
der Schnittstelle RTCPeerConnection
gibt eine RTCSessionDescription
zurück, die die Sitzung für das lokale Ende der Verbindung beschreibt.
Falls sie noch nicht gesetzt wurde, ist dieser Wert null
.
Syntax
const sessionDescription = peerConnection.localDescription
Auf einer grundlegenderen Ebene ist der zurückgegebene Wert der Wert von RTCPeerConnection.pendingLocalDescription
, falls diese Eigenschaft nicht null
ist;
anderenfalls wird der Wert von RTCPeerConnection.currentLocalDescription
zurückgegeben.
Weitere Informationen zu diesem Algorithmus und warum er verwendet wird, finden Sie unter Ausstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite.
Beispiel
Dieses Beispiel betrachtet die localDescription
und zeigt eine Warnung an, die die type
- und sdp
-Felder des RTCSessionDescription
-Objekts enthält.
const pc = new RTCPeerConnection();
// ...
const sd = pc.localDescription;
if (sd) {
alert(`Local session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
alert("No local session yet.");
}
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-localdescription |
Browser-Kompatibilität
BCD tables only load in the browser