RTCPeerConnection: Eigenschaft localDescription
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft localDescription des RTCPeerConnection-Interfaces gibt eine RTCSessionDescription zurück, die die Sitzung für das lokale Ende der Verbindung beschreibt.
Wenn sie noch nicht gesetzt wurde, ist sie null.
Wert
Auf einer grundlegenderen Ebene ist der zurückgegebene Wert der Wert von RTCPeerConnection.pendingLocalDescription, wenn diese Eigenschaft nicht null ist;
andernfalls wird der Wert von RTCPeerConnection.currentLocalDescription zurückgegeben.
Details zu diesem Algorithmus und dessen Verwendung finden Sie unter Ausstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite.
Beispiel
Dieses Beispiel betrachtet die localDescription und zeigt einen Hinweis mit den Feldern type und sdp des RTCSessionDescription-Objekts an.
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
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-peerconnection-localdescription |