RTCPeerConnection: currentLocalDescription-Eigenschaft

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Die currentLocalDescription schreibgeschützte Eigenschaft des RTCPeerConnection-Interfaces gibt ein RTCSessionDescription-Objekt zurück, das das lokale Ende der Verbindung beschreibt, wie es zuletzt erfolgreich ausgehandelt wurde seit dem letzten Mal, als die RTCPeerConnection die Verhandlung und Verbindung zu einem entfernten Peer abgeschlossen hat. Auch enthalten ist eine Liste von ICE-Kandidaten, die möglicherweise bereits vom ICE-Agenten generiert wurden, seit das durch die Beschreibung repräsentierte Angebot oder die Antwort erstmals instanziiert wurde.

Um die currentLocalDescription zu ändern, rufen Sie RTCPeerConnection.setLocalDescription() auf. Dies löst eine Reihe von Ereignissen aus, die dazu führen, dass dieser Wert gesetzt wird. Einzelheiten dazu, was genau passiert und warum die Änderung nicht unbedingt sofort erfolgt, finden Sie unter Ausstehende und aktuelle Beschreibungen auf der WebRTC-Verbindungsseite.

Hinweis: Im Gegensatz zu RTCPeerConnection.localDescription repräsentiert dieser Wert den tatsächlichen aktuellen Zustand des lokalen Endes der Verbindung; localDescription kann eine Beschreibung angeben, zu der die Verbindung momentan wechselt.

In diesem Artikel

Wert

Die aktuelle Beschreibung des lokalen Endes der Verbindung, falls eine gesetzt wurde. Wenn keine erfolgreich gesetzt wurde, ist dieser Wert null.

Beispiele

Dieses Beispiel betrachtet die currentLocalDescription und zeigt einen Alarm, der die type- und sdp-Felder des RTCSessionDescription-Objekts enthält.

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebRTC API
RTCPeerConnection
Konstruktor
1. RTCPeerConnection()
Instanzeigenschaften
Statische Methoden
1. generateCertificate()
Instanzmethoden
Events
Vererbung
1. EventTarget
Verwandte Seiten für WebRTC
Anleitungen
1. Einführung in WebRTC-Protokolle
2. Einführung in das Real-time Transport Protocol (RTP)
3. WebRTC-Konnektivität
4. Herstellen einer Verbindung: Das WebRTC-Perfect-Negotiation-Muster
5. Lebenszyklus einer WebRTC-Sitzung
6. Signalisierung und Videoanrufe
7. Verwenden von WebRTC-Datenkanälen
8. Verwendung von DTMF mit WebRTC
9. Verwenden von WebRTC Encoded Transforms
10. Ein einfaches RTCDataChannel-Beispiel
11. Bau eines internetfähigen Telefons mit PeerJS

RTCPeerConnection: currentLocalDescription-Eigenschaft

In diesem Artikel

Wert

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN