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

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Der RTCSessionDescription() Konstruktor erstellt eine neue RTCSessionDescription mit ihren Eigenschaften, die wie im angegebenen Objekt beschrieben initialisiert sind.

Hinweis: Dieser Konstruktor ist veraltet, da RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, nun direkt ein Objekt akzeptieren, das die Eigenschaften type und sdp enthält. Daher ist es nicht mehr notwendig, eine RTCSessionDescription selbst zu 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 umzuwandeln.

Hinweis: Dies ist jedoch nicht mehr notwendig; RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, akzeptieren jetzt direkt einfache Objekte, sodass es nicht erforderlich ist, eine RTCSessionDescription selbst zu instanziieren.

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

This feature does not appear to be defined in any specification.

Browser-Kompatibilität

Siehe auch