Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

RTCSessionDescription: RTCSessionDescription() Konstruktor

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Der RTCSessionDescription() Konstruktor erstellt eine neue RTCSessionDescription mit seinen Eigenschaften, die entsprechend dem angegebenen Objekt initialisiert sind.

Hinweis: Dieser Konstruktor wurde als veraltet erklärt, da RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe nehmen, nun direkt ein Objekt akzeptieren, das die Eigenschaften type und sdp enthält. Sie müssen also keine RTCSessionDescription selbst instanziieren.

Syntax

js
new RTCSessionDescription(options)

Werte

options

Ein Objekt, das die Standardwerte für die Sitzungsbeschreibung bereitstellt. Es sollte die folgenden Eigenschaften enthalten:

type

Erforderlich. Ein String, der verwendet wird, um die type Eigenschaft des neuen RTCSessionDescription Objekts festzulegen. Muss einer der gültigen RTCSessionDescription.type Werte sein.

sdp Optional

Ein String, der eine SDP Nachricht beschreibt, die die Sitzung beschreibt. Dieser Wert ist standardmäßig ein leerer String ("") und darf nicht null sein.

Beispiel

Dieses Beispiel verwendet den Konstruktor, um ein SDP-Angebot in ein RTCSessionDescription Objekt zu konvertieren.

Hinweis: Dies ist jedoch nicht mehr notwendig; RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe nehmen, akzeptieren nun direkt einfache Objekte, sodass Sie keine RTCSessionDescription selbst instanziieren müssen.

js
navigator.getUserMedia({ video: true }, (stream) => {
  pc.onaddstream({ stream });
  // Adding a local stream won't trigger the onaddstream callback
  pc.addStream(stream);

  pc.createOffer((offer) => {
    pc.setLocalDescription(
      new RTCSessionDescription(offer),
      () => {
        // send the offer to a server to be forwarded to the friend you're calling.
      },
      error,
    );
  }, error);
});

Spezifikationen

Spezifikation
WebRTC: Real-Time Communication in Browsers
# dom-sessiondescription

Browser-Kompatibilität

Siehe auch